@eqtylab/docs 0.3.0

package/dist/loaders.js

@@ -0,0 +1,85 @@
+import { groupSchema, docsSchema } from './chunk-IWKZQ4CW.js';
+import { readFile } from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { defineCollection } from 'astro:content';
+import { glob } from 'astro/loaders';
+import { globSync } from 'tinyglobby';
+import { parse } from 'yaml';
+
+var GROUP_GLOB = "**/_group.{yaml,yml,json}";
+var ROOT_GROUP_ID = "~root";
+function docsLoader(options = {}) {
+  const base = options.base ?? "content/docs";
+  return glob({
+    base: `./src/${base}`,
+    pattern: ["**/*.mdx", "!**/_*", "!**/_*/**"]
+  });
+}
+function groupsLoader(options = {}) {
+  const base = options.base ?? "content/docs";
+  return {
+    name: "@eqtylab/docs:groups",
+    async load({ store, parseData, generateDigest, watcher, logger, config }) {
+      const rootUrl = new URL(`./${base}/`, config.srcDir);
+      const rootDir = fileURLToPath(rootUrl);
+      const files = globSync([GROUP_GLOB], { cwd: rootDir, absolute: false });
+      const untouched = new Set(store.keys());
+      for (const rel of files) {
+        const dir = path.posix.dirname(rel.split(path.sep).join("/"));
+        const id = dir === "." ? ROOT_GROUP_ID : dir;
+        const abs = path.join(rootDir, rel);
+        let text;
+        try {
+          text = await readFile(abs, "utf8");
+        } catch (err) {
+          logger.warn(`Could not read ${rel}: ${err.message}`);
+          continue;
+        }
+        const digest = generateDigest(text);
+        if (store.get(id)?.digest === digest) {
+          untouched.delete(id);
+          continue;
+        }
+        let raw;
+        try {
+          raw = rel.endsWith(".json") ? JSON.parse(text) : parse(text);
+        } catch (err) {
+          throw new Error(`[@eqtylab/docs] Could not parse ${rel}: ${err.message}`);
+        }
+        const data = await parseData({
+          id,
+          data: raw ?? {},
+          filePath: path.relative(fileURLToPath(config.root), abs)
+        });
+        store.set({
+          id,
+          data,
+          digest,
+          filePath: path.relative(fileURLToPath(config.root), abs)
+        });
+        untouched.delete(id);
+      }
+      for (const id of untouched) store.delete(id);
+      if (watcher) {
+        watcher.add(rootDir);
+      }
+    }
+  };
+}
+function docsCollections(options = {}) {
+  return {
+    docs: defineCollection({
+      loader: docsLoader(options),
+      schema: docsSchema()
+    }),
+    docsGroups: defineCollection({
+      loader: groupsLoader(options),
+      schema: groupSchema()
+    })
+  };
+}
+
+export { ROOT_GROUP_ID, docsCollections, docsLoader, groupsLoader };
+//# sourceMappingURL=loaders.js.map
+//# sourceMappingURL=loaders.js.map

package/dist/loaders.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loaders.ts"],"names":["parseYaml"],"mappings":"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","file":"loaders.js","sourcesContent":["/** Astro cannot inject collections from an integration, so these are imported from the consumer's `content.config.ts`. */\nimport { readFile } from 'node:fs/promises';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { defineCollection } from 'astro:content';\nimport { glob } from 'astro/loaders';\nimport type { Loader, LoaderContext } from 'astro/loaders';\nimport { globSync } from 'tinyglobby';\nimport { parse as parseYaml } from 'yaml';\n\nimport { docsSchema, groupSchema } from './schema.ts';\n\nconst GROUP_GLOB = '**/_group.{yaml,yml,json}';\n\n/** Sentinel id for the content root's own `_group.yaml`; '' is not a valid store key. */\nexport const ROOT_GROUP_ID = '~root';\n\n/**\n * MDX only; stray `.md` files fail in `assertMdxOnly`. The `_*` negation is\n * required: the glob loader has no underscore skipping, so `_group.yaml` would become a page.\n */\nexport function docsLoader(options: { base?: string } = {}): Loader {\n  const base = options.base ?? 'content/docs';\n  return glob({\n    base: `./src/${base}`,\n    pattern: ['**/*.mdx', '!**/_*', '!**/_*/**'],\n  });\n}\n\nexport function groupsLoader(options: { base?: string } = {}): Loader {\n  const base = options.base ?? 'content/docs';\n\n  return {\n    name: '@eqtylab/docs:groups',\n\n    async load({ store, parseData, generateDigest, watcher, logger, config }: LoaderContext) {\n      const rootUrl = new URL(`./${base}/`, config.srcDir);\n      const rootDir = fileURLToPath(rootUrl);\n\n      const files = globSync([GROUP_GLOB], { cwd: rootDir, absolute: false });\n      const untouched = new Set(store.keys());\n\n      for (const rel of files) {\n        const dir = path.posix.dirname(rel.split(path.sep).join('/'));\n        const id = dir === '.' ? ROOT_GROUP_ID : dir;\n        const abs = path.join(rootDir, rel);\n\n        let text: string;\n        try {\n          text = await readFile(abs, 'utf8');\n        } catch (err) {\n          logger.warn(`Could not read ${rel}: ${(err as Error).message}`);\n          continue;\n        }\n\n        const digest = generateDigest(text);\n        if (store.get(id)?.digest === digest) {\n          untouched.delete(id);\n          continue;\n        }\n\n        let raw: unknown;\n        try {\n          raw = rel.endsWith('.json') ? JSON.parse(text) : parseYaml(text);\n        } catch (err) {\n          throw new Error(`[@eqtylab/docs] Could not parse ${rel}: ${(err as Error).message}`);\n        }\n\n        const data = await parseData({\n          id,\n          data: (raw ?? {}) as Record<string, unknown>,\n          filePath: path.relative(fileURLToPath(config.root), abs),\n        });\n\n        store.set({\n          id,\n          data,\n          digest,\n          filePath: path.relative(fileURLToPath(config.root), abs),\n        });\n        untouched.delete(id);\n      }\n\n      // Anything left was deleted on disk.\n      for (const id of untouched) store.delete(id);\n\n      if (watcher) {\n        watcher.add(rootDir);\n      }\n    },\n  };\n}\n\n/** Both collections, ready to spread. */\nexport function docsCollections(options: { base?: string } = {}) {\n  return {\n    docs: defineCollection({\n      loader: docsLoader(options),\n      schema: docsSchema(),\n    }),\n    docsGroups: defineCollection({\n      loader: groupsLoader(options),\n      schema: groupSchema(),\n    }),\n  };\n}\n"]}

package/dist/nav.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Pure nav-tree construction. Keep it free of fs and `astro:*` imports so it
+ * runs in Node and unit tests; prev/next and breadcrumbs derive from this tree.
+ */
+import { type PathContext } from './paths.ts';
+import type { DocsBadge, DocsNavEntry, NavNode, TocNode } from './types.ts';
+export type SortMode = 'alpha' | 'filename' | 'manual';
+export interface GroupConfig {
+    label?: string;
+    icon?: string;
+    order: string[];
+    sort?: SortMode;
+    collapsed?: boolean;
+    hidden: boolean;
+    badge?: DocsBadge;
+    links: Array<{
+        label: string;
+        href: string;
+        external?: boolean;
+        icon?: string;
+        badge?: DocsBadge;
+        attrs: Record<string, string | number | boolean>;
+    }>;
+}
+export interface BuildNavOptions {
+    entries: DocsNavEntry[];
+    /** Keyed by directory relative to the content root; '' is the root group. */
+    groups: Map<string, GroupConfig>;
+    /** `Astro.url.pathname`. */
+    currentPath: string;
+    paths: PathContext;
+    defaultCollapsed: boolean;
+    defaultSort: SortMode;
+    /** Appended after folder-derived nodes. Plugin-contributed sections land here. */
+    extra?: NavNode[];
+    onWarn?: (message: string) => void;
+}
+/** "getting-started" -> "Getting Started" */
+export declare function titleCase(slug: string): string;
+export declare function buildNavTree(options: BuildNavOptions): NavNode[];
+/** Depth-first list of internal, linkable nodes. Drives prev/next. */
+export declare function flattenNav(tree: NavNode[]): NavNode[];
+export declare function prevNextFor(tree: NavNode[], currentPath: string): {
+    prev?: NavNode;
+    next?: NavNode;
+};
+/** Ancestor chain from the root down to the current page. */
+export declare function breadcrumbsFor(tree: NavNode[], currentPath: string): NavNode[];
+/** Nest a flat heading list into a tree, clamped to [minLevel, maxLevel]. */
+export declare function buildTocTree(headings: Array<{
+    depth: number;
+    slug: string;
+    text: string;
+}>, { minLevel, maxLevel }?: {
+    minLevel?: number;
+    maxLevel?: number;
+}): TocNode[];

package/dist/nav.js

@@ -0,0 +1,222 @@
+import { isActive, docsHref, isAncestor } from './chunk-VJN3HXKM.js';
+
+// src/nav.ts
+function titleCase(slug) {
+  return slug.split(/[-_]/).filter(Boolean).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+function normalizeOrderToken(token) {
+  return token.trim().replace(/\/+$/, "").replace(/\.(md|mdx)$/i, "");
+}
+function byLocale(a, b) {
+  return a.localeCompare(b, void 0, { numeric: true, sensitivity: "base" });
+}
+function classify(entry) {
+  const id = entry.id;
+  const segments = id.split("/").filter(Boolean);
+  const fileBase = entry.filePath ? (entry.filePath.split("/").pop() ?? "").replace(/\.(md|mdx)$/i, "") : void 0;
+  const isIndex = fileBase === "index" || id === "index";
+  if (isIndex) {
+    const dir = id === "index" ? "" : segments.join("/");
+    return { entry, dir, name: segments.at(-1) ?? "", isIndex: true };
+  }
+  return {
+    entry,
+    dir: segments.slice(0, -1).join("/"),
+    name: segments.at(-1) ?? "",
+    isIndex: false
+  };
+}
+function ancestorsOf(dir) {
+  if (!dir) return [];
+  const parts = dir.split("/");
+  const out = [];
+  for (let i = 1; i <= parts.length; i++) out.push(parts.slice(0, i).join("/"));
+  return out;
+}
+function buildNavTree(options) {
+  const {
+    entries,
+    groups,
+    currentPath,
+    paths,
+    defaultCollapsed,
+    defaultSort,
+    extra = [],
+    onWarn
+  } = options;
+  const visible = entries.filter((e) => !e.draft);
+  const classified = visible.map(classify);
+  const indexOf = /* @__PURE__ */ new Map();
+  const filesIn = /* @__PURE__ */ new Map();
+  for (const c of classified) {
+    if (c.isIndex) {
+      indexOf.set(c.dir, c);
+    } else {
+      const list = filesIn.get(c.dir);
+      if (list) list.push(c);
+      else filesIn.set(c.dir, [c]);
+    }
+  }
+  const dirs = /* @__PURE__ */ new Set([""]);
+  for (const key of [...filesIn.keys(), ...indexOf.keys(), ...groups.keys()]) {
+    dirs.add(key);
+    for (const ancestor of ancestorsOf(key)) dirs.add(ancestor);
+  }
+  dirs.delete("~root");
+  const childDirsOf = /* @__PURE__ */ new Map();
+  for (const dir of dirs) {
+    if (!dir) continue;
+    const parent = dir.split("/").slice(0, -1).join("/");
+    const list = childDirsOf.get(parent);
+    if (list) list.push(dir);
+    else childDirsOf.set(parent, [dir]);
+  }
+  const groupFor = (dir) => groups.get(dir === "" ? "~root" : dir) ?? groups.get(dir);
+  const building = /* @__PURE__ */ new Set();
+  function pageNode(c) {
+    const href = docsHref(c.entry.id, paths);
+    return {
+      kind: "page",
+      name: c.name,
+      label: c.entry.label,
+      href,
+      icon: c.entry.icon,
+      badge: c.entry.badge,
+      current: isActive(currentPath, href),
+      inPath: isActive(currentPath, href)
+    };
+  }
+  function groupNode(dir) {
+    if (building.has(dir)) return null;
+    building.add(dir);
+    try {
+      const cfg = groupFor(dir);
+      const index = indexOf.get(dir);
+      const sortMode = cfg?.sort ?? defaultSort;
+      const pages = (filesIn.get(dir) ?? []).filter((c) => !c.entry.hidden).map(pageNode);
+      const subgroups = (childDirsOf.get(dir) ?? []).map(groupNode).filter((n) => n !== null);
+      const children = orderChildren([...pages, ...subgroups], cfg, sortMode, dir, onWarn);
+      for (const link of cfg?.links ?? []) {
+        children.push({
+          kind: "link",
+          name: link.label,
+          label: link.label,
+          href: link.href,
+          icon: link.icon,
+          badge: link.badge,
+          external: link.external,
+          attrs: link.attrs
+        });
+      }
+      if (children.length === 0 && !index) return null;
+      if (cfg?.hidden) return null;
+      const href = index ? docsHref(index.entry.id, paths) : void 0;
+      const label = cfg?.label ?? index?.entry.label ?? titleCase(dir.split("/").pop() ?? "");
+      const inPath = (href ? isAncestor(currentPath, href) : false) || children.some((c) => c.inPath);
+      return {
+        kind: "group",
+        name: dir.split("/").pop() ?? "",
+        label,
+        href,
+        icon: cfg?.icon ?? index?.entry.icon,
+        badge: cfg?.badge ?? index?.entry.badge,
+        current: href ? isActive(currentPath, href) : false,
+        inPath,
+        // Containing the current page wins over `collapsed: true`.
+        open: inPath || !(cfg?.collapsed ?? defaultCollapsed),
+        children
+      };
+    } finally {
+      building.delete(dir);
+    }
+  }
+  const root = groupNode("");
+  const rootChildren = root?.children ?? [];
+  return [...rootChildren, ...extra];
+}
+function orderChildren(children, cfg, sortMode, dir, onWarn) {
+  const byName = /* @__PURE__ */ new Map();
+  for (const child of children) {
+    if (!byName.has(child.name)) byName.set(child.name, child);
+  }
+  const taken = /* @__PURE__ */ new Set();
+  const ordered = [];
+  for (const token of cfg?.order ?? []) {
+    const key = normalizeOrderToken(token);
+    const hit = byName.get(key);
+    if (!hit) {
+      onWarn?.(
+        `_group.yaml in "${dir || "<root>"}": order lists "${token}", but no child is named "${key}". Available: ${[...byName.keys()].join(", ") || "(none)"}`
+      );
+      continue;
+    }
+    if (!taken.has(hit)) {
+      taken.add(hit);
+      ordered.push(hit);
+    }
+  }
+  let rest = children.filter((c) => !taken.has(c));
+  if (sortMode === "manual") {
+    rest = [];
+  } else if (sortMode === "filename") {
+    rest.sort((a, b) => byLocale(a.name, b.name));
+  } else {
+    rest.sort((a, b) => byLocale(a.label, b.label) || byLocale(a.name, b.name));
+  }
+  return [...ordered, ...rest];
+}
+function flattenNav(tree) {
+  const out = [];
+  const walk = (nodes) => {
+    for (const node of nodes) {
+      if (node.href && node.kind !== "link") out.push(node);
+      if (node.children?.length) walk(node.children);
+    }
+  };
+  walk(tree);
+  return out;
+}
+function prevNextFor(tree, currentPath) {
+  const flat = flattenNav(tree);
+  const i = flat.findIndex((n) => n.href && isActive(currentPath, n.href));
+  if (i === -1) return {};
+  return { prev: flat[i - 1], next: flat[i + 1] };
+}
+function breadcrumbsFor(tree, currentPath) {
+  const trail = [];
+  const walk = (nodes) => {
+    for (const node of nodes) {
+      const hit = node.href ? isActive(currentPath, node.href) : false;
+      if (hit) {
+        trail.push(node);
+        return true;
+      }
+      if (node.children?.length) {
+        trail.push(node);
+        if (walk(node.children)) return true;
+        trail.pop();
+      }
+    }
+    return false;
+  };
+  walk(tree);
+  return trail;
+}
+function buildTocTree(headings, { minLevel = 2, maxLevel = 3 } = {}) {
+  const roots = [];
+  const stack = [];
+  for (const h of headings) {
+    if (h.depth < minLevel || h.depth > maxLevel) continue;
+    const node = { depth: h.depth, slug: h.slug, text: h.text, children: [] };
+    while (stack.length && stack.at(-1).depth >= node.depth) stack.pop();
+    const parent = stack.at(-1);
+    if (parent) parent.children.push(node);
+    else roots.push(node);
+    stack.push(node);
+  }
+  return roots;
+}
+
+export { breadcrumbsFor, buildNavTree, buildTocTree, flattenNav, prevNextFor, titleCase };
+//# sourceMappingURL=nav.js.map
+//# sourceMappingURL=nav.js.map

package/dist/nav.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nav.ts"],"names":[],"mappings":";;;AA0CO,SAAS,UAAU,IAAA,EAAsB;AAC9C,EAAA,OAAO,IAAA,CACJ,MAAM,MAAM,CAAA,CACZ,OAAO,OAAO,CAAA,CACd,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,CAAC,CAAA,CAAE,aAAY,GAAI,CAAA,CAAE,MAAM,CAAC,CAAC,CAAA,CACjD,IAAA,CAAK,GAAG,CAAA;AACb;AAGA,SAAS,oBAAoB,KAAA,EAAuB;AAClD,EAAA,OAAO,KAAA,CACJ,MAAK,CACL,OAAA,CAAQ,QAAQ,EAAE,CAAA,CAClB,OAAA,CAAQ,cAAA,EAAgB,EAAE,CAAA;AAC/B;AAEA,SAAS,QAAA,CAAS,GAAW,CAAA,EAAmB;AAC9C,EAAA,OAAO,CAAA,CAAE,cAAc,CAAA,EAAG,MAAA,EAAW,EAAE,OAAA,EAAS,IAAA,EAAM,WAAA,EAAa,MAAA,EAAQ,CAAA;AAC7E;AAaA,SAAS,SAAS,KAAA,EAAiC;AACjD,EAAA,MAAM,KAAK,KAAA,CAAM,EAAA;AACjB,EAAA,MAAM,WAAW,EAAA,CAAG,KAAA,CAAM,GAAG,CAAA,CAAE,OAAO,OAAO,CAAA;AAC7C,EAAA,MAAM,QAAA,GAAW,KAAA,CAAM,QAAA,GAAA,CAClB,KAAA,CAAM,SAAS,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,EAAI,IAAK,EAAA,EAAI,OAAA,CAAQ,cAAA,EAAgB,EAAE,CAAA,GAClE,MAAA;AACJ,EAAA,MAAM,OAAA,GAAU,QAAA,KAAa,OAAA,IAAW,EAAA,KAAO,OAAA;AAE/C,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,MAAM,MAAM,EAAA,KAAO,OAAA,GAAU,EAAA,GAAK,QAAA,CAAS,KAAK,GAAG,CAAA;AACnD,IAAA,OAAO,EAAE,KAAA,EAAO,GAAA,EAAK,IAAA,EAAM,QAAA,CAAS,GAAG,EAAE,CAAA,IAAK,EAAA,EAAI,OAAA,EAAS,IAAA,EAAK;AAAA,EAClE;AACA,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,KAAK,QAAA,CAAS,KAAA,CAAM,GAAG,EAAE,CAAA,CAAE,KAAK,GAAG,CAAA;AAAA,IACnC,IAAA,EAAM,QAAA,CAAS,EAAA,CAAG,EAAE,CAAA,IAAK,EAAA;AAAA,IACzB,OAAA,EAAS;AAAA,GACX;AACF;AAEA,SAAS,YAAY,GAAA,EAAuB;AAC1C,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAClB,EAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA;AAC3B,EAAA,MAAM,MAAgB,EAAC;AACvB,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,IAAK,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK,GAAA,CAAI,IAAA,CAAK,KAAA,CAAM,MAAM,CAAA,EAAG,CAAC,CAAA,CAAE,IAAA,CAAK,GAAG,CAAC,CAAA;AAC5E,EAAA,OAAO,GAAA;AACT;AAEO,SAAS,aAAa,OAAA,EAAqC;AAChE,EAAA,MAAM;AAAA,IACJ,OAAA;AAAA,IACA,MAAA;AAAA,IACA,WAAA;AAAA,IACA,KAAA;AAAA,IACA,gBAAA;AAAA,IACA,WAAA;AAAA,IACA,QAAQ,EAAC;AAAA,IACT;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,UAAU,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,EAAE,KAAK,CAAA;AAC9C,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,GAAA,CAAI,QAAQ,CAAA;AACvC,EAAA,MAAM,OAAA,uBAAc,GAAA,EAAwB;AAC5C,EAAA,MAAM,OAAA,uBAAc,GAAA,EAA0B;AAE9C,EAAA,KAAA,MAAW,KAAK,UAAA,EAAY;AAC1B,IAAA,IAAI,EAAE,OAAA,EAAS;AACb,MAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,CAAE,GAAA,EAAK,CAAC,CAAA;AAAA,IACtB,CAAA,MAAO;AACL,MAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,GAAA,CAAI,CAAA,CAAE,GAAG,CAAA;AAC9B,MAAA,IAAI,IAAA,EAAM,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA;AAAA,mBACR,GAAA,CAAI,CAAA,CAAE,GAAA,EAAK,CAAC,CAAC,CAAC,CAAA;AAAA,IAC7B;AAAA,EACF;AAEA,EAAA,MAAM,IAAA,mBAAO,IAAI,GAAA,CAAY,CAAC,EAAE,CAAC,CAAA;AACjC,EAAA,KAAA,MAAW,GAAA,IAAO,CAAC,GAAG,OAAA,CAAQ,MAAK,EAAG,GAAG,OAAA,CAAQ,IAAA,EAAK,EAAG,GAAG,MAAA,CAAO,IAAA,EAAM,CAAA,EAAG;AAC1E,IAAA,IAAA,CAAK,IAAI,GAAG,CAAA;AACZ,IAAA,KAAA,MAAW,YAAY,WAAA,CAAY,GAAG,CAAA,EAAG,IAAA,CAAK,IAAI,QAAQ,CAAA;AAAA,EAC5D;AACA,EAAA,IAAA,CAAK,OAAO,OAAO,CAAA;AAEnB,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAsB;AAC9C,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,IAAI,CAAC,GAAA,EAAK;AACV,IAAA,MAAM,MAAA,GAAS,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAAE,MAAM,CAAA,EAAG,EAAE,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AACnD,IAAA,MAAM,IAAA,GAAO,WAAA,CAAY,GAAA,CAAI,MAAM,CAAA;AACnC,IAAA,IAAI,IAAA,EAAM,IAAA,CAAK,IAAA,CAAK,GAAG,CAAA;AAAA,SAClB,WAAA,CAAY,GAAA,CAAI,MAAA,EAAQ,CAAC,GAAG,CAAC,CAAA;AAAA,EACpC;AAEA,EAAA,MAAM,QAAA,GAAW,CAAC,GAAA,KAChB,MAAA,CAAO,GAAA,CAAI,GAAA,KAAQ,EAAA,GAAK,OAAA,GAAU,GAAG,CAAA,IAAK,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA;AAE1D,EAAA,MAAM,QAAA,uBAAe,GAAA,EAAY;AAEjC,EAAA,SAAS,SAAS,CAAA,EAAwB;AACxC,IAAA,MAAM,IAAA,GAAO,QAAA,CAAS,CAAA,CAAE,KAAA,CAAM,IAAI,KAAK,CAAA;AACvC,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,MAAA;AAAA,MACN,MAAM,CAAA,CAAE,IAAA;AAAA,MACR,KAAA,EAAO,EAAE,KAAA,CAAM,KAAA;AAAA,MACf,IAAA;AAAA,MACA,IAAA,EAAM,EAAE,KAAA,CAAM,IAAA;AAAA,MACd,KAAA,EAAO,EAAE,KAAA,CAAM,KAAA;AAAA,MACf,OAAA,EAAS,QAAA,CAAS,WAAA,EAAa,IAAI,CAAA;AAAA,MACnC,MAAA,EAAQ,QAAA,CAAS,WAAA,EAAa,IAAI;AAAA,KACpC;AAAA,EACF;AAEA,EAAA,SAAS,UAAU,GAAA,EAA6B;AAC9C,IAAA,IAAI,QAAA,CAAS,GAAA,CAAI,GAAG,CAAA,EAAG,OAAO,IAAA;AAC9B,IAAA,QAAA,CAAS,IAAI,GAAG,CAAA;AAChB,IAAA,IAAI;AACF,MAAA,MAAM,GAAA,GAAM,SAAS,GAAG,CAAA;AACxB,MAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA;AAC7B,MAAA,MAAM,QAAA,GAAW,KAAK,IAAA,IAAQ,WAAA;AAE9B,MAAA,MAAM,SAAS,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA,IAAK,EAAC,EAAG,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,CAAA,CAAE,KAAA,CAAM,MAAM,CAAA,CAAE,IAAI,QAAQ,CAAA;AAClF,MAAA,MAAM,SAAA,GAAA,CAAa,WAAA,CAAY,GAAA,CAAI,GAAG,KAAK,EAAC,EACzC,GAAA,CAAI,SAAS,CAAA,CACb,MAAA,CAAO,CAAC,CAAA,KAAoB,MAAM,IAAI,CAAA;AAEzC,MAAA,MAAM,QAAA,GAAW,aAAA,CAAc,CAAC,GAAG,KAAA,EAAO,GAAG,SAAS,CAAA,EAAG,GAAA,EAAK,QAAA,EAAU,GAAA,EAAK,MAAM,CAAA;AAEnF,MAAA,KAAA,MAAW,IAAA,IAAQ,GAAA,EAAK,KAAA,IAAS,EAAC,EAAG;AACnC,QAAA,QAAA,CAAS,IAAA,CAAK;AAAA,UACZ,IAAA,EAAM,MAAA;AAAA,UACN,MAAM,IAAA,CAAK,KAAA;AAAA,UACX,OAAO,IAAA,CAAK,KAAA;AAAA,UACZ,MAAM,IAAA,CAAK,IAAA;AAAA,UACX,MAAM,IAAA,CAAK,IAAA;AAAA,UACX,OAAO,IAAA,CAAK,KAAA;AAAA,UACZ,UAAU,IAAA,CAAK,QAAA;AAAA,UACf,OAAO,IAAA,CAAK;AAAA,SACb,CAAA;AAAA,MACH;AAEA,MAAA,IAAI,QAAA,CAAS,MAAA,KAAW,CAAA,IAAK,CAAC,OAAO,OAAO,IAAA;AAC5C,MAAA,IAAI,GAAA,EAAK,QAAQ,OAAO,IAAA;AAExB,MAAA,MAAM,OAAO,KAAA,GAAQ,QAAA,CAAS,MAAM,KAAA,CAAM,EAAA,EAAI,KAAK,CAAA,GAAI,KAAA,CAAA;AACvD,MAAA,MAAM,KAAA,GAAQ,GAAA,EAAK,KAAA,IAAS,KAAA,EAAO,KAAA,CAAM,KAAA,IAAS,SAAA,CAAU,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,MAAS,EAAE,CAAA;AAEtF,MAAA,MAAM,MAAA,GAAA,CACH,IAAA,GAAO,UAAA,CAAW,WAAA,EAAa,IAAI,CAAA,GAAI,KAAA,KAAU,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,CAAA;AAEjF,MAAA,OAAO;AAAA,QACL,IAAA,EAAM,OAAA;AAAA,QACN,MAAM,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAAE,KAAI,IAAK,EAAA;AAAA,QAC9B,KAAA;AAAA,QACA,IAAA;AAAA,QACA,IAAA,EAAM,GAAA,EAAK,IAAA,IAAQ,KAAA,EAAO,KAAA,CAAM,IAAA;AAAA,QAChC,KAAA,EAAO,GAAA,EAAK,KAAA,IAAS,KAAA,EAAO,KAAA,CAAM,KAAA;AAAA,QAClC,OAAA,EAAS,IAAA,GAAO,QAAA,CAAS,WAAA,EAAa,IAAI,CAAA,GAAI,KAAA;AAAA,QAC9C,MAAA;AAAA;AAAA,QAEA,IAAA,EAAM,MAAA,IAAU,EAAE,GAAA,EAAK,SAAA,IAAa,gBAAA,CAAA;AAAA,QACpC;AAAA,OACF;AAAA,IACF,CAAA,SAAE;AACA,MAAA,QAAA,CAAS,OAAO,GAAG,CAAA;AAAA,IACrB;AAAA,EACF;AAEA,EAAA,MAAM,IAAA,GAAO,UAAU,EAAE,CAAA;AACzB,EAAA,MAAM,YAAA,GAAe,IAAA,EAAM,QAAA,IAAY,EAAC;AACxC,EAAA,OAAO,CAAC,GAAG,YAAA,EAAc,GAAG,KAAK,CAAA;AACnC;AAEA,SAAS,aAAA,CACP,QAAA,EACA,GAAA,EACA,QAAA,EACA,KACA,MAAA,EACW;AACX,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAqB;AACxC,EAAA,KAAA,MAAW,SAAS,QAAA,EAAU;AAC5B,IAAA,IAAI,CAAC,MAAA,CAAO,GAAA,CAAI,KAAA,CAAM,IAAI,GAAG,MAAA,CAAO,GAAA,CAAI,KAAA,CAAM,IAAA,EAAM,KAAK,CAAA;AAAA,EAC3D;AAEA,EAAA,MAAM,KAAA,uBAAY,GAAA,EAAa;AAC/B,EAAA,MAAM,UAAqB,EAAC;AAE5B,EAAA,KAAA,MAAW,KAAA,IAAS,GAAA,EAAK,KAAA,IAAS,EAAC,EAAG;AACpC,IAAA,MAAM,GAAA,GAAM,oBAAoB,KAAK,CAAA;AACrC,IAAA,MAAM,GAAA,GAAM,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA;AAC1B,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,MAAA;AAAA,QACE,mBAAmB,GAAA,IAAO,QAAQ,CAAA,gBAAA,EAAmB,KAAK,6BAA6B,GAAG,CAAA,cAAA,EAC1E,CAAC,GAAG,OAAO,IAAA,EAAM,EAAE,IAAA,CAAK,IAAI,KAAK,QAAQ,CAAA;AAAA,OAC3D;AACA,MAAA;AAAA,IACF;AACA,IAAA,IAAI,CAAC,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA,EAAG;AACnB,MAAA,KAAA,CAAM,IAAI,GAAG,CAAA;AACb,MAAA,OAAA,CAAQ,KAAK,GAAG,CAAA;AAAA,IAClB;AAAA,EACF;AAEA,EAAA,IAAI,IAAA,GAAO,SAAS,MAAA,CAAO,CAAC,MAAM,CAAC,KAAA,CAAM,GAAA,CAAI,CAAC,CAAC,CAAA;AAE/C,EAAA,IAAI,aAAa,QAAA,EAAU;AACzB,IAAA,IAAA,GAAO,EAAC;AAAA,EACV,CAAA,MAAA,IAAW,aAAa,UAAA,EAAY;AAClC,IAAA,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,SAAS,CAAA,CAAE,IAAA,EAAM,CAAA,CAAE,IAAI,CAAC,CAAA;AAAA,EAC9C,CAAA,MAAO;AACL,IAAA,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,SAAS,CAAA,CAAE,KAAA,EAAO,CAAA,CAAE,KAAK,KAAK,QAAA,CAAS,CAAA,CAAE,IAAA,EAAM,CAAA,CAAE,IAAI,CAAC,CAAA;AAAA,EAC5E;AAEA,EAAA,OAAO,CAAC,GAAG,OAAA,EAAS,GAAG,IAAI,CAAA;AAC7B;AAGO,SAAS,WAAW,IAAA,EAA4B;AACrD,EAAA,MAAM,MAAiB,EAAC;AACxB,EAAA,MAAM,IAAA,GAAO,CAAC,KAAA,KAAqB;AACjC,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,IAAI,KAAK,IAAA,IAAQ,IAAA,CAAK,SAAS,MAAA,EAAQ,GAAA,CAAI,KAAK,IAAI,CAAA;AACpD,MAAA,IAAI,IAAA,CAAK,QAAA,EAAU,MAAA,EAAQ,IAAA,CAAK,KAAK,QAAQ,CAAA;AAAA,IAC/C;AAAA,EACF,CAAA;AACA,EAAA,IAAA,CAAK,IAAI,CAAA;AACT,EAAA,OAAO,GAAA;AACT;AAEO,SAAS,WAAA,CACd,MACA,WAAA,EACoC;AACpC,EAAA,MAAM,IAAA,GAAO,WAAW,IAAI,CAAA;AAC5B,EAAA,MAAM,CAAA,GAAI,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA,KAAM,CAAA,CAAE,IAAA,IAAQ,QAAA,CAAS,WAAA,EAAa,CAAA,CAAE,IAAI,CAAC,CAAA;AACvE,EAAA,IAAI,CAAA,KAAM,EAAA,EAAI,OAAO,EAAC;AACtB,EAAA,OAAO,EAAE,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,CAAC,GAAG,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,CAAC,CAAA,EAAE;AAChD;AAGO,SAAS,cAAA,CAAe,MAAiB,WAAA,EAAgC;AAC9E,EAAA,MAAM,QAAmB,EAAC;AAC1B,EAAA,MAAM,IAAA,GAAO,CAAC,KAAA,KAA8B;AAC1C,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,MAAM,MAAM,IAAA,CAAK,IAAA,GAAO,SAAS,WAAA,EAAa,IAAA,CAAK,IAAI,CAAA,GAAI,KAAA;AAC3D,MAAA,IAAI,GAAA,EAAK;AACP,QAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AACf,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,IAAI,IAAA,CAAK,UAAU,MAAA,EAAQ;AACzB,QAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AACf,QAAA,IAAI,IAAA,CAAK,IAAA,CAAK,QAAQ,CAAA,EAAG,OAAO,IAAA;AAChC,QAAA,KAAA,CAAM,GAAA,EAAI;AAAA,MACZ;AAAA,IACF;AACA,IAAA,OAAO,KAAA;AAAA,EACT,CAAA;AACA,EAAA,IAAA,CAAK,IAAI,CAAA;AACT,EAAA,OAAO,KAAA;AACT;AAGO,SAAS,YAAA,CACd,UACA,EAAE,QAAA,GAAW,GAAG,QAAA,GAAW,CAAA,EAAE,GAA8C,EAAC,EACjE;AACX,EAAA,MAAM,QAAmB,EAAC;AAC1B,EAAA,MAAM,QAAmB,EAAC;AAE1B,EAAA,KAAA,MAAW,KAAK,QAAA,EAAU;AACxB,IAAA,IAAI,CAAA,CAAE,KAAA,GAAQ,QAAA,IAAY,CAAA,CAAE,QAAQ,QAAA,EAAU;AAC9C,IAAA,MAAM,IAAA,GAAgB,EAAE,KAAA,EAAO,CAAA,CAAE,KAAA,EAAO,IAAA,EAAM,CAAA,CAAE,IAAA,EAAM,IAAA,EAAM,CAAA,CAAE,IAAA,EAAM,QAAA,EAAU,EAAC,EAAE;AACjF,IAAA,OAAO,KAAA,CAAM,MAAA,IAAW,KAAA,CAAM,EAAA,CAAG,EAAE,EAAc,KAAA,IAAS,IAAA,CAAK,KAAA,EAAO,KAAA,CAAM,GAAA,EAAI;AAChF,IAAA,MAAM,MAAA,GAAS,KAAA,CAAM,EAAA,CAAG,EAAE,CAAA;AAC1B,IAAA,IAAI,MAAA,EAAQ,MAAA,CAAO,QAAA,CAAS,IAAA,CAAK,IAAI,CAAA;AAAA,SAChC,KAAA,CAAM,KAAK,IAAI,CAAA;AACpB,IAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AAAA,EACjB;AACA,EAAA,OAAO,KAAA;AACT","file":"nav.js","sourcesContent":["/**\n * Pure nav-tree construction. Keep it free of fs and `astro:*` imports so it\n * runs in Node and unit tests; prev/next and breadcrumbs derive from this tree.\n */\nimport { docsHref, isActive, isAncestor, type PathContext } from './paths.ts';\nimport type { DocsBadge, DocsNavEntry, NavNode, TocNode } from './types.ts';\n\nexport type SortMode = 'alpha' | 'filename' | 'manual';\n\nexport interface GroupConfig {\n  label?: string;\n  icon?: string;\n  order: string[];\n  sort?: SortMode;\n  collapsed?: boolean;\n  hidden: boolean;\n  badge?: DocsBadge;\n  links: Array<{\n    label: string;\n    href: string;\n    external?: boolean;\n    icon?: string;\n    badge?: DocsBadge;\n    attrs: Record<string, string | number | boolean>;\n  }>;\n}\n\nexport interface BuildNavOptions {\n  entries: DocsNavEntry[];\n  /** Keyed by directory relative to the content root; '' is the root group. */\n  groups: Map<string, GroupConfig>;\n  /** `Astro.url.pathname`. */\n  currentPath: string;\n  paths: PathContext;\n  defaultCollapsed: boolean;\n  defaultSort: SortMode;\n  /** Appended after folder-derived nodes. Plugin-contributed sections land here. */\n  extra?: NavNode[];\n  onWarn?: (message: string) => void;\n}\n\n/** \"getting-started\" -> \"Getting Started\" */\nexport function titleCase(slug: string): string {\n  return slug\n    .split(/[-_]/)\n    .filter(Boolean)\n    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))\n    .join(' ');\n}\n\n/** Normalise an `order` token so 'foo', 'foo.mdx' and 'foo/' all mean the same child. */\nfunction normalizeOrderToken(token: string): string {\n  return token\n    .trim()\n    .replace(/\\/+$/, '')\n    .replace(/\\.(md|mdx)$/i, '');\n}\n\nfunction byLocale(a: string, b: string): number {\n  return a.localeCompare(b, undefined, { numeric: true, sensitivity: 'base' });\n}\n\ninterface Classified {\n  entry: DocsNavEntry;\n  dir: string;\n  name: string;\n  isIndex: boolean;\n}\n\n/**\n * `isIndex` must come from `filePath`: Astro strips `/index` from ids, so\n * `guides/index.mdx` and `guides.mdx` both arrive as \"guides\".\n */\nfunction classify(entry: DocsNavEntry): Classified {\n  const id = entry.id;\n  const segments = id.split('/').filter(Boolean);\n  const fileBase = entry.filePath\n    ? (entry.filePath.split('/').pop() ?? '').replace(/\\.(md|mdx)$/i, '')\n    : undefined;\n  const isIndex = fileBase === 'index' || id === 'index';\n\n  if (isIndex) {\n    const dir = id === 'index' ? '' : segments.join('/');\n    return { entry, dir, name: segments.at(-1) ?? '', isIndex: true };\n  }\n  return {\n    entry,\n    dir: segments.slice(0, -1).join('/'),\n    name: segments.at(-1) ?? '',\n    isIndex: false,\n  };\n}\n\nfunction ancestorsOf(dir: string): string[] {\n  if (!dir) return [];\n  const parts = dir.split('/');\n  const out: string[] = [];\n  for (let i = 1; i <= parts.length; i++) out.push(parts.slice(0, i).join('/'));\n  return out;\n}\n\nexport function buildNavTree(options: BuildNavOptions): NavNode[] {\n  const {\n    entries,\n    groups,\n    currentPath,\n    paths,\n    defaultCollapsed,\n    defaultSort,\n    extra = [],\n    onWarn,\n  } = options;\n\n  const visible = entries.filter((e) => !e.draft);\n  const classified = visible.map(classify);\n  const indexOf = new Map<string, Classified>();\n  const filesIn = new Map<string, Classified[]>();\n\n  for (const c of classified) {\n    if (c.isIndex) {\n      indexOf.set(c.dir, c);\n    } else {\n      const list = filesIn.get(c.dir);\n      if (list) list.push(c);\n      else filesIn.set(c.dir, [c]);\n    }\n  }\n\n  const dirs = new Set<string>(['']);\n  for (const key of [...filesIn.keys(), ...indexOf.keys(), ...groups.keys()]) {\n    dirs.add(key);\n    for (const ancestor of ancestorsOf(key)) dirs.add(ancestor);\n  }\n  dirs.delete('~root'); // groups-loader sentinel, never a real directory\n\n  const childDirsOf = new Map<string, string[]>();\n  for (const dir of dirs) {\n    if (!dir) continue;\n    const parent = dir.split('/').slice(0, -1).join('/');\n    const list = childDirsOf.get(parent);\n    if (list) list.push(dir);\n    else childDirsOf.set(parent, [dir]);\n  }\n\n  const groupFor = (dir: string): GroupConfig | undefined =>\n    groups.get(dir === '' ? '~root' : dir) ?? groups.get(dir);\n\n  const building = new Set<string>();\n\n  function pageNode(c: Classified): NavNode {\n    const href = docsHref(c.entry.id, paths);\n    return {\n      kind: 'page',\n      name: c.name,\n      label: c.entry.label,\n      href,\n      icon: c.entry.icon,\n      badge: c.entry.badge,\n      current: isActive(currentPath, href),\n      inPath: isActive(currentPath, href),\n    };\n  }\n\n  function groupNode(dir: string): NavNode | null {\n    if (building.has(dir)) return null;\n    building.add(dir);\n    try {\n      const cfg = groupFor(dir);\n      const index = indexOf.get(dir);\n      const sortMode = cfg?.sort ?? defaultSort;\n\n      const pages = (filesIn.get(dir) ?? []).filter((c) => !c.entry.hidden).map(pageNode);\n      const subgroups = (childDirsOf.get(dir) ?? [])\n        .map(groupNode)\n        .filter((n): n is NavNode => n !== null);\n\n      const children = orderChildren([...pages, ...subgroups], cfg, sortMode, dir, onWarn);\n\n      for (const link of cfg?.links ?? []) {\n        children.push({\n          kind: 'link',\n          name: link.label,\n          label: link.label,\n          href: link.href,\n          icon: link.icon,\n          badge: link.badge,\n          external: link.external,\n          attrs: link.attrs,\n        });\n      }\n\n      if (children.length === 0 && !index) return null;\n      if (cfg?.hidden) return null;\n\n      const href = index ? docsHref(index.entry.id, paths) : undefined;\n      const label = cfg?.label ?? index?.entry.label ?? titleCase(dir.split('/').pop() ?? '');\n\n      const inPath =\n        (href ? isAncestor(currentPath, href) : false) || children.some((c) => c.inPath);\n\n      return {\n        kind: 'group',\n        name: dir.split('/').pop() ?? '',\n        label,\n        href,\n        icon: cfg?.icon ?? index?.entry.icon,\n        badge: cfg?.badge ?? index?.entry.badge,\n        current: href ? isActive(currentPath, href) : false,\n        inPath,\n        // Containing the current page wins over `collapsed: true`.\n        open: inPath || !(cfg?.collapsed ?? defaultCollapsed),\n        children,\n      };\n    } finally {\n      building.delete(dir);\n    }\n  }\n\n  const root = groupNode('');\n  const rootChildren = root?.children ?? [];\n  return [...rootChildren, ...extra];\n}\n\nfunction orderChildren(\n  children: NavNode[],\n  cfg: GroupConfig | undefined,\n  sortMode: SortMode,\n  dir: string,\n  onWarn?: (message: string) => void\n): NavNode[] {\n  const byName = new Map<string, NavNode>();\n  for (const child of children) {\n    if (!byName.has(child.name)) byName.set(child.name, child);\n  }\n\n  const taken = new Set<NavNode>();\n  const ordered: NavNode[] = [];\n\n  for (const token of cfg?.order ?? []) {\n    const key = normalizeOrderToken(token);\n    const hit = byName.get(key);\n    if (!hit) {\n      onWarn?.(\n        `_group.yaml in \"${dir || '<root>'}\": order lists \"${token}\", but no child is named \"${key}\". ` +\n          `Available: ${[...byName.keys()].join(', ') || '(none)'}`\n      );\n      continue;\n    }\n    if (!taken.has(hit)) {\n      taken.add(hit);\n      ordered.push(hit);\n    }\n  }\n\n  let rest = children.filter((c) => !taken.has(c));\n\n  if (sortMode === 'manual') {\n    rest = [];\n  } else if (sortMode === 'filename') {\n    rest.sort((a, b) => byLocale(a.name, b.name));\n  } else {\n    rest.sort((a, b) => byLocale(a.label, b.label) || byLocale(a.name, b.name));\n  }\n\n  return [...ordered, ...rest];\n}\n\n/** Depth-first list of internal, linkable nodes. Drives prev/next. */\nexport function flattenNav(tree: NavNode[]): NavNode[] {\n  const out: NavNode[] = [];\n  const walk = (nodes: NavNode[]) => {\n    for (const node of nodes) {\n      if (node.href && node.kind !== 'link') out.push(node);\n      if (node.children?.length) walk(node.children);\n    }\n  };\n  walk(tree);\n  return out;\n}\n\nexport function prevNextFor(\n  tree: NavNode[],\n  currentPath: string\n): { prev?: NavNode; next?: NavNode } {\n  const flat = flattenNav(tree);\n  const i = flat.findIndex((n) => n.href && isActive(currentPath, n.href));\n  if (i === -1) return {};\n  return { prev: flat[i - 1], next: flat[i + 1] };\n}\n\n/** Ancestor chain from the root down to the current page. */\nexport function breadcrumbsFor(tree: NavNode[], currentPath: string): NavNode[] {\n  const trail: NavNode[] = [];\n  const walk = (nodes: NavNode[]): boolean => {\n    for (const node of nodes) {\n      const hit = node.href ? isActive(currentPath, node.href) : false;\n      if (hit) {\n        trail.push(node);\n        return true;\n      }\n      if (node.children?.length) {\n        trail.push(node);\n        if (walk(node.children)) return true;\n        trail.pop();\n      }\n    }\n    return false;\n  };\n  walk(tree);\n  return trail;\n}\n\n/** Nest a flat heading list into a tree, clamped to [minLevel, maxLevel]. */\nexport function buildTocTree(\n  headings: Array<{ depth: number; slug: string; text: string }>,\n  { minLevel = 2, maxLevel = 3 }: { minLevel?: number; maxLevel?: number } = {}\n): TocNode[] {\n  const roots: TocNode[] = [];\n  const stack: TocNode[] = [];\n\n  for (const h of headings) {\n    if (h.depth < minLevel || h.depth > maxLevel) continue;\n    const node: TocNode = { depth: h.depth, slug: h.slug, text: h.text, children: [] };\n    while (stack.length && (stack.at(-1) as TocNode).depth >= node.depth) stack.pop();\n    const parent = stack.at(-1);\n    if (parent) parent.children.push(node);\n    else roots.push(node);\n    stack.push(node);\n  }\n  return roots;\n}\n"]}

package/dist/paths.d.ts

@@ -0,0 +1,28 @@
+/** Every URL the framework emits goes through here; nothing else may concatenate a path. */
+/** Join path segments, collapsing duplicate slashes, always leading with one. */
+export declare function joinPath(...parts: Array<string | undefined | null>): string;
+/** True for anything we must not rewrite: protocol, protocol-relative, fragment, or query. */
+export declare function isExternalHref(href: string): boolean;
+export declare function ensureTrailingSlash(href: string): string;
+/** Astro gives the root `index.mdx` the id "index", not "". */
+export declare function idToPath(id: string): string;
+/** Trim trailing slashes for comparison. Keeps a bare "/" intact. */
+export declare function normalizePath(path: string): string;
+export interface PathContext {
+    /** Astro's `import.meta.env.BASE_URL`. Always has a leading slash. */
+    base: string;
+    /** Mounted-at prefix for docs pages, e.g. "docs". Usually empty. */
+    pathPrefix?: string;
+    /** Version segment for a pinned build, e.g. "v3.1". Empty for latest-at-root. */
+    versionPrefix?: string;
+}
+/** Prefix a site-absolute path with `base`. For assets: favicons, logos, og images. */
+export declare function withBase(path: string, ctx: PathContext): string;
+/** The public URL for a docs collection entry id. */
+export declare function docsHref(id: string, ctx: PathContext): string;
+/** Remove `base` (and version/path prefixes) from a pathname, yielding a docs-relative path. */
+export declare function stripBase(pathname: string, ctx: PathContext): string;
+/** Whether `target` is the page currently being viewed. Base-aware, slash-insensitive. */
+export declare function isActive(currentPathname: string, target: string): boolean;
+/** Whether `target` is the current page or an ancestor of it. Drives group expansion. */
+export declare function isAncestor(currentPathname: string, target: string): boolean;

package/dist/paths.js

@@ -0,0 +1,3 @@
+export { docsHref, ensureTrailingSlash, idToPath, isActive, isAncestor, isExternalHref, joinPath, normalizePath, stripBase, withBase } from './chunk-VJN3HXKM.js';
+//# sourceMappingURL=paths.js.map
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"paths.js"}

package/dist/runtime/chrome/GlobalSearch.module.css

@@ -0,0 +1,26 @@
+@reference '../styles/theme.css';
+
+/*
+ * All that is left here are the two rules that fight another package's styling. Neither
+ * can move inline: one has to outrank Equality's own dialog class at equal specificity,
+ * and the other styles an element this component never renders.
+ */
+
+/* Class doubled to beat Equality's centring, which sits at the same specificity.
+ * Never override `transform` here: the entrance animation uses it. */
+.dialog.dialog {
+  @apply p-0;
+  top: 10vh;
+  translate: -50% 0;
+}
+
+/**
+ * Two assumptions nothing enforces: `packages/ui` still generates an overlay class containing
+ * `dialog-overlay`, and Radix still renders that overlay as the dialog's previous sibling. Either
+ * changes and the blur silently disappears. `:has` keeps it off every other dialog on the site.
+ */
+:global([class*='dialog-overlay']):has(+ .dialog) {
+  @apply bg-background/25;
+  -webkit-backdrop-filter: blur(18px);
+  backdrop-filter: blur(6px);
+}