@bendyline/docblocks-cli 1.1.1 → 2.0.0

package/README.md

@@ -1,109 +1,93 @@
 # @bendyline/docblocks-cli
 
-DocBlocks CLI — build, serve, convert, and manage markdown document projects from the command line.
+The DocBlocks command-line surface for document build and preview, linked-Squisq
+format conversion, MP4 rendering, document parsing, and a local MCP server for
+agents.
 
 ## Installation
 
+Node.js 22.14 or newer is required.
+
 ```bash
 npm install -g @bendyline/docblocks-cli
+docblocks --help
 ```
 
-## Commands
-
-### `docblocks init [dir]`
-
-Initialize a new DocBlocks workspace. Creates a `.docblocks` directory with configuration.
+## Documentation
 
-### `docblocks build`
+- [Authoritative CLI reference](https://github.com/bendyline/docblocks/blob/main/docs/cli.md)
+- [MCP architecture and protocol guide](https://github.com/bendyline/docblocks/blob/main/docs/mcp.md)
 
-Build markdown files into HTML output.
+Those guides describe current input support, linked Squisq ownership, format
+directions, overwrite behavior, MCP authority, artifact lifecycle, and assurance.
 
-```bash
-docblocks build -i ./docs -o ./dist
-```
-
-### `docblocks serve`
+## Commands
 
-Start a local development server for previewing documents.
+| Command                            | Purpose                                               |
+| ---------------------------------- | ----------------------------------------------------- |
+| `docblocks init [dir]`             | Create minimal `.docblocks/config.json` metadata.     |
+| `docblocks build`                  | Recursively build Markdown into standalone HTML.      |
+| `docblocks serve`                  | Run a constrained local preview server.               |
+| `docblocks convert <input>`        | Convert through the linked Squisq registry.           |
+| `docblocks video <input> [output]` | Render a configurable MP4.                            |
+| `docblocks mcp`                    | Start the artifact-first MCP server over local stdio. |
+| `docblocks themes`                 | List linked Squisq theme IDs.                         |
+| `docblocks transforms`             | List linked Squisq transform IDs.                     |
+| `docblocks parse <input>`          | Parse UTF-8 Markdown into Squisq Markdown AST JSON.   |
 
-### `docblocks convert <input>`
+Use `docblocks help <command>` for the installed option summary.
 
-Convert a markdown document to DOCX, PPTX, PDF, HTML, or DBK container format.
+## Examples
 
 ```bash
-# Convert to all formats
-docblocks convert story.md
-
-# Convert to specific formats with a theme
-docblocks convert story.md -f docx,pdf -t cinematic
-
-# Apply a transform style before exporting
-docblocks convert story.md --transform documentary -o ./output
-```
+# Build and preview Markdown
+docblocks build --input ./docs --output ./dist
+docblocks serve --dir ./docs
 
-**Options:**
-
-- `-o, --output-dir <dir>` — Output directory
-- `-f, --formats <list>` — Comma-separated formats: docx, pptx, pdf, html, dbk
-- `-t, --theme <id>` — Visual theme (use `docblocks themes` to list)
-- `--transform <style>` — Transform style (use `docblocks transforms` to list)
-
-### `docblocks video <input> [output]`
+# The no-flag conversion set is exactly DOCX, PPTX, PDF, HTML, and DBK
+docblocks convert story.md
 
-Render a document to MP4 video with synced animations. Requires ffmpeg and Playwright.
+# Select any export-capable linked-registry formats
+docblocks convert report.docx --formats md,pdf,pptx --output-dir ./exports
 
-```bash
+# Render MP4 with explicit media controls
 docblocks video story.md --quality high --orientation portrait
-```
-
-**Options:**
-
-- `-o, --output <path>` — Output MP4 path
-- `--fps <number>` — Frames per second (1-120, default: 30)
-- `--quality <level>` — draft, normal, or high
-- `--orientation <orient>` — landscape or portrait
-- `--captions <style>` — off, standard, or social
-- `--width <pixels>` / `--height <pixels>` — Override dimensions
 
-### `docblocks mcp`
+# Discover authoring vocabulary from linked Squisq
+docblocks themes
+docblocks transforms
 
-Start an MCP (Model Context Protocol) server over stdio for AI-assisted document operations.
-
-```bash
+# Start MCP with no filesystem authority
 docblocks mcp
-```
 
-**MCP Tools exposed:**
-
-- `export_markdown_to_docx` / `_pdf` / `_pptx` / `_html` / `_video` — Export markdown to polished output formats
-- `analyze_markdown` — Extract content structure (stats, quotes, facts, dates)
-- `restyle_markdown` — Apply a transform style and return restyled markdown
-- `list_themes` / `list_transform_styles` / `list_export_formats` — Discovery tools
-
-All export tools accept raw markdown text directly — AI agents can write content and immediately export without temp files.
-
-**Claude Desktop / Copilot integration:**
-
-```json
-{
-  "mcpServers": {
-    "docblocks": { "command": "npx", "args": ["docblocks", "mcp"] }
-  }
-}
+# Grant independent roots when an agent needs files or durable output
+docblocks mcp --allow-read ./documents --allow-write ./exports
 ```
 
-### `docblocks themes`
+`convert` and `video` accept Markdown, Squisq JSON Doc, DBK/ZIP, folders, and
+import-capable linked-registry formats. Direct `build`, `convert`, and `video`
+outputs replace existing destination files. MCP conversions instead return
+immutable session artifacts; only explicit `save_artifact` materializes one, using
+no-replace or hash-conditional replacement semantics.
 
-List all available visual themes.
+The live linked registry currently covers Markdown, DOCX, PDF, PPTX, XLSX, CSV,
+HTML, HTML ZIP, EPUB, DBK, MP4, and GIF. Direction varies by format, so use the
+CLI reference or MCP `list_formats` rather than assuming every format imports.
 
-### `docblocks transforms`
+MP4/GIF rendering requires Chromium and FFmpeg. Install Chromium with
+`npx playwright install chromium`; Squisq resolves FFmpeg from `SQUISQ_FFMPEG`,
+`PATH`, or `ffmpeg-static`, in that order.
 
-List all available transform styles.
+## Development with linked Squisq
 
-### `docblocks parse <input>`
+From the DocBlocks repository root:
 
-Parse a markdown file and print its structure as JSON.
-
-## License
+```bash
+npm run link:squisq
+npm run check:squisq-linked
+npm run test:mcp:linked
+npm run all
+```
 
-MIT
+The linked assurance commands use the sibling `..\squisq` source checkout, not the
+npm package copy.

package/dist/commands/build.d.ts

@@ -1,3 +1,14 @@
 import { Command } from 'commander';
+export interface BuildOptions {
+    input: string;
+    output: string;
+    theme?: string;
+}
+export interface BuildResult {
+    inputDir: string;
+    outputDir: string;
+    builtFiles: string[];
+}
+export declare function runBuild(opts: BuildOptions): Promise<BuildResult>;
 export declare const buildCommand: Command;
 //# sourceMappingURL=build.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,YAAY,SAiCrB,CAAC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAmCvE;AAED,eAAO,MAAM,YAAY,SAiBrB,CAAC"}

package/dist/commands/build.js

@@ -1,58 +1,74 @@
 import { Command } from 'commander';
-import fs from 'node:fs';
+import { mkdir, readdir, readFile, stat, writeFile } from 'node:fs/promises';
 import path from 'node:path';
-import { parseMarkdown, stringifyMarkdown } from '@bendyline/squisq/markdown';
+import { renderMarkdownHtml } from '../render-html.js';
+export async function runBuild(opts) {
+    const inputDir = path.resolve(opts.input);
+    const outputDir = path.resolve(opts.output);
+    const inputStat = await stat(inputDir).catch(() => null);
+    if (!inputStat?.isDirectory()) {
+        throw new Error(`Input directory not found: ${inputDir}`);
+    }
+    const markdownFiles = await listMarkdownFiles(inputDir);
+    if (markdownFiles.length === 0) {
+        throw new Error(`No markdown files found in ${inputDir}.`);
+    }
+    await mkdir(outputDir, { recursive: true });
+    const builtFiles = [];
+    for (const sourcePath of markdownFiles) {
+        const relativePath = path.relative(inputDir, sourcePath);
+        const outputPath = path.join(outputDir, replaceMarkdownExtension(relativePath));
+        const source = await readFile(sourcePath, 'utf-8');
+        const html = await renderMarkdownHtml(source, {
+            title: titleFromPath(relativePath),
+            sourcePath,
+            assetRoot: inputDir,
+            themeId: opts.theme,
+            mode: 'static',
+        });
+        await mkdir(path.dirname(outputPath), { recursive: true });
+        await writeFile(outputPath, html, 'utf-8');
+        builtFiles.push(outputPath);
+    }
+    return { inputDir, outputDir, builtFiles };
+}
 export const buildCommand = new Command('build')
     .description('Build markdown files into HTML output')
     .option('-i, --input <dir>', 'input directory', '.')
     .option('-o, --output <dir>', 'output directory', 'dist')
+    .option('-t, --theme <id>', 'Squisq theme ID to apply')
     .action(async (opts) => {
-    const inputDir = path.resolve(opts.input);
-    const outputDir = path.resolve(opts.output);
-    if (!fs.existsSync(inputDir)) {
-        console.error(`Input directory not found: ${inputDir}`);
-        process.exitCode = 1;
-        return;
-    }
-    fs.mkdirSync(outputDir, { recursive: true });
-    const files = fs.readdirSync(inputDir).filter((f) => f.endsWith('.md'));
-    if (files.length === 0) {
-        console.error('No markdown files found.');
-        return;
+    try {
+        const result = await runBuild(opts);
+        for (const outFile of result.builtFiles) {
+            console.error(`Built: ${outFile}`);
+        }
+        console.error(`Done. ${result.builtFiles.length} file(s) built to ${result.outputDir}`);
     }
-    for (const file of files) {
-        const source = fs.readFileSync(path.join(inputDir, file), 'utf-8');
-        const doc = parseMarkdown(source);
-        const html = wrapHtml(file.replace(/\.md$/, ''), stringifyMarkdown(doc));
-        const outFile = path.join(outputDir, file.replace(/\.md$/, '.html'));
-        fs.writeFileSync(outFile, html);
-        console.error(`Built: ${outFile}`);
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: ${message}`);
+        process.exitCode = 1;
     }
-    console.error(`Done. ${files.length} file(s) built to ${outputDir}`);
 });
-function wrapHtml(title, markdownContent) {
-    return `<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>${escapeHtml(title)}</title>
-  <style>
-    body { font-family: system-ui, -apple-system, sans-serif; max-width: 800px; margin: 0 auto; padding: 2rem; }
-    pre { background: #f5f5f5; padding: 1rem; overflow-x: auto; border-radius: 4px; }
-    code { font-family: 'SF Mono', Menlo, monospace; }
-  </style>
-</head>
-<body>
-  <pre>${escapeHtml(markdownContent)}</pre>
-</body>
-</html>`;
+async function listMarkdownFiles(root) {
+    const entries = await readdir(root, { withFileTypes: true });
+    const files = await Promise.all(entries.map(async (entry) => {
+        const absolutePath = path.join(root, entry.name);
+        if (entry.isDirectory())
+            return listMarkdownFiles(absolutePath);
+        return isMarkdownFile(entry.name) ? [absolutePath] : [];
+    }));
+    return files.flat().sort((a, b) => a.localeCompare(b));
+}
+function isMarkdownFile(fileName) {
+    return /\.(md|markdown)$/i.test(fileName);
+}
+function replaceMarkdownExtension(filePath) {
+    return filePath.replace(/\.(md|markdown)$/i, '.html');
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
+function titleFromPath(filePath) {
+    const baseName = path.basename(filePath).replace(/\.(md|markdown)$/i, '');
+    return baseName || 'DocBlocks Document';
 }
 //# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,uCAAuC,CAAC;KACpD,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,GAAG,CAAC;KACnD,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,CAAC;KACxD,MAAM,CAAC,KAAK,EAAE,IAAuC,EAAE,EAAE;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAExE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACrE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,MAAM,qBAAqB,SAAS,EAAE,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC;AAEL,SAAS,QAAQ,CAAC,KAAa,EAAE,eAAuB;IACtD,OAAO;;;;;WAKE,UAAU,CAAC,KAAK,CAAC;;;;;;;;SAQnB,UAAU,CAAC,eAAe,CAAC;;QAE5B,CAAC;AACT,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAcvD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAEzD,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,GAAG,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,UAAU,IAAI,aAAa,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE;YAC5C,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC;YAClC,UAAU;YACV,SAAS,EAAE,QAAQ;YACnB,OAAO,EAAE,IAAI,CAAC,KAAK;YACnB,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,uCAAuC,CAAC;KACpD,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,GAAG,CAAC;KACnD,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,CAAC;KACxD,MAAM,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;KACtD,MAAM,CAAC,KAAK,EAAE,IAAkB,EAAE,EAAE;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,UAAU,CAAC,MAAM,qBAAqB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1F,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,OAAO,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAChE,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,QAAQ,IAAI,oBAAoB,CAAC;AAC1C,CAAC"}

package/dist/commands/convert.d.ts

@@ -1,8 +1,10 @@
 /**
  * convert command
  *
- * Reads a markdown file, ZIP/DBK container, or folder and exports to
- * supported formats: DOCX, PPTX, PDF, HTML, and container ZIP (.dbk).
+ * Reads any input supported by the linked Squisq CLI and exports through its
+ * canonical format registry. The historical default set remains DOCX, PPTX,
+ * PDF, HTML, and DBK; callers may explicitly request any export-capable
+ * registry format.
  *
  * Wraps the same logic as squisq-cli's convert command, reusing the
  * underlying squisq libraries directly.
@@ -10,17 +12,25 @@
 import { Command } from 'commander';
 import type { MarkdownDocument } from '@bendyline/squisq/markdown';
 import type { ContentContainer } from '@bendyline/squisq/storage';
+import type { FormatRegistry } from '@bendyline/squisq-cli/api';
 export interface ConvertOptions {
     outputDir?: string;
     formats?: string;
     theme?: string;
     transform?: string;
+    /** Cancel reading, transformation, conversion, or publication at a bounded boundary. */
+    signal?: AbortSignal;
+    /** Programmatic registry override; the CLI defaults to the linked Squisq registry. */
+    registry?: FormatRegistry;
 }
 export interface ConvertResult {
     outputFiles: {
         path: string;
         format: string;
         size: number;
+        mimeType: string;
+        suggestedFilename: string;
+        warnings: string[];
     }[];
 }
 export declare function runConvert(inputPath: string, opts: ConvertOptions): Promise<ConvertResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/commands/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAqBlE,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/D;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAmEhG;AA8DD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,gBAAgB,EAC7B,SAAS,EAAE,gBAAgB,EAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAkBD,eAAO,MAAM,cAAc,SAqBvB,CAAC"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/commands/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EAA2B,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIzF,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,EAAE,CAAC;CACL;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAiHhG;AAUD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,gBAAgB,EAC7B,SAAS,EAAE,gBAAgB,EAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AA6LD,eAAO,MAAM,cAAc,SAyBvB,CAAC"}