@blaaiz/docs-core 0.3.0 → 0.4.0

package/dist/{chunk-ICDBGTIJ.js → chunk-JHN5XQPU.js}

@@ -1544,6 +1544,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 = [];
@@ -1551,6 +1565,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);
@@ -1559,38 +1576,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");
@@ -1601,36 +1632,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;
   }
 }
 
@@ -3066,5 +3119,5 @@ function mergeOpenApiDocuments(inputs, options) {
 }
 
 export { AI_PROVIDER_MODELS, AI_PROVIDER_NAMES, AiConfigError, DocsConfigError, InvalidNavigationError, OpenApiMergeError, ProxyTargetError, SESSION_COOKIE, assertAllowedTarget, buildMetadata, buildRobots, buildSearchIndex, buildSessionCookie, buildSitemap, buildThemeCss, clearSessionCookie, createAskAiRoute, createAuthGate, createEmailSignIn, createGoogleAuth, createMarkdownRoute, createSecretSignIn, createSignOut, createSiteAuth, createTryItProxy, createTryItProxyRoute, defineDocsConfig, isAllowedEmail, mdxToMarkdown, mergeOpenApiDocuments, openApiOperationToMarkdown, parseNavigation, planDocsTree, readCookie, resolveAiConfig, searchIndex, signSession, unwrapProxyTarget, validateDocsConfig, verifySession };
-//# sourceMappingURL=chunk-ICDBGTIJ.js.map
-//# sourceMappingURL=chunk-ICDBGTIJ.js.map
+//# sourceMappingURL=chunk-JHN5XQPU.js.map
+//# sourceMappingURL=chunk-JHN5XQPU.js.map