prysm/ion.md

icon atom in prysm

a single glyph rendered at a fixed size. ion is the visual symbol — an icon that represents a concept, action, or state. when paired with prysm/text inside a molecule, they form an icon-label unit. but ion itself is only the icon

protocol role

ion is a leaf in the element tree $\mathcal{T}$ (§7 of prysm/layout). leaf type: vector. it has no sub-organelles. its membrane constrains it, it occupies a fixed square, membrane places it

sizing

all values in spatial quanta $g$

size scale

occupy

ion occupies a fixed square:

$$s = (size, size)$$

$s_{min} = (2g, 2g)$ — smallest legible icon

touch target: if $size < 4g$, the membrane adds padding to ensure the interactive area is at least $4g \times 4g$. the ion's occupied size does not change — the membrane's placement accounts for touch padding

states

state transitions: $150\text{ms}$ ease

adaptation

ion size does not change between desktop and mobile. the same $2g$ icon renders on both. when a molecule folds, it may switch to a conformation that uses a smaller or larger ion, but the ion itself does not scale — it snaps to a fixed size from the scale

3D

in the 3D extension (§11 of prysm/layout):

• ion renders at the same $p_z$ as its membrane
• ion always faces the neuron (billboard) — icons must be recognizable from any angle
• size in quanta is constant in world space

ECS

• Entity: ion organelle
• Components:
  • Sizing { width: Fix(size), height: Fix(size) }
  • IonGlyph { name } — which icon from prysm/images
  • IonSize { token } — size from scale
  • IonColor { color } — from palette or emotion
• System: ion participates in OccupySystem as a leaf — returns $(size, size)$