contentbit 0.1.1 → 0.3.0

package/dist/commands/links.js

@@ -0,0 +1,97 @@
+import { aliasReplacementsForPage, buildLinkIndex, extractFrontmatter, formatDiagnostic, serializeLinkIndex, validateLinks, } from '@contentbit/core';
+import { mkdir, readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { parseArgs } from 'node:util';
+import { glob } from 'tinyglobby';
+import { linkResolverOptions } from '../link-options.js';
+import { collectLinkInputs } from '../links-io.js';
+export async function linksCommand(args, io) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            out: { type: 'string' },
+            fix: { type: 'boolean', default: false },
+            'link-resolve': { type: 'string' },
+            'locale-field': { type: 'string' },
+            'slug-field': { type: 'string' },
+            'key-field': { type: 'string' },
+            'default-locale': { type: 'string' },
+        },
+    });
+    if (positionals.length === 0) {
+        io.stderr('links: provide at least one file or glob.');
+        return 2;
+    }
+    const files = (await glob(positionals, { absolute: true })).sort();
+    if (files.length === 0) {
+        io.stderr(`links: no files matched ${positionals.join(' ')}`);
+        return 2;
+    }
+    const inputs = await collectLinkInputs(files);
+    const linkOptions = linkResolverOptions(values);
+    let errors = 0;
+    let warnings = 0;
+    for (const { file, diagnostic } of validateLinks(inputs, linkOptions)) {
+        io.stderr(formatDiagnostic(diagnostic, file));
+        if (diagnostic.severity === 'error')
+            errors++;
+        else if (diagnostic.severity === 'warning')
+            warnings++;
+    }
+    const index = buildLinkIndex(inputs, linkOptions);
+    if (values.fix && errors > 0) {
+        io.stderr('links: --fix skipped because link errors must be resolved first.');
+    }
+    else if (values.fix && index.aliases.size > 0) {
+        for (const file of files) {
+            const source = await readFile(file, 'utf8');
+            const fm = extractFrontmatter(source);
+            if (!fm)
+                continue;
+            const lines = source.split('\n');
+            let changed = false;
+            // Only rewrite alias tokens inside the `linksTo:` block — never inside an
+            // `aliases:` list (which records the rename and must stay intact), and
+            // never in document body. Track whether we are within linksTo's scope:
+            // a top-level key resets it, dash-list / inline continuation keeps it.
+            let inLinksTo = false;
+            for (let i = 0; i < fm.lines.end && i < lines.length; i++) {
+                const line = lines[i];
+                const topKey = line.match(/^([A-Za-z0-9_.-]+):(.*)$/);
+                if (topKey)
+                    inLinksTo = topKey[1] === 'linksTo';
+                if (!inLinksTo)
+                    continue;
+                let next = line;
+                for (const [alias, current] of aliasReplacementsForPage(index, fm.data)) {
+                    const re = new RegExp(`(^|[\\s\\[,'"-])${escapeRe(alias)}($|[\\s\\],'"])`, 'g');
+                    next = next.replace(re, (_m, p1, p2) => `${p1}${current}${p2}`);
+                }
+                if (next !== line) {
+                    lines[i] = next;
+                    changed = true;
+                }
+            }
+            if (changed) {
+                await io.writeFile(file, lines.join('\n'));
+                io.stdout(`fixed alias references in ${file}`);
+            }
+        }
+    }
+    const outPath = values.out ?? join(process.cwd(), '.contentbit', 'link-index.json');
+    // The default target lives in a .contentbit/ dir that may not exist yet, and
+    // the shared Io.writeFile is a thin fs wrapper that won't create it.
+    await mkdir(dirname(outPath), { recursive: true });
+    await io.writeFile(outPath, JSON.stringify(serializeLinkIndex(index), null, 2) + '\n');
+    let edges = 0;
+    for (const p of index.pages.values())
+        edges += p.linksTo.length;
+    const orphans = [...index.pages.values()].filter((p) => p.linkedFrom.length === 0).length;
+    io.stdout(`${index.pages.size} page(s), ${edges} link(s), ${orphans} orphan(s): ${errors} errors, ${warnings} warnings`);
+    io.stdout(`index written to ${outPath}`);
+    return errors > 0 ? 1 : 0;
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

package/dist/commands/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/commands/render.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAInC,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B3E"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/commands/render.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAInC,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B3E"}

package/dist/commands/render.js

@@ -1,5 +1,5 @@
 import { genericMarkdownRenderers } from '@contentbit/blocks';
-import { formatDiagnostic, parseDocument, renderToMarkdown, validateDocument, } from '@contentbit/core';
+import { formatDiagnostic, parseDocument, renderToMarkdown, stripFrontmatter, validateDocument, } from '@contentbit/core';
 import { renderToHtml } from '@contentbit/html';
 import { readFile } from 'node:fs/promises';
 import { parseArgs } from 'node:util';
@@ -21,7 +21,7 @@ export async function renderCommand(args, io) {
     }
     const registry = await loadRegistry(values.registry);
     const source = await readFile(file, 'utf8');
-    const result = validateDocument(parseDocument(source), registry);
+    const result = validateDocument(parseDocument(stripFrontmatter(source)), registry);
     if (!result.ok) {
         for (const d of result.diagnostics)
             io.stderr(formatDiagnostic(d, file));

package/dist/commands/stats.d.ts

@@ -0,0 +1,3 @@
+import type { Io } from '../run.js';
+export declare function statsCommand(args: string[], io: Io): Promise<number>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAuBnC,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B1E"}

package/dist/commands/stats.js

@@ -0,0 +1,49 @@
+import { analyzeDocument, parseDocument, stripFrontmatter, validateDocument, } from '@contentbit/core';
+import { readFile } from 'node:fs/promises';
+import { parseArgs } from 'node:util';
+import { glob } from 'tinyglobby';
+import { loadRegistry } from '../load-registry.js';
+async function fileStats(file, registry) {
+    const source = await readFile(file, 'utf8');
+    const stats = analyzeDocument(source, { path: file });
+    if (registry) {
+        const result = validateDocument(parseDocument(stripFrontmatter(source)), registry);
+        let errors = 0;
+        let warnings = 0;
+        for (const d of result.diagnostics) {
+            if (d.severity === 'error')
+                errors++;
+            else if (d.severity === 'warning')
+                warnings++;
+        }
+        stats.validation = { errors, warnings };
+    }
+    return stats;
+}
+export async function statsCommand(args, io) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            registry: { type: 'string' },
+            'no-validate': { type: 'boolean', default: false },
+        },
+    });
+    if (positionals.length === 0) {
+        io.stderr('stats: provide at least one file or glob.');
+        return 2;
+    }
+    const files = await glob(positionals, { absolute: true });
+    if (files.length === 0) {
+        io.stderr(`stats: no files matched ${positionals.join(' ')}`);
+        return 2;
+    }
+    const registry = values['no-validate'] ? null : await loadRegistry(values.registry);
+    const all = [];
+    for (const file of files.sort()) {
+        all.push(await fileStats(file, registry));
+    }
+    // A single file keeps the flat object shape; multiple files emit an array.
+    io.stdout(JSON.stringify(all.length === 1 ? all[0] : all, null, 2));
+    return 0;
+}

package/dist/commands/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAInC,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC7E"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAKnC,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD7E"}

package/dist/commands/validate.js

@@ -1,7 +1,8 @@
-import { formatDiagnostic, parseDocument, validateDocument } from '@contentbit/core';
+import { extractFrontmatter, formatDiagnostic, parseDocument, stripFrontmatter, validateDocument, validateLinks, } from '@contentbit/core';
 import { readFile } from 'node:fs/promises';
 import { parseArgs } from 'node:util';
 import { glob } from 'tinyglobby';
+import { linkResolverOptions } from '../link-options.js';
 import { loadRegistry } from '../load-registry.js';
 export async function validateCommand(args, io) {
     const { values, positionals } = parseArgs({
@@ -10,6 +11,11 @@ export async function validateCommand(args, io) {
         options: {
             registry: { type: 'string' },
             'strict-warnings': { type: 'boolean', default: false },
+            'link-resolve': { type: 'string' },
+            'locale-field': { type: 'string' },
+            'slug-field': { type: 'string' },
+            'key-field': { type: 'string' },
+            'default-locale': { type: 'string' },
         },
     });
     if (positionals.length === 0) {
@@ -22,11 +28,17 @@ export async function validateCommand(args, io) {
         return 2;
     }
     const registry = await loadRegistry(values.registry);
+    const linkOptions = linkResolverOptions(values);
     let errors = 0;
     let warnings = 0;
+    const linkInputs = [];
     for (const file of files.sort()) {
         const source = await readFile(file, 'utf8');
-        const result = validateDocument(parseDocument(source), registry);
+        // Frontmatter is metadata, not content: blanked (positions preserved) so
+        // block syntax inside YAML never produces diagnostics — matching what
+        // frontmatter-aware consumers like Astro validate from entry bodies.
+        linkInputs.push({ path: file, data: extractFrontmatter(source)?.data ?? {} });
+        const result = validateDocument(parseDocument(stripFrontmatter(source)), registry);
         for (const d of result.diagnostics) {
             io.stderr(formatDiagnostic(d, file));
             if (d.severity === 'error')
@@ -35,6 +47,16 @@ export async function validateCommand(args, io) {
                 warnings++;
         }
     }
+    // Cross-file internal-link checks, only when the project uses linking.
+    if (linkInputs.some((i) => 'slug' in i.data)) {
+        for (const { file, diagnostic } of validateLinks(linkInputs, linkOptions)) {
+            io.stderr(formatDiagnostic(diagnostic, file));
+            if (diagnostic.severity === 'error')
+                errors++;
+            else if (diagnostic.severity === 'warning')
+                warnings++;
+        }
+    }
     io.stdout(`${files.length} file(s): ${errors} errors, ${warnings} warnings`);
     if (errors > 0)
         return 1;

package/dist/link-options.d.ts

@@ -0,0 +1,10 @@
+import type { LinkResolverOptions } from '@contentbit/core';
+export interface LinkOptionValues {
+    'link-resolve'?: string | boolean;
+    'locale-field'?: string | boolean;
+    'slug-field'?: string | boolean;
+    'key-field'?: string | boolean;
+    'default-locale'?: string | boolean;
+}
+export declare function linkResolverOptions(values: LinkOptionValues): LinkResolverOptions;
+//# sourceMappingURL=link-options.d.ts.map

package/dist/link-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-options.d.ts","sourceRoot":"","sources":["../src/link-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACpC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,CAgBjF"}

package/dist/link-options.js

@@ -0,0 +1,31 @@
+export function linkResolverOptions(values) {
+    const out = {};
+    const resolve = stringValue(values['link-resolve']);
+    if (resolve) {
+        if (!isResolveMode(resolve))
+            throw new Error(`invalid --link-resolve ${resolve}`);
+        out.resolve = resolve;
+    }
+    const localeField = stringValue(values['locale-field']);
+    const slugField = stringValue(values['slug-field']);
+    const keyField = stringValue(values['key-field']);
+    const defaultLocale = stringValue(values['default-locale']);
+    if (localeField)
+        out.localeField = localeField;
+    if (slugField)
+        out.slugField = slugField;
+    if (keyField)
+        out.keyField = keyField;
+    if (defaultLocale)
+        out.defaultLocale = defaultLocale;
+    return out;
+}
+function stringValue(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function isResolveMode(value) {
+    return (value === 'global-slug' ||
+        value === 'same-locale-slug' ||
+        value === 'same-locale-key' ||
+        value === 'prefer-same-locale-key-fallback-slug');
+}

package/dist/links-io.d.ts

@@ -0,0 +1,3 @@
+import { type LinkInput } from '@contentbit/core';
+export declare function collectLinkInputs(files: string[]): Promise<LinkInput[]>;
+//# sourceMappingURL=links-io.d.ts.map

package/dist/links-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links-io.d.ts","sourceRoot":"","sources":["../src/links-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAMrE,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAQ7E"}

package/dist/links-io.js

@@ -0,0 +1,14 @@
+import { extractFrontmatter } from '@contentbit/core';
+import { readFile } from 'node:fs/promises';
+// Read each file's frontmatter (head only — bodies are never parsed) into the
+// LinkInput shape the core link functions consume. Files with no frontmatter
+// contribute an empty data object (a non-participating page).
+export async function collectLinkInputs(files) {
+    const inputs = [];
+    for (const path of files) {
+        const source = await readFile(path, 'utf8');
+        const fm = extractFrontmatter(source);
+        inputs.push({ path, data: fm?.data ?? {} });
+    }
+    return inputs;
+}

package/dist/run.d.ts

@@ -3,6 +3,6 @@ export interface Io {
     stderr(line: string): void;
     writeFile(path: string, content: string): Promise<void>;
 }
-export declare const USAGE = "Usage: contentbit <init|validate|render|instructions|docs> [options]\n\n  init [-t react|html|markdown] [--md ...] [-y] [--no-install] [--no-page]\n\n  validate <globs...> [--registry <module.mjs>] [--strict-warnings]\n  render <file> --target html|markdown [--registry <module.mjs>] [--out <file>]\n  instructions [--audience llm|human] [--no-examples] [--registry <module.mjs>] [--out <file>]\n  docs [--registry <module.mjs>] [--out <file>]";
+export declare const USAGE = "Usage: contentbit <init|validate|stats|render|instructions|docs|agents|links> [options]\n\n  init [-t react|html|markdown|astro] [--md ...] [-y] [--no-install] [--no-page] [--no-agents]\n  agents [--claude] [--no-agents-md]\n\n  validate <globs...> [--registry <module.mjs>] [--strict-warnings] [--link-resolve <mode>]\n  stats <globs...> [--registry <module.mjs>] [--no-validate]\n  render <file> --target html|markdown [--registry <module.mjs>] [--out <file>]\n  instructions [--audience llm|human] [--no-examples] [--registry <module.mjs>] [--out <file>]\n  docs [--registry <module.mjs>] [--out <file>]\n  links <globs...> [--fix] [--out <file>] [--link-resolve <mode>]";
 export declare function run(argv: string[], io: Io): Promise<number>;
 //# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,EAAE;IACjB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD;AAED,eAAO,MAAM,KAAK,gcAO8B,CAAA;AAYhD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAcjE"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,EAAE;IACjB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD;AAED,eAAO,MAAM,KAAK,sqBAUgD,CAAA;AAelE,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAcjE"}