cyb/prysm/atoms/specs/text.md

typography atom in prysm

the only way text appears in cyb. Play (google fonts) — a single font family across the entire interface. hierarchy comes from size and weight, never from decoration

protocol role

text is a leaf in the element tree $\mathcal{T}$ (§7 of prysm/layout). leaf type: text. it has no sub-organelles. its membrane constrains it, it occupies space based on content and font size, membrane places it

sizing

all values in spatial quanta $g$

size scale

font

• family: Play (single family everywhere)
• no bold. no italic. no underline. no decoration
• hierarchy only through size and weight

font metrics derivation

the relationship between spatial quantum $g$ and font rendering:

$$\text{font\_size}(token) = \text{size}(token) \cdot (g_{px} / g)$$

$g_{px}$ — the renderer's interpretation of $g$ in pixels (convention: $g_{px} = 8\text{px}$). for body($2g$): $\text{font_size} = 2 \cdot 8 = 16\text{px}$

character width for Play at body(16px): average ~8.7px for Latin, ~9.2px for Cyrillic. since Play is not strictly monospace, text width computation uses the renderer's font shaping — this is why text glyph metrics are the exception to quantum alignment (I5)

the minimum legible size: micro($3g/2$) at $g_{px} = 8$ = 12px. below this, Play glyphs lose legibility on standard DPI (96-144). on high-DPI (288+), micro remains legible at smaller $g_{px}$

renderer independence. the protocol outputs size in quanta ($2gMATH_PLACEHOLDER_173g$). the renderer translates: $\text{font_size} = \text{size_quanta} \cdot g_{px}$. different renderers may use different $g_{px}$:

occupy

text occupies space based on content length and font size:

$s_w = \text{chars} \cdot \text{char\_width}(size)$ $s_h = \text{lines} \cdot size \cdot \text{line\_height}$

when $s_w > c_w$ (text exceeds membrane constraint): text wraps to next line, increasing $s_h$. when max-lines reached and content still exceeds: truncate with ellipsis

$s_{min} = (\text{char\_width}(size),\; size \cdot \text{line\_height})$ — one character at current size. below this, text is illegible. for body($2g$) at line-height 1.4: $s_{min} \approx (g, 3g)$

note: text glyph metrics are the one exception to quantum alignment (invariant I5) — character widths are determined by the font, not by $g$

color

states

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

adaptation

text size tokens do not change between desktop and mobile. the same body($2g$) renders on both. adaptation happens through the membrane: narrower membrane → text wraps to more lines or molecule folds to a conformation that uses smaller text token

3D

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

• text renders on a plane at the same $p_z$ as its membrane
• text always faces the neuron (billboard orientation) — legibility requires frontal view
• text size in quanta is constant in world space. at greater distance from neuron, text appears smaller but remains sharp

ECS

• Entity: text organelle
• Components:
  • Sizing { width, height } — computed from content + font size
  • TextContent { string }
  • TextSize { token } — h1, h2, h3, body, caption, micro
  • TextWeight { regular | medium }
  • TextAlign { left | center | right }
  • TextColor { color } — from palette or emotion override
  • MaxLines { n } — truncation limit
• System: text participates in OccupySystem — computes size from content metrics, respects $c_w$ for wrapping