@mzebley/mark-down-cli 1.2.1 → 1.2.3

package/README.md

@@ -1,5 +1,6 @@
 # mark↓ CLI
-*(published as `@mzebley/mark-down-cli`)*
+
+_(published as `@mzebley/mark-down-cli`)_
 
 `mark-down` is the command-line companion to the mark↓ runtime. It scans Markdown snippets, parses YAML front matter, and emits a sorted `snippets-index.json` manifest consumed by [the core client](../core/README.md). For a full project overview, see the [monorepo README](../../README.md).
 
@@ -59,7 +60,7 @@ The CLI walks the directory tree, gathers front matter, and writes `snippets-ind
 - Resolves snippet metadata from `snippets-index.json` (auto-detected next to the HTML file or provided via `--manifest`).
 - Loads Markdown from disk, strips front matter, and renders HTML with the same `marked` pipeline as the runtime.
 - Injects the rendered HTML as the element `innerHTML` and writes the result to `dist/<file>.html` by default.
-- Use `--outDir` to change the output directory or `--inPlace` to overwrite the source file.
+- Use `--outDir` to change the output directory, `--inPlace` to overwrite the source file, or `--sanitize` to apply HTML sanitization.
 - Unknown slugs are left untouched and logged as warnings. Table-of-contents generation remains a runtime concern.
 
 ## Configuration options
@@ -73,6 +74,7 @@ The CLI stays intentionally small so it can be composed inside any toolchain. Cu
 - `--manifest <path>` – path to `snippets-index.json`. Defaults to the file next to `<inputHtml>`.
 - `--outDir <dir>` – output directory for compiled HTML. Defaults to `dist`.
 - `--inPlace` – overwrite the input HTML file instead of writing to `dist/`.
+- `--sanitize [policy]` – sanitize rendered HTML (`default`, `strict`, or `permissive`). Omitting the policy defaults to `default`.
 
 Add flags directly after the command (`mark-down build content/snippets -o public/snippets-index.json`). Package scripts can capture these options as well.
 

package/dist/index.cjs

@@ -62,13 +62,20 @@ async function buildManifest(sourceDir) {
   for (const absolutePath of files) {
     const relativePath = import_node_path.default.relative(cwd, absolutePath);
     const normalizedPath = toPosix(relativePath);
-    const content = await import_promises.default.readFile(absolutePath, "utf8");
-    const parsed = (0, import_gray_matter.default)(content, MATTER_OPTIONS);
-    const snippet = createSnippet(normalizedPath, parsed.data ?? {});
-    if (snippet.draft) {
-      continue;
+    try {
+      const content = await import_promises.default.readFile(absolutePath, "utf8");
+      const parsed = (0, import_gray_matter.default)(content, MATTER_OPTIONS);
+      const snippet = createSnippet(normalizedPath, parsed.data ?? {});
+      if (snippet.draft) {
+        continue;
+      }
+      manifest.push(snippet);
+    } catch (error) {
+      console.warn(
+        `mark\u2193: failed to load snippet at '${normalizedPath}'`,
+        error
+      );
     }
-    manifest.push(snippet);
   }
   ensureUniqueSlugs(manifest);
   manifest.sort((a, b) => {
@@ -239,7 +246,10 @@ var import_mark_down2 = require("@mzebley/mark-down");
 var DEFAULT_OUT_DIR = "dist";
 async function compilePage(inputHtml, options = {}) {
   const sourcePath = import_node_path3.default.resolve(inputHtml);
-  await assertExists(sourcePath, `Input HTML file not found at '${inputHtml}'.`);
+  await assertExists(
+    sourcePath,
+    `Input HTML file not found at '${inputHtml}'.`
+  );
   const manifestPath = await resolveManifestPath(sourcePath, options.manifest);
   const manifestDir = import_node_path3.default.dirname(manifestPath);
   const manifest = await loadManifest(manifestPath);
@@ -274,9 +284,15 @@ async function compilePage(inputHtml, options = {}) {
       body = frontMatter.content;
       frontMatterSlug = frontMatter.slug;
     } catch (error) {
-      console.warn(`mark\u2193: failed to parse front matter for '${entry.path}'`, error);
+      console.warn(
+        `mark\u2193: failed to parse front matter for '${entry.path}'`,
+        error
+      );
+    }
+    let html = (0, import_mark_down2.renderMarkdown)(body);
+    if (options.sanitize) {
+      html = (0, import_mark_down2.sanitizeMarkup)(html, options.sanitize);
     }
-    const html = (0, import_mark_down2.renderMarkdown)(body);
     element.html(html);
     if (!element.attr("id")) {
       element.attr("id", frontMatterSlug ?? `snippet-${slug}`);
@@ -294,7 +310,10 @@ async function compilePage(inputHtml, options = {}) {
 }
 async function resolveManifestPath(inputHtml, manifestFlag) {
   const manifestPath = manifestFlag ? import_node_path3.default.resolve(manifestFlag) : import_node_path3.default.join(import_node_path3.default.dirname(import_node_path3.default.resolve(inputHtml)), "snippets-index.json");
-  await assertExists(manifestPath, `Manifest file not found at '${manifestPath}'.`);
+  await assertExists(
+    manifestPath,
+    `Manifest file not found at '${manifestPath}'.`
+  );
   return manifestPath;
 }
 async function loadManifest(manifestPath) {
@@ -302,7 +321,9 @@ async function loadManifest(manifestPath) {
   try {
     raw = await import_promises2.default.readFile(manifestPath, "utf8");
   } catch (error) {
-    throw new Error(`Failed to read manifest at '${manifestPath}': ${String(error)}`);
+    throw new Error(
+      `Failed to read manifest at '${manifestPath}': ${String(error)}`
+    );
   }
   try {
     const parsed = JSON.parse(raw);
@@ -311,7 +332,9 @@ async function loadManifest(manifestPath) {
     }
     return parsed;
   } catch (error) {
-    throw new Error(`Failed to parse manifest at '${manifestPath}': ${String(error)}`);
+    throw new Error(
+      `Failed to parse manifest at '${manifestPath}': ${String(error)}`
+    );
   }
 }
 async function assertExists(target, message) {
@@ -327,7 +350,10 @@ var program = new import_commander.Command();
 program.name("mark-down").description(`${brand} CLI for building snippet manifests`).version("1.2.1");
 program.command("build").argument("[sourceDir]", "directory containing snippets", "content/snippets").option("-o, --output <path>", "where to write snippets-index.json").action(async (sourceDir, options) => {
   try {
-    const result = await buildManifestFile({ sourceDir, outputPath: options.output });
+    const result = await buildManifestFile({
+      sourceDir,
+      outputPath: options.output
+    });
     logEvent("info", "manifest.written", {
       outputPath: result.outputPath,
       snippetCount: result.manifest.length
@@ -343,17 +369,26 @@ program.command("watch").argument("[sourceDir]", "directory containing snippets"
     handleError(error);
   }
 });
-program.command("compile-page").argument("<inputHtml>", "HTML file containing data-snippet placeholders").option("--manifest <path>", "path to snippets-index.json").option("--outDir <path>", "output directory for compiled HTML", "dist").option("--inPlace", "overwrite the input HTML file instead of writing to outDir").action(async (inputHtml, options) => {
-  try {
-    await compilePage(inputHtml, {
-      manifest: options.manifest,
-      outDir: options.outDir,
-      inPlace: options.inPlace
-    });
-  } catch (error) {
-    handleError(error);
+program.command("compile-page").argument("<inputHtml>", "HTML file containing data-snippet placeholders").option("--manifest <path>", "path to snippets-index.json").option("--outDir <path>", "output directory for compiled HTML", "dist").option(
+  "--inPlace",
+  "overwrite the input HTML file instead of writing to outDir"
+).option(
+  "--sanitize [policy]",
+  "sanitize rendered HTML (default|strict|permissive)"
+).action(
+  async (inputHtml, options) => {
+    try {
+      await compilePage(inputHtml, {
+        manifest: options.manifest,
+        outDir: options.outDir,
+        inPlace: options.inPlace,
+        sanitize: resolveSanitizeOption(options.sanitize)
+      });
+    } catch (error) {
+      handleError(error);
+    }
   }
-});
+);
 program.parseAsync(process.argv).catch(handleError);
 function handleError(error) {
   const err = error;
@@ -370,4 +405,23 @@ function handleError(error) {
   });
   process.exit(1);
 }
+function resolveSanitizeOption(value) {
+  if (!value) {
+    return void 0;
+  }
+  if (value === true) {
+    return { policy: "default" };
+  }
+  const policy = value.trim();
+  if (!policy) {
+    return { policy: "default" };
+  }
+  if (!isSanitizePolicy(policy)) {
+    throw new Error(`Unknown sanitize policy '${policy}'.`);
+  }
+  return { policy };
+}
+function isSanitizePolicy(value) {
+  return value === "default" || value === "strict" || value === "permissive";
+}
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/manifest.ts","../src/errors.ts","../src/watch.ts","../src/logger.ts","../src/compile-page.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport { buildManifestFile } from \"./manifest.js\";\nimport { watch as watchSnippets } from \"./watch.js\";\nimport { brand, logEvent } from \"./logger.js\";\nimport { DuplicateSlugError } from \"./errors.js\";\nimport { compilePage } from \"./compile-page.js\";\n\nconst program = new Command();\nprogram\n  .name(\"mark-down\")\n  .description(`${brand} CLI for building snippet manifests`)\n  .version(\"1.2.1\");\n\nprogram\n  .command(\"build\")\n  .argument(\"[sourceDir]\", \"directory containing snippets\", \"content/snippets\")\n  .option(\"-o, --output <path>\", \"where to write snippets-index.json\")\n  .action(async (sourceDir: string, options: { output?: string }) => {\n    try {\n      const result = await buildManifestFile({ sourceDir, outputPath: options.output });\n      logEvent(\"info\", \"manifest.written\", {\n        outputPath: result.outputPath,\n        snippetCount: result.manifest.length\n      });\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram\n  .command(\"watch\")\n  .argument(\"[sourceDir]\", \"directory containing snippets\", \"content/snippets\")\n  .option(\"-o, --output <path>\", \"where to write snippets-index.json\")\n  .action(async (sourceDir: string, options: { output?: string }) => {\n    try {\n      await watchSnippets(sourceDir, options.output);\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram\n  .command(\"compile-page\")\n  .argument(\"<inputHtml>\", \"HTML file containing data-snippet placeholders\")\n  .option(\"--manifest <path>\", \"path to snippets-index.json\")\n  .option(\"--outDir <path>\", \"output directory for compiled HTML\", \"dist\")\n  .option(\"--inPlace\", \"overwrite the input HTML file instead of writing to outDir\")\n  .action(async (inputHtml: string, options: { manifest?: string; outDir?: string; inPlace?: boolean }) => {\n    try {\n      await compilePage(inputHtml, {\n        manifest: options.manifest,\n        outDir: options.outDir,\n        inPlace: options.inPlace\n      });\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram.parseAsync(process.argv).catch(handleError);\n\nfunction handleError(error: unknown) {\n  const err = error as Error;\n  if (err instanceof DuplicateSlugError) {\n    logEvent(\"error\", \"manifest.duplicate_slug\", {\n      message: err.message,\n      slugs: err.duplicates\n    });\n    process.exit(2);\n  }\n  logEvent(\"error\", \"cli.error\", {\n    message: err.message,\n    stack: err.stack\n  });\n  process.exit(1);\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport fg from \"fast-glob\";\nimport matter from \"gray-matter\";\nimport YAML from \"yaml\";\nimport { normalizeSlug, type SnippetMeta } from \"@mzebley/mark-down\";\nimport { DuplicateSlugError } from \"./errors.js\";\n\nconst MATTER_OPTIONS = {\n  engines: {\n    yaml: (source: string) => YAML.parse(source) ?? {}\n  }\n};\n\nexport interface BuildOptions {\n  sourceDir: string;\n  outputPath?: string;\n}\n\nexport interface BuildResult {\n  manifest: SnippetMeta[];\n  outputPath: string;\n}\n\nexport async function buildManifestFile(options: BuildOptions): Promise<BuildResult> {\n  const manifest = await buildManifest(options.sourceDir);\n  const target = options.outputPath ?? path.join(options.sourceDir, \"snippets-index.json\");\n  await fs.writeFile(target, JSON.stringify(manifest, null, 2));\n  return { manifest, outputPath: target };\n}\n\nexport async function buildManifest(sourceDir: string): Promise<SnippetMeta[]> {\n  const cwd = path.resolve(sourceDir);\n  const files = await fg([\"**/*.md\"], { cwd, absolute: true });\n  const manifest: SnippetMeta[] = [];\n\n  for (const absolutePath of files) {\n    const relativePath = path.relative(cwd, absolutePath);\n    const normalizedPath = toPosix(relativePath);\n    const content = await fs.readFile(absolutePath, \"utf8\");\n    const parsed = matter(content, MATTER_OPTIONS);\n    const snippet = createSnippet(normalizedPath, parsed.data ?? {});\n    if (snippet.draft) {\n      continue;\n    }\n    manifest.push(snippet);\n  }\n\n  ensureUniqueSlugs(manifest);\n\n  manifest.sort((a, b) => {\n    const orderA = typeof a.order === \"number\" ? a.order : Number.POSITIVE_INFINITY;\n    const orderB = typeof b.order === \"number\" ? b.order : Number.POSITIVE_INFINITY;\n    if (orderA !== orderB) {\n      return orderA - orderB;\n    }\n    const titleA = a.title?.toLowerCase() ?? \"\";\n    const titleB = b.title?.toLowerCase() ?? \"\";\n    return titleA.localeCompare(titleB);\n  });\n\n  return manifest;\n}\n\nexport function createSnippet(relativePath: string, frontMatter: Record<string, unknown>): SnippetMeta {\n  const group = deriveGroup(relativePath);\n  const slugSource = typeof frontMatter.slug === \"string\" && frontMatter.slug.trim().length\n    ? frontMatter.slug\n    : relativePath.replace(/\\.md$/i, \"\");\n  const slug = normalizeSlug(slugSource);\n\n  const { title, order, type, tags, draft } = normalizeKnownFields(frontMatter);\n  const extra = collectExtra(frontMatter);\n\n  return {\n    slug,\n    title,\n    order,\n    type,\n    tags,\n    draft,\n    path: relativePath,\n    group,\n    extra\n  };\n}\n\nfunction normalizeKnownFields(data: Record<string, unknown>) {\n  return {\n    title: typeof data.title === \"string\" ? data.title : undefined,\n    order: typeof data.order === \"number\"\n      ? data.order\n      : data.order === null\n        ? null\n        : undefined,\n    type: typeof data.type === \"string\" ? data.type : undefined,\n    tags: normalizeTags(data.tags),\n    draft: data.draft === true ? true : undefined\n  };\n}\n\nfunction collectExtra(data: Record<string, unknown>): Record<string, unknown> | undefined {\n  const extra: Record<string, unknown> = {};\n  const reserved = new Set([\"slug\", \"title\", \"order\", \"type\", \"tags\", \"draft\"]);\n  for (const [key, value] of Object.entries(data)) {\n    if (reserved.has(key)) {\n      continue;\n    }\n    extra[key] = value;\n  }\n  return Object.keys(extra).length ? extra : undefined;\n}\n\nfunction normalizeTags(value: unknown): string[] | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (Array.isArray(value)) {\n    return value.map((entry) => String(entry));\n  }\n  if (typeof value === \"string\") {\n    return value\n      .split(\",\")\n      .map((entry) => entry.trim())\n      .filter(Boolean);\n  }\n  return undefined;\n}\n\nfunction deriveGroup(relativePath: string): string {\n  const dirname = toPosix(path.dirname(relativePath));\n  if (dirname === \".\" || !dirname.length) {\n    return \"root\";\n  }\n  return dirname;\n}\n\nfunction toPosix(value: string): string {\n  return value.split(path.sep).join(\"/\");\n}\n\nfunction ensureUniqueSlugs(manifest: SnippetMeta[]) {\n  const seen = new Map<string, string>();\n  const duplicates = new Set<string>();\n  for (const snippet of manifest) {\n    if (seen.has(snippet.slug)) {\n      duplicates.add(snippet.slug);\n    } else {\n      seen.set(snippet.slug, snippet.path);\n    }\n  }\n  if (duplicates.size) {\n    throw new DuplicateSlugError([...duplicates.values()]);\n  }\n}\n","export class DuplicateSlugError extends Error {\n  readonly duplicates: string[];\n\n  constructor(duplicates: string[]) {\n    super(`Duplicate slugs detected: ${duplicates.join(\", \")}`);\n    this.name = \"DuplicateSlugError\";\n    this.duplicates = duplicates;\n  }\n}\n","import path from \"node:path\";\nimport chokidar from \"chokidar\";\nimport { buildManifestFile, type BuildResult } from \"./manifest.js\";\nimport { logEvent } from \"./logger.js\";\n\nexport async function watch(sourceDir: string, outputPath?: string) {\n  const cwd = path.resolve(sourceDir);\n  logEvent(\"info\", \"watch.start\", {\n    directory: cwd,\n    outputPath: outputPath ?? path.join(cwd, \"snippets-index.json\")\n  });\n  await rebuild(cwd, outputPath);\n\n  const watcher = chokidar.watch([\"**/*.md\"], {\n    cwd,\n    ignoreInitial: true,\n    awaitWriteFinish: {\n      stabilityThreshold: 200,\n      pollInterval: 50\n    }\n  });\n\n  const schedule = debounce(async () => {\n    await rebuild(cwd, outputPath);\n  }, 150);\n\n  watcher.on(\"all\", (event, filePath) => {\n    logEvent(\"info\", \"watch.change\", { event, file: filePath });\n    schedule();\n  });\n}\n\nasync function rebuild(sourceDir: string, outputPath?: string): Promise<BuildResult | void> {\n  try {\n    const result = await buildManifestFile({ sourceDir, outputPath });\n    logEvent(\"info\", \"manifest.updated\", {\n      outputPath: result.outputPath,\n      snippetCount: result.manifest.length\n    });\n    return result;\n  } catch (error) {\n    const err = error as Error;\n    logEvent(\"error\", \"manifest.update_failed\", {\n      message: err.message,\n      stack: err.stack\n    });\n  }\n}\n\nfunction debounce<T extends (...args: unknown[]) => Promise<unknown> | void>(\n  fn: T,\n  delay: number\n) {\n  let timer: NodeJS.Timeout | null = null;\n  return (...args: Parameters<T>) => {\n    if (timer) {\n      clearTimeout(timer);\n    }\n    timer = setTimeout(() => {\n      timer = null;\n      void fn(...args);\n    }, delay);\n  };\n}\n","export const brand = \"mark↓\";\n\nexport type LogLevel = \"info\" | \"warn\" | \"error\";\n\nexport interface LogFields {\n  message?: string;\n  [key: string]: unknown;\n}\n\nexport function logEvent(level: LogLevel, event: string, fields: LogFields = {}) {\n  const entry = {\n    brand,\n    level,\n    event,\n    timestamp: new Date().toISOString(),\n    ...fields\n  };\n  const output = `${JSON.stringify(entry)}\\n`;\n  const stream = level === \"error\" ? process.stderr : process.stdout;\n  stream.write(output);\n}\n\nexport function log(message: string, fields?: LogFields) {\n  if (fields) {\n    logEvent(\"info\", message, fields);\n    return;\n  }\n  logEvent(\"info\", \"message\", { message });\n}\n\nexport function logError(message: string, fields?: LogFields) {\n  if (fields) {\n    logEvent(\"error\", message, fields);\n    return;\n  }\n  logEvent(\"error\", \"message\", { message });\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { load as loadHtml } from \"cheerio\";\nimport { parseFrontMatter, renderMarkdown, type SnippetMeta } from \"@mzebley/mark-down\";\nimport { logEvent } from \"./logger.js\";\n\nexport interface CompilePageOptions {\n  manifest?: string;\n  outDir?: string;\n  inPlace?: boolean;\n}\n\nconst DEFAULT_OUT_DIR = \"dist\";\n\nexport async function compilePage(inputHtml: string, options: CompilePageOptions = {}): Promise<string> {\n  const sourcePath = path.resolve(inputHtml);\n  await assertExists(sourcePath, `Input HTML file not found at '${inputHtml}'.`);\n\n  const manifestPath = await resolveManifestPath(sourcePath, options.manifest);\n  const manifestDir = path.dirname(manifestPath);\n  const manifest = await loadManifest(manifestPath);\n\n  const rawHtml = await fs.readFile(sourcePath, \"utf8\");\n  const doctypeMatch = rawHtml.match(/^(<!doctype[^>]*>\\s*)/i);\n  const doctype = doctypeMatch?.[1] ?? \"\";\n  const dom = loadHtml(rawHtml, { decodeEntities: false });\n\n  const targets = dom(\"[data-snippet]\").toArray();\n  for (const node of targets) {\n    const element = dom(node);\n    const slug = element.attr(\"data-snippet\");\n    if (!slug) {\n      continue;\n    }\n    const entry = manifest.find((item) => item.slug === slug);\n    if (!entry) {\n      console.warn(`mark↓: no snippet found for \"${slug}\"`);\n      continue;\n    }\n\n    const snippetPath = path.resolve(manifestDir, entry.path);\n    let raw: string;\n    try {\n      raw = await fs.readFile(snippetPath, \"utf8\");\n    } catch (error) {\n      console.warn(`mark↓: failed to read snippet at '${entry.path}'`, error);\n      continue;\n    }\n\n    let body = raw;\n    let frontMatterSlug: string | undefined;\n    try {\n      const frontMatter = parseFrontMatter(raw);\n      body = frontMatter.content;\n      frontMatterSlug = frontMatter.slug;\n    } catch (error) {\n      console.warn(`mark↓: failed to parse front matter for '${entry.path}'`, error);\n    }\n\n    const html = renderMarkdown(body);\n    element.html(html);\n\n    if (!element.attr(\"id\")) {\n      element.attr(\"id\", frontMatterSlug ?? `snippet-${slug}`);\n    }\n  }\n\n  const outputDir = options.inPlace ? path.dirname(sourcePath) : path.resolve(options.outDir ?? DEFAULT_OUT_DIR);\n  if (!options.inPlace) {\n    await fs.mkdir(outputDir, { recursive: true });\n  }\n  const outputPath = options.inPlace\n    ? sourcePath\n    : path.join(outputDir, path.basename(sourcePath));\n\n  const outputHtml = `${doctype}${dom.html() ?? \"\"}`;\n  await fs.writeFile(outputPath, outputHtml);\n\n  logEvent(\"info\", \"compile_page.written\", { outputPath });\n  return outputPath;\n}\n\nasync function resolveManifestPath(inputHtml: string, manifestFlag?: string): Promise<string> {\n  const manifestPath = manifestFlag\n    ? path.resolve(manifestFlag)\n    : path.join(path.dirname(path.resolve(inputHtml)), \"snippets-index.json\");\n  await assertExists(manifestPath, `Manifest file not found at '${manifestPath}'.`);\n  return manifestPath;\n}\n\nasync function loadManifest(manifestPath: string): Promise<SnippetMeta[]> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(manifestPath, \"utf8\");\n  } catch (error) {\n    throw new Error(`Failed to read manifest at '${manifestPath}': ${String(error)}`);\n  }\n\n  try {\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) {\n      throw new Error(\"Manifest must be a JSON array.\");\n    }\n    return parsed as SnippetMeta[];\n  } catch (error) {\n    throw new Error(`Failed to parse manifest at '${manifestPath}': ${String(error)}`);\n  }\n}\n\nasync function assertExists(target: string, message: string) {\n  try {\n    await fs.access(target);\n  } catch {\n    throw new Error(message);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,uBAAwB;;;ACDxB,sBAAe;AACf,uBAAiB;AACjB,uBAAe;AACf,yBAAmB;AACnB,kBAAiB;AACjB,uBAAgD;;;ACLzC,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAG5C,YAAY,YAAsB;AAChC,UAAM,6BAA6B,WAAW,KAAK,IAAI,CAAC,EAAE;AAC1D,SAAK,OAAO;AACZ,SAAK,aAAa;AAAA,EACpB;AACF;;;ADAA,IAAM,iBAAiB;AAAA,EACrB,SAAS;AAAA,IACP,MAAM,CAAC,WAAmB,YAAAA,QAAK,MAAM,MAAM,KAAK,CAAC;AAAA,EACnD;AACF;AAYA,eAAsB,kBAAkB,SAA6C;AACnF,QAAM,WAAW,MAAM,cAAc,QAAQ,SAAS;AACtD,QAAM,SAAS,QAAQ,cAAc,iBAAAC,QAAK,KAAK,QAAQ,WAAW,qBAAqB;AACvF,QAAM,gBAAAC,QAAG,UAAU,QAAQ,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAC5D,SAAO,EAAE,UAAU,YAAY,OAAO;AACxC;AAEA,eAAsB,cAAc,WAA2C;AAC7E,QAAM,MAAM,iBAAAD,QAAK,QAAQ,SAAS;AAClC,QAAM,QAAQ,UAAM,iBAAAE,SAAG,CAAC,SAAS,GAAG,EAAE,KAAK,UAAU,KAAK,CAAC;AAC3D,QAAM,WAA0B,CAAC;AAEjC,aAAW,gBAAgB,OAAO;AAChC,UAAM,eAAe,iBAAAF,QAAK,SAAS,KAAK,YAAY;AACpD,UAAM,iBAAiB,QAAQ,YAAY;AAC3C,UAAM,UAAU,MAAM,gBAAAC,QAAG,SAAS,cAAc,MAAM;AACtD,UAAM,aAAS,mBAAAE,SAAO,SAAS,cAAc;AAC7C,UAAM,UAAU,cAAc,gBAAgB,OAAO,QAAQ,CAAC,CAAC;AAC/D,QAAI,QAAQ,OAAO;AACjB;AAAA,IACF;AACA,aAAS,KAAK,OAAO;AAAA,EACvB;AAEA,oBAAkB,QAAQ;AAE1B,WAAS,KAAK,CAAC,GAAG,MAAM;AACtB,UAAM,SAAS,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ,OAAO;AAC9D,UAAM,SAAS,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ,OAAO;AAC9D,QAAI,WAAW,QAAQ;AACrB,aAAO,SAAS;AAAA,IAClB;AACA,UAAM,SAAS,EAAE,OAAO,YAAY,KAAK;AACzC,UAAM,SAAS,EAAE,OAAO,YAAY,KAAK;AACzC,WAAO,OAAO,cAAc,MAAM;AAAA,EACpC,CAAC;AAED,SAAO;AACT;AAEO,SAAS,cAAc,cAAsB,aAAmD;AACrG,QAAM,QAAQ,YAAY,YAAY;AACtC,QAAM,aAAa,OAAO,YAAY,SAAS,YAAY,YAAY,KAAK,KAAK,EAAE,SAC/E,YAAY,OACZ,aAAa,QAAQ,UAAU,EAAE;AACrC,QAAM,WAAO,gCAAc,UAAU;AAErC,QAAM,EAAE,OAAO,OAAO,MAAM,MAAM,MAAM,IAAI,qBAAqB,WAAW;AAC5E,QAAM,QAAQ,aAAa,WAAW;AAEtC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,qBAAqB,MAA+B;AAC3D,SAAO;AAAA,IACL,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;AAAA,IACrD,OAAO,OAAO,KAAK,UAAU,WACzB,KAAK,QACL,KAAK,UAAU,OACb,OACA;AAAA,IACN,MAAM,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO;AAAA,IAClD,MAAM,cAAc,KAAK,IAAI;AAAA,IAC7B,OAAO,KAAK,UAAU,OAAO,OAAO;AAAA,EACtC;AACF;AAEA,SAAS,aAAa,MAAoE;AACxF,QAAM,QAAiC,CAAC;AACxC,QAAM,WAAW,oBAAI,IAAI,CAAC,QAAQ,SAAS,SAAS,QAAQ,QAAQ,OAAO,CAAC;AAC5E,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,QAAI,SAAS,IAAI,GAAG,GAAG;AACrB;AAAA,IACF;AACA,UAAM,GAAG,IAAI;AAAA,EACf;AACA,SAAO,OAAO,KAAK,KAAK,EAAE,SAAS,QAAQ;AAC7C;AAEA,SAAS,cAAc,OAAsC;AAC3D,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,IAAI,CAAC,UAAU,OAAO,KAAK,CAAC;AAAA,EAC3C;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,MACJ,MAAM,GAAG,EACT,IAAI,CAAC,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,OAAO;AAAA,EACnB;AACA,SAAO;AACT;AAEA,SAAS,YAAY,cAA8B;AACjD,QAAM,UAAU,QAAQ,iBAAAH,QAAK,QAAQ,YAAY,CAAC;AAClD,MAAI,YAAY,OAAO,CAAC,QAAQ,QAAQ;AACtC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,QAAQ,OAAuB;AACtC,SAAO,MAAM,MAAM,iBAAAA,QAAK,GAAG,EAAE,KAAK,GAAG;AACvC;AAEA,SAAS,kBAAkB,UAAyB;AAClD,QAAM,OAAO,oBAAI,IAAoB;AACrC,QAAM,aAAa,oBAAI,IAAY;AACnC,aAAW,WAAW,UAAU;AAC9B,QAAI,KAAK,IAAI,QAAQ,IAAI,GAAG;AAC1B,iBAAW,IAAI,QAAQ,IAAI;AAAA,IAC7B,OAAO;AACL,WAAK,IAAI,QAAQ,MAAM,QAAQ,IAAI;AAAA,IACrC;AAAA,EACF;AACA,MAAI,WAAW,MAAM;AACnB,UAAM,IAAI,mBAAmB,CAAC,GAAG,WAAW,OAAO,CAAC,CAAC;AAAA,EACvD;AACF;;;AE1JA,IAAAI,oBAAiB;AACjB,sBAAqB;;;ACDd,IAAM,QAAQ;AASd,SAAS,SAAS,OAAiB,OAAe,SAAoB,CAAC,GAAG;AAC/E,QAAM,QAAQ;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC,GAAG;AAAA,EACL;AACA,QAAM,SAAS,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA;AACvC,QAAM,SAAS,UAAU,UAAU,QAAQ,SAAS,QAAQ;AAC5D,SAAO,MAAM,MAAM;AACrB;;;ADfA,eAAsB,MAAM,WAAmB,YAAqB;AAClE,QAAM,MAAM,kBAAAC,QAAK,QAAQ,SAAS;AAClC,WAAS,QAAQ,eAAe;AAAA,IAC9B,WAAW;AAAA,IACX,YAAY,cAAc,kBAAAA,QAAK,KAAK,KAAK,qBAAqB;AAAA,EAChE,CAAC;AACD,QAAM,QAAQ,KAAK,UAAU;AAE7B,QAAM,UAAU,gBAAAC,QAAS,MAAM,CAAC,SAAS,GAAG;AAAA,IAC1C;AAAA,IACA,eAAe;AAAA,IACf,kBAAkB;AAAA,MAChB,oBAAoB;AAAA,MACpB,cAAc;AAAA,IAChB;AAAA,EACF,CAAC;AAED,QAAM,WAAW,SAAS,YAAY;AACpC,UAAM,QAAQ,KAAK,UAAU;AAAA,EAC/B,GAAG,GAAG;AAEN,UAAQ,GAAG,OAAO,CAAC,OAAO,aAAa;AACrC,aAAS,QAAQ,gBAAgB,EAAE,OAAO,MAAM,SAAS,CAAC;AAC1D,aAAS;AAAA,EACX,CAAC;AACH;AAEA,eAAe,QAAQ,WAAmB,YAAkD;AAC1F,MAAI;AACF,UAAM,SAAS,MAAM,kBAAkB,EAAE,WAAW,WAAW,CAAC;AAChE,aAAS,QAAQ,oBAAoB;AAAA,MACnC,YAAY,OAAO;AAAA,MACnB,cAAc,OAAO,SAAS;AAAA,IAChC,CAAC;AACD,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,MAAM;AACZ,aAAS,SAAS,0BAA0B;AAAA,MAC1C,SAAS,IAAI;AAAA,MACb,OAAO,IAAI;AAAA,IACb,CAAC;AAAA,EACH;AACF;AAEA,SAAS,SACP,IACA,OACA;AACA,MAAI,QAA+B;AACnC,SAAO,IAAI,SAAwB;AACjC,QAAI,OAAO;AACT,mBAAa,KAAK;AAAA,IACpB;AACA,YAAQ,WAAW,MAAM;AACvB,cAAQ;AACR,WAAK,GAAG,GAAG,IAAI;AAAA,IACjB,GAAG,KAAK;AAAA,EACV;AACF;;;AE/DA,IAAAC,mBAAe;AACf,IAAAC,oBAAiB;AACjB,qBAAiC;AACjC,IAAAC,oBAAmE;AASnE,IAAM,kBAAkB;AAExB,eAAsB,YAAY,WAAmB,UAA8B,CAAC,GAAoB;AACtG,QAAM,aAAa,kBAAAC,QAAK,QAAQ,SAAS;AACzC,QAAM,aAAa,YAAY,iCAAiC,SAAS,IAAI;AAE7E,QAAM,eAAe,MAAM,oBAAoB,YAAY,QAAQ,QAAQ;AAC3E,QAAM,cAAc,kBAAAA,QAAK,QAAQ,YAAY;AAC7C,QAAM,WAAW,MAAM,aAAa,YAAY;AAEhD,QAAM,UAAU,MAAM,iBAAAC,QAAG,SAAS,YAAY,MAAM;AACpD,QAAM,eAAe,QAAQ,MAAM,wBAAwB;AAC3D,QAAM,UAAU,eAAe,CAAC,KAAK;AACrC,QAAM,UAAM,eAAAC,MAAS,SAAS,EAAE,gBAAgB,MAAM,CAAC;AAEvD,QAAM,UAAU,IAAI,gBAAgB,EAAE,QAAQ;AAC9C,aAAW,QAAQ,SAAS;AAC1B,UAAM,UAAU,IAAI,IAAI;AACxB,UAAM,OAAO,QAAQ,KAAK,cAAc;AACxC,QAAI,CAAC,MAAM;AACT;AAAA,IACF;AACA,UAAM,QAAQ,SAAS,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI;AACxD,QAAI,CAAC,OAAO;AACV,cAAQ,KAAK,qCAAgC,IAAI,GAAG;AACpD;AAAA,IACF;AAEA,UAAM,cAAc,kBAAAF,QAAK,QAAQ,aAAa,MAAM,IAAI;AACxD,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,iBAAAC,QAAG,SAAS,aAAa,MAAM;AAAA,IAC7C,SAAS,OAAO;AACd,cAAQ,KAAK,0CAAqC,MAAM,IAAI,KAAK,KAAK;AACtE;AAAA,IACF;AAEA,QAAI,OAAO;AACX,QAAI;AACJ,QAAI;AACF,YAAM,kBAAc,oCAAiB,GAAG;AACxC,aAAO,YAAY;AACnB,wBAAkB,YAAY;AAAA,IAChC,SAAS,OAAO;AACd,cAAQ,KAAK,iDAA4C,MAAM,IAAI,KAAK,KAAK;AAAA,IAC/E;AAEA,UAAM,WAAO,kCAAe,IAAI;AAChC,YAAQ,KAAK,IAAI;AAEjB,QAAI,CAAC,QAAQ,KAAK,IAAI,GAAG;AACvB,cAAQ,KAAK,MAAM,mBAAmB,WAAW,IAAI,EAAE;AAAA,IACzD;AAAA,EACF;AAEA,QAAM,YAAY,QAAQ,UAAU,kBAAAD,QAAK,QAAQ,UAAU,IAAI,kBAAAA,QAAK,QAAQ,QAAQ,UAAU,eAAe;AAC7G,MAAI,CAAC,QAAQ,SAAS;AACpB,UAAM,iBAAAC,QAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAAA,EAC/C;AACA,QAAM,aAAa,QAAQ,UACvB,aACA,kBAAAD,QAAK,KAAK,WAAW,kBAAAA,QAAK,SAAS,UAAU,CAAC;AAElD,QAAM,aAAa,GAAG,OAAO,GAAG,IAAI,KAAK,KAAK,EAAE;AAChD,QAAM,iBAAAC,QAAG,UAAU,YAAY,UAAU;AAEzC,WAAS,QAAQ,wBAAwB,EAAE,WAAW,CAAC;AACvD,SAAO;AACT;AAEA,eAAe,oBAAoB,WAAmB,cAAwC;AAC5F,QAAM,eAAe,eACjB,kBAAAD,QAAK,QAAQ,YAAY,IACzB,kBAAAA,QAAK,KAAK,kBAAAA,QAAK,QAAQ,kBAAAA,QAAK,QAAQ,SAAS,CAAC,GAAG,qBAAqB;AAC1E,QAAM,aAAa,cAAc,+BAA+B,YAAY,IAAI;AAChF,SAAO;AACT;AAEA,eAAe,aAAa,cAA8C;AACxE,MAAI;AACJ,MAAI;AACF,UAAM,MAAM,iBAAAC,QAAG,SAAS,cAAc,MAAM;AAAA,EAC9C,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,+BAA+B,YAAY,MAAM,OAAO,KAAK,CAAC,EAAE;AAAA,EAClF;AAEA,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,QAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,gCAAgC,YAAY,MAAM,OAAO,KAAK,CAAC,EAAE;AAAA,EACnF;AACF;AAEA,eAAe,aAAa,QAAgB,SAAiB;AAC3D,MAAI;AACF,UAAM,iBAAAA,QAAG,OAAO,MAAM;AAAA,EACxB,QAAQ;AACN,UAAM,IAAI,MAAM,OAAO;AAAA,EACzB;AACF;;;AL3GA,IAAM,UAAU,IAAI,yBAAQ;AAC5B,QACG,KAAK,WAAW,EAChB,YAAY,GAAG,KAAK,qCAAqC,EACzD,QAAQ,OAAO;AAElB,QACG,QAAQ,OAAO,EACf,SAAS,eAAe,iCAAiC,kBAAkB,EAC3E,OAAO,uBAAuB,oCAAoC,EAClE,OAAO,OAAO,WAAmB,YAAiC;AACjE,MAAI;AACF,UAAM,SAAS,MAAM,kBAAkB,EAAE,WAAW,YAAY,QAAQ,OAAO,CAAC;AAChF,aAAS,QAAQ,oBAAoB;AAAA,MACnC,YAAY,OAAO;AAAA,MACnB,cAAc,OAAO,SAAS;AAAA,IAChC,CAAC;AAAA,EACH,SAAS,OAAO;AACd,gBAAY,KAAK;AAAA,EACnB;AACF,CAAC;AAEH,QACG,QAAQ,OAAO,EACf,SAAS,eAAe,iCAAiC,kBAAkB,EAC3E,OAAO,uBAAuB,oCAAoC,EAClE,OAAO,OAAO,WAAmB,YAAiC;AACjE,MAAI;AACF,UAAM,MAAc,WAAW,QAAQ,MAAM;AAAA,EAC/C,SAAS,OAAO;AACd,gBAAY,KAAK;AAAA,EACnB;AACF,CAAC;AAEH,QACG,QAAQ,cAAc,EACtB,SAAS,eAAe,gDAAgD,EACxE,OAAO,qBAAqB,6BAA6B,EACzD,OAAO,mBAAmB,sCAAsC,MAAM,EACtE,OAAO,aAAa,4DAA4D,EAChF,OAAO,OAAO,WAAmB,YAAuE;AACvG,MAAI;AACF,UAAM,YAAY,WAAW;AAAA,MAC3B,UAAU,QAAQ;AAAA,MAClB,QAAQ,QAAQ;AAAA,MAChB,SAAS,QAAQ;AAAA,IACnB,CAAC;AAAA,EACH,SAAS,OAAO;AACd,gBAAY,KAAK;AAAA,EACnB;AACF,CAAC;AAEH,QAAQ,WAAW,QAAQ,IAAI,EAAE,MAAM,WAAW;AAElD,SAAS,YAAY,OAAgB;AACnC,QAAM,MAAM;AACZ,MAAI,eAAe,oBAAoB;AACrC,aAAS,SAAS,2BAA2B;AAAA,MAC3C,SAAS,IAAI;AAAA,MACb,OAAO,IAAI;AAAA,IACb,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,WAAS,SAAS,aAAa;AAAA,IAC7B,SAAS,IAAI;AAAA,IACb,OAAO,IAAI;AAAA,EACb,CAAC;AACD,UAAQ,KAAK,CAAC;AAChB;","names":["YAML","path","fs","fg","matter","import_node_path","path","chokidar","import_promises","import_node_path","import_mark_down","path","fs","loadHtml"]}
+{"version":3,"sources":["../src/index.ts","../src/manifest.ts","../src/errors.ts","../src/watch.ts","../src/logger.ts","../src/compile-page.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport { buildManifestFile } from \"./manifest.js\";\nimport { watch as watchSnippets } from \"./watch.js\";\nimport { brand, logEvent } from \"./logger.js\";\nimport { DuplicateSlugError } from \"./errors.js\";\nimport { compilePage } from \"./compile-page.js\";\nimport type { SanitizeOptions, SanitizePolicy } from \"@mzebley/mark-down\";\n\nconst program = new Command();\nprogram\n  .name(\"mark-down\")\n  .description(`${brand} CLI for building snippet manifests`)\n  .version(\"1.2.1\");\n\nprogram\n  .command(\"build\")\n  .argument(\"[sourceDir]\", \"directory containing snippets\", \"content/snippets\")\n  .option(\"-o, --output <path>\", \"where to write snippets-index.json\")\n  .action(async (sourceDir: string, options: { output?: string }) => {\n    try {\n      const result = await buildManifestFile({\n        sourceDir,\n        outputPath: options.output,\n      });\n      logEvent(\"info\", \"manifest.written\", {\n        outputPath: result.outputPath,\n        snippetCount: result.manifest.length,\n      });\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram\n  .command(\"watch\")\n  .argument(\"[sourceDir]\", \"directory containing snippets\", \"content/snippets\")\n  .option(\"-o, --output <path>\", \"where to write snippets-index.json\")\n  .action(async (sourceDir: string, options: { output?: string }) => {\n    try {\n      await watchSnippets(sourceDir, options.output);\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram\n  .command(\"compile-page\")\n  .argument(\"<inputHtml>\", \"HTML file containing data-snippet placeholders\")\n  .option(\"--manifest <path>\", \"path to snippets-index.json\")\n  .option(\"--outDir <path>\", \"output directory for compiled HTML\", \"dist\")\n  .option(\n    \"--inPlace\",\n    \"overwrite the input HTML file instead of writing to outDir\",\n  )\n  .option(\n    \"--sanitize [policy]\",\n    \"sanitize rendered HTML (default|strict|permissive)\",\n  )\n  .action(\n    async (\n      inputHtml: string,\n      options: {\n        manifest?: string;\n        outDir?: string;\n        inPlace?: boolean;\n        sanitize?: string | boolean;\n      },\n    ) => {\n      try {\n        await compilePage(inputHtml, {\n          manifest: options.manifest,\n          outDir: options.outDir,\n          inPlace: options.inPlace,\n          sanitize: resolveSanitizeOption(options.sanitize),\n        });\n      } catch (error) {\n        handleError(error);\n      }\n    },\n  );\n\nprogram.parseAsync(process.argv).catch(handleError);\n\nfunction handleError(error: unknown) {\n  const err = error as Error;\n  if (err instanceof DuplicateSlugError) {\n    logEvent(\"error\", \"manifest.duplicate_slug\", {\n      message: err.message,\n      slugs: err.duplicates,\n    });\n    process.exit(2);\n  }\n  logEvent(\"error\", \"cli.error\", {\n    message: err.message,\n    stack: err.stack,\n  });\n  process.exit(1);\n}\n\nfunction resolveSanitizeOption(\n  value?: string | boolean,\n): SanitizeOptions | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (value === true) {\n    return { policy: \"default\" };\n  }\n  const policy = value.trim();\n  if (!policy) {\n    return { policy: \"default\" };\n  }\n  if (!isSanitizePolicy(policy)) {\n    throw new Error(`Unknown sanitize policy '${policy}'.`);\n  }\n  return { policy };\n}\n\nfunction isSanitizePolicy(value: string): value is SanitizePolicy {\n  return value === \"default\" || value === \"strict\" || value === \"permissive\";\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport fg from \"fast-glob\";\nimport matter from \"gray-matter\";\nimport YAML from \"yaml\";\nimport { normalizeSlug, type SnippetMeta } from \"@mzebley/mark-down\";\nimport { DuplicateSlugError } from \"./errors.js\";\n\nconst MATTER_OPTIONS = {\n  engines: {\n    yaml: (source: string) => YAML.parse(source) ?? {},\n  },\n};\n\nexport interface BuildOptions {\n  sourceDir: string;\n  outputPath?: string;\n}\n\nexport interface BuildResult {\n  manifest: SnippetMeta[];\n  outputPath: string;\n}\n\nexport async function buildManifestFile(\n  options: BuildOptions,\n): Promise<BuildResult> {\n  const manifest = await buildManifest(options.sourceDir);\n  const target =\n    options.outputPath ?? path.join(options.sourceDir, \"snippets-index.json\");\n  await fs.writeFile(target, JSON.stringify(manifest, null, 2));\n  return { manifest, outputPath: target };\n}\n\nexport async function buildManifest(sourceDir: string): Promise<SnippetMeta[]> {\n  const cwd = path.resolve(sourceDir);\n  const files = await fg([\"**/*.md\"], { cwd, absolute: true });\n  const manifest: SnippetMeta[] = [];\n\n  for (const absolutePath of files) {\n    const relativePath = path.relative(cwd, absolutePath);\n    const normalizedPath = toPosix(relativePath);\n    try {\n      const content = await fs.readFile(absolutePath, \"utf8\");\n      const parsed = matter(content, MATTER_OPTIONS);\n      const snippet = createSnippet(normalizedPath, parsed.data ?? {});\n      if (snippet.draft) {\n        continue;\n      }\n      manifest.push(snippet);\n    } catch (error) {\n      console.warn(\n        `mark↓: failed to load snippet at '${normalizedPath}'`,\n        error,\n      );\n    }\n  }\n\n  ensureUniqueSlugs(manifest);\n\n  manifest.sort((a, b) => {\n    const orderA =\n      typeof a.order === \"number\" ? a.order : Number.POSITIVE_INFINITY;\n    const orderB =\n      typeof b.order === \"number\" ? b.order : Number.POSITIVE_INFINITY;\n    if (orderA !== orderB) {\n      return orderA - orderB;\n    }\n    const titleA = a.title?.toLowerCase() ?? \"\";\n    const titleB = b.title?.toLowerCase() ?? \"\";\n    return titleA.localeCompare(titleB);\n  });\n\n  return manifest;\n}\n\nexport function createSnippet(\n  relativePath: string,\n  frontMatter: Record<string, unknown>,\n): SnippetMeta {\n  const group = deriveGroup(relativePath);\n  const slugSource =\n    typeof frontMatter.slug === \"string\" && frontMatter.slug.trim().length\n      ? frontMatter.slug\n      : relativePath.replace(/\\.md$/i, \"\");\n  const slug = normalizeSlug(slugSource);\n\n  const { title, order, type, tags, draft } = normalizeKnownFields(frontMatter);\n  const extra = collectExtra(frontMatter);\n\n  return {\n    slug,\n    title,\n    order,\n    type,\n    tags,\n    draft,\n    path: relativePath,\n    group,\n    extra,\n  };\n}\n\nfunction normalizeKnownFields(data: Record<string, unknown>) {\n  return {\n    title: typeof data.title === \"string\" ? data.title : undefined,\n    order:\n      typeof data.order === \"number\"\n        ? data.order\n        : data.order === null\n          ? null\n          : undefined,\n    type: typeof data.type === \"string\" ? data.type : undefined,\n    tags: normalizeTags(data.tags),\n    draft: data.draft === true ? true : undefined,\n  };\n}\n\nfunction collectExtra(\n  data: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n  const extra: Record<string, unknown> = {};\n  const reserved = new Set([\"slug\", \"title\", \"order\", \"type\", \"tags\", \"draft\"]);\n  for (const [key, value] of Object.entries(data)) {\n    if (reserved.has(key)) {\n      continue;\n    }\n    extra[key] = value;\n  }\n  return Object.keys(extra).length ? extra : undefined;\n}\n\nfunction normalizeTags(value: unknown): string[] | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (Array.isArray(value)) {\n    return value.map((entry) => String(entry));\n  }\n  if (typeof value === \"string\") {\n    return value\n      .split(\",\")\n      .map((entry) => entry.trim())\n      .filter(Boolean);\n  }\n  return undefined;\n}\n\nfunction deriveGroup(relativePath: string): string {\n  const dirname = toPosix(path.dirname(relativePath));\n  if (dirname === \".\" || !dirname.length) {\n    return \"root\";\n  }\n  return dirname;\n}\n\nfunction toPosix(value: string): string {\n  return value.split(path.sep).join(\"/\");\n}\n\nfunction ensureUniqueSlugs(manifest: SnippetMeta[]) {\n  const seen = new Map<string, string>();\n  const duplicates = new Set<string>();\n  for (const snippet of manifest) {\n    if (seen.has(snippet.slug)) {\n      duplicates.add(snippet.slug);\n    } else {\n      seen.set(snippet.slug, snippet.path);\n    }\n  }\n  if (duplicates.size) {\n    throw new DuplicateSlugError([...duplicates.values()]);\n  }\n}\n","export class DuplicateSlugError extends Error {\n  readonly duplicates: string[];\n\n  constructor(duplicates: string[]) {\n    super(`Duplicate slugs detected: ${duplicates.join(\", \")}`);\n    this.name = \"DuplicateSlugError\";\n    this.duplicates = duplicates;\n  }\n}\n","import path from \"node:path\";\nimport chokidar from \"chokidar\";\nimport { buildManifestFile, type BuildResult } from \"./manifest.js\";\nimport { logEvent } from \"./logger.js\";\n\nexport async function watch(sourceDir: string, outputPath?: string) {\n  const cwd = path.resolve(sourceDir);\n  logEvent(\"info\", \"watch.start\", {\n    directory: cwd,\n    outputPath: outputPath ?? path.join(cwd, \"snippets-index.json\"),\n  });\n  await rebuild(cwd, outputPath);\n\n  const watcher = chokidar.watch([\"**/*.md\"], {\n    cwd,\n    ignoreInitial: true,\n    awaitWriteFinish: {\n      stabilityThreshold: 200,\n      pollInterval: 50,\n    },\n  });\n\n  const schedule = debounce(async () => {\n    await rebuild(cwd, outputPath);\n  }, 150);\n\n  watcher.on(\"all\", (event, filePath) => {\n    logEvent(\"info\", \"watch.change\", { event, file: filePath });\n    schedule();\n  });\n}\n\nasync function rebuild(\n  sourceDir: string,\n  outputPath?: string,\n): Promise<BuildResult | void> {\n  try {\n    const result = await buildManifestFile({ sourceDir, outputPath });\n    logEvent(\"info\", \"manifest.updated\", {\n      outputPath: result.outputPath,\n      snippetCount: result.manifest.length,\n    });\n    return result;\n  } catch (error) {\n    const err = error as Error;\n    logEvent(\"error\", \"manifest.update_failed\", {\n      message: err.message,\n      stack: err.stack,\n    });\n  }\n}\n\nfunction debounce<T extends (...args: unknown[]) => Promise<unknown> | void>(\n  fn: T,\n  delay: number,\n) {\n  let timer: NodeJS.Timeout | null = null;\n  return (...args: Parameters<T>) => {\n    if (timer) {\n      clearTimeout(timer);\n    }\n    timer = setTimeout(() => {\n      timer = null;\n      void fn(...args);\n    }, delay);\n  };\n}\n","export const brand = \"mark↓\";\n\nexport type LogLevel = \"info\" | \"warn\" | \"error\";\n\nexport interface LogFields {\n  message?: string;\n  [key: string]: unknown;\n}\n\nexport function logEvent(\n  level: LogLevel,\n  event: string,\n  fields: LogFields = {},\n) {\n  const entry = {\n    brand,\n    level,\n    event,\n    timestamp: new Date().toISOString(),\n    ...fields,\n  };\n  const output = `${JSON.stringify(entry)}\\n`;\n  const stream = level === \"error\" ? process.stderr : process.stdout;\n  stream.write(output);\n}\n\nexport function log(message: string, fields?: LogFields) {\n  if (fields) {\n    logEvent(\"info\", message, fields);\n    return;\n  }\n  logEvent(\"info\", \"message\", { message });\n}\n\nexport function logError(message: string, fields?: LogFields) {\n  if (fields) {\n    logEvent(\"error\", message, fields);\n    return;\n  }\n  logEvent(\"error\", \"message\", { message });\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { load as loadHtml } from \"cheerio\";\nimport {\n  parseFrontMatter,\n  renderMarkdown,\n  sanitizeMarkup,\n  type SanitizeOptions,\n  type SnippetMeta,\n} from \"@mzebley/mark-down\";\nimport { logEvent } from \"./logger.js\";\n\nexport interface CompilePageOptions {\n  manifest?: string;\n  outDir?: string;\n  inPlace?: boolean;\n  sanitize?: SanitizeOptions;\n}\n\nconst DEFAULT_OUT_DIR = \"dist\";\n\nexport async function compilePage(\n  inputHtml: string,\n  options: CompilePageOptions = {},\n): Promise<string> {\n  const sourcePath = path.resolve(inputHtml);\n  await assertExists(\n    sourcePath,\n    `Input HTML file not found at '${inputHtml}'.`,\n  );\n\n  const manifestPath = await resolveManifestPath(sourcePath, options.manifest);\n  const manifestDir = path.dirname(manifestPath);\n  const manifest = await loadManifest(manifestPath);\n\n  const rawHtml = await fs.readFile(sourcePath, \"utf8\");\n  const doctypeMatch = rawHtml.match(/^(<!doctype[^>]*>\\s*)/i);\n  const doctype = doctypeMatch?.[1] ?? \"\";\n  const dom = loadHtml(rawHtml, { decodeEntities: false });\n\n  const targets = dom(\"[data-snippet]\").toArray();\n  for (const node of targets) {\n    const element = dom(node);\n    const slug = element.attr(\"data-snippet\");\n    if (!slug) {\n      continue;\n    }\n    const entry = manifest.find((item) => item.slug === slug);\n    if (!entry) {\n      console.warn(`mark↓: no snippet found for \"${slug}\"`);\n      continue;\n    }\n\n    const snippetPath = path.resolve(manifestDir, entry.path);\n    let raw: string;\n    try {\n      raw = await fs.readFile(snippetPath, \"utf8\");\n    } catch (error) {\n      console.warn(`mark↓: failed to read snippet at '${entry.path}'`, error);\n      continue;\n    }\n\n    let body = raw;\n    let frontMatterSlug: string | undefined;\n    try {\n      const frontMatter = parseFrontMatter(raw);\n      body = frontMatter.content;\n      frontMatterSlug = frontMatter.slug;\n    } catch (error) {\n      console.warn(\n        `mark↓: failed to parse front matter for '${entry.path}'`,\n        error,\n      );\n    }\n\n    let html = renderMarkdown(body);\n    if (options.sanitize) {\n      html = sanitizeMarkup(html, options.sanitize);\n    }\n    element.html(html);\n\n    if (!element.attr(\"id\")) {\n      element.attr(\"id\", frontMatterSlug ?? `snippet-${slug}`);\n    }\n  }\n\n  const outputDir = options.inPlace\n    ? path.dirname(sourcePath)\n    : path.resolve(options.outDir ?? DEFAULT_OUT_DIR);\n  if (!options.inPlace) {\n    await fs.mkdir(outputDir, { recursive: true });\n  }\n  const outputPath = options.inPlace\n    ? sourcePath\n    : path.join(outputDir, path.basename(sourcePath));\n\n  const outputHtml = `${doctype}${dom.html() ?? \"\"}`;\n  await fs.writeFile(outputPath, outputHtml);\n\n  logEvent(\"info\", \"compile_page.written\", { outputPath });\n  return outputPath;\n}\n\nasync function resolveManifestPath(\n  inputHtml: string,\n  manifestFlag?: string,\n): Promise<string> {\n  const manifestPath = manifestFlag\n    ? path.resolve(manifestFlag)\n    : path.join(path.dirname(path.resolve(inputHtml)), \"snippets-index.json\");\n  await assertExists(\n    manifestPath,\n    `Manifest file not found at '${manifestPath}'.`,\n  );\n  return manifestPath;\n}\n\nasync function loadManifest(manifestPath: string): Promise<SnippetMeta[]> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(manifestPath, \"utf8\");\n  } catch (error) {\n    throw new Error(\n      `Failed to read manifest at '${manifestPath}': ${String(error)}`,\n    );\n  }\n\n  try {\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) {\n      throw new Error(\"Manifest must be a JSON array.\");\n    }\n    return parsed as SnippetMeta[];\n  } catch (error) {\n    throw new Error(\n      `Failed to parse manifest at '${manifestPath}': ${String(error)}`,\n    );\n  }\n}\n\nasync function assertExists(target: string, message: string) {\n  try {\n    await fs.access(target);\n  } catch {\n    throw new Error(message);\n  }\n}\n"],"mappings":"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","names":["YAML","path","fs","fg","matter","import_node_path","path","chokidar","import_promises","import_node_path","import_mark_down","path","fs","loadHtml"]}

package/dist/index.mjs

@@ -39,13 +39,20 @@ async function buildManifest(sourceDir) {
   for (const absolutePath of files) {
     const relativePath = path.relative(cwd, absolutePath);
     const normalizedPath = toPosix(relativePath);
-    const content = await fs.readFile(absolutePath, "utf8");
-    const parsed = matter(content, MATTER_OPTIONS);
-    const snippet = createSnippet(normalizedPath, parsed.data ?? {});
-    if (snippet.draft) {
-      continue;
+    try {
+      const content = await fs.readFile(absolutePath, "utf8");
+      const parsed = matter(content, MATTER_OPTIONS);
+      const snippet = createSnippet(normalizedPath, parsed.data ?? {});
+      if (snippet.draft) {
+        continue;
+      }
+      manifest.push(snippet);
+    } catch (error) {
+      console.warn(
+        `mark\u2193: failed to load snippet at '${normalizedPath}'`,
+        error
+      );
     }
-    manifest.push(snippet);
   }
   ensureUniqueSlugs(manifest);
   manifest.sort((a, b) => {
@@ -212,11 +219,18 @@ function debounce(fn, delay) {
 import fs2 from "fs/promises";
 import path3 from "path";
 import { load as loadHtml } from "cheerio";
-import { parseFrontMatter, renderMarkdown } from "@mzebley/mark-down";
+import {
+  parseFrontMatter,
+  renderMarkdown,
+  sanitizeMarkup
+} from "@mzebley/mark-down";
 var DEFAULT_OUT_DIR = "dist";
 async function compilePage(inputHtml, options = {}) {
   const sourcePath = path3.resolve(inputHtml);
-  await assertExists(sourcePath, `Input HTML file not found at '${inputHtml}'.`);
+  await assertExists(
+    sourcePath,
+    `Input HTML file not found at '${inputHtml}'.`
+  );
   const manifestPath = await resolveManifestPath(sourcePath, options.manifest);
   const manifestDir = path3.dirname(manifestPath);
   const manifest = await loadManifest(manifestPath);
@@ -251,9 +265,15 @@ async function compilePage(inputHtml, options = {}) {
       body = frontMatter.content;
       frontMatterSlug = frontMatter.slug;
     } catch (error) {
-      console.warn(`mark\u2193: failed to parse front matter for '${entry.path}'`, error);
+      console.warn(
+        `mark\u2193: failed to parse front matter for '${entry.path}'`,
+        error
+      );
+    }
+    let html = renderMarkdown(body);
+    if (options.sanitize) {
+      html = sanitizeMarkup(html, options.sanitize);
     }
-    const html = renderMarkdown(body);
     element.html(html);
     if (!element.attr("id")) {
       element.attr("id", frontMatterSlug ?? `snippet-${slug}`);
@@ -271,7 +291,10 @@ async function compilePage(inputHtml, options = {}) {
 }
 async function resolveManifestPath(inputHtml, manifestFlag) {
   const manifestPath = manifestFlag ? path3.resolve(manifestFlag) : path3.join(path3.dirname(path3.resolve(inputHtml)), "snippets-index.json");
-  await assertExists(manifestPath, `Manifest file not found at '${manifestPath}'.`);
+  await assertExists(
+    manifestPath,
+    `Manifest file not found at '${manifestPath}'.`
+  );
   return manifestPath;
 }
 async function loadManifest(manifestPath) {
@@ -279,7 +302,9 @@ async function loadManifest(manifestPath) {
   try {
     raw = await fs2.readFile(manifestPath, "utf8");
   } catch (error) {
-    throw new Error(`Failed to read manifest at '${manifestPath}': ${String(error)}`);
+    throw new Error(
+      `Failed to read manifest at '${manifestPath}': ${String(error)}`
+    );
   }
   try {
     const parsed = JSON.parse(raw);
@@ -288,7 +313,9 @@ async function loadManifest(manifestPath) {
     }
     return parsed;
   } catch (error) {
-    throw new Error(`Failed to parse manifest at '${manifestPath}': ${String(error)}`);
+    throw new Error(
+      `Failed to parse manifest at '${manifestPath}': ${String(error)}`
+    );
   }
 }
 async function assertExists(target, message) {
@@ -304,7 +331,10 @@ var program = new Command();
 program.name("mark-down").description(`${brand} CLI for building snippet manifests`).version("1.2.1");
 program.command("build").argument("[sourceDir]", "directory containing snippets", "content/snippets").option("-o, --output <path>", "where to write snippets-index.json").action(async (sourceDir, options) => {
   try {
-    const result = await buildManifestFile({ sourceDir, outputPath: options.output });
+    const result = await buildManifestFile({
+      sourceDir,
+      outputPath: options.output
+    });
     logEvent("info", "manifest.written", {
       outputPath: result.outputPath,
       snippetCount: result.manifest.length
@@ -320,17 +350,26 @@ program.command("watch").argument("[sourceDir]", "directory containing snippets"
     handleError(error);
   }
 });
-program.command("compile-page").argument("<inputHtml>", "HTML file containing data-snippet placeholders").option("--manifest <path>", "path to snippets-index.json").option("--outDir <path>", "output directory for compiled HTML", "dist").option("--inPlace", "overwrite the input HTML file instead of writing to outDir").action(async (inputHtml, options) => {
-  try {
-    await compilePage(inputHtml, {
-      manifest: options.manifest,
-      outDir: options.outDir,
-      inPlace: options.inPlace
-    });
-  } catch (error) {
-    handleError(error);
+program.command("compile-page").argument("<inputHtml>", "HTML file containing data-snippet placeholders").option("--manifest <path>", "path to snippets-index.json").option("--outDir <path>", "output directory for compiled HTML", "dist").option(
+  "--inPlace",
+  "overwrite the input HTML file instead of writing to outDir"
+).option(
+  "--sanitize [policy]",
+  "sanitize rendered HTML (default|strict|permissive)"
+).action(
+  async (inputHtml, options) => {
+    try {
+      await compilePage(inputHtml, {
+        manifest: options.manifest,
+        outDir: options.outDir,
+        inPlace: options.inPlace,
+        sanitize: resolveSanitizeOption(options.sanitize)
+      });
+    } catch (error) {
+      handleError(error);
+    }
   }
-});
+);
 program.parseAsync(process.argv).catch(handleError);
 function handleError(error) {
   const err = error;
@@ -347,4 +386,23 @@ function handleError(error) {
   });
   process.exit(1);
 }
+function resolveSanitizeOption(value) {
+  if (!value) {
+    return void 0;
+  }
+  if (value === true) {
+    return { policy: "default" };
+  }
+  const policy = value.trim();
+  if (!policy) {
+    return { policy: "default" };
+  }
+  if (!isSanitizePolicy(policy)) {
+    throw new Error(`Unknown sanitize policy '${policy}'.`);
+  }
+  return { policy };
+}
+function isSanitizePolicy(value) {
+  return value === "default" || value === "strict" || value === "permissive";
+}
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/manifest.ts","../src/errors.ts","../src/watch.ts","../src/logger.ts","../src/compile-page.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport { buildManifestFile } from \"./manifest.js\";\nimport { watch as watchSnippets } from \"./watch.js\";\nimport { brand, logEvent } from \"./logger.js\";\nimport { DuplicateSlugError } from \"./errors.js\";\nimport { compilePage } from \"./compile-page.js\";\n\nconst program = new Command();\nprogram\n  .name(\"mark-down\")\n  .description(`${brand} CLI for building snippet manifests`)\n  .version(\"1.2.1\");\n\nprogram\n  .command(\"build\")\n  .argument(\"[sourceDir]\", \"directory containing snippets\", \"content/snippets\")\n  .option(\"-o, --output <path>\", \"where to write snippets-index.json\")\n  .action(async (sourceDir: string, options: { output?: string }) => {\n    try {\n      const result = await buildManifestFile({ sourceDir, outputPath: options.output });\n      logEvent(\"info\", \"manifest.written\", {\n        outputPath: result.outputPath,\n        snippetCount: result.manifest.length\n      });\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram\n  .command(\"watch\")\n  .argument(\"[sourceDir]\", \"directory containing snippets\", \"content/snippets\")\n  .option(\"-o, --output <path>\", \"where to write snippets-index.json\")\n  .action(async (sourceDir: string, options: { output?: string }) => {\n    try {\n      await watchSnippets(sourceDir, options.output);\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram\n  .command(\"compile-page\")\n  .argument(\"<inputHtml>\", \"HTML file containing data-snippet placeholders\")\n  .option(\"--manifest <path>\", \"path to snippets-index.json\")\n  .option(\"--outDir <path>\", \"output directory for compiled HTML\", \"dist\")\n  .option(\"--inPlace\", \"overwrite the input HTML file instead of writing to outDir\")\n  .action(async (inputHtml: string, options: { manifest?: string; outDir?: string; inPlace?: boolean }) => {\n    try {\n      await compilePage(inputHtml, {\n        manifest: options.manifest,\n        outDir: options.outDir,\n        inPlace: options.inPlace\n      });\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram.parseAsync(process.argv).catch(handleError);\n\nfunction handleError(error: unknown) {\n  const err = error as Error;\n  if (err instanceof DuplicateSlugError) {\n    logEvent(\"error\", \"manifest.duplicate_slug\", {\n      message: err.message,\n      slugs: err.duplicates\n    });\n    process.exit(2);\n  }\n  logEvent(\"error\", \"cli.error\", {\n    message: err.message,\n    stack: err.stack\n  });\n  process.exit(1);\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport fg from \"fast-glob\";\nimport matter from \"gray-matter\";\nimport YAML from \"yaml\";\nimport { normalizeSlug, type SnippetMeta } from \"@mzebley/mark-down\";\nimport { DuplicateSlugError } from \"./errors.js\";\n\nconst MATTER_OPTIONS = {\n  engines: {\n    yaml: (source: string) => YAML.parse(source) ?? {}\n  }\n};\n\nexport interface BuildOptions {\n  sourceDir: string;\n  outputPath?: string;\n}\n\nexport interface BuildResult {\n  manifest: SnippetMeta[];\n  outputPath: string;\n}\n\nexport async function buildManifestFile(options: BuildOptions): Promise<BuildResult> {\n  const manifest = await buildManifest(options.sourceDir);\n  const target = options.outputPath ?? path.join(options.sourceDir, \"snippets-index.json\");\n  await fs.writeFile(target, JSON.stringify(manifest, null, 2));\n  return { manifest, outputPath: target };\n}\n\nexport async function buildManifest(sourceDir: string): Promise<SnippetMeta[]> {\n  const cwd = path.resolve(sourceDir);\n  const files = await fg([\"**/*.md\"], { cwd, absolute: true });\n  const manifest: SnippetMeta[] = [];\n\n  for (const absolutePath of files) {\n    const relativePath = path.relative(cwd, absolutePath);\n    const normalizedPath = toPosix(relativePath);\n    const content = await fs.readFile(absolutePath, \"utf8\");\n    const parsed = matter(content, MATTER_OPTIONS);\n    const snippet = createSnippet(normalizedPath, parsed.data ?? {});\n    if (snippet.draft) {\n      continue;\n    }\n    manifest.push(snippet);\n  }\n\n  ensureUniqueSlugs(manifest);\n\n  manifest.sort((a, b) => {\n    const orderA = typeof a.order === \"number\" ? a.order : Number.POSITIVE_INFINITY;\n    const orderB = typeof b.order === \"number\" ? b.order : Number.POSITIVE_INFINITY;\n    if (orderA !== orderB) {\n      return orderA - orderB;\n    }\n    const titleA = a.title?.toLowerCase() ?? \"\";\n    const titleB = b.title?.toLowerCase() ?? \"\";\n    return titleA.localeCompare(titleB);\n  });\n\n  return manifest;\n}\n\nexport function createSnippet(relativePath: string, frontMatter: Record<string, unknown>): SnippetMeta {\n  const group = deriveGroup(relativePath);\n  const slugSource = typeof frontMatter.slug === \"string\" && frontMatter.slug.trim().length\n    ? frontMatter.slug\n    : relativePath.replace(/\\.md$/i, \"\");\n  const slug = normalizeSlug(slugSource);\n\n  const { title, order, type, tags, draft } = normalizeKnownFields(frontMatter);\n  const extra = collectExtra(frontMatter);\n\n  return {\n    slug,\n    title,\n    order,\n    type,\n    tags,\n    draft,\n    path: relativePath,\n    group,\n    extra\n  };\n}\n\nfunction normalizeKnownFields(data: Record<string, unknown>) {\n  return {\n    title: typeof data.title === \"string\" ? data.title : undefined,\n    order: typeof data.order === \"number\"\n      ? data.order\n      : data.order === null\n        ? null\n        : undefined,\n    type: typeof data.type === \"string\" ? data.type : undefined,\n    tags: normalizeTags(data.tags),\n    draft: data.draft === true ? true : undefined\n  };\n}\n\nfunction collectExtra(data: Record<string, unknown>): Record<string, unknown> | undefined {\n  const extra: Record<string, unknown> = {};\n  const reserved = new Set([\"slug\", \"title\", \"order\", \"type\", \"tags\", \"draft\"]);\n  for (const [key, value] of Object.entries(data)) {\n    if (reserved.has(key)) {\n      continue;\n    }\n    extra[key] = value;\n  }\n  return Object.keys(extra).length ? extra : undefined;\n}\n\nfunction normalizeTags(value: unknown): string[] | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (Array.isArray(value)) {\n    return value.map((entry) => String(entry));\n  }\n  if (typeof value === \"string\") {\n    return value\n      .split(\",\")\n      .map((entry) => entry.trim())\n      .filter(Boolean);\n  }\n  return undefined;\n}\n\nfunction deriveGroup(relativePath: string): string {\n  const dirname = toPosix(path.dirname(relativePath));\n  if (dirname === \".\" || !dirname.length) {\n    return \"root\";\n  }\n  return dirname;\n}\n\nfunction toPosix(value: string): string {\n  return value.split(path.sep).join(\"/\");\n}\n\nfunction ensureUniqueSlugs(manifest: SnippetMeta[]) {\n  const seen = new Map<string, string>();\n  const duplicates = new Set<string>();\n  for (const snippet of manifest) {\n    if (seen.has(snippet.slug)) {\n      duplicates.add(snippet.slug);\n    } else {\n      seen.set(snippet.slug, snippet.path);\n    }\n  }\n  if (duplicates.size) {\n    throw new DuplicateSlugError([...duplicates.values()]);\n  }\n}\n","export class DuplicateSlugError extends Error {\n  readonly duplicates: string[];\n\n  constructor(duplicates: string[]) {\n    super(`Duplicate slugs detected: ${duplicates.join(\", \")}`);\n    this.name = \"DuplicateSlugError\";\n    this.duplicates = duplicates;\n  }\n}\n","import path from \"node:path\";\nimport chokidar from \"chokidar\";\nimport { buildManifestFile, type BuildResult } from \"./manifest.js\";\nimport { logEvent } from \"./logger.js\";\n\nexport async function watch(sourceDir: string, outputPath?: string) {\n  const cwd = path.resolve(sourceDir);\n  logEvent(\"info\", \"watch.start\", {\n    directory: cwd,\n    outputPath: outputPath ?? path.join(cwd, \"snippets-index.json\")\n  });\n  await rebuild(cwd, outputPath);\n\n  const watcher = chokidar.watch([\"**/*.md\"], {\n    cwd,\n    ignoreInitial: true,\n    awaitWriteFinish: {\n      stabilityThreshold: 200,\n      pollInterval: 50\n    }\n  });\n\n  const schedule = debounce(async () => {\n    await rebuild(cwd, outputPath);\n  }, 150);\n\n  watcher.on(\"all\", (event, filePath) => {\n    logEvent(\"info\", \"watch.change\", { event, file: filePath });\n    schedule();\n  });\n}\n\nasync function rebuild(sourceDir: string, outputPath?: string): Promise<BuildResult | void> {\n  try {\n    const result = await buildManifestFile({ sourceDir, outputPath });\n    logEvent(\"info\", \"manifest.updated\", {\n      outputPath: result.outputPath,\n      snippetCount: result.manifest.length\n    });\n    return result;\n  } catch (error) {\n    const err = error as Error;\n    logEvent(\"error\", \"manifest.update_failed\", {\n      message: err.message,\n      stack: err.stack\n    });\n  }\n}\n\nfunction debounce<T extends (...args: unknown[]) => Promise<unknown> | void>(\n  fn: T,\n  delay: number\n) {\n  let timer: NodeJS.Timeout | null = null;\n  return (...args: Parameters<T>) => {\n    if (timer) {\n      clearTimeout(timer);\n    }\n    timer = setTimeout(() => {\n      timer = null;\n      void fn(...args);\n    }, delay);\n  };\n}\n","export const brand = \"mark↓\";\n\nexport type LogLevel = \"info\" | \"warn\" | \"error\";\n\nexport interface LogFields {\n  message?: string;\n  [key: string]: unknown;\n}\n\nexport function logEvent(level: LogLevel, event: string, fields: LogFields = {}) {\n  const entry = {\n    brand,\n    level,\n    event,\n    timestamp: new Date().toISOString(),\n    ...fields\n  };\n  const output = `${JSON.stringify(entry)}\\n`;\n  const stream = level === \"error\" ? process.stderr : process.stdout;\n  stream.write(output);\n}\n\nexport function log(message: string, fields?: LogFields) {\n  if (fields) {\n    logEvent(\"info\", message, fields);\n    return;\n  }\n  logEvent(\"info\", \"message\", { message });\n}\n\nexport function logError(message: string, fields?: LogFields) {\n  if (fields) {\n    logEvent(\"error\", message, fields);\n    return;\n  }\n  logEvent(\"error\", \"message\", { message });\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { load as loadHtml } from \"cheerio\";\nimport { parseFrontMatter, renderMarkdown, type SnippetMeta } from \"@mzebley/mark-down\";\nimport { logEvent } from \"./logger.js\";\n\nexport interface CompilePageOptions {\n  manifest?: string;\n  outDir?: string;\n  inPlace?: boolean;\n}\n\nconst DEFAULT_OUT_DIR = \"dist\";\n\nexport async function compilePage(inputHtml: string, options: CompilePageOptions = {}): Promise<string> {\n  const sourcePath = path.resolve(inputHtml);\n  await assertExists(sourcePath, `Input HTML file not found at '${inputHtml}'.`);\n\n  const manifestPath = await resolveManifestPath(sourcePath, options.manifest);\n  const manifestDir = path.dirname(manifestPath);\n  const manifest = await loadManifest(manifestPath);\n\n  const rawHtml = await fs.readFile(sourcePath, \"utf8\");\n  const doctypeMatch = rawHtml.match(/^(<!doctype[^>]*>\\s*)/i);\n  const doctype = doctypeMatch?.[1] ?? \"\";\n  const dom = loadHtml(rawHtml, { decodeEntities: false });\n\n  const targets = dom(\"[data-snippet]\").toArray();\n  for (const node of targets) {\n    const element = dom(node);\n    const slug = element.attr(\"data-snippet\");\n    if (!slug) {\n      continue;\n    }\n    const entry = manifest.find((item) => item.slug === slug);\n    if (!entry) {\n      console.warn(`mark↓: no snippet found for \"${slug}\"`);\n      continue;\n    }\n\n    const snippetPath = path.resolve(manifestDir, entry.path);\n    let raw: string;\n    try {\n      raw = await fs.readFile(snippetPath, \"utf8\");\n    } catch (error) {\n      console.warn(`mark↓: failed to read snippet at '${entry.path}'`, error);\n      continue;\n    }\n\n    let body = raw;\n    let frontMatterSlug: string | undefined;\n    try {\n      const frontMatter = parseFrontMatter(raw);\n      body = frontMatter.content;\n      frontMatterSlug = frontMatter.slug;\n    } catch (error) {\n      console.warn(`mark↓: failed to parse front matter for '${entry.path}'`, error);\n    }\n\n    const html = renderMarkdown(body);\n    element.html(html);\n\n    if (!element.attr(\"id\")) {\n      element.attr(\"id\", frontMatterSlug ?? `snippet-${slug}`);\n    }\n  }\n\n  const outputDir = options.inPlace ? path.dirname(sourcePath) : path.resolve(options.outDir ?? DEFAULT_OUT_DIR);\n  if (!options.inPlace) {\n    await fs.mkdir(outputDir, { recursive: true });\n  }\n  const outputPath = options.inPlace\n    ? sourcePath\n    : path.join(outputDir, path.basename(sourcePath));\n\n  const outputHtml = `${doctype}${dom.html() ?? \"\"}`;\n  await fs.writeFile(outputPath, outputHtml);\n\n  logEvent(\"info\", \"compile_page.written\", { outputPath });\n  return outputPath;\n}\n\nasync function resolveManifestPath(inputHtml: string, manifestFlag?: string): Promise<string> {\n  const manifestPath = manifestFlag\n    ? path.resolve(manifestFlag)\n    : path.join(path.dirname(path.resolve(inputHtml)), \"snippets-index.json\");\n  await assertExists(manifestPath, `Manifest file not found at '${manifestPath}'.`);\n  return manifestPath;\n}\n\nasync function loadManifest(manifestPath: string): Promise<SnippetMeta[]> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(manifestPath, \"utf8\");\n  } catch (error) {\n    throw new Error(`Failed to read manifest at '${manifestPath}': ${String(error)}`);\n  }\n\n  try {\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) {\n      throw new Error(\"Manifest must be a JSON array.\");\n    }\n    return parsed as SnippetMeta[];\n  } catch (error) {\n    throw new Error(`Failed to parse manifest at '${manifestPath}': ${String(error)}`);\n  }\n}\n\nasync function assertExists(target: string, message: string) {\n  try {\n    await fs.access(target);\n  } catch {\n    throw new Error(message);\n  }\n}\n"],"mappings":";;;AACA,SAAS,eAAe;;;ACDxB,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,OAAO,YAAY;AACnB,OAAO,UAAU;AACjB,SAAS,qBAAuC;;;ACLzC,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAG5C,YAAY,YAAsB;AAChC,UAAM,6BAA6B,WAAW,KAAK,IAAI,CAAC,EAAE;AAC1D,SAAK,OAAO;AACZ,SAAK,aAAa;AAAA,EACpB;AACF;;;ADAA,IAAM,iBAAiB;AAAA,EACrB,SAAS;AAAA,IACP,MAAM,CAAC,WAAmB,KAAK,MAAM,MAAM,KAAK,CAAC;AAAA,EACnD;AACF;AAYA,eAAsB,kBAAkB,SAA6C;AACnF,QAAM,WAAW,MAAM,cAAc,QAAQ,SAAS;AACtD,QAAM,SAAS,QAAQ,cAAc,KAAK,KAAK,QAAQ,WAAW,qBAAqB;AACvF,QAAM,GAAG,UAAU,QAAQ,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAC5D,SAAO,EAAE,UAAU,YAAY,OAAO;AACxC;AAEA,eAAsB,cAAc,WAA2C;AAC7E,QAAM,MAAM,KAAK,QAAQ,SAAS;AAClC,QAAM,QAAQ,MAAM,GAAG,CAAC,SAAS,GAAG,EAAE,KAAK,UAAU,KAAK,CAAC;AAC3D,QAAM,WAA0B,CAAC;AAEjC,aAAW,gBAAgB,OAAO;AAChC,UAAM,eAAe,KAAK,SAAS,KAAK,YAAY;AACpD,UAAM,iBAAiB,QAAQ,YAAY;AAC3C,UAAM,UAAU,MAAM,GAAG,SAAS,cAAc,MAAM;AACtD,UAAM,SAAS,OAAO,SAAS,cAAc;AAC7C,UAAM,UAAU,cAAc,gBAAgB,OAAO,QAAQ,CAAC,CAAC;AAC/D,QAAI,QAAQ,OAAO;AACjB;AAAA,IACF;AACA,aAAS,KAAK,OAAO;AAAA,EACvB;AAEA,oBAAkB,QAAQ;AAE1B,WAAS,KAAK,CAAC,GAAG,MAAM;AACtB,UAAM,SAAS,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ,OAAO;AAC9D,UAAM,SAAS,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ,OAAO;AAC9D,QAAI,WAAW,QAAQ;AACrB,aAAO,SAAS;AAAA,IAClB;AACA,UAAM,SAAS,EAAE,OAAO,YAAY,KAAK;AACzC,UAAM,SAAS,EAAE,OAAO,YAAY,KAAK;AACzC,WAAO,OAAO,cAAc,MAAM;AAAA,EACpC,CAAC;AAED,SAAO;AACT;AAEO,SAAS,cAAc,cAAsB,aAAmD;AACrG,QAAM,QAAQ,YAAY,YAAY;AACtC,QAAM,aAAa,OAAO,YAAY,SAAS,YAAY,YAAY,KAAK,KAAK,EAAE,SAC/E,YAAY,OACZ,aAAa,QAAQ,UAAU,EAAE;AACrC,QAAM,OAAO,cAAc,UAAU;AAErC,QAAM,EAAE,OAAO,OAAO,MAAM,MAAM,MAAM,IAAI,qBAAqB,WAAW;AAC5E,QAAM,QAAQ,aAAa,WAAW;AAEtC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,qBAAqB,MAA+B;AAC3D,SAAO;AAAA,IACL,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;AAAA,IACrD,OAAO,OAAO,KAAK,UAAU,WACzB,KAAK,QACL,KAAK,UAAU,OACb,OACA;AAAA,IACN,MAAM,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO;AAAA,IAClD,MAAM,cAAc,KAAK,IAAI;AAAA,IAC7B,OAAO,KAAK,UAAU,OAAO,OAAO;AAAA,EACtC;AACF;AAEA,SAAS,aAAa,MAAoE;AACxF,QAAM,QAAiC,CAAC;AACxC,QAAM,WAAW,oBAAI,IAAI,CAAC,QAAQ,SAAS,SAAS,QAAQ,QAAQ,OAAO,CAAC;AAC5E,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,QAAI,SAAS,IAAI,GAAG,GAAG;AACrB;AAAA,IACF;AACA,UAAM,GAAG,IAAI;AAAA,EACf;AACA,SAAO,OAAO,KAAK,KAAK,EAAE,SAAS,QAAQ;AAC7C;AAEA,SAAS,cAAc,OAAsC;AAC3D,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,IAAI,CAAC,UAAU,OAAO,KAAK,CAAC;AAAA,EAC3C;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,MACJ,MAAM,GAAG,EACT,IAAI,CAAC,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,OAAO;AAAA,EACnB;AACA,SAAO;AACT;AAEA,SAAS,YAAY,cAA8B;AACjD,QAAM,UAAU,QAAQ,KAAK,QAAQ,YAAY,CAAC;AAClD,MAAI,YAAY,OAAO,CAAC,QAAQ,QAAQ;AACtC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,QAAQ,OAAuB;AACtC,SAAO,MAAM,MAAM,KAAK,GAAG,EAAE,KAAK,GAAG;AACvC;AAEA,SAAS,kBAAkB,UAAyB;AAClD,QAAM,OAAO,oBAAI,IAAoB;AACrC,QAAM,aAAa,oBAAI,IAAY;AACnC,aAAW,WAAW,UAAU;AAC9B,QAAI,KAAK,IAAI,QAAQ,IAAI,GAAG;AAC1B,iBAAW,IAAI,QAAQ,IAAI;AAAA,IAC7B,OAAO;AACL,WAAK,IAAI,QAAQ,MAAM,QAAQ,IAAI;AAAA,IACrC;AAAA,EACF;AACA,MAAI,WAAW,MAAM;AACnB,UAAM,IAAI,mBAAmB,CAAC,GAAG,WAAW,OAAO,CAAC,CAAC;AAAA,EACvD;AACF;;;AE1JA,OAAOA,WAAU;AACjB,OAAO,cAAc;;;ACDd,IAAM,QAAQ;AASd,SAAS,SAAS,OAAiB,OAAe,SAAoB,CAAC,GAAG;AAC/E,QAAM,QAAQ;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC,GAAG;AAAA,EACL;AACA,QAAM,SAAS,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA;AACvC,QAAM,SAAS,UAAU,UAAU,QAAQ,SAAS,QAAQ;AAC5D,SAAO,MAAM,MAAM;AACrB;;;ADfA,eAAsB,MAAM,WAAmB,YAAqB;AAClE,QAAM,MAAMC,MAAK,QAAQ,SAAS;AAClC,WAAS,QAAQ,eAAe;AAAA,IAC9B,WAAW;AAAA,IACX,YAAY,cAAcA,MAAK,KAAK,KAAK,qBAAqB;AAAA,EAChE,CAAC;AACD,QAAM,QAAQ,KAAK,UAAU;AAE7B,QAAM,UAAU,SAAS,MAAM,CAAC,SAAS,GAAG;AAAA,IAC1C;AAAA,IACA,eAAe;AAAA,IACf,kBAAkB;AAAA,MAChB,oBAAoB;AAAA,MACpB,cAAc;AAAA,IAChB;AAAA,EACF,CAAC;AAED,QAAM,WAAW,SAAS,YAAY;AACpC,UAAM,QAAQ,KAAK,UAAU;AAAA,EAC/B,GAAG,GAAG;AAEN,UAAQ,GAAG,OAAO,CAAC,OAAO,aAAa;AACrC,aAAS,QAAQ,gBAAgB,EAAE,OAAO,MAAM,SAAS,CAAC;AAC1D,aAAS;AAAA,EACX,CAAC;AACH;AAEA,eAAe,QAAQ,WAAmB,YAAkD;AAC1F,MAAI;AACF,UAAM,SAAS,MAAM,kBAAkB,EAAE,WAAW,WAAW,CAAC;AAChE,aAAS,QAAQ,oBAAoB;AAAA,MACnC,YAAY,OAAO;AAAA,MACnB,cAAc,OAAO,SAAS;AAAA,IAChC,CAAC;AACD,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,MAAM;AACZ,aAAS,SAAS,0BAA0B;AAAA,MAC1C,SAAS,IAAI;AAAA,MACb,OAAO,IAAI;AAAA,IACb,CAAC;AAAA,EACH;AACF;AAEA,SAAS,SACP,IACA,OACA;AACA,MAAI,QAA+B;AACnC,SAAO,IAAI,SAAwB;AACjC,QAAI,OAAO;AACT,mBAAa,KAAK;AAAA,IACpB;AACA,YAAQ,WAAW,MAAM;AACvB,cAAQ;AACR,WAAK,GAAG,GAAG,IAAI;AAAA,IACjB,GAAG,KAAK;AAAA,EACV;AACF;;;AE/DA,OAAOC,SAAQ;AACf,OAAOC,WAAU;AACjB,SAAS,QAAQ,gBAAgB;AACjC,SAAS,kBAAkB,sBAAwC;AASnE,IAAM,kBAAkB;AAExB,eAAsB,YAAY,WAAmB,UAA8B,CAAC,GAAoB;AACtG,QAAM,aAAaC,MAAK,QAAQ,SAAS;AACzC,QAAM,aAAa,YAAY,iCAAiC,SAAS,IAAI;AAE7E,QAAM,eAAe,MAAM,oBAAoB,YAAY,QAAQ,QAAQ;AAC3E,QAAM,cAAcA,MAAK,QAAQ,YAAY;AAC7C,QAAM,WAAW,MAAM,aAAa,YAAY;AAEhD,QAAM,UAAU,MAAMC,IAAG,SAAS,YAAY,MAAM;AACpD,QAAM,eAAe,QAAQ,MAAM,wBAAwB;AAC3D,QAAM,UAAU,eAAe,CAAC,KAAK;AACrC,QAAM,MAAM,SAAS,SAAS,EAAE,gBAAgB,MAAM,CAAC;AAEvD,QAAM,UAAU,IAAI,gBAAgB,EAAE,QAAQ;AAC9C,aAAW,QAAQ,SAAS;AAC1B,UAAM,UAAU,IAAI,IAAI;AACxB,UAAM,OAAO,QAAQ,KAAK,cAAc;AACxC,QAAI,CAAC,MAAM;AACT;AAAA,IACF;AACA,UAAM,QAAQ,SAAS,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI;AACxD,QAAI,CAAC,OAAO;AACV,cAAQ,KAAK,qCAAgC,IAAI,GAAG;AACpD;AAAA,IACF;AAEA,UAAM,cAAcD,MAAK,QAAQ,aAAa,MAAM,IAAI;AACxD,QAAI;AACJ,QAAI;AACF,YAAM,MAAMC,IAAG,SAAS,aAAa,MAAM;AAAA,IAC7C,SAAS,OAAO;AACd,cAAQ,KAAK,0CAAqC,MAAM,IAAI,KAAK,KAAK;AACtE;AAAA,IACF;AAEA,QAAI,OAAO;AACX,QAAI;AACJ,QAAI;AACF,YAAM,cAAc,iBAAiB,GAAG;AACxC,aAAO,YAAY;AACnB,wBAAkB,YAAY;AAAA,IAChC,SAAS,OAAO;AACd,cAAQ,KAAK,iDAA4C,MAAM,IAAI,KAAK,KAAK;AAAA,IAC/E;AAEA,UAAM,OAAO,eAAe,IAAI;AAChC,YAAQ,KAAK,IAAI;AAEjB,QAAI,CAAC,QAAQ,KAAK,IAAI,GAAG;AACvB,cAAQ,KAAK,MAAM,mBAAmB,WAAW,IAAI,EAAE;AAAA,IACzD;AAAA,EACF;AAEA,QAAM,YAAY,QAAQ,UAAUD,MAAK,QAAQ,UAAU,IAAIA,MAAK,QAAQ,QAAQ,UAAU,eAAe;AAC7G,MAAI,CAAC,QAAQ,SAAS;AACpB,UAAMC,IAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAAA,EAC/C;AACA,QAAM,aAAa,QAAQ,UACvB,aACAD,MAAK,KAAK,WAAWA,MAAK,SAAS,UAAU,CAAC;AAElD,QAAM,aAAa,GAAG,OAAO,GAAG,IAAI,KAAK,KAAK,EAAE;AAChD,QAAMC,IAAG,UAAU,YAAY,UAAU;AAEzC,WAAS,QAAQ,wBAAwB,EAAE,WAAW,CAAC;AACvD,SAAO;AACT;AAEA,eAAe,oBAAoB,WAAmB,cAAwC;AAC5F,QAAM,eAAe,eACjBD,MAAK,QAAQ,YAAY,IACzBA,MAAK,KAAKA,MAAK,QAAQA,MAAK,QAAQ,SAAS,CAAC,GAAG,qBAAqB;AAC1E,QAAM,aAAa,cAAc,+BAA+B,YAAY,IAAI;AAChF,SAAO;AACT;AAEA,eAAe,aAAa,cAA8C;AACxE,MAAI;AACJ,MAAI;AACF,UAAM,MAAMC,IAAG,SAAS,cAAc,MAAM;AAAA,EAC9C,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,+BAA+B,YAAY,MAAM,OAAO,KAAK,CAAC,EAAE;AAAA,EAClF;AAEA,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,QAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,gCAAgC,YAAY,MAAM,OAAO,KAAK,CAAC,EAAE;AAAA,EACnF;AACF;AAEA,eAAe,aAAa,QAAgB,SAAiB;AAC3D,MAAI;AACF,UAAMA,IAAG,OAAO,MAAM;AAAA,EACxB,QAAQ;AACN,UAAM,IAAI,MAAM,OAAO;AAAA,EACzB;AACF;;;AL3GA,IAAM,UAAU,IAAI,QAAQ;AAC5B,QACG,KAAK,WAAW,EAChB,YAAY,GAAG,KAAK,qCAAqC,EACzD,QAAQ,OAAO;AAElB,QACG,QAAQ,OAAO,EACf,SAAS,eAAe,iCAAiC,kBAAkB,EAC3E,OAAO,uBAAuB,oCAAoC,EAClE,OAAO,OAAO,WAAmB,YAAiC;AACjE,MAAI;AACF,UAAM,SAAS,MAAM,kBAAkB,EAAE,WAAW,YAAY,QAAQ,OAAO,CAAC;AAChF,aAAS,QAAQ,oBAAoB;AAAA,MACnC,YAAY,OAAO;AAAA,MACnB,cAAc,OAAO,SAAS;AAAA,IAChC,CAAC;AAAA,EACH,SAAS,OAAO;AACd,gBAAY,KAAK;AAAA,EACnB;AACF,CAAC;AAEH,QACG,QAAQ,OAAO,EACf,SAAS,eAAe,iCAAiC,kBAAkB,EAC3E,OAAO,uBAAuB,oCAAoC,EAClE,OAAO,OAAO,WAAmB,YAAiC;AACjE,MAAI;AACF,UAAM,MAAc,WAAW,QAAQ,MAAM;AAAA,EAC/C,SAAS,OAAO;AACd,gBAAY,KAAK;AAAA,EACnB;AACF,CAAC;AAEH,QACG,QAAQ,cAAc,EACtB,SAAS,eAAe,gDAAgD,EACxE,OAAO,qBAAqB,6BAA6B,EACzD,OAAO,mBAAmB,sCAAsC,MAAM,EACtE,OAAO,aAAa,4DAA4D,EAChF,OAAO,OAAO,WAAmB,YAAuE;AACvG,MAAI;AACF,UAAM,YAAY,WAAW;AAAA,MAC3B,UAAU,QAAQ;AAAA,MAClB,QAAQ,QAAQ;AAAA,MAChB,SAAS,QAAQ;AAAA,IACnB,CAAC;AAAA,EACH,SAAS,OAAO;AACd,gBAAY,KAAK;AAAA,EACnB;AACF,CAAC;AAEH,QAAQ,WAAW,QAAQ,IAAI,EAAE,MAAM,WAAW;AAElD,SAAS,YAAY,OAAgB;AACnC,QAAM,MAAM;AACZ,MAAI,eAAe,oBAAoB;AACrC,aAAS,SAAS,2BAA2B;AAAA,MAC3C,SAAS,IAAI;AAAA,MACb,OAAO,IAAI;AAAA,IACb,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,WAAS,SAAS,aAAa;AAAA,IAC7B,SAAS,IAAI;AAAA,IACb,OAAO,IAAI;AAAA,EACb,CAAC;AACD,UAAQ,KAAK,CAAC;AAChB;","names":["path","path","fs","path","path","fs"]}
+{"version":3,"sources":["../src/index.ts","../src/manifest.ts","../src/errors.ts","../src/watch.ts","../src/logger.ts","../src/compile-page.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport { buildManifestFile } from \"./manifest.js\";\nimport { watch as watchSnippets } from \"./watch.js\";\nimport { brand, logEvent } from \"./logger.js\";\nimport { DuplicateSlugError } from \"./errors.js\";\nimport { compilePage } from \"./compile-page.js\";\nimport type { SanitizeOptions, SanitizePolicy } from \"@mzebley/mark-down\";\n\nconst program = new Command();\nprogram\n  .name(\"mark-down\")\n  .description(`${brand} CLI for building snippet manifests`)\n  .version(\"1.2.1\");\n\nprogram\n  .command(\"build\")\n  .argument(\"[sourceDir]\", \"directory containing snippets\", \"content/snippets\")\n  .option(\"-o, --output <path>\", \"where to write snippets-index.json\")\n  .action(async (sourceDir: string, options: { output?: string }) => {\n    try {\n      const result = await buildManifestFile({\n        sourceDir,\n        outputPath: options.output,\n      });\n      logEvent(\"info\", \"manifest.written\", {\n        outputPath: result.outputPath,\n        snippetCount: result.manifest.length,\n      });\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram\n  .command(\"watch\")\n  .argument(\"[sourceDir]\", \"directory containing snippets\", \"content/snippets\")\n  .option(\"-o, --output <path>\", \"where to write snippets-index.json\")\n  .action(async (sourceDir: string, options: { output?: string }) => {\n    try {\n      await watchSnippets(sourceDir, options.output);\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram\n  .command(\"compile-page\")\n  .argument(\"<inputHtml>\", \"HTML file containing data-snippet placeholders\")\n  .option(\"--manifest <path>\", \"path to snippets-index.json\")\n  .option(\"--outDir <path>\", \"output directory for compiled HTML\", \"dist\")\n  .option(\n    \"--inPlace\",\n    \"overwrite the input HTML file instead of writing to outDir\",\n  )\n  .option(\n    \"--sanitize [policy]\",\n    \"sanitize rendered HTML (default|strict|permissive)\",\n  )\n  .action(\n    async (\n      inputHtml: string,\n      options: {\n        manifest?: string;\n        outDir?: string;\n        inPlace?: boolean;\n        sanitize?: string | boolean;\n      },\n    ) => {\n      try {\n        await compilePage(inputHtml, {\n          manifest: options.manifest,\n          outDir: options.outDir,\n          inPlace: options.inPlace,\n          sanitize: resolveSanitizeOption(options.sanitize),\n        });\n      } catch (error) {\n        handleError(error);\n      }\n    },\n  );\n\nprogram.parseAsync(process.argv).catch(handleError);\n\nfunction handleError(error: unknown) {\n  const err = error as Error;\n  if (err instanceof DuplicateSlugError) {\n    logEvent(\"error\", \"manifest.duplicate_slug\", {\n      message: err.message,\n      slugs: err.duplicates,\n    });\n    process.exit(2);\n  }\n  logEvent(\"error\", \"cli.error\", {\n    message: err.message,\n    stack: err.stack,\n  });\n  process.exit(1);\n}\n\nfunction resolveSanitizeOption(\n  value?: string | boolean,\n): SanitizeOptions | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (value === true) {\n    return { policy: \"default\" };\n  }\n  const policy = value.trim();\n  if (!policy) {\n    return { policy: \"default\" };\n  }\n  if (!isSanitizePolicy(policy)) {\n    throw new Error(`Unknown sanitize policy '${policy}'.`);\n  }\n  return { policy };\n}\n\nfunction isSanitizePolicy(value: string): value is SanitizePolicy {\n  return value === \"default\" || value === \"strict\" || value === \"permissive\";\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport fg from \"fast-glob\";\nimport matter from \"gray-matter\";\nimport YAML from \"yaml\";\nimport { normalizeSlug, type SnippetMeta } from \"@mzebley/mark-down\";\nimport { DuplicateSlugError } from \"./errors.js\";\n\nconst MATTER_OPTIONS = {\n  engines: {\n    yaml: (source: string) => YAML.parse(source) ?? {},\n  },\n};\n\nexport interface BuildOptions {\n  sourceDir: string;\n  outputPath?: string;\n}\n\nexport interface BuildResult {\n  manifest: SnippetMeta[];\n  outputPath: string;\n}\n\nexport async function buildManifestFile(\n  options: BuildOptions,\n): Promise<BuildResult> {\n  const manifest = await buildManifest(options.sourceDir);\n  const target =\n    options.outputPath ?? path.join(options.sourceDir, \"snippets-index.json\");\n  await fs.writeFile(target, JSON.stringify(manifest, null, 2));\n  return { manifest, outputPath: target };\n}\n\nexport async function buildManifest(sourceDir: string): Promise<SnippetMeta[]> {\n  const cwd = path.resolve(sourceDir);\n  const files = await fg([\"**/*.md\"], { cwd, absolute: true });\n  const manifest: SnippetMeta[] = [];\n\n  for (const absolutePath of files) {\n    const relativePath = path.relative(cwd, absolutePath);\n    const normalizedPath = toPosix(relativePath);\n    try {\n      const content = await fs.readFile(absolutePath, \"utf8\");\n      const parsed = matter(content, MATTER_OPTIONS);\n      const snippet = createSnippet(normalizedPath, parsed.data ?? {});\n      if (snippet.draft) {\n        continue;\n      }\n      manifest.push(snippet);\n    } catch (error) {\n      console.warn(\n        `mark↓: failed to load snippet at '${normalizedPath}'`,\n        error,\n      );\n    }\n  }\n\n  ensureUniqueSlugs(manifest);\n\n  manifest.sort((a, b) => {\n    const orderA =\n      typeof a.order === \"number\" ? a.order : Number.POSITIVE_INFINITY;\n    const orderB =\n      typeof b.order === \"number\" ? b.order : Number.POSITIVE_INFINITY;\n    if (orderA !== orderB) {\n      return orderA - orderB;\n    }\n    const titleA = a.title?.toLowerCase() ?? \"\";\n    const titleB = b.title?.toLowerCase() ?? \"\";\n    return titleA.localeCompare(titleB);\n  });\n\n  return manifest;\n}\n\nexport function createSnippet(\n  relativePath: string,\n  frontMatter: Record<string, unknown>,\n): SnippetMeta {\n  const group = deriveGroup(relativePath);\n  const slugSource =\n    typeof frontMatter.slug === \"string\" && frontMatter.slug.trim().length\n      ? frontMatter.slug\n      : relativePath.replace(/\\.md$/i, \"\");\n  const slug = normalizeSlug(slugSource);\n\n  const { title, order, type, tags, draft } = normalizeKnownFields(frontMatter);\n  const extra = collectExtra(frontMatter);\n\n  return {\n    slug,\n    title,\n    order,\n    type,\n    tags,\n    draft,\n    path: relativePath,\n    group,\n    extra,\n  };\n}\n\nfunction normalizeKnownFields(data: Record<string, unknown>) {\n  return {\n    title: typeof data.title === \"string\" ? data.title : undefined,\n    order:\n      typeof data.order === \"number\"\n        ? data.order\n        : data.order === null\n          ? null\n          : undefined,\n    type: typeof data.type === \"string\" ? data.type : undefined,\n    tags: normalizeTags(data.tags),\n    draft: data.draft === true ? true : undefined,\n  };\n}\n\nfunction collectExtra(\n  data: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n  const extra: Record<string, unknown> = {};\n  const reserved = new Set([\"slug\", \"title\", \"order\", \"type\", \"tags\", \"draft\"]);\n  for (const [key, value] of Object.entries(data)) {\n    if (reserved.has(key)) {\n      continue;\n    }\n    extra[key] = value;\n  }\n  return Object.keys(extra).length ? extra : undefined;\n}\n\nfunction normalizeTags(value: unknown): string[] | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (Array.isArray(value)) {\n    return value.map((entry) => String(entry));\n  }\n  if (typeof value === \"string\") {\n    return value\n      .split(\",\")\n      .map((entry) => entry.trim())\n      .filter(Boolean);\n  }\n  return undefined;\n}\n\nfunction deriveGroup(relativePath: string): string {\n  const dirname = toPosix(path.dirname(relativePath));\n  if (dirname === \".\" || !dirname.length) {\n    return \"root\";\n  }\n  return dirname;\n}\n\nfunction toPosix(value: string): string {\n  return value.split(path.sep).join(\"/\");\n}\n\nfunction ensureUniqueSlugs(manifest: SnippetMeta[]) {\n  const seen = new Map<string, string>();\n  const duplicates = new Set<string>();\n  for (const snippet of manifest) {\n    if (seen.has(snippet.slug)) {\n      duplicates.add(snippet.slug);\n    } else {\n      seen.set(snippet.slug, snippet.path);\n    }\n  }\n  if (duplicates.size) {\n    throw new DuplicateSlugError([...duplicates.values()]);\n  }\n}\n","export class DuplicateSlugError extends Error {\n  readonly duplicates: string[];\n\n  constructor(duplicates: string[]) {\n    super(`Duplicate slugs detected: ${duplicates.join(\", \")}`);\n    this.name = \"DuplicateSlugError\";\n    this.duplicates = duplicates;\n  }\n}\n","import path from \"node:path\";\nimport chokidar from \"chokidar\";\nimport { buildManifestFile, type BuildResult } from \"./manifest.js\";\nimport { logEvent } from \"./logger.js\";\n\nexport async function watch(sourceDir: string, outputPath?: string) {\n  const cwd = path.resolve(sourceDir);\n  logEvent(\"info\", \"watch.start\", {\n    directory: cwd,\n    outputPath: outputPath ?? path.join(cwd, \"snippets-index.json\"),\n  });\n  await rebuild(cwd, outputPath);\n\n  const watcher = chokidar.watch([\"**/*.md\"], {\n    cwd,\n    ignoreInitial: true,\n    awaitWriteFinish: {\n      stabilityThreshold: 200,\n      pollInterval: 50,\n    },\n  });\n\n  const schedule = debounce(async () => {\n    await rebuild(cwd, outputPath);\n  }, 150);\n\n  watcher.on(\"all\", (event, filePath) => {\n    logEvent(\"info\", \"watch.change\", { event, file: filePath });\n    schedule();\n  });\n}\n\nasync function rebuild(\n  sourceDir: string,\n  outputPath?: string,\n): Promise<BuildResult | void> {\n  try {\n    const result = await buildManifestFile({ sourceDir, outputPath });\n    logEvent(\"info\", \"manifest.updated\", {\n      outputPath: result.outputPath,\n      snippetCount: result.manifest.length,\n    });\n    return result;\n  } catch (error) {\n    const err = error as Error;\n    logEvent(\"error\", \"manifest.update_failed\", {\n      message: err.message,\n      stack: err.stack,\n    });\n  }\n}\n\nfunction debounce<T extends (...args: unknown[]) => Promise<unknown> | void>(\n  fn: T,\n  delay: number,\n) {\n  let timer: NodeJS.Timeout | null = null;\n  return (...args: Parameters<T>) => {\n    if (timer) {\n      clearTimeout(timer);\n    }\n    timer = setTimeout(() => {\n      timer = null;\n      void fn(...args);\n    }, delay);\n  };\n}\n","export const brand = \"mark↓\";\n\nexport type LogLevel = \"info\" | \"warn\" | \"error\";\n\nexport interface LogFields {\n  message?: string;\n  [key: string]: unknown;\n}\n\nexport function logEvent(\n  level: LogLevel,\n  event: string,\n  fields: LogFields = {},\n) {\n  const entry = {\n    brand,\n    level,\n    event,\n    timestamp: new Date().toISOString(),\n    ...fields,\n  };\n  const output = `${JSON.stringify(entry)}\\n`;\n  const stream = level === \"error\" ? process.stderr : process.stdout;\n  stream.write(output);\n}\n\nexport function log(message: string, fields?: LogFields) {\n  if (fields) {\n    logEvent(\"info\", message, fields);\n    return;\n  }\n  logEvent(\"info\", \"message\", { message });\n}\n\nexport function logError(message: string, fields?: LogFields) {\n  if (fields) {\n    logEvent(\"error\", message, fields);\n    return;\n  }\n  logEvent(\"error\", \"message\", { message });\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { load as loadHtml } from \"cheerio\";\nimport {\n  parseFrontMatter,\n  renderMarkdown,\n  sanitizeMarkup,\n  type SanitizeOptions,\n  type SnippetMeta,\n} from \"@mzebley/mark-down\";\nimport { logEvent } from \"./logger.js\";\n\nexport interface CompilePageOptions {\n  manifest?: string;\n  outDir?: string;\n  inPlace?: boolean;\n  sanitize?: SanitizeOptions;\n}\n\nconst DEFAULT_OUT_DIR = \"dist\";\n\nexport async function compilePage(\n  inputHtml: string,\n  options: CompilePageOptions = {},\n): Promise<string> {\n  const sourcePath = path.resolve(inputHtml);\n  await assertExists(\n    sourcePath,\n    `Input HTML file not found at '${inputHtml}'.`,\n  );\n\n  const manifestPath = await resolveManifestPath(sourcePath, options.manifest);\n  const manifestDir = path.dirname(manifestPath);\n  const manifest = await loadManifest(manifestPath);\n\n  const rawHtml = await fs.readFile(sourcePath, \"utf8\");\n  const doctypeMatch = rawHtml.match(/^(<!doctype[^>]*>\\s*)/i);\n  const doctype = doctypeMatch?.[1] ?? \"\";\n  const dom = loadHtml(rawHtml, { decodeEntities: false });\n\n  const targets = dom(\"[data-snippet]\").toArray();\n  for (const node of targets) {\n    const element = dom(node);\n    const slug = element.attr(\"data-snippet\");\n    if (!slug) {\n      continue;\n    }\n    const entry = manifest.find((item) => item.slug === slug);\n    if (!entry) {\n      console.warn(`mark↓: no snippet found for \"${slug}\"`);\n      continue;\n    }\n\n    const snippetPath = path.resolve(manifestDir, entry.path);\n    let raw: string;\n    try {\n      raw = await fs.readFile(snippetPath, \"utf8\");\n    } catch (error) {\n      console.warn(`mark↓: failed to read snippet at '${entry.path}'`, error);\n      continue;\n    }\n\n    let body = raw;\n    let frontMatterSlug: string | undefined;\n    try {\n      const frontMatter = parseFrontMatter(raw);\n      body = frontMatter.content;\n      frontMatterSlug = frontMatter.slug;\n    } catch (error) {\n      console.warn(\n        `mark↓: failed to parse front matter for '${entry.path}'`,\n        error,\n      );\n    }\n\n    let html = renderMarkdown(body);\n    if (options.sanitize) {\n      html = sanitizeMarkup(html, options.sanitize);\n    }\n    element.html(html);\n\n    if (!element.attr(\"id\")) {\n      element.attr(\"id\", frontMatterSlug ?? `snippet-${slug}`);\n    }\n  }\n\n  const outputDir = options.inPlace\n    ? path.dirname(sourcePath)\n    : path.resolve(options.outDir ?? DEFAULT_OUT_DIR);\n  if (!options.inPlace) {\n    await fs.mkdir(outputDir, { recursive: true });\n  }\n  const outputPath = options.inPlace\n    ? sourcePath\n    : path.join(outputDir, path.basename(sourcePath));\n\n  const outputHtml = `${doctype}${dom.html() ?? \"\"}`;\n  await fs.writeFile(outputPath, outputHtml);\n\n  logEvent(\"info\", \"compile_page.written\", { outputPath });\n  return outputPath;\n}\n\nasync function resolveManifestPath(\n  inputHtml: string,\n  manifestFlag?: string,\n): Promise<string> {\n  const manifestPath = manifestFlag\n    ? path.resolve(manifestFlag)\n    : path.join(path.dirname(path.resolve(inputHtml)), \"snippets-index.json\");\n  await assertExists(\n    manifestPath,\n    `Manifest file not found at '${manifestPath}'.`,\n  );\n  return manifestPath;\n}\n\nasync function loadManifest(manifestPath: string): Promise<SnippetMeta[]> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(manifestPath, \"utf8\");\n  } catch (error) {\n    throw new Error(\n      `Failed to read manifest at '${manifestPath}': ${String(error)}`,\n    );\n  }\n\n  try {\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) {\n      throw new Error(\"Manifest must be a JSON array.\");\n    }\n    return parsed as SnippetMeta[];\n  } catch (error) {\n    throw new Error(\n      `Failed to parse manifest at '${manifestPath}': ${String(error)}`,\n    );\n  }\n}\n\nasync function assertExists(target: string, message: string) {\n  try {\n    await fs.access(target);\n  } catch {\n    throw new Error(message);\n  }\n}\n"],"mappings":"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","names":["path","path","fs","path","path","fs"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mzebley/mark-down-cli",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "mark↓ CLI for building snippet manifests",
   "type": "module",
   "bin": {
@@ -9,6 +9,9 @@
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "publishConfig": {
     "access": "public"
   },
@@ -17,7 +20,7 @@
     "dev": "tsup --config tsup.config.ts --watch"
   },
   "dependencies": {
-    "@mzebley/mark-down": "^1.2.1",
+    "@mzebley/mark-down": "^1.2.2",
     "cheerio": "^1.0.0",
     "chokidar": "^3.6.0",
     "commander": "^11.1.0",

package/src/compile-page.ts

@@ -1,116 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { load as loadHtml } from "cheerio";
-import { parseFrontMatter, renderMarkdown, type SnippetMeta } from "@mzebley/mark-down";
-import { logEvent } from "./logger.js";
-
-export interface CompilePageOptions {
-  manifest?: string;
-  outDir?: string;
-  inPlace?: boolean;
-}
-
-const DEFAULT_OUT_DIR = "dist";
-
-export async function compilePage(inputHtml: string, options: CompilePageOptions = {}): Promise<string> {
-  const sourcePath = path.resolve(inputHtml);
-  await assertExists(sourcePath, `Input HTML file not found at '${inputHtml}'.`);
-
-  const manifestPath = await resolveManifestPath(sourcePath, options.manifest);
-  const manifestDir = path.dirname(manifestPath);
-  const manifest = await loadManifest(manifestPath);
-
-  const rawHtml = await fs.readFile(sourcePath, "utf8");
-  const doctypeMatch = rawHtml.match(/^(<!doctype[^>]*>\s*)/i);
-  const doctype = doctypeMatch?.[1] ?? "";
-  const dom = loadHtml(rawHtml, { decodeEntities: false });
-
-  const targets = dom("[data-snippet]").toArray();
-  for (const node of targets) {
-    const element = dom(node);
-    const slug = element.attr("data-snippet");
-    if (!slug) {
-      continue;
-    }
-    const entry = manifest.find((item) => item.slug === slug);
-    if (!entry) {
-      console.warn(`mark↓: no snippet found for "${slug}"`);
-      continue;
-    }
-
-    const snippetPath = path.resolve(manifestDir, entry.path);
-    let raw: string;
-    try {
-      raw = await fs.readFile(snippetPath, "utf8");
-    } catch (error) {
-      console.warn(`mark↓: failed to read snippet at '${entry.path}'`, error);
-      continue;
-    }
-
-    let body = raw;
-    let frontMatterSlug: string | undefined;
-    try {
-      const frontMatter = parseFrontMatter(raw);
-      body = frontMatter.content;
-      frontMatterSlug = frontMatter.slug;
-    } catch (error) {
-      console.warn(`mark↓: failed to parse front matter for '${entry.path}'`, error);
-    }
-
-    const html = renderMarkdown(body);
-    element.html(html);
-
-    if (!element.attr("id")) {
-      element.attr("id", frontMatterSlug ?? `snippet-${slug}`);
-    }
-  }
-
-  const outputDir = options.inPlace ? path.dirname(sourcePath) : path.resolve(options.outDir ?? DEFAULT_OUT_DIR);
-  if (!options.inPlace) {
-    await fs.mkdir(outputDir, { recursive: true });
-  }
-  const outputPath = options.inPlace
-    ? sourcePath
-    : path.join(outputDir, path.basename(sourcePath));
-
-  const outputHtml = `${doctype}${dom.html() ?? ""}`;
-  await fs.writeFile(outputPath, outputHtml);
-
-  logEvent("info", "compile_page.written", { outputPath });
-  return outputPath;
-}
-
-async function resolveManifestPath(inputHtml: string, manifestFlag?: string): Promise<string> {
-  const manifestPath = manifestFlag
-    ? path.resolve(manifestFlag)
-    : path.join(path.dirname(path.resolve(inputHtml)), "snippets-index.json");
-  await assertExists(manifestPath, `Manifest file not found at '${manifestPath}'.`);
-  return manifestPath;
-}
-
-async function loadManifest(manifestPath: string): Promise<SnippetMeta[]> {
-  let raw: string;
-  try {
-    raw = await fs.readFile(manifestPath, "utf8");
-  } catch (error) {
-    throw new Error(`Failed to read manifest at '${manifestPath}': ${String(error)}`);
-  }
-
-  try {
-    const parsed = JSON.parse(raw);
-    if (!Array.isArray(parsed)) {
-      throw new Error("Manifest must be a JSON array.");
-    }
-    return parsed as SnippetMeta[];
-  } catch (error) {
-    throw new Error(`Failed to parse manifest at '${manifestPath}': ${String(error)}`);
-  }
-}
-
-async function assertExists(target: string, message: string) {
-  try {
-    await fs.access(target);
-  } catch {
-    throw new Error(message);
-  }
-}

package/src/errors.ts

@@ -1,9 +0,0 @@
-export class DuplicateSlugError extends Error {
-  readonly duplicates: string[];
-
-  constructor(duplicates: string[]) {
-    super(`Duplicate slugs detected: ${duplicates.join(", ")}`);
-    this.name = "DuplicateSlugError";
-    this.duplicates = duplicates;
-  }
-}

package/src/index.ts

@@ -1,77 +0,0 @@
-#!/usr/bin/env node
-import { Command } from "commander";
-import { buildManifestFile } from "./manifest.js";
-import { watch as watchSnippets } from "./watch.js";
-import { brand, logEvent } from "./logger.js";
-import { DuplicateSlugError } from "./errors.js";
-import { compilePage } from "./compile-page.js";
-
-const program = new Command();
-program
-  .name("mark-down")
-  .description(`${brand} CLI for building snippet manifests`)
-  .version("1.2.1");
-
-program
-  .command("build")
-  .argument("[sourceDir]", "directory containing snippets", "content/snippets")
-  .option("-o, --output <path>", "where to write snippets-index.json")
-  .action(async (sourceDir: string, options: { output?: string }) => {
-    try {
-      const result = await buildManifestFile({ sourceDir, outputPath: options.output });
-      logEvent("info", "manifest.written", {
-        outputPath: result.outputPath,
-        snippetCount: result.manifest.length
-      });
-    } catch (error) {
-      handleError(error);
-    }
-  });
-
-program
-  .command("watch")
-  .argument("[sourceDir]", "directory containing snippets", "content/snippets")
-  .option("-o, --output <path>", "where to write snippets-index.json")
-  .action(async (sourceDir: string, options: { output?: string }) => {
-    try {
-      await watchSnippets(sourceDir, options.output);
-    } catch (error) {
-      handleError(error);
-    }
-  });
-
-program
-  .command("compile-page")
-  .argument("<inputHtml>", "HTML file containing data-snippet placeholders")
-  .option("--manifest <path>", "path to snippets-index.json")
-  .option("--outDir <path>", "output directory for compiled HTML", "dist")
-  .option("--inPlace", "overwrite the input HTML file instead of writing to outDir")
-  .action(async (inputHtml: string, options: { manifest?: string; outDir?: string; inPlace?: boolean }) => {
-    try {
-      await compilePage(inputHtml, {
-        manifest: options.manifest,
-        outDir: options.outDir,
-        inPlace: options.inPlace
-      });
-    } catch (error) {
-      handleError(error);
-    }
-  });
-
-program.parseAsync(process.argv).catch(handleError);
-
-function handleError(error: unknown) {
-  const err = error as Error;
-  if (err instanceof DuplicateSlugError) {
-    logEvent("error", "manifest.duplicate_slug", {
-      message: err.message,
-      slugs: err.duplicates
-    });
-    process.exit(2);
-  }
-  logEvent("error", "cli.error", {
-    message: err.message,
-    stack: err.stack
-  });
-  process.exit(1);
-}

package/src/logger.ts

@@ -1,37 +0,0 @@
-export const brand = "mark↓";
-
-export type LogLevel = "info" | "warn" | "error";
-
-export interface LogFields {
-  message?: string;
-  [key: string]: unknown;
-}
-
-export function logEvent(level: LogLevel, event: string, fields: LogFields = {}) {
-  const entry = {
-    brand,
-    level,
-    event,
-    timestamp: new Date().toISOString(),
-    ...fields
-  };
-  const output = `${JSON.stringify(entry)}\n`;
-  const stream = level === "error" ? process.stderr : process.stdout;
-  stream.write(output);
-}
-
-export function log(message: string, fields?: LogFields) {
-  if (fields) {
-    logEvent("info", message, fields);
-    return;
-  }
-  logEvent("info", "message", { message });
-}
-
-export function logError(message: string, fields?: LogFields) {
-  if (fields) {
-    logEvent("error", message, fields);
-    return;
-  }
-  logEvent("error", "message", { message });
-}

package/src/manifest.ts

@@ -1,155 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import fg from "fast-glob";
-import matter from "gray-matter";
-import YAML from "yaml";
-import { normalizeSlug, type SnippetMeta } from "@mzebley/mark-down";
-import { DuplicateSlugError } from "./errors.js";
-
-const MATTER_OPTIONS = {
-  engines: {
-    yaml: (source: string) => YAML.parse(source) ?? {}
-  }
-};
-
-export interface BuildOptions {
-  sourceDir: string;
-  outputPath?: string;
-}
-
-export interface BuildResult {
-  manifest: SnippetMeta[];
-  outputPath: string;
-}
-
-export async function buildManifestFile(options: BuildOptions): Promise<BuildResult> {
-  const manifest = await buildManifest(options.sourceDir);
-  const target = options.outputPath ?? path.join(options.sourceDir, "snippets-index.json");
-  await fs.writeFile(target, JSON.stringify(manifest, null, 2));
-  return { manifest, outputPath: target };
-}
-
-export async function buildManifest(sourceDir: string): Promise<SnippetMeta[]> {
-  const cwd = path.resolve(sourceDir);
-  const files = await fg(["**/*.md"], { cwd, absolute: true });
-  const manifest: SnippetMeta[] = [];
-
-  for (const absolutePath of files) {
-    const relativePath = path.relative(cwd, absolutePath);
-    const normalizedPath = toPosix(relativePath);
-    const content = await fs.readFile(absolutePath, "utf8");
-    const parsed = matter(content, MATTER_OPTIONS);
-    const snippet = createSnippet(normalizedPath, parsed.data ?? {});
-    if (snippet.draft) {
-      continue;
-    }
-    manifest.push(snippet);
-  }
-
-  ensureUniqueSlugs(manifest);
-
-  manifest.sort((a, b) => {
-    const orderA = typeof a.order === "number" ? a.order : Number.POSITIVE_INFINITY;
-    const orderB = typeof b.order === "number" ? b.order : Number.POSITIVE_INFINITY;
-    if (orderA !== orderB) {
-      return orderA - orderB;
-    }
-    const titleA = a.title?.toLowerCase() ?? "";
-    const titleB = b.title?.toLowerCase() ?? "";
-    return titleA.localeCompare(titleB);
-  });
-
-  return manifest;
-}
-
-export function createSnippet(relativePath: string, frontMatter: Record<string, unknown>): SnippetMeta {
-  const group = deriveGroup(relativePath);
-  const slugSource = typeof frontMatter.slug === "string" && frontMatter.slug.trim().length
-    ? frontMatter.slug
-    : relativePath.replace(/\.md$/i, "");
-  const slug = normalizeSlug(slugSource);
-
-  const { title, order, type, tags, draft } = normalizeKnownFields(frontMatter);
-  const extra = collectExtra(frontMatter);
-
-  return {
-    slug,
-    title,
-    order,
-    type,
-    tags,
-    draft,
-    path: relativePath,
-    group,
-    extra
-  };
-}
-
-function normalizeKnownFields(data: Record<string, unknown>) {
-  return {
-    title: typeof data.title === "string" ? data.title : undefined,
-    order: typeof data.order === "number"
-      ? data.order
-      : data.order === null
-        ? null
-        : undefined,
-    type: typeof data.type === "string" ? data.type : undefined,
-    tags: normalizeTags(data.tags),
-    draft: data.draft === true ? true : undefined
-  };
-}
-
-function collectExtra(data: Record<string, unknown>): Record<string, unknown> | undefined {
-  const extra: Record<string, unknown> = {};
-  const reserved = new Set(["slug", "title", "order", "type", "tags", "draft"]);
-  for (const [key, value] of Object.entries(data)) {
-    if (reserved.has(key)) {
-      continue;
-    }
-    extra[key] = value;
-  }
-  return Object.keys(extra).length ? extra : undefined;
-}
-
-function normalizeTags(value: unknown): string[] | undefined {
-  if (!value) {
-    return undefined;
-  }
-  if (Array.isArray(value)) {
-    return value.map((entry) => String(entry));
-  }
-  if (typeof value === "string") {
-    return value
-      .split(",")
-      .map((entry) => entry.trim())
-      .filter(Boolean);
-  }
-  return undefined;
-}
-
-function deriveGroup(relativePath: string): string {
-  const dirname = toPosix(path.dirname(relativePath));
-  if (dirname === "." || !dirname.length) {
-    return "root";
-  }
-  return dirname;
-}
-
-function toPosix(value: string): string {
-  return value.split(path.sep).join("/");
-}
-
-function ensureUniqueSlugs(manifest: SnippetMeta[]) {
-  const seen = new Map<string, string>();
-  const duplicates = new Set<string>();
-  for (const snippet of manifest) {
-    if (seen.has(snippet.slug)) {
-      duplicates.add(snippet.slug);
-    } else {
-      seen.set(snippet.slug, snippet.path);
-    }
-  }
-  if (duplicates.size) {
-    throw new DuplicateSlugError([...duplicates.values()]);
-  }
-}

package/src/watch.ts

@@ -1,64 +0,0 @@
-import path from "node:path";
-import chokidar from "chokidar";
-import { buildManifestFile, type BuildResult } from "./manifest.js";
-import { logEvent } from "./logger.js";
-
-export async function watch(sourceDir: string, outputPath?: string) {
-  const cwd = path.resolve(sourceDir);
-  logEvent("info", "watch.start", {
-    directory: cwd,
-    outputPath: outputPath ?? path.join(cwd, "snippets-index.json")
-  });
-  await rebuild(cwd, outputPath);
-
-  const watcher = chokidar.watch(["**/*.md"], {
-    cwd,
-    ignoreInitial: true,
-    awaitWriteFinish: {
-      stabilityThreshold: 200,
-      pollInterval: 50
-    }
-  });
-
-  const schedule = debounce(async () => {
-    await rebuild(cwd, outputPath);
-  }, 150);
-
-  watcher.on("all", (event, filePath) => {
-    logEvent("info", "watch.change", { event, file: filePath });
-    schedule();
-  });
-}
-
-async function rebuild(sourceDir: string, outputPath?: string): Promise<BuildResult | void> {
-  try {
-    const result = await buildManifestFile({ sourceDir, outputPath });
-    logEvent("info", "manifest.updated", {
-      outputPath: result.outputPath,
-      snippetCount: result.manifest.length
-    });
-    return result;
-  } catch (error) {
-    const err = error as Error;
-    logEvent("error", "manifest.update_failed", {
-      message: err.message,
-      stack: err.stack
-    });
-  }
-}
-
-function debounce<T extends (...args: unknown[]) => Promise<unknown> | void>(
-  fn: T,
-  delay: number
-) {
-  let timer: NodeJS.Timeout | null = null;
-  return (...args: Parameters<T>) => {
-    if (timer) {
-      clearTimeout(timer);
-    }
-    timer = setTimeout(() => {
-      timer = null;
-      void fn(...args);
-    }, delay);
-  };
-}

package/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "module": "ES2020",
-    "moduleResolution": "node"
-  },
-  "include": ["src/**/*"]
-}

package/tsup.config.ts

@@ -1,15 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts"],
-  format: ["esm", "cjs"],
-  dts: true,
-  sourcemap: true,
-  splitting: false,
-  clean: true,
-  outExtension({ format }) {
-    return {
-      js: format === "esm" ? ".mjs" : ".cjs"
-    };
-  }
-});