diffwiki-core 0.3.0-rc.202607220233.d11ed2a → 0.3.0

package/dist/index.cjs

@@ -38,7 +38,6 @@ __export(index_exports, {
   NoDefaultCollectionError: () => NoDefaultCollectionError,
   REPO_CONFIG_FILE: () => REPO_CONFIG_FILE,
   addTags: () => addTags,
-  buildArticleTree: () => buildArticleTree,
   collectionDir: () => collectionDir,
   collectionsDir: () => collectionsDir,
   configPath: () => configPath,
@@ -48,13 +47,11 @@ __export(index_exports, {
   findCollection: () => findCollection,
   getConfigValue: () => getConfigValue,
   initRepoWiki: () => initRepoWiki,
-  listArticleTree: () => listArticleTree,
   listCollections: () => listCollections,
   parseAddTarget: () => parseAddTarget,
   parseArticle: () => parseArticle,
   parsePathTarget: () => parsePathTarget,
   query: () => query,
-  readArticle: () => readArticle,
   readConfig: () => readConfig,
   readRegistry: () => readRegistry,
   readRepoConfig: () => readRepoConfig,
@@ -63,7 +60,6 @@ __export(index_exports, {
   removeArticle: () => removeArticle,
   removeCollection: () => removeCollection,
   removeTags: () => removeTags,
-  renderArticle: () => renderArticle,
   resolveHome: () => resolveHome,
   serializeArticle: () => serializeArticle,
   setConfigValue: () => setConfigValue,
@@ -239,17 +235,8 @@ function slugify(input) {
 
 // src/frontmatter.ts
 var import_gray_matter = __toESM(require("gray-matter"), 1);
-var import_yaml = require("yaml");
-var YAML_ENGINE = {
-  parse: (input) => {
-    const data = (0, import_yaml.parse)(input);
-    return data && typeof data === "object" ? data : {};
-  },
-  stringify: (data) => (0, import_yaml.stringify)(data)
-};
-var MATTER_OPTS = { engines: { yaml: YAML_ENGINE } };
 function parseArticle(raw) {
-  const { data, content } = (0, import_gray_matter.default)(raw, MATTER_OPTS);
+  const { data, content } = (0, import_gray_matter.default)(raw);
   const title = typeof data.title === "string" ? data.title : "";
   const tags = Array.isArray(data.tags) ? data.tags.map((t) => String(t)) : [];
   const created = typeof data.created === "string" ? data.created : void 0;
@@ -259,7 +246,7 @@ function serializeArticle(article) {
   const front = { title: article.title, tags: article.tags };
   if (article.created) front.created = article.created;
   if (article.updated) front.updated = article.updated;
-  return import_gray_matter.default.stringify(article.body, front, MATTER_OPTS);
+  return import_gray_matter.default.stringify(article.body, front);
 }
 
 // src/articles.ts
@@ -378,7 +365,7 @@ var import_promises5 = __toESM(require("fs/promises"), 1);
 var import_node_path3 = __toESM(require("path"), 1);
 var import_node_child_process = require("child_process");
 var import_node_util = require("util");
-var import_yaml2 = require("yaml");
+var import_yaml = require("yaml");
 var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
 var REPO_CONFIG_FILE = "diffwiki.yaml";
 async function detectRepoName(cwd) {
@@ -392,7 +379,7 @@ async function detectRepoName(cwd) {
 async function readRepoConfig(cwd) {
   try {
     const raw = await import_promises5.default.readFile(import_node_path3.default.join(cwd, REPO_CONFIG_FILE), "utf8");
-    const parsed = (0, import_yaml2.parse)(raw) ?? {};
+    const parsed = (0, import_yaml.parse)(raw) ?? {};
     if (!parsed.path) return void 0;
     return {
       collection: parsed.collection ?? import_node_path3.default.basename(import_node_path3.default.resolve(cwd)),
@@ -423,7 +410,7 @@ async function initRepoWiki(opts) {
   }
   await import_promises5.default.mkdir(absWiki, { recursive: true });
   const config = { collection: name, path: wikiPath };
-  await import_promises5.default.writeFile(import_node_path3.default.join(cwd, REPO_CONFIG_FILE), (0, import_yaml2.stringify)(config), "utf8");
+  await import_promises5.default.writeFile(import_node_path3.default.join(cwd, REPO_CONFIG_FILE), (0, import_yaml.stringify)(config), "utf8");
   const entry = {
     name,
     type: "repo",
@@ -507,224 +494,6 @@ async function doctor() {
   }
   return out;
 }
-
-// src/browse.ts
-var import_promises8 = __toESM(require("fs/promises"), 1);
-var import_node_path5 = __toESM(require("path"), 1);
-var INDEX_RE = /^(index|readme)\.mdx?$/i;
-function buildArticleTree(relPaths) {
-  const root = {};
-  for (const raw of relPaths) {
-    const rel = raw.replace(/\\/g, "/").replace(/^\/+/, "");
-    if (!rel) continue;
-    const segs = rel.split("/");
-    let cur = root;
-    segs.forEach((seg, i) => {
-      if (i === segs.length - 1) {
-        if (!(seg in cur)) cur[seg] = null;
-      } else {
-        if (cur[seg] === null || !(seg in cur)) cur[seg] = {};
-        cur = cur[seg];
-      }
-    });
-  }
-  const stripExt = (f) => f.replace(/\.(mdx?)$/, "");
-  const walk = (trie, parents) => {
-    const entries = Object.entries(trie);
-    const branches = entries.filter(([, v]) => v !== null);
-    const leaves = entries.filter(([, v]) => v === null).map(([k]) => k).filter((f) => !INDEX_RE.test(f));
-    branches.sort(([a], [b]) => a.toLowerCase().localeCompare(b.toLowerCase()));
-    leaves.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
-    const branchNodes = branches.map(([seg, sub]) => ({
-      name: seg,
-      title: seg,
-      // Folders are navigable to their index page (an authored index.md/README,
-      // else a generated listing).
-      slug: [...parents, seg].join("/"),
-      children: walk(sub, [...parents, seg])
-    }));
-    const leafNodes = leaves.map((file) => {
-      const nameNoExt = stripExt(file);
-      return { name: nameNoExt, title: nameNoExt, slug: [...parents, nameNoExt].join("/") };
-    });
-    return [...branchNodes, ...leafNodes];
-  };
-  return walk(root, []);
-}
-async function collectRelPaths(dir, rel = "") {
-  let dirents;
-  try {
-    dirents = await import_promises8.default.readdir(dir, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-  const out = [];
-  for (const d of dirents) {
-    if (d.name.startsWith(".")) continue;
-    const childRel = rel ? `${rel}/${d.name}` : d.name;
-    if (d.isDirectory()) {
-      out.push(...await collectRelPaths(import_node_path5.default.join(dir, d.name), childRel));
-    } else if (/\.(mdx?)$/.test(d.name)) {
-      out.push(childRel);
-    }
-  }
-  return out;
-}
-async function readdirSafe(dir) {
-  try {
-    return await import_promises8.default.readdir(dir);
-  } catch {
-    return [];
-  }
-}
-function pickIndexFile(names) {
-  const rank = (n) => {
-    const lower = n.toLowerCase();
-    const base = lower.startsWith("index") ? 0 : 1;
-    const ext = lower.endsWith(".mdx") ? 0 : 1;
-    return base * 2 + ext;
-  };
-  return names.filter((n) => INDEX_RE.test(n)).sort((a, b) => rank(a) - rank(b))[0];
-}
-async function cheapTitle(absPath) {
-  let handle;
-  try {
-    handle = await import_promises8.default.open(absPath, "r");
-    const buf = Buffer.alloc(512);
-    const { bytesRead } = await handle.read(buf, 0, 512, 0);
-    const snippet = buf.subarray(0, bytesRead).toString("utf8");
-    const m = snippet.match(/^---[\s\S]*?^title:\s*(.+)$/m);
-    if (m) return m[1].trim().replace(/^["']|["']$/g, "");
-  } catch {
-  } finally {
-    await handle?.close();
-  }
-  return void 0;
-}
-async function enrichTitles(nodes, collDir) {
-  return Promise.all(
-    nodes.map(async (node) => {
-      if (node.children) {
-        const children = await enrichTitles(node.children, collDir);
-        let title = node.title;
-        if (node.slug) {
-          const dir = import_node_path5.default.join(collDir, node.slug);
-          const idx = pickIndexFile(await readdirSafe(dir));
-          if (idx) title = await cheapTitle(import_node_path5.default.join(dir, idx)) ?? title;
-        }
-        return { ...node, title, children };
-      }
-      for (const ext of [".mdx", ".md"]) {
-        const title = await cheapTitle(import_node_path5.default.join(collDir, `${node.slug}${ext}`));
-        if (title) return { ...node, title };
-      }
-      return node;
-    })
-  );
-}
-async function listArticleTree(coll) {
-  const entry = await findCollection(coll);
-  if (!entry) throw new CollectionNotFoundError(coll);
-  const rels = await collectRelPaths(entry.path);
-  return enrichTitles(buildArticleTree(rels), import_node_path5.default.resolve(entry.path));
-}
-async function readArticle(coll, slug) {
-  const entry = await findCollection(coll);
-  if (!entry) throw new CollectionNotFoundError(coll);
-  const collDir = import_node_path5.default.resolve(entry.path);
-  const normalized = slug.replace(/\\/g, "/");
-  if (normalized.split("/").some((s) => s === "..")) {
-    throw new InvalidTargetError(slug, "path traversal detected");
-  }
-  const safeSlug = normalized.split("/").filter((s) => s !== "" && s !== ".").join("/");
-  const inJail = (p) => p === collDir || p.startsWith(collDir + import_node_path5.default.sep);
-  let abs;
-  for (const rel of safeSlug ? [`${safeSlug}.mdx`, `${safeSlug}.md`] : []) {
-    const candidate = import_node_path5.default.resolve(collDir, rel);
-    if (!inJail(candidate)) throw new InvalidTargetError(slug, "path traversal detected");
-    try {
-      await import_promises8.default.access(candidate);
-      abs = candidate;
-      break;
-    } catch {
-    }
-  }
-  if (!abs) {
-    const dir = import_node_path5.default.resolve(collDir, safeSlug);
-    if (inJail(dir)) {
-      const idx = pickIndexFile(await readdirSafe(dir));
-      if (idx) abs = import_node_path5.default.join(dir, idx);
-    }
-  }
-  if (!abs) throw new ArticleNotFoundError(`${coll}/${safeSlug}`);
-  const parsed = parseArticle(await import_promises8.default.readFile(abs, "utf8"));
-  const title = parsed.title?.trim() || (safeSlug ? safeSlug.split("/").pop() ?? safeSlug : coll);
-  return { coll, slug: safeSlug, title, tags: parsed.tags, body: parsed.body, path: abs };
-}
-
-// src/render.ts
-var import_unified = require("unified");
-var import_remark_parse = __toESM(require("remark-parse"), 1);
-var import_remark_gfm = __toESM(require("remark-gfm"), 1);
-var import_remark_rehype = __toESM(require("remark-rehype"), 1);
-var import_rehype_slug = __toESM(require("rehype-slug"), 1);
-var import_rehype = __toESM(require("@shikijs/rehype"), 1);
-var import_rehype_stringify = __toESM(require("rehype-stringify"), 1);
-var import_unist_util_visit = require("unist-util-visit");
-var import_hast_util_to_string = require("hast-util-to-string");
-var LANG_ALIASES = {
-  "c#": "csharp",
-  cs: "csharp",
-  "c++": "cpp",
-  cxx: "cpp",
-  hs: "haskell",
-  ex: "elixir"
-};
-function rehypeCollectToc(toc) {
-  return (tree) => {
-    (0, import_unist_util_visit.visit)(tree, "element", (node) => {
-      if (node.tagName !== "h2" && node.tagName !== "h3") return;
-      const id = node.properties?.id;
-      if (!id) return;
-      toc.push({ slug: String(id), text: (0, import_hast_util_to_string.toString)(node), depth: node.tagName === "h2" ? 2 : 3 });
-    });
-  };
-}
-function rehypeStripLeadingH1() {
-  return (tree) => {
-    let removed = false;
-    (0, import_unist_util_visit.visit)(tree, "element", (node, index, parent) => {
-      if (!removed && node.tagName === "h1" && parent && index != null) {
-        parent.children.splice(index, 1);
-        removed = true;
-        return [import_unist_util_visit.SKIP, index];
-      }
-    });
-  };
-}
-function rehypeMarkMermaid() {
-  return (tree) => {
-    (0, import_unist_util_visit.visit)(tree, "element", (node) => {
-      if (node.tagName !== "pre") return;
-      const code = node.children.find((c) => c.type === "element" && c.tagName === "code");
-      const cls = code?.properties?.className ?? [];
-      if (!code || !cls.includes("language-mermaid")) return;
-      const source = (0, import_hast_util_to_string.toString)(code);
-      node.properties = { className: ["mermaid"] };
-      node.children = [{ type: "text", value: source }];
-    });
-  };
-}
-async function renderArticle(body) {
-  const toc = [];
-  const file = await (0, import_unified.unified)().use(import_remark_parse.default).use(import_remark_gfm.default).use(import_remark_rehype.default).use(import_rehype_slug.default).use(rehypeCollectToc, toc).use(rehypeStripLeadingH1).use(rehypeMarkMermaid).use(import_rehype.default, {
-    themes: { light: "github-light", dark: "github-dark" },
-    defaultColor: false,
-    langAlias: LANG_ALIASES,
-    fallbackLanguage: "plaintext"
-  }).use(import_rehype_stringify.default).process(body);
-  return { html: String(file), toc };
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ArticleNotFoundError,
@@ -735,7 +504,6 @@ async function renderArticle(body) {
   NoDefaultCollectionError,
   REPO_CONFIG_FILE,
   addTags,
-  buildArticleTree,
   collectionDir,
   collectionsDir,
   configPath,
@@ -745,13 +513,11 @@ async function renderArticle(body) {
   findCollection,
   getConfigValue,
   initRepoWiki,
-  listArticleTree,
   listCollections,
   parseAddTarget,
   parseArticle,
   parsePathTarget,
   query,
-  readArticle,
   readConfig,
   readRegistry,
   readRepoConfig,
@@ -760,7 +526,6 @@ async function renderArticle(body) {
   removeArticle,
   removeCollection,
   removeTags,
-  renderArticle,
   resolveHome,
   serializeArticle,
   setConfigValue,

package/dist/index.d.cts

@@ -25,31 +25,6 @@ interface RepoConfig {
     /** Path to the wiki directory, relative to the repo root. */
     path: string;
 }
-/** A node in a collection's article tree. Branches have `children`; leaves have `slug`. */
-interface ArticleNode {
-    /** Segment label — dir name for branches, filename-without-ext for leaves. */
-    name: string;
-    /** Display title — frontmatter `title` (leaf) or the folder's index title, else `name`. */
-    title?: string;
-    /**
-     * Path within the collection, without extension, e.g. "guide/setup". Set on
-     * leaves (the article) and on branches (the folder, navigable to its index).
-     */
-    slug?: string;
-    /** Branch only: nested nodes. */
-    children?: ArticleNode[];
-}
-/** A resolved article's content, returned by `readArticle`. */
-interface ArticleContent {
-    coll: string;
-    slug: string;
-    title: string;
-    tags: string[];
-    /** Frontmatter-stripped body (md/mdx). */
-    body: string;
-    /** Absolute path to the file on disk. */
-    path: string;
-}
 
 /** Base class for all expected, user-facing diffwiki failures. */
 declare class DiffwikiError extends Error {
@@ -167,45 +142,4 @@ interface Diagnostic {
 }
 declare function doctor(): Promise<Diagnostic[]>;
 
-/**
- * Build a nested ArticleNode[] from a flat list of relative file paths.
- * Pure — no I/O. Directories become branches; files become leaves whose `slug`
- * is the relative path without extension. Dirs-first, then alpha (case-insensitive).
- */
-declare function buildArticleTree(relPaths: string[]): ArticleNode[];
-/**
- * List the article tree of a collection. Walks the collection's registered
- * `entry.path` — so collections living OUTSIDE `~/.diffwiki/collections`
- * (e.g. in-repo wikis registered via `diffwiki init`) work unchanged.
- */
-declare function listArticleTree(coll: string): Promise<ArticleNode[]>;
-/**
- * Read and resolve a single article by collection + slug (relative path without
- * extension). Tries `.mdx` then `.md`, guards against path traversal, and splits
- * frontmatter. Throws CollectionNotFoundError / ArticleNotFoundError / InvalidTargetError.
- */
-declare function readArticle(coll: string, slug: string): Promise<ArticleContent>;
-
-/** A heading extracted for the table of contents (h2/h3). */
-interface TocItem {
-    slug: string;
-    text: string;
-    depth: number;
-}
-/** The result of rendering an article body to HTML. */
-interface RenderedArticle {
-    /** Fully-rendered, Shiki-highlighted HTML — mounted directly on the client (no eval). */
-    html: string;
-    /** h2/h3 headings collected during render, in document order. */
-    toc: TocItem[];
-}
-/**
- * Render an article body (markdown) to Shiki-highlighted HTML plus its table of
- * contents. Runs entirely server-side; the client mounts the HTML directly with
- * no `eval`/`new Function`, so it works under a strict CSP. Code is highlighted
- * here (dual github-light/github-dark via CSS variables); mermaid fences are
- * marked for client rendering.
- */
-declare function renderArticle(body: string): Promise<RenderedArticle>;
-
-export { type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, type CollectionEntry, CollectionExistsError, CollectionNotFoundError, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type InitOptions, InvalidTargetError, NoDefaultCollectionError, type ParsedArticle, type QueryHit, REPO_CONFIG_FILE, type Registry, type RenderedArticle, type RepoConfig, type SerializableArticle, type TocItem, addTags, buildArticleTree, collectionDir, collectionsDir, configPath, createArticle, createCollection, doctor, findCollection, getConfigValue, initRepoWiki, listArticleTree, listCollections, parseAddTarget, parseArticle, parsePathTarget, query, readArticle, readConfig, readRegistry, readRepoConfig, registerCollection, registryPath, removeArticle, removeCollection, removeTags, renderArticle, resolveHome, serializeArticle, setConfigValue, setTags, slugify, unregisterCollection, updateArticleBody, writeConfig, writeRegistry };
+export { type Article, ArticleNotFoundError, type CollectionEntry, CollectionExistsError, CollectionNotFoundError, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type InitOptions, InvalidTargetError, NoDefaultCollectionError, type ParsedArticle, type QueryHit, REPO_CONFIG_FILE, type Registry, type RepoConfig, type SerializableArticle, addTags, collectionDir, collectionsDir, configPath, createArticle, createCollection, doctor, findCollection, getConfigValue, initRepoWiki, listCollections, parseAddTarget, parseArticle, parsePathTarget, query, readConfig, readRegistry, readRepoConfig, registerCollection, registryPath, removeArticle, removeCollection, removeTags, resolveHome, serializeArticle, setConfigValue, setTags, slugify, unregisterCollection, updateArticleBody, writeConfig, writeRegistry };

package/dist/index.d.ts

@@ -25,31 +25,6 @@ interface RepoConfig {
     /** Path to the wiki directory, relative to the repo root. */
     path: string;
 }
-/** A node in a collection's article tree. Branches have `children`; leaves have `slug`. */
-interface ArticleNode {
-    /** Segment label — dir name for branches, filename-without-ext for leaves. */
-    name: string;
-    /** Display title — frontmatter `title` (leaf) or the folder's index title, else `name`. */
-    title?: string;
-    /**
-     * Path within the collection, without extension, e.g. "guide/setup". Set on
-     * leaves (the article) and on branches (the folder, navigable to its index).
-     */
-    slug?: string;
-    /** Branch only: nested nodes. */
-    children?: ArticleNode[];
-}
-/** A resolved article's content, returned by `readArticle`. */
-interface ArticleContent {
-    coll: string;
-    slug: string;
-    title: string;
-    tags: string[];
-    /** Frontmatter-stripped body (md/mdx). */
-    body: string;
-    /** Absolute path to the file on disk. */
-    path: string;
-}
 
 /** Base class for all expected, user-facing diffwiki failures. */
 declare class DiffwikiError extends Error {
@@ -167,45 +142,4 @@ interface Diagnostic {
 }
 declare function doctor(): Promise<Diagnostic[]>;
 
-/**
- * Build a nested ArticleNode[] from a flat list of relative file paths.
- * Pure — no I/O. Directories become branches; files become leaves whose `slug`
- * is the relative path without extension. Dirs-first, then alpha (case-insensitive).
- */
-declare function buildArticleTree(relPaths: string[]): ArticleNode[];
-/**
- * List the article tree of a collection. Walks the collection's registered
- * `entry.path` — so collections living OUTSIDE `~/.diffwiki/collections`
- * (e.g. in-repo wikis registered via `diffwiki init`) work unchanged.
- */
-declare function listArticleTree(coll: string): Promise<ArticleNode[]>;
-/**
- * Read and resolve a single article by collection + slug (relative path without
- * extension). Tries `.mdx` then `.md`, guards against path traversal, and splits
- * frontmatter. Throws CollectionNotFoundError / ArticleNotFoundError / InvalidTargetError.
- */
-declare function readArticle(coll: string, slug: string): Promise<ArticleContent>;
-
-/** A heading extracted for the table of contents (h2/h3). */
-interface TocItem {
-    slug: string;
-    text: string;
-    depth: number;
-}
-/** The result of rendering an article body to HTML. */
-interface RenderedArticle {
-    /** Fully-rendered, Shiki-highlighted HTML — mounted directly on the client (no eval). */
-    html: string;
-    /** h2/h3 headings collected during render, in document order. */
-    toc: TocItem[];
-}
-/**
- * Render an article body (markdown) to Shiki-highlighted HTML plus its table of
- * contents. Runs entirely server-side; the client mounts the HTML directly with
- * no `eval`/`new Function`, so it works under a strict CSP. Code is highlighted
- * here (dual github-light/github-dark via CSS variables); mermaid fences are
- * marked for client rendering.
- */
-declare function renderArticle(body: string): Promise<RenderedArticle>;
-
-export { type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, type CollectionEntry, CollectionExistsError, CollectionNotFoundError, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type InitOptions, InvalidTargetError, NoDefaultCollectionError, type ParsedArticle, type QueryHit, REPO_CONFIG_FILE, type Registry, type RenderedArticle, type RepoConfig, type SerializableArticle, type TocItem, addTags, buildArticleTree, collectionDir, collectionsDir, configPath, createArticle, createCollection, doctor, findCollection, getConfigValue, initRepoWiki, listArticleTree, listCollections, parseAddTarget, parseArticle, parsePathTarget, query, readArticle, readConfig, readRegistry, readRepoConfig, registerCollection, registryPath, removeArticle, removeCollection, removeTags, renderArticle, resolveHome, serializeArticle, setConfigValue, setTags, slugify, unregisterCollection, updateArticleBody, writeConfig, writeRegistry };
+export { type Article, ArticleNotFoundError, type CollectionEntry, CollectionExistsError, CollectionNotFoundError, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type InitOptions, InvalidTargetError, NoDefaultCollectionError, type ParsedArticle, type QueryHit, REPO_CONFIG_FILE, type Registry, type RepoConfig, type SerializableArticle, addTags, collectionDir, collectionsDir, configPath, createArticle, createCollection, doctor, findCollection, getConfigValue, initRepoWiki, listCollections, parseAddTarget, parseArticle, parsePathTarget, query, readConfig, readRegistry, readRepoConfig, registerCollection, registryPath, removeArticle, removeCollection, removeTags, resolveHome, serializeArticle, setConfigValue, setTags, slugify, unregisterCollection, updateArticleBody, writeConfig, writeRegistry };

package/dist/index.js

@@ -161,17 +161,8 @@ function slugify(input) {
 
 // src/frontmatter.ts
 import matter from "gray-matter";
-import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
-var YAML_ENGINE = {
-  parse: (input) => {
-    const data = parseYaml(input);
-    return data && typeof data === "object" ? data : {};
-  },
-  stringify: (data) => stringifyYaml(data)
-};
-var MATTER_OPTS = { engines: { yaml: YAML_ENGINE } };
 function parseArticle(raw) {
-  const { data, content } = matter(raw, MATTER_OPTS);
+  const { data, content } = matter(raw);
   const title = typeof data.title === "string" ? data.title : "";
   const tags = Array.isArray(data.tags) ? data.tags.map((t) => String(t)) : [];
   const created = typeof data.created === "string" ? data.created : void 0;
@@ -181,7 +172,7 @@ function serializeArticle(article) {
   const front = { title: article.title, tags: article.tags };
   if (article.created) front.created = article.created;
   if (article.updated) front.updated = article.updated;
-  return matter.stringify(article.body, front, MATTER_OPTS);
+  return matter.stringify(article.body, front);
 }
 
 // src/articles.ts
@@ -300,7 +291,7 @@ import fs5 from "fs/promises";
 import path3 from "path";
 import { execFile } from "child_process";
 import { promisify } from "util";
-import { parse as parseYaml2, stringify as stringifyYaml2 } from "yaml";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 var execFileAsync = promisify(execFile);
 var REPO_CONFIG_FILE = "diffwiki.yaml";
 async function detectRepoName(cwd) {
@@ -314,7 +305,7 @@ async function detectRepoName(cwd) {
 async function readRepoConfig(cwd) {
   try {
     const raw = await fs5.readFile(path3.join(cwd, REPO_CONFIG_FILE), "utf8");
-    const parsed = parseYaml2(raw) ?? {};
+    const parsed = parseYaml(raw) ?? {};
     if (!parsed.path) return void 0;
     return {
       collection: parsed.collection ?? path3.basename(path3.resolve(cwd)),
@@ -345,7 +336,7 @@ async function initRepoWiki(opts) {
   }
   await fs5.mkdir(absWiki, { recursive: true });
   const config = { collection: name, path: wikiPath };
-  await fs5.writeFile(path3.join(cwd, REPO_CONFIG_FILE), stringifyYaml2(config), "utf8");
+  await fs5.writeFile(path3.join(cwd, REPO_CONFIG_FILE), stringifyYaml(config), "utf8");
   const entry = {
     name,
     type: "repo",
@@ -429,224 +420,6 @@ async function doctor() {
   }
   return out;
 }
-
-// src/browse.ts
-import fs8 from "fs/promises";
-import path5 from "path";
-var INDEX_RE = /^(index|readme)\.mdx?$/i;
-function buildArticleTree(relPaths) {
-  const root = {};
-  for (const raw of relPaths) {
-    const rel = raw.replace(/\\/g, "/").replace(/^\/+/, "");
-    if (!rel) continue;
-    const segs = rel.split("/");
-    let cur = root;
-    segs.forEach((seg, i) => {
-      if (i === segs.length - 1) {
-        if (!(seg in cur)) cur[seg] = null;
-      } else {
-        if (cur[seg] === null || !(seg in cur)) cur[seg] = {};
-        cur = cur[seg];
-      }
-    });
-  }
-  const stripExt = (f) => f.replace(/\.(mdx?)$/, "");
-  const walk = (trie, parents) => {
-    const entries = Object.entries(trie);
-    const branches = entries.filter(([, v]) => v !== null);
-    const leaves = entries.filter(([, v]) => v === null).map(([k]) => k).filter((f) => !INDEX_RE.test(f));
-    branches.sort(([a], [b]) => a.toLowerCase().localeCompare(b.toLowerCase()));
-    leaves.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
-    const branchNodes = branches.map(([seg, sub]) => ({
-      name: seg,
-      title: seg,
-      // Folders are navigable to their index page (an authored index.md/README,
-      // else a generated listing).
-      slug: [...parents, seg].join("/"),
-      children: walk(sub, [...parents, seg])
-    }));
-    const leafNodes = leaves.map((file) => {
-      const nameNoExt = stripExt(file);
-      return { name: nameNoExt, title: nameNoExt, slug: [...parents, nameNoExt].join("/") };
-    });
-    return [...branchNodes, ...leafNodes];
-  };
-  return walk(root, []);
-}
-async function collectRelPaths(dir, rel = "") {
-  let dirents;
-  try {
-    dirents = await fs8.readdir(dir, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-  const out = [];
-  for (const d of dirents) {
-    if (d.name.startsWith(".")) continue;
-    const childRel = rel ? `${rel}/${d.name}` : d.name;
-    if (d.isDirectory()) {
-      out.push(...await collectRelPaths(path5.join(dir, d.name), childRel));
-    } else if (/\.(mdx?)$/.test(d.name)) {
-      out.push(childRel);
-    }
-  }
-  return out;
-}
-async function readdirSafe(dir) {
-  try {
-    return await fs8.readdir(dir);
-  } catch {
-    return [];
-  }
-}
-function pickIndexFile(names) {
-  const rank = (n) => {
-    const lower = n.toLowerCase();
-    const base = lower.startsWith("index") ? 0 : 1;
-    const ext = lower.endsWith(".mdx") ? 0 : 1;
-    return base * 2 + ext;
-  };
-  return names.filter((n) => INDEX_RE.test(n)).sort((a, b) => rank(a) - rank(b))[0];
-}
-async function cheapTitle(absPath) {
-  let handle;
-  try {
-    handle = await fs8.open(absPath, "r");
-    const buf = Buffer.alloc(512);
-    const { bytesRead } = await handle.read(buf, 0, 512, 0);
-    const snippet = buf.subarray(0, bytesRead).toString("utf8");
-    const m = snippet.match(/^---[\s\S]*?^title:\s*(.+)$/m);
-    if (m) return m[1].trim().replace(/^["']|["']$/g, "");
-  } catch {
-  } finally {
-    await handle?.close();
-  }
-  return void 0;
-}
-async function enrichTitles(nodes, collDir) {
-  return Promise.all(
-    nodes.map(async (node) => {
-      if (node.children) {
-        const children = await enrichTitles(node.children, collDir);
-        let title = node.title;
-        if (node.slug) {
-          const dir = path5.join(collDir, node.slug);
-          const idx = pickIndexFile(await readdirSafe(dir));
-          if (idx) title = await cheapTitle(path5.join(dir, idx)) ?? title;
-        }
-        return { ...node, title, children };
-      }
-      for (const ext of [".mdx", ".md"]) {
-        const title = await cheapTitle(path5.join(collDir, `${node.slug}${ext}`));
-        if (title) return { ...node, title };
-      }
-      return node;
-    })
-  );
-}
-async function listArticleTree(coll) {
-  const entry = await findCollection(coll);
-  if (!entry) throw new CollectionNotFoundError(coll);
-  const rels = await collectRelPaths(entry.path);
-  return enrichTitles(buildArticleTree(rels), path5.resolve(entry.path));
-}
-async function readArticle(coll, slug) {
-  const entry = await findCollection(coll);
-  if (!entry) throw new CollectionNotFoundError(coll);
-  const collDir = path5.resolve(entry.path);
-  const normalized = slug.replace(/\\/g, "/");
-  if (normalized.split("/").some((s) => s === "..")) {
-    throw new InvalidTargetError(slug, "path traversal detected");
-  }
-  const safeSlug = normalized.split("/").filter((s) => s !== "" && s !== ".").join("/");
-  const inJail = (p) => p === collDir || p.startsWith(collDir + path5.sep);
-  let abs;
-  for (const rel of safeSlug ? [`${safeSlug}.mdx`, `${safeSlug}.md`] : []) {
-    const candidate = path5.resolve(collDir, rel);
-    if (!inJail(candidate)) throw new InvalidTargetError(slug, "path traversal detected");
-    try {
-      await fs8.access(candidate);
-      abs = candidate;
-      break;
-    } catch {
-    }
-  }
-  if (!abs) {
-    const dir = path5.resolve(collDir, safeSlug);
-    if (inJail(dir)) {
-      const idx = pickIndexFile(await readdirSafe(dir));
-      if (idx) abs = path5.join(dir, idx);
-    }
-  }
-  if (!abs) throw new ArticleNotFoundError(`${coll}/${safeSlug}`);
-  const parsed = parseArticle(await fs8.readFile(abs, "utf8"));
-  const title = parsed.title?.trim() || (safeSlug ? safeSlug.split("/").pop() ?? safeSlug : coll);
-  return { coll, slug: safeSlug, title, tags: parsed.tags, body: parsed.body, path: abs };
-}
-
-// src/render.ts
-import { unified } from "unified";
-import remarkParse from "remark-parse";
-import remarkGfm from "remark-gfm";
-import remarkRehype from "remark-rehype";
-import rehypeSlug from "rehype-slug";
-import rehypeShiki from "@shikijs/rehype";
-import rehypeStringify from "rehype-stringify";
-import { visit, SKIP } from "unist-util-visit";
-import { toString as hastToString } from "hast-util-to-string";
-var LANG_ALIASES = {
-  "c#": "csharp",
-  cs: "csharp",
-  "c++": "cpp",
-  cxx: "cpp",
-  hs: "haskell",
-  ex: "elixir"
-};
-function rehypeCollectToc(toc) {
-  return (tree) => {
-    visit(tree, "element", (node) => {
-      if (node.tagName !== "h2" && node.tagName !== "h3") return;
-      const id = node.properties?.id;
-      if (!id) return;
-      toc.push({ slug: String(id), text: hastToString(node), depth: node.tagName === "h2" ? 2 : 3 });
-    });
-  };
-}
-function rehypeStripLeadingH1() {
-  return (tree) => {
-    let removed = false;
-    visit(tree, "element", (node, index, parent) => {
-      if (!removed && node.tagName === "h1" && parent && index != null) {
-        parent.children.splice(index, 1);
-        removed = true;
-        return [SKIP, index];
-      }
-    });
-  };
-}
-function rehypeMarkMermaid() {
-  return (tree) => {
-    visit(tree, "element", (node) => {
-      if (node.tagName !== "pre") return;
-      const code = node.children.find((c) => c.type === "element" && c.tagName === "code");
-      const cls = code?.properties?.className ?? [];
-      if (!code || !cls.includes("language-mermaid")) return;
-      const source = hastToString(code);
-      node.properties = { className: ["mermaid"] };
-      node.children = [{ type: "text", value: source }];
-    });
-  };
-}
-async function renderArticle(body) {
-  const toc = [];
-  const file = await unified().use(remarkParse).use(remarkGfm).use(remarkRehype).use(rehypeSlug).use(rehypeCollectToc, toc).use(rehypeStripLeadingH1).use(rehypeMarkMermaid).use(rehypeShiki, {
-    themes: { light: "github-light", dark: "github-dark" },
-    defaultColor: false,
-    langAlias: LANG_ALIASES,
-    fallbackLanguage: "plaintext"
-  }).use(rehypeStringify).process(body);
-  return { html: String(file), toc };
-}
 export {
   ArticleNotFoundError,
   CollectionExistsError,
@@ -656,7 +429,6 @@ export {
   NoDefaultCollectionError,
   REPO_CONFIG_FILE,
   addTags,
-  buildArticleTree,
   collectionDir,
   collectionsDir,
   configPath,
@@ -666,13 +438,11 @@ export {
   findCollection,
   getConfigValue,
   initRepoWiki,
-  listArticleTree,
   listCollections,
   parseAddTarget,
   parseArticle,
   parsePathTarget,
   query,
-  readArticle,
   readConfig,
   readRegistry,
   readRepoConfig,
@@ -681,7 +451,6 @@ export {
   removeArticle,
   removeCollection,
   removeTags,
-  renderArticle,
   resolveHome,
   serializeArticle,
   setConfigValue,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffwiki-core",
-  "version": "0.3.0-rc.202607220233.d11ed2a",
+  "version": "0.3.0",
   "description": "Core configuration, registry, and article management for diffwiki",
   "license": "MIT",
   "type": "module",
@@ -21,20 +21,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@shikijs/rehype": "^3.0.0",
     "gray-matter": "^4.0.3",
-    "hast-util-to-string": "^3.0.0",
-    "rehype-slug": "^6.0.0",
-    "rehype-stringify": "^10.0.0",
-    "remark-gfm": "^4.0.0",
-    "remark-parse": "^11.0.0",
-    "remark-rehype": "^11.0.0",
-    "unified": "^11.0.0",
-    "unist-util-visit": "^5.0.0",
     "yaml": "^2.5.0"
   },
   "devDependencies": {
-    "@types/hast": "^3.0.5",
     "@types/node": "^22.0.0"
   },
   "scripts": {