@clarify-labs/renderer 0.10.0 → 0.10.1

package/output/{render-CV0a-qtD.js → render-DKj24Jqw.js}

@@ -1,20 +1,22 @@
-import { t as ClarifyShell } from "./ClarifyShell-CxhXBtsR.js";
+import { t as ClarifyShell } from "./ClarifyShell-1LuBliwt.js";
 import { StrictMode } from "react";
 import { BrowserRouter } from "react-router-dom";
 import { jsx } from "react/jsx-runtime";
 import { createRoot, hydrateRoot } from "react-dom/client";
 //#region source/runtime/render.tsx
+var root;
 /**
 * Clarify 客户端 Hydration 入口。
 * 在文档项目的 main.tsx 中调用：
 * ```ts
 * import { render } from '@clarify-labs/renderer';
-* import { routes } from 'virtual:clarify-routes';
-* import { config } from 'virtual:clarify-config';
+* import { routes } from 'virtual:clarify/routes';
+* import { config } from 'virtual:clarify/config';
 * render({ config, routes });
 * ```
 */
 function isHydrationDebugEnabled() {
+	if (typeof window === "undefined") return false;
 	try {
 		return new URLSearchParams(window.location.search).get("clarifyHydrationDebug") === "1" || window.localStorage.getItem("clarify:hydration-debug") === "1";
 	} catch {
@@ -22,7 +24,7 @@ function isHydrationDebugEnabled() {
 	}
 }
 function render(options) {
-	const { config, routes, navigation, openApis = {}, runtimeSlots, container, themeEditor = false } = options;
+	const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, container, themeEditor = false } = options;
 	const target = container ?? document.getElementById("root");
 	if (!target) throw new Error("[clarify] 渲染失败：找不到挂载节点，请确保 HTML 中存在 id=\"root\" 的元素");
 	const app = /* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(BrowserRouter, {
@@ -31,22 +33,27 @@ function render(options) {
 			config,
 			routes,
 			navigation,
-			openApis,
+			openApiSpecs,
 			runtimeSlots,
 			themeEditor
 		})
 	}) });
 	const hydrationDebug = isHydrationDebugEnabled();
+	if (root) {
+		root.render(app);
+		return;
+	}
 	try {
-		hydrateRoot(target, app, { onRecoverableError(error, errorInfo) {
+		root = hydrateRoot(target, app, { onRecoverableError(error, errorInfo) {
 			if (hydrationDebug) console.warn("[clarify] Recoverable hydration error:", error, errorInfo);
 		} });
 	} catch (err) {
 		console.warn("[clarify] Hydration failed, falling back to client render:", err);
-		createRoot(target).render(app);
+		root = createRoot(target);
+		root.render(app);
 	}
 }
 //#endregion
 export { render as t };
 
-//# sourceMappingURL=render-CV0a-qtD.js.map
+//# sourceMappingURL=render-DKj24Jqw.js.map

package/output/render-DKj24Jqw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-DKj24Jqw.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-CCCoUWDP.cjs → render-Di5B6Zc0.cjs}

@@ -1,20 +1,22 @@
-const require_ClarifyShell = require("./ClarifyShell-DjLRRW8T.cjs");
+const require_ClarifyShell = require("./ClarifyShell-C6li72Ce.cjs");
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
 let react_dom_client = require("react-dom/client");
 //#region source/runtime/render.tsx
+var root;
 /**
 * Clarify 客户端 Hydration 入口。
 * 在文档项目的 main.tsx 中调用：
 * ```ts
 * import { render } from '@clarify-labs/renderer';
-* import { routes } from 'virtual:clarify-routes';
-* import { config } from 'virtual:clarify-config';
+* import { routes } from 'virtual:clarify/routes';
+* import { config } from 'virtual:clarify/config';
 * render({ config, routes });
 * ```
 */
 function isHydrationDebugEnabled() {
+	if (typeof window === "undefined") return false;
 	try {
 		return new URLSearchParams(window.location.search).get("clarifyHydrationDebug") === "1" || window.localStorage.getItem("clarify:hydration-debug") === "1";
 	} catch {
@@ -22,7 +24,7 @@ function isHydrationDebugEnabled() {
 	}
 }
 function render(options) {
-	const { config, routes, navigation, openApis = {}, runtimeSlots, container, themeEditor = false } = options;
+	const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, container, themeEditor = false } = options;
 	const target = container ?? document.getElementById("root");
 	if (!target) throw new Error("[clarify] 渲染失败：找不到挂载节点，请确保 HTML 中存在 id=\"root\" 的元素");
 	const app = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.StrictMode, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.BrowserRouter, {
@@ -31,19 +33,24 @@ function render(options) {
 			config,
 			routes,
 			navigation,
-			openApis,
+			openApiSpecs,
 			runtimeSlots,
 			themeEditor
 		})
 	}) });
 	const hydrationDebug = isHydrationDebugEnabled();
+	if (root) {
+		root.render(app);
+		return;
+	}
 	try {
-		(0, react_dom_client.hydrateRoot)(target, app, { onRecoverableError(error, errorInfo) {
+		root = (0, react_dom_client.hydrateRoot)(target, app, { onRecoverableError(error, errorInfo) {
 			if (hydrationDebug) console.warn("[clarify] Recoverable hydration error:", error, errorInfo);
 		} });
 	} catch (err) {
 		console.warn("[clarify] Hydration failed, falling back to client render:", err);
-		(0, react_dom_client.createRoot)(target).render(app);
+		root = (0, react_dom_client.createRoot)(target);
+		root.render(app);
 	}
 }
 //#endregion
@@ -54,4 +61,4 @@ Object.defineProperty(exports, "render", {
 	}
 });
 
-//# sourceMappingURL=render-CCCoUWDP.cjs.map
+//# sourceMappingURL=render-Di5B6Zc0.cjs.map

package/output/render-Di5B6Zc0.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-Di5B6Zc0.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

@@ -106,9 +106,11 @@
     --color-sky-700: oklch(50% .134 242.749);
     --color-sky-900: oklch(39.1% .09 240.876);
     --color-sky-950: oklch(29.3% .066 243.157);
+    --color-violet-200: oklch(89.4% .057 293.283);
     --color-violet-300: oklch(81.1% .111 293.571);
     --color-violet-400: oklch(70.2% .183 293.541);
     --color-violet-500: oklch(60.6% .25 292.717);
+    --color-violet-700: oklch(49.1% .27 292.581);
     --color-fuchsia-400: oklch(74% .238 322.16);
     --color-fuchsia-500: oklch(66.7% .295 322.15);
     --color-pink-300: oklch(82.3% .12 346.018);
@@ -739,6 +741,17 @@
 
   :root, .clarify-app {
     --clarify-http-method-delete-text: var(--color-rose-700);
+    --clarify-http-method-webhook-background: #a685ff3d;
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    :root, .clarify-app {
+      --clarify-http-method-webhook-background: color-mix(in srgb, var(--color-violet-400) 24%, transparent);
+    }
+  }
+
+  :root, .clarify-app {
+    --clarify-http-method-webhook-text: var(--color-violet-700);
     --clarify-http-method-default-background: #9f9fa933;
   }
 
@@ -955,6 +968,17 @@
 
   .dark, .dark .clarify-app {
     --clarify-http-method-delete-text: var(--color-rose-200);
+    --clarify-http-method-webhook-background: #a685ff4d;
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    .dark, .dark .clarify-app {
+      --clarify-http-method-webhook-background: color-mix(in srgb, var(--color-violet-400) 30%, transparent);
+    }
+  }
+
+  .dark, .dark .clarify-app {
+    --clarify-http-method-webhook-text: var(--color-violet-200);
     --clarify-http-method-default-background: #9f9fa942;
   }
 
@@ -3023,6 +3047,10 @@
     background-color: var(--clarify-http-method-put-background);
   }
 
+  .bg-\(--clarify-http-method-webhook-background\) {
+    background-color: var(--clarify-http-method-webhook-background);
+  }
+
   .bg-\(--clarify-skeleton-accent-background\) {
     background-color: var(--clarify-skeleton-accent-background);
   }
@@ -3199,6 +3227,10 @@
     }
   }
 
+  .bg-sky-100 {
+    background-color: var(--color-sky-100);
+  }
+
   .bg-sky-400\/10 {
     background-color: #00bcfe1a;
   }
@@ -3724,6 +3756,10 @@
     color: var(--clarify-http-method-put-text);
   }
 
+  .text-\(--clarify-http-method-webhook-text\) {
+    color: var(--clarify-http-method-webhook-text);
+  }
+
   .text-\(--clarify-theme-tokens-colors-background\) {
     color: var(--clarify-theme-tokens-colors-background);
   }
@@ -3848,6 +3884,10 @@
     color: var(--color-sky-600);
   }
 
+  .text-sky-700 {
+    color: var(--color-sky-700);
+  }
+
   .text-sky-900 {
     color: var(--color-sky-900);
   }
@@ -5056,6 +5096,16 @@
     }
   }
 
+  .dark\:bg-sky-400\/15:where(.dark, .dark *) {
+    background-color: #00bcfe26;
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    .dark\:bg-sky-400\/15:where(.dark, .dark *) {
+      background-color: color-mix(in oklab, var(--color-sky-400) 15%, transparent);
+    }
+  }
+
   .dark\:bg-white:where(.dark, .dark *) {
     background-color: var(--color-white);
   }
@@ -5200,6 +5250,10 @@
     color: var(--color-sky-100);
   }
 
+  .dark\:text-sky-200:where(.dark, .dark *) {
+    color: var(--color-sky-200);
+  }
+
   .dark\:text-sky-400:where(.dark, .dark *) {
     color: var(--color-sky-400);
   }

package/output/runtime/ClarifyShell.d.ts

@@ -1,19 +1,18 @@
 import { ReactNode } from 'react';
-import { Config, NavigationTree, RouteItem } from '../core/types';
-import { OpenAPISpec } from '../openapi/lib/utils';
-import { RuntimeSlots } from '../slots';
+import { Config, NavigationTree, OpenApiRegistry, RouteItem } from '../core/types';
+import { RuntimeSlotRegistry } from '../slots';
 export type ClarifyShellProps = {
     config: Config;
     routes: RouteItem[];
     navigation?: NavigationTree;
-    openApis: Record<string, OpenAPISpec>;
-    runtimeSlots?: RuntimeSlots;
+    openApiSpecs: OpenApiRegistry;
+    runtimeSlots?: RuntimeSlotRegistry;
     themeEditor?: boolean;
     children?: ReactNode;
 };
 /**
  * Shared provider chain used by both client-side render and server-side
- * renderToHTML.  Wraps AppShell with ConfigContext → OpenApisContext →
+ * renderToHTML.  Wraps AppShell with ConfigContext → OpenApiSpecsContext →
  * ThemeProvider → ThemeRoot.
  *
  * The outer Router (BrowserRouter / StaticRouter) is left to the caller

package/output/server.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_PageActions = require("./PageActions-GS_cxeJN.cjs");
-const require_ClarifyShell = require("./ClarifyShell-DjLRRW8T.cjs");
+const require_ClarifyShell = require("./ClarifyShell-C6li72Ce.cjs");
+const require_PageActions = require("./PageActions-BjB6PYmL.cjs");
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -12,7 +12,7 @@ let react_dom_server = require("react-dom/server");
 * 返回 `div#root` 内部的 HTML，由 Clarify CLI 组装为完整的 HTML 文档。
 */
 function renderToHTML(options) {
-	const { config, routes, navigation, openApis = {}, runtimeSlots, url, themeEditor = false } = options;
+	const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, url, themeEditor = false } = options;
 	const location = require_PageActions.prefixHref(url, config.routePrefix);
 	return (0, react_dom_server.renderToString)(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.StrictMode, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.StaticRouter, {
 		basename: config.routePrefix,
@@ -21,7 +21,7 @@ function renderToHTML(options) {
 			config,
 			routes,
 			navigation,
-			openApis,
+			openApiSpecs,
 			runtimeSlots,
 			themeEditor
 		})

package/output/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","names":[],"sources":["../source/runtime/server.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { renderToString } from 'react-dom/server'\nimport { StaticRouter } from 'react-router-dom'\n\nimport type { ServerRenderOptions } from '../types'\nimport { prefixHref } from '../utils/href'\n\nimport { ClarifyShell } from './ClarifyShell'\n\n/**\n * Clarify 服务端渲染入口。\n * 由 @clarify-labs/cli 在构建时调用，为每条路由生成 React HTML 片段。\n * 返回 `div#root` 内部的 HTML，由 Clarify CLI 组装为完整的 HTML 文档。\n */\nexport function renderToHTML(options: ServerRenderOptions): string {\n  const { config, routes, navigation, openApis = {}, runtimeSlots, url, themeEditor = false } = options\n  const location = prefixHref(url, config.routePrefix)\n\n  return renderToString(\n    <StrictMode>\n      <StaticRouter basename={config.routePrefix} location={location}>\n        <ClarifyShell\n          config={config}\n          routes={routes}\n          navigation={navigation}\n          openApis={openApis}\n          runtimeSlots={runtimeSlots}\n          themeEditor={themeEditor}\n        />\n      </StaticRouter>\n    </StrictMode>\n  )\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAgB,aAAa,SAAsC;CACjE,MAAM,EAAE,QAAQ,QAAQ,YAAY,WAAW,CAAC,GAAG,cAAc,KAAK,cAAc,UAAU;CAC9F,MAAM,WAAW,oBAAA,WAAW,KAAK,OAAO,WAAW;CAEnD,QAAA,GAAA,iBAAA,eAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,MAAA,YAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,iBAAA,cAAD;EAAc,UAAU,OAAO;EAAuB;YACpD,iBAAA,GAAA,kBAAA,IAAA,CAAC,qBAAA,cAAD;GACU;GACA;GACI;GACF;GACI;GACD;EACd,CAAA;CACW,CAAA,EACJ,CAAA,CACd;AACF"}
+{"version":3,"file":"server.cjs","names":[],"sources":["../source/runtime/server.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { renderToString } from 'react-dom/server'\nimport { StaticRouter } from 'react-router-dom'\n\nimport type { ServerRenderOptions } from '../types'\nimport { prefixHref } from '../utils/href'\n\nimport { ClarifyShell } from './ClarifyShell'\n\n/**\n * Clarify 服务端渲染入口。\n * 由 @clarify-labs/cli 在构建时调用，为每条路由生成 React HTML 片段。\n * 返回 `div#root` 内部的 HTML，由 Clarify CLI 组装为完整的 HTML 文档。\n */\nexport function renderToHTML(options: ServerRenderOptions): string {\n  const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, url, themeEditor = false } = options\n  const location = prefixHref(url, config.routePrefix)\n\n  return renderToString(\n    <StrictMode>\n      <StaticRouter basename={config.routePrefix} location={location}>\n        <ClarifyShell\n          config={config}\n          routes={routes}\n          navigation={navigation}\n          openApiSpecs={openApiSpecs}\n          runtimeSlots={runtimeSlots}\n          themeEditor={themeEditor}\n        />\n      </StaticRouter>\n    </StrictMode>\n  )\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAgB,aAAa,SAAsC;CACjE,MAAM,EAAE,QAAQ,QAAQ,YAAY,eAAe,CAAC,GAAG,cAAc,KAAK,cAAc,UAAU;CAClG,MAAM,WAAW,oBAAA,WAAW,KAAK,OAAO,WAAW;CAEnD,QAAA,GAAA,iBAAA,eAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,MAAA,YAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,iBAAA,cAAD;EAAc,UAAU,OAAO;EAAuB;YACpD,iBAAA,GAAA,kBAAA,IAAA,CAAC,qBAAA,cAAD;GACU;GACA;GACI;GACE;GACA;GACD;EACd,CAAA;CACW,CAAA,EACJ,CAAA,CACd;AACF"}

package/output/server.js

@@ -1,5 +1,5 @@
-import { T as prefixHref } from "./PageActions-Dn8IGWoL.js";
-import { t as ClarifyShell } from "./ClarifyShell-CxhXBtsR.js";
+import { t as ClarifyShell } from "./ClarifyShell-1LuBliwt.js";
+import { T as prefixHref } from "./PageActions-D7K9LDGf.js";
 import { StrictMode } from "react";
 import { StaticRouter } from "react-router-dom";
 import { jsx } from "react/jsx-runtime";
@@ -11,7 +11,7 @@ import { renderToString } from "react-dom/server";
 * 返回 `div#root` 内部的 HTML，由 Clarify CLI 组装为完整的 HTML 文档。
 */
 function renderToHTML(options) {
-	const { config, routes, navigation, openApis = {}, runtimeSlots, url, themeEditor = false } = options;
+	const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, url, themeEditor = false } = options;
 	const location = prefixHref(url, config.routePrefix);
 	return renderToString(/* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(StaticRouter, {
 		basename: config.routePrefix,
@@ -20,7 +20,7 @@ function renderToHTML(options) {
 			config,
 			routes,
 			navigation,
-			openApis,
+			openApiSpecs,
 			runtimeSlots,
 			themeEditor
 		})

package/output/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../source/runtime/server.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { renderToString } from 'react-dom/server'\nimport { StaticRouter } from 'react-router-dom'\n\nimport type { ServerRenderOptions } from '../types'\nimport { prefixHref } from '../utils/href'\n\nimport { ClarifyShell } from './ClarifyShell'\n\n/**\n * Clarify 服务端渲染入口。\n * 由 @clarify-labs/cli 在构建时调用，为每条路由生成 React HTML 片段。\n * 返回 `div#root` 内部的 HTML，由 Clarify CLI 组装为完整的 HTML 文档。\n */\nexport function renderToHTML(options: ServerRenderOptions): string {\n  const { config, routes, navigation, openApis = {}, runtimeSlots, url, themeEditor = false } = options\n  const location = prefixHref(url, config.routePrefix)\n\n  return renderToString(\n    <StrictMode>\n      <StaticRouter basename={config.routePrefix} location={location}>\n        <ClarifyShell\n          config={config}\n          routes={routes}\n          navigation={navigation}\n          openApis={openApis}\n          runtimeSlots={runtimeSlots}\n          themeEditor={themeEditor}\n        />\n      </StaticRouter>\n    </StrictMode>\n  )\n}\n"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,aAAa,SAAsC;CACjE,MAAM,EAAE,QAAQ,QAAQ,YAAY,WAAW,CAAC,GAAG,cAAc,KAAK,cAAc,UAAU;CAC9F,MAAM,WAAW,WAAW,KAAK,OAAO,WAAW;CAEnD,OAAO,eACL,oBAAC,YAAD,EAAA,UACE,oBAAC,cAAD;EAAc,UAAU,OAAO;EAAuB;YACpD,oBAAC,cAAD;GACU;GACA;GACI;GACF;GACI;GACD;EACd,CAAA;CACW,CAAA,EACJ,CAAA,CACd;AACF"}
+{"version":3,"file":"server.js","names":[],"sources":["../source/runtime/server.tsx"],"sourcesContent":["import { StrictMode } from 'react'\nimport { renderToString } from 'react-dom/server'\nimport { StaticRouter } from 'react-router-dom'\n\nimport type { ServerRenderOptions } from '../types'\nimport { prefixHref } from '../utils/href'\n\nimport { ClarifyShell } from './ClarifyShell'\n\n/**\n * Clarify 服务端渲染入口。\n * 由 @clarify-labs/cli 在构建时调用，为每条路由生成 React HTML 片段。\n * 返回 `div#root` 内部的 HTML，由 Clarify CLI 组装为完整的 HTML 文档。\n */\nexport function renderToHTML(options: ServerRenderOptions): string {\n  const { config, routes, navigation, openApiSpecs = {}, runtimeSlots, url, themeEditor = false } = options\n  const location = prefixHref(url, config.routePrefix)\n\n  return renderToString(\n    <StrictMode>\n      <StaticRouter basename={config.routePrefix} location={location}>\n        <ClarifyShell\n          config={config}\n          routes={routes}\n          navigation={navigation}\n          openApiSpecs={openApiSpecs}\n          runtimeSlots={runtimeSlots}\n          themeEditor={themeEditor}\n        />\n      </StaticRouter>\n    </StrictMode>\n  )\n}\n"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,aAAa,SAAsC;CACjE,MAAM,EAAE,QAAQ,QAAQ,YAAY,eAAe,CAAC,GAAG,cAAc,KAAK,cAAc,UAAU;CAClG,MAAM,WAAW,WAAW,KAAK,OAAO,WAAW;CAEnD,OAAO,eACL,oBAAC,YAAD,EAAA,UACE,oBAAC,cAAD;EAAc,UAAU,OAAO;EAAuB;YACpD,oBAAC,cAAD;GACU;GACA;GACI;GACE;GACA;GACD;EACd,CAAA;CACW,CAAA,EACJ,CAAA,CACd;AACF"}

package/output/shell/Navigation.d.ts

@@ -2,5 +2,6 @@ import { NavigationNode } from '../types';
 export type NavigationProps = {
     navigation: NavigationNode[];
     className?: string;
+    currentLocale?: string;
 };
 export declare function Navigation(arg0: NavigationProps): import("react").JSX.Element;

package/output/shell/search/SearchDialog.d.ts

@@ -10,4 +10,4 @@ type SearchDialogProps = {
     onNavigate?: () => void;
 };
 export declare function SearchDialog(arg0: SearchDialogProps): import("react").JSX.Element;
-export {};
+export default SearchDialog;

package/output/slots/RuntimeSlot.d.ts

@@ -5,7 +5,7 @@ import { UISlotName } from './types';
  * One registered slot component, as compiled by the CLI into
  * `virtual:clarify/slots`.
  *
- * `component` is a lazy import factory `() => import('path')`. On the client
+ * `loadComponent` is a lazy import factory `() => import('path')`. On the client
  * it is passed to `React.lazy`. During SSR the factory is pre-resolved and
  * the resulting component is stored in `_resolved`, which the renderer uses
  * directly (no Suspense needed for `renderToString`).
@@ -14,21 +14,21 @@ export type RuntimeSlotEntry = {
     /** Plugin that registered this component, used as a stable render key. */
     plugin: string;
     /** Lazy import factory — `() => import('path')`. Set by CLI virtual module. */
-    component: () => Promise<{
+    loadComponent: () => Promise<{
         default: ComponentType;
     }>;
     /** @internal Pre-resolved component set by SSR before {@link renderToHTML}. */
     _resolved?: ComponentType;
 };
 /** Registry keyed by slot name. */
-export type RuntimeSlots = Partial<Record<UISlotName, RuntimeSlotEntry[]>>;
+export type RuntimeSlotRegistry = Partial<Record<UISlotName, RuntimeSlotEntry[]>>;
 type RuntimeSlotsContextValue = {
-    slots: RuntimeSlots;
+    slots: RuntimeSlotRegistry;
     route?: RouteItem;
 };
 export declare const RuntimeSlotsContext: import('react').Context<RuntimeSlotsContextValue>;
 type RuntimeSlotsProviderProps = {
-    slots?: RuntimeSlots;
+    slots?: RuntimeSlotRegistry;
     route?: RouteItem;
     children: ReactNode;
 };
@@ -36,7 +36,7 @@ type RuntimeSlotsProviderProps = {
  * Makes the compiled slot registry and the current route available to every
  * {@link RuntimeSlot} in the tree. Mounted once near the top of `AppShell`.
  */
-export declare function RuntimeSlotsProvider(arg0: RuntimeSlotsProviderProps): ReactNode;
+export declare function RuntimeSlotsProvider(props: RuntimeSlotsProviderProps): ReactNode;
 type RuntimeSlotProps = {
     name: UISlotName;
     /** Built-in default component for replacement slots. */
@@ -54,5 +54,5 @@ type RuntimeSlotProps = {
  * compatibility with `renderToString`. Otherwise, `React.lazy` + `Suspense`
  * is used for client-side code-splitting.
  */
-export declare function RuntimeSlot(arg0: RuntimeSlotProps): ReactNode;
+export declare function RuntimeSlot(props: RuntimeSlotProps): ReactNode;
 export {};

package/output/slots/context.d.ts

@@ -1,12 +1,12 @@
 import { ReactNode } from 'react';
-import { UISlotName, SlotContext } from './types';
-export type { UISlotName, SlotContext };
+import { UISlotName, UISlotContext } from './types';
+export type { UISlotName, UISlotContext };
 type SlotProviderProps = {
-    value: SlotContext;
+    value: UISlotContext;
     children: ReactNode;
 };
 /**
- * Provides an isolated {@link SlotContext} for a single slot component.
+ * Provides an isolated {@link UISlotContext} for a single slot component.
  * `RuntimeSlot` wraps every rendered slot component with this provider.
  */
 export declare function SlotProvider(arg0: SlotProviderProps): ReactNode;
@@ -17,4 +17,4 @@ export declare function SlotProvider(arg0: SlotProviderProps): ReactNode;
  * slot provider throws, which helps plugin authors notice that the component was
  * not mounted through a Clarify slot.
  */
-export declare function useSlot(): SlotContext;
+export declare function useSlot(): UISlotContext;

package/output/slots/index.d.ts

@@ -1,5 +1,5 @@
 export { SlotProvider, useSlot } from './context';
-export type { SlotContext, UISlotName } from './context';
+export type { UISlotContext, UISlotName } from './context';
 export { RuntimeSlot, RuntimeSlotsProvider, RuntimeSlotsContext } from './RuntimeSlot';
-export type { RuntimeSlotEntry, RuntimeSlots } from './RuntimeSlot';
+export type { RuntimeSlotEntry, RuntimeSlotRegistry } from './RuntimeSlot';
 export type { UISlotRegistration } from './types';

package/output/slots/types.d.ts

@@ -16,7 +16,7 @@ export type UISlotName = 'page.footer.before' | 'page.banner.replace' | 'page.fo
  * everything they need from this hook, which keeps slot components as ordinary
  * React components and lets the slot context grow without changing signatures.
  */
-export type SlotContext = {
+export type UISlotContext = {
     /** The slot the current component is mounted into. */
     name: UISlotName;
     /** Name of the plugin that registered the current slot component. */

package/output/utils/path.d.ts

@@ -1,2 +1,2 @@
 export declare function normalizeRoutePath(path: string): string;
-export declare function isSameRoutePath(a: string | undefined, b: string | undefined): boolean;
+export declare function isSameRoutePath(a: string | undefined, b: string | undefined, locale?: string): boolean;

package/package.json

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