docmind-cli 0.1.0 → 0.1.1

package/dist/index.js

@@ -8177,6 +8177,7 @@ function parseBulletList(lines, i) {
 }
 function parseOrderedList(lines, i) {
   if (!/^\d+\.\s/.test(lines[i])) return null;
+  const start = Number.parseInt(lines[i], 10) || 1;
   const items = [];
   let j = i;
   while (j < lines.length && /^\d+\.\s/.test(lines[j])) {
@@ -8189,15 +8190,19 @@ function parseOrderedList(lines, i) {
     const item = { type: "listItem", content: content.length ? content : [{ type: "paragraph", content: [] }] };
     items.push(tagRaw(item, lines, itemStart, j));
   }
-  return { node: { type: "orderedList", attrs: { start: 1 }, content: items }, newI: j };
+  return { node: { type: "orderedList", attrs: { start }, content: items }, newI: j };
+}
+function isQuoteLine(line) {
+  return line.startsWith("> ") || line.trim() === ">";
 }
 function parseBlockquote(lines, i) {
-  if (!lines[i].startsWith("> ") && lines[i].trim() !== ">") return null;
+  if (!isQuoteLine(lines[i])) return null;
   const quoteLines = [];
   let j = i;
-  while (j < lines.length && (lines[j].startsWith("> ") || lines[j].trim() === ">")) quoteLines.push(lines[j++].replace(/^>\s?/, ""));
+  while (j < lines.length && isQuoteLine(lines[j])) quoteLines.push(lines[j++].replace(/^>\s?/, ""));
+  const content = parseBlocks(quoteLines);
   return {
-    node: { type: "blockquote", content: [{ type: "paragraph", content: parseInline(quoteLines.join(" ")) }] },
+    node: { type: "blockquote", content: content.length ? content : [{ type: "paragraph" }] },
     newI: j
   };
 }
@@ -8244,6 +8249,9 @@ function collectUntilClose(lines, start, first, close) {
   }
   return null;
 }
+function joinParagraphLines(paraLines) {
+  return paraLines.reduce((acc, line) => / {2,}$/.test(acc) ? `${acc.replace(/ +$/, "")}<br>${line}` : `${acc} ${line}`);
+}
 function parseParagraph(lines, i) {
   const paraLines = [];
   let j = i;
@@ -8251,7 +8259,7 @@ function parseParagraph(lines, i) {
     paraLines.push(lines[j++]);
   }
   if (paraLines.length > 0) {
-    return { node: { type: "paragraph", content: parseInline(paraLines.join(" ")) }, newI: j };
+    return { node: { type: "paragraph", content: parseInline(joinParagraphLines(paraLines)) }, newI: j };
   }
   return { node: null, newI: i + 1 };
 }
@@ -8584,8 +8592,10 @@ function nodeToMarkdown(node, rawIndex) {
       return paragraphToMarkdown(node);
     case "bulletList":
       return (node.content ?? []).map((item) => serializeListItem(item, "- ", rawIndex)).join("\n");
-    case "orderedList":
-      return (node.content ?? []).map((item, idx) => serializeListItem(item, `${idx + 1}. `, rawIndex)).join("\n");
+    case "orderedList": {
+      const start = Math.max(1, Number(node.attrs?.start) || 1);
+      return (node.content ?? []).map((item, idx) => serializeListItem(item, `${start + idx}. `, rawIndex)).join("\n");
+    }
     case "taskList":
       return (node.content ?? []).map(
         (item) => serializeListItem(item, `- [${item.attrs?.checked ? "x" : " "}] `, rawIndex, { inlineFirstParagraph: true })
@@ -8593,7 +8603,9 @@ function nodeToMarkdown(node, rawIndex) {
     case "blockquote": {
       const color = canonicalQuoteColor(String(node.attrs?.color ?? ""));
       const aligned = (node.content ?? []).some((n) => blockAlign(n));
-      if (!color && !aligned) return (node.content ?? []).map((n) => `> ${nodeToMarkdown(n, rawIndex)}`).join("\n");
+      if (!color && !aligned) {
+        return childrenToMarkdown(node.content ?? [], rawIndex).split("\n").map((line) => line ? `> ${line}` : ">").join("\n");
+      }
       const colorAttr = color ? ` color="${color}"` : "";
       return `<Quote${colorAttr}>
 ${indent(childrenToMarkdown(node.content ?? [], rawIndex))}
@@ -17636,7 +17648,12 @@ async function buildOfflineState(input) {
     };
   }
   const rows = new Rows();
-  await seedExisting(model.navigation, rows, readText);
+  const specFileForSlug = (slug) => {
+    if (!slug || slug.includes("/")) return null;
+    const hits = [...snapshot.files.keys()].filter((p) => /\.(ya?ml|json)$/i.test(p) && p.slice(p.lastIndexOf("/") + 1).replace(/\.(ya?ml|json)$/i, "") === slug);
+    return hits.length === 1 ? hits[0] : null;
+  };
+  await seedExisting(model.navigation, rows, readText, specFileForSlug);
   const existing = rows.size();
   const diff = diffNavigation(model, rows.toDbNavState(), inventoryOf(snapshot, prefix), { subdirectory });
   let refused = null;
@@ -17658,17 +17675,17 @@ async function buildOfflineState(input) {
     counts: { existing, created: rows.size() - existing }
   };
 }
-async function seedExisting(nodes, rows, readText, parent = { sectionId: null, groupId: null, apiReference: false }) {
+async function seedExisting(nodes, rows, readText, specFileForSlug, parent = { sectionId: null, groupId: null, apiReference: false }) {
   for (const [order, node] of nodes.entries()) {
     switch (node.kind) {
       case "tab": {
         const id = node.id;
         if (id) rows.add({ kind: "section", row: sectionRow(id, node.name, slugFromName(node.name), order, node.roles, node.mode, node.icon) });
-        await seedExisting(node.children, rows, readText, { sectionId: id ?? null, groupId: null, apiReference: false });
+        await seedExisting(node.children, rows, readText, specFileForSlug, { sectionId: id ?? null, groupId: null, apiReference: false });
         break;
       }
       case "apiReference":
-        await seedExisting(node.children, rows, readText, { sectionId: null, groupId: null, apiReference: true });
+        await seedExisting(node.children, rows, readText, specFileForSlug, { sectionId: null, groupId: null, apiReference: true });
         break;
       case "group": {
         const id = node.id;
@@ -17687,7 +17704,7 @@ async function seedExisting(nodes, rows, readText, parent = { sectionId: null, g
             )
           });
         }
-        await seedExisting(node.children, rows, readText, {
+        await seedExisting(node.children, rows, readText, specFileForSlug, {
           sectionId: parent.sectionId,
           groupId: id ?? null,
           apiReference: parent.apiReference
@@ -17722,20 +17739,15 @@ async function seedExisting(nodes, rows, readText, parent = { sectionId: null, g
         break;
       case "api":
         if (node.id) {
-          const text = await readText(node.ref);
+          const bySlug = await readText(node.ref) === null ? specFileForSlug(node.ref) : null;
+          const path = bySlug ?? node.ref;
+          const text = await readText(path);
           const detection = text ? detectOpenApi(text) : null;
           const name = node.name?.trim() || detection?.title || "Untitled API";
+          const slug = bySlug ? uniqueSlug(node.ref, rows.specSlugs) : uniqueSlug(slugify(name), rows.specSlugs);
           rows.add({
             kind: "spec",
-            row: specRow(
-              node.id,
-              name,
-              uniqueSlug(slugify(name), rows.specSlugs),
-              node.ref,
-              order,
-              parent.groupId,
-              detection
-            )
+            row: specRow(node.id, name, slug, path, order, parent.groupId, detection)
           });
         }
         break;
@@ -19266,6 +19278,60 @@ var init_api_tag_page = __esm({
   }
 });
 
+// ../../lib/docs/breadcrumbs.ts
+function orderedGroupChain(groupId, groups) {
+  const byId = new Map(groups.map((g) => [g.id, g]));
+  const chain = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (let id = groupId; id && !seen.has(id); ) {
+    seen.add(id);
+    const group = byId.get(id);
+    if (!group) break;
+    chain.unshift({ id: group.id, name: group.name });
+    id = group.parentId;
+  }
+  return chain;
+}
+function buildDocsBreadcrumbs(input) {
+  const groupChain = orderedGroupChain(input.groupId, input.groups);
+  if (groupChain.length === 0) return null;
+  const trail = [
+    { id: "home", label: input.homeLabel, type: "home", route: null }
+  ];
+  if (input.sectionId) {
+    trail.push({
+      id: input.sectionId,
+      label: input.sectionName,
+      type: "tab",
+      route: input.sectionLandingRoute
+    });
+  }
+  for (const group of groupChain) {
+    trail.push({ id: group.id, label: group.name, type: "group", route: null });
+  }
+  trail.push({
+    id: "current-page",
+    label: input.pageTitle,
+    type: "page",
+    route: input.pageRoute,
+    current: true
+  });
+  return trail;
+}
+function buildManifestPageBreadcrumbs(navigation, placement, opts) {
+  return buildDocsBreadcrumbs({
+    ...opts,
+    sectionId: placement.sectionId,
+    groupId: placement.groupId,
+    groups: navigation.groups
+  });
+}
+var init_breadcrumbs = __esm({
+  "../../lib/docs/breadcrumbs.ts"() {
+    "use strict";
+  }
+});
+
 // ../../lib/format-role.ts
 function formatRoleLabel(name) {
   if (!name) return "";
@@ -19375,6 +19441,8 @@ function docView(site, slug, role) {
   const pubSection = pub.manifest.navigation.sections.find((s) => s.id === entry.sectionId) ?? null;
   const pubGroup = entry.groupId ? pub.manifest.navigation.groups.find((g) => g.id === entry.groupId) ?? null : null;
   const isChangelog = artifact.contentType === "changelog" || pubSection?.changelog === true;
+  const pageRoute2 = publishedPageRoute(pub, entry) ?? `/${section}/${entry.slug}`;
+  const sectionLanding = tabRoute({ slug: section, landingRoute: navPages[0]?.route });
   let release = null;
   if (isReleaseNotesSection(pubSection)) {
     release = { version: entry.version, releaseDate: entry.releaseDate, isLatest: navPages[0]?.slug === slug };
@@ -19395,7 +19463,14 @@ function docView(site, slug, role) {
     },
     prevPage: prev,
     nextPage: next,
-    tabRoute: tabRoute({ slug: section, landingRoute: navPages[0]?.route }),
+    tabRoute: sectionLanding,
+    breadcrumbs: buildManifestPageBreadcrumbs(pub.manifest.navigation, entry, {
+      homeLabel: "Docs",
+      pageTitle: artifact.title ?? entry.title,
+      pageRoute: pageRoute2,
+      sectionName: pubSection?.name ?? section,
+      sectionLandingRoute: sectionLanding
+    }),
     pageLinks: prunePageLinks(artifact.content, publicationPageLinks(pub), artifact.githubPath),
     isChangelog,
     release
@@ -19422,6 +19497,7 @@ function apiDocView(site, slug, apiLandingRoute) {
     prevPage: null,
     nextPage: null,
     tabRoute: apiLandingRoute,
+    breadcrumbs: null,
     pageLinks: publicationPageLinks(site.pub),
     isChangelog: false,
     release: null
@@ -19556,6 +19632,7 @@ var init_view = __esm({
     init_release_notes();
     init_page_links();
     init_docs_routes();
+    init_breadcrumbs();
     init_public_settings();
     init_system_roles();
     init_format_role();
@@ -20732,7 +20809,7 @@ var package_default = {
   license: "UNLICENSED",
   type: "module",
   bin: {
-    docmind: "./dist/index.js"
+    docmind: "dist/index.js"
   },
   files: [
     "dist",