@clarify-labs/renderer 0.11.9 → 0.11.11

package/output/index.cjs

@@ -1,11 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-DakpK96I.cjs");
-const require_i18n = require("./i18n-BuvwT5W9.cjs");
-const require_ClarifyShell = require("./ClarifyShell-GCXbb_AF.cjs");
-const require_PageActions = require("./PageActions-DxGK-444.cjs");
-const require_OpenApiOperation = require("./OpenApiOperation-DIgbzvk5.cjs");
+const require_i18n = require("./i18n-BMNCgF9o.cjs");
+const require_ClarifyShell = require("./ClarifyShell-DLOGS18o.cjs");
+const require_PageActions = require("./PageActions-CVOTIuxh.cjs");
+const require_OpenApiOperation = require("./OpenApiOperation-416zAKci.cjs");
 const require_remark = require("./remark-DTLbG8PK.cjs");
-const require_render = require("./render-D8h-jcnw.cjs");
+const require_render = require("./render-TErh9x_2.cjs");
 let clsx = require("clsx");
 clsx = require_rolldown_runtime.__toESM(clsx, 1);
 let react = require("react");
@@ -404,6 +404,8 @@ exports.PageBanner = require_ClarifyShell.PageBanner;
 exports.PageFooter = require_ClarifyShell.PageFooter;
 exports.Pre = require_OpenApiOperation.Pre;
 exports.Prose = require_OpenApiOperation.Prose;
+exports.Release = require_OpenApiOperation.Release;
+exports.ReleaseItem = require_OpenApiOperation.ReleaseItem;
 exports.RuntimeSlot = require_ClarifyShell.RuntimeSlot;
 exports.RuntimeSlotsProvider = require_ClarifyShell.RuntimeSlotsProvider;
 exports.SectionProvider = require_PageActions.SectionProvider;

package/output/index.d.ts

@@ -8,6 +8,7 @@ import { Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, Feedback,
 import { ConfigProvider, OpenApiSpecsContext, useConfig, useConfigUpdater, useConfigUpdaterOptional, useOpenApiSpecs } from './context';
 import { useMDXComponents } from './mdx/components';
 import { DocShell } from './mdx/DocShell';
+import { Release, ReleaseItem } from './mdx/primitives';
 import { markdownRemarkPlugins, parseCodeMeta } from './mdx/remark';
 import { OpenApiRequest, OpenApiDocument, OpenApiLink, OpenApiOperation, createOpenApiRouteComponent } from './openapi';
 import { render } from './runtime/render';
@@ -26,7 +27,7 @@ export type { ContentDiagnostic, ContentDiagnosticKind };
 export type { Config, RouteItem, RouteSection, RenderOptions, ServerRenderOptions, Section };
 export type { RuntimeSlotEntry, RuntimeSlotRegistry, UISlotRegistration, UISlotName, UISlotContext } from './slots';
 export { AppShell, render, ConfigProvider, OpenApiSpecsContext, useConfig, useConfigUpdater, useConfigUpdaterOptional, useOpenApiSpecs, BuiltWithClarify, PageBanner, PageFooter, ThemeProvider, ThemeToggle, ThemeEditor, useTheme, SectionProvider, useSectionStore, remToPx, applyThemeVariables, themeEditorPresets, themePresets, themeBootstrapScript, createContentDiagnosticComponent, createOpenApiRouteComponent };
-export { Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, Pre, Prose, Heading, Logo, Mermaid, GridPattern, HeroPattern, Feedback, Step, Steps, Tab, Tabs, Tag, WebFrame };
+export { Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, Pre, Prose, Heading, Logo, Mermaid, GridPattern, HeroPattern, Feedback, Step, Steps, Tab, Tabs, Tag, WebFrame, Release, ReleaseItem };
 export { DocShell, useMDXComponents, markdownRemarkPlugins, parseCodeMeta };
 export { SlotProvider, RuntimeSlot, RuntimeSlotsProvider, useSlot };
 export { OpenApiRequest, OpenApiDocument, OpenApiLink, OpenApiOperation };

package/output/index.js

@@ -1,9 +1,9 @@
-import { A as Feedback, B as LocalizedLink, C as Steps, D as Logo, E as HeroPattern, F as Mermaid, I as Card, L as CardGroup, M as Code, N as CodeGroup, O as Heading, P as Pre, R as Callout, S as Step, T as GridPattern, _ as Markdown, b as TabItem, d as EndpointMethodBadge, f as getOpenApiOperationEntryById, j as Collapse, k as Tag, m as listOpenApiOperations, n as OpenApiOperation$1, p as getOpenApiOperationSectionId, r as OpenApiRequestWorkbench, v as primitives_exports, w as Prose, x as Tabs, y as WebFrame, z as Button } from "./OpenApiOperation-B26v2y44.js";
-import { a as useConfig, c as useConfigUpdaterOptional, i as OpenApiSpecsContext, l as useLocale, n as ConfigProvider, s as useConfigUpdater, t as useBuiltInText, u as useOpenApiSpecs } from "./i18n-C6tIP-nl.js";
-import { a as themeBootstrapScript, c as AppShell, d as RenderErrorPanel, f as BuiltWithClarify, g as useSlot, h as SlotProvider, i as themeEditorPresets, l as PageFooter, m as RuntimeSlotsProvider, n as ThemeEditor, o as themePresets, p as RuntimeSlot, r as applyThemeVariables, u as PageBanner } from "./ClarifyShell-nV23Fn7m.js";
-import { a as SectionProvider, h as useTheme, m as ThemeProvider, o as useSectionStore, p as ThemeToggle, s as remToPx, t as PageActions, w as localizeHref } from "./PageActions-BbmyFeSk.js";
+import { A as Heading, B as Callout, C as Tabs, D as GridPattern, E as Prose, F as CodeGroup, H as LocalizedLink, I as Pre, L as Mermaid, M as Feedback, N as Collapse, O as HeroPattern, P as Code, R as Card, S as TabItem, T as Steps, V as Button, _ as Markdown, b as primitives_exports, d as EndpointMethodBadge, f as getOpenApiOperationEntryById, j as Tag, k as Logo, m as listOpenApiOperations, n as OpenApiOperation$1, p as getOpenApiOperationSectionId, r as OpenApiRequestWorkbench, v as Release, w as Step, x as WebFrame, y as ReleaseItem, z as CardGroup } from "./OpenApiOperation-bY3wbaJC.js";
+import { a as useConfig, c as useConfigUpdaterOptional, i as OpenApiSpecsContext, l as useLocale, n as ConfigProvider, s as useConfigUpdater, t as useBuiltInText, u as useOpenApiSpecs } from "./i18n-Zmmhz7FF.js";
+import { a as themeBootstrapScript, c as AppShell, d as RenderErrorPanel, f as BuiltWithClarify, g as useSlot, h as SlotProvider, i as themeEditorPresets, l as PageFooter, m as RuntimeSlotsProvider, n as ThemeEditor, o as themePresets, p as RuntimeSlot, r as applyThemeVariables, u as PageBanner } from "./ClarifyShell-DGm_R5Bp.js";
+import { T as localizeHref, c as remToPx, g as useTheme, h as ThemeProvider, m as ThemeToggle, o as SectionProvider, s as useSectionStore, t as PageActions } from "./PageActions-D52u18C8.js";
 import { n as parseCodeMeta, t as markdownRemarkPlugins } from "./remark-C9iRQM0R.js";
-import { t as render } from "./render-CAtVGsQF.js";
+import { t as render } from "./render-D_QvIv7Z.js";
 import clsx from "clsx";
 import { useEffect, useState } from "react";
 import { useLocation } from "react-router-dom";
@@ -375,6 +375,6 @@ function DocShell(arg0) {
 	});
 }
 //#endregion
-export { AppShell, BuiltWithClarify, Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, ConfigProvider, DocShell, Feedback, GridPattern, Heading, HeroPattern, Logo, Mermaid, OpenApiDocument, OpenApiLink, OpenApiOperation, OpenApiRequest, OpenApiSpecsContext, PageBanner, PageFooter, Pre, Prose, RuntimeSlot, RuntimeSlotsProvider, SectionProvider, SlotProvider, Step, Steps, TabItem as Tab, Tabs, Tag, ThemeEditor, ThemeProvider, ThemeToggle, WebFrame, applyThemeVariables, createContentDiagnosticComponent, createOpenApiRouteComponent, markdownRemarkPlugins, parseCodeMeta, remToPx, render, themeBootstrapScript, themeEditorPresets, themePresets, useConfig, useConfigUpdater, useConfigUpdaterOptional, useMDXComponents, useOpenApiSpecs, useSectionStore, useSlot, useTheme };
+export { AppShell, BuiltWithClarify, Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, ConfigProvider, DocShell, Feedback, GridPattern, Heading, HeroPattern, Logo, Mermaid, OpenApiDocument, OpenApiLink, OpenApiOperation, OpenApiRequest, OpenApiSpecsContext, PageBanner, PageFooter, Pre, Prose, Release, ReleaseItem, RuntimeSlot, RuntimeSlotsProvider, SectionProvider, SlotProvider, Step, Steps, TabItem as Tab, Tabs, Tag, ThemeEditor, ThemeProvider, ThemeToggle, WebFrame, applyThemeVariables, createContentDiagnosticComponent, createOpenApiRouteComponent, markdownRemarkPlugins, parseCodeMeta, remToPx, render, themeBootstrapScript, themeEditorPresets, themePresets, useConfig, useConfigUpdater, useConfigUpdaterOptional, useMDXComponents, useOpenApiSpecs, useSectionStore, useSlot, useTheme };
 
 //# sourceMappingURL=index.js.map

package/output/mdx/components.d.ts

@@ -9,6 +9,15 @@ export declare function useMDXComponents(components?: Record<string, unknown>):
     OpenApiOperation: typeof OpenApiOperation;
     Collapse: typeof Collapse;
     Mermaid: typeof Mermaid;
+    Release(arg0: {
+        version: string;
+        date?: string;
+        children: import('react').ReactNode;
+    }): import("react").JSX.Element;
+    ReleaseItem(arg0: {
+        title: string;
+        children: import('react').ReactNode;
+    }): import("react").JSX.Element;
     wrapper(arg0: {
         children: import('react').ReactNode;
     }): import("react").JSX.Element;

package/output/mdx/primitives.d.ts

@@ -5,6 +5,17 @@ import { Image } from '../components/Image';
 type WrapperProps = {
     children: ReactNode;
 };
+type ReleaseProps = {
+    version: string;
+    date?: string;
+    children: ReactNode;
+};
+type ReleaseItemProps = {
+    title: string;
+    children: ReactNode;
+};
+export declare function Release(arg0: ReleaseProps): import("react").JSX.Element;
+export declare function ReleaseItem(arg0: ReleaseItemProps): import("react").JSX.Element;
 export declare function wrapper(arg0: WrapperProps): import("react").JSX.Element;
 export declare function table(arg0: ComponentPropsWithoutRef<'table'>): import("react").JSX.Element;
 export declare function a(arg0: ComponentPropsWithoutRef<'a'>): import("react").JSX.Element;

package/output/preview.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_i18n = require("./i18n-BuvwT5W9.cjs");
-const require_PageActions = require("./PageActions-DxGK-444.cjs");
-const require_OpenApiOperation = require("./OpenApiOperation-DIgbzvk5.cjs");
+const require_i18n = require("./i18n-BMNCgF9o.cjs");
+const require_PageActions = require("./PageActions-CVOTIuxh.cjs");
+const require_OpenApiOperation = require("./OpenApiOperation-416zAKci.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let lucide_react = require("lucide-react");

package/output/preview.js

@@ -1,6 +1,6 @@
-import { a as ResponseExamplesPanel, c as getAuthOptions, g as getRequestBody, h as getMediaTypeEntries, i as RequestExamplesPanel, l as getServerKey, o as authPlaceholder, s as defaultServerVariables, t as EndpointIdentity, u as getServers } from "./OpenApiOperation-B26v2y44.js";
-import { i as OpenApiSpecsContext, n as ConfigProvider, r as LocaleContext } from "./i18n-C6tIP-nl.js";
-import { a as SectionProvider, i as Navigation } from "./PageActions-BbmyFeSk.js";
+import { a as ResponseExamplesPanel, c as getAuthOptions, g as getRequestBody, h as getMediaTypeEntries, i as RequestExamplesPanel, l as getServerKey, o as authPlaceholder, s as defaultServerVariables, t as EndpointIdentity, u as getServers } from "./OpenApiOperation-bY3wbaJC.js";
+import { i as OpenApiSpecsContext, n as ConfigProvider, r as LocaleContext } from "./i18n-Zmmhz7FF.js";
+import { a as Navigation, o as SectionProvider } from "./PageActions-D52u18C8.js";
 import { useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Menu, X } from "lucide-react";

package/output/{render-CAtVGsQF.js → render-D_QvIv7Z.js}

@@ -1,4 +1,4 @@
-import { t as ClarifyShell } from "./ClarifyShell-nV23Fn7m.js";
+import { t as ClarifyShell } from "./ClarifyShell-DGm_R5Bp.js";
 import { StrictMode } from "react";
 import { BrowserRouter } from "react-router-dom";
 import { jsx } from "react/jsx-runtime";
@@ -56,4 +56,4 @@ function render(options) {
 //#endregion
 export { render as t };
 
-//# sourceMappingURL=render-CAtVGsQF.js.map
+//# sourceMappingURL=render-D_QvIv7Z.js.map

package/output/{render-CAtVGsQF.js.map → render-D_QvIv7Z.js.map}

@@ -1 +1 @@
-{"version":3,"file":"render-CAtVGsQF.js","names":[],"sources":["../source/runtime/render.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { hydrateRoot, createRoot, type Root } from 'react-dom/client'\nimport { BrowserRouter } from 'react-router-dom'\n\nimport type { RenderOptions } from '../types'\n\nimport { ClarifyShell } from './ClarifyShell'\n\nlet root: Root | undefined\n\n/**\n * Clarify 客户端 Hydration 入口。\n * 在文档项目的 main.tsx 中调用：\n * ```ts\n * import { render } from '@clarify-labs/renderer';\n * import { routes } from 'virtual:clarify/routes';\n * import { config } from 'virtual:clarify/config';\n * render({ config, routes });\n * ```\n */\nfunction isHydrationDebugEnabled(): boolean {\n  if (typeof window === 'undefined') return false\n\n  try {\n    const params = new URLSearchParams(window.location.search)\n    return params.get('clarifyHydrationDebug') === '1' || window.localStorage.getItem('clarify:hydration-debug') === '1'\n  } catch {\n    return false\n  }\n}\n\nexport function render(options: RenderOptions) {\n  const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, container, themeEditor = false } = options\n\n  const target = container ?? document.getElementById('root')\n  if (!target) {\n    throw new Error('[clarify] 渲染失败：找不到挂载节点，请确保 HTML 中存在 id=\"root\" 的元素')\n  }\n\n  const app = (\n    <StrictMode>\n      <BrowserRouter basename={config.routePrefix}>\n        <ClarifyShell\n          config={config}\n          routes={routes}\n          navigation={navigation}\n          openApiSpecs={openApiSpecs}\n          runtimeSlots={runtimeSlots}\n          themeEditor={themeEditor}\n        />\n      </BrowserRouter>\n    </StrictMode>\n  )\n\n  const hydrationDebug = isHydrationDebugEnabled()\n\n  if (root) {\n    root.render(app)\n    return\n  }\n\n  try {\n    root = hydrateRoot(target as Element, app, {\n      onRecoverableError(error, errorInfo) {\n        // Phase 1: suppress hydration mismatch noise by default. React 19\n        // recovers automatically, but diagnostics can be enabled explicitly.\n        if (hydrationDebug) {\n          console.warn('[clarify] Recoverable hydration error:', error, errorInfo)\n        }\n      },\n    })\n  } catch (err) {\n    console.warn('[clarify] Hydration failed, falling back to client render:', err)\n    root = createRoot(target as Element)\n    root.render(app)\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAI;;;;;;;;;;;AAYJ,SAAS,0BAAmC;CAC1C,IAAI,OAAO,WAAW,aAAa,OAAO;CAE1C,IAAI;EAEF,OAAO,IADY,gBAAgB,OAAO,SAAS,MAC5C,CAAA,CAAO,IAAI,uBAAuB,MAAM,OAAO,OAAO,aAAa,QAAQ,yBAAyB,MAAM;CACnH,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAgB,OAAO,SAAwB;CAC7C,MAAM,EAAE,QAAQ,QAAQ,YAAY,eAAe,CAAC,GAAG,cAAc,WAAW,cAAc,UAAU;CAExG,MAAM,SAAS,aAAa,SAAS,eAAe,MAAM;CAC1D,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qDAAmD;CAGrE,MAAM,MACJ,oBAAC,YAAD,EAAA,UACE,oBAAC,eAAD;EAAe,UAAU,OAAO;YAC9B,oBAAC,cAAD;GACU;GACA;GACI;GACE;GACA;GACD;EACd,CAAA;CACY,CAAA,EACL,CAAA;CAGd,MAAM,iBAAiB,wBAAwB;CAE/C,IAAI,MAAM;EACR,KAAK,OAAO,GAAG;EACf;CACF;CAEA,IAAI;EACF,OAAO,YAAY,QAAmB,KAAK,EACzC,mBAAmB,OAAO,WAAW;GAGnC,IAAI,gBACF,QAAQ,KAAK,0CAA0C,OAAO,SAAS;EAE3E,EACF,CAAC;CACH,SAAS,KAAK;EACZ,QAAQ,KAAK,8DAA8D,GAAG;EAC9E,OAAO,WAAW,MAAiB;EACnC,KAAK,OAAO,GAAG;CACjB;AACF"}
+{"version":3,"file":"render-D_QvIv7Z.js","names":[],"sources":["../source/runtime/render.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { hydrateRoot, createRoot, type Root } from 'react-dom/client'\nimport { BrowserRouter } from 'react-router-dom'\n\nimport type { RenderOptions } from '../types'\n\nimport { ClarifyShell } from './ClarifyShell'\n\nlet root: Root | undefined\n\n/**\n * Clarify 客户端 Hydration 入口。\n * 在文档项目的 main.tsx 中调用：\n * ```ts\n * import { render } from '@clarify-labs/renderer';\n * import { routes } from 'virtual:clarify/routes';\n * import { config } from 'virtual:clarify/config';\n * render({ config, routes });\n * ```\n */\nfunction isHydrationDebugEnabled(): boolean {\n  if (typeof window === 'undefined') return false\n\n  try {\n    const params = new URLSearchParams(window.location.search)\n    return params.get('clarifyHydrationDebug') === '1' || window.localStorage.getItem('clarify:hydration-debug') === '1'\n  } catch {\n    return false\n  }\n}\n\nexport function render(options: RenderOptions) {\n  const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, container, themeEditor = false } = options\n\n  const target = container ?? document.getElementById('root')\n  if (!target) {\n    throw new Error('[clarify] 渲染失败：找不到挂载节点，请确保 HTML 中存在 id=\"root\" 的元素')\n  }\n\n  const app = (\n    <StrictMode>\n      <BrowserRouter basename={config.routePrefix}>\n        <ClarifyShell\n          config={config}\n          routes={routes}\n          navigation={navigation}\n          openApiSpecs={openApiSpecs}\n          runtimeSlots={runtimeSlots}\n          themeEditor={themeEditor}\n        />\n      </BrowserRouter>\n    </StrictMode>\n  )\n\n  const hydrationDebug = isHydrationDebugEnabled()\n\n  if (root) {\n    root.render(app)\n    return\n  }\n\n  try {\n    root = hydrateRoot(target as Element, app, {\n      onRecoverableError(error, errorInfo) {\n        // Phase 1: suppress hydration mismatch noise by default. React 19\n        // recovers automatically, but diagnostics can be enabled explicitly.\n        if (hydrationDebug) {\n          console.warn('[clarify] Recoverable hydration error:', error, errorInfo)\n        }\n      },\n    })\n  } catch (err) {\n    console.warn('[clarify] Hydration failed, falling back to client render:', err)\n    root = createRoot(target as Element)\n    root.render(app)\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAI;;;;;;;;;;;AAYJ,SAAS,0BAAmC;CAC1C,IAAI,OAAO,WAAW,aAAa,OAAO;CAE1C,IAAI;EAEF,OAAO,IADY,gBAAgB,OAAO,SAAS,MAC5C,CAAA,CAAO,IAAI,uBAAuB,MAAM,OAAO,OAAO,aAAa,QAAQ,yBAAyB,MAAM;CACnH,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAgB,OAAO,SAAwB;CAC7C,MAAM,EAAE,QAAQ,QAAQ,YAAY,eAAe,CAAC,GAAG,cAAc,WAAW,cAAc,UAAU;CAExG,MAAM,SAAS,aAAa,SAAS,eAAe,MAAM;CAC1D,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qDAAmD;CAGrE,MAAM,MACJ,oBAAC,YAAD,EAAA,UACE,oBAAC,eAAD;EAAe,UAAU,OAAO;YAC9B,oBAAC,cAAD;GACU;GACA;GACI;GACE;GACA;GACD;EACd,CAAA;CACY,CAAA,EACL,CAAA;CAGd,MAAM,iBAAiB,wBAAwB;CAE/C,IAAI,MAAM;EACR,KAAK,OAAO,GAAG;EACf;CACF;CAEA,IAAI;EACF,OAAO,YAAY,QAAmB,KAAK,EACzC,mBAAmB,OAAO,WAAW;GAGnC,IAAI,gBACF,QAAQ,KAAK,0CAA0C,OAAO,SAAS;EAE3E,EACF,CAAC;CACH,SAAS,KAAK;EACZ,QAAQ,KAAK,8DAA8D,GAAG;EAC9E,OAAO,WAAW,MAAiB;EACnC,KAAK,OAAO,GAAG;CACjB;AACF"}

package/output/{render-D8h-jcnw.cjs → render-TErh9x_2.cjs}

@@ -1,4 +1,4 @@
-const require_ClarifyShell = require("./ClarifyShell-GCXbb_AF.cjs");
+const require_ClarifyShell = require("./ClarifyShell-DLOGS18o.cjs");
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -61,4 +61,4 @@ Object.defineProperty(exports, "render", {
 	}
 });
 
-//# sourceMappingURL=render-D8h-jcnw.cjs.map
+//# sourceMappingURL=render-TErh9x_2.cjs.map

package/output/{render-D8h-jcnw.cjs.map → render-TErh9x_2.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"render-D8h-jcnw.cjs","names":[],"sources":["../source/runtime/render.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { hydrateRoot, createRoot, type Root } from 'react-dom/client'\nimport { BrowserRouter } from 'react-router-dom'\n\nimport type { RenderOptions } from '../types'\n\nimport { ClarifyShell } from './ClarifyShell'\n\nlet root: Root | undefined\n\n/**\n * Clarify 客户端 Hydration 入口。\n * 在文档项目的 main.tsx 中调用：\n * ```ts\n * import { render } from '@clarify-labs/renderer';\n * import { routes } from 'virtual:clarify/routes';\n * import { config } from 'virtual:clarify/config';\n * render({ config, routes });\n * ```\n */\nfunction isHydrationDebugEnabled(): boolean {\n  if (typeof window === 'undefined') return false\n\n  try {\n    const params = new URLSearchParams(window.location.search)\n    return params.get('clarifyHydrationDebug') === '1' || window.localStorage.getItem('clarify:hydration-debug') === '1'\n  } catch {\n    return false\n  }\n}\n\nexport function render(options: RenderOptions) {\n  const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, container, themeEditor = false } = options\n\n  const target = container ?? document.getElementById('root')\n  if (!target) {\n    throw new Error('[clarify] 渲染失败：找不到挂载节点，请确保 HTML 中存在 id=\"root\" 的元素')\n  }\n\n  const app = (\n    <StrictMode>\n      <BrowserRouter basename={config.routePrefix}>\n        <ClarifyShell\n          config={config}\n          routes={routes}\n          navigation={navigation}\n          openApiSpecs={openApiSpecs}\n          runtimeSlots={runtimeSlots}\n          themeEditor={themeEditor}\n        />\n      </BrowserRouter>\n    </StrictMode>\n  )\n\n  const hydrationDebug = isHydrationDebugEnabled()\n\n  if (root) {\n    root.render(app)\n    return\n  }\n\n  try {\n    root = hydrateRoot(target as Element, app, {\n      onRecoverableError(error, errorInfo) {\n        // Phase 1: suppress hydration mismatch noise by default. React 19\n        // recovers automatically, but diagnostics can be enabled explicitly.\n        if (hydrationDebug) {\n          console.warn('[clarify] Recoverable hydration error:', error, errorInfo)\n        }\n      },\n    })\n  } catch (err) {\n    console.warn('[clarify] Hydration failed, falling back to client render:', err)\n    root = createRoot(target as Element)\n    root.render(app)\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAI;;;;;;;;;;;AAYJ,SAAS,0BAAmC;CAC1C,IAAI,OAAO,WAAW,aAAa,OAAO;CAE1C,IAAI;EAEF,OAAO,IADY,gBAAgB,OAAO,SAAS,MAC5C,CAAA,CAAO,IAAI,uBAAuB,MAAM,OAAO,OAAO,aAAa,QAAQ,yBAAyB,MAAM;CACnH,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAgB,OAAO,SAAwB;CAC7C,MAAM,EAAE,QAAQ,QAAQ,YAAY,eAAe,CAAC,GAAG,cAAc,WAAW,cAAc,UAAU;CAExG,MAAM,SAAS,aAAa,SAAS,eAAe,MAAM;CAC1D,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qDAAmD;CAGrE,MAAM,MACJ,iBAAA,GAAA,kBAAA,IAAA,CAAC,MAAA,YAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,iBAAA,eAAD;EAAe,UAAU,OAAO;YAC9B,iBAAA,GAAA,kBAAA,IAAA,CAAC,qBAAA,cAAD;GACU;GACA;GACI;GACE;GACA;GACD;EACd,CAAA;CACY,CAAA,EACL,CAAA;CAGd,MAAM,iBAAiB,wBAAwB;CAE/C,IAAI,MAAM;EACR,KAAK,OAAO,GAAG;EACf;CACF;CAEA,IAAI;EACF,QAAA,GAAA,iBAAA,YAAA,CAAmB,QAAmB,KAAK,EACzC,mBAAmB,OAAO,WAAW;GAGnC,IAAI,gBACF,QAAQ,KAAK,0CAA0C,OAAO,SAAS;EAE3E,EACF,CAAC;CACH,SAAS,KAAK;EACZ,QAAQ,KAAK,8DAA8D,GAAG;EAC9E,QAAA,GAAA,iBAAA,WAAA,CAAkB,MAAiB;EACnC,KAAK,OAAO,GAAG;CACjB;AACF"}
+{"version":3,"file":"render-TErh9x_2.cjs","names":[],"sources":["../source/runtime/render.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { hydrateRoot, createRoot, type Root } from 'react-dom/client'\nimport { BrowserRouter } from 'react-router-dom'\n\nimport type { RenderOptions } from '../types'\n\nimport { ClarifyShell } from './ClarifyShell'\n\nlet root: Root | undefined\n\n/**\n * Clarify 客户端 Hydration 入口。\n * 在文档项目的 main.tsx 中调用：\n * ```ts\n * import { render } from '@clarify-labs/renderer';\n * import { routes } from 'virtual:clarify/routes';\n * import { config } from 'virtual:clarify/config';\n * render({ config, routes });\n * ```\n */\nfunction isHydrationDebugEnabled(): boolean {\n  if (typeof window === 'undefined') return false\n\n  try {\n    const params = new URLSearchParams(window.location.search)\n    return params.get('clarifyHydrationDebug') === '1' || window.localStorage.getItem('clarify:hydration-debug') === '1'\n  } catch {\n    return false\n  }\n}\n\nexport function render(options: RenderOptions) {\n  const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, container, themeEditor = false } = options\n\n  const target = container ?? document.getElementById('root')\n  if (!target) {\n    throw new Error('[clarify] 渲染失败：找不到挂载节点，请确保 HTML 中存在 id=\"root\" 的元素')\n  }\n\n  const app = (\n    <StrictMode>\n      <BrowserRouter basename={config.routePrefix}>\n        <ClarifyShell\n          config={config}\n          routes={routes}\n          navigation={navigation}\n          openApiSpecs={openApiSpecs}\n          runtimeSlots={runtimeSlots}\n          themeEditor={themeEditor}\n        />\n      </BrowserRouter>\n    </StrictMode>\n  )\n\n  const hydrationDebug = isHydrationDebugEnabled()\n\n  if (root) {\n    root.render(app)\n    return\n  }\n\n  try {\n    root = hydrateRoot(target as Element, app, {\n      onRecoverableError(error, errorInfo) {\n        // Phase 1: suppress hydration mismatch noise by default. React 19\n        // recovers automatically, but diagnostics can be enabled explicitly.\n        if (hydrationDebug) {\n          console.warn('[clarify] Recoverable hydration error:', error, errorInfo)\n        }\n      },\n    })\n  } catch (err) {\n    console.warn('[clarify] Hydration failed, falling back to client render:', err)\n    root = createRoot(target as Element)\n    root.render(app)\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAI;;;;;;;;;;;AAYJ,SAAS,0BAAmC;CAC1C,IAAI,OAAO,WAAW,aAAa,OAAO;CAE1C,IAAI;EAEF,OAAO,IADY,gBAAgB,OAAO,SAAS,MAC5C,CAAA,CAAO,IAAI,uBAAuB,MAAM,OAAO,OAAO,aAAa,QAAQ,yBAAyB,MAAM;CACnH,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAgB,OAAO,SAAwB;CAC7C,MAAM,EAAE,QAAQ,QAAQ,YAAY,eAAe,CAAC,GAAG,cAAc,WAAW,cAAc,UAAU;CAExG,MAAM,SAAS,aAAa,SAAS,eAAe,MAAM;CAC1D,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qDAAmD;CAGrE,MAAM,MACJ,iBAAA,GAAA,kBAAA,IAAA,CAAC,MAAA,YAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,iBAAA,eAAD;EAAe,UAAU,OAAO;YAC9B,iBAAA,GAAA,kBAAA,IAAA,CAAC,qBAAA,cAAD;GACU;GACA;GACI;GACE;GACA;GACD;EACd,CAAA;CACY,CAAA,EACL,CAAA;CAGd,MAAM,iBAAiB,wBAAwB;CAE/C,IAAI,MAAM;EACR,KAAK,OAAO,GAAG;EACf;CACF;CAEA,IAAI;EACF,QAAA,GAAA,iBAAA,YAAA,CAAmB,QAAmB,KAAK,EACzC,mBAAmB,OAAO,WAAW;GAGnC,IAAI,gBACF,QAAQ,KAAK,0CAA0C,OAAO,SAAS;EAE3E,EACF,CAAC;CACH,SAAS,KAAK;EACZ,QAAQ,KAAK,8DAA8D,GAAG;EAC9E,QAAA,GAAA,iBAAA,WAAA,CAAkB,MAAiB;EACnC,KAAK,OAAO,GAAG;CACjB;AACF"}

package/output/renderer.css

@@ -145,6 +145,7 @@
     --text-base: 1rem;
     --text-base--line-height: 1.75rem;
     --text-lg: 1.125rem;
+    --text-lg--line-height: 1.75rem;
     --text-xl: 1.25rem;
     --text-2xl: 1.5rem;
     --text-3xl: 1.875rem;
@@ -1001,6 +1002,17 @@
     --clarify-http-method-default-text: var(--color-zinc-100);
   }
 
+  .clarify-content-blog .clarify-mdx-page, .clarify-content-blog .clarify-page-metadata {
+    max-width: 48rem;
+    margin-inline: auto;
+  }
+
+  .clarify-content-blog .clarify-page-title {
+    font-family: Georgia, Times New Roman, serif;
+    font-size: clamp(2.5rem, 7cqw, 4.5rem);
+    line-height: 1.05;
+  }
+
   .clarify-api-response {
     --shiki-color-text: var(--clarify-ui-text-strong);
     --shiki-token-constant: #047857;
@@ -1937,6 +1949,10 @@
     margin: 0;
   }
 
+  .m-0\! {
+    margin: 0 !important;
+  }
+
   .mx-0 {
     margin-inline: 0;
   }
@@ -1973,6 +1989,10 @@
     margin-block: calc(var(--spacing) * 10);
   }
 
+  .my-14 {
+    margin-block: calc(var(--spacing) * 14);
+  }
+
   .prose {
     --tw-prose-body: var(--clarify-theme-tokens-colors-foreground);
   }
@@ -2425,6 +2445,10 @@
     margin-left: calc(var(--spacing) * -152);
   }
 
+  .ml-1 {
+    margin-left: var(--spacing);
+  }
+
   .ml-2 {
     margin-left: calc(var(--spacing) * 2);
   }
@@ -2495,6 +2519,11 @@
     height: calc(var(--spacing) * 2.5);
   }
 
+  .size-3 {
+    width: calc(var(--spacing) * 3);
+    height: calc(var(--spacing) * 3);
+  }
+
   .size-3\.5 {
     width: calc(var(--spacing) * 3.5);
     height: calc(var(--spacing) * 3.5);
@@ -2941,6 +2970,14 @@
     min-width: calc(var(--spacing) * 28);
   }
 
+  .min-w-40 {
+    min-width: calc(var(--spacing) * 40);
+  }
+
+  .min-w-48 {
+    min-width: calc(var(--spacing) * 48);
+  }
+
   .min-w-96 {
     min-width: calc(var(--spacing) * 96);
   }
@@ -3014,6 +3051,10 @@
     rotate: -90deg;
   }
 
+  .rotate-90 {
+    rotate: 90deg;
+  }
+
   .rotate-180 {
     rotate: 180deg;
   }
@@ -3219,6 +3260,10 @@
     gap: calc(var(--spacing) * 6);
   }
 
+  .gap-7 {
+    gap: calc(var(--spacing) * 7);
+  }
+
   .gap-px {
     gap: 1px;
   }
@@ -3311,6 +3356,10 @@
     }
   }
 
+  .self-start {
+    align-self: flex-start;
+  }
+
   .truncate {
     text-overflow: ellipsis;
     white-space: nowrap;
@@ -4235,6 +4284,10 @@
     padding-left: calc(var(--spacing) * 4);
   }
 
+  .pl-6 {
+    padding-left: calc(var(--spacing) * 6);
+  }
+
   .pl-9 {
     padding-left: calc(var(--spacing) * 9);
   }
@@ -4324,6 +4377,11 @@
     line-height: calc(var(--spacing) * 6);
   }
 
+  .text-lg {
+    font-size: var(--text-lg);
+    line-height: var(--tw-leading, var(--text-lg--line-height));
+  }
+
   .text-lg\/7 {
     font-size: var(--text-lg);
     line-height: calc(var(--spacing) * 7);
@@ -4684,6 +4742,14 @@
     opacity: .35;
   }
 
+  .opacity-60 {
+    opacity: .6;
+  }
+
+  .opacity-70 {
+    opacity: .7;
+  }
+
   .opacity-80 {
     opacity: .8;
   }
@@ -5363,6 +5429,10 @@
       color: var(--clarify-theme-tokens-colors-foreground);
     }
 
+    .hover\:text-\(--clarify-ui-text\):hover {
+      color: var(--clarify-ui-text);
+    }
+
     .hover\:text-\(--clarify-ui-text-strong\):hover {
       color: var(--clarify-ui-text-strong);
     }
@@ -5663,6 +5733,10 @@
       position: absolute;
     }
 
+    .sm\:sticky {
+      position: sticky;
+    }
+
     .sm\:top-14 {
       top: calc(var(--spacing) * 14);
     }
@@ -5671,6 +5745,10 @@
       top: calc(var(--spacing) * 16);
     }
 
+    .sm\:top-24 {
+      top: calc(var(--spacing) * 24);
+    }
+
     .sm\:right-0 {
       right: 0;
     }
@@ -5747,6 +5825,10 @@
       grid-template-columns: 2rem minmax(0, 1fr) minmax(0, 1fr);
     }
 
+    .sm\:grid-cols-\[8\.5rem_minmax\(0\,1fr\)\] {
+      grid-template-columns: 8.5rem minmax(0, 1fr);
+    }
+
     .sm\:grid-cols-\[minmax\(0\,1fr\)_auto\] {
       grid-template-columns: minmax(0, 1fr) auto;
     }
@@ -5783,6 +5865,10 @@
       gap: calc(var(--spacing) * 4);
     }
 
+    .sm\:gap-12 {
+      gap: calc(var(--spacing) * 12);
+    }
+
     .sm\:self-end {
       align-self: flex-end;
     }

package/output/server.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_ClarifyShell = require("./ClarifyShell-GCXbb_AF.cjs");
-const require_PageActions = require("./PageActions-DxGK-444.cjs");
+const require_ClarifyShell = require("./ClarifyShell-DLOGS18o.cjs");
+const require_PageActions = require("./PageActions-CVOTIuxh.cjs");
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");

package/output/server.js

@@ -1,5 +1,5 @@
-import { t as ClarifyShell } from "./ClarifyShell-nV23Fn7m.js";
-import { T as prefixHref } from "./PageActions-BbmyFeSk.js";
+import { t as ClarifyShell } from "./ClarifyShell-DGm_R5Bp.js";
+import { E as prefixHref } from "./PageActions-D52u18C8.js";
 import { StrictMode } from "react";
 import { StaticRouter } from "react-router-dom";
 import { jsx } from "react/jsx-runtime";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clarify-labs/renderer",
-  "version": "0.11.9",
+  "version": "0.11.11",
   "license": "AGPL-3.0-only",
   "type": "module",
   "repository": {