@se-studio/contentful-cms 1.0.3 → 1.0.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @se-studio/contentful-cms Changelog
 
+## 1.0.5
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
+## 1.0.4
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
 ## 1.0.3
 
 ### Patch Changes

package/README.md

@@ -231,6 +231,8 @@ Capture a PNG of a component, collection, external component, person, or page. *
 
 Use `--out before.png` / `--out after.png` with `agent-browser diff screenshot` for visual diffing. See the **screenshots** skill for details.
 
+**Batch screenshots:** The `cms-capture-screenshots` script (same package) captures multiple variants to `<app-dir>/docs/cms-guidelines/screenshots/`. Run it from the **monorepo root** so the output path is correct: `node packages/contentful-cms/dist/bin/cms-capture-screenshots.js --variants /tmp/type-variants.json --app-dir apps/example-se2026`.
+
 ### export-converted
 
 Export a session ref's entry as **converted (`IBase*`) JSON** via the app's convert API. Use the output with `screenshot --json-file` for custom variants without a session.

package/dist/bin/cms-capture-screenshots.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+export {};
+//# sourceMappingURL=cms-capture-screenshots.d.ts.map

package/dist/bin/cms-capture-screenshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-capture-screenshots.d.ts","sourceRoot":"","sources":["../../src/bin/cms-capture-screenshots.ts"],"names":[],"mappings":";AACA,uFAAuF"}

package/dist/bin/cms-capture-screenshots.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+/**
+ * cms-capture-screenshots
+ *
+ * Captures showcase screenshots for one or more CMS types using cms-edit.
+ * Screenshots are saved to <app-dir>/docs/cms-guidelines/screenshots/<type>-<label>.png.
+ * The path is resolved from process.cwd(), so run from the monorepo root when using --app-dir
+ * (e.g. node packages/contentful-cms/dist/bin/cms-capture-screenshots.js --variants ... --app-dir apps/example-se2026).
+ *
+ * Usage:
+ *   cms-capture-screenshots --type Hero [--app-dir <path>]
+ *   cms-capture-screenshots --variants variants.json [--app-dir <path>]
+ *
+ * Where variants.json follows the output contract from the variant-proposal-prompt:
+ * {
+ *   "typeName": "Hero",
+ *   "variants": [
+ *     { "label": "default", "description": "...", "showcaseParams": {} },
+ *     { "label": "navy", "description": "...", "showcaseParams": { "backgroundColour": "Navy" } }
+ *   ]
+ * }
+ *
+ * If --type is passed without --variants, uses a default set of variants for that type.
+ *
+ * Prerequisites:
+ *   - agent-browser installed: npm install -g agent-browser && agent-browser install
+ *   - App running on its dev port (e.g. pnpm --filter example-brightline dev)
+ *   - cms-edit available on PATH (installed with this package)
+ */
+import { spawnSync } from 'node:child_process';
+import { mkdirSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+// Default variants for well-known types (used when --type is passed without --variants)
+const DEFAULT_VARIANTS = {
+    Hero: {
+        typeName: 'Hero',
+        mode: 'component',
+        variants: [
+            {
+                label: 'default',
+                description: 'All fields populated, no colour override.',
+                showcaseParams: {},
+            },
+            {
+                label: 'no-visual',
+                description: 'visual field removed; copy spans full width.',
+                showcaseParams: { showVisual: 'false' },
+            },
+            {
+                label: 'navy',
+                description: 'Navy background + Off White text.',
+                showcaseParams: { backgroundColour: 'Navy', textColour: 'Off White' },
+            },
+            {
+                label: 'minimal',
+                description: 'Heading only, no eyebrow/subtitle/body/links/visual.',
+                showcaseParams: { showVisual: 'false', showLinks: 'false' },
+            },
+        ],
+    },
+    'Hero Flipped': {
+        typeName: 'Hero Flipped',
+        mode: 'component',
+        variants: [
+            {
+                label: 'default',
+                description: 'Default flipped layout — visual on left, copy on right.',
+                showcaseParams: {},
+            },
+        ],
+    },
+};
+function parseCli() {
+    const args = process.argv.slice(2);
+    const result = {
+        variantsFile: null,
+        type: null,
+        appDir: process.cwd(),
+    };
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--variants' && args[i + 1]) {
+            result.variantsFile = args[++i];
+        }
+        else if (args[i] === '--type' && args[i + 1]) {
+            result.type = args[++i];
+        }
+        else if (args[i] === '--app-dir' && args[i + 1]) {
+            result.appDir = args[++i];
+        }
+    }
+    return result;
+}
+function typeNameToSlug(typeName) {
+    return typeName.toLowerCase().replace(/\s+/g, '-');
+}
+function buildCmsEditArgs(typeName, mode, params) {
+    const modeFlag = mode === 'collection' ? '--collection' : '--component';
+    const paramFlags = Object.entries(params).flatMap(([k, v]) => ['--param', `${k}=${v}`]);
+    return [modeFlag, typeName, ...paramFlags];
+}
+function captureScreenshot(typeName, mode, variant, outPath, appDir) {
+    const args = buildCmsEditArgs(typeName, mode, variant.showcaseParams);
+    // Validate URL generation first (shell: false so type names with spaces are one argument)
+    const urlResult = spawnSync('cms-edit', ['screenshot', ...args, '--url-only'], {
+        cwd: appDir,
+        encoding: 'utf8',
+        shell: false,
+    });
+    if (urlResult.status !== 0) {
+        console.error(`  ✗ URL generation failed for ${typeName} / ${variant.label}`);
+        console.error(`    ${urlResult.stderr}`);
+        return false;
+    }
+    const url = urlResult.stdout.trim();
+    console.log(`  URL: ${url}`);
+    const result = spawnSync('cms-edit', ['screenshot', ...args, '--out', outPath, '--wait', '1000'], {
+        cwd: appDir,
+        encoding: 'utf8',
+        timeout: 60000,
+        shell: false,
+    });
+    if (result.status !== 0) {
+        const stderr = result.stderr ?? '';
+        if (stderr.includes('agent-browser') ||
+            stderr.includes('not found') ||
+            stderr.includes('ENOENT')) {
+            console.warn(`  ⚠ agent-browser not available. Screenshot URL only:`);
+            console.warn(`    ${url}`);
+            console.warn(`  Install with: npm install -g agent-browser && agent-browser install`);
+        }
+        else {
+            console.error(`  ✗ Screenshot failed: ${stderr}`);
+        }
+        return false;
+    }
+    console.log(`  ✓ Saved: ${outPath}`);
+    return true;
+}
+function main() {
+    const { variantsFile, type, appDir } = parseCli();
+    // Resolve relative to process.cwd() so path is absolute when passed to cms-edit (which runs with cwd: appDir)
+    const screenshotsDir = resolve(process.cwd(), appDir, 'docs/cms-guidelines/screenshots');
+    mkdirSync(screenshotsDir, { recursive: true });
+    let jobs = [];
+    if (variantsFile) {
+        const data = JSON.parse(readFileSync(variantsFile, 'utf8'));
+        const payload = Array.isArray(data) ? data : [data];
+        jobs = payload.map((entry) => ({
+            typeName: entry.typeName,
+            mode: entry.mode ?? 'component',
+            variants: entry.variants,
+        }));
+    }
+    else if (type) {
+        const defaults = DEFAULT_VARIANTS[type];
+        if (!defaults) {
+            console.error(`No default variants for type "${type}". Use --variants <file> instead.`);
+            process.exit(1);
+        }
+        jobs = [defaults];
+    }
+    else {
+        console.log('Usage:');
+        console.log('  cms-capture-screenshots --type Hero');
+        console.log('  cms-capture-screenshots --variants variants.json');
+        console.log('  cms-capture-screenshots --type Hero --app-dir /path/to/app');
+        process.exit(0);
+    }
+    for (const job of jobs) {
+        const slug = typeNameToSlug(job.typeName);
+        console.log(`\nCapturing screenshots for: ${job.typeName} (${job.variants.length} variants)`);
+        for (const variant of job.variants) {
+            const outFile = `${slug}-${variant.label}.png`;
+            const outPath = join(screenshotsDir, outFile);
+            console.log(`\n  Variant: ${variant.label} — ${variant.description}`);
+            captureScreenshot(job.typeName, job.mode, variant, outPath, appDir);
+        }
+    }
+    console.log('\nDone.');
+}
+main();
+//# sourceMappingURL=cms-capture-screenshots.js.map

package/dist/bin/cms-capture-screenshots.js.map

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

package/dist/bin/cms-generate-collection-guidelines.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+export {};
+//# sourceMappingURL=cms-generate-collection-guidelines.d.ts.map

package/dist/bin/cms-generate-collection-guidelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-generate-collection-guidelines.d.ts","sourceRoot":"","sources":["../../src/bin/cms-generate-collection-guidelines.ts"],"names":[],"mappings":";AACA,uFAAuF"}

package/dist/bin/cms-generate-collection-guidelines.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+/**
+ * cms-generate-collection-guidelines
+ *
+ * Generates guideline markdown fragments for all collections and external components
+ * in a project by reading from the live discovery API. This script is project-independent:
+ * it needs only a discovery URL and an app directory.
+ *
+ * Usage:
+ *   cms-generate-collection-guidelines --discovery-url <url> --app-dir <path>
+ *
+ * Example:
+ *   cms-generate-collection-guidelines \
+ *     --discovery-url http://localhost:3010/api/cms/discovery/ \
+ *     --app-dir apps/example-brightline
+ *
+ * What it does:
+ *   1. Fetches discovery JSON from the URL.
+ *   2. For each collections[] entry:
+ *      - Computes slug (name lowercased, spaces → hyphens, parentheses stripped)
+ *      - Writes docs/cms-guidelines/collections/<slug>.md
+ *      - Writes colour hint (section or none) to generated/cms-discovery/colour-hints.json
+ *   3. For each externals[] entry:
+ *      - Computes slug
+ *      - Writes docs/cms-guidelines/externals/<slug>.md
+ *      - Writes colour hint (none)
+ *
+ * Existing files are overwritten; run this to regenerate after adding types or changing fields.
+ *
+ * Prerequisites:
+ *   - App must be running so the discovery URL is reachable.
+ *   - generated/cms-discovery/ directory must exist (created by cms-generate-field-list).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+// ---------------------------------------------------------------------------
+// CLI argument parsing
+// ---------------------------------------------------------------------------
+function parseCli() {
+    const args = process.argv.slice(2);
+    let discoveryUrl = '';
+    let appDir = process.cwd();
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--discovery-url' && args[i + 1]) {
+            discoveryUrl = args[++i];
+        }
+        else if (args[i] === '--app-dir' && args[i + 1]) {
+            appDir = args[++i];
+        }
+        else if (args[i] === '--help' || args[i] === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    if (!discoveryUrl) {
+        console.error('Error: --discovery-url is required.');
+        printHelp();
+        process.exit(1);
+    }
+    return { discoveryUrl, appDir };
+}
+function printHelp() {
+    console.log('Usage:');
+    console.log('  cms-generate-collection-guidelines --discovery-url <url> [--app-dir <path>]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --discovery-url <url>   Discovery API URL (e.g. http://localhost:3010/api/cms/discovery/)');
+    console.log('  --app-dir <path>        App directory (default: cwd)');
+    console.log('');
+    console.log('Example:');
+    console.log('  cms-generate-collection-guidelines \\');
+    console.log('    --discovery-url http://localhost:3010/api/cms/discovery/ \\');
+    console.log('    --app-dir apps/example-brightline');
+}
+// ---------------------------------------------------------------------------
+// Slug computation
+// ---------------------------------------------------------------------------
+function toSlug(name) {
+    return name.toLowerCase().replace(/\s+/g, '-').replace(/[()]/g, '');
+}
+// ---------------------------------------------------------------------------
+// Markdown generation
+// ---------------------------------------------------------------------------
+const SECTION_EXCLUDE = new Set(['contents', 'collectionType', 'cmsLabel', 'id', 'index']);
+const CARD_EXCLUDE = new Set(['parentId', 'componentType', 'id']);
+function generateCollectionMarkdown(entry) {
+    const sectionFields = entry.usedFields.filter((f) => !SECTION_EXCLUDE.has(f));
+    const cardFields = (entry.cardUsedFields ?? []).filter((f) => !CARD_EXCLUDE.has(f));
+    const hasCard = cardFields.length > 0;
+    const hasColour = entry.usedFields.some((f) => f === 'backgroundColour' || f === 'textColour') ||
+        entry.cardUsedFields?.some((f) => f === 'backgroundColour' || f === 'textColour');
+    let md = `# ${entry.name}\n\n`;
+    md += 'Collection section with optional section heading and a set of items (cards or list).\n\n';
+    md += '## Section fields\n\n';
+    md += '| Field | Effect |\n|---|---|\n';
+    for (const f of sectionFields) {
+        md += `| \`${f}\` | Section-level. |\n`;
+    }
+    if (hasCard) {
+        md += '\n## Card / item fields\n\n';
+        for (const f of cardFields) {
+            md += `- \`${f}\`\n`;
+        }
+    }
+    if (hasColour) {
+        md +=
+            '\n## Colours\n\nSection and/or cards may use `backgroundColour` and `textColour` from the palette.\n';
+    }
+    return md;
+}
+function generateExternalMarkdown(entry) {
+    return `# ${entry.name}\n\nExternal component: embeds or integrates third-party content (e.g. form, iframe, RSS). Configure in CMS; layout and styling are project-specific.\n`;
+}
+// ---------------------------------------------------------------------------
+// Colour hints
+// ---------------------------------------------------------------------------
+function loadColourHints(hintsPath) {
+    if (!existsSync(hintsPath)) {
+        return {};
+    }
+    try {
+        return JSON.parse(readFileSync(hintsPath, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function saveColourHints(hintsPath, hints) {
+    mkdirSync(dirname(hintsPath), { recursive: true });
+    const sorted = Object.fromEntries(Object.entries(hints).sort(([a], [b]) => a.localeCompare(b)));
+    writeFileSync(hintsPath, JSON.stringify(sorted, null, 2) + '\n');
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    const { discoveryUrl, appDir } = parseCli();
+    console.log(`Fetching discovery from: ${discoveryUrl}`);
+    console.log(`App directory: ${appDir}`);
+    // Fetch discovery
+    let discovery;
+    try {
+        const res = await fetch(discoveryUrl);
+        if (!res.ok) {
+            console.error(`Discovery fetch failed: HTTP ${res.status} ${res.statusText}`);
+            console.error(`URL: ${discoveryUrl}`);
+            process.exit(1);
+        }
+        discovery = (await res.json());
+    }
+    catch (err) {
+        console.error(`Failed to fetch discovery URL: ${discoveryUrl}`);
+        console.error(String(err));
+        console.error('\nIs the app running? Start it with:');
+        console.error('  pnpm --filter <appName> dev');
+        process.exit(1);
+    }
+    const collectionsDir = join(appDir, 'docs/cms-guidelines/collections');
+    const externalsDir = join(appDir, 'docs/cms-guidelines/externals');
+    const hintsPath = join(appDir, 'generated/cms-discovery/colour-hints.json');
+    mkdirSync(collectionsDir, { recursive: true });
+    mkdirSync(externalsDir, { recursive: true });
+    mkdirSync(dirname(hintsPath), { recursive: true });
+    const hints = loadColourHints(hintsPath);
+    // Collections
+    console.log(`\nGenerating ${discovery.collections.length} collection guidelines...`);
+    for (const entry of discovery.collections) {
+        const slug = toSlug(entry.name);
+        const outPath = join(collectionsDir, `${slug}.md`);
+        const md = generateCollectionMarkdown(entry);
+        writeFileSync(outPath, md, 'utf8');
+        // Colour hint: section if backgroundColour or textColour in used/card fields; else none
+        const hasColourFields = entry.usedFields.some((f) => f === 'backgroundColour' || f === 'textColour') ||
+            entry.cardUsedFields?.some((f) => f === 'backgroundColour' || f === 'textColour');
+        hints[entry.name] = {
+            colourApplication: hasColourFields ? 'section' : 'none',
+            notes: hasColourFields
+                ? 'Section and/or cards use backgroundColour/textColour from palette.'
+                : 'No colour fields in used fields or card fields.',
+        };
+        console.log(`  ✓ ${entry.name} → collections/${slug}.md`);
+    }
+    // Externals
+    console.log(`\nGenerating ${discovery.externals.length} external component guidelines...`);
+    for (const entry of discovery.externals) {
+        const slug = toSlug(entry.name);
+        const outPath = join(externalsDir, `${slug}.md`);
+        const md = generateExternalMarkdown(entry);
+        writeFileSync(outPath, md, 'utf8');
+        hints[entry.name] = {
+            colourApplication: 'none',
+            notes: 'External embed; no colour fields.',
+        };
+        console.log(`  ✓ ${entry.name} → externals/${slug}.md`);
+    }
+    // Save colour hints
+    saveColourHints(hintsPath, hints);
+    console.log(`\nColour hints written to ${hintsPath}`);
+    console.log(`\nDone. ${discovery.collections.length} collections and ${discovery.externals.length} externals generated.`);
+    console.log('\nNext step: run merge to update COMPONENT_GUIDELINES_FOR_LLM.md:');
+    console.log('  cms-merge-guidelines --app-dir <appDir>');
+    console.log('  (or: pnpm run cms-guidelines:merge from the app directory)');
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cms-generate-collection-guidelines.js.map

package/dist/bin/cms-generate-collection-guidelines.js.map

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

package/dist/bin/cms-generate-field-list.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+export {};
+//# sourceMappingURL=cms-generate-field-list.d.ts.map

package/dist/bin/cms-generate-field-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-generate-field-list.d.ts","sourceRoot":"","sources":["../../src/bin/cms-generate-field-list.ts"],"names":[],"mappings":";AACA,uFAAuF"}

package/dist/bin/cms-generate-field-list.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+/**
+ * cms-generate-field-list
+ *
+ * Parses the generated Contentful TypeScript type files in an app to produce
+ * generated/cms-discovery/field-list.json.
+ *
+ * This file contains field metadata for component, collection, and external
+ * component content types: field id, label, type, whether required, summary,
+ * and valid enum values if applicable.
+ *
+ * Usage:
+ *   cms-generate-field-list [--app-dir <path>]
+ *
+ * Prerequisites:
+ *   Run `pnpm codegen` (or `pnpm generate:types`) first to ensure
+ *   src/generated/types/ is up to date.
+ *
+ * Output:
+ *   <app-dir>/generated/cms-discovery/field-list.json
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+// Parse --app-dir flag (default: cwd)
+function parseAppDir() {
+    const args = process.argv.slice(2);
+    const idx = args.indexOf('--app-dir');
+    return idx !== -1 && args[idx + 1] ? args[idx + 1] : process.cwd();
+}
+const appRoot = parseAppDir();
+// Content types to parse: [ fileName, contentTypeId ]
+const CONTENT_TYPES = [
+    ['TypeComponent.ts', 'component'],
+    ['TypeCollection.ts', 'collection'],
+    ['TypeExternalComponent.ts', 'externalComponent'],
+];
+const TYPES_DIR = join(appRoot, 'src/generated/types');
+const OUTPUT_PATH = join(appRoot, 'generated/cms-discovery/field-list.json');
+/**
+ * Derive a simplified field type name and enum values from an EntryFieldTypes expression.
+ */
+function parseFieldType(typeExpr) {
+    const entryFieldMatch = typeExpr.match(/EntryFieldTypes\.(\w+)/);
+    if (!entryFieldMatch) {
+        return { type: 'Unknown' };
+    }
+    const typeName = entryFieldMatch[1];
+    if (typeName === 'Symbol') {
+        const enumMatch = typeExpr.match(/EntryFieldTypes\.Symbol<(.+?)>/);
+        if (enumMatch) {
+            const enumStr = enumMatch[1];
+            const enumValues = enumStr.split('|').map((v) => v.trim().replace(/^"(.+)"$/, '$1'));
+            return { type: 'Symbol', enumValues };
+        }
+    }
+    return { type: typeName };
+}
+/**
+ * Parse a TypeXxx.ts file and extract field metadata from the TypeXxxFields interface.
+ */
+function parseTypeFile(fileName) {
+    const filePath = join(TYPES_DIR, fileName);
+    let source;
+    try {
+        source = readFileSync(filePath, 'utf8');
+    }
+    catch {
+        console.error(`Could not read ${filePath}`);
+        return [];
+    }
+    const interfaceMatch = source.match(/export interface Type\w+Fields \{([\s\S]+?)^}/m);
+    if (!interfaceMatch) {
+        console.error(`Could not find TypeXxxFields interface in ${fileName}`);
+        return [];
+    }
+    const body = interfaceMatch[1];
+    const fields = [];
+    const fieldBlockRegex = /\/\*\*([\s\S]*?)\*\/\s*\n\s+(\w+)(\??):\s*([\s\S]+?);/g;
+    let match = fieldBlockRegex.exec(body);
+    while (match !== null) {
+        const [, jsdoc, fieldId, optionalMark, typeExpr] = match;
+        const nameMatch = jsdoc.match(/@name (.+)/);
+        const label = nameMatch ? nameMatch[1].trim() : fieldId;
+        const summaryMatch = jsdoc.match(/@summary (.+)/);
+        const summary = summaryMatch ? summaryMatch[1].trim() : undefined;
+        const required = optionalMark !== '?';
+        const { type, enumValues } = parseFieldType(typeExpr.replace(/\s+/g, ' '));
+        const field = { id: fieldId, label, required, type };
+        if (summary) {
+            field.summary = summary;
+        }
+        if (enumValues) {
+            field.enumValues = enumValues;
+        }
+        fields.push(field);
+        match = fieldBlockRegex.exec(body);
+    }
+    return fields;
+}
+function main() {
+    console.log(`Generating field list for: ${appRoot}`);
+    const output = {};
+    for (const [fileName, contentTypeId] of CONTENT_TYPES) {
+        const fields = parseTypeFile(fileName);
+        output[contentTypeId] = { fields };
+        console.log(`  ${contentTypeId}: ${fields.length} fields`);
+    }
+    mkdirSync(dirname(OUTPUT_PATH), { recursive: true });
+    writeFileSync(OUTPUT_PATH, JSON.stringify(output, null, 2));
+    console.log(`\nWrote ${OUTPUT_PATH}`);
+}
+main();
+//# sourceMappingURL=cms-generate-field-list.js.map

package/dist/bin/cms-generate-field-list.js.map

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

package/dist/bin/cms-merge-guidelines.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+export {};
+//# sourceMappingURL=cms-merge-guidelines.d.ts.map

package/dist/bin/cms-merge-guidelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-merge-guidelines.d.ts","sourceRoot":"","sources":["../../src/bin/cms-merge-guidelines.ts"],"names":[],"mappings":";AAEA,uFAAuF"}