@blaaiz/docs-core 0.7.5 → 0.8.0

package/dist/index.js

@@ -1,3 +1,3 @@
-export { AI_PROVIDER_MODELS, AI_PROVIDER_NAMES, AiConfigError, DocsConfigError, InvalidNavigationError, OpenApiMergeError, ProxyTargetError, SESSION_COOKIE, assertAllowedTarget, buildLlmsTxt, buildMetadata, buildRobots, buildSearchIndex, buildSessionCookie, buildSitemap, buildThemeCss, clearSessionCookie, createAskAiRoute, createAuthGate, createEmailSignIn, createGoogleAuth, createMarkdownRoute, createSecretSignIn, createSignOut, createSiteAuth, createTryItProxy, createTryItProxyRoute, curlCodeUsage, defineDocsConfig, isAllowedEmail, isMarkdownRouteRequest, markdownRewriteTarget, mdxToMarkdown, mergeOpenApiDocuments, openApiOperationToMarkdown, parseNavigation, planDocsTree, readCookie, redirectTarget, resolveAiConfig, searchIndex, signSession, unwrapProxyTarget, validateDocsConfig, verifySession } from './chunk-G6EOGADC.js';
+export { AI_PROVIDER_MODELS, AI_PROVIDER_NAMES, AiConfigError, DocsConfigError, InvalidNavigationError, OpenApiMergeError, ProxyTargetError, SESSION_COOKIE, assertAllowedTarget, buildLlmsTxt, buildMetadata, buildRobots, buildSearchIndex, buildSessionCookie, buildSitemap, buildThemeCss, clearSessionCookie, createAskAiRoute, createAuthGate, createEmailSignIn, createGoogleAuth, createMarkdownRoute, createSecretSignIn, createSignOut, createSiteAuth, createTryItProxy, createTryItProxyRoute, curlCodeUsage, defineDocsConfig, isAllowedEmail, isMarkdownRouteRequest, markdownRewriteTarget, mdxToMarkdown, mergeOpenApiDocuments, openApiOperationToMarkdown, parseNavigation, planDocsTree, readCookie, redirectTarget, resolveAiConfig, searchIndex, signSession, unwrapProxyTarget, validateDocsConfig, verifySession } from './chunk-W74K64WH.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/mdx.cjs

@@ -0,0 +1,104 @@
+'use strict';
+
+// src/mdx/index.ts
+function isCode(node) {
+  return node.type === "code";
+}
+function isJsxElement(node) {
+  return node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement";
+}
+function walk(node, visit) {
+  const children = node.children ?? [];
+  for (const [index, child] of children.entries()) {
+    visit(child, index, node);
+    walk(child, visit);
+  }
+}
+function parseMeta(meta) {
+  const tokens = meta.match(/[^\s"]*"[^"]*"|\S+/g) ?? [];
+  const bare = [];
+  const rest = [];
+  let explicit;
+  for (const token of tokens) {
+    const titled = /^title=(?:"([^"]*)"|(\S+))$/.exec(token);
+    if (titled) {
+      explicit ??= titled[1] ?? titled[2];
+      continue;
+    }
+    if (token.includes("=") || token.startsWith("{") || token.startsWith("[")) {
+      rest.push(token);
+    } else {
+      bare.push(token);
+    }
+  }
+  if (explicit !== void 0) {
+    return { title: explicit, rest: [...rest, ...bare] };
+  }
+  return { title: bare.length > 0 ? bare.join(" ") : void 0, rest };
+}
+function serializeMeta(parsed, withTitle) {
+  const tokens = withTitle && parsed.title !== void 0 ? [`title="${parsed.title.replaceAll('"', "")}"`, ...parsed.rest] : parsed.rest;
+  return tokens.length > 0 ? tokens.join(" ") : void 0;
+}
+function takeTitle(code) {
+  if (typeof code.meta !== "string" || code.meta === "") {
+    return void 0;
+  }
+  const parsed = parseMeta(code.meta);
+  code.meta = serializeMeta(parsed, false) ?? null;
+  return parsed.title;
+}
+function normalizeTitle(code) {
+  if (typeof code.meta !== "string" || code.meta === "") {
+    return;
+  }
+  code.meta = serializeMeta(parseMeta(code.meta), true) ?? null;
+}
+function remarkCodeTitles() {
+  return (tree) => {
+    const root = tree;
+    walk(root, (node) => {
+      if (!isJsxElement(node) || node.name !== "CodeGroup") {
+        return;
+      }
+      const fences = (node.children ?? []).filter(isCode);
+      if (fences.length === 0) {
+        return;
+      }
+      const labels = fences.map(
+        (fence, index) => takeTitle(fence) ?? fence.lang ?? `Code ${String(index + 1)}`
+      );
+      node.attributes ??= [];
+      node.attributes.push({
+        type: "mdxJsxAttribute",
+        name: "labels",
+        value: JSON.stringify(labels)
+      });
+    });
+    walk(root, (node) => {
+      if (isCode(node)) {
+        normalizeTitle(node);
+      }
+    });
+  };
+}
+function remarkMermaid() {
+  return (tree) => {
+    walk(tree, (node, index, parent) => {
+      if (isCode(node) && node.lang === "mermaid") {
+        const element = {
+          type: "mdxJsxFlowElement",
+          name: "Mermaid",
+          attributes: [{ type: "mdxJsxAttribute", name: "chart", value: node.value ?? "" }],
+          children: []
+        };
+        (parent.children ?? [])[index] = element;
+      }
+    });
+  };
+}
+
+exports.remarkCodeTitles = remarkCodeTitles;
+exports.remarkMermaid = remarkMermaid;
+//# sourceMappingURL=mdx.cjs.map
+//# sourceMappingURL=mdx.cjs.map

package/dist/mdx.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mdx/index.ts"],"names":[],"mappings":"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","file":"mdx.cjs","sourcesContent":["/**\n * Remark plugins for the docs MDX pipeline. A site wires them into\n * `source.config.ts`:\n *\n * ```ts\n * import { remarkCodeTitles, remarkMermaid } from '@blaaiz/docs-core/mdx';\n *\n * export default defineConfig({\n *   mdxOptions: { remarkPlugins: [remarkGfm, remarkCodeTitles, remarkMermaid] },\n * });\n * ```\n *\n * `remarkCodeTitles` accepts both fence-title spellings — fumadocs' explicit\n * `title=\"NGN\"` and Mintlify's bare words after the language (`json NGN`) — so\n * content migrated from Mintlify keeps its code-block titles and `<CodeGroup>`\n * tab labels without a rewrite. `remarkMermaid` turns mermaid fences into the\n * `<Mermaid>` client component.\n *\n * @packageDocumentation\n */\n\ninterface MdastNode {\n  type: string;\n  children?: MdastNode[];\n}\n\ninterface CodeNode extends MdastNode {\n  type: 'code';\n  lang?: string | null;\n  meta?: string | null;\n  value?: string;\n}\n\ninterface MdxJsxAttribute {\n  type: 'mdxJsxAttribute';\n  name: string;\n  value: unknown;\n}\n\ninterface MdxJsxElement extends MdastNode {\n  name?: string | null;\n  attributes?: MdxJsxAttribute[];\n}\n\nfunction isCode(node: MdastNode): node is CodeNode {\n  return node.type === 'code';\n}\n\nfunction isJsxElement(node: MdastNode): node is MdxJsxElement {\n  return node.type === 'mdxJsxFlowElement' || node.type === 'mdxJsxTextElement';\n}\n\nfunction walk(\n  node: MdastNode,\n  visit: (node: MdastNode, index: number, parent: MdastNode) => void,\n): void {\n  const children = node.children ?? [];\n  for (const [index, child] of children.entries()) {\n    visit(child, index, node);\n    walk(child, visit);\n  }\n}\n\n/**\n * A fence's parsed info-string meta: the resolved title (explicit\n * `title=\"...\"` wins over bare words) and every other token, order preserved.\n */\ninterface ParsedMeta {\n  title: string | undefined;\n  rest: string[];\n}\n\nfunction parseMeta(meta: string): ParsedMeta {\n  const tokens = meta.match(/[^\\s\"]*\"[^\"]*\"|\\S+/g) ?? [];\n  const bare: string[] = [];\n  const rest: string[] = [];\n  let explicit: string | undefined;\n  for (const token of tokens) {\n    const titled = /^title=(?:\"([^\"]*)\"|(\\S+))$/.exec(token);\n    if (titled) {\n      explicit ??= titled[1] ?? titled[2];\n      continue;\n    }\n    // A key=value option or a {1,3} highlight range is meta in its own right;\n    // only plain words are a Mintlify-style title.\n    if (token.includes('=') || token.startsWith('{') || token.startsWith('[')) {\n      rest.push(token);\n    } else {\n      bare.push(token);\n    }\n  }\n  if (explicit !== undefined) {\n    return { title: explicit, rest: [...rest, ...bare] };\n  }\n  return { title: bare.length > 0 ? bare.join(' ') : undefined, rest };\n}\n\nfunction serializeMeta(parsed: ParsedMeta, withTitle: boolean): string | undefined {\n  const tokens =\n    withTitle && parsed.title !== undefined\n      ? [`title=\"${parsed.title.replaceAll('\"', '')}\"`, ...parsed.rest]\n      : parsed.rest;\n  return tokens.length > 0 ? tokens.join(' ') : undefined;\n}\n\n/**\n * Reads and removes the title from a fence inside a `<CodeGroup>`. The group\n * shows the title on its tab, so leaving it on the fence would render a\n * duplicate per-block header inside the panel.\n */\nfunction takeTitle(code: CodeNode): string | undefined {\n  if (typeof code.meta !== 'string' || code.meta === '') {\n    return undefined;\n  }\n  const parsed = parseMeta(code.meta);\n  code.meta = serializeMeta(parsed, false) ?? null;\n  return parsed.title;\n}\n\nfunction normalizeTitle(code: CodeNode): void {\n  if (typeof code.meta !== 'string' || code.meta === '') {\n    return;\n  }\n  code.meta = serializeMeta(parseMeta(code.meta), true) ?? null;\n}\n\n/**\n * Fence-title compatibility for content written for Mintlify. Inside a\n * `<CodeGroup>`, each fence's title (either spelling) moves onto the group as\n * its tab label — the `labels` attribute `<CodeGroup>` reads — and comes off\n * the fence so the panel renders without its own header. Everywhere else a\n * bare-word meta becomes `title=\"...\"`, which the code-block component renders\n * as the block's header, exactly as it would the explicit spelling.\n *\n * @public\n */\nexport function remarkCodeTitles() {\n  return (tree: unknown): void => {\n    const root = tree as MdastNode;\n    walk(root, (node) => {\n      if (!isJsxElement(node) || node.name !== 'CodeGroup') {\n        return;\n      }\n      const fences = (node.children ?? []).filter(isCode);\n      if (fences.length === 0) {\n        return;\n      }\n      const labels = fences.map(\n        (fence, index) => takeTitle(fence) ?? fence.lang ?? `Code ${String(index + 1)}`,\n      );\n      node.attributes ??= [];\n      node.attributes.push({\n        type: 'mdxJsxAttribute',\n        name: 'labels',\n        value: JSON.stringify(labels),\n      });\n    });\n    walk(root, (node) => {\n      if (isCode(node)) {\n        normalizeTitle(node);\n      }\n    });\n  };\n}\n\n/**\n * Turns mermaid fences into a `<Mermaid chart=\"...\" />` element so\n * diagrams render as diagrams, not source. The site maps `Mermaid` to the\n * client component exported from `@blaaiz/docs-core/ui/mermaid`.\n *\n * @public\n */\nexport function remarkMermaid() {\n  return (tree: unknown): void => {\n    walk(tree as MdastNode, (node, index, parent) => {\n      if (isCode(node) && node.lang === 'mermaid') {\n        const element: MdxJsxElement = {\n          type: 'mdxJsxFlowElement',\n          name: 'Mermaid',\n          attributes: [{ type: 'mdxJsxAttribute', name: 'chart', value: node.value ?? '' }],\n          children: [],\n        };\n        (parent.children ?? [])[index] = element;\n      }\n    });\n  };\n}\n"]}

package/dist/mdx.d.cts

@@ -0,0 +1,41 @@
+/**
+ * Remark plugins for the docs MDX pipeline. A site wires them into
+ * `source.config.ts`:
+ *
+ * ```ts
+ * import { remarkCodeTitles, remarkMermaid } from '@blaaiz/docs-core/mdx';
+ *
+ * export default defineConfig({
+ *   mdxOptions: { remarkPlugins: [remarkGfm, remarkCodeTitles, remarkMermaid] },
+ * });
+ * ```
+ *
+ * `remarkCodeTitles` accepts both fence-title spellings — fumadocs' explicit
+ * `title="NGN"` and Mintlify's bare words after the language (`json NGN`) — so
+ * content migrated from Mintlify keeps its code-block titles and `<CodeGroup>`
+ * tab labels without a rewrite. `remarkMermaid` turns mermaid fences into the
+ * `<Mermaid>` client component.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Fence-title compatibility for content written for Mintlify. Inside a
+ * `<CodeGroup>`, each fence's title (either spelling) moves onto the group as
+ * its tab label — the `labels` attribute `<CodeGroup>` reads — and comes off
+ * the fence so the panel renders without its own header. Everywhere else a
+ * bare-word meta becomes `title="..."`, which the code-block component renders
+ * as the block's header, exactly as it would the explicit spelling.
+ *
+ * @public
+ */
+declare function remarkCodeTitles(): (tree: unknown) => void;
+/**
+ * Turns mermaid fences into a `<Mermaid chart="..." />` element so
+ * diagrams render as diagrams, not source. The site maps `Mermaid` to the
+ * client component exported from `@blaaiz/docs-core/ui/mermaid`.
+ *
+ * @public
+ */
+declare function remarkMermaid(): (tree: unknown) => void;
+
+export { remarkCodeTitles, remarkMermaid };

package/dist/mdx.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Remark plugins for the docs MDX pipeline. A site wires them into
+ * `source.config.ts`:
+ *
+ * ```ts
+ * import { remarkCodeTitles, remarkMermaid } from '@blaaiz/docs-core/mdx';
+ *
+ * export default defineConfig({
+ *   mdxOptions: { remarkPlugins: [remarkGfm, remarkCodeTitles, remarkMermaid] },
+ * });
+ * ```
+ *
+ * `remarkCodeTitles` accepts both fence-title spellings — fumadocs' explicit
+ * `title="NGN"` and Mintlify's bare words after the language (`json NGN`) — so
+ * content migrated from Mintlify keeps its code-block titles and `<CodeGroup>`
+ * tab labels without a rewrite. `remarkMermaid` turns mermaid fences into the
+ * `<Mermaid>` client component.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Fence-title compatibility for content written for Mintlify. Inside a
+ * `<CodeGroup>`, each fence's title (either spelling) moves onto the group as
+ * its tab label — the `labels` attribute `<CodeGroup>` reads — and comes off
+ * the fence so the panel renders without its own header. Everywhere else a
+ * bare-word meta becomes `title="..."`, which the code-block component renders
+ * as the block's header, exactly as it would the explicit spelling.
+ *
+ * @public
+ */
+declare function remarkCodeTitles(): (tree: unknown) => void;
+/**
+ * Turns mermaid fences into a `<Mermaid chart="..." />` element so
+ * diagrams render as diagrams, not source. The site maps `Mermaid` to the
+ * client component exported from `@blaaiz/docs-core/ui/mermaid`.
+ *
+ * @public
+ */
+declare function remarkMermaid(): (tree: unknown) => void;
+
+export { remarkCodeTitles, remarkMermaid };

package/dist/mdx.js

@@ -0,0 +1,101 @@
+// src/mdx/index.ts
+function isCode(node) {
+  return node.type === "code";
+}
+function isJsxElement(node) {
+  return node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement";
+}
+function walk(node, visit) {
+  const children = node.children ?? [];
+  for (const [index, child] of children.entries()) {
+    visit(child, index, node);
+    walk(child, visit);
+  }
+}
+function parseMeta(meta) {
+  const tokens = meta.match(/[^\s"]*"[^"]*"|\S+/g) ?? [];
+  const bare = [];
+  const rest = [];
+  let explicit;
+  for (const token of tokens) {
+    const titled = /^title=(?:"([^"]*)"|(\S+))$/.exec(token);
+    if (titled) {
+      explicit ??= titled[1] ?? titled[2];
+      continue;
+    }
+    if (token.includes("=") || token.startsWith("{") || token.startsWith("[")) {
+      rest.push(token);
+    } else {
+      bare.push(token);
+    }
+  }
+  if (explicit !== void 0) {
+    return { title: explicit, rest: [...rest, ...bare] };
+  }
+  return { title: bare.length > 0 ? bare.join(" ") : void 0, rest };
+}
+function serializeMeta(parsed, withTitle) {
+  const tokens = withTitle && parsed.title !== void 0 ? [`title="${parsed.title.replaceAll('"', "")}"`, ...parsed.rest] : parsed.rest;
+  return tokens.length > 0 ? tokens.join(" ") : void 0;
+}
+function takeTitle(code) {
+  if (typeof code.meta !== "string" || code.meta === "") {
+    return void 0;
+  }
+  const parsed = parseMeta(code.meta);
+  code.meta = serializeMeta(parsed, false) ?? null;
+  return parsed.title;
+}
+function normalizeTitle(code) {
+  if (typeof code.meta !== "string" || code.meta === "") {
+    return;
+  }
+  code.meta = serializeMeta(parseMeta(code.meta), true) ?? null;
+}
+function remarkCodeTitles() {
+  return (tree) => {
+    const root = tree;
+    walk(root, (node) => {
+      if (!isJsxElement(node) || node.name !== "CodeGroup") {
+        return;
+      }
+      const fences = (node.children ?? []).filter(isCode);
+      if (fences.length === 0) {
+        return;
+      }
+      const labels = fences.map(
+        (fence, index) => takeTitle(fence) ?? fence.lang ?? `Code ${String(index + 1)}`
+      );
+      node.attributes ??= [];
+      node.attributes.push({
+        type: "mdxJsxAttribute",
+        name: "labels",
+        value: JSON.stringify(labels)
+      });
+    });
+    walk(root, (node) => {
+      if (isCode(node)) {
+        normalizeTitle(node);
+      }
+    });
+  };
+}
+function remarkMermaid() {
+  return (tree) => {
+    walk(tree, (node, index, parent) => {
+      if (isCode(node) && node.lang === "mermaid") {
+        const element = {
+          type: "mdxJsxFlowElement",
+          name: "Mermaid",
+          attributes: [{ type: "mdxJsxAttribute", name: "chart", value: node.value ?? "" }],
+          children: []
+        };
+        (parent.children ?? [])[index] = element;
+      }
+    });
+  };
+}
+
+export { remarkCodeTitles, remarkMermaid };
+//# sourceMappingURL=mdx.js.map
+//# sourceMappingURL=mdx.js.map

package/dist/mdx.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mdx/index.ts"],"names":[],"mappings":"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","file":"mdx.js","sourcesContent":["/**\n * Remark plugins for the docs MDX pipeline. A site wires them into\n * `source.config.ts`:\n *\n * ```ts\n * import { remarkCodeTitles, remarkMermaid } from '@blaaiz/docs-core/mdx';\n *\n * export default defineConfig({\n *   mdxOptions: { remarkPlugins: [remarkGfm, remarkCodeTitles, remarkMermaid] },\n * });\n * ```\n *\n * `remarkCodeTitles` accepts both fence-title spellings — fumadocs' explicit\n * `title=\"NGN\"` and Mintlify's bare words after the language (`json NGN`) — so\n * content migrated from Mintlify keeps its code-block titles and `<CodeGroup>`\n * tab labels without a rewrite. `remarkMermaid` turns mermaid fences into the\n * `<Mermaid>` client component.\n *\n * @packageDocumentation\n */\n\ninterface MdastNode {\n  type: string;\n  children?: MdastNode[];\n}\n\ninterface CodeNode extends MdastNode {\n  type: 'code';\n  lang?: string | null;\n  meta?: string | null;\n  value?: string;\n}\n\ninterface MdxJsxAttribute {\n  type: 'mdxJsxAttribute';\n  name: string;\n  value: unknown;\n}\n\ninterface MdxJsxElement extends MdastNode {\n  name?: string | null;\n  attributes?: MdxJsxAttribute[];\n}\n\nfunction isCode(node: MdastNode): node is CodeNode {\n  return node.type === 'code';\n}\n\nfunction isJsxElement(node: MdastNode): node is MdxJsxElement {\n  return node.type === 'mdxJsxFlowElement' || node.type === 'mdxJsxTextElement';\n}\n\nfunction walk(\n  node: MdastNode,\n  visit: (node: MdastNode, index: number, parent: MdastNode) => void,\n): void {\n  const children = node.children ?? [];\n  for (const [index, child] of children.entries()) {\n    visit(child, index, node);\n    walk(child, visit);\n  }\n}\n\n/**\n * A fence's parsed info-string meta: the resolved title (explicit\n * `title=\"...\"` wins over bare words) and every other token, order preserved.\n */\ninterface ParsedMeta {\n  title: string | undefined;\n  rest: string[];\n}\n\nfunction parseMeta(meta: string): ParsedMeta {\n  const tokens = meta.match(/[^\\s\"]*\"[^\"]*\"|\\S+/g) ?? [];\n  const bare: string[] = [];\n  const rest: string[] = [];\n  let explicit: string | undefined;\n  for (const token of tokens) {\n    const titled = /^title=(?:\"([^\"]*)\"|(\\S+))$/.exec(token);\n    if (titled) {\n      explicit ??= titled[1] ?? titled[2];\n      continue;\n    }\n    // A key=value option or a {1,3} highlight range is meta in its own right;\n    // only plain words are a Mintlify-style title.\n    if (token.includes('=') || token.startsWith('{') || token.startsWith('[')) {\n      rest.push(token);\n    } else {\n      bare.push(token);\n    }\n  }\n  if (explicit !== undefined) {\n    return { title: explicit, rest: [...rest, ...bare] };\n  }\n  return { title: bare.length > 0 ? bare.join(' ') : undefined, rest };\n}\n\nfunction serializeMeta(parsed: ParsedMeta, withTitle: boolean): string | undefined {\n  const tokens =\n    withTitle && parsed.title !== undefined\n      ? [`title=\"${parsed.title.replaceAll('\"', '')}\"`, ...parsed.rest]\n      : parsed.rest;\n  return tokens.length > 0 ? tokens.join(' ') : undefined;\n}\n\n/**\n * Reads and removes the title from a fence inside a `<CodeGroup>`. The group\n * shows the title on its tab, so leaving it on the fence would render a\n * duplicate per-block header inside the panel.\n */\nfunction takeTitle(code: CodeNode): string | undefined {\n  if (typeof code.meta !== 'string' || code.meta === '') {\n    return undefined;\n  }\n  const parsed = parseMeta(code.meta);\n  code.meta = serializeMeta(parsed, false) ?? null;\n  return parsed.title;\n}\n\nfunction normalizeTitle(code: CodeNode): void {\n  if (typeof code.meta !== 'string' || code.meta === '') {\n    return;\n  }\n  code.meta = serializeMeta(parseMeta(code.meta), true) ?? null;\n}\n\n/**\n * Fence-title compatibility for content written for Mintlify. Inside a\n * `<CodeGroup>`, each fence's title (either spelling) moves onto the group as\n * its tab label — the `labels` attribute `<CodeGroup>` reads — and comes off\n * the fence so the panel renders without its own header. Everywhere else a\n * bare-word meta becomes `title=\"...\"`, which the code-block component renders\n * as the block's header, exactly as it would the explicit spelling.\n *\n * @public\n */\nexport function remarkCodeTitles() {\n  return (tree: unknown): void => {\n    const root = tree as MdastNode;\n    walk(root, (node) => {\n      if (!isJsxElement(node) || node.name !== 'CodeGroup') {\n        return;\n      }\n      const fences = (node.children ?? []).filter(isCode);\n      if (fences.length === 0) {\n        return;\n      }\n      const labels = fences.map(\n        (fence, index) => takeTitle(fence) ?? fence.lang ?? `Code ${String(index + 1)}`,\n      );\n      node.attributes ??= [];\n      node.attributes.push({\n        type: 'mdxJsxAttribute',\n        name: 'labels',\n        value: JSON.stringify(labels),\n      });\n    });\n    walk(root, (node) => {\n      if (isCode(node)) {\n        normalizeTitle(node);\n      }\n    });\n  };\n}\n\n/**\n * Turns mermaid fences into a `<Mermaid chart=\"...\" />` element so\n * diagrams render as diagrams, not source. The site maps `Mermaid` to the\n * client component exported from `@blaaiz/docs-core/ui/mermaid`.\n *\n * @public\n */\nexport function remarkMermaid() {\n  return (tree: unknown): void => {\n    walk(tree as MdastNode, (node, index, parent) => {\n      if (isCode(node) && node.lang === 'mermaid') {\n        const element: MdxJsxElement = {\n          type: 'mdxJsxFlowElement',\n          name: 'Mermaid',\n          attributes: [{ type: 'mdxJsxAttribute', name: 'chart', value: node.value ?? '' }],\n          children: [],\n        };\n        (parent.children ?? [])[index] = element;\n      }\n    });\n  };\n}\n"]}

package/dist/ui.cjs

@@ -429,6 +429,74 @@ function CardGroup({ cols = 2, children }) {
   };
   return /* @__PURE__ */ jsxRuntime.jsx("div", { style, children });
 }
+function findLabel(node, depth = 0) {
+  if (depth > 4) {
+    return void 0;
+  }
+  for (const child of react.Children.toArray(node)) {
+    if (!react.isValidElement(child)) {
+      continue;
+    }
+    const { title, lang, children } = child.props;
+    if (typeof title === "string" && title !== "") {
+      return title;
+    }
+    if (typeof lang === "string" && lang !== "") {
+      return lang;
+    }
+    const nested = findLabel(children, depth + 1);
+    if (nested !== void 0) {
+      return nested;
+    }
+  }
+  return void 0;
+}
+function parseLabels(labels) {
+  if (labels === void 0) {
+    return [];
+  }
+  if (typeof labels !== "string") {
+    return labels;
+  }
+  try {
+    const parsed = JSON.parse(labels);
+    return Array.isArray(parsed) ? parsed.map(String) : [];
+  } catch {
+    return [];
+  }
+}
+function CodeGroup({
+  children,
+  labels
+}) {
+  const group = react.useId();
+  const blocks = react.Children.toArray(children).filter(
+    (child) => react.isValidElement(child)
+  );
+  const named = parseLabels(labels);
+  const labelOf = (block, index) => named[index] ?? findLabel(block) ?? `Code ${String(index + 1)}`;
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "tabs tabs--code", children: [
+    blocks.map((_block, index) => /* @__PURE__ */ jsxRuntime.jsx(
+      "input",
+      {
+        className: "tabs__radio",
+        type: "radio",
+        name: group,
+        id: `${group}-${String(index)}`,
+        defaultChecked: index === 0
+      },
+      index
+    )),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "tabs__bar", children: blocks.map((block, index) => /* @__PURE__ */ jsxRuntime.jsx("label", { className: "tabs__trigger", htmlFor: `${group}-${String(index)}`, children: labelOf(block, index) }, index)) }),
+    blocks.map((block, index) => /* @__PURE__ */ jsxRuntime.jsx("section", { className: "tabs__panel", children: block }, index))
+  ] });
+}
+function Frame({ caption, children }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("figure", { className: "frame", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "frame__body", children }),
+    caption === void 0 ? null : /* @__PURE__ */ jsxRuntime.jsx("figcaption", { className: "frame__caption", children: caption })
+  ] });
+}
 
 // src/ui/docs-icons.tsx
 var ICONS = {
@@ -684,7 +752,9 @@ var mdxComponents = {
   Steps,
   Step,
   Tabs,
-  Tab
+  Tab,
+  Frame,
+  CodeGroup
 };
 var defaultResolveHref = (page) => {
   if (page.kind === "openapi") {
@@ -781,8 +851,10 @@ exports.AuthScreen = AuthScreen;
 exports.Callout = Callout;
 exports.Card = Card;
 exports.CardGroup = CardGroup;
+exports.CodeGroup = CodeGroup;
 exports.DocsSidebar = DocsSidebar;
 exports.ErrorScreen = ErrorScreen;
+exports.Frame = Frame;
 exports.Info = Info;
 exports.MethodBadge = MethodBadge;
 exports.NavActions = NavActions;