@clarify-labs/renderer 0.2.0 → 0.4.0

package/output/openapi/types.d.ts

@@ -0,0 +1,66 @@
+export type { OpenAPIOperation, OpenAPISpec } from './utils';
+export type OpenApiRecord = Record<string, unknown>;
+export type OpenApiParameter = {
+    name?: string;
+    in?: string;
+    required?: boolean;
+    description?: string;
+    schema?: unknown;
+};
+export type OpenApiMediaType = {
+    schema?: unknown;
+    example?: unknown;
+    examples?: Record<string, unknown>;
+    encoding?: Record<string, {
+        contentType?: string;
+    }>;
+};
+export type OpenApiResponse = {
+    description?: string;
+    content?: Record<string, OpenApiMediaType>;
+};
+export type OpenApiServerVariable = {
+    default?: string;
+    enum?: string[];
+    description?: string;
+};
+export type OpenApiServer = {
+    url?: string;
+    description?: string;
+    variables?: Record<string, OpenApiServerVariable>;
+};
+export type OpenApiSecurityScheme = {
+    type?: string;
+    scheme?: string;
+    bearerFormat?: string;
+    in?: string;
+    name?: string;
+    flows?: unknown;
+    openIdConnectUrl?: string;
+};
+export type OpenApiSecurityRequirement = Record<string, string[]>;
+export type RequestAuthInput = {
+    name: string;
+    value: string;
+    scheme: OpenApiSecurityScheme;
+};
+export type MediaTypeEntry = {
+    mediaType: string;
+    value: OpenApiMediaType;
+};
+export type ExampleEntry = {
+    key: string;
+    title: string;
+    summary?: string;
+    value: unknown;
+    generated?: boolean;
+};
+export type RequestCodeExample = {
+    key: string;
+    title: string;
+    language: string;
+    languageKey: string;
+    clientKey: string;
+    clientTitle: string;
+    code: string;
+};

package/output/{render-bPMMBoDH.js → render-BCiQn6Q1.js}

@@ -1,4 +1,4 @@
-import { m as OpenApisContext, p as ClarifyConfigContext, t as AppShell, u as ThemeProvider } from "./AppShell-Ci894P_0.js";
+import { T as OpenApisContext, t as AppShell, u as ThemeProvider, w as ClarifyConfigContext } from "./AppShell-nQnuKyn2.js";
 import { StrictMode } from "react";
 import { BrowserRouter } from "react-router-dom";
 import { jsx } from "react/jsx-runtime";
@@ -52,4 +52,4 @@ function render(options) {
 //#endregion
 export { render as t };
 
-//# sourceMappingURL=render-bPMMBoDH.js.map
+//# sourceMappingURL=render-BCiQn6Q1.js.map

package/output/{render-bPMMBoDH.js.map → render-BCiQn6Q1.js.map}

@@ -1 +1 @@
-{"version":3,"file":"render-bPMMBoDH.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 { ThemeProvider } from '../components/ThemeProvider'\nimport { ClarifyConfigContext, OpenApisContext } from '../context'\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 = {}, container } = 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        <ClarifyConfigContext.Provider value={config}>\n          <OpenApisContext.Provider value={openApis}>\n            <ThemeProvider>\n              <AppShell config={config} routes={routes} navigation={navigation ?? []} />\n            </ThemeProvider>\n          </OpenApisContext.Provider>\n        </ClarifyConfigContext.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":";;;;;;;;;;;;;;;;AAmBA,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,cAAc;CAEjE,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,qBAAqB,UAAtB;GAA+B,OAAO;aACpC,oBAAC,gBAAgB,UAAjB;IAA0B,OAAO;cAC/B,oBAAC,eAAD,EAAA,UACE,oBAAC,UAAD;KAAkB;KAAgB;KAAQ,YAAY,cAAc,CAAC;IAAI,CAAA,EAC5D,CAAA;GACS,CAAA;EACG,CAAA;CAClB,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-BCiQn6Q1.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 { ThemeProvider } from '../components/ThemeProvider'\nimport { ClarifyConfigContext, OpenApisContext } from '../context'\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 = {}, container } = 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        <ClarifyConfigContext.Provider value={config}>\n          <OpenApisContext.Provider value={openApis}>\n            <ThemeProvider>\n              <AppShell config={config} routes={routes} navigation={navigation ?? []} />\n            </ThemeProvider>\n          </OpenApisContext.Provider>\n        </ClarifyConfigContext.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":";;;;;;;;;;;;;;;;AAmBA,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,cAAc;CAEjE,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,qBAAqB,UAAtB;GAA+B,OAAO;aACpC,oBAAC,gBAAgB,UAAjB;IAA0B,OAAO;cAC/B,oBAAC,eAAD,EAAA,UACE,oBAAC,UAAD;KAAkB;KAAgB;KAAQ,YAAY,cAAc,CAAC;IAAI,CAAA,EAC5D,CAAA;GACS,CAAA;EACG,CAAA;CAClB,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/{render-z9rSQ00n.cjs → render-CZsdzmme.cjs}

@@ -1,4 +1,4 @@
-const require_AppShell = require("./AppShell-4KB3lU-n.cjs");
+const require_AppShell = require("./AppShell-CZw1MrPG.cjs");
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -57,4 +57,4 @@ Object.defineProperty(exports, "render", {
 	}
 });
 
-//# sourceMappingURL=render-z9rSQ00n.cjs.map
+//# sourceMappingURL=render-CZsdzmme.cjs.map

package/output/{render-z9rSQ00n.cjs.map → render-CZsdzmme.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"render-z9rSQ00n.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 { ThemeProvider } from '../components/ThemeProvider'\nimport { ClarifyConfigContext, OpenApisContext } from '../context'\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 = {}, container } = 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        <ClarifyConfigContext.Provider value={config}>\n          <OpenApisContext.Provider value={openApis}>\n            <ThemeProvider>\n              <AppShell config={config} routes={routes} navigation={navigation ?? []} />\n            </ThemeProvider>\n          </OpenApisContext.Provider>\n        </ClarifyConfigContext.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":";;;;;;;;;;;;;;;;AAmBA,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,cAAc;CAEjE,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,iBAAA,qBAAqB,UAAtB;GAA+B,OAAO;aACpC,iBAAA,GAAA,kBAAA,KAAC,iBAAA,gBAAgB,UAAjB;IAA0B,OAAO;cAC/B,iBAAA,GAAA,kBAAA,KAAC,iBAAA,eAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,KAAC,iBAAA,UAAD;KAAkB;KAAgB;KAAQ,YAAY,cAAc,CAAC;IAAI,CAAA,EAC5D,CAAA;GACS,CAAA;EACG,CAAA;CAClB,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-CZsdzmme.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 { ThemeProvider } from '../components/ThemeProvider'\nimport { ClarifyConfigContext, OpenApisContext } from '../context'\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 = {}, container } = 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        <ClarifyConfigContext.Provider value={config}>\n          <OpenApisContext.Provider value={openApis}>\n            <ThemeProvider>\n              <AppShell config={config} routes={routes} navigation={navigation ?? []} />\n            </ThemeProvider>\n          </OpenApisContext.Provider>\n        </ClarifyConfigContext.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":";;;;;;;;;;;;;;;;AAmBA,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,cAAc;CAEjE,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,iBAAA,qBAAqB,UAAtB;GAA+B,OAAO;aACpC,iBAAA,GAAA,kBAAA,KAAC,iBAAA,gBAAgB,UAAjB;IAA0B,OAAO;cAC/B,iBAAA,GAAA,kBAAA,KAAC,iBAAA,eAAD,EAAA,UACE,iBAAA,GAAA,kBAAA,KAAC,iBAAA,UAAD;KAAkB;KAAgB;KAAQ,YAAY,cAAc,CAAC;IAAI,CAAA,EAC5D,CAAA;GACS,CAAA;EACG,CAAA;CAClB,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"}