@contentful/experience-design-system-generation 2.35.1-dev-build-fa950e44.0 → 2.35.1-dev-build-b8da2525.0

package/dist/src/services/parsing/helpers/parse-selection-slot-evidence.js

@@ -0,0 +1,66 @@
+export function parseSelectionSlotEvidence(value, warnings) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value)) {
+        warnings.push("slot_evidence must be an array — ignored");
+        return undefined;
+    }
+    const evidence = [];
+    for (const [index, candidate] of value.entries()) {
+        if (typeof candidate !== "object" || candidate === null) {
+            warnings.push(`slot_evidence[${index}] must be an object — skipped`);
+            continue;
+        }
+        const record = candidate;
+        const evidenceItems = record.evidence;
+        if (typeof record.name !== "string" ||
+            typeof record.is_real_slot !== "boolean" ||
+            typeof record.reason !== "string" ||
+            !Array.isArray(evidenceItems)) {
+            warnings.push(`slot_evidence[${index}] is missing name, is_real_slot, reason, or evidence — skipped`);
+            continue;
+        }
+        const citations = [];
+        for (const [citationIndex, citation] of evidenceItems.entries()) {
+            if (typeof citation !== "object" || citation === null)
+                continue;
+            const citationRecord = citation;
+            if (typeof citationRecord.source === "string" &&
+                typeof citationRecord.line === "string" &&
+                typeof citationRecord.quote === "string") {
+                citations.push({
+                    source: citationRecord.source,
+                    line: citationRecord.line,
+                    quote: citationRecord.quote,
+                });
+            }
+            else {
+                warnings.push(`slot_evidence[${index}].evidence[${citationIndex}] is missing source, line, or quote — skipped`);
+            }
+        }
+        if (record.is_real_slot && citations.length === 0) {
+            warnings.push(`slot_evidence[${index}] marks a real slot without citation evidence — skipped`);
+            continue;
+        }
+        const allowedComponents = record.allowed_components;
+        if (allowedComponents !== undefined &&
+            (!Array.isArray(allowedComponents) ||
+                !allowedComponents.every((component) => typeof component === "string"))) {
+            warnings.push(`slot_evidence[${index}].allowed_components must be an array of names — skipped`);
+            continue;
+        }
+        if (record.is_real_slot &&
+            (!Array.isArray(allowedComponents) || allowedComponents.length === 0)) {
+            warnings.push(`slot_evidence[${index}] marks a real slot without allowed_components — skipped`);
+            continue;
+        }
+        evidence.push({
+            name: record.name,
+            is_real_slot: record.is_real_slot,
+            ...(allowedComponents ? { allowed_components: allowedComponents } : {}),
+            evidence: citations,
+            reason: record.reason,
+        });
+    }
+    return evidence;
+}

package/dist/src/services/parsing/helpers/read-tool-call-objects.js

@@ -7,16 +7,16 @@ function findJsonObjectEnd(line) {
         if (escaped) {
             escaped = false;
         }
-        else if (ch === '\\' && inString) {
+        else if (ch === "\\" && inString) {
             escaped = true;
         }
         else if (ch === '"') {
             inString = !inString;
         }
-        else if (!inString && ch === '{') {
+        else if (!inString && ch === "{") {
             depth++;
         }
-        else if (!inString && ch === '}' && --depth === 0) {
+        else if (!inString && ch === "}" && --depth === 0) {
             return i;
         }
     }
@@ -25,9 +25,9 @@ function findJsonObjectEnd(line) {
 export function readToolCallObjects(stdout) {
     const objects = [];
     const warnings = [];
-    for (const raw of stdout.split('\n')) {
+    for (const raw of stdout.split("\n")) {
         const line = raw.trim();
-        if (!line.startsWith('{'))
+        if (!line.startsWith("{"))
             continue;
         const end = findJsonObjectEnd(line);
         if (end === -1) {
@@ -46,7 +46,7 @@ export function readToolCallObjects(stdout) {
         if (trailing.trim()) {
             warnings.push(`ignored trailing content after JSON: ${trailing.trim().slice(0, 120)}`);
         }
-        if (typeof parsed === 'object' && parsed !== null && 'tool' in parsed) {
+        if (typeof parsed === "object" && parsed !== null && "tool" in parsed) {
             objects.push(parsed);
         }
     }

package/dist/src/services/parsing/parse-map-token-tool-calls.d.ts

@@ -1,2 +1,2 @@
-import type { ParsedMapTokenPropToolCalls } from '../../types/tool-calls.js';
+import type { ParsedMapTokenPropToolCalls } from "../../types/tool-calls.js";
 export declare function parseMapTokenPropToolCallLines(stdout: string): ParsedMapTokenPropToolCalls;

package/dist/src/services/parsing/parse-map-token-tool-calls.js

@@ -1,12 +1,12 @@
 function isStringArray(value) {
-    return Array.isArray(value) && value.every((v) => typeof v === 'string');
+    return Array.isArray(value) && value.every((v) => typeof v === "string");
 }
 export function parseMapTokenPropToolCallLines(stdout) {
     const calls = [];
     const warnings = [];
-    for (const raw of stdout.split('\n')) {
+    for (const raw of stdout.split("\n")) {
         const line = raw.trim();
-        if (!line.startsWith('{'))
+        if (!line.startsWith("{"))
             continue;
         let obj;
         try {
@@ -16,16 +16,16 @@ export function parseMapTokenPropToolCallLines(stdout) {
             warnings.push(`unparseable line: ${line.slice(0, 120)}`);
             continue;
         }
-        if (typeof obj !== 'object' || obj === null || !('tool' in obj))
+        if (typeof obj !== "object" || obj === null || !("tool" in obj))
             continue;
         const rec = obj;
-        if (rec.tool !== 'map_token_prop')
+        if (rec.tool !== "map_token_prop")
             continue;
-        if (typeof rec.component !== 'string' || !rec.component) {
-            warnings.push('map_token_prop missing component — skipped');
+        if (typeof rec.component !== "string" || !rec.component) {
+            warnings.push("map_token_prop missing component — skipped");
             continue;
         }
-        if (typeof rec.prop !== 'string' || !rec.prop) {
+        if (typeof rec.prop !== "string" || !rec.prop) {
             warnings.push(`map_token_prop '${rec.component}': missing prop — skipped`);
             continue;
         }
@@ -33,7 +33,12 @@ export function parseMapTokenPropToolCallLines(stdout) {
             warnings.push(`map_token_prop '${rec.component}.${String(rec.prop)}': missing or empty token_allowed — skipped`);
             continue;
         }
-        calls.push({ tool: 'map_token_prop', component: rec.component, prop: rec.prop, token_allowed: rec.token_allowed });
+        calls.push({
+            tool: "map_token_prop",
+            component: rec.component,
+            prop: rec.prop,
+            token_allowed: rec.token_allowed,
+        });
     }
     return { calls, warnings };
 }

package/dist/src/services/parsing/parse-prop-tool-calls.d.ts

@@ -1,2 +1,2 @@
-import type { ParsedToolCalls } from '../../types/tool-calls.js';
+import type { ParsedToolCalls } from "../../types/tool-calls.js";
 export declare function parsePropToolCallLines(stdout: string): ParsedToolCalls;

package/dist/src/services/parsing/parse-prop-tool-calls.js

@@ -1,7 +1,19 @@
-import { readToolCallObjects } from './helpers/read-tool-call-objects.js';
-const VALID_TOOL_NAMES = new Set(['classify_prop', 'exclude_prop', 'classify_component', 'classify_slot']);
-const VALID_CDF_TYPES = new Set(['string', 'richtext', 'media', 'enum', 'token', 'boolean']);
-const VALID_CATEGORIES = new Set(['content', 'design', 'state']);
+import { readToolCallObjects } from "./helpers/read-tool-call-objects.js";
+const VALID_TOOL_NAMES = new Set([
+    "classify_prop",
+    "exclude_prop",
+    "classify_component",
+    "classify_slot",
+]);
+const VALID_CDF_TYPES = new Set([
+    "string",
+    "richtext",
+    "media",
+    "enum",
+    "token",
+    "boolean",
+]);
+const VALID_CATEGORIES = new Set(["content", "design", "state"]);
 export function parsePropToolCallLines(stdout) {
     const calls = [];
     const { objects, warnings } = readToolCallObjects(stdout);
@@ -11,78 +23,86 @@ export function parsePropToolCallLines(stdout) {
             continue;
         }
         const tool = rec.tool;
-        if (tool === 'classify_prop') {
-            if (typeof rec.prop !== 'string' || !rec.prop) {
-                warnings.push('classify_prop missing prop name — skipped');
+        if (tool === "classify_prop") {
+            if (typeof rec.prop !== "string" || !rec.prop) {
+                warnings.push("classify_prop missing prop name — skipped");
                 continue;
             }
-            if (typeof rec.cdf_type !== 'string' || !VALID_CDF_TYPES.has(rec.cdf_type)) {
+            if (typeof rec.cdf_type !== "string" ||
+                !VALID_CDF_TYPES.has(rec.cdf_type)) {
                 warnings.push(`classify_prop '${rec.prop}': invalid cdf_type '${String(rec.cdf_type)}' — skipped`);
                 continue;
             }
-            if (typeof rec.cdf_category !== 'string' || !VALID_CATEGORIES.has(rec.cdf_category)) {
+            if (typeof rec.cdf_category !== "string" ||
+                !VALID_CATEGORIES.has(rec.cdf_category)) {
                 warnings.push(`classify_prop '${rec.prop}': invalid cdf_category '${String(rec.cdf_category)}' — skipped`);
                 continue;
             }
             const call = {
-                tool: 'classify_prop',
+                tool: "classify_prop",
                 prop: rec.prop,
                 cdf_type: rec.cdf_type,
                 cdf_category: rec.cdf_category,
             };
-            if (Array.isArray(rec.values) && rec.values.every((v) => typeof v === 'string'))
+            if (Array.isArray(rec.values) &&
+                rec.values.every((v) => typeof v === "string"))
                 call.values = rec.values;
-            if (typeof rec.token_kind === 'string')
+            if (typeof rec.token_kind === "string")
                 call.token_kind = rec.token_kind;
-            if (typeof rec.required === 'boolean')
+            if (typeof rec.required === "boolean")
                 call.required = rec.required;
-            if (typeof rec.description === 'string')
+            if (typeof rec.description === "string")
                 call.description = rec.description;
-            if (typeof rec.default === 'string' || typeof rec.default === 'boolean')
+            if (typeof rec.default === "string" || typeof rec.default === "boolean")
                 call.default = rec.default;
-            if (typeof rec.reason === 'string')
+            if (typeof rec.reason === "string")
                 call.reason = rec.reason;
             calls.push(call);
         }
-        else if (tool === 'exclude_prop') {
-            if (typeof rec.prop !== 'string' || !rec.prop) {
-                warnings.push('exclude_prop missing prop name — skipped');
+        else if (tool === "exclude_prop") {
+            if (typeof rec.prop !== "string" || !rec.prop) {
+                warnings.push("exclude_prop missing prop name — skipped");
                 continue;
             }
-            calls.push({ tool: 'exclude_prop', prop: rec.prop, reason: typeof rec.reason === 'string' ? rec.reason : '' });
+            calls.push({
+                tool: "exclude_prop",
+                prop: rec.prop,
+                reason: typeof rec.reason === "string" ? rec.reason : "",
+            });
         }
-        else if (tool === 'classify_component') {
-            const call = { tool: 'classify_component' };
-            if (typeof rec.description === 'string')
+        else if (tool === "classify_component") {
+            const call = { tool: "classify_component" };
+            if (typeof rec.description === "string")
                 call.description = rec.description;
-            if (typeof rec.rationale === 'object' && rec.rationale !== null) {
+            if (typeof rec.rationale === "object" && rec.rationale !== null) {
                 const r = rec.rationale;
                 const rationale = {};
-                if (typeof r.description === 'string')
+                if (typeof r.description === "string")
                     rationale.description = r.description;
-                if (typeof r.props === 'string')
+                if (typeof r.props === "string")
                     rationale.props = r.props;
-                if (typeof r.slots === 'string')
+                if (typeof r.slots === "string")
                     rationale.slots = r.slots;
                 if (Object.keys(rationale).length > 0)
                     call.rationale = rationale;
             }
             calls.push(call);
         }
-        else if (tool === 'classify_slot') {
-            if (typeof rec.slot !== 'string' || !rec.slot) {
-                warnings.push('classify_slot missing slot name — skipped');
+        else if (tool === "classify_slot") {
+            if (typeof rec.slot !== "string" || !rec.slot) {
+                warnings.push("classify_slot missing slot name — skipped");
                 continue;
             }
-            const call = { tool: 'classify_slot', slot: rec.slot };
-            if (typeof rec.required === 'boolean')
+            const call = { tool: "classify_slot", slot: rec.slot };
+            if (typeof rec.required === "boolean")
                 call.required = rec.required;
-            if (Array.isArray(rec.allowed_components) && rec.allowed_components.every((v) => typeof v === 'string')) {
+            if (Array.isArray(rec.allowed_components) &&
+                rec.allowed_components.every((v) => typeof v === "string")) {
                 call.allowed_components = rec.allowed_components;
             }
-            if (typeof rec.description === 'string')
+            if (typeof rec.description === "string")
                 call.description = rec.description;
-            if (typeof rec.rationale === 'string')
+            if (typeof rec.rationale === "string")
                 call.rationale = rec.rationale;
             calls.push(call);
         }

package/dist/src/services/parsing/parse-select-tool-calls.d.ts

@@ -1,2 +1,2 @@
-import type { ParsedSelectToolCalls } from '../../types/tool-calls.js';
+import type { ParsedSelectToolCalls } from "../../types/tool-calls.js";
 export declare function parseSelectToolCallLines(stdout: string): ParsedSelectToolCalls;

package/dist/src/services/parsing/parse-select-tool-calls.js

@@ -1,26 +1,40 @@
-import { readToolCallObjects } from './helpers/read-tool-call-objects.js';
-const VALID_SELECT_TOOL_NAMES = new Set(['select_component', 'reject_component']);
+import { parseSelectionSlotEvidence } from "./helpers/parse-selection-slot-evidence.js";
+import { readToolCallObjects } from "./helpers/read-tool-call-objects.js";
+const VALID_SELECT_TOOL_NAMES = new Set([
+    "select_component",
+    "reject_component",
+]);
 export function parseSelectToolCallLines(stdout) {
     const calls = [];
     const { objects, warnings } = readToolCallObjects(stdout);
     for (const rec of objects) {
         if (!VALID_SELECT_TOOL_NAMES.has(rec.tool))
             continue;
-        if (typeof rec.name !== 'string' || !rec.name) {
+        if (typeof rec.name !== "string" || !rec.name) {
             warnings.push(`${String(rec.tool)} missing name — skipped`);
             continue;
         }
-        const call = { tool: rec.tool, name: rec.name };
-        if (typeof rec.reason === 'string')
+        const call = {
+            tool: rec.tool,
+            name: rec.name,
+        };
+        if (typeof rec.reason === "string")
             call.reason = rec.reason;
-        if (typeof rec.confidence === 'number' && rec.confidence >= 1 && rec.confidence <= 5) {
-            if (call.tool === 'select_component') {
+        if (typeof rec.confidence === "number" &&
+            rec.confidence >= 1 &&
+            rec.confidence <= 5) {
+            if (call.tool === "select_component") {
                 call.confidence = rec.confidence;
             }
             else {
                 call.confidence = rec.confidence;
             }
         }
+        if (call.tool === "select_component") {
+            const slotEvidence = parseSelectionSlotEvidence(rec.slot_evidence, warnings);
+            if (slotEvidence !== undefined)
+                call.slot_evidence = slotEvidence;
+        }
         calls.push(call);
     }
     return { calls, warnings };

package/dist/src/services/parsing/parse-token-tool-calls.d.ts

@@ -1,2 +1,2 @@
-import type { ParsedTokenToolCalls } from '../../types/tool-calls.js';
+import type { ParsedTokenToolCalls } from "../../types/tool-calls.js";
 export declare function parseTokenToolCallLines(stdout: string): ParsedTokenToolCalls;

package/dist/src/services/parsing/parse-token-tool-calls.js

@@ -1,36 +1,41 @@
-import { readToolCallObjects } from './helpers/read-tool-call-objects.js';
-const VALID_TOKEN_TOOL_NAMES = new Set(['set_token', 'set_group']);
+import { readToolCallObjects } from "./helpers/read-tool-call-objects.js";
+const VALID_TOKEN_TOOL_NAMES = new Set(["set_token", "set_group"]);
 export function parseTokenToolCallLines(stdout) {
     const calls = [];
     const { objects, warnings } = readToolCallObjects(stdout);
     for (const rec of objects) {
         if (!VALID_TOKEN_TOOL_NAMES.has(rec.tool))
             continue;
-        if (rec.tool === 'set_token') {
-            if (typeof rec.path !== 'string' || !rec.path) {
-                warnings.push('set_token missing path — skipped');
+        if (rec.tool === "set_token") {
+            if (typeof rec.path !== "string" || !rec.path) {
+                warnings.push("set_token missing path — skipped");
                 continue;
             }
-            if (typeof rec.type !== 'string' || !rec.type) {
+            if (typeof rec.type !== "string" || !rec.type) {
                 warnings.push(`set_token '${rec.path}': missing type — skipped`);
                 continue;
             }
-            if (!('value' in rec)) {
+            if (!("value" in rec)) {
                 warnings.push(`set_token '${rec.path}': missing value — skipped`);
                 continue;
             }
-            const call = { tool: 'set_token', path: rec.path, type: rec.type, value: rec.value };
-            if (typeof rec.description === 'string')
+            const call = {
+                tool: "set_token",
+                path: rec.path,
+                type: rec.type,
+                value: rec.value,
+            };
+            if (typeof rec.description === "string")
                 call.description = rec.description;
             calls.push(call);
         }
-        else if (rec.tool === 'set_group') {
-            if (typeof rec.path !== 'string' || !rec.path) {
-                warnings.push('set_group missing path — skipped');
+        else if (rec.tool === "set_group") {
+            if (typeof rec.path !== "string" || !rec.path) {
+                warnings.push("set_group missing path — skipped");
                 continue;
             }
-            const call = { tool: 'set_group', path: rec.path };
-            if (typeof rec.description === 'string')
+            const call = { tool: "set_group", path: rec.path };
+            if (typeof rec.description === "string")
                 call.description = rec.description;
             calls.push(call);
         }

package/dist/src/services/prompts/build-prompt.d.ts

@@ -1,4 +1,4 @@
-import type { PromptOptions, Skill } from '../../types/prompt.js';
-export { resolveSkillPath, formatCustomPromptBanner } from './helpers/resolve-skill-file.js';
+import type { PromptOptions, Skill } from "../../types/prompt.js";
+export { resolveSkillPath, formatCustomPromptBanner, } from "./helpers/resolve-skill-file.js";
 export type { Skill };
 export declare function buildPrompt(options: PromptOptions): Promise<string>;

package/dist/src/services/prompts/build-prompt.js

@@ -1,8 +1,9 @@
-import { readSkillFile } from './helpers/resolve-skill-file.js';
-import { buildPreamble } from './helpers/build-preamble.js';
-export { resolveSkillPath, formatCustomPromptBanner } from './helpers/resolve-skill-file.js';
+import { readSkillFile } from "./helpers/resolve-skill-file.js";
+import { buildPreamble } from "./helpers/build-preamble.js";
+export { resolveSkillPath, formatCustomPromptBanner, } from "./helpers/resolve-skill-file.js";
 export async function buildPrompt(options) {
-    const skillContent = options.skillContentOverride ?? (await readSkillFile(options.skill, options.skillPathOverride));
+    const skillContent = options.skillContentOverride ??
+        (await readSkillFile(options.skill, options.skillPathOverride));
     const preamble = buildPreamble(options);
     return `${preamble}\n\nSkill instructions follow:\n---\n${skillContent}`;
 }

package/dist/src/services/prompts/helpers/build-preamble.d.ts

@@ -1,2 +1,2 @@
-import type { PromptOptions } from '../../../types/prompt.js';
+import type { PromptOptions } from "../../../types/prompt.js";
 export declare function buildPreamble(options: PromptOptions): string;

package/dist/src/services/prompts/helpers/build-preamble.js

@@ -1,8 +1,8 @@
-import { inferFenceLang, filterDesignTokenProps, buildTokenCandidateSections } from './format-token-candidates.js';
-import { formatSourceRefsSection } from './format-source-refs.js';
-import { buildComponentsAutonomousPreamble, buildSelectAutonomousPreamble, buildMapTokensAutonomousPreamble, buildTokensAutonomousPreamble, } from './build-skill-preambles.js';
+import { inferFenceLang, filterDesignTokenProps, buildTokenCandidateSections, } from "./format-token-candidates.js";
+import { formatSourceRefsSection } from "./format-source-refs.js";
+import { buildComponentsAutonomousPreamble, buildSelectAutonomousPreamble, buildMapTokensAutonomousPreamble, buildTokensAutonomousPreamble, } from "./build-skill-preambles.js";
 export function buildPreamble(options) {
-    const { skill, rawComponentsInline, rawTokensInline, rawTokensFilename, tokensInline, tokenMapInline, generatedCdf, tokenTree, componentSourceRefs, existingComponentsInline, existingTokensInline, componentAllowlistInline, } = options;
+    const { skill, rawComponentsInline, propBucketsInline, rawTokensInline, rawTokensFilename, tokensInline, tokenMapInline, generatedCdf, tokenTree, componentSourceRefs, existingComponentsInline, existingTokensInline, componentAllowlistInline, } = options;
     const sections = [];
     if (existingComponentsInline) {
         sections.push(`Existing components in the target Contentful space (JSON) — use for alignment, not as a hard filter:\n\`\`\`json\n${existingComponentsInline}\n\`\`\``);
@@ -16,9 +16,14 @@ export function buildPreamble(options) {
     if (rawComponentsInline) {
         sections.push(`Raw component data (JSON):\n\`\`\`json\n${rawComponentsInline}\n\`\`\``);
     }
+    if (propBucketsInline) {
+        sections.push(`Deterministic prop buckets (advisory evidence only; verify against source and do not treat as inclusion or category decisions):\n\`\`\`json\n${propBucketsInline}\n\`\`\``);
+    }
     if (rawTokensInline) {
         const lang = inferFenceLang(rawTokensFilename);
-        const label = rawTokensFilename ? `Raw token source (${rawTokensFilename})` : 'Raw token source';
+        const label = rawTokensFilename
+            ? `Raw token source (${rawTokensFilename})`
+            : "Raw token source";
         sections.push(`${label}:\n\`\`\`${lang}\n${rawTokensInline}\n\`\`\``);
     }
     if (tokensInline) {
@@ -27,8 +32,11 @@ export function buildPreamble(options) {
     if (tokenMapInline) {
         sections.push(`Token-name sidecar (raw name → DTCG path):\n\`\`\`json\n${tokenMapInline}\n\`\`\``);
     }
-    const filteredTokenProps = generatedCdf ? filterDesignTokenProps(generatedCdf) : undefined;
-    if (filteredTokenProps && Object.keys(filteredTokenProps.filtered).length > 0) {
+    const filteredTokenProps = generatedCdf
+        ? filterDesignTokenProps(generatedCdf)
+        : undefined;
+    if (filteredTokenProps &&
+        Object.keys(filteredTokenProps.filtered).length > 0) {
         sections.push(`Generated CDF so far — design-category token props only (JSON):\n\`\`\`json\n${JSON.stringify(filteredTokenProps.filtered)}\n\`\`\``);
     }
     if (tokenTree) {
@@ -37,12 +45,12 @@ export function buildPreamble(options) {
     if (componentSourceRefs && componentSourceRefs.length > 0) {
         sections.push(...formatSourceRefsSection(componentSourceRefs, skill));
     }
-    const inputBlock = sections.length > 0 ? `\n\n${sections.join('\n\n')}` : '';
-    if (skill === 'components')
+    const inputBlock = sections.length > 0 ? `\n\n${sections.join("\n\n")}` : "";
+    if (skill === "components")
         return buildComponentsAutonomousPreamble(inputBlock);
-    if (skill === 'select')
+    if (skill === "select")
         return buildSelectAutonomousPreamble(inputBlock);
-    if (skill === 'map-tokens')
+    if (skill === "map-tokens")
         return buildMapTokensAutonomousPreamble(inputBlock);
     return buildTokensAutonomousPreamble(inputBlock);
 }

package/dist/src/services/prompts/helpers/format-source-refs.d.ts

@@ -1,2 +1,2 @@
-import type { ComponentSourceRef, Skill } from '../../../types/prompt.js';
+import type { ComponentSourceRef, Skill } from "../../../types/prompt.js";
 export declare function formatSourceRefsSection(refs: ComponentSourceRef[], skill: Skill): string[];

package/dist/src/services/prompts/helpers/format-source-refs.js

@@ -1,30 +1,30 @@
-import { inferFenceLang } from './format-token-candidates.js';
+import { inferFenceLang } from "./format-token-candidates.js";
 function formatSourceRefBlock(ref) {
     const mainBlock = `#### ${ref.component} (\`${ref.sourcePath}\`)\n\`\`\`${inferFenceLang(ref.sourcePath)}\n${ref.content}\n\`\`\``;
     const siblingBlocks = (ref.siblingFiles ?? []).map((sibling) => `##### ${ref.component} — imported file \`${sibling.path}\`\n\`\`\`${inferFenceLang(sibling.path)}\n${sibling.content}\n\`\`\``);
     const truncationNote = ref.truncatedSiblingCount && ref.truncatedSiblingCount > 0
         ? [
-            `##### ${ref.component} — +${ref.truncatedSiblingCount} more imported file${ref.truncatedSiblingCount === 1 ? '' : 's'} not shown (evidence may be incomplete)`,
+            `##### ${ref.component} — +${ref.truncatedSiblingCount} more imported file${ref.truncatedSiblingCount === 1 ? "" : "s"} not shown (evidence may be incomplete)`,
         ]
         : [];
     const notShownNote = ref.usesNotShown && ref.usesNotShown.length > 0
         ? [
-            `##### ${ref.component} — uses not shown: ${ref.usesNotShown.join(', ')}\n\nThe files above are excerpts, and each of these properties has at least one use that fell outside the excerpt budget. Treat their consumption as unknown, not absent: do not classify them \`token\` on what is shown, and do not conclude they are unread.`,
+            `##### ${ref.component} — uses not shown: ${ref.usesNotShown.join(", ")}\n\nThe files above are excerpts, and each of these properties has at least one use that fell outside the excerpt budget. Treat their consumption as unknown, not absent: do not classify them \`token\` on what is shown, and do not conclude they are unread.`,
         ]
         : [];
-    return [mainBlock, ...siblingBlocks, ...truncationNote, ...notShownNote].join('\n\n');
+    return [mainBlock, ...siblingBlocks, ...truncationNote, ...notShownNote].join("\n\n");
 }
 export function formatSourceRefsSection(refs, skill) {
     const sections = [];
     const withContent = refs.filter((ref) => ref.content != null);
     const withoutContent = refs.filter((ref) => ref.content == null);
     if (withContent.length > 0) {
-        sections.push(`### Component source references\n\n${withContent.map(formatSourceRefBlock).join('\n\n')}`);
+        sections.push(`### Component source references\n\n${withContent.map(formatSourceRefBlock).join("\n\n")}`);
     }
     if (withoutContent.length > 0) {
-        const guidance = skill === 'components'
-            ? 'there is no consumption evidence for these, so `token` cannot be earned for any of their props — classify from the prop signature alone, and any prop that would otherwise be enum-versus-token is `enum` (or `string`)'
-            : 'there is no source evidence to narrow from — emit nothing for their props';
+        const guidance = skill === "components"
+            ? "there is no consumption evidence for these, so `token` cannot be earned for any of their props — classify from the prop signature alone, and any prop that would otherwise be enum-versus-token is `enum` (or `string`)"
+            : "there is no source evidence to narrow from — emit nothing for their props";
         sections.push(`Component source unavailable for (JSON) — ${guidance}:\n\`\`\`json\n${JSON.stringify(withoutContent.map((ref) => ({ component: ref.component, sourcePath: ref.sourcePath })))}\n\`\`\``);
     }
     return sections;

package/dist/src/services/prompts/helpers/format-token-candidates.d.ts

@@ -1,4 +1,4 @@
-import type { GeneratedCdf } from '../../../types/prompt.js';
+import type { GeneratedCdf } from "../../../types/prompt.js";
 export declare function inferFenceLang(filename: string | undefined): string;
 export declare function filterDesignTokenProps(cdf: GeneratedCdf): {
     filtered: GeneratedCdf;