npm - @blaaiz/docs-core - Versions diffs - 0.3.0 → 0.4.0 - Mend

@blaaiz/docs-core 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/{chunk-ICDBGTIJ.js → chunk-JHN5XQPU.js} +97 -44
package/dist/chunk-JHN5XQPU.js.map +1 -0
package/dist/generator.cjs +114 -44
package/dist/generator.cjs.map +1 -1
package/dist/generator.js +20 -3
package/dist/generator.js.map +1 -1
package/dist/index.cjs +95 -42
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +35 -7
package/dist/index.d.ts +35 -7
package/dist/index.js +1 -1
package/package.json +1 -1
package/dist/chunk-ICDBGTIJ.js.map +0 -1

package/dist/generator.cjs CHANGED Viewed

@@ -27,6 +27,20 @@ function dirname(file) {
   const i = file.lastIndexOf("/");
   return i === -1 ? "" : file.slice(0, i);
 }
+function firstDocFile(items) {
+  for (const item of items) {
+    if (item.kind === "doc") {
+      return item.file;
+    }
+    if (item.kind === "group") {
+      const found = firstDocFile(item.items);
+      if (found !== void 0) {
+        return found;
+      }
+    }
+  }
+  return void 0;
+}
 function planDocsTree(navigation, options = {}) {
   const apiDir = options.apiDir ?? "api";
   const specs = [];
@@ -34,6 +48,9 @@ function planDocsTree(navigation, options = {}) {
   const apiGroups = [];
   const metas = [];
   const rootPages = [];
+  const apiTabDocPages = [];
+  const apiTabs = navigation.filter((tab) => hasOpenApi(tab.items));
+  const soleApiTab = apiTabs.length === 1;
   for (const tab of navigation) {
     if (hasOpenApi(tab.items)) {
       planApiTab(tab);
@@ -42,38 +59,52 @@ function planDocsTree(navigation, options = {}) {
     planDocTab(tab);
   }
   metas.unshift({ path: "meta.json", content: { pages: rootPages } });
-  return { specs, apiPages, apiGroups, metas };
+  return { specs, apiPages, apiGroups, metas, apiTabDocPages };
   function planApiTab(tab) {
-    rootPages.push(apiDir);
-    const groupDirs = [];
-    for (const item of tab.items) {
-      if (item.kind !== "group") {
+    const tabDir = soleApiTab ? apiDir : slugify(tab.title);
+    rootPages.push(tabDir);
+    const at = apiGroups.length;
+    const children = planApiItems(tab.items, tabDir);
+    apiGroups.splice(at, 0, {
+      dir: tabDir,
+      title: tab.title,
+      root: true,
+      ...tab.icon ? { icon: tab.icon } : {},
+      children
+    });
+  }
+  function planApiItems(items, dir) {
+    const children = [];
+    const takenFolders = /* @__PURE__ */ new Set();
+    let order = 0;
+    for (const item of items) {
+      if (item.kind === "group") {
+        const folder = slugify(item.title);
+        if (takenFolders.has(folder)) {
+          throw new Error(
+            `[docs-core] Two sibling groups under '${dir}' share the folder name '${folder}'. Rename one of the groups in docs.json.`
+          );
+        }
+        takenFolders.add(folder);
+        const childDir = `${dir}/${folder}`;
+        const at = apiGroups.length;
+        const sub = planApiItems(item.items, childDir);
+        apiGroups.splice(at, 0, { dir: childDir, title: item.title, children: sub });
+        children.push({ order, folder });
+        order += 1;
         continue;
       }
-      const dir = `${apiDir}/${slugify(item.title)}`;
-      groupDirs.push(slugify(item.title));
-      apiGroups.push({ dir, title: item.title });
-      let order = 0;
-      for (const page of item.items) {
-        if (page.kind !== "openapi") {
-          continue;
-        }
-        if (!specs.includes(page.file)) {
-          specs.push(page.file);
+      if (item.kind === "openapi") {
+        if (!specs.includes(item.file)) {
+          specs.push(item.file);
         }
-        apiPages.push({ file: page.file, method: page.method, apiPath: page.apiPath, dir, order });
+        apiPages.push({ file: item.file, method: item.method, apiPath: item.apiPath, dir, order });
         order += 1;
+        continue;
       }
+      apiTabDocPages.push(item.file);
     }
-    metas.push({
-      path: `${apiDir}/meta.json`,
-      content: {
-        title: tab.title,
-        root: true,
-        ...tab.icon ? { icon: tab.icon } : {},
-        pages: groupDirs
-      }
-    });
+    return children;
   }
   function planDocTab(tab) {
     const directPages = tab.items.filter((item) => item.kind === "doc");
@@ -84,36 +115,58 @@ function planDocsTree(navigation, options = {}) {
       }
       return;
     }
-    const firstFile = directPages[0]?.file ?? groups.flatMap((g) => g.items).find((item) => item.kind === "doc")?.file;
+    const firstFile = firstDocFile(tab.items);
     if (firstFile === void 0) {
       return;
     }
     const tabDir = firstFile.split("/")[0] ?? "";
     rootPages.push(tabDir);
-    const tabPages = directPages.map((page) => basename(page.file));
-    for (const group of groups) {
-      const pages = group.items.filter((item) => item.kind === "doc");
-      const groupDir = dirname(pages[0]?.file ?? "");
-      const folder = groupDir.split("/").slice(1).join("/");
-      if (folder === "") {
-        tabPages.push(...pages.map((page) => basename(page.file)));
-        continue;
-      }
-      tabPages.push(folder);
-      metas.push({
-        path: `${groupDir}/meta.json`,
-        content: { title: group.title, pages: pages.map((page) => basename(page.file)) }
-      });
-    }
     metas.push({
       path: `${tabDir}/meta.json`,
       content: {
         title: tab.title,
         root: true,
         ...tab.icon ? { icon: tab.icon } : {},
-        pages: tabPages
+        pages: planDocItems(tab.items, tabDir)
+      }
+    });
+  }
+  function planDocItems(items, dir) {
+    const entries = [];
+    for (const item of items) {
+      if (item.kind === "doc") {
+        entries.push(basename(item.file));
+        continue;
+      }
+      if (item.kind !== "group") {
+        continue;
+      }
+      const groupDir = planDocGroup(item, dir);
+      if (groupDir === null) {
+        continue;
       }
+      if (groupDir === dir) {
+        entries.push(...planDocItems(item.items, dir));
+        continue;
+      }
+      entries.push(groupDir.slice(dir.length + 1));
+    }
+    return entries;
+  }
+  function planDocGroup(group, dir) {
+    const firstFile = firstDocFile(group.items);
+    if (firstFile === void 0) {
+      return null;
+    }
+    const groupDir = dirname(firstFile);
+    if (groupDir === dir || groupDir === "") {
+      return dir;
+    }
+    metas.push({
+      path: `${groupDir}/meta.json`,
+      content: { title: group.title, pages: planDocItems(group.items, groupDir) }
     });
+    return groupDir;
   }
 }
@@ -408,7 +461,11 @@ async function generateDocsTree(options) {
       group.push({ order: page.order, slug });
       groupPages.set(page.dir, group);
     }
-    await promises.rm(path__default.default.join(outDir, apiDir), { recursive: true, force: true });
+    for (const group of plan.apiGroups) {
+      if (group.root) {
+        await promises.rm(path__default.default.join(outDir, group.dir), { recursive: true, force: true });
+      }
+    }
     const createOpenAPI = fumadocs.createOpenAPI;
     const generateFiles = fumadocs.generateFiles;
     await generateFiles({
@@ -443,7 +500,15 @@ async function generateDocsTree(options) {
       path: `${group.dir}/meta.json`,
       content: {
         title: group.title,
-        pages: (groupPages.get(group.dir) ?? []).sort((a, b) => a.order - b.order).map((page) => page.slug)
+        ...group.root ? { root: true } : {},
+        ...group.icon ? { icon: group.icon } : {},
+        pages: [
+          ...(groupPages.get(group.dir) ?? []).map((page) => ({
+            order: page.order,
+            name: page.slug
+          })),
+          ...group.children.map((child) => ({ order: child.order, name: child.folder }))
+        ].sort((a, b) => a.order - b.order).map((entry) => entry.name)
       }
     }))
   ];
@@ -500,6 +565,11 @@ async function generateDocsTree(options) {
     `${JSON.stringify(methodsByUrl, null, 2)}
 `
   );
+  if (plan.apiTabDocPages.length > 0) {
+    console.warn(
+      `[docs-core] ${String(plan.apiTabDocPages.length)} doc page(s) are declared inside API tabs and cannot be placed in the generated sidebar folders: ${plan.apiTabDocPages.join(", ")}. Each page stays reachable at its own URL; to list one in the sidebar, move it into a doc tab.`
+    );
+  }
   return { pages, metas: metas.length, navLinks, methodsByUrl, document };
 }

package/dist/generator.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/core/docs-tree.ts","../src/adapters/docs-json/parse-navigation.ts","../src/adapters/openapi/merge-documents.ts","../src/generator/index.ts"],"names":["path","isRecord","HTTP_METHODS","slugify","readFile","rm","mkdir","writeFile"],"mappings":"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","file":"generator.cjs","sourcesContent":["/*\n Turns the normalized navigation into a content-tree plan: which folders and\n * `meta.json` files encode the navigation, and where each API page belongs.\n * The site's `docs.json` stays the single source of truth — authors reorganize\n * routes and groups by editing one file, never by moving generated files.\n \n The planner is pure; `@blaaiz/docs-core/generator` executes the plan.\n \n @packageDocumentation\n /\n\nimport type { NavItem, NavTab, Navigation } from './navigation.js';\n\n/\n A planned API reference page: one operation and the folder it belongs to.\n \n @public\n /\nexport interface PlannedApiPage {\n /* Spec file reference from `docs.json`, relative to the content directory. /\n readonly file: string;\n /* The operation's HTTP method. /\n readonly method: string;\n /* The operation's API route. /\n readonly apiPath: string;\n /* Output folder, relative to the docs output directory (e.g. `api/authentication`). /\n readonly dir: string;\n /* Position within the group. /\n readonly order: number;\n}\n\n/\n A planned API group folder. The generator fills its page order once the\n * operation slugs are known.\n \n @public\n /\nexport interface PlannedApiGroup {\n readonly dir: string;\n readonly title: string;\n}\n\n/\n A `meta.json` file the plan wants written.\n \n @public\n /\nexport interface PlannedMeta {\n /* Path relative to the docs output directory, e.g. `guides/meta.json`. /\n readonly path: string;\n readonly content: Record<string, unknown>;\n}\n\n/\n The complete content-tree plan for one navigation.\n \n @public\n /\nexport interface DocsTreePlan {\n /* Unique spec files referenced by the navigation, in order of appearance. /\n readonly specs: readonly string[];\n readonly apiPages: readonly PlannedApiPage[];\n readonly apiGroups: readonly PlannedApiGroup[];\n /* Fully-known meta files: the root, tab folders, and doc groups. /\n readonly metas: readonly PlannedMeta[];\n}\n\n/\n Options for {@link planDocsTree}.\n \n @public\n /\nexport interface PlanDocsTreeOptions {\n /* Folder for generated API pages. Default `api`. /\n readonly apiDir?: string;\n}\n\n/* Kebab-case a title into a folder name. /\nfunction slugify(title: string): string {\n return title\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/^-+\|-+$/g, '');\n}\n\nfunction isOpenApi(item: NavItem): boolean {\n return item.kind === 'openapi';\n}\n\nfunction hasOpenApi(items: readonly NavItem[]): boolean {\n return items.some((item) => (item.kind === 'group' ? hasOpenApi(item.items) : isOpenApi(item)));\n}\n\n/* The basename of a doc page path (its file name in the folder). /\nfunction basename(file: string): string {\n const i = file.lastIndexOf('/');\n return i === -1 ? file : file.slice(i + 1);\n}\n\n/* The directory of a doc page path, or '' for a root page. /\nfunction dirname(file: string): string {\n const i = file.lastIndexOf('/');\n return i === -1 ? '' : file.slice(0, i);\n}\n\n/\n Plan the content tree for a navigation.\n \n Conventions (Mintlify-shaped):\n * - A tab whose items reference OpenAPI files becomes the API tab; its groups\n * become folders under `apiDir`, named by slugified group title.\n * - A tab of doc pages becomes the folder its pages share (their first path\n * segment); a doc group's pages must share one directory.\n * - Root-level doc pages (no `/` in the path) are listed in the root meta.\n * - Tab folders get `root: true`, so the sidebar scopes to the active tab.\n \n @param navigation - the parsed navigation\n * @param options - the API folder name\n * @returns the plan the generator executes\n * @public\n /\nexport function planDocsTree(\n navigation: Navigation,\n options: PlanDocsTreeOptions = {},\n): DocsTreePlan {\n const apiDir = options.apiDir ?? 'api';\n\n const specs: string[] = [];\n const apiPages: PlannedApiPage[] = [];\n const apiGroups: PlannedApiGroup[] = [];\n const metas: PlannedMeta[] = [];\n const rootPages: string[] = [];\n\n for (const tab of navigation) {\n if (hasOpenApi(tab.items)) {\n planApiTab(tab);\n continue;\n }\n planDocTab(tab);\n }\n\n metas.unshift({ path: 'meta.json', content: { pages: rootPages } });\n\n return { specs, apiPages, apiGroups, metas };\n\n function planApiTab(tab: NavTab): void {\n rootPages.push(apiDir);\n const groupDirs: string[] = [];\n\n for (const item of tab.items) {\n if (item.kind !== 'group') {\n continue; // an API tab organizes its endpoints in groups\n }\n const dir = `${apiDir}/${slugify(item.title)}`;\n groupDirs.push(slugify(item.title));\n apiGroups.push({ dir, title: item.title });\n\n let order = 0;\n for (const page of item.items) {\n if (page.kind !== 'openapi') {\n continue;\n }\n if (!specs.includes(page.file)) {\n specs.push(page.file);\n }\n apiPages.push({ file: page.file, method: page.method, apiPath: page.apiPath, dir, order });\n order += 1;\n }\n }\n\n metas.push({\n path: `${apiDir}/meta.json`,\n content: {\n title: tab.title,\n root: true,\n ...(tab.icon ? { icon: tab.icon } : {}),\n pages: groupDirs,\n },\n });\n }\n\n function planDocTab(tab: NavTab): void {\n const directPages = tab.items.filter((item) => item.kind === 'doc');\n const groups = tab.items.filter((item) => item.kind === 'group');\n\n // A tab of root-level pages (e.g. Home -> index) lists them at the root.\n if (groups.length === 0 && directPages.every((page) => !page.file.includes('/'))) {\n for (const page of directPages) {\n rootPages.push(page.file);\n }\n return;\n }\n\n // The tab folder is the first path segment its pages share.\n const firstFile =\n directPages[0]?.file ??\n groups.flatMap((g) => g.items).find((item) => item.kind === 'doc')?.file;\n if (firstFile === undefined) {\n return;\n }\n const tabDir = firstFile.split('/')[0] ?? '';\n rootPages.push(tabDir);\n\n const tabPages: string[] = directPages.map((page) => basename(page.file));\n\n for (const group of groups) {\n const pages = group.items.filter((item) => item.kind === 'doc');\n const groupDir = dirname(pages[0]?.file ?? '');\n const folder = groupDir.split('/').slice(1).join('/');\n if (folder === '') {\n // Group pages live directly in the tab folder.\n tabPages.push(...pages.map((page) => basename(page.file)));\n continue;\n }\n tabPages.push(folder);\n metas.push({\n path: `${groupDir}/meta.json`,\n content: { title: group.title, pages: pages.map((page) => basename(page.file)) },\n });\n }\n\n metas.push({\n path: `${tabDir}/meta.json`,\n content: {\n title: tab.title,\n root: true,\n ...(tab.icon ? { icon: tab.icon } : {}),\n pages: tabPages,\n },\n });\n }\n}\n","/\n `docs.json` navigation adapter.\n \n Translates a Mintlify `docs.json` navigation block into the framework's\n * normalized {@link Navigation} tree. It understands the two page-string forms\n * Mintlify uses — a plain content path, and an OpenAPI entry of the form\n * `\"<file> <METHOD> <route>\"` — and it recurses through arbitrarily nested\n * groups.\n \n @packageDocumentation\n /\n\nimport {\n type NavGroup,\n type NavItem,\n type NavMethod,\n type NavPage,\n type NavTab,\n type Navigation,\n} from '../../core/index.js';\n\nconst HTTP_METHODS: ReadonlySet<string> = new Set([\n 'GET',\n 'POST',\n 'PUT',\n 'PATCH',\n 'DELETE',\n 'HEAD',\n 'OPTIONS',\n 'TRACE',\n]);\n\n/\n Thrown when a `docs.json` navigation block does not match the expected shape.\n \n @public\n /\nexport class InvalidNavigationError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'InvalidNavigationError';\n }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/\n Parse a single page string into a normalized page node.\n \n A string shaped `\"<file> <METHOD> <route>\"` (where `<METHOD>` is a known HTTP\n * method) becomes an {@link OpenApiPage}; anything else becomes a {@link DocPage}.\n /\nfunction parsePageString(entry: string): NavPage {\n const parts = entry.trim().split(/\\s+/);\n const [file, maybeMethod, ...rest] = parts;\n\n if (file === undefined \|\| file === '') {\n throw new InvalidNavigationError('Encountered an empty navigation page entry.');\n }\n\n if (maybeMethod !== undefined && rest.length > 0 && HTTP_METHODS.has(maybeMethod.toUpperCase())) {\n return {\n kind: 'openapi',\n file,\n method: maybeMethod.toUpperCase() as NavMethod,\n apiPath: rest.join(' '),\n };\n }\n\n return { kind: 'doc', file: entry.trim() };\n}\n\nfunction parseItem(entry: unknown, path: string): NavItem {\n if (typeof entry === 'string') {\n return parsePageString(entry);\n }\n\n if (isRecord(entry) && typeof entry['group'] === 'string') {\n return parseGroup(entry, path);\n }\n\n throw new InvalidNavigationError(\n `Navigation entry at ${path} must be a page string or a group object.`,\n );\n}\n\nfunction parseItems(pages: unknown, path: string): NavItem[] {\n if (!Array.isArray(pages)) {\n throw new InvalidNavigationError(`Expected an array of pages at ${path}.`);\n }\n return pages.map((entry, index) => parseItem(entry, `${path}[${String(index)}]`));\n}\n\nfunction parseGroup(group: Record<string, unknown>, path: string): NavGroup {\n const title = group['group'];\n if (typeof title !== 'string') {\n throw new InvalidNavigationError(`Group at ${path} is missing a string \"group\" title.`);\n }\n return {\n kind: 'group',\n title,\n items: parseItems(group['pages'], `${path}.pages`),\n };\n}\n\nfunction parseTab(tab: unknown, path: string): NavTab {\n if (!isRecord(tab) \|\| typeof tab['tab'] !== 'string') {\n throw new InvalidNavigationError(`Tab at ${path} is missing a string \"tab\" title.`);\n }\n\n // A tab holds either `groups` or `pages`; normalize both into `items`.\n const items: NavItem[] =\n tab['groups'] !== undefined\n ? parseGroups(tab['groups'], `${path}.groups`)\n : parseItems(tab['pages'], `${path}.pages`);\n\n const icon = tab['icon'];\n return {\n kind: 'tab',\n title: tab['tab'],\n items,\n ...(typeof icon === 'string' ? { icon } : {}),\n };\n}\n\nfunction parseGroups(groups: unknown, path: string): NavGroup[] {\n if (!Array.isArray(groups)) {\n throw new InvalidNavigationError(`Expected an array of groups at ${path}.`);\n }\n return groups.map((group, index) => {\n const groupPath = `${path}[${String(index)}]`;\n if (!isRecord(group)) {\n throw new InvalidNavigationError(`Group at ${groupPath} must be an object.`);\n }\n return parseGroup(group, groupPath);\n });\n}\n\n/\n Parse a Mintlify `docs.json` object into the normalized {@link Navigation} tree.\n \n @param docsJson - the parsed contents of a `docs.json` file\n * @returns the normalized, ordered list of tabs\n * @throws {@link InvalidNavigationError} when the navigation shape is invalid\n * @public\n /\nexport function parseNavigation(docsJson: unknown): Navigation {\n if (!isRecord(docsJson)) {\n throw new InvalidNavigationError('docs.json must be an object.');\n }\n\n const navigation = docsJson['navigation'];\n if (!isRecord(navigation)) {\n throw new InvalidNavigationError('docs.json must have a \"navigation\" object.');\n }\n\n const tabs = navigation['tabs'];\n if (!Array.isArray(tabs)) {\n throw new InvalidNavigationError('docs.json navigation must have a \"tabs\" array.');\n }\n\n return tabs.map((tab, index) => parseTab(tab, `navigation.tabs[${String(index)}]`));\n}\n","/\n OpenAPI merge adapter.\n \n A Mintlify-style API reference stores one OpenAPI file per endpoint. Renderers\n * (Scalar, fumadocs-openapi) want a single document. `mergeOpenApiDocuments`\n * combines many single-operation OpenAPI files into one document: it unions\n * servers, tags, and components, and assembles the paths. A genuine conflict —\n * the same method on the same route defined twice — is an error, not a\n * silent overwrite.\n \n @packageDocumentation\n /\n\nimport {\n type OpenApiComponents,\n type OpenApiDocument,\n type OpenApiInfo,\n type OpenApiPathItem,\n type OpenApiServer,\n type OpenApiTag,\n} from '../../core/index.js';\n\n/\n Options controlling the merge.\n \n @public\n /\nexport interface MergeOpenApiOptions {\n /* The `info` block of the merged document. /\n readonly info: OpenApiInfo;\n /\n Servers for the merged document. When omitted, servers are unioned from\n * the input documents (deduplicated by `url`).\n /\n readonly servers?: readonly OpenApiServer[];\n /* The OpenAPI version string of the merged document. Defaults to `3.1.0`. /\n readonly openapi?: string;\n}\n\n/\n Thrown when an input is not a usable OpenAPI document, or when two inputs\n * define the same operation (method + route).\n \n @public\n /\nexport class OpenApiMergeError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'OpenApiMergeError';\n }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction collectServers(\n inputs: readonly Record<string, unknown>[],\n override: readonly OpenApiServer[] \| undefined,\n): OpenApiServer[] {\n if (override !== undefined) {\n return [...override];\n }\n const byUrl = new Map<string, OpenApiServer>();\n for (const doc of inputs) {\n const servers = doc['servers'];\n if (!Array.isArray(servers)) {\n continue;\n }\n for (const server of servers) {\n if (isRecord(server) && typeof server['url'] === 'string' && !byUrl.has(server['url'])) {\n byUrl.set(server['url'], server as unknown as OpenApiServer);\n }\n }\n }\n return [...byUrl.values()];\n}\n\nfunction collectTags(inputs: readonly Record<string, unknown>[]): OpenApiTag[] {\n const byName = new Map<string, OpenApiTag>();\n for (const doc of inputs) {\n const tags = doc['tags'];\n if (!Array.isArray(tags)) {\n continue;\n }\n for (const tag of tags) {\n if (isRecord(tag) && typeof tag['name'] === 'string' && !byName.has(tag['name'])) {\n byName.set(tag['name'], tag as unknown as OpenApiTag);\n }\n }\n }\n return [...byName.values()];\n}\n\nfunction mergeComponents(inputs: readonly Record<string, unknown>[]): OpenApiComponents {\n const merged: Record<string, Record<string, unknown>> = {};\n for (const doc of inputs) {\n const components = doc['components'];\n if (!isRecord(components)) {\n continue;\n }\n for (const [section, value] of Object.entries(components)) {\n if (!isRecord(value)) {\n continue;\n }\n const target = merged[section] ?? (merged[section] = {});\n for (const [key, definition] of Object.entries(value)) {\n // First definition wins; later identical re-declarations are ignored.\n if (!(key in target)) {\n target[key] = definition;\n }\n }\n }\n }\n return merged;\n}\n\nconst HTTP_METHODS = new Set(['get', 'put', 'post', 'delete', 'patch', 'options', 'head', 'trace']);\n\nfunction assemblePaths(\n inputs: readonly Record<string, unknown>[],\n): Record<string, OpenApiPathItem> {\n const paths: Record<string, OpenApiPathItem> = {};\n for (const doc of inputs) {\n const docPaths = doc['paths'];\n if (!isRecord(docPaths)) {\n throw new OpenApiMergeError('Each OpenAPI input must have a \"paths\" object.');\n }\n // Each file's top-level security applies to all its operations. The merged\n // document can't carry one shared security, so push it onto the operations.\n const docSecurity = doc['security'];\n for (const [route, pathItem] of Object.entries(docPaths)) {\n if (!isRecord(pathItem)) {\n throw new OpenApiMergeError(`Path item for \"${route}\" must be an object.`);\n }\n const target = paths[route] ?? (paths[route] = {});\n for (const [method, operation] of Object.entries(pathItem)) {\n if (method in target) {\n throw new OpenApiMergeError(\n `Duplicate operation ${method.toUpperCase()} ${route} across inputs.`,\n );\n }\n let resolved = operation;\n if (\n HTTP_METHODS.has(method.toLowerCase()) &&\n isRecord(operation) &&\n !('security' in operation) &&\n Array.isArray(docSecurity)\n ) {\n resolved = { ...operation, security: docSecurity };\n }\n target[method] = resolved as OpenApiPathItem[string];\n }\n }\n }\n return paths;\n}\n\n/\n Merge many single-operation OpenAPI documents into one document.\n \n @param inputs - parsed OpenAPI documents, each typically holding one operation\n * @param options - the merged document's `info`, and optional server/version overrides\n * @returns the merged {@link OpenApiDocument}\n * @throws {@link OpenApiMergeError} on an invalid input or a duplicate operation\n * @public\n /\nexport function mergeOpenApiDocuments(\n inputs: readonly unknown[],\n options: MergeOpenApiOptions,\n): OpenApiDocument {\n const records: Record<string, unknown>[] = inputs.map((input, index) => {\n if (!isRecord(input)) {\n throw new OpenApiMergeError(`OpenAPI input at index ${String(index)} must be an object.`);\n }\n return input;\n });\n\n return {\n openapi: options.openapi ?? '3.1.0',\n info: options.info,\n servers: collectServers(records, options.servers),\n tags: collectTags(records),\n paths: assemblePaths(records),\n components: mergeComponents(records),\n };\n}\n","/\n `@blaaiz/docs-core/generator` — builds the docs content tree from `docs.json`.\n \n One call turns the site's navigation file into everything fumadocs needs:\n * generated API pages placed in their configured groups, and `meta.json` files\n * encoding tab and group order. Authors reorganize the docs by editing\n * `docs.json` — never by moving files.\n \n Node-only. A site that publishes an API reference injects `createOpenAPI` and\n * `generateFiles` from its own `fumadocs-openapi` install, so this package takes\n * no dependency on it. A site of prose alone injects nothing: with no API pages\n * in `docs.json` the generator writes the `meta.json` files and `nav.json` and\n * never touches `fumadocs-openapi`.\n \n @packageDocumentation\n /\n\nimport { mkdir, readFile, rm, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { mergeOpenApiDocuments } from '../adapters/index.js';\nimport { parseNavigation } from '../adapters/index.js';\nimport type { NavItem, OpenApiDocument, OpenApiInfo, OpenApiServer } from '../core/index.js';\nimport { planDocsTree } from '../core/index.js';\n\n/\n The two fumadocs-openapi functions the generator needs, injected by the site\n * (`createOpenAPI` from `fumadocs-openapi/server`, `generateFiles` from\n * `fumadocs-openapi`). Typed loosely so this package needs no fumadocs types.\n \n @public\n /\nexport interface FumadocsOpenApi {\n readonly createOpenAPI: (...args: never[]) => unknown;\n readonly generateFiles: (...args: never[]) => unknown;\n}\n\n/\n Options for {@link generateDocsTree}.\n \n @public\n /\nexport interface GenerateDocsTreeOptions {\n /* The site's content directory (holds `docs.json`, spec files, and `docs/`). /\n readonly contentDir: string;\n /* Path to the navigation file. Default `<contentDir>/docs.json`. /\n readonly docsJson?: string;\n /* Output directory for the page tree. Default `<contentDir>/docs`. /\n readonly outDir?: string;\n /* Folder for generated API pages. Default `api`. /\n readonly apiDir?: string;\n /\n `info` block of the merged OpenAPI document. Required when `docs.json`\n * publishes API pages; ignored on a site of prose alone, which merges no\n * documents.\n /\n readonly info?: OpenApiInfo;\n /* Servers of the merged document. /\n readonly servers?: readonly OpenApiServer[];\n /* Same-origin proxy route for the try-it playground. /\n readonly proxyUrl?: string;\n /* URL base the fumadocs loader serves pages under. Default `/docs`. /\n readonly baseUrl?: string;\n /\n The site's fumadocs-openapi functions. Required when `docs.json` publishes\n * API pages; omit it on a site of prose alone.\n /\n readonly fumadocs?: FumadocsOpenApi;\n}\n\n/\n A top-navigation link: one tab, pointing at its first page.\n \n @public\n /\nexport interface NavLink {\n readonly text: string;\n readonly url: string;\n /* The tab's icon name from `docs.json`, for the site to resolve. /\n readonly icon?: string;\n}\n\n/\n What the generator produced.\n \n @public\n /\nexport interface GenerateDocsTreeResult {\n readonly pages: number;\n readonly metas: number;\n /\n Top-nav links, one per tab, each pointing at the tab's first page — written\n * to `<contentDir>/nav.json` for the site's layout. Keeps the top nav in sync\n * with `docs.json` instead of a hand-maintained list.\n /\n readonly navLinks: readonly NavLink[];\n /\n Page URL to HTTP method, written to `<contentDir>/api-methods.json` for the\n * sidebar method badges (`apiMethodBadges` in `@blaaiz/docs-core/ui`).\n /\n readonly methodsByUrl: Readonly<Record<string, string>>;\n /* The merged OpenAPI document (reusable for the runtime page renderer). /\n readonly document: OpenApiDocument;\n}\n\ninterface GeneratedFile {\n path: string;\n content: string;\n}\n\nfunction slugify(value: string): string {\n return value\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/^-+\|-+$/g, '');\n}\n\n/* The `METHOD path` key of the first operation a generated page renders. /\nfunction operationKeyOf(content: string): string \| null {\n const match = /operations=\\{(\\[[\\s\\S]?\\])\\}/.exec(content);\n if (!match?.[1]) {\n return null;\n }\n try {\n const ops = JSON.parse(match[1]) as { path: string; method: string }[];\n const op = ops[0];\n return op ? `${op.method.toUpperCase()} ${op.path}` : null;\n } catch {\n return null;\n }\n}\n\n/*\n The `info` a docs-only run reports on its (empty) merged document. Nothing\n * renders it: with no API pages there is no reference view to title.\n /\nconst PROSE_ONLY_INFO: OpenApiInfo = { title: 'No API reference', version: '0.0.0' };\n\n/\n The fumadocs functions, checked. Called only when the navigation publishes\n * API pages, so the message can name the exact reason they are needed.\n /\nfunction requireFumadocs(value: unknown, apiPageCount: number): FumadocsOpenApi {\n const because = `docs.json publishes ${String(apiPageCount)} API page(s)`;\n if (typeof value !== 'object' \|\| value === null) {\n throw new Error(\n `[docs-core] generateDocsTree: the 'fumadocs' option is required because ${because}. ` +\n \"Pass { createOpenAPI, generateFiles } from the site's fumadocs-openapi install.\",\n );\n }\n const candidate = value as Record<string, unknown>;\n for (const name of ['createOpenAPI', 'generateFiles'] as const) {\n if (typeof candidate[name] !== 'function') {\n throw new Error(\n `[docs-core] generateDocsTree: fumadocs.${name} must be a function because ${because}. ` +\n `Import ${name} from ${name === 'createOpenAPI' ? \"'fumadocs-openapi/server'\" : \"'fumadocs-openapi'\"}.`,\n );\n }\n }\n return value as FumadocsOpenApi;\n}\n\n/\n Build the docs content tree from `docs.json`.\n \n Reads the navigation, merges every referenced spec, generates one page per\n * declared endpoint into its configured group folder, and writes the\n * `meta.json` files that give the sidebar the navigation's exact structure and\n * order. Operations present in a spec but not declared in `docs.json` get no\n * page — the navigation decides what is published, as on Mintlify.\n \n A site of prose alone needs neither option: with no API pages in `docs.json`\n * the run writes the `meta.json` files, `nav.json`, and an empty\n * `api-methods.json`, and never loads `fumadocs-openapi`.\n \n @example\n * ```ts\n * // A site of prose alone.\n * await generateDocsTree({ contentDir: 'content' });\n * ```\n \n @param options - directories, document info, and the injected fumadocs functions\n * @returns counts and the merged document\n * @throws when `docs.json` publishes API pages and `fumadocs` or `info` is missing\n * @public\n */\nexport async function generateDocsTree(\n options: GenerateDocsTreeOptions,\n): Promise<GenerateDocsTreeResult> {\n const docsJson = options.docsJson ?? path.join(options.contentDir, 'docs.json');\n const outDir = options.outDir ?? path.join(options.contentDir, 'docs');\n const apiDir = options.apiDir ?? 'api';\n\n const navigation = parseNavigation(JSON.parse(await readFile(docsJson, 'utf8')));\n const plan = planDocsTree(navigation, { apiDir });\n\n // Where each planned API page lands. Both stay empty on a prose-only site.\n const placements = new Map<string, { dir: string; order: number; slug: string }>();\n const groupPages = new Map<string, { order: number; slug: string }[]>();\n let pages = 0;\n let document: OpenApiDocument;\n\n if (plan.apiPages.length === 0) {\n // A site of prose alone. Nothing to merge, nothing to generate, and — most\n // importantly — nothing removed: a hand-written folder named `api` is the\n // site's own content, not our output.\n document = mergeOpenApiDocuments([], { info: options.info ?? PROSE_ONLY_INFO });\n } else {\n const fumadocs = requireFumadocs(options.fumadocs, plan.apiPages.length);\n if (options.info === undefined) {\n throw new Error(\n `[docs-core] generateDocsTree: the 'info' option is required because docs.json ` +\n `publishes ${String(plan.apiPages.length)} API page(s). ` +\n 'Pass { title, version } for the merged OpenAPI document.',\n );\n }\n\n // Merge exactly the specs the navigation references.\n const docs = await Promise.all(\n plan.specs.map(\n async (file) =>\n JSON.parse(await readFile(path.join(options.contentDir, file), 'utf8')) as unknown,\n ),\n );\n document = mergeOpenApiDocuments(docs, {\n info: options.info,\n ...(options.servers ? { servers: options.servers } : {}),\n });\n\n // Resolve each planned page's slug from the merged document.\n for (const page of plan.apiPages) {\n const operation = document.paths[page.apiPath]?.[page.method.toLowerCase()] as\n { operationId?: string } \| undefined;\n if (!operation) {\n throw new Error(\n `[docs-core] docs.json references ${page.method} ${page.apiPath}, ` +\n `but ${page.file} defines no such operation.`,\n );\n }\n const slug = operation.operationId ?? slugify(`${page.method} ${page.apiPath}`);\n placements.set(`${page.method.toUpperCase()} ${page.apiPath}`, { ...page, slug });\n const group = groupPages.get(page.dir) ?? [];\n group.push({ order: page.order, slug });\n groupPages.set(page.dir, group);\n }\n\n // Fresh API tree, then generate pages and route each into its planned folder.\n await rm(path.join(outDir, apiDir), { recursive: true, force: true });\n const createOpenAPI = fumadocs.createOpenAPI as (input: unknown) => unknown;\n const generateFiles = fumadocs.generateFiles as (input: unknown) => Promise<void>;\n await generateFiles({\n input: createOpenAPI({\n input: { blaaiz: document },\n ...(options.proxyUrl ? { proxyUrl: options.proxyUrl } : {}),\n }),\n output: outDir,\n per: 'operation',\n groupBy: 'none',\n beforeWrite(files: GeneratedFile[]) {\n for (let i = files.length - 1; i >= 0; i -= 1) {\n const file = files[i];\n if (!file) {\n continue;\n }\n const key = operationKeyOf(file.content);\n const placement = key ? placements.get(key) : undefined;\n if (!placement) {\n files.splice(i, 1); // not declared in docs.json -> not published\n continue;\n }\n file.path = path.join(placement.dir, `${placement.slug}.mdx`);\n pages += 1;\n }\n },\n });\n }\n\n // Meta files: the plan's static ones, plus page order for each API group.\n const metas = [\n ...plan.metas,\n ...plan.apiGroups.map((group) => ({\n path: `${group.dir}/meta.json`,\n content: {\n title: group.title,\n pages: (groupPages.get(group.dir) ?? [])\n .sort((a, b) => a.order - b.order)\n .map((page) => page.slug),\n },\n })),\n ];\n for (const meta of metas) {\n const target = path.join(outDir, meta.path);\n await mkdir(path.dirname(target), { recursive: true });\n await writeFile(target, `${JSON.stringify(meta.content, null, 2)}\\n`);\n }\n\n // Top-nav links: each tab points at its first page. The URL of an API page\n // needs its resolved slug, which is why this runs here, not in the planner.\n const baseUrl = (options.baseUrl ?? '/docs').replace(/\\/$/, '');\n const docUrl = (file: string): string => {\n const clean = file.replace(/\\/?index$/, '');\n return clean ? `${baseUrl}/${clean}` : baseUrl;\n };\n const firstUrl = (items: readonly NavItem[]): string \| undefined => {\n for (const item of items) {\n if (item.kind === 'group') {\n const url = firstUrl(item.items);\n if (url) {\n return url;\n }\n } else if (item.kind === 'doc') {\n return docUrl(item.file);\n } else {\n const placement = placements.get(`${item.method.toUpperCase()} ${item.apiPath}`);\n if (placement) {\n return `${baseUrl}/${placement.dir}/${placement.slug}`;\n }\n }\n }\n return undefined;\n };\n const navLinks: NavLink[] = [];\n for (const tab of navigation) {\n const url = firstUrl(tab.items);\n if (url) {\n navLinks.push({ text: tab.title, url, ...(tab.icon ? { icon: tab.icon } : {}) });\n }\n }\n await writeFile(\n path.join(options.contentDir, 'nav.json'),\n `${JSON.stringify(navLinks, null, 2)}\\n`,\n );\n\n // Page URL -> HTTP method, for the sidebar method badges.\n const methodsByUrl: Record<string, string> = {};\n for (const page of plan.apiPages) {\n const placement = placements.get(`${page.method.toUpperCase()} ${page.apiPath}`);\n if (placement) {\n methodsByUrl[`${baseUrl}/${placement.dir}/${placement.slug}`] = page.method.toUpperCase();\n }\n }\n await writeFile(\n path.join(options.contentDir, 'api-methods.json'),\n `${JSON.stringify(methodsByUrl, null, 2)}\\n`,\n );\n\n return { pages, metas: metas.length, navLinks, methodsByUrl, document };\n}\n"]}
1	+ {"version":3,"sources":["../src/core/docs-tree.ts","../src/adapters/docs-json/parse-navigation.ts","../src/adapters/openapi/merge-documents.ts","../src/generator/index.ts"],"names":["path","isRecord","HTTP_METHODS","slugify","readFile","rm","mkdir","writeFile"],"mappings":"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","file":"generator.cjs","sourcesContent":["/*\n Turns the normalized navigation into a content-tree plan: which folders and\n * `meta.json` files encode the navigation, and where each API page belongs.\n * The site's `docs.json` stays the single source of truth — authors reorganize\n * routes and groups by editing one file, never by moving generated files.\n \n The planner is pure; `@blaaiz/docs-core/generator` executes the plan.\n \n @packageDocumentation\n /\n\nimport type { NavGroup, NavItem, NavTab, Navigation } from './navigation.js';\n\n/\n A planned API reference page: one operation and the folder it belongs to.\n \n @public\n /\nexport interface PlannedApiPage {\n /* Spec file reference from `docs.json`, relative to the content directory. /\n readonly file: string;\n /* The operation's HTTP method. /\n readonly method: string;\n /* The operation's API route. /\n readonly apiPath: string;\n /* Output folder, relative to the docs output directory (e.g. `api/authentication`). /\n readonly dir: string;\n /* Position within the group. /\n readonly order: number;\n}\n\n/\n A child folder of a planned API group, at its position among the group's\n * pages. The generator merges these with the resolved page slugs to write the\n * group's `meta.json` in declared order.\n \n @public\n /\nexport interface PlannedGroupChild {\n readonly order: number;\n /* The child folder's name within the group directory. /\n readonly folder: string;\n}\n\n/\n A planned API group folder. The generator fills its page order once the\n * operation slugs are known, interleaving {@link PlannedGroupChild} folders at\n * their declared positions. A group with `root: true` is an API tab's folder.\n \n @public\n /\nexport interface PlannedApiGroup {\n readonly dir: string;\n readonly title: string;\n readonly children: readonly PlannedGroupChild[];\n /* Set on an API tab's own folder, so the sidebar scopes to the tab. /\n readonly root?: boolean;\n /* The tab's icon, on a `root` group. /\n readonly icon?: string;\n}\n\n/\n A `meta.json` file the plan wants written.\n \n @public\n /\nexport interface PlannedMeta {\n /* Path relative to the docs output directory, e.g. `guides/meta.json`. /\n readonly path: string;\n readonly content: Record<string, unknown>;\n}\n\n/\n The complete content-tree plan for one navigation.\n \n @public\n /\nexport interface DocsTreePlan {\n /* Unique spec files referenced by the navigation, in order of appearance. /\n readonly specs: readonly string[];\n readonly apiPages: readonly PlannedApiPage[];\n readonly apiGroups: readonly PlannedApiGroup[];\n /* Fully-known meta files: the root, doc tab folders, and doc groups. /\n readonly metas: readonly PlannedMeta[];\n /\n Doc pages declared inside API tabs. The plan cannot place them in the\n * generated folders, so the generator reports them instead of dropping them\n * silently; they stay reachable at their own URLs.\n /\n readonly apiTabDocPages: readonly string[];\n}\n\n/\n Options for {@link planDocsTree}.\n \n @public\n /\nexport interface PlanDocsTreeOptions {\n /* Folder for generated API pages when one tab publishes them. Default `api`. /\n readonly apiDir?: string;\n}\n\n/* Kebab-case a title into a folder name. /\nfunction slugify(title: string): string {\n return title\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/^-+\|-+$/g, '');\n}\n\nfunction isOpenApi(item: NavItem): boolean {\n return item.kind === 'openapi';\n}\n\nfunction hasOpenApi(items: readonly NavItem[]): boolean {\n return items.some((item) => (item.kind === 'group' ? hasOpenApi(item.items) : isOpenApi(item)));\n}\n\n/* The basename of a doc page path (its file name in the folder). /\nfunction basename(file: string): string {\n const i = file.lastIndexOf('/');\n return i === -1 ? file : file.slice(i + 1);\n}\n\n/* The directory of a doc page path, or '' for a root page. /\nfunction dirname(file: string): string {\n const i = file.lastIndexOf('/');\n return i === -1 ? '' : file.slice(0, i);\n}\n\n/* The first doc page in a group, descending nested groups in order. /\nfunction firstDocFile(items: readonly NavItem[]): string \| undefined {\n for (const item of items) {\n if (item.kind === 'doc') {\n return item.file;\n }\n if (item.kind === 'group') {\n const found = firstDocFile(item.items);\n if (found !== undefined) {\n return found;\n }\n }\n }\n return undefined;\n}\n\n/\n Plan the content tree for a navigation.\n \n Conventions (Mintlify-shaped):\n * - A tab whose items reference OpenAPI files becomes an API tab. With one API\n * tab its folder is `apiDir`; with several, each tab's folder is its\n * slugified title, so tabs never collide. Groups become nested folders named\n * by slugified group title, to any depth.\n * - A tab of doc pages becomes the folder its pages share (their first path\n * segment); a doc group's pages must share one directory. Doc groups nest.\n * - Root-level doc pages (no `/` in the path) are listed in the root meta.\n * - Tab folders get `root: true`, so the sidebar scopes to the active tab.\n * - Sidebar order is declaration order, pages and groups interleaved.\n \n @param navigation - the parsed navigation\n * @param options - the API folder name\n * @returns the plan the generator executes\n * @throws when two sibling groups slugify to the same folder\n * @public\n /\nexport function planDocsTree(\n navigation: Navigation,\n options: PlanDocsTreeOptions = {},\n): DocsTreePlan {\n const apiDir = options.apiDir ?? 'api';\n\n const specs: string[] = [];\n const apiPages: PlannedApiPage[] = [];\n const apiGroups: PlannedApiGroup[] = [];\n const metas: PlannedMeta[] = [];\n const rootPages: string[] = [];\n const apiTabDocPages: string[] = [];\n\n const apiTabs = navigation.filter((tab) => hasOpenApi(tab.items));\n const soleApiTab = apiTabs.length === 1;\n\n for (const tab of navigation) {\n if (hasOpenApi(tab.items)) {\n planApiTab(tab);\n continue;\n }\n planDocTab(tab);\n }\n\n metas.unshift({ path: 'meta.json', content: { pages: rootPages } });\n\n return { specs, apiPages, apiGroups, metas, apiTabDocPages };\n\n function planApiTab(tab: NavTab): void {\n const tabDir = soleApiTab ? apiDir : slugify(tab.title);\n rootPages.push(tabDir);\n const at = apiGroups.length;\n const children = planApiItems(tab.items, tabDir);\n apiGroups.splice(at, 0, {\n dir: tabDir,\n title: tab.title,\n root: true,\n ...(tab.icon ? { icon: tab.icon } : {}),\n children,\n });\n }\n\n /\n Plan a run of API-tab items into `dir`: operations become planned pages,\n * nested groups become child folders, and doc pages are reported. Returns\n * the child folders at their declared positions.\n /\n function planApiItems(items: readonly NavItem[], dir: string): PlannedGroupChild[] {\n const children: PlannedGroupChild[] = [];\n const takenFolders = new Set<string>();\n let order = 0;\n for (const item of items) {\n if (item.kind === 'group') {\n const folder = slugify(item.title);\n if (takenFolders.has(folder)) {\n throw new Error(\n `[docs-core] Two sibling groups under '${dir}' share the folder name '${folder}'. ` +\n 'Rename one of the groups in docs.json.',\n );\n }\n takenFolders.add(folder);\n const childDir = `${dir}/${folder}`;\n const at = apiGroups.length;\n const sub = planApiItems(item.items, childDir);\n apiGroups.splice(at, 0, { dir: childDir, title: item.title, children: sub });\n children.push({ order, folder });\n order += 1;\n continue;\n }\n if (item.kind === 'openapi') {\n if (!specs.includes(item.file)) {\n specs.push(item.file);\n }\n apiPages.push({ file: item.file, method: item.method, apiPath: item.apiPath, dir, order });\n order += 1;\n continue;\n }\n apiTabDocPages.push(item.file);\n }\n return children;\n }\n\n function planDocTab(tab: NavTab): void {\n const directPages = tab.items.filter((item) => item.kind === 'doc');\n const groups = tab.items.filter((item) => item.kind === 'group');\n\n // A tab of root-level pages (e.g. Home -> index) lists them at the root.\n if (groups.length === 0 && directPages.every((page) => !page.file.includes('/'))) {\n for (const page of directPages) {\n rootPages.push(page.file);\n }\n return;\n }\n\n // The tab folder is the first path segment its pages share.\n const firstFile = firstDocFile(tab.items);\n if (firstFile === undefined) {\n return;\n }\n const tabDir = firstFile.split('/')[0] ?? '';\n rootPages.push(tabDir);\n\n metas.push({\n path: `${tabDir}/meta.json`,\n content: {\n title: tab.title,\n root: true,\n ...(tab.icon ? { icon: tab.icon } : {}),\n pages: planDocItems(tab.items, tabDir),\n },\n });\n }\n\n /\n Plan a run of doc-tab items belonging to the folder `dir`: pages are\n * listed by basename, nested groups get their own `meta.json` and are\n * listed by their folder path relative to `dir`. A nested group whose pages\n * live directly in `dir` is flattened into it. Returns the meta entries in\n * declared order.\n /\n function planDocItems(items: readonly NavItem[], dir: string): string[] {\n const entries: string[] = [];\n for (const item of items) {\n if (item.kind === 'doc') {\n entries.push(basename(item.file));\n continue;\n }\n if (item.kind !== 'group') {\n continue;\n }\n const groupDir = planDocGroup(item, dir);\n if (groupDir === null) {\n continue;\n }\n if (groupDir === dir) {\n // The group's pages live directly in this folder.\n entries.push(...planDocItems(item.items, dir));\n continue;\n }\n entries.push(groupDir.slice(dir.length + 1));\n }\n return entries;\n }\n\n /\n Plan one doc group. Returns the group's directory, `dir` itself when the\n * group flattens into its parent folder, or `null` for an empty group.\n /\n function planDocGroup(group: NavGroup, dir: string): string \| null {\n const firstFile = firstDocFile(group.items);\n if (firstFile === undefined) {\n return null;\n }\n const groupDir = dirname(firstFile);\n if (groupDir === dir \|\| groupDir === '') {\n return dir;\n }\n metas.push({\n path: `${groupDir}/meta.json`,\n content: { title: group.title, pages: planDocItems(group.items, groupDir) },\n });\n return groupDir;\n }\n}\n","/\n `docs.json` navigation adapter.\n \n Translates a Mintlify `docs.json` navigation block into the framework's\n * normalized {@link Navigation} tree. It understands the two page-string forms\n * Mintlify uses — a plain content path, and an OpenAPI entry of the form\n * `\"<file> <METHOD> <route>\"` — and it recurses through arbitrarily nested\n * groups.\n \n @packageDocumentation\n /\n\nimport {\n type NavGroup,\n type NavItem,\n type NavMethod,\n type NavPage,\n type NavTab,\n type Navigation,\n} from '../../core/index.js';\n\nconst HTTP_METHODS: ReadonlySet<string> = new Set([\n 'GET',\n 'POST',\n 'PUT',\n 'PATCH',\n 'DELETE',\n 'HEAD',\n 'OPTIONS',\n 'TRACE',\n]);\n\n/\n Thrown when a `docs.json` navigation block does not match the expected shape.\n \n @public\n /\nexport class InvalidNavigationError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'InvalidNavigationError';\n }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/\n Parse a single page string into a normalized page node.\n \n A string shaped `\"<file> <METHOD> <route>\"` (where `<METHOD>` is a known HTTP\n * method) becomes an {@link OpenApiPage}; anything else becomes a {@link DocPage}.\n /\nfunction parsePageString(entry: string): NavPage {\n const parts = entry.trim().split(/\\s+/);\n const [file, maybeMethod, ...rest] = parts;\n\n if (file === undefined \|\| file === '') {\n throw new InvalidNavigationError('Encountered an empty navigation page entry.');\n }\n\n if (maybeMethod !== undefined && rest.length > 0 && HTTP_METHODS.has(maybeMethod.toUpperCase())) {\n return {\n kind: 'openapi',\n file,\n method: maybeMethod.toUpperCase() as NavMethod,\n apiPath: rest.join(' '),\n };\n }\n\n return { kind: 'doc', file: entry.trim() };\n}\n\nfunction parseItem(entry: unknown, path: string): NavItem {\n if (typeof entry === 'string') {\n return parsePageString(entry);\n }\n\n if (isRecord(entry) && typeof entry['group'] === 'string') {\n return parseGroup(entry, path);\n }\n\n throw new InvalidNavigationError(\n `Navigation entry at ${path} must be a page string or a group object.`,\n );\n}\n\nfunction parseItems(pages: unknown, path: string): NavItem[] {\n if (!Array.isArray(pages)) {\n throw new InvalidNavigationError(`Expected an array of pages at ${path}.`);\n }\n return pages.map((entry, index) => parseItem(entry, `${path}[${String(index)}]`));\n}\n\nfunction parseGroup(group: Record<string, unknown>, path: string): NavGroup {\n const title = group['group'];\n if (typeof title !== 'string') {\n throw new InvalidNavigationError(`Group at ${path} is missing a string \"group\" title.`);\n }\n return {\n kind: 'group',\n title,\n items: parseItems(group['pages'], `${path}.pages`),\n };\n}\n\nfunction parseTab(tab: unknown, path: string): NavTab {\n if (!isRecord(tab) \|\| typeof tab['tab'] !== 'string') {\n throw new InvalidNavigationError(`Tab at ${path} is missing a string \"tab\" title.`);\n }\n\n // A tab holds either `groups` or `pages`; normalize both into `items`.\n const items: NavItem[] =\n tab['groups'] !== undefined\n ? parseGroups(tab['groups'], `${path}.groups`)\n : parseItems(tab['pages'], `${path}.pages`);\n\n const icon = tab['icon'];\n return {\n kind: 'tab',\n title: tab['tab'],\n items,\n ...(typeof icon === 'string' ? { icon } : {}),\n };\n}\n\nfunction parseGroups(groups: unknown, path: string): NavGroup[] {\n if (!Array.isArray(groups)) {\n throw new InvalidNavigationError(`Expected an array of groups at ${path}.`);\n }\n return groups.map((group, index) => {\n const groupPath = `${path}[${String(index)}]`;\n if (!isRecord(group)) {\n throw new InvalidNavigationError(`Group at ${groupPath} must be an object.`);\n }\n return parseGroup(group, groupPath);\n });\n}\n\n/\n Parse a Mintlify `docs.json` object into the normalized {@link Navigation} tree.\n \n @param docsJson - the parsed contents of a `docs.json` file\n * @returns the normalized, ordered list of tabs\n * @throws {@link InvalidNavigationError} when the navigation shape is invalid\n * @public\n /\nexport function parseNavigation(docsJson: unknown): Navigation {\n if (!isRecord(docsJson)) {\n throw new InvalidNavigationError('docs.json must be an object.');\n }\n\n const navigation = docsJson['navigation'];\n if (!isRecord(navigation)) {\n throw new InvalidNavigationError('docs.json must have a \"navigation\" object.');\n }\n\n const tabs = navigation['tabs'];\n if (!Array.isArray(tabs)) {\n throw new InvalidNavigationError('docs.json navigation must have a \"tabs\" array.');\n }\n\n return tabs.map((tab, index) => parseTab(tab, `navigation.tabs[${String(index)}]`));\n}\n","/\n OpenAPI merge adapter.\n \n A Mintlify-style API reference stores one OpenAPI file per endpoint. Renderers\n * (Scalar, fumadocs-openapi) want a single document. `mergeOpenApiDocuments`\n * combines many single-operation OpenAPI files into one document: it unions\n * servers, tags, and components, and assembles the paths. A genuine conflict —\n * the same method on the same route defined twice — is an error, not a\n * silent overwrite.\n \n @packageDocumentation\n /\n\nimport {\n type OpenApiComponents,\n type OpenApiDocument,\n type OpenApiInfo,\n type OpenApiPathItem,\n type OpenApiServer,\n type OpenApiTag,\n} from '../../core/index.js';\n\n/\n Options controlling the merge.\n \n @public\n /\nexport interface MergeOpenApiOptions {\n /* The `info` block of the merged document. /\n readonly info: OpenApiInfo;\n /\n Servers for the merged document. When omitted, servers are unioned from\n * the input documents (deduplicated by `url`).\n /\n readonly servers?: readonly OpenApiServer[];\n /* The OpenAPI version string of the merged document. Defaults to `3.1.0`. /\n readonly openapi?: string;\n}\n\n/\n Thrown when an input is not a usable OpenAPI document, or when two inputs\n * define the same operation (method + route).\n \n @public\n /\nexport class OpenApiMergeError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'OpenApiMergeError';\n }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction collectServers(\n inputs: readonly Record<string, unknown>[],\n override: readonly OpenApiServer[] \| undefined,\n): OpenApiServer[] {\n if (override !== undefined) {\n return [...override];\n }\n const byUrl = new Map<string, OpenApiServer>();\n for (const doc of inputs) {\n const servers = doc['servers'];\n if (!Array.isArray(servers)) {\n continue;\n }\n for (const server of servers) {\n if (isRecord(server) && typeof server['url'] === 'string' && !byUrl.has(server['url'])) {\n byUrl.set(server['url'], server as unknown as OpenApiServer);\n }\n }\n }\n return [...byUrl.values()];\n}\n\nfunction collectTags(inputs: readonly Record<string, unknown>[]): OpenApiTag[] {\n const byName = new Map<string, OpenApiTag>();\n for (const doc of inputs) {\n const tags = doc['tags'];\n if (!Array.isArray(tags)) {\n continue;\n }\n for (const tag of tags) {\n if (isRecord(tag) && typeof tag['name'] === 'string' && !byName.has(tag['name'])) {\n byName.set(tag['name'], tag as unknown as OpenApiTag);\n }\n }\n }\n return [...byName.values()];\n}\n\nfunction mergeComponents(inputs: readonly Record<string, unknown>[]): OpenApiComponents {\n const merged: Record<string, Record<string, unknown>> = {};\n for (const doc of inputs) {\n const components = doc['components'];\n if (!isRecord(components)) {\n continue;\n }\n for (const [section, value] of Object.entries(components)) {\n if (!isRecord(value)) {\n continue;\n }\n const target = merged[section] ?? (merged[section] = {});\n for (const [key, definition] of Object.entries(value)) {\n // First definition wins; later identical re-declarations are ignored.\n if (!(key in target)) {\n target[key] = definition;\n }\n }\n }\n }\n return merged;\n}\n\nconst HTTP_METHODS = new Set(['get', 'put', 'post', 'delete', 'patch', 'options', 'head', 'trace']);\n\nfunction assemblePaths(\n inputs: readonly Record<string, unknown>[],\n): Record<string, OpenApiPathItem> {\n const paths: Record<string, OpenApiPathItem> = {};\n for (const doc of inputs) {\n const docPaths = doc['paths'];\n if (!isRecord(docPaths)) {\n throw new OpenApiMergeError('Each OpenAPI input must have a \"paths\" object.');\n }\n // Each file's top-level security applies to all its operations. The merged\n // document can't carry one shared security, so push it onto the operations.\n const docSecurity = doc['security'];\n for (const [route, pathItem] of Object.entries(docPaths)) {\n if (!isRecord(pathItem)) {\n throw new OpenApiMergeError(`Path item for \"${route}\" must be an object.`);\n }\n const target = paths[route] ?? (paths[route] = {});\n for (const [method, operation] of Object.entries(pathItem)) {\n if (method in target) {\n throw new OpenApiMergeError(\n `Duplicate operation ${method.toUpperCase()} ${route} across inputs.`,\n );\n }\n let resolved = operation;\n if (\n HTTP_METHODS.has(method.toLowerCase()) &&\n isRecord(operation) &&\n !('security' in operation) &&\n Array.isArray(docSecurity)\n ) {\n resolved = { ...operation, security: docSecurity };\n }\n target[method] = resolved as OpenApiPathItem[string];\n }\n }\n }\n return paths;\n}\n\n/\n Merge many single-operation OpenAPI documents into one document.\n \n @param inputs - parsed OpenAPI documents, each typically holding one operation\n * @param options - the merged document's `info`, and optional server/version overrides\n * @returns the merged {@link OpenApiDocument}\n * @throws {@link OpenApiMergeError} on an invalid input or a duplicate operation\n * @public\n /\nexport function mergeOpenApiDocuments(\n inputs: readonly unknown[],\n options: MergeOpenApiOptions,\n): OpenApiDocument {\n const records: Record<string, unknown>[] = inputs.map((input, index) => {\n if (!isRecord(input)) {\n throw new OpenApiMergeError(`OpenAPI input at index ${String(index)} must be an object.`);\n }\n return input;\n });\n\n return {\n openapi: options.openapi ?? '3.1.0',\n info: options.info,\n servers: collectServers(records, options.servers),\n tags: collectTags(records),\n paths: assemblePaths(records),\n components: mergeComponents(records),\n };\n}\n","/\n `@blaaiz/docs-core/generator` — builds the docs content tree from `docs.json`.\n \n One call turns the site's navigation file into everything fumadocs needs:\n * generated API pages placed in their configured groups, and `meta.json` files\n * encoding tab and group order. Authors reorganize the docs by editing\n * `docs.json` — never by moving files.\n \n Node-only. A site that publishes an API reference injects `createOpenAPI` and\n * `generateFiles` from its own `fumadocs-openapi` install, so this package takes\n * no dependency on it. A site of prose alone injects nothing: with no API pages\n * in `docs.json` the generator writes the `meta.json` files and `nav.json` and\n * never touches `fumadocs-openapi`.\n \n @packageDocumentation\n /\n\nimport { mkdir, readFile, rm, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { mergeOpenApiDocuments } from '../adapters/index.js';\nimport { parseNavigation } from '../adapters/index.js';\nimport type { NavItem, OpenApiDocument, OpenApiInfo, OpenApiServer } from '../core/index.js';\nimport { planDocsTree } from '../core/index.js';\n\n/\n The two fumadocs-openapi functions the generator needs, injected by the site\n * (`createOpenAPI` from `fumadocs-openapi/server`, `generateFiles` from\n * `fumadocs-openapi`). Typed loosely so this package needs no fumadocs types.\n \n @public\n /\nexport interface FumadocsOpenApi {\n readonly createOpenAPI: (...args: never[]) => unknown;\n readonly generateFiles: (...args: never[]) => unknown;\n}\n\n/\n Options for {@link generateDocsTree}.\n \n @public\n /\nexport interface GenerateDocsTreeOptions {\n /* The site's content directory (holds `docs.json`, spec files, and `docs/`). /\n readonly contentDir: string;\n /* Path to the navigation file. Default `<contentDir>/docs.json`. /\n readonly docsJson?: string;\n /* Output directory for the page tree. Default `<contentDir>/docs`. /\n readonly outDir?: string;\n /* Folder for generated API pages. Default `api`. /\n readonly apiDir?: string;\n /\n `info` block of the merged OpenAPI document. Required when `docs.json`\n * publishes API pages; ignored on a site of prose alone, which merges no\n * documents.\n /\n readonly info?: OpenApiInfo;\n /* Servers of the merged document. /\n readonly servers?: readonly OpenApiServer[];\n /* Same-origin proxy route for the try-it playground. /\n readonly proxyUrl?: string;\n /* URL base the fumadocs loader serves pages under. Default `/docs`. /\n readonly baseUrl?: string;\n /\n The site's fumadocs-openapi functions. Required when `docs.json` publishes\n * API pages; omit it on a site of prose alone.\n /\n readonly fumadocs?: FumadocsOpenApi;\n}\n\n/\n A top-navigation link: one tab, pointing at its first page.\n \n @public\n /\nexport interface NavLink {\n readonly text: string;\n readonly url: string;\n /* The tab's icon name from `docs.json`, for the site to resolve. /\n readonly icon?: string;\n}\n\n/\n What the generator produced.\n \n @public\n /\nexport interface GenerateDocsTreeResult {\n readonly pages: number;\n readonly metas: number;\n /\n Top-nav links, one per tab, each pointing at the tab's first page — written\n * to `<contentDir>/nav.json` for the site's layout. Keeps the top nav in sync\n * with `docs.json` instead of a hand-maintained list.\n /\n readonly navLinks: readonly NavLink[];\n /\n Page URL to HTTP method, written to `<contentDir>/api-methods.json` for the\n * sidebar method badges (`apiMethodBadges` in `@blaaiz/docs-core/ui`).\n /\n readonly methodsByUrl: Readonly<Record<string, string>>;\n /* The merged OpenAPI document (reusable for the runtime page renderer). /\n readonly document: OpenApiDocument;\n}\n\ninterface GeneratedFile {\n path: string;\n content: string;\n}\n\nfunction slugify(value: string): string {\n return value\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/^-+\|-+$/g, '');\n}\n\n/* The `METHOD path` key of the first operation a generated page renders. /\nfunction operationKeyOf(content: string): string \| null {\n const match = /operations=\\{(\\[[\\s\\S]?\\])\\}/.exec(content);\n if (!match?.[1]) {\n return null;\n }\n try {\n const ops = JSON.parse(match[1]) as { path: string; method: string }[];\n const op = ops[0];\n return op ? `${op.method.toUpperCase()} ${op.path}` : null;\n } catch {\n return null;\n }\n}\n\n/*\n The `info` a docs-only run reports on its (empty) merged document. Nothing\n * renders it: with no API pages there is no reference view to title.\n /\nconst PROSE_ONLY_INFO: OpenApiInfo = { title: 'No API reference', version: '0.0.0' };\n\n/\n The fumadocs functions, checked. Called only when the navigation publishes\n * API pages, so the message can name the exact reason they are needed.\n /\nfunction requireFumadocs(value: unknown, apiPageCount: number): FumadocsOpenApi {\n const because = `docs.json publishes ${String(apiPageCount)} API page(s)`;\n if (typeof value !== 'object' \|\| value === null) {\n throw new Error(\n `[docs-core] generateDocsTree: the 'fumadocs' option is required because ${because}. ` +\n \"Pass { createOpenAPI, generateFiles } from the site's fumadocs-openapi install.\",\n );\n }\n const candidate = value as Record<string, unknown>;\n for (const name of ['createOpenAPI', 'generateFiles'] as const) {\n if (typeof candidate[name] !== 'function') {\n throw new Error(\n `[docs-core] generateDocsTree: fumadocs.${name} must be a function because ${because}. ` +\n `Import ${name} from ${name === 'createOpenAPI' ? \"'fumadocs-openapi/server'\" : \"'fumadocs-openapi'\"}.`,\n );\n }\n }\n return value as FumadocsOpenApi;\n}\n\n/\n Build the docs content tree from `docs.json`.\n \n Reads the navigation, merges every referenced spec, generates one page per\n * declared endpoint into its configured group folder, and writes the\n * `meta.json` files that give the sidebar the navigation's exact structure and\n * order. Operations present in a spec but not declared in `docs.json` get no\n * page — the navigation decides what is published, as on Mintlify.\n \n A site of prose alone needs neither option: with no API pages in `docs.json`\n * the run writes the `meta.json` files, `nav.json`, and an empty\n * `api-methods.json`, and never loads `fumadocs-openapi`.\n \n @example\n * ```ts\n * // A site of prose alone.\n * await generateDocsTree({ contentDir: 'content' });\n * ```\n \n @param options - directories, document info, and the injected fumadocs functions\n * @returns counts and the merged document\n * @throws when `docs.json` publishes API pages and `fumadocs` or `info` is missing\n * @public\n */\nexport async function generateDocsTree(\n options: GenerateDocsTreeOptions,\n): Promise<GenerateDocsTreeResult> {\n const docsJson = options.docsJson ?? path.join(options.contentDir, 'docs.json');\n const outDir = options.outDir ?? path.join(options.contentDir, 'docs');\n const apiDir = options.apiDir ?? 'api';\n\n const navigation = parseNavigation(JSON.parse(await readFile(docsJson, 'utf8')));\n const plan = planDocsTree(navigation, { apiDir });\n\n // Where each planned API page lands. Both stay empty on a prose-only site.\n const placements = new Map<string, { dir: string; order: number; slug: string }>();\n const groupPages = new Map<string, { order: number; slug: string }[]>();\n let pages = 0;\n let document: OpenApiDocument;\n\n if (plan.apiPages.length === 0) {\n // A site of prose alone. Nothing to merge, nothing to generate, and — most\n // importantly — nothing removed: a hand-written folder named `api` is the\n // site's own content, not our output.\n document = mergeOpenApiDocuments([], { info: options.info ?? PROSE_ONLY_INFO });\n } else {\n const fumadocs = requireFumadocs(options.fumadocs, plan.apiPages.length);\n if (options.info === undefined) {\n throw new Error(\n `[docs-core] generateDocsTree: the 'info' option is required because docs.json ` +\n `publishes ${String(plan.apiPages.length)} API page(s). ` +\n 'Pass { title, version } for the merged OpenAPI document.',\n );\n }\n\n // Merge exactly the specs the navigation references.\n const docs = await Promise.all(\n plan.specs.map(\n async (file) =>\n JSON.parse(await readFile(path.join(options.contentDir, file), 'utf8')) as unknown,\n ),\n );\n document = mergeOpenApiDocuments(docs, {\n info: options.info,\n ...(options.servers ? { servers: options.servers } : {}),\n });\n\n // Resolve each planned page's slug from the merged document.\n for (const page of plan.apiPages) {\n const operation = document.paths[page.apiPath]?.[page.method.toLowerCase()] as\n { operationId?: string } \| undefined;\n if (!operation) {\n throw new Error(\n `[docs-core] docs.json references ${page.method} ${page.apiPath}, ` +\n `but ${page.file} defines no such operation.`,\n );\n }\n const slug = operation.operationId ?? slugify(`${page.method} ${page.apiPath}`);\n placements.set(`${page.method.toUpperCase()} ${page.apiPath}`, { ...page, slug });\n const group = groupPages.get(page.dir) ?? [];\n group.push({ order: page.order, slug });\n groupPages.set(page.dir, group);\n }\n\n // Fresh API tree, then generate pages and route each into its planned folder.\n for (const group of plan.apiGroups) {\n if (group.root) {\n await rm(path.join(outDir, group.dir), { recursive: true, force: true });\n }\n }\n const createOpenAPI = fumadocs.createOpenAPI as (input: unknown) => unknown;\n const generateFiles = fumadocs.generateFiles as (input: unknown) => Promise<void>;\n await generateFiles({\n input: createOpenAPI({\n input: { blaaiz: document },\n ...(options.proxyUrl ? { proxyUrl: options.proxyUrl } : {}),\n }),\n output: outDir,\n per: 'operation',\n groupBy: 'none',\n beforeWrite(files: GeneratedFile[]) {\n for (let i = files.length - 1; i >= 0; i -= 1) {\n const file = files[i];\n if (!file) {\n continue;\n }\n const key = operationKeyOf(file.content);\n const placement = key ? placements.get(key) : undefined;\n if (!placement) {\n files.splice(i, 1); // not declared in docs.json -> not published\n continue;\n }\n file.path = path.join(placement.dir, `${placement.slug}.mdx`);\n pages += 1;\n }\n },\n });\n }\n\n // Meta files: the plan's static ones, plus each API group's entries — its\n // resolved page slugs and child folders, merged back into declared order.\n const metas = [\n ...plan.metas,\n ...plan.apiGroups.map((group) => ({\n path: `${group.dir}/meta.json`,\n content: {\n title: group.title,\n ...(group.root ? { root: true } : {}),\n ...(group.icon ? { icon: group.icon } : {}),\n pages: [\n ...(groupPages.get(group.dir) ?? []).map((page) => ({\n order: page.order,\n name: page.slug,\n })),\n ...group.children.map((child) => ({ order: child.order, name: child.folder })),\n ]\n .sort((a, b) => a.order - b.order)\n .map((entry) => entry.name),\n },\n })),\n ];\n for (const meta of metas) {\n const target = path.join(outDir, meta.path);\n await mkdir(path.dirname(target), { recursive: true });\n await writeFile(target, `${JSON.stringify(meta.content, null, 2)}\\n`);\n }\n\n // Top-nav links: each tab points at its first page. The URL of an API page\n // needs its resolved slug, which is why this runs here, not in the planner.\n const baseUrl = (options.baseUrl ?? '/docs').replace(/\\/$/, '');\n const docUrl = (file: string): string => {\n const clean = file.replace(/\\/?index$/, '');\n return clean ? `${baseUrl}/${clean}` : baseUrl;\n };\n const firstUrl = (items: readonly NavItem[]): string \| undefined => {\n for (const item of items) {\n if (item.kind === 'group') {\n const url = firstUrl(item.items);\n if (url) {\n return url;\n }\n } else if (item.kind === 'doc') {\n return docUrl(item.file);\n } else {\n const placement = placements.get(`${item.method.toUpperCase()} ${item.apiPath}`);\n if (placement) {\n return `${baseUrl}/${placement.dir}/${placement.slug}`;\n }\n }\n }\n return undefined;\n };\n const navLinks: NavLink[] = [];\n for (const tab of navigation) {\n const url = firstUrl(tab.items);\n if (url) {\n navLinks.push({ text: tab.title, url, ...(tab.icon ? { icon: tab.icon } : {}) });\n }\n }\n await writeFile(\n path.join(options.contentDir, 'nav.json'),\n `${JSON.stringify(navLinks, null, 2)}\\n`,\n );\n\n // Page URL -> HTTP method, for the sidebar method badges.\n const methodsByUrl: Record<string, string> = {};\n for (const page of plan.apiPages) {\n const placement = placements.get(`${page.method.toUpperCase()} ${page.apiPath}`);\n if (placement) {\n methodsByUrl[`${baseUrl}/${placement.dir}/${placement.slug}`] = page.method.toUpperCase();\n }\n }\n await writeFile(\n path.join(options.contentDir, 'api-methods.json'),\n `${JSON.stringify(methodsByUrl, null, 2)}\\n`,\n );\n\n if (plan.apiTabDocPages.length > 0) {\n console.warn(\n `[docs-core] ${String(plan.apiTabDocPages.length)} doc page(s) are declared inside API ` +\n `tabs and cannot be placed in the generated sidebar folders: ` +\n `${plan.apiTabDocPages.join(', ')}. Each page stays reachable at its own URL; ` +\n 'to list one in the sidebar, move it into a doc tab.',\n );\n }\n\n return { pages, metas: metas.length, navLinks, methodsByUrl, document };\n}\n"]}

package/dist/generator.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { parseNavigation, planDocsTree, mergeOpenApiDocuments } from './chunk-ICDBGTIJ.js';
+import { parseNavigation, planDocsTree, mergeOpenApiDocuments } from './chunk-JHN5XQPU.js';
 import { readFile, rm, mkdir, writeFile } from 'fs/promises';
 import path from 'path';
@@ -77,7 +77,11 @@ async function generateDocsTree(options) {
       group.push({ order: page.order, slug });
       groupPages.set(page.dir, group);
     }
-    await rm(path.join(outDir, apiDir), { recursive: true, force: true });
+    for (const group of plan.apiGroups) {
+      if (group.root) {
+        await rm(path.join(outDir, group.dir), { recursive: true, force: true });
+      }
+    }
     const createOpenAPI = fumadocs.createOpenAPI;
     const generateFiles = fumadocs.generateFiles;
     await generateFiles({
@@ -112,7 +116,15 @@ async function generateDocsTree(options) {
       path: `${group.dir}/meta.json`,
       content: {
         title: group.title,
-        pages: (groupPages.get(group.dir) ?? []).sort((a, b) => a.order - b.order).map((page) => page.slug)
+        ...group.root ? { root: true } : {},
+        ...group.icon ? { icon: group.icon } : {},
+        pages: [
+          ...(groupPages.get(group.dir) ?? []).map((page) => ({
+            order: page.order,
+            name: page.slug
+          })),
+          ...group.children.map((child) => ({ order: child.order, name: child.folder }))
+        ].sort((a, b) => a.order - b.order).map((entry) => entry.name)
       }
     }))
   ];
@@ -169,6 +181,11 @@ async function generateDocsTree(options) {
     `${JSON.stringify(methodsByUrl, null, 2)}
 `
   );
+  if (plan.apiTabDocPages.length > 0) {
+    console.warn(
+      `[docs-core] ${String(plan.apiTabDocPages.length)} doc page(s) are declared inside API tabs and cannot be placed in the generated sidebar folders: ${plan.apiTabDocPages.join(", ")}. Each page stays reachable at its own URL; to list one in the sidebar, move it into a doc tab.`
+    );
+  }
   return { pages, metas: metas.length, navLinks, methodsByUrl, document };
 }