@xtyle/core 0.5.0

package/dist/icon-builder.js

@@ -0,0 +1,486 @@
+/**
+ * The icon builder: a terse name grammar, a tokenizer that parses a name into a
+ * layered composition, and a `composeIcon` renderer that assembles the SVG from
+ * named primitives, the same way an algorithm assembles a token register from
+ * anchors. The composition is the cheap, materialized artifact; the primitive
+ * library, the grammar, and the compose engine are the durable, reusable asset.
+ *
+ * A composition is a back-to-front list of layers. Each layer places a primitive
+ * (a shape, a frame, a band, or a symbol) at a grid position, sized and rotated,
+ * painted in a color or subtracted from the art beneath it. Colors resolve three
+ * ways: a literal, a theme token (`--accent`), or a series slot (`series:2`) off a
+ * scheme. With a derived register the token and series colors bake to concrete
+ * values (a static export); without one they emit `var(--…)` so the mark
+ * re-colors live with the theme.
+ *
+ * The full name grammar is documented in `docs/icon-name-grammar.md`.
+ */
+import { escapeAttr } from "./markup/escape.js";
+import { seriesPalette } from "./series.js";
+import { ICONS } from "./icons.js";
+const GRID = 24;
+const CENTER = GRID / 2;
+const CELL = GRID / 6;
+// The whole primitive library shipped in 0.4.0; a later addition passes its own `since`.
+const bare = (body, tags = [], since = "0.4.0") => ({ body, since, tags });
+/** Plain-language tags for the functional glyphs (reachable as `symbol-<name>` primitives), so the
+ * palette can search and filter them by meaning rather than by glyph name alone. */
+const GLYPH_TAGS = {
+    "chevron-up": ["chevron", "caret", "arrow", "direction", "up"],
+    "chevron-down": ["chevron", "caret", "arrow", "direction", "down"],
+    "chevron-left": ["chevron", "caret", "arrow", "direction", "left"],
+    "chevron-right": ["chevron", "caret", "arrow", "direction", "right"],
+    "chevron-expand": ["chevron", "expand", "arrow", "direction"],
+    "arrow-up": ["arrow", "direction", "up"],
+    "arrow-down": ["arrow", "direction", "down"],
+    "arrow-left": ["arrow", "direction", "left"],
+    "arrow-right": ["arrow", "direction", "right"],
+    close: ["close", "x", "cancel", "dismiss"],
+    check: ["check", "tick", "done", "confirm"],
+    plus: ["plus", "add", "new", "math"],
+    minus: ["minus", "remove", "subtract", "math"],
+    menu: ["menu", "hamburger", "nav", "list"],
+    "more-vertical": ["more", "overflow", "menu", "kebab", "dots"],
+    "more-horizontal": ["more", "overflow", "menu", "dots"],
+    search: ["search", "find", "magnify", "lookup"],
+    info: ["info", "information", "status", "alert"],
+    warning: ["warning", "alert", "caution", "status"],
+    error: ["error", "alert", "danger", "status"],
+    success: ["success", "check", "done", "status"],
+    "external-link": ["link", "external", "open", "out"],
+    dot: ["dot", "point", "circle", "bullet"],
+    loader: ["loader", "spinner", "loading", "progress"],
+    play: ["play", "media", "playback", "control"],
+    pause: ["pause", "media", "playback", "control"],
+    stop: ["stop", "media", "playback", "control"],
+    "skip-forward": ["skip", "forward", "next", "media", "control"],
+    "skip-back": ["skip", "back", "previous", "media", "control"],
+    gear: ["gear", "settings", "cog", "config", "options"],
+    folder: ["folder", "directory", "files"],
+    pencil: ["pencil", "edit", "write", "draw"],
+    trash: ["trash", "delete", "remove", "bin"],
+    eye: ["eye", "view", "visible", "show", "preview"],
+    copy: ["copy", "duplicate", "clone", "clipboard"],
+    palette: ["palette", "paint", "colors", "art", "swatches"],
+    bookmark: ["bookmark", "save", "flag", "mark"],
+    download: ["download", "save", "import", "arrow"],
+};
+/** The seed primitive library: shapes, frames, bars, symbols, and the functional glyphs. Each carries
+ * plain-language `tags` for search and filter; the keys are internal identifiers, not a taxonomy. */
+export const ICON_PRIMITIVES = {
+    "shape-circle": bare(`<circle cx="12" cy="12" r="11"/>`, ["circle", "round", "shape", "solid"]),
+    "shape-square": bare(`<rect x="1.5" y="1.5" width="21" height="21"/>`, ["square", "box", "shape", "solid"]),
+    "shape-square-1": bare(`<rect x="1.5" y="1.5" width="21" height="21" rx="2"/>`, ["square", "box", "rounded", "shape"]),
+    "shape-square-2": bare(`<rect x="1.5" y="1.5" width="21" height="21" rx="4"/>`, ["square", "box", "rounded", "shape"]),
+    "shape-square-3": bare(`<rect x="1.5" y="1.5" width="21" height="21" rx="6"/>`, ["square", "box", "rounded", "shape"]),
+    "shape-shield": bare(`<path d="M12 1.5 L21 4.5 V12 C21 18 17.2 21 12 22.5 C6.8 21 3 18 3 12 V4.5 Z"/>`, ["shield", "badge", "crest", "game", "shape"]),
+    "shape-hex": bare(`<path d="M12 1.5 L21 6.75 V17.25 L12 22.5 L3 17.25 V6.75 Z"/>`, ["hexagon", "hex", "game", "shape"]),
+    "shape-diamond": bare(`<path d="M12 1 L23 12 L12 23 L1 12 Z"/>`, ["diamond", "rhombus", "shape"]),
+    "shape-triangle": bare(`<path d="M12 2.5 L21.5 21.5 H2.5 Z"/>`, ["triangle", "angular", "shape"]),
+    "divider-rule": bare(`<rect x="2" y="11" width="20" height="2" rx="1"/>`, ["divider", "line", "separator", "rule"]),
+    "frame-ring": bare(`<circle cx="12" cy="12" r="10.5" fill="none" stroke="currentColor" stroke-width="1.5"/>`, ["ring", "circle", "frame", "outline", "round"]),
+    "frame-border": bare(`<rect x="2.25" y="2.25" width="19.5" height="19.5" rx="3" fill="none" stroke="currentColor" stroke-width="1.5"/>`, ["border", "square", "frame", "outline"]),
+    "bar-top": bare(`<rect x="2" y="2" width="20" height="5"/>`, ["bar", "band", "stripe", "top", "chief"]),
+    "bar-row": bare(`<rect x="2" y="9.5" width="20" height="5"/>`, ["bar", "band", "stripe", "row", "horizontal", "fess"]),
+    "bar-column": bare(`<rect x="9.5" y="2" width="5" height="20"/>`, ["bar", "band", "stripe", "column", "vertical", "pale"]),
+    "bar-diagonal": bare(`<path d="M2 7 L17 22 L22 17 L7 2 Z"/>`, ["diagonal", "stripe", "slash", "band", "bend"]),
+    "bar-cross": bare(`<path d="M9.5 2 h5 v7.5 h7.5 v5 h-7.5 v7.5 h-5 v-7.5 h-7.5 v-5 h7.5 Z"/>`, ["cross", "plus", "symbol"]),
+    "symbol-star": bare(`<path d="M12 2 l2.9 6.2 6.8 0.7 -5.1 4.6 1.5 6.7 -6.1 -3.6 -6.1 3.6 1.5 -6.7 -5.1 -4.6 6.8 -0.7 Z"/>`, ["star", "favorite", "rating", "symbol"]),
+    "symbol-heart": bare(`<path d="M12 21 C12 21 3 14.5 3 8.5 A4.5 4.5 0 0 1 12 6 A4.5 4.5 0 0 1 21 8.5 C21 14.5 12 21 12 21 Z"/>`, ["heart", "love", "favorite", "symbol"]),
+    "symbol-crescent": bare(`<path d="M12 3 a6 6 0 0 0 9 9 9 9 0 1 1 -9 -9 Z"/>`, ["crescent", "moon", "symbol"]),
+    "symbol-bolt": bare(`<path d="M13 2 L4 14 h6 l-1 8 l9 -13 h-6 Z"/>`, ["bolt", "lightning", "energy", "flash", "symbol"]),
+    ...Object.fromEntries(Object.entries(ICONS).map(([name, body]) => [`symbol-${name}`, bare(body, GLYPH_TAGS[name] ?? [])])),
+};
+/** The single-token functional glyphs, reachable in the grammar by their bare name as a symbol
+ * (`badge--circle-c4--check-s55-c1`). Multi-token glyph names (`chevron-right`) have no keyword; a
+ * spec reaches those through a full library name only, which the tokenizer's single-token keyword
+ * rule doesn't parse, so they stay glyph-only. `dot` is deliberately a shape, not the glyph. */
+const glyphKeywords = Object.fromEntries(Object.keys(ICONS)
+    .filter((name) => !name.includes("-") && name !== "dot")
+    .map((name) => [name, `symbol-${name}`]));
+/** Short grammar keywords → primitive-library names. A keyword the map doesn't cover is used as-is (so `shape-shield` also works verbatim). */
+export const PRIMITIVE_KEYWORDS = {
+    ...glyphKeywords,
+    circle: "shape-circle",
+    square: "shape-square",
+    square1: "shape-square-1",
+    square2: "shape-square-2",
+    square3: "shape-square-3",
+    shield: "shape-shield",
+    hex: "shape-hex",
+    diamond: "shape-diamond",
+    triangle: "shape-triangle",
+    divider: "divider-rule",
+    dot: "shape-circle",
+    ring: "frame-ring",
+    border: "frame-border",
+    top: "bar-top",
+    row: "bar-row",
+    column: "bar-column",
+    diagonal: "bar-diagonal",
+    cross: "bar-cross",
+    // heraldic aliases: kept so the older band names still resolve and stay findable in search
+    chief: "bar-top",
+    fess: "bar-row",
+    pale: "bar-column",
+    bend: "bar-diagonal",
+    star: "symbol-star",
+    heart: "symbol-heart",
+    crescent: "symbol-crescent",
+    bolt: "symbol-bolt",
+};
+/** Resolve a grammar keyword (`star`) or a bare library name (`symbol-star`) to its library name. */
+export function resolvePrimitiveName(nameOrKeyword) {
+    return PRIMITIVE_KEYWORDS[nameOrKeyword] ?? nameOrKeyword;
+}
+/** The version a primitive first shipped in, addressed by keyword or library name (undefined if unknown). */
+export function primitiveSince(nameOrKeyword) {
+    return ICON_PRIMITIVES[resolvePrimitiveName(nameOrKeyword)]?.since;
+}
+/** A primitive's plain-language tags, addressed by keyword or library name (empty when unknown). */
+export function primitiveTags(nameOrKeyword) {
+    return ICON_PRIMITIVES[resolvePrimitiveName(nameOrKeyword)]?.tags ?? [];
+}
+/** True when `name` resolves to a primitive in the library. */
+export function hasPrimitive(name) {
+    return Object.prototype.hasOwnProperty.call(ICON_PRIMITIVES, name);
+}
+/** Every primitive name in the library. */
+export const ICON_PRIMITIVE_NAMES = Object.keys(ICON_PRIMITIVES);
+const STROKE_WIDTH = [0, 0.75, 1.25, 1.75];
+/** Trims float noise from a computed coordinate. */
+function n(value) {
+    return String(Math.round(value * 1000) / 1000);
+}
+/** The number of series slots the grammar exposes (`s1`..`s5` → `series:0`..`series:4`); a scheme
+ * always resolves to this many evenly-spread colors so a slot is a stable pick across schemes. */
+export const ICON_SERIES_COUNT = 5;
+/** Maps a grammar color slot to a fill spec: 0 transparent, 1 `--fg-0`, 2 `--bg-0`, N≥3 the (N−3)th series color. */
+export function colorSlot(slot) {
+    if (slot <= 0)
+        return "transparent";
+    if (slot === 1)
+        return "--fg-0";
+    if (slot === 2)
+        return "--bg-0";
+    return `series:${slot - 3}`;
+}
+/** The `xtyle-icon` root class for a glyph or mark, shared by the element and the Astro binding so
+ * the size / tone / spin chrome stays in one place. (The fragment sandbox keeps its own copy: that
+ * module must stay import-free to bundle whole.) */
+export function iconClass(opts) {
+    return [
+        "xtyle-icon",
+        opts.size && opts.size !== "md" && `xtyle-icon--${opts.size}`,
+        opts.tone && `xtyle-icon--${opts.tone}`,
+        opts.spin && "xtyle-icon--spin",
+        opts.extra,
+    ]
+        .filter(Boolean)
+        .join(" ");
+}
+function resolveColor(spec, opts) {
+    if (!spec || spec === "currentColor")
+        return "currentColor";
+    if (spec === "transparent" || spec === "none")
+        return spec;
+    if (spec.startsWith("series:")) {
+        const index = Number(spec.slice(7));
+        if (!Number.isInteger(index) || index < 0)
+            return "currentColor";
+        if (!opts.register)
+            return "currentColor";
+        // Resolve against a fixed-size palette, not `index + 1`: sizing to the index made every slot
+        // take the *last* color of its own little palette, so a sequential scheme (thermal) collapsed
+        // to its endpoint and a sampled categorical (skittles) to its last color. A stable count makes
+        // each slot a distinct, evenly-spread color — `s1`..`s5` span the whole scheme.
+        const count = Math.max(ICON_SERIES_COUNT, index + 1);
+        const palette = seriesPalette(opts.scheme ?? "accents", count, opts.register);
+        return palette[index] ?? "currentColor";
+    }
+    if (spec.startsWith("--")) {
+        return opts.register?.[spec] ?? `var(${spec})`;
+    }
+    return spec;
+}
+/** The center of grid cell `p` (1–9, phone-keypad: 1 top-left, 5 center, 9 bottom-right). */
+function cellCenter(p) {
+    const col = (p - 1) % 3;
+    const row = Math.floor((p - 1) / 3);
+    return { x: CELL + col * 2 * CELL, y: CELL + row * 2 * CELL };
+}
+function layerTransform(layer) {
+    const parts = [];
+    const dx = layer.x ?? 0;
+    const dy = layer.y ?? 0;
+    if (dx || dy)
+        parts.push(`translate(${n(dx)} ${n(dy)})`);
+    if (layer.rotate)
+        parts.push(`rotate(${n(layer.rotate)} ${CENTER} ${CENTER})`);
+    const sx = (layer.scale ?? 1) * (layer.flipH ? -1 : 1);
+    const sy = (layer.scale ?? 1) * (layer.flipV ? -1 : 1);
+    if (sx !== 1 || sy !== 1) {
+        const scale = sx === sy ? n(sx) : `${n(sx)} ${n(sy)}`;
+        parts.push(`translate(${CENTER} ${CENTER}) scale(${scale}) translate(${-CENTER} ${-CENTER})`);
+    }
+    return parts.join(" ");
+}
+/**
+ * Strokes a shape's silhouette as the rim of a knockout — an outline, never a fill. The body's own
+ * `fill`/`stroke` (glyphs hardcode `currentColor`) is normalized so a *filled* glyph outlines instead
+ * of filling, and a *stroked* glyph takes the outline color; a bare primitive inherits the group stroke.
+ * `color` is left unset so an inherited outline color falls through to the icon's own `currentColor`
+ * rather than the `"none"` `paintGroup` would seed, which is what made this render as a shade or a fill.
+ */
+function outlineGroup(body, outline, transform, opts) {
+    const color = resolveColor(outline.color, opts);
+    const width = STROKE_WIDTH[outline.size] ?? STROKE_WIDTH[1];
+    const stroked = body
+        .replace(/fill="currentColor"/g, 'fill="none"')
+        .replace(/stroke="currentColor"/g, `stroke="${color}"`);
+    return `<g ${transform ? `transform="${transform}" ` : ""}fill="none" stroke="${color}" stroke-width="${width}">${stroked}</g>`;
+}
+function paintGroup(body, fill, layer, transform, opts) {
+    const attrs = [
+        transform && `transform="${transform}"`,
+        `fill="${fill}"`,
+        // seeds currentColor for any child glyph drawn in it, so a symbol matches the layer fill
+        `color="${fill}"`,
+        layer.outline && `stroke="${resolveColor(layer.outline.color, opts)}"`,
+        layer.outline && `stroke-width="${STROKE_WIDTH[layer.outline.size] ?? STROKE_WIDTH[1]}"`,
+        layer.opacity != null && `opacity="${n(layer.opacity)}"`,
+    ]
+        .filter(Boolean)
+        .join(" ");
+    return `<g ${attrs}>${body}</g>`;
+}
+const MISSING = bare(`<rect x="5" y="5" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-dasharray="3 2"/>`);
+/** A stable short id from a composition, so a knockout mask / rounding clip is unique per distinct spec but shared (harmlessly) between identical ones on a page. */
+function specId(composition) {
+    const source = JSON.stringify(composition);
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < source.length; i++) {
+        hash ^= source.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(36);
+}
+/**
+ * Composes a layered icon into an SVG string. Layers paint back to front; a
+ * `knockout` layer punches its shape through everything beneath it (a later layer
+ * paints over the hole). An unknown primitive renders a visible placeholder box
+ * rather than nothing, so a typo shows on screen.
+ */
+export function composeIcon(composition, opts = {}) {
+    const id = specId(composition);
+    const defs = [];
+    let body = "";
+    let holes = 0;
+    for (const layer of composition.layers) {
+        const primitive = ICON_PRIMITIVES[layer.primitive] ?? MISSING;
+        const transform = layerTransform(layer);
+        if (layer.knockout) {
+            // A normal knockout punches the shape out of the art below (white field, black shape);
+            // an inverted knockout (`-i-ko`) flips the mask so only the shape survives — clipping the
+            // accumulated art to the shape's silhouette (a circle clip, a heart clip, …).
+            const maskId = `xk-${id}-${holes++}`;
+            const fieldFill = layer.invert ? "#000" : "#fff";
+            const shapeFill = layer.invert ? "#fff" : "#000";
+            // Seed `color` too, so a glyph body drawn with `currentColor` (fill or stroke) resolves to
+            // the solid mask silhouette instead of a mid-tone that only half-cuts — same trick paintGroup
+            // uses for the normal paint. Without it, a glyph knocks out as a faint shade, not a hole.
+            const cut = `<g ${transform ? `transform="${transform}" ` : ""}fill="${shapeFill}" color="${shapeFill}">${primitive.body}</g>`;
+            defs.push(`<mask id="${maskId}" maskUnits="userSpaceOnUse" x="0" y="0" width="${GRID}" height="${GRID}"><rect width="${GRID}" height="${GRID}" fill="${fieldFill}"/>${cut}</mask>`);
+            body = `<g mask="url(#${maskId})">${body}</g>`;
+            if (layer.outline)
+                body += outlineGroup(primitive.body, layer.outline, transform, opts);
+        }
+        else if (layer.invert) {
+            // Paint the fill everywhere *except* the shape — a filled field with a shape-hole.
+            const maskId = `xi-${id}-${holes++}`;
+            const cut = `<g ${transform ? `transform="${transform}" ` : ""}fill="#000" color="#000">${primitive.body}</g>`;
+            defs.push(`<mask id="${maskId}" maskUnits="userSpaceOnUse" x="0" y="0" width="${GRID}" height="${GRID}"><rect width="${GRID}" height="${GRID}" fill="#fff"/>${cut}</mask>`);
+            const alpha = layer.opacity != null && layer.opacity !== 1 ? ` fill-opacity="${n(layer.opacity)}"` : "";
+            body += `<g mask="url(#${maskId})"><rect width="${GRID}" height="${GRID}" fill="${resolveColor(layer.fill, opts)}"${alpha}/></g>`;
+        }
+        else {
+            body += paintGroup(primitive.body, resolveColor(layer.fill, opts), layer, transform, opts);
+        }
+    }
+    // A whole-icon drop shadow: a colored, offset, blurred copy of the accumulated art cast behind it.
+    // The shadow can reach past the 24-unit box, so the svg is allowed to overflow when one is present.
+    let overflow = "";
+    if (composition.dropShadow) {
+        const ds = composition.dropShadow;
+        const color = resolveColor(ds.color, opts);
+        const filterId = `xds-${id}`;
+        defs.push(`<filter id="${filterId}" x="-40%" y="-40%" width="180%" height="180%"><feDropShadow dx="${n(ds.dx)}" dy="${n(ds.dy)}" stdDeviation="${n(ds.blur)}" flood-opacity="0.5" style="flood-color:${color}"/></filter>`);
+        body = `<g filter="url(#${filterId})">${body}</g>`;
+        overflow = ` style="overflow:visible"`;
+    }
+    const a11y = composition.label ? `role="img" aria-label="${escapeAttr(composition.label)}"` : `aria-hidden="true"`;
+    const title = composition.label ? `<title>${escapeAttr(composition.label)}</title>` : "";
+    const head = defs.length ? `<defs>${defs.join("")}</defs>` : "";
+    const cls = opts.className ? `class="${escapeAttr(opts.className)}" ` : "";
+    const part = opts.part ? `part="${escapeAttr(opts.part)}" ` : "";
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${GRID} ${GRID}" width="1em" height="1em" focusable="false"${overflow} ${cls}${part}${a11y}>${title}${head}${body}</svg>`;
+}
+/**
+ * Composes an icon for a live surface: series slots resolve against `opts.register`
+ * (the live cascade) while token fills stay `var(--…)`, so a mark bakes only what a
+ * plain CSS variable can't carry and re-colors with the theme for everything else.
+ */
+export function composeIconThemed(composition, opts = {}) {
+    const bakeSeries = (spec) => spec?.startsWith("series:") ? resolveColor(spec, opts) : spec;
+    const layers = composition.layers.map((layer) => ({
+        ...layer,
+        fill: bakeSeries(layer.fill),
+        outline: layer.outline ? { ...layer.outline, color: bakeSeries(layer.outline.color) ?? layer.outline.color } : undefined,
+    }));
+    const dropShadow = composition.dropShadow
+        ? { ...composition.dropShadow, color: bakeSeries(composition.dropShadow.color) ?? composition.dropShadow.color }
+        : undefined;
+    return composeIcon({ ...composition, layers, dropShadow }, { scheme: opts.scheme, className: opts.className, part: opts.part });
+}
+const OBJECT_TOKEN = /-(?:(p|s|x|y|r|a|c)(-?\d+)|(o)([1-3])(?:c(-?\d+))?|(ko|fh|fv|i))/g;
+function parseObject(segment) {
+    // A primitive keyword is letters plus an optional trailing index (`square`, `square1`), so an
+    // indexed variant reads as one token before the `-`-separated flags.
+    const keyword = /^[a-z]+[0-9]*/.exec(segment)?.[0];
+    if (!keyword)
+        return null;
+    const layer = { primitive: PRIMITIVE_KEYWORDS[keyword] ?? keyword };
+    let position = 5;
+    let offX = 0;
+    let offY = 0;
+    const rest = segment.slice(keyword.length);
+    OBJECT_TOKEN.lastIndex = 0;
+    let token;
+    while ((token = OBJECT_TOKEN.exec(rest))) {
+        if (token[1]) {
+            const value = Number(token[2]);
+            if (token[1] === "p")
+                position = value;
+            else if (token[1] === "s")
+                layer.scale = value / 100;
+            else if (token[1] === "x")
+                offX = value;
+            else if (token[1] === "y")
+                offY = value;
+            else if (token[1] === "r")
+                layer.rotate = value;
+            else if (token[1] === "a")
+                layer.opacity = value / 100;
+            else if (token[1] === "c")
+                layer.fill = colorSlot(value);
+        }
+        else if (token[3]) {
+            layer.outline = { size: Number(token[4]), color: token[5] != null ? colorSlot(Number(token[5])) : "currentColor" };
+        }
+        else if (token[6] === "ko")
+            layer.knockout = true;
+        else if (token[6] === "fh")
+            layer.flipH = true;
+        else if (token[6] === "fv")
+            layer.flipV = true;
+        else if (token[6] === "i")
+            layer.invert = true;
+    }
+    const cell = cellCenter(position >= 1 && position <= 9 ? position : 5);
+    const tx = cell.x - CENTER + (offX * GRID) / 100;
+    const ty = cell.y - CENTER + (offY * GRID) / 100;
+    if (tx)
+        layer.x = tx;
+    if (ty)
+        layer.y = ty;
+    return layer;
+}
+const SHADOW_MAX_OFFSET = 1.1;
+const SHADOW_MAX_BLUR = 2.5;
+/** Reads a `d{color}p{dir}s{size}t{soft}` drop-shadow token into an offset+blur the renderer applies. */
+function parseDropShadow(token) {
+    const m = /^d(\d+)?(?:p([1-9]))?(?:s([1-9]))?(?:t(\d{1,3}))?$/.exec(token);
+    if (!m)
+        return null;
+    const color = colorSlot(m[1] != null ? Number(m[1]) : 1);
+    const dir = m[2] != null ? Number(m[2]) : 8;
+    const size = m[3] != null ? Number(m[3]) : 2;
+    const soft = m[4] != null ? Math.min(100, Number(m[4])) : 50;
+    const dirX = ((dir - 1) % 3) - 1;
+    const dirY = Math.floor((dir - 1) / 3) - 1;
+    const mag = Math.hypot(dirX, dirY) || 1;
+    const dist = size * SHADOW_MAX_OFFSET;
+    return {
+        color,
+        dx: (dirX / mag) * dist,
+        dy: (dirY / mag) * dist,
+        blur: (soft / 100) * SHADOW_MAX_BLUR,
+    };
+}
+/**
+ * The `---` finish grammar: whole-icon metadata after the last object. Two kinds of token coexist and
+ * each reader skips the other's — render finishes the mark acts on (`d…` drop shadow), and `l…` lock
+ * flags that are authoring metadata for the builder's Randomize, invisible to the rendered mark.
+ */
+function parseFinish(segment) {
+    const out = {};
+    for (const token of segment.split("-")) {
+        if (token.startsWith("d")) {
+            const shadow = parseDropShadow(token);
+            if (shadow)
+                out.dropShadow = shadow;
+        }
+    }
+    return out;
+}
+/** Turns a label segment into an accessible name: `dice-3` → `dice 3`. */
+function humanize(label) {
+    return label.replace(/-/g, " ").trim();
+}
+/**
+ * Parses an icon name into a composition. A name is a spec when it contains `--`
+ * (a label, then `--`-separated objects, then an optional `---` finish). A bare
+ * name with no `--` is a lookup, not a spec, and returns `null` so the caller can
+ * fall back to the functional set or a baked artifact.
+ */
+export function parseIconName(name) {
+    if (!name.includes("--"))
+        return null;
+    const finishAt = name.indexOf("---");
+    const head = finishAt >= 0 ? name.slice(0, finishAt) : name;
+    const finishRaw = finishAt >= 0 ? name.slice(finishAt + 3) : "";
+    const parts = head.split("--");
+    const label = parts[0] || null;
+    const layers = parts
+        .slice(1)
+        .filter((segment) => segment.length > 0)
+        .map(parseObject)
+        .filter((layer) => layer != null);
+    const composition = { layers };
+    if (label)
+        composition.label = humanize(label);
+    if (finishRaw)
+        Object.assign(composition, parseFinish(finishRaw));
+    return { label, composition };
+}
+const iconGenerators = [parseIconName];
+/**
+ * Registers an alternative name→mark generator (a hashed-identicon mode, a domain-specific mark
+ * set). Generators are tried in registration order after the blessed default grammar, so an
+ * alternative claims only the names the default declines. This is the seam that keeps the mark
+ * generator swappable the way a token algorithm is: the engine owns `composeIcon` + the primitive
+ * library, an author owns how a string becomes a composition.
+ */
+export function registerIconGenerator(generator) {
+    iconGenerators.push(generator);
+}
+/** Resolves a name to a mark through the registered generators (the default grammar first), or null when none claims it. */
+export function resolveIconMark(name) {
+    for (const generator of iconGenerators) {
+        const parsed = generator(name);
+        if (parsed)
+            return parsed;
+    }
+    return null;
+}
+//# sourceMappingURL=icon-builder.js.map

package/dist/icon-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-builder.js","sourceRoot":"","sources":["../src/icon-builder.ts"],"names":[],"mappings":"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"}

package/dist/icons.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The functional icon set: a name to inline-SVG-body map plus the `renderIcon`
+ * helper that wraps a named body in a themeable `<svg>`. It is deliberately
+ * import-free so the component fragment can inline it into its sandbox bundle,
+ * the Astro SSR path can render it, and `@xtyle/core` can re-export it as a
+ * public method: one source of truth for every surface.
+ *
+ * Every glyph draws on a `0 0 24 24` grid in `currentColor`, so an icon inherits
+ * the text color around it and matches the derived theme with no tokens of its
+ * own. Line glyphs stroke; a few (the dots) fill.
+ */
+export type IconName = "chevron-up" | "chevron-down" | "chevron-left" | "chevron-right" | "chevron-expand" | "arrow-up" | "arrow-down" | "arrow-left" | "arrow-right" | "close" | "check" | "plus" | "minus" | "menu" | "more-vertical" | "more-horizontal" | "search" | "info" | "warning" | "error" | "success" | "external-link" | "dot" | "loader" | "play" | "pause" | "stop" | "skip-forward" | "skip-back" | "gear" | "folder" | "pencil" | "trash" | "eye" | "copy" | "palette" | "bookmark" | "download";
+export type IconSize = "sm" | "md" | "lg" | "xl";
+export interface RenderIconOptions {
+    /** The rendered size, stepping in `em` off the surrounding text: `sm`, `md`, `lg`, `xl`. */
+    size?: IconSize | null;
+    /**
+     * An accessible name. When set the icon is exposed as `role="img"` with the
+     * label; when omitted the icon is decorative (`aria-hidden`) and adds no
+     * accessible name of its own.
+     */
+    label?: string | null;
+    /** Continuously rotate the glyph (a loading affordance); gated by `prefers-reduced-motion`. */
+    spin?: boolean | null;
+    /** Tint the glyph to a semantic role or named hue instead of inheriting `currentColor`. */
+    tone?: string | null;
+    /** Extra class names appended after the base set. */
+    class?: string | null;
+    /** A `part` attribute for the `<svg>`, so a host element exposes it for styling. */
+    part?: string | null;
+}
+/** The functional icon set, keyed by name, each value the inner SVG body on a 24×24 grid. */
+export declare const ICONS: Record<IconName, string>;
+/** Every icon name in the set, in declaration order. */
+export declare const ICON_NAMES: IconName[];
+/** True when `name` resolves to a glyph in the set. */
+export declare function hasIcon(name: string): name is IconName;
+/**
+ * Renders a named glyph as a themeable `<svg>` string. An unknown name renders a
+ * visible placeholder box rather than nothing, so a typo shows on screen instead
+ * of silently vanishing. When `label` is set the icon carries `role="img"` and
+ * the name; otherwise it is `aria-hidden`.
+ */
+export declare function renderIcon(name: string, opts?: RenderIconOptions): string;
+//# sourceMappingURL=icons.d.ts.map

package/dist/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,QAAQ,GACjB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,OAAO,GACP,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,eAAe,GACf,iBAAiB,GACjB,QAAQ,GACR,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,eAAe,GACf,KAAK,GACL,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,GACN,cAAc,GACd,WAAW,GACX,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,KAAK,GACL,MAAM,GACN,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAEd,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IACjC,4FAA4F;IAC5F,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+FAA+F;IAC/F,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAaD,6FAA6F;AAC7F,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAiD1C,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,UAAU,EAAE,QAAQ,EAAqC,CAAC;AAEvE,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,QAAQ,CAEtD;AAsBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAQ7E"}