@hyperframes/core 0.7.27 → 0.7.29

package/dist/figma/nodeToHtml.js

@@ -0,0 +1,244 @@
+/**
+ * Phase 3 mapper: figma node tree → editable HTML with inline styles
+ * (design spec §7, hybrid fidelity routing).
+ *
+ * - Geometry is exact for free: absolute positioning at figma bounds inside
+ *   a fixed-size root — no responsive reflow, no drift.
+ * - CSS where CSS is faithful: solid/linear-gradient fills, corner radius,
+ *   opacity, drop shadow, blur, text styles.
+ * - Everything CSS can't match faithfully (vectors, boolean ops, exotic
+ *   paint) routes to the rasterize list — the caller exports those nodes as
+ *   images (Phase 1) and fills in the placeholder src.
+ * - Bindings (§7.1): resolved sites emit var(--slug, literal) so a brand
+ *   refresh propagates; unresolved sites bake the literal and carry a
+ *   data-figma-unresolved flag. Never a dangling var().
+ * - visible:false nodes and fills are skipped — figma's own renderer
+ *   semantics, not ours.
+ */
+import { figmaColorToCss } from "./color.js";
+import { childDocuments } from "./nodeDocument.js";
+const RASTERIZE_TYPES = new Set([
+    "VECTOR",
+    "BOOLEAN_OPERATION",
+    "STAR",
+    "LINE",
+    "POLYGON",
+    "REGULAR_POLYGON",
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function boxOf(node) {
+    const b = node.absoluteBoundingBox;
+    if (isRecord(b) &&
+        typeof b.x === "number" &&
+        typeof b.y === "number" &&
+        typeof b.width === "number" &&
+        typeof b.height === "number")
+        return { x: b.x, y: b.y, width: b.width, height: b.height };
+    return null;
+}
+export function slugify(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug.length > 0 ? slug : "node";
+}
+function cssVarName(compositionVariableId) {
+    return `--${slugify(compositionVariableId)}`;
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function round(n) {
+    return Math.round(n * 100) / 100;
+}
+function firstVisibleFill(node) {
+    const fills = node.fills;
+    if (!Array.isArray(fills))
+        return null;
+    for (const fill of fills) {
+        if (isRecord(fill) && fill.visible !== false)
+            return fill;
+    }
+    return null;
+}
+function gradientCss(fill) {
+    const stops = fill.gradientStops;
+    if (!Array.isArray(stops))
+        return null;
+    const parts = [];
+    for (const stop of stops) {
+        if (!isRecord(stop) || typeof stop.position !== "number")
+            return null;
+        const color = figmaColorToCss(stop.color);
+        if (color === null)
+            return null;
+        parts.push(`${color} ${round(stop.position * 100)}%`);
+    }
+    if (parts.length === 0)
+        return null;
+    // ponytail: fixed 180deg; exact angle from gradientHandlePositions when the
+    // probe confirms the handle-space math (spec §7.1 probe list).
+    return `linear-gradient(180deg, ${parts.join(", ")})`;
+}
+function fillCss(node) {
+    const fill = firstVisibleFill(node);
+    if (fill === null)
+        return null;
+    if (fill.type === "SOLID")
+        return figmaColorToCss(fill.color);
+    if (fill.type === "GRADIENT_LINEAR")
+        return gradientCss(fill);
+    return null;
+}
+function dropShadowCss(effect) {
+    if (!isRecord(effect.offset))
+        return null;
+    const color = figmaColorToCss(effect.color);
+    const { x, y } = effect.offset;
+    if (color === null || typeof x !== "number" || typeof y !== "number")
+        return null;
+    const radius = typeof effect.radius === "number" ? effect.radius : 0;
+    return `box-shadow: ${round(x)}px ${round(y)}px ${round(radius)}px ${color}`;
+}
+function effectCss(effect) {
+    if (!isRecord(effect) || effect.visible === false)
+        return null;
+    if (effect.type === "DROP_SHADOW")
+        return dropShadowCss(effect);
+    if (effect.type === "LAYER_BLUR" && typeof effect.radius === "number")
+        return `filter: blur(${round(effect.radius)}px)`;
+    return null;
+}
+function effectsCss(node, styles) {
+    const effects = node.effects;
+    if (!Array.isArray(effects))
+        return;
+    for (const effect of effects) {
+        const css = effectCss(effect);
+        if (css !== null)
+            styles.push(css);
+    }
+}
+function textCss(node, styles) {
+    const s = node.style;
+    if (!isRecord(s))
+        return;
+    // fontFamily is the one content-controlled string that reaches CSS — strip
+    // quote/escape chars so it can't break out of the font-family value (the
+    // whole style attribute is additionally HTML-escaped at emission).
+    if (typeof s.fontFamily === "string")
+        styles.push(`font-family: '${s.fontFamily.replace(/['"\\;]/g, "")}'`);
+    if (typeof s.fontWeight === "number")
+        styles.push(`font-weight: ${s.fontWeight}`);
+    if (typeof s.fontSize === "number")
+        styles.push(`font-size: ${round(s.fontSize)}px`);
+    if (typeof s.lineHeightPx === "number")
+        styles.push(`line-height: ${round(s.lineHeightPx)}px`);
+    if (typeof s.letterSpacing === "number" && s.letterSpacing !== 0)
+        styles.push(`letter-spacing: ${round(s.letterSpacing)}px`);
+}
+function uniqueSlug(ctx, name) {
+    const base = slugify(name);
+    let slug = base;
+    let n = 2;
+    while (ctx.usedSlugs.has(slug))
+        slug = `${base}-${n++}`;
+    ctx.usedSlugs.add(slug);
+    return slug;
+}
+function backgroundValue(node, ctx) {
+    const literal = fillCss(node);
+    if (literal === null)
+        return null;
+    const resolved = ctx.bindings.resolved.find((r) => r.nodeId === node.id && r.property === "fills");
+    if (resolved)
+        return `var(${cssVarName(resolved.compositionVariableId)}, ${literal})`;
+    return literal;
+}
+function unresolvedAttr(node, ctx) {
+    const props = ctx.bindings.unresolved.filter((u) => u.nodeId === node.id).map((u) => u.property);
+    if (props.length === 0)
+        return "";
+    return ` data-figma-unresolved="${escapeHtml(props.join(" "))}"`;
+}
+function geometryCss(node, ctx, isRoot) {
+    const box = boxOf(node);
+    const styles = [];
+    if (!box)
+        return styles;
+    if (isRoot) {
+        styles.push("position: relative", `width: ${round(box.width)}px`, `height: ${round(box.height)}px`);
+    }
+    else {
+        styles.push("position: absolute", `left: ${round(box.x - ctx.origin.x)}px`, `top: ${round(box.y - ctx.origin.y)}px`, `width: ${round(box.width)}px`, `height: ${round(box.height)}px`);
+    }
+    return styles;
+}
+function decorationCss(node, ctx) {
+    const styles = [];
+    // backgroundValue is the binding-aware path (var(--slug, literal)) — TEXT
+    // color goes through it too, so a token-bound text fill keeps its link.
+    const bg = backgroundValue(node, ctx);
+    if (node.type === "TEXT") {
+        if (bg !== null)
+            styles.push(`color: ${bg}`);
+        textCss(node, styles);
+    }
+    else if (bg !== null) {
+        styles.push(`background: ${bg}`);
+    }
+    if (node.type === "ELLIPSE") {
+        styles.push("border-radius: 50%");
+    }
+    else if (typeof node.cornerRadius === "number" && node.cornerRadius > 0) {
+        styles.push(`border-radius: ${round(node.cornerRadius)}px`);
+    }
+    if (node.clipsContent === true)
+        styles.push("overflow: hidden");
+    if (typeof node.opacity === "number" && node.opacity < 1)
+        styles.push(`opacity: ${round(node.opacity)}`);
+    effectsCss(node, styles);
+    return styles;
+}
+// ponytail: depth cap so a runaway auto-generated tree degrades to a skip
+// instead of a RangeError; real figma frames are nowhere near this deep.
+const MAX_DEPTH = 500;
+function renderChildren(node, ctx, depth) {
+    const childHtml = [];
+    for (const child of childDocuments(node)) {
+        const rendered = renderNodeHtml(child, ctx, false, depth + 1);
+        if (rendered.length > 0)
+            childHtml.push(rendered);
+    }
+    return childHtml.length > 0 ? `\n${childHtml.join("\n")}\n` : "";
+}
+function renderNodeHtml(node, ctx, isRoot, depth = 0) {
+    if (node.visible === false || depth > MAX_DEPTH)
+        return "";
+    const slug = uniqueSlug(ctx, node.name);
+    const style = escapeHtml([...geometryCss(node, ctx, isRoot), ...decorationCss(node, ctx)].join("; "));
+    const idAttrs = `id="${slug}" data-figma-id="${escapeHtml(node.id)}"${unresolvedAttr(node, ctx)}`;
+    if (RASTERIZE_TYPES.has(node.type)) {
+        ctx.rasterize.push({ nodeId: node.id, name: node.name, slug });
+        return `<img ${idAttrs} data-figma-rasterize="${escapeHtml(node.id)}" alt="${escapeHtml(node.name)}" style="${style}" />`;
+    }
+    if (node.type === "TEXT") {
+        const text = typeof node.characters === "string" ? escapeHtml(node.characters) : "";
+        return `<div ${idAttrs} style="${style}">${text}</div>`;
+    }
+    return `<div ${idAttrs} style="${style}">${renderChildren(node, ctx, depth)}</div>`;
+}
+export function nodeToHtml(root, bindings) {
+    const origin = boxOf(root) ?? { x: 0, y: 0, width: 0, height: 0 };
+    const ctx = { origin, bindings, rasterize: [], usedSlugs: new Set() };
+    const html = renderNodeHtml(root, ctx, true);
+    return { html, rasterize: ctx.rasterize };
+}
+//# sourceMappingURL=nodeToHtml.js.map

package/dist/figma/nodeToHtml.js.map

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

package/dist/figma/parseFigmaRef.d.ts

@@ -0,0 +1,3 @@
+import type { FigmaRef } from "./types";
+export declare function parseFigmaRef(input: string): FigmaRef;
+//# sourceMappingURL=parseFigmaRef.d.ts.map

package/dist/figma/parseFigmaRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFigmaRef.d.ts","sourceRoot":"","sources":["../../src/figma/parseFigmaRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQxC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAuBrD"}

package/dist/figma/parseFigmaRef.js

@@ -0,0 +1,31 @@
+const FILE_KEY_RE = /\/(?:design|file|proto)\/([A-Za-z0-9]+)/;
+function normalizeNodeId(raw) {
+    return raw.replaceAll("-", ":");
+}
+export function parseFigmaRef(input) {
+    const trimmed = input.trim();
+    if (trimmed.length === 0)
+        throw new Error("parseFigmaRef: empty input");
+    if (!trimmed.includes("/")) {
+        const colon = trimmed.indexOf(":");
+        if (colon === -1)
+            return { fileKey: trimmed };
+        const fileKey = trimmed.slice(0, colon);
+        const node = trimmed.slice(colon + 1);
+        if (fileKey.length === 0)
+            throw new Error(`parseFigmaRef: invalid ref "${input}"`);
+        return node.length > 0 ? { fileKey, nodeId: normalizeNodeId(node) } : { fileKey };
+    }
+    const keyMatch = trimmed.match(FILE_KEY_RE);
+    const fileKey = keyMatch?.[1];
+    if (fileKey === undefined)
+        throw new Error(`parseFigmaRef: no fileKey in "${input}"`);
+    const q = trimmed.indexOf("?");
+    if (q !== -1) {
+        const raw = new URLSearchParams(trimmed.slice(q + 1)).get("node-id");
+        if (raw !== null && raw.length > 0)
+            return { fileKey, nodeId: normalizeNodeId(raw) };
+    }
+    return { fileKey };
+}
+//# sourceMappingURL=parseFigmaRef.js.map

package/dist/figma/parseFigmaRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFigmaRef.js","sourceRoot":"","sources":["../../src/figma/parseFigmaRef.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,yCAAyC,CAAC;AAE9D,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAExE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,GAAG,CAAC,CAAC;QACnF,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;IACpF,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,GAAG,CAAC,CAAC;IAEtF,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;IACvF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/figma/resolveBindings.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Binding resolution pass (design spec §7.1): scan a node tree's complete
+ * binding set — boundVariables and style ids, alias chains honored — and
+ * partition against the binding index BEFORE any CSS is emitted.
+ *
+ * Exact-ID matching only. A missed link bakes a visually-correct literal;
+ * a wrong link silently changes color at the next brand refresh. Never
+ * match by value or name.
+ *
+ * NOTE: the consumer-side boundVariables shape is probe-flagged in the spec
+ * (§7.1 pre-build probes). Extraction here is tolerant: single alias objects
+ * and arrays of alias objects both count; unknown shapes are ignored rather
+ * than guessed at.
+ */
+import type { FigmaBindingRecord } from "./bindings";
+import type { FigmaNodeDocument } from "./client";
+export interface BindingSite {
+    nodeId: string;
+    /** boundVariables property ("fills") or style slot prefixed "style:" ("style:text") */
+    property: string;
+    figmaId: string;
+}
+export interface ResolvedBindingSite extends BindingSite {
+    compositionVariableId: string;
+}
+export interface ResolveBindingsResult {
+    resolved: ResolvedBindingSite[];
+    unresolved: BindingSite[];
+}
+export declare function resolveBindings(node: FigmaNodeDocument, index: FigmaBindingRecord[]): ResolveBindingsResult;
+//# sourceMappingURL=resolveBindings.d.ts.map

package/dist/figma/resolveBindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveBindings.d.ts","sourceRoot":"","sources":["../../src/figma/resolveBindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGlD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,UAAU,EAAE,WAAW,EAAE,CAAC;CAC3B;AAgDD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,kBAAkB,EAAE,GAC1B,qBAAqB,CAYvB"}

package/dist/figma/resolveBindings.js

@@ -0,0 +1,77 @@
+/**
+ * Binding resolution pass (design spec §7.1): scan a node tree's complete
+ * binding set — boundVariables and style ids, alias chains honored — and
+ * partition against the binding index BEFORE any CSS is emitted.
+ *
+ * Exact-ID matching only. A missed link bakes a visually-correct literal;
+ * a wrong link silently changes color at the next brand refresh. Never
+ * match by value or name.
+ *
+ * NOTE: the consumer-side boundVariables shape is probe-flagged in the spec
+ * (§7.1 pre-build probes). Extraction here is tolerant: single alias objects
+ * and arrays of alias objects both count; unknown shapes are ignored rather
+ * than guessed at.
+ */
+import { childDocuments } from "./nodeDocument.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function aliasId(value) {
+    if (isRecord(value) && value.type === "VARIABLE_ALIAS" && typeof value.id === "string")
+        return value.id;
+    return null;
+}
+function boundVariableSites(node, out) {
+    const bound = node.boundVariables;
+    if (!isRecord(bound))
+        return;
+    for (const [property, value] of Object.entries(bound)) {
+        const candidates = Array.isArray(value) ? value : [value];
+        for (const item of candidates) {
+            const id = aliasId(item);
+            if (id)
+                out.push({ nodeId: node.id, property, figmaId: id });
+        }
+    }
+}
+function styleSites(node, out) {
+    const styles = node.styles;
+    if (!isRecord(styles))
+        return;
+    for (const [slot, styleId] of Object.entries(styles)) {
+        if (typeof styleId === "string" && styleId.length > 0)
+            out.push({ nodeId: node.id, property: `style:${slot}`, figmaId: styleId });
+    }
+}
+function collectSites(node, out) {
+    boundVariableSites(node, out);
+    styleSites(node, out);
+    for (const child of childDocuments(node))
+        collectSites(child, out);
+}
+function findInIndex(index, figmaId) {
+    for (const b of index) {
+        if (b.figmaId === figmaId)
+            return b;
+        if (b.aliasChain?.includes(figmaId))
+            return b;
+        if (b.key !== undefined && b.key === figmaId)
+            return b;
+    }
+    return null;
+}
+export function resolveBindings(node, index) {
+    const sites = [];
+    collectSites(node, sites);
+    const resolved = [];
+    const unresolved = [];
+    for (const site of sites) {
+        const match = findInIndex(index, site.figmaId);
+        if (match)
+            resolved.push({ ...site, compositionVariableId: match.compositionVariableId });
+        else
+            unresolved.push(site);
+    }
+    return { resolved, unresolved };
+}
+//# sourceMappingURL=resolveBindings.js.map

package/dist/figma/resolveBindings.js.map

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

package/dist/figma/sanitizeSvg.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Sanitize a figma-exported SVG before it touches disk (design spec §5).
+ *
+ * Threat model: figma-SHAPED exports, hardened against the cheap adversarial
+ * variants (nesting, unquoted attrs, scheme smuggling). This is a lexical
+ * pass, not a general-purpose HTML sanitizer — content from arbitrary
+ * untrusted sources should go through a real sanitizer (DOMPurify) instead.
+ * Strips:
+ *  - <script> elements (with content) and <style> blocks (@import exfil)
+ *  - <foreignObject> subtrees (arbitrary embedded HTML)
+ *  - on* event-handler attributes (quoted and unquoted)
+ *  - href/xlink:href values unless local fragment (#id) or data:image/
+ *
+ * Keeps local fragment refs (#id) and data:image embeds, which figma uses
+ * for clip paths and embedded rasters.
+ */
+export declare function sanitizeSvg(svg: string): string;
+//# sourceMappingURL=sanitizeSvg.d.ts.map

package/dist/figma/sanitizeSvg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeSvg.d.ts","sourceRoot":"","sources":["../../src/figma/sanitizeSvg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAwB/C"}

package/dist/figma/sanitizeSvg.js

@@ -0,0 +1,52 @@
+/**
+ * Sanitize a figma-exported SVG before it touches disk (design spec §5).
+ *
+ * Threat model: figma-SHAPED exports, hardened against the cheap adversarial
+ * variants (nesting, unquoted attrs, scheme smuggling). This is a lexical
+ * pass, not a general-purpose HTML sanitizer — content from arbitrary
+ * untrusted sources should go through a real sanitizer (DOMPurify) instead.
+ * Strips:
+ *  - <script> elements (with content) and <style> blocks (@import exfil)
+ *  - <foreignObject> subtrees (arbitrary embedded HTML)
+ *  - on* event-handler attributes (quoted and unquoted)
+ *  - href/xlink:href values unless local fragment (#id) or data:image/
+ *
+ * Keeps local fragment refs (#id) and data:image embeds, which figma uses
+ * for clip paths and embedded rasters.
+ */
+/** Apply a replacement until the output stops changing (defeats nesting). */
+function replaceStable(input, pattern, replacement) {
+    let out = input;
+    let prev;
+    do {
+        prev = out;
+        out = out.replace(pattern, replacement);
+    } while (out !== prev);
+    return out;
+}
+export function sanitizeSvg(svg) {
+    let out = svg;
+    out = replaceStable(out, /<script\b[\s\S]*?<\/script\b[^>]*>/gi, "");
+    out = replaceStable(out, /<script\b[^>]*\/>/gi, "");
+    out = replaceStable(out, /<style\b[\s\S]*?<\/style\b[^>]*>/gi, "");
+    out = replaceStable(out, /<foreignObject\b[\s\S]*?<\/foreignObject\b[^>]*>/gi, "");
+    out = replaceStable(out, /<foreignObject\b[^>]*\/>/gi, "");
+    // Nesting leaves inert orphan close tags after the stable pass — drop them.
+    out = out.replace(/<\/(?:script|style|foreignObject)\b[^>]*>/gi, "");
+    // on* handler attributes: quoted and unquoted forms.
+    out = replaceStable(out, /\son[a-z]+\s*=\s*"[^"]*"/gi, "");
+    out = replaceStable(out, /\son[a-z]+\s*=\s*'[^']*'/gi, "");
+    out = replaceStable(out, /\son[a-z]+\s*=\s*[^\s>'"]+/gi, "");
+    // href-like attributes: POSITIVE allowlist — keep only local fragments and
+    // data:image embeds; drop everything else (javascript:, https?:, blob:,
+    // vbscript:, data:text/html, protocol-relative, …).
+    // xmlns declarations are attribute *names*, not href values — untouched.
+    out = out.replace(/\s(href|xlink:href)\s*=\s*"([^"]*)"/gi, (m, attr, value) => isAllowedHref(value) ? m : "");
+    out = out.replace(/\s(href|xlink:href)\s*=\s*'([^']*)'/gi, (m, attr, value) => isAllowedHref(value) ? m : "");
+    return out;
+}
+function isAllowedHref(value) {
+    const v = value.trim().toLowerCase();
+    return v.startsWith("#") || v.startsWith("data:image/");
+}
+//# sourceMappingURL=sanitizeSvg.js.map

package/dist/figma/sanitizeSvg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeSvg.js","sourceRoot":"","sources":["../../src/figma/sanitizeSvg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,6EAA6E;AAC7E,SAAS,aAAa,CAAC,KAAa,EAAE,OAAe,EAAE,WAAmB;IACxE,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,IAAI,CAAC;IACT,GAAG,CAAC;QACF,IAAI,GAAG,GAAG,CAAC;QACX,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC,QAAQ,GAAG,KAAK,IAAI,EAAE;IACvB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,sCAAsC,EAAE,EAAE,CAAC,CAAC;IACrE,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACpD,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,oCAAoC,EAAE,EAAE,CAAC,CAAC;IACnE,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,oDAAoD,EAAE,EAAE,CAAC,CAAC;IACnF,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,4BAA4B,EAAE,EAAE,CAAC,CAAC;IAC3D,4EAA4E;IAC5E,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,6CAA6C,EAAE,EAAE,CAAC,CAAC;IACrE,qDAAqD;IACrD,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,4BAA4B,EAAE,EAAE,CAAC,CAAC;IAC3D,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,4BAA4B,EAAE,EAAE,CAAC,CAAC;IAC3D,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,8BAA8B,EAAE,EAAE,CAAC,CAAC;IAC7D,2EAA2E;IAC3E,wEAAwE;IACxE,oDAAoD;IACpD,yEAAyE;IACzE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,uCAAuC,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,KAAa,EAAE,EAAE,CAC5F,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAC9B,CAAC;IACF,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,uCAAuC,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,KAAa,EAAE,EAAE,CAC5F,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAC9B,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAC1D,CAAC"}

package/dist/figma/tokensToVariables.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Phase 2 translator: figma variables → composition brand-variable entries,
+ * a human-readable sidecar, and binding-index records (design spec §6, §7.1).
+ *
+ * Pure — REST payload in, artifacts out. Alias chains are walked to the leaf
+ * value (cycle-safe) but the binding records the semantic id the designer
+ * bound, so a swapped primitive doesn't orphan the link.
+ */
+import type { FigmaVariablesResult } from "./client";
+import type { FigmaBindingRecord } from "./bindings";
+/** data-composition-variables entry (runtime getVariables contract). */
+export interface CompositionVariableEntry {
+    id: string;
+    type: "string" | "number" | "color" | "boolean";
+    label: string;
+    default: string | number | boolean;
+    brandRole?: string;
+}
+export interface FigmaTokenSidecarEntry {
+    name: string;
+    type: string;
+    figmaId: string;
+    key?: string;
+    value: string | number | boolean | null;
+}
+export interface FigmaTokensSidecar {
+    source: TokenSource;
+    tokens: FigmaTokenSidecarEntry[];
+}
+export interface TokenSource {
+    fileKey: string;
+    version: string;
+}
+export interface TokensToVariablesResult {
+    entries: CompositionVariableEntry[];
+    bindings: FigmaBindingRecord[];
+    sidecar: FigmaTokensSidecar;
+}
+export declare function tokensToVariables(vars: FigmaVariablesResult, source: TokenSource): TokensToVariablesResult;
+//# sourceMappingURL=tokensToVariables.d.ts.map

package/dist/figma/tokensToVariables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokensToVariables.d.ts","sourceRoot":"","sources":["../../src/figma/tokensToVariables.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAwB,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD,wEAAwE;AACxE,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AA4ED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,WAAW,GAClB,uBAAuB,CAgDzB"}