@contentful/experience-design-system-generation 2.35.1-dev-build-35ec3f8d.0 → 2.35.1-dev-build-9605c7ee.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-generation",
-  "version": "2.35.1-dev-build-35ec3f8d.0",
+  "version": "2.35.1-dev-build-9605c7ee.0",
   "description": "Agent-invocation and skill-prompt engine for the Contentful Experience Design System SDK",
   "license": "MIT",
   "type": "module",

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

@@ -1,4 +1,4 @@
 import type { PromptOptions, Skill } from '../../types/prompt.js';
-export declare function resolveSkillPath(skill: Skill): string;
-export declare function formatCustomPromptBanner(skill: 'components' | 'select', path: string): string;
+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,126 +1,6 @@
-import { existsSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { inferFenceLang, filterDesignTokenProps, buildTokenCandidateSections, } from './helpers/format-token-candidates.js';
-import { buildComponentsAutonomousPreamble, buildSelectAutonomousPreamble, buildMapTokensAutonomousPreamble, buildTokensAutonomousPreamble, } from './helpers/build-skill-preambles.js';
-const SKILL_FILES = {
-    components: 'generate-components.md',
-    tokens: 'generate-tokens.md',
-    select: 'select-components.md',
-    'map-tokens': 'map-tokens.md',
-};
-export function resolveSkillPath(skill) {
-    if (!(skill in SKILL_FILES))
-        throw new Error(`Invalid skill: ${skill}`);
-    const thisDir = dirname(fileURLToPath(import.meta.url));
-    let dir = thisDir;
-    for (;;) {
-        const candidate = join(dir, 'skills');
-        if (existsSync(candidate))
-            return join(candidate, SKILL_FILES[skill]);
-        const parent = resolve(dir, '..');
-        if (parent === dir) {
-            throw new Error(`skill file missing from CLI installation (could not locate skills/ directory from: ${thisDir})`);
-        }
-        dir = parent;
-    }
-}
-export function formatCustomPromptBanner(skill, path) {
-    return (`WARNING: Custom prompt active for ${skill}: ${path}\n` +
-        `  Bundled invariants (utility-wrapper rejection, description content rules) do NOT apply.\n` +
-        `  You are responsible for the prompt's correctness.\n`);
-}
-async function readSkillFile(skill, override) {
-    if (override) {
-        const skillPath = resolve(override);
-        try {
-            return await readFile(skillPath, 'utf8');
-        }
-        catch {
-            throw new Error(`custom prompt file not found (skill: ${skill}, path: ${skillPath})`);
-        }
-    }
-    const skillPath = resolveSkillPath(skill);
-    try {
-        return await readFile(skillPath, 'utf8');
-    }
-    catch {
-        throw new Error(`skill file missing from CLI installation — try reinstalling the CLI (looked for: ${skillPath})`);
-    }
-}
-function buildPreamble(options) {
-    const { skill, rawComponentsInline, 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\`\`\``);
-    }
-    if (existingTokensInline) {
-        sections.push(`Existing design tokens in the target Contentful space (JSON) — prefer binding to these paths over inventing new ones:\n\`\`\`json\n${existingTokensInline}\n\`\`\``);
-    }
-    if (componentAllowlistInline) {
-        sections.push(`Known component names for slot allowed_components (hard allowlist; never use any other name):\n\`\`\`json\n${componentAllowlistInline}\n\`\`\``);
-    }
-    if (rawComponentsInline) {
-        sections.push(`Raw component data (JSON):\n\`\`\`json\n${rawComponentsInline}\n\`\`\``);
-    }
-    if (rawTokensInline) {
-        const lang = inferFenceLang(rawTokensFilename);
-        const label = rawTokensFilename ? `Raw token source (${rawTokensFilename})` : 'Raw token source';
-        sections.push(`${label}:\n\`\`\`${lang}\n${rawTokensInline}\n\`\`\``);
-    }
-    if (tokensInline) {
-        sections.push(`DTCG token data (for token kind lookups):\n\`\`\`json\n${tokensInline}\n\`\`\``);
-    }
-    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) {
-        sections.push(`Generated CDF so far — design-category token props only (JSON):\n\`\`\`json\n${JSON.stringify(filteredTokenProps.filtered)}\n\`\`\``);
-    }
-    if (tokenTree) {
-        for (const section of buildTokenCandidateSections(tokenTree, filteredTokenProps)) {
-            sections.push(section);
-        }
-    }
-    if (componentSourceRefs && componentSourceRefs.length > 0) {
-        const withContent = componentSourceRefs.filter((ref) => ref.content != null);
-        const withoutContent = componentSourceRefs.filter((ref) => ref.content == null);
-        if (withContent.length > 0) {
-            const blocks = withContent.map((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)`,
-                    ]
-                    : [];
-                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.`,
-                    ]
-                    : [];
-                return [mainBlock, ...siblingBlocks, ...truncationNote, ...notShownNote].join('\n\n');
-            });
-            sections.push(`### Component source references\n\n${blocks.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';
-            sections.push(`Component source unavailable for (JSON) — ${guidance}:\n\`\`\`json\n${JSON.stringify(withoutContent.map((ref) => ({ component: ref.component, sourcePath: ref.sourcePath })))}\n\`\`\``);
-        }
-    }
-    const inputBlock = sections.length > 0 ? `\n\n${sections.join('\n\n')}` : '';
-    if (skill === 'components')
-        return buildComponentsAutonomousPreamble(inputBlock);
-    if (skill === 'select')
-        return buildSelectAutonomousPreamble(inputBlock);
-    if (skill === 'map-tokens')
-        return buildMapTokensAutonomousPreamble(inputBlock);
-    return buildTokensAutonomousPreamble(inputBlock);
-}
+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 preamble = buildPreamble(options);

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

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

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

@@ -0,0 +1,48 @@
+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 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\`\`\``);
+    }
+    if (existingTokensInline) {
+        sections.push(`Existing design tokens in the target Contentful space (JSON) — prefer binding to these paths over inventing new ones:\n\`\`\`json\n${existingTokensInline}\n\`\`\``);
+    }
+    if (componentAllowlistInline) {
+        sections.push(`Known component names for slot allowed_components (hard allowlist; never use any other name):\n\`\`\`json\n${componentAllowlistInline}\n\`\`\``);
+    }
+    if (rawComponentsInline) {
+        sections.push(`Raw component data (JSON):\n\`\`\`json\n${rawComponentsInline}\n\`\`\``);
+    }
+    if (rawTokensInline) {
+        const lang = inferFenceLang(rawTokensFilename);
+        const label = rawTokensFilename ? `Raw token source (${rawTokensFilename})` : 'Raw token source';
+        sections.push(`${label}:\n\`\`\`${lang}\n${rawTokensInline}\n\`\`\``);
+    }
+    if (tokensInline) {
+        sections.push(`DTCG token data (for token kind lookups):\n\`\`\`json\n${tokensInline}\n\`\`\``);
+    }
+    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) {
+        sections.push(`Generated CDF so far — design-category token props only (JSON):\n\`\`\`json\n${JSON.stringify(filteredTokenProps.filtered)}\n\`\`\``);
+    }
+    if (tokenTree) {
+        sections.push(...buildTokenCandidateSections(tokenTree, filteredTokenProps));
+    }
+    if (componentSourceRefs && componentSourceRefs.length > 0) {
+        sections.push(...formatSourceRefsSection(componentSourceRefs, skill));
+    }
+    const inputBlock = sections.length > 0 ? `\n\n${sections.join('\n\n')}` : '';
+    if (skill === 'components')
+        return buildComponentsAutonomousPreamble(inputBlock);
+    if (skill === 'select')
+        return buildSelectAutonomousPreamble(inputBlock);
+    if (skill === 'map-tokens')
+        return buildMapTokensAutonomousPreamble(inputBlock);
+    return buildTokensAutonomousPreamble(inputBlock);
+}

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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1,31 @@
+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)`,
+        ]
+        : [];
+    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.`,
+        ]
+        : [];
+    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')}`);
+    }
+    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';
+        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/resolve-skill-file.d.ts

@@ -0,0 +1,4 @@
+import type { Skill } from '../../../types/prompt.js';
+export declare function resolveSkillPath(skill: Skill): string;
+export declare function formatCustomPromptBanner(skill: 'components' | 'select', path: string): string;
+export declare function readSkillFile(skill: Skill, override?: string): Promise<string>;

package/dist/src/services/prompts/helpers/resolve-skill-file.js

@@ -0,0 +1,49 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const SKILL_FILES = {
+    components: 'generate-components.md',
+    tokens: 'generate-tokens.md',
+    select: 'select-components.md',
+    'map-tokens': 'map-tokens.md',
+};
+export function resolveSkillPath(skill) {
+    if (!(skill in SKILL_FILES))
+        throw new Error(`Invalid skill: ${skill}`);
+    const thisDir = dirname(fileURLToPath(import.meta.url));
+    let dir = thisDir;
+    for (;;) {
+        const candidate = join(dir, 'skills');
+        if (existsSync(candidate))
+            return join(candidate, SKILL_FILES[skill]);
+        const parent = resolve(dir, '..');
+        if (parent === dir) {
+            throw new Error(`skill file missing from CLI installation (could not locate skills/ directory from: ${thisDir})`);
+        }
+        dir = parent;
+    }
+}
+export function formatCustomPromptBanner(skill, path) {
+    return (`WARNING: Custom prompt active for ${skill}: ${path}\n` +
+        `  Bundled invariants (utility-wrapper rejection, description content rules) do NOT apply.\n` +
+        `  You are responsible for the prompt's correctness.\n`);
+}
+export async function readSkillFile(skill, override) {
+    if (override) {
+        const skillPath = resolve(override);
+        try {
+            return await readFile(skillPath, 'utf8');
+        }
+        catch {
+            throw new Error(`custom prompt file not found (skill: ${skill}, path: ${skillPath})`);
+        }
+    }
+    const skillPath = resolveSkillPath(skill);
+    try {
+        return await readFile(skillPath, 'utf8');
+    }
+    catch {
+        throw new Error(`skill file missing from CLI installation — try reinstalling the CLI (looked for: ${skillPath})`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-generation",
-  "version": "2.35.1-dev-build-35ec3f8d.0",
+  "version": "2.35.1-dev-build-9605c7ee.0",
   "description": "Agent-invocation and skill-prompt engine for the Contentful Experience Design System SDK",
   "license": "MIT",
   "type": "module",
@@ -22,7 +22,7 @@
     "skills/"
   ],
   "dependencies": {
-    "@contentful/experience-design-system-types": "2.35.1-dev-build-35ec3f8d.0"
+    "@contentful/experience-design-system-types": "2.35.1-dev-build-9605c7ee.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",