@dogsbay/format-topicmap 0.2.0-beta.101

package/dist/edit.js

@@ -0,0 +1,295 @@
+/**
+ * Pure structural transforms over a parsed TopicMap — the ONE edit path
+ * shared by the agent's `map-*` verbs (@dogsbay/commands) and the IDE's
+ * Structure panel (plans/topicmap-editor.md: "agent edits are validated
+ * identically to human edits and never touch YAML bytes directly").
+ *
+ * No I/O: the caller loads/serializes. Existence of a local href target is
+ * checked through an injected `exists` predicate (a workspace storage, the
+ * IDE's file index); when none is given the check is skipped and the
+ * caller owns the diagnostic.
+ *
+ * Entries are addressed by POINTER — a dotted index path like `0.2.1`
+ * (`""` is the root) — or, where unambiguous, by `href`/`navtitle`
+ * (`@x` forces name matching for a title that looks like a pointer).
+ *
+ * Every transform MUTATES the given map in place (callers hold a fresh
+ * parse) and returns `{ ok: true, … }` or `{ ok: false, code, message }` —
+ * a refusal leaves the map untouched.
+ */
+import { dirname, isExternalHref, joinPath, normalizePath } from "./paths.js";
+import { isTopicMapPath } from "./types.js";
+const refuse = (code, message, extra) => ({
+    ok: false,
+    code,
+    message,
+    ...(extra ? { extra } : {}),
+});
+export const parsePointer = (pointer) => {
+    const p = pointer.trim();
+    if (p === "" || p === "/")
+        return [];
+    if (!/^\d+(\.\d+)*$/.test(p))
+        return undefined;
+    return p.split(".").map(Number);
+};
+export const pointerOf = (path) => path.join(".");
+/** The `topics` array a pointer's PARENT owns, plus the index. Read-only: never creates arrays. */
+export const locate = (map, path) => {
+    if (path.length === 0)
+        return undefined;
+    let siblings = map.topics;
+    for (let depth = 0; depth < path.length - 1; depth++) {
+        const e = siblings[path[depth]];
+        if (!e?.topics)
+            return undefined;
+        siblings = e.topics;
+    }
+    const index = path[path.length - 1];
+    const entry = siblings[index];
+    return entry ? { siblings, index, entry } : undefined;
+};
+/** The container to insert INTO (root or an entry's topics, created on demand for the write path). */
+export const containerOf = (map, path) => {
+    if (path.length === 0)
+        return map.topics;
+    const found = locate(map, path);
+    if (!found)
+        return undefined;
+    found.entry.topics ??= [];
+    return found.entry.topics;
+};
+/** Pointer of an entry by IDENTITY (after a splice, indices may have shifted). */
+export const pathOfEntry = (map, target) => {
+    const walk = (entries, prefix) => {
+        for (let i = 0; i < entries.length; i++) {
+            const e = entries[i];
+            if (e === target)
+                return [...prefix, i];
+            if (e.topics) {
+                const hit = walk(e.topics, [...prefix, i]);
+                if (hit)
+                    return hit;
+            }
+        }
+        return undefined;
+    };
+    return walk(map.topics, []);
+};
+/** Workspace path an href points at (undefined for external / fragment-only). */
+export const hrefTarget = (mapFile, href) => {
+    if (isExternalHref(href) || href.startsWith("#"))
+        return undefined;
+    const bare = href.split("#")[0].trim();
+    // an empty href is not a file (it would "resolve" to the map's directory, which exists)
+    if (!bare)
+        return undefined;
+    if (bare.startsWith("/"))
+        return normalizePath(bare.slice(1));
+    return normalizePath(joinPath(dirname(mapFile), bare));
+};
+/** A local href that resolves to the map itself is a self-include, whatever the format flag says. */
+export const isSelfInclude = (mapFile, href) => hrefTarget(mapFile, href) === mapFile;
+/** All entries matching an href or navtitle. */
+export const findByHref = (map, href) => {
+    const hits = [];
+    const walk = (entries, prefix) => {
+        entries.forEach((e, i) => {
+            const path = [...prefix, i];
+            if (e.href === href || e.navtitle === href)
+                hits.push(path);
+            if (e.topics)
+                walk(e.topics, path);
+        });
+    };
+    walk(map.topics, []);
+    return hits;
+};
+/** Pointer, or unique href/navtitle (`@x` forces name matching), to a path. */
+export const resolveAddress = (map, at) => {
+    const byName = (name) => {
+        const hits = findByHref(map, name);
+        if (hits.length === 1)
+            return { ok: true, path: hits[0] };
+        if (hits.length === 0)
+            return refuse("map-entry-not-found", `no entry with href or navtitle "${name}"`);
+        return refuse("map-entry-ambiguous", `"${name}" matches ${hits.length} entries: ${hits.map(pointerOf).join(", ")}; use a pointer`);
+    };
+    if (at.startsWith("@"))
+        return byName(at.slice(1));
+    const asPointer = parsePointer(at);
+    if (asPointer !== undefined) {
+        if (asPointer.length && !locate(map, asPointer))
+            return refuse("map-pointer-missing", `no entry at pointer "${at}"`);
+        return { ok: true, path: asPointer };
+    }
+    return byName(at);
+};
+export const flattenTopicMap = (map) => {
+    const out = [];
+    const walk = (entries, prefix, depth) => {
+        entries.forEach((e, i) => {
+            const path = [...prefix, i];
+            out.push({
+                pointer: pointerOf(path),
+                depth,
+                ...(e.navtitle !== undefined ? { navtitle: e.navtitle } : {}),
+                ...(e.href !== undefined ? { href: e.href } : {}),
+                ...(e.format !== undefined ? { format: e.format } : {}),
+                ...(e.toc !== undefined ? { toc: e.toc } : {}),
+                ...(e.singlePage !== undefined ? { singlePage: e.singlePage } : {}),
+                children: e.topics?.length ?? 0,
+            });
+            if (e.topics)
+                walk(e.topics, path, depth + 1);
+        });
+    };
+    walk(map.topics, [], 0);
+    return out;
+};
+/** Refuse a self-include or (when `exists` is given) a dangling local href. */
+const checkHref = (mapFile, href, exists) => {
+    const target = hrefTarget(mapFile, href);
+    if (target === undefined)
+        return undefined;
+    if (isSelfInclude(mapFile, href))
+        return refuse("map-self-include", "a map cannot include itself");
+    if (exists && !exists(target))
+        return refuse("map-href-dangling", `${href} does not resolve to a workspace file (${target})`, { target });
+    return undefined;
+};
+export const addRef = (map, mapFile, input, exists) => {
+    const parent = resolveAddress(map, input.parent ?? "");
+    if (!parent.ok)
+        return parent;
+    const href = input.href?.trim() || undefined;
+    const navtitle = input.navtitle?.trim() || undefined;
+    if (!href && !navtitle)
+        return refuse("map-entry-empty", "an entry needs an href or a navtitle");
+    if (href) {
+        const bad = checkHref(mapFile, href, exists);
+        if (bad)
+            return bad;
+    }
+    const entry = {
+        ...(navtitle !== undefined ? { navtitle } : {}),
+        ...(href !== undefined ? { href } : {}),
+        ...(input.format !== undefined ? { format: input.format } : {}),
+        ...(input.toc !== undefined ? { toc: input.toc } : {}),
+        ...(input.singlePage !== undefined ? { singlePage: input.singlePage } : {}),
+    };
+    if (input.format === undefined && href && isTopicMapPath(href))
+        entry.format = "topicmap";
+    const container = containerOf(map, parent.path);
+    const index = input.index === undefined ? container.length : Math.min(input.index, container.length);
+    container.splice(index, 0, entry);
+    const target = href ? hrefTarget(mapFile, href) : undefined;
+    return { ok: true, pointer: pointerOf([...parent.path, index]), entry, ...(target !== undefined ? { target } : {}) };
+};
+export const moveRef = (map, input) => {
+    const from = resolveAddress(map, input.from);
+    if (!from.ok)
+        return from;
+    if (from.path.length === 0)
+        return refuse("map-move-root", "the root is not an entry");
+    const to = input.toParent === undefined ? { ok: true, path: from.path.slice(0, -1) } : resolveAddress(map, input.toParent);
+    if (!to.ok)
+        return to;
+    const fromKey = pointerOf(from.path);
+    const toKey = pointerOf(to.path);
+    if (toKey === fromKey || toKey.startsWith(fromKey + "."))
+        return refuse("map-move-into-self", "cannot move an entry into its own subtree");
+    // Resolve BOTH containers by object identity BEFORE the splice: pointers
+    // are positions, and removing the source shifts every later sibling.
+    const src = locate(map, from.path);
+    const dest = containerOf(map, to.path);
+    const [entry] = src.siblings.splice(src.index, 1);
+    const index = input.index === undefined ? dest.length : Math.min(input.index, dest.length);
+    dest.splice(index, 0, entry);
+    const newPath = pathOfEntry(map, entry) ?? [...to.path, index];
+    return { ok: true, from: fromKey, to: pointerOf(newPath), entry: entry };
+};
+export const removeRef = (map, input) => {
+    const at = resolveAddress(map, input.at);
+    if (!at.ok)
+        return at;
+    if (at.path.length === 0)
+        return refuse("map-remove-root", "the root is not an entry");
+    const found = locate(map, at.path);
+    const removedChildren = found.entry.topics?.length ?? 0;
+    const hoisted = input.keepChildren ? (found.entry.topics ?? []) : [];
+    found.siblings.splice(found.index, 1, ...hoisted);
+    return {
+        ok: true,
+        pointer: pointerOf(at.path),
+        entry: found.entry,
+        childrenRemoved: input.keepChildren ? 0 : removedChildren,
+        childrenHoisted: hoisted.length,
+    };
+};
+export const setProps = (map, mapFile, input, exists) => {
+    const at = resolveAddress(map, input.at);
+    if (!at.ok)
+        return at;
+    if (at.path.length === 0)
+        return refuse("map-root-not-entry", "the root is not an entry; set the map title by editing the file");
+    const { entry } = locate(map, at.path);
+    // validate everything BEFORE mutating, so a refusal leaves the map untouched:
+    // judge the POST-state (both fields may change in one call)
+    const hrefAfter = input.href === undefined ? entry.href : input.href?.trim() || null;
+    const titleAfter = input.navtitle === undefined ? entry.navtitle : input.navtitle?.trim() || null;
+    if (!hrefAfter && !titleAfter)
+        return refuse("map-entry-empty", "an entry needs an href or a navtitle");
+    if (typeof input.href === "string" && !input.href.trim())
+        return refuse("map-entry-empty", "href must not be empty (use null to unset)");
+    if (typeof input.navtitle === "string" && !input.navtitle.trim())
+        return refuse("map-entry-empty", "navtitle must not be empty (use null to unset)");
+    if (typeof input.href === "string") {
+        const bad = checkHref(mapFile, input.href.trim(), exists);
+        if (bad)
+            return bad;
+    }
+    const changed = [];
+    if (input.href !== undefined) {
+        if (input.href === null) {
+            delete entry.href;
+            // a title-only entry cannot be a map include
+            if (input.format === undefined && entry.format === "topicmap")
+                delete entry.format;
+        }
+        else {
+            entry.href = input.href.trim();
+            // keep `format` honest when the caller did not say: a map path is a
+            // map, a non-map path is not (a stale `format: topicmap` would make
+            // the build parse a .md as YAML)
+            if (input.format === undefined) {
+                if (isTopicMapPath(entry.href))
+                    entry.format = "topicmap";
+                else if (entry.format === "topicmap")
+                    delete entry.format;
+            }
+        }
+        changed.push("href");
+    }
+    if (input.navtitle !== undefined) {
+        if (input.navtitle === null)
+            delete entry.navtitle;
+        else
+            entry.navtitle = input.navtitle.trim();
+        changed.push("navtitle");
+    }
+    for (const key of ["format", "toc", "singlePage"]) {
+        const value = input[key];
+        if (value === undefined)
+            continue;
+        if (value === null)
+            delete entry[key];
+        else
+            entry[key] = value;
+        changed.push(key);
+    }
+    if (!changed.length)
+        return refuse("map-props-noop", "nothing to set");
+    return { ok: true, pointer: pointerOf(at.path), changed, entry };
+};
+//# sourceMappingURL=edit.js.map

package/dist/edit.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @dogsbay/format-topicmap
+ *
+ * Recursive YAML topic maps (`*.topicmap.yml`) — the DITA-map-equivalent
+ * authored structure format. Topic maps are the source of truth for site
+ * structure; NavItem[]/nav.json are build outputs.
+ *
+ * Spec background: the ide-claude repo's
+ * plans/markdown-dita-replacement/01-modular-content-model.md §1.2.
+ */
+export { isTopicMapPath, TOPICMAP_EXTENSIONS, type TopicMap, type TopicMapEntry, type TopicMapError, type TopicMapLoader, type ResolveOptions, type ResolvedTopicMap, } from "./types.js";
+export { parseTopicMap } from "./parse.js";
+export { serializeTopicMap } from "./serialize.js";
+export { resolveTopicMap } from "./resolve.js";
+export { topicMapToNav } from "./nav.js";
+export { topicMapToNavFile, type NavFileEntry } from "./nav-file.js";
+export { normalizePath, dirname, joinPath, resolveHref, isExternalHref } from "./paths.js";
+export { parsePointer, pointerOf, locate, containerOf, pathOfEntry, hrefTarget, isSelfInclude, findByHref, resolveAddress, flattenTopicMap, addRef, moveRef, removeRef, setProps, type EditResult, type EditRefusal, type ExistsFn, type FlatEntry, type AddRefInput, type MoveRefInput, type SetPropsInput, } from "./edit.js";
+export { applyMapEdit, type MapEditOp, type SourceEditResult } from "./edit-source.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,SAAS,EACT,MAAM,EACN,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,eAAe,EACf,MAAM,EACN,OAAO,EACP,SAAS,EACT,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @dogsbay/format-topicmap
+ *
+ * Recursive YAML topic maps (`*.topicmap.yml`) — the DITA-map-equivalent
+ * authored structure format. Topic maps are the source of truth for site
+ * structure; NavItem[]/nav.json are build outputs.
+ *
+ * Spec background: the ide-claude repo's
+ * plans/markdown-dita-replacement/01-modular-content-model.md §1.2.
+ */
+export { isTopicMapPath, TOPICMAP_EXTENSIONS, } from "./types.js";
+export { parseTopicMap } from "./parse.js";
+export { serializeTopicMap } from "./serialize.js";
+export { resolveTopicMap } from "./resolve.js";
+export { topicMapToNav } from "./nav.js";
+export { topicMapToNavFile } from "./nav-file.js";
+export { normalizePath, dirname, joinPath, resolveHref, isExternalHref } from "./paths.js";
+export { parsePointer, pointerOf, locate, containerOf, pathOfEntry, hrefTarget, isSelfInclude, findByHref, resolveAddress, flattenTopicMap, addRef, moveRef, removeRef, setProps, } from "./edit.js";
+export { applyMapEdit } from "./edit-source.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,GAOpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAqB,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,SAAS,EACT,MAAM,EACN,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,eAAe,EACf,MAAM,EACN,OAAO,EACP,SAAS,EACT,QAAQ,GAQT,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAyC,MAAM,kBAAkB,CAAC"}

package/dist/nav-file.d.ts

@@ -0,0 +1,23 @@
+import type { TopicMap } from "./types.js";
+/**
+ * Nav-file entry shape understood by the site pipeline's explicit nav
+ * loader (`format-dogsbay-md`'s `loadNavFile`): `label` + `file` for
+ * content-relative paths (gets existence checks and href prefixing) or
+ * `href` for external/absolute targets.
+ */
+export interface NavFileEntry {
+    label: string;
+    file?: string;
+    href?: string;
+    singlePage?: "yes" | "no" | "children";
+    children?: NavFileEntry[];
+}
+/**
+ * Emit a *resolved* topic map as nav-file JSON entries — the bridge that
+ * lets today's `nav:` config option consume topic maps: resolve the map,
+ * write the result as nav.json, point `nav:` at it. Relative hrefs become
+ * `file:` references (existence-checked and prefixed by the nav loader);
+ * external/absolute hrefs pass through as `href`.
+ */
+export declare const topicMapToNavFile: (map: TopicMap) => NavFileEntry[];
+//# sourceMappingURL=nav-file.d.ts.map

package/dist/nav-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-file.d.ts","sourceRoot":"","sources":["../src/nav-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAG1D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,UAAU,CAAC;IACvC,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AA2CD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,QAAQ,KAAG,YAAY,EACwB,CAAC"}

package/dist/nav-file.js

@@ -0,0 +1,48 @@
+import { isExternalHref } from "./paths.js";
+// Any scheme-prefixed URL (https, mailto, tel, …) or root-absolute path is a
+// pass-through href; only relative paths become existence-checked file: refs
+const isExternal = (href) => href.startsWith("/") || isExternalHref(href);
+const labelFromHref = (href) => {
+    const base = href.split("/").pop() ?? href;
+    const stem = base.replace(/\.[^.]+$/, "");
+    const words = stem.replace(/[-_]+/g, " ").trim();
+    return words.length > 0 ? words[0].toUpperCase() + words.slice(1) : href;
+};
+const entryToNavFile = (entry) => {
+    if (entry.toc === false)
+        return null;
+    const label = entry.navtitle ?? (entry.href ? labelFromHref(entry.href) : undefined);
+    if (label === undefined)
+        return null;
+    const item = { label };
+    if (entry.href !== undefined) {
+        if (isExternal(entry.href)) {
+            item.href = entry.href;
+        }
+        else {
+            item.file = entry.href;
+        }
+    }
+    if (entry.singlePage !== undefined)
+        item.singlePage = entry.singlePage;
+    if (entry.topics && entry.topics.length > 0) {
+        const children = entry.topics
+            .map(entryToNavFile)
+            .filter((child) => child !== null);
+        if (children.length > 0)
+            item.children = children;
+    }
+    if (item.file === undefined && item.href === undefined && item.children === undefined) {
+        return null;
+    }
+    return item;
+};
+/**
+ * Emit a *resolved* topic map as nav-file JSON entries — the bridge that
+ * lets today's `nav:` config option consume topic maps: resolve the map,
+ * write the result as nav.json, point `nav:` at it. Relative hrefs become
+ * `file:` references (existence-checked and prefixed by the nav loader);
+ * external/absolute hrefs pass through as `href`.
+ */
+export const topicMapToNavFile = (map) => map.topics.map(entryToNavFile).filter((item) => item !== null);
+//# sourceMappingURL=nav-file.js.map

package/dist/nav-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-file.js","sourceRoot":"","sources":["../src/nav-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgB5C,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;AAE3F,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAoB,EAAuB,EAAE;IACnE,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,IAAI,GAAiB,EAAE,KAAK,EAAE,CAAC;IACrC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAEvE,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM;aAC1B,GAAG,CAAC,cAAc,CAAC;aACnB,MAAM,CAAC,CAAC,KAAK,EAAyB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QAC5D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACpD,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAa,EAAkB,EAAE,CACjE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAwB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC"}

package/dist/nav.d.ts

@@ -0,0 +1,8 @@
+import type { NavItem } from "@dogsbay/types";
+import type { TopicMap } from "./types.js";
+/**
+ * Emit the navigation tree for a *resolved* topic map (run resolveTopicMap
+ * first — `format: topicmap` entries are not expanded here).
+ */
+export declare const topicMapToNav: (map: TopicMap) => NavItem[];
+//# sourceMappingURL=nav.d.ts.map

package/dist/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../src/nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAkC1D;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,QAAQ,KAAG,OAAO,EACwB,CAAC"}

package/dist/nav.js

@@ -0,0 +1,37 @@
+/** "getting-started/quick-install.md" → "Quick install" */
+const labelFromHref = (href) => {
+    const base = href.split("/").pop() ?? href;
+    const stem = base.replace(/\.[^.]+$/, "");
+    const words = stem.replace(/[-_]+/g, " ").trim();
+    return words.length > 0 ? words[0].toUpperCase() + words.slice(1) : href;
+};
+const entryToNav = (entry) => {
+    // toc: false → addressable but not in navigation
+    if (entry.toc === false)
+        return null;
+    const label = entry.navtitle ?? (entry.href ? labelFromHref(entry.href) : undefined);
+    if (label === undefined)
+        return null;
+    const item = { label };
+    if (entry.href !== undefined)
+        item.href = entry.href;
+    if (entry.singlePage !== undefined)
+        item.singlePage = entry.singlePage;
+    if (entry.topics && entry.topics.length > 0) {
+        const children = entry.topics
+            .map(entryToNav)
+            .filter((child) => child !== null);
+        if (children.length > 0)
+            item.children = children;
+    }
+    // A label-only entry whose children were all excluded carries no navigation value
+    if (item.href === undefined && item.children === undefined)
+        return null;
+    return item;
+};
+/**
+ * Emit the navigation tree for a *resolved* topic map (run resolveTopicMap
+ * first — `format: topicmap` entries are not expanded here).
+ */
+export const topicMapToNav = (map) => map.topics.map(entryToNav).filter((item) => item !== null);
+//# sourceMappingURL=nav.js.map

package/dist/nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.js","sourceRoot":"","sources":["../src/nav.ts"],"names":[],"mappings":"AAGA,2DAA2D;AAC3D,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,KAAoB,EAAkB,EAAE;IAC1D,iDAAiD;IACjD,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,IAAI,GAAY,EAAE,KAAK,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACrD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAEvE,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM;aAC1B,GAAG,CAAC,UAAU,CAAC;aACf,MAAM,CAAC,CAAC,KAAK,EAAoB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QACvD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACpD,CAAC;IAED,kFAAkF;IAClF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAExE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAa,EAAa,EAAE,CACxD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAmB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,12 @@
+import type { TopicMap, TopicMapError } from "./types.js";
+interface ParseResult {
+    map: TopicMap | null;
+    errors: TopicMapError[];
+}
+/**
+ * Parse a topic map YAML source. Never throws — problems are collected as
+ * structured errors so builds can report all of them at once.
+ */
+export declare const parseTopicMap: (source: string, mapPath?: string) => ParseResult;
+export {};
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,UAAU,WAAW;IACnB,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAgHD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,gBAAY,KAAG,WA0C5D,CAAC"}