@functional-examples/documentation 0.0.0-alpha.1

package/dist/commands/generate.d.ts

@@ -0,0 +1,21 @@
+import type { ResolvedConfig } from '@functional-examples/devkit';
+import type { ResolvedDocumentationPluginOptions } from '../schema.js';
+export declare function createGenerateCommand(config: ResolvedConfig, pluginOpts: ResolvedDocumentationPluginOptions): import("cli-forge").CLI<{
+    unmatched: string[];
+    '--'?: string[];
+} & {
+    output?: string;
+} & {} & {
+    format?: string;
+} & {} & {
+    templates?: string;
+} & {} & {
+    filter?: string;
+} & {} & {
+    "dry-run"?: boolean;
+} & {} & {
+    clean?: boolean;
+} & {} & {
+    check?: boolean;
+} & {}, Promise<void>, {}, undefined>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAK3E,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAC;AA6CvE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,kCAAkC;;;;;;;;;;;;;;;;;sCAiP/C"}

package/dist/commands/generate.js

@@ -0,0 +1,243 @@
+import { cli } from 'cli-forge';
+import { scanExamples } from 'functional-examples';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { docsMetadataSchema } from '../schema.js';
+import { loadTemplates, renderIndexTemplate, renderItemTemplate, renderTemplate, } from '../templates/engine.js';
+function shouldSkip(example) {
+    const result = docsMetadataSchema.safeParse(example.metadata);
+    if (result.success && result.data.docs?.skip) {
+        return true;
+    }
+    return false;
+}
+function getOutputName(example) {
+    const result = docsMetadataSchema.safeParse(example.metadata);
+    if (result.success) {
+        return result.data.docs?.outputName;
+    }
+    return undefined;
+}
+function getPerExampleTemplate(example) {
+    const result = docsMetadataSchema.safeParse(example.metadata);
+    if (result.success) {
+        return result.data.docs?.template;
+    }
+    return undefined;
+}
+/** Ensure the parent directory of a file path exists. */
+async function ensureParentDir(filePath) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+}
+/** Map CLI format names to template file extensions. */
+const FORMAT_TO_EXT = {
+    markdown: '.md',
+    mdoc: '.mdoc',
+};
+export function createGenerateCommand(config, pluginOpts) {
+    return cli('$0', {
+        description: 'Generate documentation from functional examples',
+        builder: (cmd) => cmd
+            .option('output', {
+            type: 'string',
+            alias: ['o'],
+            description: 'Output directory',
+            default: pluginOpts.outputDir,
+        })
+            .option('format', {
+            type: 'string',
+            alias: ['f'],
+            description: 'Output format: markdown | mdoc',
+            default: pluginOpts.format,
+        })
+            .option('templates', {
+            type: 'string',
+            alias: ['t'],
+            description: 'Path to custom templates directory',
+        })
+            .option('filter', {
+            type: 'string',
+            description: 'Filter examples by id pattern',
+        })
+            .option('dry-run', {
+            type: 'boolean',
+            description: 'Show what would be generated without writing files',
+            default: false,
+        })
+            .option('clean', {
+            type: 'boolean',
+            description: 'Remove output directory before generating',
+            default: false,
+        })
+            .option('check', {
+            type: 'boolean',
+            description: 'Verify generated docs are up-to-date (exit code 1 if stale)',
+            default: false,
+        }),
+        handler: async (args) => {
+            const format = (args.format === 'mdoc' ? 'mdoc' : 'markdown');
+            const outputDir = path.resolve(args.output);
+            const customTemplatesDir = args.templates ?? pluginOpts.templates;
+            // Load templates — custom directory or built-in filtered by format
+            let templates;
+            if (customTemplatesDir) {
+                templates = await loadTemplates(path.resolve(customTemplatesDir));
+            }
+            else {
+                const all = await loadTemplates();
+                const ext = FORMAT_TO_EXT[format] ?? '.md';
+                templates = all.filter((t) => t.format === ext);
+            }
+            // Scan for examples
+            const { examples, errors } = await scanExamples(config);
+            if (errors.length) {
+                for (const error of errors) {
+                    console.error(`Error: ${error.message}`);
+                }
+                process.exit(1);
+            }
+            // Filter out skipped examples
+            let docsExamples = examples.filter((e) => !shouldSkip(e));
+            // Apply filter pattern
+            if (args.filter) {
+                const pattern = args.filter.toLowerCase();
+                docsExamples = docsExamples.filter((e) => e.id.toLowerCase().includes(pattern) ||
+                    e.rootPath.toLowerCase().includes(pattern));
+            }
+            if (docsExamples.length === 0) {
+                console.log('No examples found for documentation generation');
+                return;
+            }
+            // ── --check mode: compare rendered output against existing files ──
+            if (args.check) {
+                const staleFiles = [];
+                for (const template of templates) {
+                    if (template.perItem) {
+                        for (const example of docsExamples) {
+                            const perExampleTemplate = getPerExampleTemplate(example);
+                            if (perExampleTemplate) {
+                                // Per-example override: use custom template file directly
+                                const outputName = getOutputName(example) ?? example.id;
+                                const ext = template.format;
+                                const outputFile = path.join(outputDir, `${outputName}${ext}`);
+                                const rendered = await renderTemplate(example, perExampleTemplate);
+                                let existing;
+                                try {
+                                    existing = await fs.readFile(outputFile, 'utf-8');
+                                }
+                                catch {
+                                    // file doesn't exist yet
+                                }
+                                if (existing !== rendered) {
+                                    staleFiles.push(outputFile);
+                                }
+                            }
+                            else {
+                                const result = await renderItemTemplate(template, example);
+                                const outputName = getOutputName(example);
+                                const relativePath = outputName
+                                    ? `${outputName}${template.format}`
+                                    : result.relativePath;
+                                const outputFile = path.join(outputDir, relativePath);
+                                let existing;
+                                try {
+                                    existing = await fs.readFile(outputFile, 'utf-8');
+                                }
+                                catch {
+                                    // file doesn't exist yet
+                                }
+                                if (existing !== result.content) {
+                                    staleFiles.push(outputFile);
+                                }
+                            }
+                        }
+                    }
+                    else {
+                        const result = await renderIndexTemplate(template, docsExamples);
+                        const outputFile = path.join(outputDir, result.relativePath);
+                        let existing;
+                        try {
+                            existing = await fs.readFile(outputFile, 'utf-8');
+                        }
+                        catch {
+                            // file doesn't exist yet
+                        }
+                        if (existing !== result.content) {
+                            staleFiles.push(outputFile);
+                        }
+                    }
+                }
+                if (staleFiles.length > 0) {
+                    console.error(`Documentation is out of date. ${staleFiles.length} file(s) would change:`);
+                    for (const f of staleFiles) {
+                        console.error(`  ${f}`);
+                    }
+                    process.exit(1);
+                }
+                console.log('Documentation is up to date.');
+                return;
+            }
+            // ── --dry-run / normal write mode ──
+            // Clean output directory if requested
+            if (args.clean && !args['dry-run']) {
+                await fs.rm(outputDir, { recursive: true, force: true });
+            }
+            // Ensure output directory exists
+            if (!args['dry-run']) {
+                await fs.mkdir(outputDir, { recursive: true });
+            }
+            console.log(`Generating ${format} documentation for ${docsExamples.length} example(s)...`);
+            for (const template of templates) {
+                if (template.perItem) {
+                    for (const example of docsExamples) {
+                        const perExampleTemplate = getPerExampleTemplate(example);
+                        if (perExampleTemplate) {
+                            // Per-example template override
+                            const outputName = getOutputName(example) ?? example.id;
+                            const ext = template.format;
+                            const outputFile = path.join(outputDir, `${outputName}${ext}`);
+                            if (args['dry-run']) {
+                                console.log(`  [dry-run] ${outputFile}`);
+                                continue;
+                            }
+                            const rendered = await renderTemplate(example, perExampleTemplate);
+                            await ensureParentDir(outputFile);
+                            await fs.writeFile(outputFile, rendered, 'utf-8');
+                            console.log(`  ${outputFile}`);
+                        }
+                        else {
+                            const result = await renderItemTemplate(template, example);
+                            const outputName = getOutputName(example);
+                            const relativePath = outputName
+                                ? `${outputName}${template.format}`
+                                : result.relativePath;
+                            const outputFile = path.join(outputDir, relativePath);
+                            if (args['dry-run']) {
+                                console.log(`  [dry-run] ${outputFile}`);
+                                continue;
+                            }
+                            await ensureParentDir(outputFile);
+                            await fs.writeFile(outputFile, result.content, 'utf-8');
+                            console.log(`  ${outputFile}`);
+                        }
+                    }
+                }
+                else {
+                    const result = await renderIndexTemplate(template, docsExamples);
+                    const outputFile = path.join(outputDir, result.relativePath);
+                    if (args['dry-run']) {
+                        console.log(`  [dry-run] ${outputFile}`);
+                        continue;
+                    }
+                    await ensureParentDir(outputFile);
+                    await fs.writeFile(outputFile, result.content, 'utf-8');
+                    console.log(`  ${outputFile}`);
+                }
+            }
+            if (!args['dry-run']) {
+                console.log(`\nDone. ${docsExamples.length} example(s) documented.`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,21 @@
+import type { ResolvedConfig } from '@functional-examples/devkit';
+import type { ResolvedDocumentationPluginOptions } from '../schema.js';
+export declare function createDocumentationCommands(config: ResolvedConfig, pluginOpts: ResolvedDocumentationPluginOptions): import("cli-forge").CLI<{
+    unmatched: string[];
+    '--'?: string[];
+} & {
+    output?: string;
+} & {} & {
+    format?: string;
+} & {} & {
+    templates?: string;
+} & {} & {
+    filter?: string;
+} & {} & {
+    "dry-run"?: boolean;
+} & {} & {
+    clean?: boolean;
+} & {} & {
+    check?: boolean;
+} & {}, Promise<void>, {}, undefined>[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAC;AAGvE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,kCAAkC;;;;;;;;;;;;;;;;;wCAG/C"}

package/dist/commands/index.js

@@ -0,0 +1,5 @@
+import { createGenerateCommand } from './generate.js';
+export function createDocumentationCommands(config, pluginOpts) {
+    return [createGenerateCommand(config, pluginOpts)];
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,UAAU,2BAA2B,CACzC,MAAsB,EACtB,UAA8C;IAE9C,OAAO,CAAC,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/extractor/extractor.d.ts

@@ -0,0 +1,9 @@
+import type { Extractor } from '@functional-examples/devkit';
+/**
+ * Create a markdown frontmatter extractor.
+ *
+ * Scans for .md files with YAML frontmatter containing at least `id` and `title`.
+ * Treats each matching file as a single-file example.
+ */
+export declare function createMarkdownExtractor(): Extractor;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/extractor/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/extractor/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EAIV,MAAM,6BAA6B,CAAC;AA+CrC;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,SAAS,CAyEnD"}

package/dist/extractor/extractor.js

@@ -0,0 +1,95 @@
+import { parseYaml } from '@functional-examples/devkit';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+const EXTRACTOR_NAME = 'markdown-frontmatter-extractor';
+/** Pattern matching YAML frontmatter delimiters. */
+const FRONTMATTER_FENCE = /^---\s*$/;
+/**
+ * Parse YAML frontmatter from a Markdown file.
+ * Returns null if no valid frontmatter is found.
+ */
+async function parseFrontmatter(content) {
+    const lines = content.split('\n');
+    if (lines.length < 2 || !FRONTMATTER_FENCE.test(lines[0])) {
+        return null;
+    }
+    let endIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (FRONTMATTER_FENCE.test(lines[i])) {
+            endIdx = i;
+            break;
+        }
+    }
+    if (endIdx === -1)
+        return null;
+    const yamlStr = lines.slice(1, endIdx).join('\n');
+    const metadata = (await parseYaml(yamlStr));
+    if (typeof metadata !== 'object' || metadata === null) {
+        return null;
+    }
+    const body = lines.slice(endIdx + 1).join('\n').trimStart();
+    return { metadata, body };
+}
+/**
+ * Create a markdown frontmatter extractor.
+ *
+ * Scans for .md files with YAML frontmatter containing at least `id` and `title`.
+ * Treats each matching file as a single-file example.
+ */
+export function createMarkdownExtractor() {
+    return {
+        name: EXTRACTOR_NAME,
+        async extract(candidates, _options) {
+            const examples = [];
+            const errors = [];
+            const claimedFiles = new Set();
+            const mdCandidates = candidates.filter((c) => c.isFile() && c.name.endsWith('.md'));
+            for (const candidate of mdCandidates) {
+                const parentPath = 'parentPath' in candidate && typeof candidate.parentPath === 'string'
+                    ? candidate.parentPath
+                    : candidate.path ?? '';
+                const absPath = path.join(parentPath, candidate.name);
+                try {
+                    const content = await fs.readFile(absPath, 'utf-8');
+                    const parsed = await parseFrontmatter(content);
+                    if (!parsed)
+                        continue;
+                    const { metadata, body } = parsed;
+                    // Must have id and title to be treated as an example
+                    if (typeof metadata.id !== 'string' ||
+                        typeof metadata.title !== 'string') {
+                        continue;
+                    }
+                    examples.push({
+                        id: metadata.id,
+                        title: metadata.title,
+                        description: typeof metadata.description === 'string'
+                            ? metadata.description
+                            : undefined,
+                        rootPath: path.dirname(absPath),
+                        files: [
+                            {
+                                absolutePath: absPath,
+                                relativePath: candidate.name,
+                                raw: content,
+                                parsed: body,
+                            },
+                        ],
+                        metadata,
+                        extractorName: EXTRACTOR_NAME,
+                    });
+                    claimedFiles.add(absPath);
+                }
+                catch (err) {
+                    errors.push({
+                        path: absPath,
+                        message: err instanceof Error ? err.message : `Failed to read ${absPath}`,
+                        cause: err instanceof Error ? err : undefined,
+                    });
+                }
+            }
+            return { examples, errors, claimedFiles };
+        },
+    };
+}
+//# sourceMappingURL=extractor.js.map

package/dist/extractor/extractor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import type { Plugin } from '@functional-examples/devkit';
+import type { DocsMetadataSchemaType, DocumentationPluginOptions } from './schema.js';
+/**
+ * Create the documentation plugin.
+ *
+ * @example
+ * ```typescript
+ * import { createDocumentationPlugin } from '@functional-examples/documentation';
+ *
+ * const config = {
+ *   plugins: [
+ *     createDocumentationPlugin({
+ *       outputDir: './docs',
+ *       format: 'markdown',
+ *     }),
+ *   ],
+ * };
+ * ```
+ */
+export declare function createDocumentationPlugin(options?: DocumentationPluginOptions): Plugin<DocsMetadataSchemaType>;
+export type { DocumentationPluginOptions, DocsMetadata, ResolvedDocumentationPluginOptions, DocsMetadataSchemaType, } from './schema.js';
+export type { TemplateData, TemplateDescriptor, RenderedFile, IndexTemplateData, ProseRenderResult, } from './templates/engine.js';
+export type { TemplateHelpers } from './templates/helpers.js';
+export type { ProseHelpers } from './templates/prose-helpers.js';
+export { createMarkdownExtractor } from './extractor/extractor.js';
+export { renderTemplate, buildTemplateData, renderProseFiles, loadTemplates, parseTemplateName, substituteVars, renderItemTemplate, renderIndexTemplate, getBuiltinTemplatesDir, } from './templates/engine.js';
+export { templateHelpers } from './templates/helpers.js';
+export { ConsumptionTracker } from './templates/consumption-tracker.js';
+export { createProseHelpers, fencedBlock } from './templates/prose-helpers.js';
+export { createGuideRenderer } from './templates/guide-renderer.js';
+export type { GuideRenderer, ExampleAccessor } from './templates/guide-renderer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAoB,MAAM,6BAA6B,CAAC;AAG5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAQtF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,MAAM,CAAC,sBAAsB,CAAC,CAkBhC;AAGD,YAAY,EACV,0BAA0B,EAC1B,YAAY,EACZ,kCAAkC,EAClC,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,46 @@
+import { createDocumentationCommands } from './commands/index.js';
+import { createMarkdownExtractor } from './extractor/extractor.js';
+import { DOCS_METADATA_JSON_SCHEMA, DOCS_OPTIONS_JSON_SCHEMA, docsOptionsSchema, validateDocsMetadata, } from './schema.js';
+/**
+ * Create the documentation plugin.
+ *
+ * @example
+ * ```typescript
+ * import { createDocumentationPlugin } from '@functional-examples/documentation';
+ *
+ * const config = {
+ *   plugins: [
+ *     createDocumentationPlugin({
+ *       outputDir: './docs',
+ *       format: 'markdown',
+ *     }),
+ *   ],
+ * };
+ * ```
+ */
+export function createDocumentationPlugin(options = {}) {
+    return {
+        name: '@functional-examples/documentation',
+        extensions: options.enableExtractor ? ['.md'] : undefined,
+        extractor: options.enableExtractor ? createMarkdownExtractor() : undefined,
+        schemas: {
+            metadata: JSON.stringify(DOCS_METADATA_JSON_SCHEMA),
+            options: JSON.stringify(DOCS_OPTIONS_JSON_SCHEMA),
+        },
+        validators: {
+            metadata: validateDocsMetadata,
+        },
+        commands: async (config) => {
+            const resolved = docsOptionsSchema.parse(options);
+            return createDocumentationCommands(config, resolved);
+        },
+        _options: options,
+    };
+}
+export { createMarkdownExtractor } from './extractor/extractor.js';
+export { renderTemplate, buildTemplateData, renderProseFiles, loadTemplates, parseTemplateName, substituteVars, renderItemTemplate, renderIndexTemplate, getBuiltinTemplatesDir, } from './templates/engine.js';
+export { templateHelpers } from './templates/helpers.js';
+export { ConsumptionTracker } from './templates/consumption-tracker.js';
+export { createProseHelpers, fencedBlock } from './templates/prose-helpers.js';
+export { createGuideRenderer } from './templates/guide-renderer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAsC,EAAE;IAExC,OAAO;QACL,IAAI,EAAE,oCAAoC;QAC1C,UAAU,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QACzD,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC,SAAS;QAC1E,OAAO,EAAE;YACP,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC;YACnD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC;SAClD;QACD,UAAU,EAAE;YACV,QAAQ,EAAE,oBAA+D;SAC1E;QACD,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACzB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClD,OAAO,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAC;QAChE,CAAC;QACD,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAkBD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/renderers/markdoc.d.ts

@@ -0,0 +1,13 @@
+import type { Renderer } from './types.js';
+/**
+ * Markdoc renderer — wraps code blocks with Markdoc-style fence annotations.
+ *
+ * Converts standard Markdown code fences into Markdoc-annotated fences:
+ *   ```typescript        →  ```typescript {% process=true %}
+ *   code                     code
+ *   ```                      ```
+ *
+ * Also converts headings to Markdoc-annotated headings with auto-generated IDs.
+ */
+export declare function createMarkdocRenderer(): Renderer;
+//# sourceMappingURL=markdoc.d.ts.map

package/dist/renderers/markdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdoc.d.ts","sourceRoot":"","sources":["../../src/renderers/markdoc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAkChD"}

package/dist/renderers/markdoc.js

@@ -0,0 +1,42 @@
+/**
+ * Markdoc renderer — wraps code blocks with Markdoc-style fence annotations.
+ *
+ * Converts standard Markdown code fences into Markdoc-annotated fences:
+ *   ```typescript        →  ```typescript {% process=true %}
+ *   code                     code
+ *   ```                      ```
+ *
+ * Also converts headings to Markdoc-annotated headings with auto-generated IDs.
+ */
+export function createMarkdocRenderer() {
+    return {
+        extension: '.mdoc',
+        render(content) {
+            const lines = content.split('\n');
+            const result = [];
+            for (const line of lines) {
+                // Annotate code fences with Markdoc attributes
+                const fenceMatch = line.match(/^(```\w+)\s*$/);
+                if (fenceMatch) {
+                    result.push(`${fenceMatch[1]} {% process=true %}`);
+                    continue;
+                }
+                // Annotate headings with auto-generated IDs
+                const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+                if (headingMatch) {
+                    const [, hashes, text] = headingMatch;
+                    const id = text
+                        .replace(/`/g, '')
+                        .toLowerCase()
+                        .replace(/[^a-z0-9]+/g, '-')
+                        .replace(/^-|-$/g, '');
+                    result.push(`${hashes} ${text} {% #${id} %}`);
+                    continue;
+                }
+                result.push(line);
+            }
+            return result.join('\n');
+        },
+    };
+}
+//# sourceMappingURL=markdoc.js.map

package/dist/renderers/markdoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdoc.js","sourceRoot":"","sources":["../../src/renderers/markdoc.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,SAAS,EAAE,OAAO;QAClB,MAAM,CAAC,OAAe;YACpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,MAAM,GAAa,EAAE,CAAC;YAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,+CAA+C;gBAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;gBAC/C,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;oBACnD,SAAS;gBACX,CAAC;gBAED,4CAA4C;gBAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;gBACrD,IAAI,YAAY,EAAE,CAAC;oBACjB,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,YAAY,CAAC;oBACtC,MAAM,EAAE,GAAG,IAAI;yBACZ,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;yBACjB,WAAW,EAAE;yBACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;yBAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACzB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,IAAI,QAAQ,EAAE,KAAK,CAAC,CAAC;oBAC9C,SAAS;gBACX,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;YAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/renderers/markdown.d.ts

@@ -0,0 +1,6 @@
+import type { Renderer } from './types.js';
+/**
+ * Markdown renderer — passes template output through as-is.
+ */
+export declare function createMarkdownRenderer(): Renderer;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/renderers/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/renderers/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,QAAQ,CAOjD"}

package/dist/renderers/markdown.js

@@ -0,0 +1,12 @@
+/**
+ * Markdown renderer — passes template output through as-is.
+ */
+export function createMarkdownRenderer() {
+    return {
+        extension: '.md',
+        render(content) {
+            return content;
+        },
+    };
+}
+//# sourceMappingURL=markdown.js.map

package/dist/renderers/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/renderers/markdown.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,SAAS,EAAE,KAAK;QAChB,MAAM,CAAC,OAAe;YACpB,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/renderers/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Renderer interface for post-processing template output.
+ */
+export interface Renderer {
+    /** File extension produced by this renderer (e.g., '.md', '.mdoc') */
+    readonly extension: string;
+    /**
+     * Process template output into final file content.
+     * @param content - Raw rendered template output (Markdown)
+     * @returns Processed content ready to write to disk
+     */
+    render(content: string): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/renderers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/renderers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC"}