@clarify-labs/renderer 0.7.1 → 0.7.2

package/output/client.js

@@ -1,4 +1,4 @@
 import { S as themeCookieName, _ as getStoredThemePreference, b as storeLocalePreference, g as getStoredLocalePreference, v as localeCookieName, x as storeThemePreference, y as readLocaleCookie } from "./PageActions-yoDRjkq8.js";
-import { a as themeBootstrapScript, i as themeEditorPresets, n as ThemeEditor, r as applyThemeVariables, s as themeStorageKey } from "./ThemeRoot-CLa0yvRQ.js";
-import { t as render } from "./render-D0ls3d2j.js";
+import { a as themeBootstrapScript, i as themeEditorPresets, n as ThemeEditor, r as applyThemeVariables, s as themeStorageKey } from "./ThemeRoot-QULrwQf6.js";
+import { t as render } from "./render-psutGbsg.js";
 export { ThemeEditor, applyThemeVariables, getStoredLocalePreference, getStoredThemePreference, localeCookieName, readLocaleCookie, render, storeLocalePreference, storeThemePreference, themeBootstrapScript, themeCookieName, themeEditorPresets, themeStorageKey };

package/output/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_PageActions = require("./PageActions-1RDCHcUY.cjs");
-const require_ThemeRoot = require("./ThemeRoot-DYS-lcK-.cjs");
-const require_OpenApiOperation = require("./OpenApiOperation-C4xZu4i0.cjs");
+const require_ThemeRoot = require("./ThemeRoot-UWj0iK1X.cjs");
+const require_OpenApiOperation = require("./OpenApiOperation-BcyW_ULy.cjs");
 const require_remark = require("./remark-Dv3owbSH.cjs");
-const require_render = require("./render-CRTqZzyY.cjs");
+const require_render = require("./render-ByWbJbrA.cjs");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region source/openapi/lib/spec-path.ts

package/output/index.js

@@ -1,8 +1,8 @@
-import { C as Code, D as CardGroup, E as Card, O as Callout, S as Collapse, T as Pre, _ as HeroPattern, b as Tag, f as Markdown, g as GridPattern, h as Prose, k as Button, m as WebFrame, n as OpenApiOperation$1, p as primitives_exports, v as Logo, w as CodeGroup, x as Feedback, y as Heading } from "./OpenApiOperation-LIL7bqxW.js";
+import { C as Code, D as CardGroup, E as Card, O as Callout, S as Collapse, T as Pre, _ as HeroPattern, b as Tag, f as Markdown, g as GridPattern, h as Prose, k as Button, m as WebFrame, n as OpenApiOperation$1, p as primitives_exports, v as Logo, w as CodeGroup, x as Feedback, y as Heading } from "./OpenApiOperation-tUKf7lZ4.js";
 import { A as OpenApisContext, D as useBuiltInText, M as useLocale, N as useOpenApis, O as ConfigContext, c as remToPx, h as useTheme, j as useConfig, m as ThemeProvider, n as PageTitleActions, o as SectionProvider, p as ThemeToggle, s as useSectionStore } from "./PageActions-yoDRjkq8.js";
-import { a as themeBootstrapScript, c as AppShell, d as PageBanner, i as themeEditorPresets, l as PageFooter, n as ThemeEditor, o as themePresets, r as applyThemeVariables, u as BuiltWithClarify } from "./ThemeRoot-CLa0yvRQ.js";
+import { a as themeBootstrapScript, c as AppShell, d as PageBanner, i as themeEditorPresets, l as PageFooter, n as ThemeEditor, o as themePresets, r as applyThemeVariables, u as BuiltWithClarify } from "./ThemeRoot-QULrwQf6.js";
 import { t as markdownRemarkPlugins } from "./remark-Dd2WU50s.js";
-import { t as render } from "./render-D0ls3d2j.js";
+import { t as render } from "./render-psutGbsg.js";
 import { useLocation } from "react-router-dom";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region source/openapi/lib/spec-path.ts

package/output/mdx/components.d.ts

@@ -31,6 +31,7 @@ export declare function useMDXComponents(components?: Record<string, unknown>):
     }): import("react").JSX.Element;
     Row(arg0: {
         children: import('react').ReactNode;
+        className?: string;
     }): import("react").JSX.Element;
     Col(arg0: {
         children: import('react').ReactNode;

package/output/mdx/primitives.d.ts

@@ -30,6 +30,7 @@ type NoteProps = {
 export declare function Note(arg0: NoteProps): import("react").JSX.Element;
 type RowProps = {
     children: ReactNode;
+    className?: string;
 };
 export declare function Row(arg0: RowProps): import("react").JSX.Element;
 type ColProps = {

package/output/openapi/components/EndpointSections.d.ts

@@ -0,0 +1,30 @@
+import { ReactNode } from 'react';
+import { OpenAPIOperation, OpenAPISpec } from '../lib/utils';
+import { MediaTypeEntry, OpenApiParameter, OpenApiRecord, OpenApiServer, RequestAuthInput } from '../types';
+type EndpointRequestProps = {
+    spec: OpenAPISpec;
+    path: string;
+    method: string;
+    description?: string;
+    groupedParameters: {
+        path: OpenApiParameter[];
+        query: OpenApiParameter[];
+        header: OpenApiParameter[];
+    };
+    parameters: OpenApiParameter[];
+    requestBody?: OpenApiRecord;
+    requestContents: MediaTypeEntry[];
+    requestSchema: unknown;
+    selectedRequestMediaType: string;
+    onSelectRequestMediaType: (value: string) => void;
+    selectedServer: OpenApiServer;
+    serverVariables: Record<string, string>;
+    auth?: RequestAuthInput;
+};
+export declare function EndpointRequest(arg0: EndpointRequestProps): ReactNode;
+type EndpointResponseProps = {
+    spec: OpenAPISpec;
+    operation: OpenAPIOperation;
+};
+export declare function EndpointResponse(arg0: EndpointResponseProps): ReactNode;
+export {};

package/output/preview.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_PageActions = require("./PageActions-1RDCHcUY.cjs");
-const require_OpenApiOperation = require("./OpenApiOperation-C4xZu4i0.cjs");
+const require_OpenApiOperation = require("./OpenApiOperation-BcyW_ULy.cjs");
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let lucide_react = require("lucide-react");

package/output/preview.js

@@ -1,4 +1,4 @@
-import { a as authPlaceholder, c as getServerKey, d as getRequestBody, i as ResponseExamplesPanel, l as getServers, o as defaultServerVariables, r as RequestExamplesPanel, s as getAuthOptions, t as EndpointIdentity, u as getMediaTypeEntries } from "./OpenApiOperation-LIL7bqxW.js";
+import { a as authPlaceholder, c as getServerKey, d as getRequestBody, i as ResponseExamplesPanel, l as getServers, o as defaultServerVariables, r as RequestExamplesPanel, s as getAuthOptions, t as EndpointIdentity, u as getMediaTypeEntries } from "./OpenApiOperation-tUKf7lZ4.js";
 import { A as OpenApisContext, O as ConfigContext, i as Navigation, k as LocaleContext, o as SectionProvider } from "./PageActions-yoDRjkq8.js";
 import { useState } from "react";
 import { MemoryRouter } from "react-router-dom";

package/output/{render-CRTqZzyY.cjs → render-ByWbJbrA.cjs}

@@ -1,5 +1,5 @@
 const require_PageActions = require("./PageActions-1RDCHcUY.cjs");
-const require_ThemeRoot = require("./ThemeRoot-DYS-lcK-.cjs");
+const require_ThemeRoot = require("./ThemeRoot-UWj0iK1X.cjs");
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -64,4 +64,4 @@ Object.defineProperty(exports, "render", {
 	}
 });
 
-//# sourceMappingURL=render-CRTqZzyY.cjs.map
+//# sourceMappingURL=render-ByWbJbrA.cjs.map

package/output/{render-CRTqZzyY.cjs.map → render-ByWbJbrA.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"render-CRTqZzyY.cjs","names":[],"sources":["../source/runtime/render.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { hydrateRoot, createRoot } from 'react-dom/client'\nimport { BrowserRouter } from 'react-router-dom'\n\nimport { AppShell } from '../app/AppShell'\nimport { ConfigContext, OpenApisContext } from '../context'\nimport { ThemeProvider } from '../theme/ThemeProvider'\nimport { ThemeRoot } from '../theme/ThemeRoot'\nimport type { RenderOptions } from '../types'\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  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, openApis = {}, bannerComponent, footerComponent, 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        <ConfigContext.Provider value={config}>\n          <OpenApisContext.Provider value={openApis}>\n            <ThemeProvider>\n              <ThemeRoot theme={config.theme} themeEditor={themeEditor}>\n                <AppShell config={config} routes={routes} navigation={navigation ?? []} bannerComponent={bannerComponent} footerComponent={footerComponent} />\n              </ThemeRoot>\n            </ThemeProvider>\n          </OpenApisContext.Provider>\n        </ConfigContext.Provider>\n      </BrowserRouter>\n    </StrictMode>\n  )\n\n  const hydrationDebug = isHydrationDebugEnabled()\n\n  try {\n    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    createRoot(target as Element).render(app)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,SAAS,0BAAmC;CAC1C,IAAI;EAEF,OAAO,IADY,gBAAgB,OAAO,SAAS,MAC5C,EAAO,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,WAAW,CAAC,GAAG,iBAAiB,iBAAiB,WAAW,cAAc,UAAU;CAExH,MAAM,SAAS,aAAa,SAAS,eAAe,MAAM;CAC1D,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qDAAmD;CAGrE,MAAM,MACJ,iBAAA,GAAA,kBAAA,KAAC,MAAA,YAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,KAAC,iBAAA,eAAD;EAAe,UAAU,OAAO;YAC9B,iBAAA,GAAA,kBAAA,KAAC,oBAAA,cAAc,UAAf;GAAwB,OAAO;aAC7B,iBAAA,GAAA,kBAAA,KAAC,oBAAA,gBAAgB,UAAjB;IAA0B,OAAO;cAC/B,iBAAA,GAAA,kBAAA,KAAC,oBAAA,eAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,KAAC,kBAAA,WAAD;KAAW,OAAO,OAAO;KAAoB;eAC3C,iBAAA,GAAA,kBAAA,KAAC,kBAAA,UAAD;MAAkB;MAAgB;MAAQ,YAAY,cAAc,CAAC;MAAoB;MAAkC;KAAkB,CAAA;IACpI,CAAA,EACE,CAAA;GACS,CAAA;EACJ,CAAA;CACX,CAAA,EACL,CAAA;CAGd,MAAM,iBAAiB,wBAAwB;CAE/C,IAAI;EACF,CAAA,GAAA,iBAAA,aAAY,QAAmB,KAAK,EAClC,mBAAmB,OAAO,WAAW;GAGnC,IAAI,gBACF,QAAQ,KAAK,0CAA0C,OAAO,SAAS;EAE3E,EACF,CAAC;CACH,SAAS,KAAK;EACZ,QAAQ,KAAK,8DAA8D,GAAG;EAC9E,CAAA,GAAA,iBAAA,YAAW,MAAiB,EAAE,OAAO,GAAG;CAC1C;AACF"}
+{"version":3,"file":"render-ByWbJbrA.cjs","names":[],"sources":["../source/runtime/render.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { hydrateRoot, createRoot } from 'react-dom/client'\nimport { BrowserRouter } from 'react-router-dom'\n\nimport { AppShell } from '../app/AppShell'\nimport { ConfigContext, OpenApisContext } from '../context'\nimport { ThemeProvider } from '../theme/ThemeProvider'\nimport { ThemeRoot } from '../theme/ThemeRoot'\nimport type { RenderOptions } from '../types'\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  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, openApis = {}, bannerComponent, footerComponent, 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        <ConfigContext.Provider value={config}>\n          <OpenApisContext.Provider value={openApis}>\n            <ThemeProvider>\n              <ThemeRoot theme={config.theme} themeEditor={themeEditor}>\n                <AppShell config={config} routes={routes} navigation={navigation ?? []} bannerComponent={bannerComponent} footerComponent={footerComponent} />\n              </ThemeRoot>\n            </ThemeProvider>\n          </OpenApisContext.Provider>\n        </ConfigContext.Provider>\n      </BrowserRouter>\n    </StrictMode>\n  )\n\n  const hydrationDebug = isHydrationDebugEnabled()\n\n  try {\n    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    createRoot(target as Element).render(app)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,SAAS,0BAAmC;CAC1C,IAAI;EAEF,OAAO,IADY,gBAAgB,OAAO,SAAS,MAC5C,EAAO,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,WAAW,CAAC,GAAG,iBAAiB,iBAAiB,WAAW,cAAc,UAAU;CAExH,MAAM,SAAS,aAAa,SAAS,eAAe,MAAM;CAC1D,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qDAAmD;CAGrE,MAAM,MACJ,iBAAA,GAAA,kBAAA,KAAC,MAAA,YAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,KAAC,iBAAA,eAAD;EAAe,UAAU,OAAO;YAC9B,iBAAA,GAAA,kBAAA,KAAC,oBAAA,cAAc,UAAf;GAAwB,OAAO;aAC7B,iBAAA,GAAA,kBAAA,KAAC,oBAAA,gBAAgB,UAAjB;IAA0B,OAAO;cAC/B,iBAAA,GAAA,kBAAA,KAAC,oBAAA,eAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,KAAC,kBAAA,WAAD;KAAW,OAAO,OAAO;KAAoB;eAC3C,iBAAA,GAAA,kBAAA,KAAC,kBAAA,UAAD;MAAkB;MAAgB;MAAQ,YAAY,cAAc,CAAC;MAAoB;MAAkC;KAAkB,CAAA;IACpI,CAAA,EACE,CAAA;GACS,CAAA;EACJ,CAAA;CACX,CAAA,EACL,CAAA;CAGd,MAAM,iBAAiB,wBAAwB;CAE/C,IAAI;EACF,CAAA,GAAA,iBAAA,aAAY,QAAmB,KAAK,EAClC,mBAAmB,OAAO,WAAW;GAGnC,IAAI,gBACF,QAAQ,KAAK,0CAA0C,OAAO,SAAS;EAE3E,EACF,CAAC;CACH,SAAS,KAAK;EACZ,QAAQ,KAAK,8DAA8D,GAAG;EAC9E,CAAA,GAAA,iBAAA,YAAW,MAAiB,EAAE,OAAO,GAAG;CAC1C;AACF"}

package/output/{render-D0ls3d2j.js → render-psutGbsg.js}

@@ -1,5 +1,5 @@
 import { A as OpenApisContext, O as ConfigContext, m as ThemeProvider } from "./PageActions-yoDRjkq8.js";
-import { c as AppShell, t as ThemeRoot } from "./ThemeRoot-CLa0yvRQ.js";
+import { c as AppShell, t as ThemeRoot } from "./ThemeRoot-QULrwQf6.js";
 import { StrictMode } from "react";
 import { BrowserRouter } from "react-router-dom";
 import { jsx } from "react/jsx-runtime";
@@ -59,4 +59,4 @@ function render(options) {
 //#endregion
 export { render as t };
 
-//# sourceMappingURL=render-D0ls3d2j.js.map
+//# sourceMappingURL=render-psutGbsg.js.map

package/output/{render-D0ls3d2j.js.map → render-psutGbsg.js.map}

@@ -1 +1 @@
-{"version":3,"file":"render-D0ls3d2j.js","names":[],"sources":["../source/runtime/render.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { hydrateRoot, createRoot } from 'react-dom/client'\nimport { BrowserRouter } from 'react-router-dom'\n\nimport { AppShell } from '../app/AppShell'\nimport { ConfigContext, OpenApisContext } from '../context'\nimport { ThemeProvider } from '../theme/ThemeProvider'\nimport { ThemeRoot } from '../theme/ThemeRoot'\nimport type { RenderOptions } from '../types'\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  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, openApis = {}, bannerComponent, footerComponent, 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        <ConfigContext.Provider value={config}>\n          <OpenApisContext.Provider value={openApis}>\n            <ThemeProvider>\n              <ThemeRoot theme={config.theme} themeEditor={themeEditor}>\n                <AppShell config={config} routes={routes} navigation={navigation ?? []} bannerComponent={bannerComponent} footerComponent={footerComponent} />\n              </ThemeRoot>\n            </ThemeProvider>\n          </OpenApisContext.Provider>\n        </ConfigContext.Provider>\n      </BrowserRouter>\n    </StrictMode>\n  )\n\n  const hydrationDebug = isHydrationDebugEnabled()\n\n  try {\n    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    createRoot(target as Element).render(app)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,SAAS,0BAAmC;CAC1C,IAAI;EAEF,OAAO,IADY,gBAAgB,OAAO,SAAS,MAC5C,EAAO,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,WAAW,CAAC,GAAG,iBAAiB,iBAAiB,WAAW,cAAc,UAAU;CAExH,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,cAAc,UAAf;GAAwB,OAAO;aAC7B,oBAAC,gBAAgB,UAAjB;IAA0B,OAAO;cAC/B,oBAAC,eAAD,EAAA,UACE,oBAAC,WAAD;KAAW,OAAO,OAAO;KAAoB;eAC3C,oBAAC,UAAD;MAAkB;MAAgB;MAAQ,YAAY,cAAc,CAAC;MAAoB;MAAkC;KAAkB,CAAA;IACpI,CAAA,EACE,CAAA;GACS,CAAA;EACJ,CAAA;CACX,CAAA,EACL,CAAA;CAGd,MAAM,iBAAiB,wBAAwB;CAE/C,IAAI;EACF,YAAY,QAAmB,KAAK,EAClC,mBAAmB,OAAO,WAAW;GAGnC,IAAI,gBACF,QAAQ,KAAK,0CAA0C,OAAO,SAAS;EAE3E,EACF,CAAC;CACH,SAAS,KAAK;EACZ,QAAQ,KAAK,8DAA8D,GAAG;EAC9E,WAAW,MAAiB,EAAE,OAAO,GAAG;CAC1C;AACF"}
+{"version":3,"file":"render-psutGbsg.js","names":[],"sources":["../source/runtime/render.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { hydrateRoot, createRoot } from 'react-dom/client'\nimport { BrowserRouter } from 'react-router-dom'\n\nimport { AppShell } from '../app/AppShell'\nimport { ConfigContext, OpenApisContext } from '../context'\nimport { ThemeProvider } from '../theme/ThemeProvider'\nimport { ThemeRoot } from '../theme/ThemeRoot'\nimport type { RenderOptions } from '../types'\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  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, openApis = {}, bannerComponent, footerComponent, 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        <ConfigContext.Provider value={config}>\n          <OpenApisContext.Provider value={openApis}>\n            <ThemeProvider>\n              <ThemeRoot theme={config.theme} themeEditor={themeEditor}>\n                <AppShell config={config} routes={routes} navigation={navigation ?? []} bannerComponent={bannerComponent} footerComponent={footerComponent} />\n              </ThemeRoot>\n            </ThemeProvider>\n          </OpenApisContext.Provider>\n        </ConfigContext.Provider>\n      </BrowserRouter>\n    </StrictMode>\n  )\n\n  const hydrationDebug = isHydrationDebugEnabled()\n\n  try {\n    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    createRoot(target as Element).render(app)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,SAAS,0BAAmC;CAC1C,IAAI;EAEF,OAAO,IADY,gBAAgB,OAAO,SAAS,MAC5C,EAAO,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,WAAW,CAAC,GAAG,iBAAiB,iBAAiB,WAAW,cAAc,UAAU;CAExH,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,cAAc,UAAf;GAAwB,OAAO;aAC7B,oBAAC,gBAAgB,UAAjB;IAA0B,OAAO;cAC/B,oBAAC,eAAD,EAAA,UACE,oBAAC,WAAD;KAAW,OAAO,OAAO;KAAoB;eAC3C,oBAAC,UAAD;MAAkB;MAAgB;MAAQ,YAAY,cAAc,CAAC;MAAoB;MAAkC;KAAkB,CAAA;IACpI,CAAA,EACE,CAAA;GACS,CAAA;EACJ,CAAA;CACX,CAAA,EACL,CAAA;CAGd,MAAM,iBAAiB,wBAAwB;CAE/C,IAAI;EACF,YAAY,QAAmB,KAAK,EAClC,mBAAmB,OAAO,WAAW;GAGnC,IAAI,gBACF,QAAQ,KAAK,0CAA0C,OAAO,SAAS;EAE3E,EACF,CAAC;CACH,SAAS,KAAK;EACZ,QAAQ,KAAK,8DAA8D,GAAG;EAC9E,WAAW,MAAiB,EAAE,OAAO,GAAG;CAC1C;AACF"}

package/output/renderer.css

@@ -2537,12 +2537,6 @@
     margin-block-end: calc(calc(var(--spacing) * 5) * calc(1 - var(--tw-space-y-reverse)));
   }
 
-  :where(.space-y-6 > :not(:last-child)) {
-    --tw-space-y-reverse: 0;
-    margin-block-start: calc(calc(var(--spacing) * 6) * var(--tw-space-y-reverse));
-    margin-block-end: calc(calc(var(--spacing) * 6) * calc(1 - var(--tw-space-y-reverse)));
-  }
-
   :where(.space-y-8 > :not(:last-child)) {
     --tw-space-y-reverse: 0;
     margin-block-start: calc(calc(var(--spacing) * 8) * var(--tw-space-y-reverse));
@@ -4594,8 +4588,8 @@
       position: sticky;
     }
 
-    .xl\:top-24 {
-      top: calc(var(--spacing) * 24);
+    .xl\:top-\[calc\(var\(--clarify-header-offset\,3\.5rem\)\+1\.5rem\)\] {
+      top: calc(var(--clarify-header-offset, 3.5rem) + 1.5rem);
     }
 
     .xl\:max-w-none {
@@ -4614,6 +4608,10 @@
       grid-template-columns: repeat(4, minmax(0, 1fr));
     }
 
+    .xl\:self-start {
+      align-self: flex-start;
+    }
+
     .xl\:px-6 {
       padding-inline: calc(var(--spacing) * 6);
     }

package/output/server.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_PageActions = require("./PageActions-1RDCHcUY.cjs");
-const require_ThemeRoot = require("./ThemeRoot-DYS-lcK-.cjs");
+const require_ThemeRoot = require("./ThemeRoot-UWj0iK1X.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 { A as OpenApisContext, O as ConfigContext, T as prefixHref, m as ThemeProvider } from "./PageActions-yoDRjkq8.js";
-import { c as AppShell, t as ThemeRoot } from "./ThemeRoot-CLa0yvRQ.js";
+import { c as AppShell, t as ThemeRoot } from "./ThemeRoot-QULrwQf6.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.7.1",
+  "version": "0.7.2",
   "license": "AGPL-3.0-only",
   "type": "module",
   "repository": {