contentbit 0.1.0

package/dist/commands/docs.d.ts

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

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

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

package/dist/commands/docs.js

@@ -0,0 +1,18 @@
+import { parseArgs } from 'node:util';
+import { loadRegistry } from '../load-registry.js';
+export async function docsCommand(args, io) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            registry: { type: 'string' },
+            out: { type: 'string' },
+        },
+    });
+    const registry = await loadRegistry(values.registry);
+    const guide = registry.toAuthoringGuide({ audience: 'human', includeExamples: true });
+    if (values.out)
+        await io.writeFile(values.out, guide);
+    else
+        io.stdout(guide);
+    return 0;
+}

package/dist/commands/init.d.ts

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

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

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

package/dist/commands/init.js

@@ -0,0 +1,204 @@
+import { spawn } from 'node:child_process';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parseArgs } from 'node:util';
+import { loadRegistry } from '../load-registry.js';
+const TARGETS = ['react', 'html', 'markdown'];
+const REGISTRY_TEMPLATE = `// Custom blocks for this project. The CLI and your app share this module:
+//
+//   contentbit validate "content/**/*.md" --registry ./blocks/registry.mjs
+//
+// Define blocks with @contentbit/core and default-export them as an array.
+// Docs: https://contentbit.dev/docs/guides/custom-blocks
+//
+// import { defineBlock, pipeRows } from '@contentbit/core'
+// import { z } from 'zod'
+//
+// const pricingTable = defineBlock({
+//   name: 'pricing-table',
+//   description: 'Compares product plans.',
+//   props: z.object({ currency: z.enum(['usd', 'eur']).default('usd') }),
+//   content: pipeRows({ columns: ['plan', 'price'], minRows: 2 }),
+//   authoring: {
+//     useWhen: ['Comparing pricing plans'],
+//     example: ':::pricing-table\\n- Starter | $0\\n- Pro | $12/mo\\n:::',
+//   },
+// })
+
+export default []
+`;
+const EXAMPLE_CONTENT = `# Hello, Content Blocks
+
+Regular Markdown works everywhere. Blocks add validated structure:
+
+:::callout{type="tip" title="Try breaking this file"}
+Run the validate script and you will get file:line:col diagnostics.
+:::
+
+:::steps
+1. Edit this file and add or break a block.
+2. Run \`contentbit validate "content/**/*.md"\`.
+3. Render it with the target you picked at init.
+:::
+`;
+const REACT_COMPONENT = `import { genericBlocks } from '@contentbit/blocks'
+import { createBlockRegistry, parseDocument, validateDocument } from '@contentbit/core'
+import { ContentBlocks } from '@contentbit/react'
+
+const registry = createBlockRegistry().use(genericBlocks())
+
+export function Content({ source }: { source: string }) {
+  const result = validateDocument(parseDocument(source), registry)
+  return (
+    <ContentBlocks
+      document={result.document}
+      // TODO: plug your Markdown library in here, e.g. react-markdown.
+      // One function renders all prose: https://contentbit.dev/docs/guides/markdown
+      // renderMarkdown={(md) => <Markdown source={md} />}
+    />
+  )
+}
+`;
+function detectPackageManager() {
+    const agent = process.env.npm_config_user_agent ?? '';
+    for (const pm of ['pnpm', 'yarn', 'bun']) {
+        if (agent.startsWith(pm))
+            return pm;
+    }
+    return 'npm';
+}
+function installArgs(pm, dev, pkgs) {
+    const add = pm === 'npm' ? 'install' : 'add';
+    return dev ? [add, '-D', ...pkgs] : [add, ...pkgs];
+}
+function runInstall(pm, args, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(pm, args, { cwd, stdio: 'inherit', shell: process.platform === 'win32' });
+        child.on('close', (code) => resolve(code ?? 1));
+        child.on('error', () => resolve(1));
+    });
+}
+/** Write a file unless it already exists; returns what happened for the summary. */
+async function scaffold(path, content) {
+    try {
+        await readFile(path, 'utf8');
+        return 'skipped';
+    }
+    catch {
+        await mkdir(join(path, '..'), { recursive: true });
+        await writeFile(path, content, 'utf8');
+        return 'created';
+    }
+}
+export async function initCommand(args, io) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            target: { type: 'string', short: 't' },
+            yes: { type: 'boolean', short: 'y', default: false },
+            cwd: { type: 'string', default: process.cwd() },
+            'no-install': { type: 'boolean', default: false },
+        },
+    });
+    const cwd = values.cwd;
+    // A project to init into is required.
+    let pkg;
+    const pkgPath = join(cwd, 'package.json');
+    try {
+        pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
+    }
+    catch {
+        io.stderr('No package.json found. Run this inside a project (npm init first).');
+        return 1;
+    }
+    // Resolve the render target: flag > prompt (interactive) > detection.
+    const hasReact = Boolean(pkg.dependencies?.react ?? pkg.devDependencies?.react);
+    const detected = hasReact ? 'react' : 'html';
+    let target;
+    if (values.target) {
+        if (!TARGETS.includes(values.target)) {
+            io.stderr(`Unknown target "${values.target}". Use one of: ${TARGETS.join(', ')}`);
+            return 2;
+        }
+        target = values.target;
+    }
+    else if (!values.yes && process.stdin.isTTY && process.stdout.isTTY) {
+        const { isCancel, select } = await import('@clack/prompts');
+        const answer = await select({
+            message: 'Render target?',
+            initialValue: detected,
+            options: [
+                { value: 'react', label: 'React', hint: 'ContentBlocks component' },
+                { value: 'html', label: 'Static HTML', hint: 'renderToHtml, no framework' },
+                { value: 'markdown', label: 'Plain Markdown', hint: 'fallback rendering only' },
+            ],
+        });
+        if (isCancel(answer))
+            return 1;
+        target = answer;
+    }
+    else {
+        target = detected;
+    }
+    // Install runtime packages plus the CLI as a dev dependency.
+    const runtime = ['@contentbit/core', '@contentbit/blocks'];
+    if (target === 'react')
+        runtime.push('@contentbit/react');
+    if (target === 'html')
+        runtime.push('@contentbit/html');
+    if (values['no-install']) {
+        io.stdout(`skipped install: ${runtime.join(' ')} + contentbit (dev)`);
+    }
+    else {
+        const pm = detectPackageManager();
+        io.stdout(`installing with ${pm}: ${runtime.join(' ')}`);
+        if ((await runInstall(pm, installArgs(pm, false, runtime), cwd)) !== 0) {
+            io.stderr('install failed');
+            return 1;
+        }
+        if ((await runInstall(pm, installArgs(pm, true, ['contentbit']), cwd)) !== 0) {
+            io.stderr('install failed');
+            return 1;
+        }
+    }
+    // Scaffold project files; never overwrite.
+    const files = [
+        ['blocks/registry.mjs', REGISTRY_TEMPLATE],
+        ['content/example.md', EXAMPLE_CONTENT],
+    ];
+    if (target === 'react')
+        files.push(['components/content-blocks.tsx', REACT_COMPONENT]);
+    for (const [rel, content] of files) {
+        const result = await scaffold(join(cwd, rel), content);
+        io.stdout(`${result}: ${rel}`);
+    }
+    // Wire the validate script.
+    const fresh = JSON.parse(await readFile(pkgPath, 'utf8'));
+    fresh.scripts ??= {};
+    if (!fresh.scripts['content:check']) {
+        fresh.scripts['content:check'] =
+            'contentbit validate "content/**/*.md" --registry ./blocks/registry.mjs';
+        await writeFile(pkgPath, `${JSON.stringify(fresh, null, 2)}\n`, 'utf8');
+        io.stdout('added script: content:check');
+    }
+    // Generate the LLM authoring guide from the registry, ready to paste into a prompt.
+    const registry = await loadRegistry();
+    const guide = registry.toAuthoringGuide({ audience: 'llm', includeExamples: true });
+    await writeFile(join(cwd, 'contentbit-guide.md'), guide, 'utf8');
+    io.stdout('created: contentbit-guide.md (LLM authoring instructions)');
+    io.stdout('');
+    io.stdout('Done. Next steps:');
+    io.stdout(`  1. Validate the starter content: ${detectPackageManager()} run content:check`);
+    if (target === 'react') {
+        io.stdout('  2. Render it: import { Content } from "./components/content-blocks"');
+        io.stdout('  3. Styled components: pnpm dlx shadcn@latest add @contentbit/generic-pack');
+    }
+    else if (target === 'html') {
+        io.stdout('  2. Render it: contentbit render content/example.md --target html');
+    }
+    else {
+        io.stdout('  2. Render it: contentbit render content/example.md --target markdown');
+    }
+    io.stdout('  Docs: https://contentbit.dev/docs');
+    return 0;
+}

package/dist/commands/instructions.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/commands/instructions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAInC,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBjF"}

package/dist/commands/instructions.js

@@ -0,0 +1,23 @@
+import { parseArgs } from 'node:util';
+import { loadRegistry } from '../load-registry.js';
+export async function instructionsCommand(args, io) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            audience: { type: 'string', default: 'llm' },
+            'no-examples': { type: 'boolean', default: false },
+            registry: { type: 'string' },
+            out: { type: 'string' },
+        },
+    });
+    const registry = await loadRegistry(values.registry);
+    const guide = registry.toAuthoringGuide({
+        audience: values.audience === 'human' ? 'human' : 'llm',
+        includeExamples: !values['no-examples'],
+    });
+    if (values.out)
+        await io.writeFile(values.out, guide);
+    else
+        io.stdout(guide);
+    return 0;
+}

package/dist/commands/render.d.ts

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

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

@@ -0,0 +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"}

package/dist/commands/render.js

@@ -0,0 +1,38 @@
+import { genericMarkdownRenderers } from '@contentbit/blocks';
+import { formatDiagnostic, parseDocument, renderToMarkdown, validateDocument, } from '@contentbit/core';
+import { renderToHtml } from '@contentbit/html';
+import { readFile } from 'node:fs/promises';
+import { parseArgs } from 'node:util';
+import { loadRegistry } from '../load-registry.js';
+export async function renderCommand(args, io) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            target: { type: 'string', default: 'html' },
+            registry: { type: 'string' },
+            out: { type: 'string' },
+        },
+    });
+    const file = positionals[0];
+    if (!file || (values.target !== 'html' && values.target !== 'markdown')) {
+        io.stderr('render: usage: render <file> --target html|markdown [--out <file>]');
+        return 2;
+    }
+    const registry = await loadRegistry(values.registry);
+    const source = await readFile(file, 'utf8');
+    const result = validateDocument(parseDocument(source), registry);
+    if (!result.ok) {
+        for (const d of result.diagnostics)
+            io.stderr(formatDiagnostic(d, file));
+        return 1;
+    }
+    const output = values.target === 'html'
+        ? renderToHtml(result.document)
+        : renderToMarkdown(result.document, { renderers: genericMarkdownRenderers });
+    if (values.out)
+        await io.writeFile(values.out, output);
+    else
+        io.stdout(output);
+    return 0;
+}

package/dist/commands/validate.d.ts

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

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

@@ -0,0 +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"}

package/dist/commands/validate.js

@@ -0,0 +1,44 @@
+import { formatDiagnostic, parseDocument, 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';
+export async function validateCommand(args, io) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            registry: { type: 'string' },
+            'strict-warnings': { type: 'boolean', default: false },
+        },
+    });
+    if (positionals.length === 0) {
+        io.stderr('validate: provide at least one file or glob.');
+        return 2;
+    }
+    const files = await glob(positionals, { absolute: true });
+    if (files.length === 0) {
+        io.stderr(`validate: no files matched ${positionals.join(' ')}`);
+        return 2;
+    }
+    const registry = await loadRegistry(values.registry);
+    let errors = 0;
+    let warnings = 0;
+    for (const file of files.sort()) {
+        const source = await readFile(file, 'utf8');
+        const result = validateDocument(parseDocument(source), registry);
+        for (const d of result.diagnostics) {
+            io.stderr(formatDiagnostic(d, file));
+            if (d.severity === 'error')
+                errors++;
+            else if (d.severity === 'warning')
+                warnings++;
+        }
+    }
+    io.stdout(`${files.length} file(s): ${errors} errors, ${warnings} warnings`);
+    if (errors > 0)
+        return 1;
+    if (warnings > 0 && values['strict-warnings'])
+        return 1;
+    return 0;
+}

package/dist/load-registry.d.ts

@@ -0,0 +1,4 @@
+import { type BlockRegistry } from '@contentbit/core';
+/** Generic pack + optional user module (default export: BlockDefinition[]). */
+export declare function loadRegistry(registryPath?: string): Promise<BlockRegistry>;
+//# sourceMappingURL=load-registry.d.ts.map

package/dist/load-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-registry.d.ts","sourceRoot":"","sources":["../src/load-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhG,+EAA+E;AAC/E,wBAAsB,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAchF"}

package/dist/load-registry.js

@@ -0,0 +1,15 @@
+import { genericBlocks } from '@contentbit/blocks';
+import { createBlockRegistry } from '@contentbit/core';
+import { pathToFileURL } from 'node:url';
+/** Generic pack + optional user module (default export: BlockDefinition[]). */
+export async function loadRegistry(registryPath) {
+    const registry = createBlockRegistry().use(genericBlocks());
+    if (registryPath) {
+        const mod = (await import(pathToFileURL(registryPath).href));
+        if (!Array.isArray(mod.default)) {
+            throw new Error(`--registry module must default-export an array of block definitions: ${registryPath}`);
+        }
+        registry.use(mod.default);
+    }
+    return registry;
+}

package/dist/run.d.ts

@@ -0,0 +1,8 @@
+export interface Io {
+    stdout(line: string): void;
+    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] [-y] [--no-install]\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 function run(argv: string[], io: Io): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +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,yaAO8B,CAAA;AAYhD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAcjE"}