@takazudo/zudo-doc 9.1.0 → 9.1.1

package/CHANGELOG.md

@@ -8,6 +8,12 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [9.1.1] - 2026-10-30
+
+### Bug Fixes
+
+- `categoryMatch` once again owns its dash "satellite" directories, fixing a 9.1.0 regression. With the 9.1.0 whole-segment rule, `categoryMatch: "claude"` stopped claiming the generated `claude-md/`, `claude-skills/`, and `claude-commands/` trees (and `"codex"` its `codex-*` trees), so those pages lost the Claude tab and its sidebar. A value now owns `foo`, `foo/...`, and `foo-*`, but still not `foo2`; the longest matching value wins, so an explicit `foo-bar` keeps its own section. (4975426b)
+
 ## [9.1.0] - 2026-10-28
 
 ### Features

package/dist/config-assertions/index.d.ts

@@ -111,8 +111,8 @@ export declare function assertValidSearchMaxBodyLength(searchMaxBodyLength: numb
  * Warn about `categoryMatch` values that cannot express the intended
  * dropdown grouping.
  *
- * A category matcher is compared with the first slug segment by the nav-scope
- * resolver, so a value containing `/` never matches. Likewise, duplicate
+ * A category matcher is compared with the first slug segment (and its `-`
+ * satellites) by the nav-scope resolver, so a value containing `/` never matches. Likewise, duplicate
  * child values make every matching child category-active. Children grouped
  * under one top-level directory should omit `categoryMatch` and rely on the
  * deepest matching child path; Learn-style children should use distinct

package/dist/nav-scope/index.d.ts

@@ -17,6 +17,17 @@ export interface NavScopeHeaderNavItem {
  * headerNav array instead of reading `settings.headerNav` directly.
  */
 export declare function getCategoryOrder(headerNav: NavScopeHeaderNavItem[]): string[];
+/**
+ * Resolve which explicit categoryMatch owns a slug's top-level category.
+ *
+ * A matcher `m` owns the top-level segment `m` itself and its dash
+ * "satellites" (`m-*`), the same convention `groupSatelliteNodes` uses for the
+ * generated `claude-md/`, `claude-skills/`, `codex-agents-md/`, … trees. `foo`
+ * does not own `foo2`. When several matchers apply, the longest wins, so an
+ * explicit `foo-bar` keeps `foo-bar` and `foo-bar-*` out of `foo`. `"!"` is
+ * ignored; callers apply the fallback themselves.
+ */
+export declare function resolveCategoryOwner(slug: string, explicitMatches: readonly string[]): string | undefined;
 /**
  * Given a doc's slug (e.g. "getting-started/introduction" or "guides/overview"),
  * return the categoryMatch value of the headerNav item it belongs to.
@@ -28,7 +39,8 @@ export declare function getNavSectionForSlug(slug: string, headerNav: NavScopeHe
 /**
  * Filter top-level NavNodes by a headerNav categoryMatch value.
  * - `"!"` means everything NOT claimed by explicit matchers
- * - `"claude"` means nodes whose slug is `"claude"` or under `"claude/"`
+ * - `"claude"` means nodes owned by `"claude"` per `resolveCategoryOwner`
+ *   (`claude`, `claude/…`, and dash satellites such as `claude-md`)
  * - `undefined` means all nodes
  *
  * Parameterized version of the host's `getNavSubtree()` — receives the

package/dist/nav-scope/index.js

@@ -10,31 +10,36 @@ function getCategoryOrder(headerNav) {
     return matches;
   });
 }
-function getNavSectionForSlug(slug, headerNav) {
+function resolveCategoryOwner(slug, explicitMatches) {
   const topCategory = slug.split("/")[0] ?? "";
-  const all = getCategoryOrder(headerNav);
-  const explicitMatch = all.find((cm) => cm !== "!" && topCategory === cm);
+  let owner;
+  for (const cm of explicitMatches) {
+    if (cm === "!" || !cm) continue;
+    if (topCategory !== cm && !topCategory.startsWith(cm + "-")) continue;
+    if (owner === void 0 || cm.length > owner.length) owner = cm;
+  }
+  return owner;
+}
+function getNavSectionForSlug(slug, headerNav) {
+  const explicitMatch = resolveCategoryOwner(slug, getCategoryOrder(headerNav));
   if (explicitMatch !== void 0) return explicitMatch;
   const defaultItem = headerNav.find(
     (item) => item.categoryMatch === "!"
   );
   return defaultItem?.categoryMatch;
 }
-function matchesCategory(slug, match) {
-  return slug === match || slug.startsWith(match + "/");
-}
 function getNavSubtree(tree, categoryMatch, headerNav) {
   if (!categoryMatch) return tree;
+  const explicitMatches = getCategoryOrder(headerNav);
   if (categoryMatch === "!") {
-    const explicitPrefixes = getCategoryOrder(headerNav).filter((cm) => cm !== "!");
-    return tree.filter(
-      (node) => !explicitPrefixes.some((prefix) => matchesCategory(node.slug, prefix))
-    );
+    return tree.filter((node) => resolveCategoryOwner(node.slug, explicitMatches) === void 0);
   }
-  return tree.filter((node) => matchesCategory(node.slug, categoryMatch));
+  const candidates = explicitMatches.includes(categoryMatch) ? explicitMatches : [...explicitMatches, categoryMatch];
+  return tree.filter((node) => resolveCategoryOwner(node.slug, candidates) === categoryMatch);
 }
 export {
   getCategoryOrder,
   getNavSectionForSlug,
-  getNavSubtree
+  getNavSubtree,
+  resolveCategoryOwner
 };

package/dist/sidebar-utils/index.js

@@ -1,3 +1,4 @@
+import { resolveCategoryOwner } from "../nav-scope/index.js";
 function findNode(tree, slug) {
   for (const node of tree) {
     if (node.slug === slug) return node;
@@ -65,17 +66,13 @@ function resolveItem(item, tree, lang) {
     }
   }
 }
-function matchesCategory(slug, match) {
-  return slug === match || slug.startsWith(match + "/");
-}
 function filterByCategory(tree, categoryMatch, explicitPrefixes) {
   if (!categoryMatch) return tree;
   if (categoryMatch === "!") {
-    return tree.filter(
-      (node) => !explicitPrefixes.some((prefix) => matchesCategory(node.slug, prefix))
-    );
+    return tree.filter((node) => resolveCategoryOwner(node.slug, explicitPrefixes) === void 0);
   }
-  return tree.filter((node) => matchesCategory(node.slug, categoryMatch));
+  const candidates = explicitPrefixes.includes(categoryMatch) ? explicitPrefixes : [...explicitPrefixes, categoryMatch];
+  return tree.filter((node) => resolveCategoryOwner(node.slug, candidates) === categoryMatch);
 }
 function buildSidebarForSection(docs, lang, categoryMatch, categoryMeta, sidebars, buildNavTree, explicitCategoryPrefixes) {
   const tree = buildNavTree(docs, lang, categoryMeta);

package/dist/site-schema/nav-tree.js

@@ -1,5 +1,6 @@
 import { buildSidebarTree } from "../sidebar-tree/build-tree.js";
 import { toRouteSlug } from "../slug/index.js";
+import { resolveCategoryOwner } from "../nav-scope/index.js";
 function isNavVisible(doc) {
   return !doc.data.unlisted && !doc.data.standalone;
 }
@@ -88,7 +89,7 @@ function groupSatelliteNodes(tree, prefixes) {
     const satelliteIdxs = [];
     for (let i = 0; i < result.length; i++) {
       const node = result[i];
-      if (node && i !== primaryIdx && node.slug.startsWith(`${prefix}-`)) {
+      if (node && i !== primaryIdx && node.slug.startsWith(`${prefix}-`) && resolveCategoryOwner(node.slug, prefixes) === prefix) {
         satelliteIdxs.push(i);
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "9.1.0",
+  "version": "9.1.1",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -809,7 +809,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.12",
     "zod": "^4.6.7",
-    "@takazudo/zudo-doc-history-server": "9.1.0"
+    "@takazudo/zudo-doc-history-server": "9.1.1"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",