@bendyline/squisq-cli 1.0.0 → 1.1.0

package/dist/commands/video.js

@@ -0,0 +1,122 @@
+/**
+ * video command
+ *
+ * Renders a squisq document to MP4 video by delegating to the
+ * programmatic renderDocToMp4 API.
+ *
+ * Usage:
+ *   squisq video <input> [-o output.mp4] [--fps 30] [--quality normal] [--orientation landscape]
+ */
+import { mkdir } from 'node:fs/promises';
+import { dirname, basename, extname, resolve } from 'node:path';
+import { readInput } from '../util/readInput.js';
+import { renderDocToMp4 } from '../api.js';
+const VALID_QUALITIES = ['draft', 'normal', 'high'];
+const VALID_ORIENTATIONS = ['landscape', 'portrait'];
+const VALID_CAPTIONS = ['off', 'standard', 'social'];
+export function registerVideoCommand(program) {
+    program
+        .command('video')
+        .description('Render a squisq document to MP4 video')
+        .argument('<input>', 'Path to .md file, .zip/.dbk container, or folder')
+        .argument('[output]', 'Output MP4 path (default: <input>.mp4)')
+        .option('-o, --output <path>', 'Output MP4 path (default: <input>.mp4)')
+        .option('--fps <number>', 'Frames per second (default: 30)', '30')
+        .option('--quality <level>', `Encoding quality: ${VALID_QUALITIES.join(', ')} (default: normal)`, 'normal')
+        .option('--orientation <orient>', `Video orientation: ${VALID_ORIENTATIONS.join(', ')} (default: landscape)`, 'landscape')
+        .option('--captions <style>', `Caption style: ${VALID_CAPTIONS.join(', ')} (default: off)`, 'off')
+        .option('--width <pixels>', 'Override video width')
+        .option('--height <pixels>', 'Override video height')
+        .action(async (inputPath, outputArg, opts) => {
+        try {
+            // Positional output arg takes precedence, then -o flag
+            if (outputArg && !opts.output) {
+                opts.output = outputArg;
+            }
+            await runVideo(inputPath, opts);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`Error: ${message}`);
+            process.exitCode = 1;
+        }
+    });
+}
+async function runVideo(inputPath, opts) {
+    const resolvedInput = resolve(inputPath);
+    // Validate options
+    const fps = parseInt(opts.fps ?? '30', 10);
+    if (isNaN(fps) || fps < 1 || fps > 120) {
+        throw new Error('FPS must be a number between 1 and 120');
+    }
+    const quality = opts.quality ?? 'normal';
+    if (!VALID_QUALITIES.includes(quality)) {
+        throw new Error(`Invalid quality "${quality}". Valid: ${VALID_QUALITIES.join(', ')}`);
+    }
+    const orientation = opts.orientation ?? 'landscape';
+    if (!VALID_ORIENTATIONS.includes(orientation)) {
+        throw new Error(`Invalid orientation "${orientation}". Valid: ${VALID_ORIENTATIONS.join(', ')}`);
+    }
+    const captions = opts.captions ?? 'off';
+    if (!VALID_CAPTIONS.includes(captions)) {
+        throw new Error(`Invalid captions "${captions}". Valid: ${VALID_CAPTIONS.join(', ')}`);
+    }
+    const captionStyle = captions === 'off' ? undefined : captions;
+    // Determine output path
+    const inputBasename = basename(resolvedInput);
+    const inputExt = extname(inputBasename);
+    const baseName = inputExt ? inputBasename.slice(0, -inputExt.length) : inputBasename;
+    const outputPath = opts.output
+        ? resolve(opts.output)
+        : resolve(dirname(resolvedInput), `${baseName}.mp4`);
+    // Ensure output directory exists
+    await mkdir(dirname(outputPath), { recursive: true });
+    // ── Step 1: Read input ──────────────────────────────────────────
+    console.error(`Reading: ${resolvedInput}`);
+    const result = await readInput(resolvedInput);
+    const { container } = result;
+    // ── Step 2: Get or parse Doc ────────────────────────────────────
+    let doc;
+    if (result.doc) {
+        console.error('Using pre-built Doc JSON');
+        doc = result.doc;
+    }
+    else if (result.markdownDoc) {
+        const { markdownToDoc } = await import('@bendyline/squisq/doc');
+        doc = markdownToDoc(result.markdownDoc);
+    }
+    else {
+        throw new Error('No document found in input');
+    }
+    console.error(`Rendering: ${fps} fps, quality: ${quality}, orientation: ${orientation}, captions: ${captions}`);
+    // ── Step 3: Render via programmatic API ─────────────────────────
+    const result2 = await renderDocToMp4(doc, container, {
+        outputPath,
+        fps,
+        quality: quality,
+        orientation: orientation,
+        width: opts.width ? parseInt(opts.width, 10) : undefined,
+        height: opts.height ? parseInt(opts.height, 10) : undefined,
+        captionStyle,
+        coverPreRoll: 2,
+        onProgress: (phase, percent) => {
+            writeProgress(phase, percent, 100);
+        },
+    });
+    clearProgress();
+    console.error(`  ✓ ${outputPath} (${result2.duration.toFixed(1)}s, ${result2.frameCount} frames)`);
+    console.error('Done.');
+}
+// ── Progress helpers ──────────────────────────────────────────────
+const BAR_WIDTH = 30;
+function writeProgress(label, current, total, detail) {
+    const pct = Math.min(100, Math.round((current / total) * 100));
+    const filled = Math.round((pct / 100) * BAR_WIDTH);
+    const bar = '█'.repeat(filled) + '░'.repeat(BAR_WIDTH - filled);
+    const suffix = detail ? ` (${detail})` : '';
+    process.stderr.write(`\r  ${label}: ${bar} ${pct}%${suffix}  `);
+}
+function clearProgress() {
+    process.stderr.write('\r' + ' '.repeat(80) + '\r');
+}
+//# sourceMappingURL=video.js.map

package/dist/commands/video.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,12 @@
-
-export {  }
+/**
+ * squisq CLI
+ *
+ * Command-line tool for converting and processing Squisq documents.
+ * Designed for easy addition of future subcommands (e.g., import).
+ *
+ * Usage:
+ *   squisq convert <input> [options]
+ *   squisq --help
+ */
+export {};
+//# 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":"AAAA;;;;;;;;;GASG"}

package/dist/index.js

@@ -1,428 +1,23 @@
-#!/usr/bin/env node
-
-// src/index.ts
-import { Command } from "commander";
-
-// src/commands/convert.ts
-import { writeFile, mkdir } from "fs/promises";
-import { dirname, basename, extname as extname2, join as join2, resolve } from "path";
-
-// src/util/readInput.ts
-import { readFile, readdir, stat } from "fs/promises";
-import { join, extname } from "path";
-import { parseMarkdown } from "@bendyline/squisq/markdown";
-import { MemoryContentContainer } from "@bendyline/squisq/storage";
-import { zipToContainer } from "@bendyline/squisq-formats/container";
-var MIME_TYPES = {
-  ".md": "text/markdown",
-  ".txt": "text/plain",
-  ".json": "application/json",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".png": "image/png",
-  ".gif": "image/gif",
-  ".webp": "image/webp",
-  ".svg": "image/svg+xml",
-  ".mp3": "audio/mpeg",
-  ".wav": "audio/wav",
-  ".ogg": "audio/ogg",
-  ".mp4": "video/mp4",
-  ".webm": "video/webm"
-};
-function mimeFromExt(filePath) {
-  return MIME_TYPES[extname(filePath).toLowerCase()] ?? "application/octet-stream";
-}
-async function walkDir(root, prefix = "") {
-  const entries = await readdir(root, { withFileTypes: true });
-  const paths = [];
-  for (const entry of entries) {
-    const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
-    if (entry.isDirectory()) {
-      paths.push(...await walkDir(join(root, entry.name), relPath));
-    } else if (entry.isFile()) {
-      paths.push(relPath);
-    }
-  }
-  return paths;
-}
-async function readInput(inputPath) {
-  const info = await stat(inputPath);
-  if (info.isDirectory()) {
-    return readFolder(inputPath);
-  }
-  const ext = extname(inputPath).toLowerCase();
-  if (ext === ".zip" || ext === ".dbk") {
-    return readContainer(inputPath);
-  }
-  return readMarkdownFile(inputPath);
-}
-async function readMarkdownFile(filePath) {
-  const content = await readFile(filePath, "utf-8");
-  const container = new MemoryContentContainer();
-  await container.writeDocument(content);
-  const markdownDoc = parseMarkdown(content);
-  return { container, markdownDoc };
-}
-async function readContainer(filePath) {
-  const data = await readFile(filePath);
-  const container = await zipToContainer(
-    data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength)
-  );
-  const markdown = await container.readDocument();
-  if (!markdown) {
-    throw new Error(`No markdown document found in container: ${filePath}`);
-  }
-  const markdownDoc = parseMarkdown(markdown);
-  return { container, markdownDoc };
-}
-async function readFolder(dirPath) {
-  const container = new MemoryContentContainer();
-  const files = await walkDir(dirPath);
-  for (const relPath of files) {
-    const absPath = join(dirPath, relPath);
-    const data = await readFile(absPath);
-    await container.writeFile(
-      relPath,
-      new Uint8Array(data.buffer, data.byteOffset, data.byteLength),
-      mimeFromExt(relPath)
-    );
-  }
-  const markdown = await container.readDocument();
-  if (!markdown) {
-    throw new Error(`No markdown document found in folder: ${dirPath}`);
-  }
-  const markdownDoc = parseMarkdown(markdown);
-  return { container, markdownDoc };
-}
-
-// src/commands/convert.ts
-var ALL_FORMATS = ["docx", "pdf", "html", "dbk"];
-function parseFormats(value) {
-  const requested = value.split(",").map((s) => s.trim().toLowerCase());
-  const valid = [];
-  for (const r of requested) {
-    if (ALL_FORMATS.includes(r)) {
-      valid.push(r);
-    } else {
-      console.warn(`Unknown format "${r}" \u2014 skipping. Valid: ${ALL_FORMATS.join(", ")}`);
-    }
-  }
-  if (valid.length === 0) {
-    throw new Error(`No valid formats specified. Valid: ${ALL_FORMATS.join(", ")}`);
-  }
-  return valid;
-}
-function registerConvertCommand(program2) {
-  program2.command("convert").description("Convert a markdown document to DOCX, PDF, HTML, and DBK container formats").argument("<input>", "Path to .md file, .zip/.dbk container, or folder").option("-o, --output-dir <dir>", "Output directory (default: same as input)").option(
-    "-f, --formats <list>",
-    `Comma-separated formats to produce (default: all). Valid: ${ALL_FORMATS.join(", ")}`
-  ).action(async (inputPath, opts) => {
-    try {
-      await runConvert(inputPath, opts);
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      console.error(`Error: ${message}`);
-      process.exitCode = 1;
-    }
-  });
-}
-async function runConvert(inputPath, opts) {
-  const resolvedInput = resolve(inputPath);
-  const formats = opts.formats ? parseFormats(opts.formats) : [...ALL_FORMATS];
-  const outputDir = opts.outputDir ? resolve(opts.outputDir) : dirname(resolvedInput);
-  const inputBasename = basename(resolvedInput);
-  const inputExt = extname2(inputBasename);
-  const baseName = inputExt ? inputBasename.slice(0, -inputExt.length) : inputBasename;
-  await mkdir(outputDir, { recursive: true });
-  console.error(`Reading: ${resolvedInput}`);
-  const { container, markdownDoc } = await readInput(resolvedInput);
-  for (const format of formats) {
-    const outPath = join2(outputDir, `${baseName}.${format}`);
-    switch (format) {
-      case "docx": {
-        const { markdownDocToDocx } = await import("@bendyline/squisq-formats/docx");
-        const buf = await markdownDocToDocx(markdownDoc);
-        await writeFile(outPath, Buffer.from(buf));
-        break;
-      }
-      case "pdf": {
-        const { markdownDocToPdf } = await import("@bendyline/squisq-formats/pdf");
-        const buf = await markdownDocToPdf(markdownDoc);
-        await writeFile(outPath, Buffer.from(buf));
-        break;
-      }
-      case "html": {
-        const { markdownToDoc } = await import("@bendyline/squisq/doc");
-        const { docToHtml, collectImagePaths } = await import("@bendyline/squisq-formats/html");
-        const { PLAYER_BUNDLE } = await import("@bendyline/squisq-react/standalone-source");
-        const doc = markdownToDoc(markdownDoc);
-        const imagePaths = collectImagePaths(doc);
-        const images = /* @__PURE__ */ new Map();
-        for (const imgPath of imagePaths) {
-          const data = await container.readFile(imgPath);
-          if (data) {
-            images.set(imgPath, data);
-          }
-        }
-        const html = docToHtml(doc, {
-          playerScript: PLAYER_BUNDLE,
-          images,
-          title: baseName,
-          mode: "static"
-        });
-        await writeFile(outPath, html, "utf-8");
-        break;
-      }
-      case "dbk": {
-        const { containerToZip } = await import("@bendyline/squisq-formats/container");
-        const blob = await containerToZip(container);
-        const buf = await blob.arrayBuffer();
-        await writeFile(outPath, Buffer.from(buf));
-        break;
-      }
-    }
-    console.error(`  \u2713 ${outPath}`);
-  }
-  console.error("Done.");
-}
-
-// src/commands/video.ts
-import { mkdir as mkdir2 } from "fs/promises";
-import { dirname as dirname2, basename as basename2, extname as extname3, resolve as resolve2 } from "path";
-
-// src/util/detectFfmpeg.ts
-import { execFile } from "child_process";
-async function detectFfmpeg() {
-  const command = process.platform === "win32" ? "where" : "which";
-  return new Promise((resolve3) => {
-    execFile(command, ["ffmpeg"], { timeout: 5e3 }, (err, stdout) => {
-      if (err || !stdout.trim()) {
-        resolve3(null);
-        return;
-      }
-      const path = stdout.trim().split("\n")[0].trim();
-      resolve3(path);
-    });
-  });
-}
-
-// src/commands/video.ts
-var VALID_QUALITIES = ["draft", "normal", "high"];
-var VALID_ORIENTATIONS = ["landscape", "portrait"];
-var VALID_CAPTIONS = ["off", "standard", "social"];
-function registerVideoCommand(program2) {
-  program2.command("video").description("Render a squisq document to MP4 video").argument("<input>", "Path to .md file, .zip/.dbk container, or folder").argument("[output]", "Output MP4 path (default: <input>.mp4)").option("-o, --output <path>", "Output MP4 path (default: <input>.mp4)").option("--fps <number>", "Frames per second (default: 30)", "30").option(
-    "--quality <level>",
-    `Encoding quality: ${VALID_QUALITIES.join(", ")} (default: normal)`,
-    "normal"
-  ).option(
-    "--orientation <orient>",
-    `Video orientation: ${VALID_ORIENTATIONS.join(", ")} (default: landscape)`,
-    "landscape"
-  ).option(
-    "--captions <style>",
-    `Caption style: ${VALID_CAPTIONS.join(", ")} (default: off)`,
-    "off"
-  ).option("--width <pixels>", "Override video width").option("--height <pixels>", "Override video height").action(async (inputPath, outputArg, opts) => {
-    try {
-      if (outputArg && !opts.output) {
-        opts.output = outputArg;
-      }
-      await runVideo(inputPath, opts);
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      console.error(`Error: ${message}`);
-      process.exitCode = 1;
-    }
-  });
-}
-async function runVideo(inputPath, opts) {
-  const resolvedInput = resolve2(inputPath);
-  const fps = parseInt(opts.fps ?? "30", 10);
-  if (isNaN(fps) || fps < 1 || fps > 120) {
-    throw new Error("FPS must be a number between 1 and 120");
-  }
-  const quality = opts.quality ?? "normal";
-  if (!VALID_QUALITIES.includes(quality)) {
-    throw new Error(`Invalid quality "${quality}". Valid: ${VALID_QUALITIES.join(", ")}`);
-  }
-  const orientation = opts.orientation ?? "landscape";
-  if (!VALID_ORIENTATIONS.includes(orientation)) {
-    throw new Error(
-      `Invalid orientation "${orientation}". Valid: ${VALID_ORIENTATIONS.join(", ")}`
-    );
-  }
-  const captions = opts.captions ?? "off";
-  if (!VALID_CAPTIONS.includes(captions)) {
-    throw new Error(`Invalid captions "${captions}". Valid: ${VALID_CAPTIONS.join(", ")}`);
-  }
-  const captionStyle = captions === "off" ? void 0 : captions;
-  const inputBasename = basename2(resolvedInput);
-  const inputExt = extname3(inputBasename);
-  const baseName = inputExt ? inputBasename.slice(0, -inputExt.length) : inputBasename;
-  const outputPath = opts.output ? resolve2(opts.output) : resolve2(dirname2(resolvedInput), `${baseName}.mp4`);
-  await mkdir2(dirname2(outputPath), { recursive: true });
-  console.error(`Reading: ${resolvedInput}`);
-  const { container, markdownDoc } = await readInput(resolvedInput);
-  const { markdownToDoc } = await import("@bendyline/squisq/doc");
-  const doc = markdownToDoc(markdownDoc);
-  const { collectImagePaths } = await import("@bendyline/squisq-formats/html");
-  const imagePaths = collectImagePaths(doc);
-  const images = /* @__PURE__ */ new Map();
-  for (const imgPath of imagePaths) {
-    const data = await container.readFile(imgPath);
-    if (data) {
-      images.set(imgPath, data);
-    }
-  }
-  const audio = /* @__PURE__ */ new Map();
-  let concatenatedAudio = null;
-  if (doc.audio?.segments?.length) {
-    for (const seg of doc.audio.segments) {
-      const data = await container.readFile(seg.src);
-      if (data) {
-        audio.set(seg.src, data);
-        audio.set(seg.name, data);
-      }
-    }
-    if (audio.size > 0) {
-      const firstSeg = doc.audio.segments[0];
-      const firstData = await container.readFile(firstSeg.src);
-      if (firstData) {
-        concatenatedAudio = new Uint8Array(firstData);
-      }
-    }
-  }
-  const { generateRenderHtml } = await import("@bendyline/squisq-video");
-  const { PLAYER_BUNDLE } = await import("@bendyline/squisq-react/standalone-source");
-  const { resolveDimensions } = await import("@bendyline/squisq-video");
-  const dimensions = resolveDimensions({
-    orientation,
-    width: opts.width ? parseInt(opts.width, 10) : void 0,
-    height: opts.height ? parseInt(opts.height, 10) : void 0
-  });
-  const renderHtml = generateRenderHtml(doc, {
-    playerScript: PLAYER_BUNDLE,
-    images,
-    audio: audio.size > 0 ? audio : void 0,
-    width: dimensions.width,
-    height: dimensions.height,
-    captionStyle
-  });
-  console.error(
-    `Viewport: ${dimensions.width}x${dimensions.height}, ${fps} fps, quality: ${quality}, captions: ${captions}`
-  );
-  const { chromium } = await import("playwright-core");
-  const browser = await chromium.launch({ headless: true });
-  const page = await browser.newPage({
-    viewport: { width: dimensions.width, height: dimensions.height }
-  });
-  const pageErrors = [];
-  page.on("pageerror", (err) => pageErrors.push(err.message));
-  page.on("console", (msg) => {
-    if (msg.type() === "error") pageErrors.push(msg.text());
-  });
-  await page.setContent(renderHtml, { waitUntil: "load" });
-  await page.waitForTimeout(500);
-  try {
-    await page.waitForFunction(
-      () => typeof window.getDuration === "function",
-      { timeout: 15e3 }
-    );
-  } catch {
-    await browser.close();
-    const errorDetail = pageErrors.length ? `
-Page errors:
-  ${pageErrors.join("\n  ")}` : "\nNo page errors captured \u2014 the player may have failed to mount.";
-    throw new Error(`Render API did not initialize within 15 seconds.${errorDetail}`);
-  }
-  const duration = await page.evaluate(() => {
-    return window.getDuration();
-  });
-  if (duration <= 0) {
-    await browser.close();
-    throw new Error("Document has zero duration \u2014 nothing to render");
-  }
-  const totalFrames = Math.ceil(duration * fps);
-  console.error(`Duration: ${duration.toFixed(1)}s, ${totalFrames} frames to capture`);
-  const frames = [];
-  const frameInterval = 1 / fps;
-  const hasCover = await page.evaluate(() => {
-    const w = window;
-    return typeof w.hasCoverBlock === "function" ? w.hasCoverBlock() : false;
-  });
-  if (hasCover) {
-    const coverFrameCount = 2 * fps;
-    await page.evaluate(() => {
-      window.showCover();
-    });
-    await page.waitForTimeout(100);
-    const coverScreenshot = await page.screenshot({ type: "png" });
-    const coverFrame = new Uint8Array(coverScreenshot);
-    for (let i = 0; i < coverFrameCount; i++) {
-      frames.push(coverFrame);
-    }
-    await page.evaluate(() => {
-      window.hideCover();
-    });
-    writeProgress("Capturing", coverFrameCount, totalFrames + coverFrameCount);
-  }
-  const totalWithCover = totalFrames + frames.length;
-  for (let i = 0; i < totalFrames; i++) {
-    const time = i * frameInterval;
-    await page.evaluate((t) => {
-      return window.seekTo(t);
-    }, time);
-    const screenshot = await page.screenshot({ type: "png" });
-    frames.push(new Uint8Array(screenshot));
-    if (i % Math.max(1, Math.floor(fps / 2)) === 0 || i === totalFrames - 1) {
-      writeProgress("Capturing", frames.length, totalWithCover);
-    }
-  }
-  clearProgress();
-  await browser.close();
-  const ffmpegPath = await detectFfmpeg();
-  const exportOptions = {
-    fps,
-    quality,
-    orientation,
-    width: dimensions.width,
-    height: dimensions.height,
-    onProgress: (percent, phase) => {
-      writeProgress("Encoding", percent, 100, phase);
-    }
-  };
-  if (ffmpegPath) {
-    console.error(`Using native ffmpeg: ${ffmpegPath}`);
-    const { framesToMp4Native } = await import("./nativeEncoder-EXDP2O5B.js");
-    await framesToMp4Native(ffmpegPath, frames, concatenatedAudio, outputPath, exportOptions);
-  } else {
-    throw new Error(
-      "ffmpeg is required but not found in PATH.\nInstall it with:\n  macOS:   brew install ffmpeg\n  Ubuntu:  sudo apt install ffmpeg\n  Windows: winget install ffmpeg"
-    );
-  }
-  clearProgress();
-  console.error(`  \u2713 ${outputPath}`);
-  console.error("Done.");
-}
-var BAR_WIDTH = 30;
-function writeProgress(label, current, total, detail) {
-  const pct = Math.min(100, Math.round(current / total * 100));
-  const filled = Math.round(pct / 100 * BAR_WIDTH);
-  const bar = "\u2588".repeat(filled) + "\u2591".repeat(BAR_WIDTH - filled);
-  const suffix = detail ? ` (${detail})` : "";
-  process.stderr.write(`\r  ${label}: ${bar} ${pct}%${suffix}  `);
-}
-function clearProgress() {
-  process.stderr.write("\r" + " ".repeat(80) + "\r");
-}
-
-// src/index.ts
-console.error(
-  "\x1B[36m{[\x1B[0m \x1B[1msquiggly square\x1B[0m \x1B[2m\u2014\x1B[0m \x1B[1msquisq\x1B[0m \x1B[2m\u2014\x1B[0m \x1B[33mv1.0.0\x1B[0m \x1B[36m]}\x1B[0m"
-);
-var program = new Command();
-program.name("squisq").description("Squisq CLI \u2014 convert and process markdown-based documents").version("1.0.0");
+/**
+ * squisq CLI
+ *
+ * Command-line tool for converting and processing Squisq documents.
+ * Designed for easy addition of future subcommands (e.g., import).
+ *
+ * Usage:
+ *   squisq convert <input> [options]
+ *   squisq --help
+ */
+import { Command } from 'commander';
+import { registerConvertCommand } from './commands/convert.js';
+import { registerVideoCommand } from './commands/video.js';
+// Colored banner: cyan brackets, bold white text, dim version
+console.error('\x1b[36m{[\x1b[0m \x1b[1msquiggly square\x1b[0m \x1b[2m—\x1b[0m \x1b[1msquisq\x1b[0m \x1b[2m—\x1b[0m \x1b[33mv1.0.0\x1b[0m \x1b[36m]}\x1b[0m');
+const program = new Command();
+program
+    .name('squisq')
+    .description('Squisq CLI — convert and process markdown-based documents')
+    .version('1.0.0');
 registerConvertCommand(program);
 registerVideoCommand(program);
 program.parse();