@oscharko-dev/keiko 0.2.0-beta.5 → 0.2.0-beta.7

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/a11yBaseline.js

@@ -21,10 +21,13 @@
 // emitted in a stable depth-first / stable-sorted order and carry no timestamp, so the same IR yields
 // a byte-identical result. The baseline is model-free and stands alone; vision augmentation (#810) is
 // layered separately and never replaces these items.
-import { parseHexRgb } from "./color.js";
+import { parseHexRgba } from "./color.js";
 const MIN_TARGET_SIZE = 24;
 const AA_NORMAL = 4.5;
 const AA_LARGE = 3.0;
+const LARGE_TEXT_MIN_PX = 24;
+const LARGE_BOLD_TEXT_MIN_PX = 18.6667;
+const LARGE_TEXT_MIN_WEIGHT = 700;
 // Generous per-screen item cap so a pathologically dense real screen (thousands of TEXT nodes →
 // thousands of contrast checks) cannot make the a11y baseline unbounded in memory/output. Small
 // fixtures stay far below it, so it is invisible except on huge boards. Deterministic: the first
@@ -36,7 +39,7 @@ const INTERACTIVE = new Set(["button", "input", "link"]);
 // sRGB → linear-light channel (WCAG 2.x): c/12.92 below the knee, else ((c+0.055)/1.055)^2.4.
 const linearizeChannel = (channel255) => {
     const c = channel255 / 255;
-    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+    return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
 };
 /** WCAG relative luminance of an sRGB colour: 0 for black, 1 for white. */
 export const relativeLuminance = (rgb) => 0.2126 * linearizeChannel(rgb.r) +
@@ -61,9 +64,10 @@ function a11yItemId(prefix, key) {
     }
     return `${prefix}-${(hash >>> 0).toString(16).padStart(8, "0")}`;
 }
-const a11yItem = (ctx, nodeId, kind, title) => ({
+const a11yItem = (ctx, nodeId, kind, title, outcome) => ({
     id: a11yItemId("fa11y", `${ctx.screenId}|${kind}|${nodeId}`),
     category: "a11y",
+    ...(outcome !== undefined ? { outcome } : {}),
     screenId: ctx.screenId,
     screenName: ctx.screenName,
     sourceNodeId: nodeId,
@@ -79,50 +83,91 @@ const noticeItem = (ctx, nodeId, kind, title) => ({
 });
 // ─── Per-rule derivation ───────────────────────────────────────────────────────────
 const nodeLabel = (node) => node.text !== undefined && node.text.length > 0 ? node.text : node.name;
-// A node's name is "descriptive" only when it is not an opaque Figma node id (e.g. "123:45"). This is
-// structural, not board-specific: it rejects the id syntax, never any particular screen's vocabulary.
-const hasDescriptiveName = (node) => node.name.trim().length > 0 && !/^[0-9]+:[0-9]+$/u.test(node.name.trim());
+const GENERIC_LAYER_NAME = /^(?:frame|rectangle|group|button|instance|component|text|vector|ellipse|line|image|icon)(?:\s+\d+)?$/iu;
+// A node's name is descriptive only when it is neither an opaque Figma node id nor a generic default
+// layer name. This stays structural: it rejects provider-default vocabulary, not board-specific copy.
+const hasDescriptiveName = (node) => {
+    const trimmed = node.name.trim();
+    return (trimmed.length > 0 && !/^[0-9]+:[0-9]+$/u.test(trimmed) && !GENERIC_LAYER_NAME.test(trimmed));
+};
 const hasAccessibleName = (node) => (node.text !== undefined && node.text.trim().length > 0) || hasDescriptiveName(node);
+const isLargeText = (node) => {
+    const typography = node.typography;
+    if (typography === undefined)
+        return false;
+    if (typography.fontSize >= LARGE_TEXT_MIN_PX)
+        return true;
+    return (typography.fontSize >= LARGE_BOLD_TEXT_MIN_PX && typography.fontWeight >= LARGE_TEXT_MIN_WEIGHT);
+};
+const compositeChannel = (foreground, background, alpha) => Math.round(foreground * alpha + background * (1 - alpha));
+const compositeOver = (foreground, background) => {
+    if (foreground.a >= 1)
+        return { r: foreground.r, g: foreground.g, b: foreground.b };
+    return {
+        r: compositeChannel(foreground.r, background.r, foreground.a),
+        g: compositeChannel(foreground.g, background.g, foreground.a),
+        b: compositeChannel(foreground.b, background.b, foreground.a),
+    };
+};
+const resolveBackground = (backgroundColor, inheritedBackground) => {
+    if (backgroundColor === undefined)
+        return inheritedBackground;
+    const ownBackground = parseHexRgba(backgroundColor);
+    if (ownBackground === undefined)
+        return undefined;
+    if (inheritedBackground === undefined && ownBackground.a < 1)
+        return undefined;
+    return compositeOver(ownBackground, inheritedBackground ?? { r: 255, g: 255, b: 255 });
+};
 const contrastItem = (ctx, node, background) => {
-    const fg = node.textColor === undefined ? undefined : parseHexRgb(node.textColor);
-    const bg = background === undefined ? undefined : parseHexRgb(background);
+    const fg = node.textColor === undefined ? undefined : parseHexRgba(node.textColor);
+    const bg = background;
     if (fg === undefined || bg === undefined) {
         return noticeItem(ctx, node.id, "contrast", `Text "${nodeLabel(node)}" needs a verifiable colour contrast: text/background colour could not be resolved from the design tokens`);
     }
-    const ratio = contrastRatio(fg, bg);
+    const renderedFg = compositeOver(fg, bg);
+    const ratio = contrastRatio(renderedFg, bg);
     const rounded = Math.round(ratio * 100) / 100;
-    const verdict = meetsContrastAa(ratio, false)
-        ? `meets WCAG AA (${String(rounded)}:1 ≥ ${String(AA_NORMAL)}:1)`
-        : `is below WCAG AA (${String(rounded)}:1 < ${String(AA_NORMAL)}:1)`;
-    return a11yItem(ctx, node.id, "contrast", `Text "${nodeLabel(node)}" colour contrast ${verdict}`);
+    const largeText = isLargeText(node);
+    const threshold = largeText ? AA_LARGE : AA_NORMAL;
+    const label = largeText ? "WCAG AA large text" : "WCAG AA";
+    const passes = meetsContrastAa(ratio, largeText);
+    const verdict = passes
+        ? `meets ${label} (${String(rounded)}:1 ≥ ${String(threshold)}:1)`
+        : `is below ${label} (${String(rounded)}:1 < ${String(threshold)}:1)`;
+    return a11yItem(ctx, node.id, "contrast", `Text "${nodeLabel(node)}" colour contrast ${verdict}`, passes ? "pass" : "fail");
 };
 const isTooSmall = (box) => box.width < MIN_TARGET_SIZE || box.height < MIN_TARGET_SIZE;
 const byReadingOrder = (a, b) => a.box.y !== b.box.y ? a.box.y - b.box.y : a.box.x - b.box.x;
 // Each rule returns its item (or undefined when the node is out of scope), keeping `visit` flat so
 // its cyclomatic complexity stays within budget. Rules read only structural shape — never copy.
 const nameRule = (ctx, node) => INTERACTIVE.has(node.interactionHint) && !hasAccessibleName(node)
-    ? a11yItem(ctx, node.id, "name", `Interactive "${node.name}" exposes an accessible name`)
+    ? a11yItem(ctx, node.id, "name", `Interactive "${node.name}" needs an accessible name`, "fail")
     : undefined;
-const contrastRule = (ctx, node, background) => node.interactionHint === "text" && node.textColor !== undefined
+const contrastRule = (ctx, node, background) => node.interactionHint === "text" && node.text !== undefined && node.text.trim().length > 0
     ? contrastItem(ctx, node, background)
     : undefined;
+const layoutCoverageRule = (ctx, node) => INTERACTIVE.has(node.interactionHint) && node.boundingBox === undefined
+    ? noticeItem(ctx, node.id, "bounds", `Control "${nodeLabel(node)}" needs verifiable layout bounds: target size and focus order could not be resolved from the Screen-IR`)
+    : undefined;
 const targetSizeRule = (ctx, node) => INTERACTIVE.has(node.interactionHint) &&
     node.boundingBox !== undefined &&
     isTooSmall(node.boundingBox)
-    ? a11yItem(ctx, node.id, "target", `Control "${nodeLabel(node)}" meets the 24×24 minimum target size`)
+    ? a11yItem(ctx, node.id, "target", `Control "${nodeLabel(node)}" does not meet the 24×24 minimum target size`, "fail")
     : undefined;
 const altTextRule = (ctx, node) => node.imageFills.length > 0
-    ? a11yItem(ctx, node.id, "alt", `Image "${node.name}" exposes descriptive alt text`)
+    ? a11yItem(ctx, node.id, "alt", `Image "${node.name}" needs descriptive alt text verification`, "expectation")
     : undefined;
 // Shared constant — see prune.ts for rationale. Must stay in sync with every other recursive walk.
 const MAX_TREE_DEPTH = 512;
 function visitAt(node, ctx, inheritedBackground, acc, depth) {
     if (depth > MAX_TREE_DEPTH)
         return;
-    const background = node.backgroundColor ?? inheritedBackground;
+    const background = resolveBackground(node.backgroundColor, inheritedBackground);
     for (const item of [
         nameRule(ctx, node),
         contrastRule(ctx, node, background),
+        layoutCoverageRule(ctx, node),
         targetSizeRule(ctx, node),
         altTextRule(ctx, node),
     ]) {
@@ -141,7 +186,7 @@ function visit(node, ctx, inheritedBackground, acc) {
 const focusOrderItem = (ctx, focusables) => {
     const ordered = [...focusables].sort(byReadingOrder);
     const sequence = ordered.map((f) => `"${f.label}"`).join(" → ");
-    return a11yItem(ctx, ordered[0]?.nodeId ?? "", "focus-order", `Focus order follows the visual reading order: ${sequence}`);
+    return a11yItem(ctx, ordered[0]?.nodeId ?? "", "focus-order", `Focus order follows the visual reading order: ${sequence}`, "expectation");
 };
 /**
  * Derive the deterministic a11y test items per screen, keyed by the screen they are attributed to.

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/cleanToScreenIr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleanToScreenIr.d.ts","sourceRoot":"","sources":["../../../src/domain/figma/cleanToScreenIr.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAA6B,cAAc,EAAE,MAAM,cAAc,CAAC;AA6B9E,eAAO,MAAM,0BAA0B,GAAI,SAAS,OAAO,KAAG,cAyB7D,CAAC"}
+{"version":3,"file":"cleanToScreenIr.d.ts","sourceRoot":"","sources":["../../../src/domain/figma/cleanToScreenIr.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAA6B,cAAc,EAAE,MAAM,cAAc,CAAC;AA6B9E,eAAO,MAAM,0BAA0B,GAAI,SAAS,OAAO,KAAG,cA4B7D,CAAC"}

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/cleanToScreenIr.js

@@ -49,6 +49,9 @@ export const cleanScopedNodesToScreenIr = (rawRoot) => {
         return { id: ir.id, name: ir.name, root: ir };
     })
         .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    // keptNodeCount counts only IR nodes under detected screens, so surviving scope containers
+    // (CANVAS/SECTION) that are not themselves screens count toward removal. removedRatio is therefore
+    // the fraction of raw input nodes not retained in any screen IR, not the fraction the pruner dropped.
     const keptNodeCount = screens.reduce((sum, screen) => sum + countIrNodes(screen.root), 0);
     return {
         screens,

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/color.d.ts

@@ -2,7 +2,7 @@ import { type FigmaSourceNode } from "./sourceNode.js";
 /**
  * Whether a Figma paint contributes a visible colour. Figma omits `visible` when a paint is shown, so
  * only an explicit `visible:false` hides it (mirrors {@link isHidden} for nodes). A paint-level
- * `opacity:0` or a SOLID `color.a:0` is fully transparent and likewise contributes no visible colour.
+ * `opacity <= 0` or a SOLID `color.a <= 0` is fully transparent and likewise contributes no visible colour.
  * Used so neither the reported text/background colour (#812) nor an extracted colour token (#752) is
  * ever taken from a paint that does not render.
  */
@@ -22,5 +22,10 @@ export interface Rgb {
     readonly g: number;
     readonly b: number;
 }
+export interface Rgba extends Rgb {
+    /** Alpha in the 0..1 range. */
+    readonly a: number;
+}
+export declare const parseHexRgba: (hex: string) => Rgba | undefined;
 export declare const parseHexRgb: (hex: string) => Rgb | undefined;
 //# sourceMappingURL=color.d.ts.map

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/domain/figma/color.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAkC,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAOvF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAO/D,CAAC;AAEF,wGAAwG;AACxG,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MAAM,GAAG,SAUzE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,eAAe,EAAE,KAAK,MAAM,KAAG,MAAM,GAAG,SAWhF,CAAC;AAEF,gDAAgD;AAChD,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,GAAG,GAAG,SAM/C,CAAC"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/domain/figma/color.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAkC,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAOvF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAU/D,CAAC;AAEF,wGAAwG;AACxG,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MAAM,GAAG,SAYzE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,eAAe,EAAE,KAAK,MAAM,KAAG,MAAM,GAAG,SAWhF,CAAC;AAEF,gDAAgD;AAChD,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,IAAK,SAAQ,GAAG;IAC/B,+BAA+B;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,IAAI,GAAG,SAOjD,CAAC;AAGF,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,GAAG,GAAG,SAK/C,CAAC"}

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/color.js

@@ -22,7 +22,7 @@ const channel = (value) => Math.round(Math.min(1, Math.max(0, value)) * 255)
 /**
  * Whether a Figma paint contributes a visible colour. Figma omits `visible` when a paint is shown, so
  * only an explicit `visible:false` hides it (mirrors {@link isHidden} for nodes). A paint-level
- * `opacity:0` or a SOLID `color.a:0` is fully transparent and likewise contributes no visible colour.
+ * `opacity <= 0` or a SOLID `color.a <= 0` is fully transparent and likewise contributes no visible colour.
  * Used so neither the reported text/background colour (#812) nor an extracted colour token (#752) is
  * ever taken from a paint that does not render.
  */
@@ -30,11 +30,14 @@ export const isVisiblePaint = (paint) => {
     if (paint.visible === false)
         return false;
     const opacity = readNumber(paint.opacity);
-    if (opacity === 0)
+    if (opacity !== undefined && opacity <= 0)
         return false;
     const color = asNode(paint.color);
-    if (color !== undefined && readNumber(color.a) === 0)
-        return false;
+    if (color !== undefined) {
+        const alpha = readNumber(color.a);
+        if (alpha !== undefined && alpha <= 0)
+            return false;
+    }
     return true;
 };
 /** Project a Figma paint's `color` ({r,g,b,a} in 0..1) to normalized `#RRGGBB[AA]` (alpha < 1 only). */
@@ -47,7 +50,9 @@ export const paintColorToHex = (paint) => {
     const b = readNumber(color.b);
     if (r === undefined || g === undefined || b === undefined)
         return undefined;
-    const a = readNumber(color.a) ?? 1;
+    const colorAlpha = readNumber(color.a) ?? 1;
+    const paintOpacity = readNumber(paint.opacity) ?? 1;
+    const a = Math.min(1, Math.max(0, colorAlpha)) * Math.min(1, Math.max(0, paintOpacity));
     const base = `#${channel(r)}${channel(g)}${channel(b)}`;
     return a < 1 ? `${base}${channel(a)}` : base;
 };
@@ -73,14 +78,22 @@ export const firstSolidPaintHex = (node, key) => {
     }
     return undefined;
 };
-// Parse the leading `#RRGGBB` of a normalized hex (the optional alpha suffix is ignored for contrast:
-// WCAG contrast is defined on opaque colours and the IR composites onto a solid background). Returns
-// undefined for a malformed value so the caller emits a coverage notice rather than crashing.
-export const parseHexRgb = (hex) => {
+// Parse `#RRGGBB[AA]` into rendered colour channels. Returns undefined for a malformed value so the
+// caller emits a coverage notice rather than crashing.
+export const parseHexRgba = (hex) => {
     if (!/^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/u.test(hex))
         return undefined;
     const r = Number.parseInt(hex.slice(1, 3), 16);
     const g = Number.parseInt(hex.slice(3, 5), 16);
     const b = Number.parseInt(hex.slice(5, 7), 16);
+    const a = hex.length === 9 ? Number.parseInt(hex.slice(7, 9), 16) / 255 : 1;
+    return { r, g, b, a };
+};
+// Legacy RGB parser for callers that intentionally want the opaque leading colour.
+export const parseHexRgb = (hex) => {
+    const parsed = parseHexRgba(hex);
+    if (parsed === undefined)
+        return undefined;
+    const { r, g, b } = parsed;
     return { r, g, b };
 };

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/emissionPlan.d.ts

@@ -13,7 +13,10 @@ export interface EmissionElement {
     readonly layout?: IrLayout;
     /** Per-axis sizing mode threaded from the IR node; absent when not set. */
     readonly sizing?: IrSizing;
-    /** Corner radius in pixels threaded from the IR node; absent when zero or absent. */
+    /**
+     * Corner radius in pixels threaded verbatim from the IR node; absent when the IR omits it. The IR
+     * cleaner (normalize) already drops a zero radius upstream, so this is never 0 in practice.
+     */
     readonly cornerRadius?: number;
     /** Per-TEXT typography threaded from the IR node; absent for non-TEXT nodes. */
     readonly typography?: IrTypography;

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/emissionPlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emissionPlan.d.ts","sourceRoot":"","sources":["../../../src/domain/figma/emissionPlan.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EAER,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,QAAQ,EACT,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,kGAAkG;AAClG,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC;AAE3C,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,4GAA4G;IAC5G,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED,iGAAiG;AACjG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACnD;AAED,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AA2CD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CASxE"}
+{"version":3,"file":"emissionPlan.d.ts","sourceRoot":"","sources":["../../../src/domain/figma/emissionPlan.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EAER,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,QAAQ,EACT,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,kGAAkG;AAClG,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC;AAE3C,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,4GAA4G;IAC5G,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED,iGAAiG;AACjG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACnD;AAED,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAyDD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CAYxE"}

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/emissionPlan.js

@@ -27,6 +27,15 @@ function structuralDisplayName(node) {
         return text;
     return node.interactionHint;
 }
+// Screen names are evidence text too; a tampered/partial record can carry blank names. Keep the
+// first-slice artifact reviewable and navigable without model help by falling back to the screen id.
+function structuralScreenName(screen) {
+    const trimmed = screen.name.trim();
+    if (trimmed.length > 0)
+        return trimmed;
+    const id = screen.id.trim();
+    return id.length > 0 ? id : "Screen";
+}
 function toElement(node) {
     const text = node.text?.trim();
     return {
@@ -47,11 +56,15 @@ function navTargetsFor(screenId, hints, nameByScreenId) {
     const hint = hints.find((h) => h.screenId === screenId);
     if (hint === undefined)
         return [];
-    return hint.transitions.map((transition) => ({
-        trigger: transition.trigger,
-        toScreenId: transition.toScreenId,
-        toScreenName: nameByScreenId.get(transition.toScreenId) ?? transition.toScreenId,
-    }));
+    return hint.transitions.map((transition) => {
+        const fallbackName = transition.toScreenId.trim();
+        return {
+            trigger: transition.trigger,
+            toScreenId: transition.toScreenId,
+            toScreenName: nameByScreenId.get(transition.toScreenId) ??
+                (fallbackName.length > 0 ? fallbackName : "Screen"),
+        };
+    });
 }
 /**
  * Build the target-neutral emission plan from the Screen-IR, design tokens, and routing hints. Pure,
@@ -60,12 +73,15 @@ function navTargetsFor(screenId, hints, nameByScreenId) {
  * plan, so the emitted code is reproducible.
  */
 export function buildEmissionPlan(input) {
-    const nameByScreenId = new Map(input.screens.map((s) => [s.id, s.name]));
-    const screens = input.screens.map((screen) => ({
-        screenId: screen.id,
-        screenName: screen.name,
-        root: toElement(screen.root),
-        navTargets: navTargetsFor(screen.id, input.hints, nameByScreenId),
-    }));
+    const nameByScreenId = new Map(input.screens.map((s) => [s.id, structuralScreenName(s)]));
+    const screens = input.screens.map((screen) => {
+        const screenName = structuralScreenName(screen);
+        return {
+            screenId: screen.id,
+            screenName,
+            root: toElement(screen.root),
+            navTargets: navTargetsFor(screen.id, input.hints, nameByScreenId),
+        };
+    });
     return { screens, tokens: input.tokens };
 }

package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/domain/figma/htmlCssAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"htmlCssAdapter.d.ts","sourceRoot":"","sources":["../../../src/domain/figma/htmlCssAdapter.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAA0B,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAwZxF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,EAAE,iBAG5B,CAAC"}
+{"version":3,"file":"htmlCssAdapter.d.ts","sourceRoot":"","sources":["../../../src/domain/figma/htmlCssAdapter.ts"],"names":[],"mappings":"AA2CA,OAAO,KAAK,EAA0B,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAqfxF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,EAAE,iBAG5B,CAAC"}