@blaaiz/docs-core 0.4.0 → 0.6.0

package/dist/{chunk-ZKOOKLZ3.js → chunk-6H6OB7YP.js}

@@ -52,6 +52,21 @@ var GLYPHS = {
     /* @__PURE__ */ jsx("rect", { x: "3", y: "11", width: "18", height: "11", rx: "2" }),
     /* @__PURE__ */ jsx("path", { d: "M7 11V7a5 5 0 0 1 10 0v4" })
   ] }),
+  users: /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("circle", { cx: "9", cy: "7", r: "4" }),
+    /* @__PURE__ */ jsx("path", { d: "M2 21a7 7 0 0 1 14 0" }),
+    /* @__PURE__ */ jsx("path", { d: "M16 3.5a4 4 0 0 1 0 7" }),
+    /* @__PURE__ */ jsx("path", { d: "M17.5 14.5a7 7 0 0 1 4.5 6.5" })
+  ] }),
+  building: /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("rect", { x: "4", y: "2", width: "16", height: "20", rx: "2" }),
+    /* @__PURE__ */ jsx("path", { d: "M9 22v-4h6v4" }),
+    /* @__PURE__ */ jsx("path", { d: "M8 6h.01M12 6h.01M16 6h.01M8 10h.01M12 10h.01M16 10h.01M8 14h.01M12 14h.01M16 14h.01" })
+  ] }),
+  clock: /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "9" }),
+    /* @__PURE__ */ jsx("path", { d: "M12 7v5l3 2" })
+  ] }),
   /** A circled `i` — an informational note, and the generic error state. */
   info: /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "10" }),
@@ -120,5 +135,5 @@ function filledIcon(path, options = {}) {
 var PLAY_PATH = "M8 5v14l11-7z";
 
 export { PLAY_PATH, filledIcon, strokeIcon };
-//# sourceMappingURL=chunk-ZKOOKLZ3.js.map
-//# sourceMappingURL=chunk-ZKOOKLZ3.js.map
+//# sourceMappingURL=chunk-6H6OB7YP.js.map
+//# sourceMappingURL=chunk-6H6OB7YP.js.map

package/dist/chunk-6H6OB7YP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ui/icons.tsx"],"names":[],"mappings":";;;AAuBA,IAAM,MAAA,GAAS;AAAA,EACb,uBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,GAAE,gDAAA,EAAiD,CAAA;AAAA,oBACzD,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,eAAA,EAAgB;AAAA,GAAA,EAC1B,CAAA;AAAA,EAEF,IAAA,kBAAM,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,gEAAA,EAAiE,CAAA;AAAA,EAC/E,sBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,GAAE,gBAAA,EAAiB,CAAA;AAAA,oBACzB,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,cAAA,EAAe;AAAA,GAAA,EACzB,CAAA;AAAA,EAEF,wBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,GAAE,yFAAA,EAA0F,CAAA;AAAA,oBAClG,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,iGAAA,EAAkG,CAAA;AAAA,oBAC1G,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,wCAAA,EAAyC,CAAA;AAAA,oBACjD,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,yCAAA,EAA0C;AAAA,GAAA,EACpD,CAAA;AAAA,EAEF,0BACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,GAAE,eAAA,EAAgB,CAAA;AAAA,oBACxB,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,UAAA,EAAW;AAAA,GAAA,EACrB,CAAA;AAAA,EAEF,wBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,GAAE,4GAAA,EAA6G,CAAA;AAAA,oBACrH,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,2CAAA,EAA4C;AAAA,GAAA,EACtD,CAAA;AAAA,EAEF,qBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,GAAE,gEAAA,EAAiE,CAAA;AAAA,oBACzE,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,eAAA,EAAgB,CAAA;AAAA,wBACvB,QAAA,EAAA,EAAO,EAAA,EAAG,OAAM,EAAA,EAAG,MAAA,EAAO,GAAE,KAAA,EAAM;AAAA,GAAA,EACrC,CAAA;AAAA,EAEF,yBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,GAAE,0EAAA,EAA2E,CAAA;AAAA,oBACnF,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,2DAAA,EAA4D,CAAA;AAAA,oBACpE,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,wDAAA,EAAyD;AAAA,GAAA,EACnE,CAAA;AAAA,EAEF,uBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,YAAO,EAAA,EAAG,IAAA,EAAK,EAAA,EAAG,IAAA,EAAK,GAAE,IAAA,EAAK,CAAA;AAAA,oBAC/B,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,iDAAA,EAAkD,CAAA;AAAA,oBAC1D,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,UAAA,EAAW;AAAA,GAAA,EACrB,CAAA;AAAA,EAEF,sBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,GAAA,EAAI,CAAA,EAAE,GAAA,EAAI,OAAM,IAAA,EAAK,MAAA,EAAO,IAAA,EAAK,EAAA,EAAG,GAAA,EAAI,CAAA;AAAA,oBAChD,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,2CAAA,EAA4C;AAAA,GAAA,EACtD,CAAA;AAAA,EAEF,sBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,YAAO,EAAA,EAAG,IAAA,EAAK,EAAA,EAAG,GAAA,EAAI,GAAE,GAAA,EAAI,CAAA;AAAA,oBAC7B,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,sBAAA,EAAuB;AAAA,GAAA,EACjC,CAAA;AAAA,EAEF,sBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,GAAA,EAAI,CAAA,EAAE,IAAA,EAAK,OAAM,IAAA,EAAK,MAAA,EAAO,IAAA,EAAK,EAAA,EAAG,GAAA,EAAI,CAAA;AAAA,oBACjD,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,0BAAA,EAA2B;AAAA,GAAA,EACrC,CAAA;AAAA,EAEF,uBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,YAAO,EAAA,EAAG,GAAA,EAAI,EAAA,EAAG,GAAA,EAAI,GAAE,GAAA,EAAI,CAAA;AAAA,oBAC5B,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,sBAAA,EAAuB,CAAA;AAAA,oBAC/B,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,uBAAA,EAAwB,CAAA;AAAA,oBAChC,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,8BAAA,EAA+B;AAAA,GAAA,EACzC,CAAA;AAAA,EAEF,0BACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,GAAA,EAAI,CAAA,EAAE,GAAA,EAAI,OAAM,IAAA,EAAK,MAAA,EAAO,IAAA,EAAK,EAAA,EAAG,GAAA,EAAI,CAAA;AAAA,oBAChD,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,cAAA,EAAe,CAAA;AAAA,oBACvB,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,sFAAA,EAAuF;AAAA,GAAA,EACjG,CAAA;AAAA,EAEF,uBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,YAAO,EAAA,EAAG,IAAA,EAAK,EAAA,EAAG,IAAA,EAAK,GAAE,GAAA,EAAI,CAAA;AAAA,oBAC9B,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,aAAA,EAAc;AAAA,GAAA,EACxB,CAAA;AAAA;AAAA,EAGF,sBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,YAAO,EAAA,EAAG,IAAA,EAAK,EAAA,EAAG,IAAA,EAAK,GAAE,IAAA,EAAK,CAAA;AAAA,oBAC/B,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,mBAAA,EAAoB,eAAc,OAAA,EAAQ;AAAA,GAAA,EACpD,CAAA;AAAA;AAAA,EAGF,uBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,GAAE,0FAAA,EAA2F,CAAA;AAAA,oBACnG,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,mBAAA,EAAoB,eAAc,OAAA,EAAQ;AAAA,GAAA,EACpD,CAAA;AAAA;AAAA,EAGF,IAAA,kBACE,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,kGAAA,EAAmG,CAAA;AAAA;AAAA,EAG7G,6BACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,YAAO,EAAA,EAAG,IAAA,EAAK,EAAA,EAAG,IAAA,EAAK,GAAE,IAAA,EAAK,CAAA;AAAA,oBAC/B,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,iDAAA,EAAkD,eAAc,OAAA,EAAQ;AAAA,GAAA,EAClF,CAAA;AAAA;AAAA,EAGF,yBACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,6DAAA,EAA8D,aAAA,EAAc,OAAA,EAAQ,CAAA;AAAA,oBAC5F,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,YAAA,EAAa,eAAc,OAAA,EAAQ;AAAA,GAAA,EAC7C,CAAA;AAAA,EAEF,IAAA,kBACE,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,+HAAA,EAAgI,CAAA;AAAA,EAE1I,KAAA,kBAAO,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,iBAAA,EAAkB,CAAA;AAAA,EACjC,WAAA,kBAAa,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,cAAA,EAAe,CAAA;AAAA;AAAA,EAEpC,aAAA,kBAAe,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,2BAAA,EAA4B,CAAA;AAAA;AAAA,EAEnD,yBAAS,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,6BAAA,EAA8B,eAAc,OAAA,EAAQ,CAAA;AAAA,EACrE,0BACE,IAAA,CAAA,QAAA,EAAA,EACE,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,GAAA,EAAI,CAAA,EAAE,GAAA,EAAI,OAAM,IAAA,EAAK,MAAA,EAAO,IAAA,EAAK,EAAA,EAAG,GAAA,EAAI,CAAA;AAAA,oBAChD,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,2CAAA,EAA4C;AAAA,GAAA,EACtD;AAEJ,CAAA;AAkCO,SAAS,UAAA,CAAW,IAAA,EAAiB,OAAA,GAAuB,EAAC,EAAc;AAChF,EAAA,uBACE,GAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MAEE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,MAC1E,GAAI,OAAA,CAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,KAAA,EAAO,OAAA,CAAQ,IAAA,EAAM,MAAA,EAAQ,OAAA,CAAQ,IAAA,EAAK;AAAA,MACnF,OAAA,EAAQ,WAAA;AAAA,MACR,IAAA,EAAK,MAAA;AAAA,MACL,MAAA,EAAO,cAAA;AAAA,MACP,WAAA,EAAa,QAAQ,WAAA,IAAe,CAAA;AAAA,MACnC,GAAI,QAAQ,OAAA,GAAU,EAAE,eAAe,OAAA,EAAS,cAAA,EAAgB,OAAA,EAAQ,GAAI,EAAC;AAAA,MAC9E,aAAA,EAAY,MAAA;AAAA,MAEX,iBAAO,IAAI;AAAA,KAAA;AAAA,IAVP,OAAA,CAAQ;AAAA,GAWf;AAEJ;AAUO,SAAS,UAAA,CAAW,IAAA,EAAc,OAAA,GAAuB,EAAC,EAAc;AAC7E,EAAA,uBACE,GAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MAEE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,MAC1E,GAAI,OAAA,CAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,KAAA,EAAO,OAAA,CAAQ,IAAA,EAAM,MAAA,EAAQ,OAAA,CAAQ,IAAA,EAAK;AAAA,MACnF,OAAA,EAAQ,WAAA;AAAA,MACR,IAAA,EAAK,cAAA;AAAA,MACL,aAAA,EAAY,MAAA;AAAA,MAEZ,QAAA,kBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAG,IAAA,EAAM;AAAA,KAAA;AAAA,IAPV,OAAA,CAAQ;AAAA,GAQf;AAEJ;AAGO,IAAM,SAAA,GAAY","file":"chunk-6H6OB7YP.js","sourcesContent":["import type { ReactNode } from 'react';\n\n/**\n * The framework's inline-SVG glyph set — internal.\n *\n * Five UI modules drew their own icons, and four glyphs were drawn twice: the\n * house on the error screen and in the sidebar icon map, the padlock on the\n * sign-in and the `403` screen, the info circle on both of those, the key in\n * both places again, and the check mark in the copy-page button and the\n * playground. One drawing per glyph now lives here.\n *\n * Nothing is exported from the package: the modules below compose these paths,\n * and `docsIcon` remains the only public icon surface. Zero dependencies — the\n * paths are Lucide-shaped, on the same 24×24 grid, so any glyph works at any\n * size.\n *\n * @packageDocumentation\n */\n\n/**\n * The glyph paths, keyed by name. Each value is the *inside* of an `<svg>`, so\n * a caller decides the size, the stroke, and the class.\n */\nconst GLYPHS = {\n  house: (\n    <>\n      <path d=\"m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z\" />\n      <path d=\"M9 22V12h6v10\" />\n    </>\n  ),\n  book: <path d=\"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H20v20H6.5a2.5 2.5 0 0 1 0-5H20\" />,\n  code: (\n    <>\n      <path d=\"m16 18 6-6-6-6\" />\n      <path d=\"m8 6-6 6 6 6\" />\n    </>\n  ),\n  rocket: (\n    <>\n      <path d=\"M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91 0z\" />\n      <path d=\"m12 15-3-3a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.35 22.35 0 0 1-4 2z\" />\n      <path d=\"M9 12H4s.55-3.03 2-4c1.62-1.08 5 0 5 0\" />\n      <path d=\"M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5\" />\n    </>\n  ),\n  terminal: (\n    <>\n      <path d=\"m4 17 6-6-6-6\" />\n      <path d=\"M12 19h8\" />\n    </>\n  ),\n  wallet: (\n    <>\n      <path d=\"M19 7V4a1 1 0 0 0-1-1H5a2 2 0 0 0 0 4h15a1 1 0 0 1 1 1v4h-3a2 2 0 0 0 0 4h3a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1\" />\n      <path d=\"M3 5v14a2 2 0 0 0 2 2h15a1 1 0 0 0 1-1v-4\" />\n    </>\n  ),\n  key: (\n    <>\n      <path d=\"m15.5 7.5 2.3 2.3a1 1 0 0 0 1.4 0l2.1-2.1a1 1 0 0 0 0-1.4L19 4\" />\n      <path d=\"m21 2-9.6 9.6\" />\n      <circle cx=\"7.5\" cy=\"15.5\" r=\"5.5\" />\n    </>\n  ),\n  webhook: (\n    <>\n      <path d=\"M18 16.98h-5.99c-1.1 0-1.95.94-2.48 1.9A4 4 0 0 1 2 17c.01-.7.2-1.4.57-2\" />\n      <path d=\"m6 17 3.13-5.78c.53-.97.1-2.18-.5-3.1a4 4 0 1 1 6.89-4.06\" />\n      <path d=\"m12 6 3.13 5.73C15.66 12.7 16.9 13 18 13a4 4 0 0 1 0 8\" />\n    </>\n  ),\n  globe: (\n    <>\n      <circle cx=\"12\" cy=\"12\" r=\"10\" />\n      <path d=\"M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20\" />\n      <path d=\"M2 12h20\" />\n    </>\n  ),\n  mail: (\n    <>\n      <rect x=\"2\" y=\"4\" width=\"20\" height=\"16\" rx=\"2\" />\n      <path d=\"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7\" />\n    </>\n  ),\n  user: (\n    <>\n      <circle cx=\"12\" cy=\"8\" r=\"4\" />\n      <path d=\"M4 21a8 8 0 0 1 16 0\" />\n    </>\n  ),\n  lock: (\n    <>\n      <rect x=\"3\" y=\"11\" width=\"18\" height=\"11\" rx=\"2\" />\n      <path d=\"M7 11V7a5 5 0 0 1 10 0v4\" />\n    </>\n  ),\n  users: (\n    <>\n      <circle cx=\"9\" cy=\"7\" r=\"4\" />\n      <path d=\"M2 21a7 7 0 0 1 14 0\" />\n      <path d=\"M16 3.5a4 4 0 0 1 0 7\" />\n      <path d=\"M17.5 14.5a7 7 0 0 1 4.5 6.5\" />\n    </>\n  ),\n  building: (\n    <>\n      <rect x=\"4\" y=\"2\" width=\"16\" height=\"20\" rx=\"2\" />\n      <path d=\"M9 22v-4h6v4\" />\n      <path d=\"M8 6h.01M12 6h.01M16 6h.01M8 10h.01M12 10h.01M16 10h.01M8 14h.01M12 14h.01M16 14h.01\" />\n    </>\n  ),\n  clock: (\n    <>\n      <circle cx=\"12\" cy=\"12\" r=\"9\" />\n      <path d=\"M12 7v5l3 2\" />\n    </>\n  ),\n  /** A circled `i` — an informational note, and the generic error state. */\n  info: (\n    <>\n      <circle cx=\"12\" cy=\"12\" r=\"10\" />\n      <path d=\"M12 8v4M12 16h.01\" strokeLinecap=\"round\" />\n    </>\n  ),\n  /** A warning triangle — a caution, and the `500` screen. */\n  alert: (\n    <>\n      <path d=\"M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\" />\n      <path d=\"M12 9v4M12 17h.01\" strokeLinecap=\"round\" />\n    </>\n  ),\n  /** A light bulb — a tip. */\n  bulb: (\n    <path d=\"M9 18h6M10 22h4M12 2a7 7 0 0 0-4 12.7c.6.5 1 1.3 1 2.1V17h6v-.2c0-.8.4-1.6 1-2.1A7 7 0 0 0 12 2Z\" />\n  ),\n  /** A circle with a cross — the `404` screen. */\n  crossCircle: (\n    <>\n      <circle cx=\"12\" cy=\"12\" r=\"10\" />\n      <path d=\"m14.31 8-1.31 2.4M9.69 8l4.62 8M14.31 16 9.69 8\" strokeLinecap=\"round\" />\n    </>\n  ),\n  /** Struck-through signal bars — the offline screen. */\n  offline: (\n    <>\n      <path d=\"M5 12.55a11 11 0 0 1 14 0M8.5 16.11a6 6 0 0 1 7 0M12 20h.01\" strokeLinecap=\"round\" />\n      <path d=\"m2 2 20 20\" strokeLinecap=\"round\" />\n    </>\n  ),\n  copy: (\n    <path d=\"M9 9h9a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H9a2 2 0 0 1-2-2v-9a2 2 0 0 1 2-2ZM5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1\" />\n  ),\n  check: <path d=\"M20 6 9 17l-5-5\" />,\n  chevronDown: <path d=\"m6 9 6 6 6-6\" />,\n  /** Stacked chevrons — a value this control switches between. */\n  chevronUpDown: <path d=\"m7 15 5 5 5-5M7 9l5-5 5 5\" />,\n  /** An open arc — one turn of a loading spinner. */\n  spinner: <path d=\"M21 12a9 9 0 1 1-6.219-8.56\" strokeLinecap=\"round\" />,\n  markdown: (\n    <>\n      <rect x=\"2\" y=\"5\" width=\"20\" height=\"14\" rx=\"2\" />\n      <path d=\"M6 15V9l3 3 3-3v6M17 9v4m0 0 2-2m-2 2-2-2\" />\n    </>\n  ),\n} satisfies Record<string, ReactNode>;\n\n/** A glyph in {@link GLYPHS}. */\nexport type GlyphName = keyof typeof GLYPHS;\n\n/**\n * How one icon is drawn. Every field is optional, and the defaults match the\n * house style: 24×24 grid, current colour, hidden from assistive technology.\n */\nexport interface IconOptions {\n  /**\n   * React key for the `<svg>`. Set it when a host may place the icon in an\n   * array of children — fumadocs renders a sidebar link as `[icon, text]`, and\n   * an unkeyed element there raises React's \"unique key\" warning in the\n   * consuming site's console.\n   */\n  readonly key?: string;\n  /** Pixel size for `width` and `height`. Omit to let CSS size the icon. */\n  readonly size?: number;\n  /** Stroke width. Default 2. */\n  readonly strokeWidth?: number;\n  /** Round the stroke's ends and joins. Default `false`. */\n  readonly rounded?: boolean;\n  /** Class for the `<svg>`, e.g. a spin animation. */\n  readonly className?: string;\n}\n\n/**\n * Draw a stroked glyph.\n *\n * @param name - the glyph\n * @param options - size, stroke, and class\n * @returns the `<svg>` element\n */\nexport function strokeIcon(name: GlyphName, options: IconOptions = {}): ReactNode {\n  return (\n    <svg\n      key={options.key}\n      {...(options.className === undefined ? {} : { className: options.className })}\n      {...(options.size === undefined ? {} : { width: options.size, height: options.size })}\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth={options.strokeWidth ?? 2}\n      {...(options.rounded ? { strokeLinecap: 'round', strokeLinejoin: 'round' } : {})}\n      aria-hidden=\"true\"\n    >\n      {GLYPHS[name]}\n    </svg>\n  );\n}\n\n/**\n * Draw a filled glyph. Used by the solid play triangle, where a stroke would\n * read as an outline.\n *\n * @param path - the path data\n * @param options - size and class\n * @returns the `<svg>` element\n */\nexport function filledIcon(path: string, options: IconOptions = {}): ReactNode {\n  return (\n    <svg\n      key={options.key}\n      {...(options.className === undefined ? {} : { className: options.className })}\n      {...(options.size === undefined ? {} : { width: options.size, height: options.size })}\n      viewBox=\"0 0 24 24\"\n      fill=\"currentColor\"\n      aria-hidden=\"true\"\n    >\n      <path d={path} />\n    </svg>\n  );\n}\n\n/** A solid right-pointing triangle: run this request. */\nexport const PLAY_PATH = 'M8 5v14l11-7z';\n"]}

package/dist/generator.cjs

@@ -43,12 +43,13 @@ function firstDocFile(items) {
 }
 function planDocsTree(navigation, options = {}) {
   const apiDir = options.apiDir ?? "api";
+  const headings = (options.sidebar ?? "collapsible") === "headings";
   const specs = [];
   const apiPages = [];
   const apiGroups = [];
   const metas = [];
   const rootPages = [];
-  const apiTabDocPages = [];
+  const apiDocLinks = [];
   const apiTabs = navigation.filter((tab) => hasOpenApi(tab.items));
   const soleApiTab = apiTabs.length === 1;
   for (const tab of navigation) {
@@ -59,7 +60,7 @@ function planDocsTree(navigation, options = {}) {
     planDocTab(tab);
   }
   metas.unshift({ path: "meta.json", content: { pages: rootPages } });
-  return { specs, apiPages, apiGroups, metas, apiTabDocPages };
+  return { specs, apiPages, apiGroups, metas, apiDocLinks };
   function planApiTab(tab) {
     const tabDir = soleApiTab ? apiDir : slugify(tab.title);
     rootPages.push(tabDir);
@@ -90,7 +91,7 @@ function planDocsTree(navigation, options = {}) {
         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 });
+        children.push({ order, folder, title: item.title });
         order += 1;
         continue;
       }
@@ -102,7 +103,8 @@ function planDocsTree(navigation, options = {}) {
         order += 1;
         continue;
       }
-      apiTabDocPages.push(item.file);
+      apiDocLinks.push({ file: item.file, dir, order });
+      order += 1;
     }
     return children;
   }
@@ -127,11 +129,11 @@ function planDocsTree(navigation, options = {}) {
         title: tab.title,
         root: true,
         ...tab.icon ? { icon: tab.icon } : {},
-        pages: planDocItems(tab.items, tabDir)
+        pages: planDocItems(tab.items, tabDir, true)
       }
     });
   }
-  function planDocItems(items, dir) {
+  function planDocItems(items, dir, tabLevel) {
     const entries = [];
     for (const item of items) {
       if (item.kind === "doc") {
@@ -146,10 +148,18 @@ function planDocsTree(navigation, options = {}) {
         continue;
       }
       if (groupDir === dir) {
-        entries.push(...planDocItems(item.items, dir));
+        if (headings) {
+          entries.push(`---${item.title}---`);
+        }
+        entries.push(...planDocItems(item.items, dir, false));
+        continue;
+      }
+      const folder = groupDir.slice(dir.length + 1);
+      if (headings && tabLevel) {
+        entries.push(`---${item.title}---`, `...${folder}`);
         continue;
       }
-      entries.push(groupDir.slice(dir.length + 1));
+      entries.push(folder);
     }
     return entries;
   }
@@ -164,7 +174,14 @@ function planDocsTree(navigation, options = {}) {
     }
     metas.push({
       path: `${groupDir}/meta.json`,
-      content: { title: group.title, pages: planDocItems(group.items, groupDir) }
+      content: {
+        title: group.title,
+        // A nested group starts closed in the headings style, whatever the
+        // site's defaultOpenLevel. On a tab-level group the flag is inert:
+        // that folder is extracted, so no folder node renders it.
+        ...headings ? { defaultOpen: false } : {},
+        pages: planDocItems(group.items, groupDir, false)
+      }
     });
     return groupDir;
   }
@@ -386,8 +403,30 @@ function mergeOpenApiDocuments(inputs, options) {
 }
 
 // src/generator/index.ts
-function slugify2(value) {
-  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+function kebabCase(value) {
+  return value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function pageSlug(operation, method, apiPath) {
+  for (const candidate of [operation.summary, operation.operationId]) {
+    if (candidate !== void 0) {
+      const slug = kebabCase(candidate);
+      if (slug !== "") {
+        return slug;
+      }
+    }
+  }
+  return kebabCase(`${method} ${apiPath}`);
+}
+function frontmatterTitle(source) {
+  const block = /^---\r?\n([\s\S]*?)\r?\n---/.exec(source);
+  if (!block?.[1]) {
+    return null;
+  }
+  const line = /^title\s*:\s*(.+)\s*$/m.exec(block[1]);
+  if (!line?.[1]) {
+    return null;
+  }
+  return line[1].replace(/^(['"])(.*)\1$/, "$2");
 }
 function operationKeyOf(content) {
   const match = /operations=\{(\[[\s\S]*?\])\}/.exec(content);
@@ -403,6 +442,15 @@ function operationKeyOf(content) {
   }
 }
 var PROSE_ONLY_INFO = { title: "No API reference", version: "0.0.0" };
+function sidebarStyleOf(docsJson) {
+  const value = docsJson["sidebar"] ?? "collapsible";
+  if (value !== "collapsible" && value !== "headings") {
+    throw new Error(
+      `[docs-core] docs.json has sidebar: ${JSON.stringify(value)}. Use 'headings' (flat group headings, nested groups closed) or 'collapsible' (every group a folder).`
+    );
+  }
+  return value;
+}
 function requireFumadocs(value, apiPageCount) {
   const because = `docs.json publishes ${String(apiPageCount)} API page(s)`;
   if (typeof value !== "object" || value === null) {
@@ -424,8 +472,11 @@ async function generateDocsTree(options) {
   const docsJson = options.docsJson ?? path__default.default.join(options.contentDir, "docs.json");
   const outDir = options.outDir ?? path__default.default.join(options.contentDir, "docs");
   const apiDir = options.apiDir ?? "api";
-  const navigation = parseNavigation(JSON.parse(await promises.readFile(docsJson, "utf8")));
-  const plan = planDocsTree(navigation, { apiDir });
+  const parsed = JSON.parse(await promises.readFile(docsJson, "utf8"));
+  const navigation = parseNavigation(parsed);
+  const sidebar = sidebarStyleOf(parsed);
+  const headings = sidebar === "headings";
+  const plan = planDocsTree(navigation, { apiDir, sidebar });
   const placements = /* @__PURE__ */ new Map();
   const groupPages = /* @__PURE__ */ new Map();
   let pages = 0;
@@ -448,6 +499,7 @@ async function generateDocsTree(options) {
       info: options.info,
       ...options.servers ? { servers: options.servers } : {}
     });
+    const taken = /* @__PURE__ */ new Map();
     for (const page of plan.apiPages) {
       const operation = document.paths[page.apiPath]?.[page.method.toLowerCase()];
       if (!operation) {
@@ -455,7 +507,15 @@ async function generateDocsTree(options) {
           `[docs-core] docs.json references ${page.method} ${page.apiPath}, but ${page.file} defines no such operation.`
         );
       }
-      const slug = operation.operationId ?? slugify2(`${page.method} ${page.apiPath}`);
+      const slug = pageSlug(operation, page.method, page.apiPath);
+      const key = `${page.dir}/${slug}`;
+      const holder = taken.get(key);
+      if (holder !== void 0) {
+        throw new Error(
+          `[docs-core] ${holder} and ${page.method.toUpperCase()} ${page.apiPath} both resolve to the page '${key}'. Give one of them a distinct summary.`
+        );
+      }
+      taken.set(key, `${page.method.toUpperCase()} ${page.apiPath}`);
       placements.set(`${page.method.toUpperCase()} ${page.apiPath}`, { ...page, slug });
       const group = groupPages.get(page.dir) ?? [];
       group.push({ order: page.order, slug });
@@ -494,6 +554,35 @@ async function generateDocsTree(options) {
       }
     });
   }
+  const baseUrl = (options.baseUrl ?? "/docs").replace(/\/$/, "");
+  const docUrl = (file) => {
+    const clean = file.replace(/\/?index$/, "");
+    return clean ? `${baseUrl}/${clean}` : baseUrl;
+  };
+  for (const link of plan.apiDocLinks) {
+    const source = path__default.default.join(outDir, `${link.file}.mdx`);
+    let title = null;
+    try {
+      title = frontmatterTitle(await promises.readFile(source, "utf8"));
+    } catch {
+      console.warn(
+        `[docs-core] docs.json lists ${link.file} inside an API tab, but ${source} does not exist. The sidebar entry is skipped.`
+      );
+      continue;
+    }
+    if (title === null) {
+      title = link.file.split("/").pop() ?? link.file;
+      console.warn(
+        `[docs-core] ${link.file}.mdx has no frontmatter title; its sidebar entry falls back to '${title}'.`
+      );
+    }
+    const group = groupPages.get(link.dir) ?? [];
+    group.push({
+      order: link.order,
+      slug: `[${title.replace(/[[\]()]/g, "")}](${docUrl(link.file)})`
+    });
+    groupPages.set(link.dir, group);
+  }
   const metas = [
     ...plan.metas,
     ...plan.apiGroups.map((group) => ({
@@ -502,13 +591,21 @@ async function generateDocsTree(options) {
         title: group.title,
         ...group.root ? { root: true } : {},
         ...group.icon ? { icon: group.icon } : {},
+        // A nested group starts closed in the headings style, whatever the
+        // site's defaultOpenLevel.
+        ...headings && !group.root ? { defaultOpen: false } : {},
         pages: [
           ...(groupPages.get(group.dir) ?? []).map((page) => ({
             order: page.order,
-            name: page.slug
+            names: [page.slug]
           })),
-          ...group.children.map((child) => ({ order: child.order, name: child.folder }))
-        ].sort((a, b) => a.order - b.order).map((entry) => entry.name)
+          ...group.children.map((child) => ({
+            order: child.order,
+            // In the headings style a tab-level group is a flat heading with
+            // its pages extracted beneath it, not a collapsible folder.
+            names: headings && group.root ? [`---${child.title}---`, `...${child.folder}`] : [child.folder]
+          }))
+        ].sort((a, b) => a.order - b.order).flatMap((entry) => entry.names)
       }
     }))
   ];
@@ -518,11 +615,6 @@ async function generateDocsTree(options) {
     await promises.writeFile(target, `${JSON.stringify(meta.content, null, 2)}
 `);
   }
-  const baseUrl = (options.baseUrl ?? "/docs").replace(/\/$/, "");
-  const docUrl = (file) => {
-    const clean = file.replace(/\/?index$/, "");
-    return clean ? `${baseUrl}/${clean}` : baseUrl;
-  };
   const firstUrl = (items) => {
     for (const item of items) {
       if (item.kind === "group") {
@@ -541,12 +633,36 @@ async function generateDocsTree(options) {
     }
     return void 0;
   };
+  const tabDocFiles = (items) => items.flatMap((item) => {
+    if (item.kind === "group") {
+      return tabDocFiles(item.items);
+    }
+    return item.kind === "doc" ? [item.file] : [];
+  });
+  const apiTabRoots = plan.apiGroups.filter((group) => group.root).map((group) => group.dir);
+  let apiTabIndex = 0;
   const navLinks = [];
   for (const tab of navigation) {
+    let match;
+    if (hasOpenApi(tab.items)) {
+      const root = apiTabRoots[apiTabIndex];
+      apiTabIndex += 1;
+      if (root !== void 0) {
+        match = [
+          .../* @__PURE__ */ new Set([`${baseUrl}/${root}`, ...tabDocFiles(tab.items).map((file) => docUrl(file))])
+        ];
+      }
+    }
     const url = firstUrl(tab.items);
-    if (url) {
-      navLinks.push({ text: tab.title, url, ...tab.icon ? { icon: tab.icon } : {} });
+    if (!url) {
+      continue;
     }
+    navLinks.push({
+      text: tab.title,
+      url,
+      ...tab.icon ? { icon: tab.icon } : {},
+      ...match ? { match } : {}
+    });
   }
   await promises.writeFile(
     path__default.default.join(options.contentDir, "nav.json"),
@@ -554,10 +670,54 @@ async function generateDocsTree(options) {
 `
   );
   const methodsByUrl = {};
+  const sourcesByUrl = {};
   for (const page of plan.apiPages) {
     const placement = placements.get(`${page.method.toUpperCase()} ${page.apiPath}`);
     if (placement) {
-      methodsByUrl[`${baseUrl}/${placement.dir}/${placement.slug}`] = page.method.toUpperCase();
+      const url = `${baseUrl}/${placement.dir}/${placement.slug}`;
+      methodsByUrl[url] = page.method.toUpperCase();
+      sourcesByUrl[url] = {
+        file: page.file,
+        method: page.method.toUpperCase(),
+        route: page.apiPath
+      };
+    }
+  }
+  const sourcesPath = path__default.default.join(options.contentDir, "api-sources.json");
+  const redirectsPath = path__default.default.join(options.contentDir, "redirects.json");
+  const previousSources = await readJson(sourcesPath);
+  const redirects = await readJson(redirectsPath) ?? {};
+  if (previousSources) {
+    const urlByOperation = new Map(
+      Object.entries(sourcesByUrl).map(([url, s]) => [`${s.method} ${s.route}`, url])
+    );
+    for (const [oldUrl, source] of Object.entries(previousSources)) {
+      const newUrl = urlByOperation.get(`${source.method} ${source.route}`);
+      if (newUrl !== void 0 && newUrl !== oldUrl) {
+        redirects[oldUrl] = newUrl;
+      }
+    }
+  }
+  const finalDestination = (from) => {
+    const seen = /* @__PURE__ */ new Set([from]);
+    let current = redirects[from];
+    while (current !== void 0 && !(current in sourcesByUrl)) {
+      if (seen.has(current)) {
+        return null;
+      }
+      seen.add(current);
+      current = redirects[current];
+    }
+    return current ?? null;
+  };
+  const liveRedirects = {};
+  for (const oldUrl of Object.keys(redirects)) {
+    if (oldUrl in sourcesByUrl) {
+      continue;
+    }
+    const destination = finalDestination(oldUrl);
+    if (destination !== null && destination !== oldUrl) {
+      liveRedirects[oldUrl] = destination;
     }
   }
   await promises.writeFile(
@@ -565,12 +725,26 @@ 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.`
-    );
+  await promises.writeFile(sourcesPath, `${JSON.stringify(sourcesByUrl, null, 2)}
+`);
+  await promises.writeFile(redirectsPath, `${JSON.stringify(liveRedirects, null, 2)}
+`);
+  return {
+    pages,
+    metas: metas.length,
+    navLinks,
+    methodsByUrl,
+    sourcesByUrl,
+    redirects: liveRedirects,
+    document
+  };
+}
+async function readJson(file) {
+  try {
+    return JSON.parse(await promises.readFile(file, "utf8"));
+  } catch {
+    return null;
   }
-  return { pages, metas: metas.length, navLinks, methodsByUrl, document };
 }
 
 exports.generateDocsTree = generateDocsTree;