@clarify-labs/renderer 0.7.1 → 0.8.0

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 { C as themeCookieName, S as storeThemePreference, _ as getStoredLocalePreference, b as readLocaleCookie, v as getStoredThemePreference, x as storeLocalePreference, y as localeCookieName } from "./PageActions-DR0asnKH.js";
+import { a as themeBootstrapScript, i as themeEditorPresets, n as ThemeEditor, r as applyThemeVariables, s as themeStorageKey } from "./ClarifyShell-BxB_6Uhd.js";
+import { t as render } from "./render-mGozubG5.js";
 export { ThemeEditor, applyThemeVariables, getStoredLocalePreference, getStoredThemePreference, localeCookieName, readLocaleCookie, render, storeLocalePreference, storeThemePreference, themeBootstrapScript, themeCookieName, themeEditorPresets, themeStorageKey };

package/output/components/Code.d.ts

@@ -18,5 +18,9 @@ type CodeProps = ComponentPropsWithoutRef<'code'> & {
     title?: string;
 };
 export declare function Code(arg0: CodeProps): import("react").JSX.Element;
-export declare function Pre(arg0: ComponentPropsWithoutRef<typeof CodeGroup>): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+type PreProps = ComponentPropsWithoutRef<typeof CodeGroup> & {
+    language?: string;
+    code?: string;
+};
+export declare function Pre(arg0: PreProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
 export {};

package/output/components/Mermaid.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+type MermaidProps = {
+    chart: string;
+    className?: string;
+};
+export declare function Mermaid(arg0: MermaidProps): ReactNode;
+export {};

package/output/components/index.d.ts

@@ -12,6 +12,7 @@ export { Heading } from './Heading';
 export { LocalizedLink, useLocalizedHref } from './LocalizedLink';
 export type { LocalizedLinkProps } from './LocalizedLink';
 export { Logo } from './Logo';
+export { Mermaid } from './Mermaid';
 export { GridPattern, HeroPattern } from './patterns';
 export { Prose } from './Prose';
 export { Tag } from './Tag';

package/output/context.d.ts

@@ -1 +1 @@
-export { ConfigContext, LocaleContext, OpenApisContext, useConfig, useLocale, useOpenApis } from './core/context';
+export { LocaleContext, OpenApisContext, useLocale, useOpenApis } from './core/context';

package/output/core/i18n.d.ts

@@ -1,5 +1,5 @@
 export type BuiltInLocale = 'en' | 'zh-CN';
-export type BuiltInTextKey = 'actions.code' | 'actions.copy' | 'actions.copied' | 'builtWith.label' | 'builtWith.prefix' | 'callout.danger' | 'callout.info' | 'callout.note' | 'callout.success' | 'callout.tip' | 'callout.warning' | 'contentActions.copyContent' | 'contentActions.copyContentDescription' | 'contentActions.copyLink' | 'contentActions.copyLinkDescription' | 'contentActions.copyLlms' | 'contentActions.copyLlmsDescription' | 'contentActions.copiedLlms' | 'contentActions.editPage' | 'contentActions.editPageDescription' | 'contentActions.copyOptions' | 'contentActions.copiedContent' | 'contentActions.copiedLink' | 'contentActions.viewMarkdown' | 'contentActions.viewMarkdownDescription' | 'contentActions.viewOpenApi' | 'contentActions.viewOpenApiDescription' | 'feedback.no' | 'feedback.prompt' | 'feedback.thanks' | 'feedback.yes' | 'navigation.documentation' | 'navigation.next' | 'navigation.previous' | 'navigation.previousNext' | 'navigation.toggle' | 'navbar.home' | 'navbar.openLinks' | 'navbar.sections' | 'notFound.description' | 'notFound.home' | 'notFound.label' | 'notFound.title' | 'openapi.apiDocumentation' | 'openapi.bodyProperties' | 'openapi.collapse' | 'openapi.endpointNotFound' | 'openapi.example' | 'openapi.expand' | 'openapi.headers' | 'openapi.language' | 'openapi.client' | 'openapi.mediaType' | 'openapi.openApiReference' | 'openapi.operationParameter' | 'openapi.optional' | 'openapi.parameter' | 'openapi.pathParameters' | 'openapi.queryParameters' | 'openapi.request' | 'openapi.requestBody' | 'openapi.required' | 'openapi.requiredBadge' | 'openapi.response' | 'openapi.responses' | 'openapi.schemaExample' | 'openapi.scrollExamplesLeft' | 'openapi.scrollExamplesRight' | 'openapi.specNotFound' | 'openapi.specPathMissing' | 'openapi.status' | 'openapi.version' | 'search.button' | 'search.noResults' | 'search.placeholder' | 'search.shortcutCtrl' | 'renderError.componentStack' | 'renderError.description' | 'renderError.details' | 'renderError.message' | 'renderError.path' | 'renderError.reload' | 'renderError.stack' | 'renderError.timestamp' | 'renderError.title' | 'renderError.type' | 'theme.switchToDark' | 'theme.switchToLight' | 'language.switch';
+export type BuiltInTextKey = 'actions.code' | 'actions.copy' | 'actions.copied' | 'builtWith.label' | 'builtWith.prefix' | 'callout.danger' | 'callout.info' | 'callout.note' | 'callout.success' | 'callout.tip' | 'callout.warning' | 'contentActions.copyContent' | 'contentActions.copyContentDescription' | 'contentActions.copyLink' | 'contentActions.copyLinkDescription' | 'contentActions.copyLlms' | 'contentActions.copyLlmsDescription' | 'contentActions.copiedLlms' | 'contentActions.editPage' | 'contentActions.editPageDescription' | 'contentActions.copyOptions' | 'contentActions.copiedContent' | 'contentActions.copiedLink' | 'contentActions.viewMarkdown' | 'contentActions.viewMarkdownDescription' | 'contentActions.viewOpenApi' | 'contentActions.viewOpenApiDescription' | 'feedback.no' | 'feedback.prompt' | 'feedback.thanks' | 'feedback.yes' | 'navigation.documentation' | 'navigation.next' | 'navigation.previous' | 'navigation.previousNext' | 'navigation.toggle' | 'navbar.home' | 'navbar.openLinks' | 'navbar.sections' | 'notFound.description' | 'notFound.home' | 'notFound.label' | 'notFound.title' | 'openapi.apiDocumentation' | 'openapi.bodyProperties' | 'openapi.collapse' | 'openapi.endpointNotFound' | 'openapi.example' | 'openapi.expand' | 'openapi.headers' | 'openapi.language' | 'openapi.client' | 'openapi.mediaType' | 'openapi.openApiReference' | 'openapi.operationParameter' | 'openapi.optional' | 'openapi.parameter' | 'openapi.pathParameters' | 'openapi.queryParameters' | 'openapi.request' | 'openapi.requestBody' | 'openapi.required' | 'openapi.requiredBadge' | 'openapi.response' | 'openapi.responses' | 'openapi.schemaExample' | 'openapi.scrollExamplesLeft' | 'openapi.scrollExamplesRight' | 'openapi.specNotFound' | 'openapi.specPathMissing' | 'openapi.status' | 'openapi.version' | 'search.button' | 'search.noResults' | 'search.placeholder' | 'search.shortcutCtrl' | 'renderError.componentStack' | 'renderError.description' | 'renderError.details' | 'renderError.message' | 'renderError.path' | 'renderError.reload' | 'renderError.stack' | 'renderError.timestamp' | 'renderError.title' | 'renderError.type' | 'theme.switchToDark' | 'theme.switchToLight' | 'language.switch' | 'mermaid.zoomIn' | 'mermaid.zoomOut' | 'mermaid.resetZoom' | 'mermaid.renderError' | 'mermaid.scrollHint';
 export declare function resolveBuiltInLocale(locale?: string): BuiltInLocale;
 export declare function translateBuiltInText(locale: string | undefined, key: BuiltInTextKey, replacements?: Record<string, string>): string;
 export declare function useBuiltInText(locale?: string): (key: BuiltInTextKey, replacements?: Record<string, string>) => string;

package/output/core/types.d.ts

@@ -1,6 +1,6 @@
 import { ComponentType } from 'react';
 import { OpenAPISpec } from '../openapi/lib/utils';
-export type FooterComponentPath = string;
+import { RuntimeSlots } from '../slots';
 export type RouteComponent = ComponentType | (() => Promise<{
     default: ComponentType;
 }>);
@@ -58,19 +58,16 @@ export type NavbarLink = {
     href: string;
     external?: boolean;
 };
-export type BannerComponentPath = string;
-export type BannerConfigOptions = {
+export type BannerConfig = {
     content: LocalizedText;
     dismissible?: boolean;
     link?: NavbarLink;
 };
-export type BannerConfig = BannerConfigOptions | BannerComponentPath;
-export type FooterLinksConfig = {
+export type FooterConfig = {
     links?: NavbarLink[];
     socials?: Record<string, string>;
     copyright?: LocalizedText;
 };
-export type FooterConfig = FooterLinksConfig | FooterComponentPath;
 export type SourceConfig = {
     repository: string;
     branch?: string;
@@ -178,10 +175,8 @@ export type RenderOptions = {
     navigation?: NavigationTree;
     /** 从 virtual:clarify-openapi-registry 导入的 OpenAPI 规范表 */
     openApis?: Record<string, OpenAPISpec>;
-    /** Custom banner component imported from a configured banner path. */
-    bannerComponent?: ComponentType;
-    /** Custom footer component imported from a configured footer path. */
-    footerComponent?: ComponentType;
+    /** Plugin runtime UI slots imported from virtual:clarify-runtime-slots. */
+    runtimeSlots?: RuntimeSlots;
     /** Whether to render the live theme editor inside the app tree. */
     themeEditor?: boolean;
     /** 挂载节点，默认 document.getElementById('root') */
@@ -199,10 +194,8 @@ export type ServerRenderOptions = {
     navigation?: NavigationTree;
     /** 从 virtual:clarify-openapi-registry 导入的 OpenAPI 规范表 */
     openApis?: Record<string, OpenAPISpec>;
-    /** Custom banner component imported from a configured banner path. */
-    bannerComponent?: ComponentType;
-    /** Custom footer component imported from a configured footer path. */
-    footerComponent?: ComponentType;
+    /** Plugin runtime UI slots imported from virtual:clarify-runtime-slots. */
+    runtimeSlots?: RuntimeSlots;
     /** Whether to render the live theme editor inside the app tree. */
     themeEditor?: boolean;
     /** 当前请求的 URL */

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_PageActions = require("./PageActions-yycPlNyL.cjs");
+const require_ClarifyShell = require("./ClarifyShell-DNN5erFD.cjs");
+const require_OpenApiOperation = require("./OpenApiOperation-9SvCA_B4.cjs");
 const require_remark = require("./remark-Dv3owbSH.cjs");
-const require_render = require("./render-CRTqZzyY.cjs");
+const require_render = require("./render-CWvm77UW.cjs");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region source/openapi/lib/spec-path.ts
@@ -26,23 +26,22 @@ function normalizeSpecPath(specPath, currentRoutePath, routePrefix = "") {
 /**
 * 为绝对 specPath 生成带 locale 前缀的候选模块 ID。
 *
-* 局部嵌入（OpenApiOperation / OpenApiDocument）通常使用 `/api` 这样的绝对路径。
-* 默认 locale 的 spec 注册在 `virtual:clarify-page/api`，而其他 locale 的 spec
-* 注册在 `virtual:clarify-page/<locale>/api`。相对路径会因为当前路由已含 locale 前缀
-* 而自动解析到正确的 spec，但绝对路径不会，因此这里显式注入 locale 前缀。
+* 所有 locale 的 spec 都注册在 `virtual:clarify-page/<locale>/...` 下，
+* 因此绝对路径（如 `/api`）需要显式注入 locale 前缀才能命中。
+* 相对路径会因为当前路由已含 locale 前缀而自动解析到正确的 spec。
 */
-function localizeSpecModuleId(moduleId, specPath, locale, defaultLocale) {
-	if (!locale || locale === defaultLocale) return void 0;
+function localizeSpecModuleId(moduleId, specPath, locale, _defaultLocale) {
+	if (!locale) return void 0;
 	if (!specPath.startsWith("/") || specPath.startsWith(VIRTUAL_PREFIX)) return void 0;
 	const rest = moduleId.slice(21);
 	if (rest.startsWith(`${locale}/`) || rest === locale) return void 0;
 	return `${VIRTUAL_PREFIX}${locale}/${rest}`;
 }
 function useOpenApiSpec(spec, specPath) {
-	const specs = require_PageActions.useOpenApis();
-	const location = (0, react_router_dom.useLocation)();
 	const config = require_PageActions.useConfig();
 	const locale = require_PageActions.useLocale();
+	const specs = require_PageActions.useOpenApis();
+	const location = (0, react_router_dom.useLocation)();
 	if (spec) return spec;
 	if (!specPath) return null;
 	const normalized = normalizeSpecPath(specPath, location.pathname, config.routePrefix);
@@ -203,7 +202,8 @@ function OpenApiOperation(arg0) {
 var builtInMDXComponents = {
 	...require_OpenApiOperation.primitives_exports,
 	Markdown: require_OpenApiOperation.Markdown,
-	Collapse: require_OpenApiOperation.Collapse
+	Collapse: require_OpenApiOperation.Collapse,
+	Mermaid: require_OpenApiOperation.Mermaid
 };
 var builtInOpenAPIComponents = {
 	OpenApiDocument,
@@ -238,8 +238,8 @@ function DocShell(arg0) {
 	});
 }
 //#endregion
-exports.AppShell = require_ThemeRoot.AppShell;
-exports.BuiltWithClarify = require_ThemeRoot.BuiltWithClarify;
+exports.AppShell = require_ClarifyShell.AppShell;
+exports.BuiltWithClarify = require_ClarifyShell.BuiltWithClarify;
 exports.Button = require_OpenApiOperation.Button;
 exports.Callout = require_OpenApiOperation.Callout;
 exports.Card = require_OpenApiOperation.Card;
@@ -247,7 +247,6 @@ exports.CardGroup = require_OpenApiOperation.CardGroup;
 exports.Code = require_OpenApiOperation.Code;
 exports.CodeGroup = require_OpenApiOperation.CodeGroup;
 exports.Collapse = require_OpenApiOperation.Collapse;
-exports.ConfigContext = require_PageActions.ConfigContext;
 exports.DocShell = DocShell;
 exports.Feedback = require_OpenApiOperation.Feedback;
 exports.GridPattern = require_OpenApiOperation.GridPattern;
@@ -255,30 +254,34 @@ exports.Heading = require_OpenApiOperation.Heading;
 exports.HeroPattern = require_OpenApiOperation.HeroPattern;
 exports.Logo = require_OpenApiOperation.Logo;
 exports.Markdown = require_OpenApiOperation.Markdown;
+exports.Mermaid = require_OpenApiOperation.Mermaid;
 exports.OpenApiDocument = OpenApiDocument;
 exports.OpenApiOperation = OpenApiOperation;
 exports.OpenApisContext = require_PageActions.OpenApisContext;
-exports.PageBanner = require_ThemeRoot.PageBanner;
-exports.PageFooter = require_ThemeRoot.PageFooter;
+exports.PageBanner = require_ClarifyShell.PageBanner;
+exports.PageFooter = require_ClarifyShell.PageFooter;
 exports.Pre = require_OpenApiOperation.Pre;
 exports.Prose = require_OpenApiOperation.Prose;
+exports.RuntimeSlot = require_ClarifyShell.RuntimeSlot;
+exports.RuntimeSlotsProvider = require_ClarifyShell.RuntimeSlotsProvider;
 exports.SectionProvider = require_PageActions.SectionProvider;
+exports.SlotProvider = require_ClarifyShell.SlotProvider;
 exports.Tag = require_OpenApiOperation.Tag;
-exports.ThemeEditor = require_ThemeRoot.ThemeEditor;
+exports.ThemeEditor = require_ClarifyShell.ThemeEditor;
 exports.ThemeProvider = require_PageActions.ThemeProvider;
 exports.ThemeToggle = require_PageActions.ThemeToggle;
 exports.WebFrame = require_OpenApiOperation.WebFrame;
-exports.applyThemeVariables = require_ThemeRoot.applyThemeVariables;
+exports.applyThemeVariables = require_ClarifyShell.applyThemeVariables;
 exports.markdownRemarkPlugins = require_remark.markdownRemarkPlugins;
 exports.remToPx = require_PageActions.remToPx;
 exports.render = require_render.render;
-exports.themeBootstrapScript = require_ThemeRoot.themeBootstrapScript;
-exports.themeEditorPresets = require_ThemeRoot.themeEditorPresets;
-exports.themePresets = require_ThemeRoot.themePresets;
-exports.useConfig = require_PageActions.useConfig;
+exports.themeBootstrapScript = require_ClarifyShell.themeBootstrapScript;
+exports.themeEditorPresets = require_ClarifyShell.themeEditorPresets;
+exports.themePresets = require_ClarifyShell.themePresets;
 exports.useMDXComponents = useMDXComponents;
 exports.useOpenApis = require_PageActions.useOpenApis;
 exports.useSectionStore = require_PageActions.useSectionStore;
+exports.useSlot = require_ClarifyShell.useSlot;
 exports.useTheme = require_PageActions.useTheme;
 
 //# sourceMappingURL=index.cjs.map

package/output/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../source/openapi/lib/spec-path.ts","../source/openapi/lib/utils.ts","../source/openapi/entry.tsx","../source/mdx/components.ts","../source/mdx/DocShell.tsx"],"sourcesContent":["import { useLocation } from 'react-router-dom'\n\nimport { useConfig, useLocale, useOpenApis } from '../../core/context'\n\nimport type { OpenAPISpec } from './utils'\n\nconst VIRTUAL_PREFIX = 'virtual:clarify-page/'\n\nfunction resolveRelativePath(fromDir: string, to: string): string {\n  const parts = (fromDir + '/' + to).split('/').filter(Boolean)\n  const stack: string[] = []\n  for (const part of parts) {\n    if (part === '..') {\n      stack.pop()\n    } else if (part !== '.') {\n      stack.push(part)\n    }\n  }\n  return stack.join('/')\n}\n\nfunction normalizeSpecPath(specPath: string, currentRoutePath?: string, routePrefix = ''): string {\n  if (specPath.startsWith(VIRTUAL_PREFIX)) return specPath\n\n  const normalizedRoutePrefix = routePrefix.replace(/^\\/+|\\/+$/g, '')\n  const normalizedSpecPath = specPath.startsWith('/') && normalizedRoutePrefix && specPath.slice(1).startsWith(`${normalizedRoutePrefix}/`)\n    ? '/' + specPath.slice(normalizedRoutePrefix.length + 2)\n    : specPath\n\n  if (normalizedSpecPath.startsWith('/')) {\n    return VIRTUAL_PREFIX + normalizedSpecPath.replace(/^\\//, '')\n  }\n  const fromDir = currentRoutePath === '/' ? '' : currentRoutePath?.replace(/^\\//, '').replace(/\\/[^/]*$/, '') ?? ''\n  const normalizedFromDir = normalizedRoutePrefix && fromDir.startsWith(`${normalizedRoutePrefix}/`)\n    ? fromDir.slice(normalizedRoutePrefix.length + 1)\n    : fromDir\n  return VIRTUAL_PREFIX + resolveRelativePath(normalizedFromDir, normalizedSpecPath)\n}\n\n/**\n * 为绝对 specPath 生成带 locale 前缀的候选模块 ID。\n *\n * 局部嵌入（OpenApiOperation / OpenApiDocument）通常使用 `/api` 这样的绝对路径。\n * 默认 locale 的 spec 注册在 `virtual:clarify-page/api`，而其他 locale 的 spec\n * 注册在 `virtual:clarify-page/<locale>/api`。相对路径会因为当前路由已含 locale 前缀\n * 而自动解析到正确的 spec，但绝对路径不会，因此这里显式注入 locale 前缀。\n */\nfunction localizeSpecModuleId(moduleId: string, specPath: string, locale: string | undefined, defaultLocale: string | undefined): string | undefined {\n  if (!locale || locale === defaultLocale) return undefined\n  // 仅处理绝对路径；相对路径已经基于含 locale 前缀的当前路由解析。\n  if (!specPath.startsWith('/') || specPath.startsWith(VIRTUAL_PREFIX)) return undefined\n  const rest = moduleId.slice(VIRTUAL_PREFIX.length)\n  if (rest.startsWith(`${locale}/`) || rest === locale) return undefined\n  return `${VIRTUAL_PREFIX}${locale}/${rest}`\n}\n\nexport function useOpenApiSpec(spec?: OpenAPISpec, specPath?: string): OpenAPISpec | null {\n  const specs = useOpenApis()\n  const location = useLocation()\n  const config = useConfig()\n  const locale = useLocale()\n\n  if (spec) return spec\n  if (!specPath) return null\n\n  const normalized = normalizeSpecPath(specPath, location.pathname, config.routePrefix)\n  const localized = localizeSpecModuleId(normalized, specPath, locale, config.i18n?.defaultLocale)\n\n  if (localized && specs[localized]) return specs[localized]\n  return specs[normalized] ?? null\n}\n","import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\n\nimport type { OpenApiRecord } from '../types'\n\nexport type OpenAPISpec = OpenAPIV3.Document | OpenAPIV3_1.Document\nexport type OpenAPIOperation = OpenAPIV3.OperationObject | OpenAPIV3_1.OperationObject\n\nexport const OPENAPI_HTTP_METHODS = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'] as const\n\nexport type OpenAPIHttpMethod = typeof OPENAPI_HTTP_METHODS[number]\n\nexport function isOpenAPIHttpMethod(method: string): method is OpenAPIHttpMethod {\n  return (OPENAPI_HTTP_METHODS as readonly string[]).includes(method.toLowerCase())\n}\n\nfunction isRecord(value: unknown): value is OpenApiRecord {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction resolveOpenApiRef(spec: OpenAPISpec, ref: string): unknown {\n  if (!ref.startsWith('#/')) return undefined\n\n  return ref\n    .slice(2)\n    .split('/')\n    .map((part) => part.replace(/~1/g, '/').replace(/~0/g, '~'))\n    .reduce<unknown>((current, part) => (isRecord(current) ? current[part] : undefined), spec)\n}\n\nfunction getPathItem(spec: OpenAPISpec, path: string): OpenApiRecord | undefined {\n  const pathItem = spec.paths?.[path]\n  const resolved = isRecord(pathItem) && typeof pathItem.$ref === 'string' ? resolveOpenApiRef(spec, pathItem.$ref) : pathItem\n  return isRecord(resolved) ? resolved : undefined\n}\n\nexport function getOpenApiOperation(spec: OpenAPISpec, path: string, method: string): OpenAPIOperation | undefined {\n  if (!isOpenAPIHttpMethod(method)) return undefined\n  return getPathItem(spec, path)?.[method.toLowerCase() as OpenAPIHttpMethod] as OpenAPIOperation | undefined\n}\n\nexport function listOpenApiOperations(spec: OpenAPISpec): Array<{ path: string; method: OpenAPIHttpMethod; operation: OpenAPIOperation }> {\n  const paths = spec.paths ?? {}\n  const operations: Array<{ path: string; method: OpenAPIHttpMethod; operation: OpenAPIOperation }> = []\n\n  for (const path of Object.keys(paths)) {\n    const pathItem = getPathItem(spec, path)\n    if (!pathItem) continue\n    for (const method of OPENAPI_HTTP_METHODS) {\n      const operation = pathItem[method]\n      if (operation) operations.push({ path, method, operation: operation as OpenAPIOperation })\n    }\n  }\n\n  return operations\n}\n","import type { ReactNode } from 'react'\n\nimport { PageTitleActions } from '../app/PageActions'\nimport { Prose } from '../components/Prose'\nimport { useBuiltInText } from '../core/i18n'\nimport { Markdown } from '../mdx/Markdown'\n\nimport { OpenApiOperation as OpenApiOperationComponent } from './components/OpenApiOperation'\nimport { useOpenApiSpec } from './lib/spec-path'\nimport { getOpenApiOperation, listOpenApiOperations } from './lib/utils'\nimport type { OpenAPISpec } from './lib/utils'\n\ntype OpenApiPathsProps = { spec: OpenAPISpec; tagFilter?: string[] }\n\ntype OpenApiHeaderProps = { spec: OpenAPISpec }\n\ntype WarningBoxProps = {\n  children: ReactNode\n  tone?: 'amber' | 'red'\n}\n\nexport type OpenApiDocumentProps = {\n  spec?: OpenAPISpec\n  specPath?: string\n  tagFilter?: string[]\n}\n\ntype OpenApiOperationWithSpecProps = {\n  spec: OpenAPISpec\n  path: string\n  method: string\n}\n\nexport type OpenApiOperationProps = {\n  specPath: string\n  path: string\n  method: string\n}\n\nfunction OpenApiHeader(arg0: OpenApiHeaderProps): ReactNode {\n  const { spec } = arg0\n\n  const t = useBuiltInText()\n  return (\n    <header className=\"clarify-openapi-header mb-16 border-b border-(--clarify-theme-tokens-colors-border) pb-8\">\n      <p className=\"mb-3 text-xs/6 font-medium tracking-widest text-(--clarify-ui-accent-text) uppercase\">\n        {t('openapi.openApiReference')}\n      </p>\n      <div className=\"clarify-page-title-row flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between\">\n        <h1 className=\"clarify-page-title min-w-0 flex-1\">{spec.info?.title ?? t('openapi.apiDocumentation')}</h1>\n        <PageTitleActions />\n      </div>\n      {spec.info?.description ? <Markdown className=\"lead mt-4 *:first:mt-0 *:last:mb-0\">{spec.info.description}</Markdown> : null}\n      {spec.info?.version ? <p className=\"mt-4 text-sm text-(--clarify-ui-text-faint)\">{t('openapi.version', { version: spec.info.version })}</p> : null}\n    </header>\n  )\n}\n\nfunction operationMatchesTags(operationTags: string[] | undefined, filterTags: string[] | undefined): boolean {\n  if (!filterTags?.length) return true\n  return operationTags?.some(tag => filterTags.includes(tag)) ?? false\n}\n\nfunction OpenApiPaths(arg0: OpenApiPathsProps): ReactNode {\n  const { spec, tagFilter } = arg0\n\n  const entries = listOpenApiOperations(spec)\n    .filter(({ operation }) => operationMatchesTags(operation.tags, tagFilter))\n    .map(({ path, method, operation }) => ({\n      path,\n      method: method.toUpperCase(),\n      operation,\n    }))\n\n  return (\n    <div className=\"clarify-api-endpoints divide-y divide-zinc-200/70 dark:divide-white/10\">\n      {entries.map(({ path, method, operation }) => (\n        <OpenApiOperationComponent key={`${method}-${path}`} spec={spec} path={path} method={method} operation={operation} />\n      ))}\n    </div>\n  )\n}\n\nfunction WarningBox(arg0: WarningBoxProps): ReactNode {\n  const { children, tone = 'amber' } = arg0\n\n  const classes = tone === 'red'\n    ? 'rounded-lg border border-red-200 bg-red-50 p-4 text-sm text-red-700 dark:border-red-500/30 dark:bg-red-500/10 dark:text-red-200'\n    : 'rounded-lg border border-amber-200 bg-amber-50 p-4 text-sm text-amber-700 dark:border-amber-500/30 dark:bg-amber-500/10 dark:text-amber-200'\n\n  return <div className={`clarify-warning ${classes}`}>{children}</div>\n}\n\nexport function OpenApiDocument(arg0: OpenApiDocumentProps): ReactNode {\n  const { spec, specPath, tagFilter } = arg0\n  const t = useBuiltInText()\n  const resolved = useOpenApiSpec(spec, specPath)\n\n  if (!resolved) {\n    return <WarningBox>{t('openapi.specNotFound', { specPath: specPath ?? t('openapi.specPathMissing') })}</WarningBox>\n  }\n\n  return (\n    <article className=\"clarify-openapi-page flex h-full flex-col pt-16 pb-10\">\n      <Prose className=\"flex-auto\">\n        <OpenApiHeader spec={resolved} />\n        <OpenApiPaths spec={resolved} tagFilter={tagFilter} />\n      </Prose>\n    </article>\n  )\n}\n\nfunction OpenApiOperationWithSpec(arg0: OpenApiOperationWithSpecProps): ReactNode {\n  const { spec, path, method } = arg0\n  const t = useBuiltInText()\n  const op = getOpenApiOperation(spec, path, method)\n\n  if (!op) {\n    return <WarningBox tone=\"red\">{t('openapi.endpointNotFound', { endpoint: `${method.toUpperCase()} ${path}` })}</WarningBox>\n  }\n\n  const normalizedMethod = method.toUpperCase()\n  return <OpenApiOperationComponent key={`${normalizedMethod}-${path}`} spec={spec} path={path} method={normalizedMethod} operation={op} />\n}\n\nexport function OpenApiOperation(arg0: OpenApiOperationProps): ReactNode {\n  const { specPath, path, method } = arg0\n  const t = useBuiltInText()\n  const spec = useOpenApiSpec(undefined, specPath)\n\n  if (!spec) {\n    return <WarningBox>{t('openapi.specNotFound', { specPath })}</WarningBox>\n  }\n\n  return <OpenApiOperationWithSpec spec={spec} path={path} method={method} />\n}\n","import { Collapse } from '../components/Collapse'\nimport { OpenApiDocument, OpenApiOperation } from '../openapi'\n\nimport { Markdown } from './Markdown'\nimport * as mdxPrimitives from './primitives'\n\nconst builtInMDXComponents = {\n  ...mdxPrimitives,\n  Markdown,\n  Collapse,\n}\n\nconst builtInOpenAPIComponents = {\n  OpenApiDocument,\n  OpenApiOperation,\n}\n\nexport function useMDXComponents(components: Record<string, unknown> = {}) {\n  return {\n    ...components,\n    ...builtInMDXComponents,\n    ...builtInOpenAPIComponents,\n  }\n}\n","import type { ReactNode } from 'react'\n\nimport { Prose } from '../components/Prose'\n\nexport type DocShellProps = {\n  title: string\n  subtitle?: string\n  children: ReactNode\n}\n\nexport function DocShell(arg0: DocShellProps) {\n  const { title, subtitle, children } = arg0\n\n  return (\n    <main className=\"clarify-doc-shell min-h-screen bg-(--clarify-theme-tokens-colors-background) px-6 py-10 text-(--clarify-theme-tokens-colors-foreground) md:px-10\">\n      <div className=\"mx-auto max-w-6xl\">\n        <header className=\"mb-10\">\n          <h1 className=\"text-3xl font-bold tracking-tight md:text-5xl\">{title}</h1>\n          {subtitle ? <p className=\"mt-3 max-w-2xl text-(--clarify-ui-text-soft)\">{subtitle}</p> : null}\n        </header>\n        <Prose>{children}</Prose>\n      </div>\n    </main>\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../source/openapi/lib/spec-path.ts","../source/openapi/lib/utils.ts","../source/openapi/entry.tsx","../source/mdx/components.ts","../source/mdx/DocShell.tsx"],"sourcesContent":["import { useLocation } from 'react-router-dom'\n\nimport { useConfig, useLocale, useOpenApis } from '../../core/context'\n\nimport type { OpenAPISpec } from './utils'\n\nconst VIRTUAL_PREFIX = 'virtual:clarify-page/'\n\nfunction resolveRelativePath(fromDir: string, to: string): string {\n  const parts = (fromDir + '/' + to).split('/').filter(Boolean)\n  const stack: string[] = []\n  for (const part of parts) {\n    if (part === '..') {\n      stack.pop()\n    } else if (part !== '.') {\n      stack.push(part)\n    }\n  }\n  return stack.join('/')\n}\n\nfunction normalizeSpecPath(specPath: string, currentRoutePath?: string, routePrefix = ''): string {\n  if (specPath.startsWith(VIRTUAL_PREFIX)) return specPath\n\n  const normalizedRoutePrefix = routePrefix.replace(/^\\/+|\\/+$/g, '')\n  const normalizedSpecPath = specPath.startsWith('/') && normalizedRoutePrefix && specPath.slice(1).startsWith(`${normalizedRoutePrefix}/`)\n    ? '/' + specPath.slice(normalizedRoutePrefix.length + 2)\n    : specPath\n\n  if (normalizedSpecPath.startsWith('/')) {\n    return VIRTUAL_PREFIX + normalizedSpecPath.replace(/^\\//, '')\n  }\n  const fromDir = currentRoutePath === '/' ? '' : currentRoutePath?.replace(/^\\//, '').replace(/\\/[^/]*$/, '') ?? ''\n  const normalizedFromDir = normalizedRoutePrefix && fromDir.startsWith(`${normalizedRoutePrefix}/`)\n    ? fromDir.slice(normalizedRoutePrefix.length + 1)\n    : fromDir\n  return VIRTUAL_PREFIX + resolveRelativePath(normalizedFromDir, normalizedSpecPath)\n}\n\n/**\n * 为绝对 specPath 生成带 locale 前缀的候选模块 ID。\n *\n * 所有 locale 的 spec 都注册在 `virtual:clarify-page/<locale>/...` 下，\n * 因此绝对路径（如 `/api`）需要显式注入 locale 前缀才能命中。\n * 相对路径会因为当前路由已含 locale 前缀而自动解析到正确的 spec。\n */\nfunction localizeSpecModuleId(moduleId: string, specPath: string, locale: string | undefined, _defaultLocale: string | undefined): string | undefined {\n  if (!locale) return undefined\n  // 仅处理绝对路径；相对路径已经基于含 locale 前缀的当前路由解析。\n  if (!specPath.startsWith('/') || specPath.startsWith(VIRTUAL_PREFIX)) return undefined\n  const rest = moduleId.slice(VIRTUAL_PREFIX.length)\n  if (rest.startsWith(`${locale}/`) || rest === locale) return undefined\n  return `${VIRTUAL_PREFIX}${locale}/${rest}`\n}\n\nexport function useOpenApiSpec(spec?: OpenAPISpec, specPath?: string): OpenAPISpec | null {\n  const config = useConfig()\n  const locale = useLocale()\n  const specs = useOpenApis()\n  const location = useLocation()\n\n  if (spec) return spec\n  if (!specPath) return null\n\n  const normalized = normalizeSpecPath(specPath, location.pathname, config.routePrefix)\n  const localized = localizeSpecModuleId(normalized, specPath, locale, config.i18n?.defaultLocale)\n\n  if (localized && specs[localized]) return specs[localized]\n  return specs[normalized] ?? null\n}\n","import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\n\nimport type { OpenApiRecord } from '../types'\n\nexport type OpenAPISpec = OpenAPIV3.Document | OpenAPIV3_1.Document\nexport type OpenAPIOperation = OpenAPIV3.OperationObject | OpenAPIV3_1.OperationObject\n\nexport const OPENAPI_HTTP_METHODS = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'] as const\n\nexport type OpenAPIHttpMethod = typeof OPENAPI_HTTP_METHODS[number]\n\nexport function isOpenAPIHttpMethod(method: string): method is OpenAPIHttpMethod {\n  return (OPENAPI_HTTP_METHODS as readonly string[]).includes(method.toLowerCase())\n}\n\nfunction isRecord(value: unknown): value is OpenApiRecord {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction resolveOpenApiRef(spec: OpenAPISpec, ref: string): unknown {\n  if (!ref.startsWith('#/')) return undefined\n\n  return ref\n    .slice(2)\n    .split('/')\n    .map((part) => part.replace(/~1/g, '/').replace(/~0/g, '~'))\n    .reduce<unknown>((current, part) => (isRecord(current) ? current[part] : undefined), spec)\n}\n\nfunction getPathItem(spec: OpenAPISpec, path: string): OpenApiRecord | undefined {\n  const pathItem = spec.paths?.[path]\n  const resolved = isRecord(pathItem) && typeof pathItem.$ref === 'string' ? resolveOpenApiRef(spec, pathItem.$ref) : pathItem\n  return isRecord(resolved) ? resolved : undefined\n}\n\nexport function getOpenApiOperation(spec: OpenAPISpec, path: string, method: string): OpenAPIOperation | undefined {\n  if (!isOpenAPIHttpMethod(method)) return undefined\n  return getPathItem(spec, path)?.[method.toLowerCase() as OpenAPIHttpMethod] as OpenAPIOperation | undefined\n}\n\nexport function listOpenApiOperations(spec: OpenAPISpec): Array<{ path: string; method: OpenAPIHttpMethod; operation: OpenAPIOperation }> {\n  const paths = spec.paths ?? {}\n  const operations: Array<{ path: string; method: OpenAPIHttpMethod; operation: OpenAPIOperation }> = []\n\n  for (const path of Object.keys(paths)) {\n    const pathItem = getPathItem(spec, path)\n    if (!pathItem) continue\n    for (const method of OPENAPI_HTTP_METHODS) {\n      const operation = pathItem[method]\n      if (operation) operations.push({ path, method, operation: operation as OpenAPIOperation })\n    }\n  }\n\n  return operations\n}\n","import type { ReactNode } from 'react'\n\nimport { PageTitleActions } from '../app/PageActions'\nimport { Prose } from '../components/Prose'\nimport { useBuiltInText } from '../core/i18n'\nimport { Markdown } from '../mdx/Markdown'\n\nimport { OpenApiOperation as OpenApiOperationComponent } from './components/OpenApiOperation'\nimport { useOpenApiSpec } from './lib/spec-path'\nimport { getOpenApiOperation, listOpenApiOperations } from './lib/utils'\nimport type { OpenAPISpec } from './lib/utils'\n\ntype OpenApiPathsProps = { spec: OpenAPISpec; tagFilter?: string[] }\n\ntype OpenApiHeaderProps = { spec: OpenAPISpec }\n\ntype WarningBoxProps = {\n  children: ReactNode\n  tone?: 'amber' | 'red'\n}\n\nexport type OpenApiDocumentProps = {\n  spec?: OpenAPISpec\n  specPath?: string\n  tagFilter?: string[]\n}\n\ntype OpenApiOperationWithSpecProps = {\n  spec: OpenAPISpec\n  path: string\n  method: string\n}\n\nexport type OpenApiOperationProps = {\n  specPath: string\n  path: string\n  method: string\n}\n\nfunction OpenApiHeader(arg0: OpenApiHeaderProps): ReactNode {\n  const { spec } = arg0\n\n  const t = useBuiltInText()\n  return (\n    <header className=\"clarify-openapi-header mb-16 border-b border-(--clarify-theme-tokens-colors-border) pb-8\">\n      <p className=\"mb-3 text-xs/6 font-medium tracking-widest text-(--clarify-ui-accent-text) uppercase\">\n        {t('openapi.openApiReference')}\n      </p>\n      <div className=\"clarify-page-title-row flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between\">\n        <h1 className=\"clarify-page-title min-w-0 flex-1\">{spec.info?.title ?? t('openapi.apiDocumentation')}</h1>\n        <PageTitleActions />\n      </div>\n      {spec.info?.description ? <Markdown className=\"lead mt-4 *:first:mt-0 *:last:mb-0\">{spec.info.description}</Markdown> : null}\n      {spec.info?.version ? <p className=\"mt-4 text-sm text-(--clarify-ui-text-faint)\">{t('openapi.version', { version: spec.info.version })}</p> : null}\n    </header>\n  )\n}\n\nfunction operationMatchesTags(operationTags: string[] | undefined, filterTags: string[] | undefined): boolean {\n  if (!filterTags?.length) return true\n  return operationTags?.some(tag => filterTags.includes(tag)) ?? false\n}\n\nfunction OpenApiPaths(arg0: OpenApiPathsProps): ReactNode {\n  const { spec, tagFilter } = arg0\n\n  const entries = listOpenApiOperations(spec)\n    .filter(({ operation }) => operationMatchesTags(operation.tags, tagFilter))\n    .map(({ path, method, operation }) => ({\n      path,\n      method: method.toUpperCase(),\n      operation,\n    }))\n\n  return (\n    <div className=\"clarify-api-endpoints divide-y divide-zinc-200/70 dark:divide-white/10\">\n      {entries.map(({ path, method, operation }) => (\n        <OpenApiOperationComponent key={`${method}-${path}`} spec={spec} path={path} method={method} operation={operation} />\n      ))}\n    </div>\n  )\n}\n\nfunction WarningBox(arg0: WarningBoxProps): ReactNode {\n  const { children, tone = 'amber' } = arg0\n\n  const classes = tone === 'red'\n    ? 'rounded-lg border border-red-200 bg-red-50 p-4 text-sm text-red-700 dark:border-red-500/30 dark:bg-red-500/10 dark:text-red-200'\n    : 'rounded-lg border border-amber-200 bg-amber-50 p-4 text-sm text-amber-700 dark:border-amber-500/30 dark:bg-amber-500/10 dark:text-amber-200'\n\n  return <div className={`clarify-warning ${classes}`}>{children}</div>\n}\n\nexport function OpenApiDocument(arg0: OpenApiDocumentProps): ReactNode {\n  const { spec, specPath, tagFilter } = arg0\n  const t = useBuiltInText()\n  const resolved = useOpenApiSpec(spec, specPath)\n\n  if (!resolved) {\n    return <WarningBox>{t('openapi.specNotFound', { specPath: specPath ?? t('openapi.specPathMissing') })}</WarningBox>\n  }\n\n  return (\n    <article className=\"clarify-openapi-page flex h-full flex-col pt-16 pb-10\">\n      <Prose className=\"flex-auto\">\n        <OpenApiHeader spec={resolved} />\n        <OpenApiPaths spec={resolved} tagFilter={tagFilter} />\n      </Prose>\n    </article>\n  )\n}\n\nfunction OpenApiOperationWithSpec(arg0: OpenApiOperationWithSpecProps): ReactNode {\n  const { spec, path, method } = arg0\n  const t = useBuiltInText()\n  const op = getOpenApiOperation(spec, path, method)\n\n  if (!op) {\n    return <WarningBox tone=\"red\">{t('openapi.endpointNotFound', { endpoint: `${method.toUpperCase()} ${path}` })}</WarningBox>\n  }\n\n  const normalizedMethod = method.toUpperCase()\n  return <OpenApiOperationComponent key={`${normalizedMethod}-${path}`} spec={spec} path={path} method={normalizedMethod} operation={op} />\n}\n\nexport function OpenApiOperation(arg0: OpenApiOperationProps): ReactNode {\n  const { specPath, path, method } = arg0\n  const t = useBuiltInText()\n  const spec = useOpenApiSpec(undefined, specPath)\n\n  if (!spec) {\n    return <WarningBox>{t('openapi.specNotFound', { specPath })}</WarningBox>\n  }\n\n  return <OpenApiOperationWithSpec spec={spec} path={path} method={method} />\n}\n","import { Collapse } from '../components/Collapse'\nimport { Mermaid } from '../components/Mermaid'\nimport { OpenApiDocument, OpenApiOperation } from '../openapi'\n\nimport { Markdown } from './Markdown'\nimport * as mdxPrimitives from './primitives'\n\nconst builtInMDXComponents = {\n  ...mdxPrimitives,\n  Markdown,\n  Collapse,\n  Mermaid,\n}\n\nconst builtInOpenAPIComponents = {\n  OpenApiDocument,\n  OpenApiOperation,\n}\n\nexport function useMDXComponents(components: Record<string, unknown> = {}) {\n  return {\n    ...components,\n    ...builtInMDXComponents,\n    ...builtInOpenAPIComponents,\n  }\n}\n","import type { ReactNode } from 'react'\n\nimport { Prose } from '../components/Prose'\n\nexport type DocShellProps = {\n  title: string\n  subtitle?: string\n  children: ReactNode\n}\n\nexport function DocShell(arg0: DocShellProps) {\n  const { title, subtitle, children } = arg0\n\n  return (\n    <main className=\"clarify-doc-shell min-h-screen bg-(--clarify-theme-tokens-colors-background) px-6 py-10 text-(--clarify-theme-tokens-colors-foreground) md:px-10\">\n      <div className=\"mx-auto max-w-6xl\">\n        <header className=\"mb-10\">\n          <h1 className=\"text-3xl font-bold tracking-tight md:text-5xl\">{title}</h1>\n          {subtitle ? <p className=\"mt-3 max-w-2xl text-(--clarify-ui-text-soft)\">{subtitle}</p> : null}\n        </header>\n        <Prose>{children}</Prose>\n      </div>\n    </main>\n  )\n}\n"],"mappings":"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"}

package/output/index.d.ts

@@ -3,14 +3,15 @@ import { BuiltWithClarify } from './app/BuiltWithClarify';
 import { PageBanner } from './app/PageBanner';
 import { PageFooter } from './app/PageFooter';
 import { SectionProvider, useSectionStore, Section } from './app/SectionProvider';
-import { Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, Feedback, GridPattern, Heading, HeroPattern, Logo, Pre, Prose, Tag, WebFrame } from './components';
-import { ConfigContext, OpenApisContext, useConfig, useOpenApis } from './context';
+import { Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, Feedback, GridPattern, Heading, HeroPattern, Logo, Mermaid, Pre, Prose, Tag, WebFrame } from './components';
+import { OpenApisContext, useOpenApis } from './context';
 import { useMDXComponents } from './mdx/components';
 import { DocShell } from './mdx/DocShell';
 import { Markdown } from './mdx/Markdown';
 import { markdownRemarkPlugins } from './mdx/remark';
 import { OpenApiDocument, OpenApiOperation } from './openapi';
 import { render } from './runtime/render';
+import { SlotProvider, RuntimeSlot, RuntimeSlotsProvider, useSlot } from './slots';
 import { applyThemeVariables, themeEditorPresets, ThemeEditor } from './theme/ThemeEditor';
 import { ThemeProvider, useTheme } from './theme/ThemeProvider';
 import { ThemeToggle } from './theme/ThemeToggle';
@@ -20,7 +21,9 @@ import { remToPx } from './utils/remToPx';
 export type { OpenApiOperationProps, OpenApiDocumentProps, OpenAPIOperation, OpenAPISpec } from './openapi';
 export type { ThemeEditorProps } from './theme/ThemeEditor';
 export type { Config, RouteItem, RenderOptions, ServerRenderOptions, Section };
-export { AppShell, render, ConfigContext, OpenApisContext, useConfig, useOpenApis, BuiltWithClarify, PageBanner, PageFooter, ThemeProvider, ThemeToggle, ThemeEditor, useTheme, SectionProvider, useSectionStore, remToPx, applyThemeVariables, themeEditorPresets, themePresets, themeBootstrapScript };
-export { Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, Pre, Prose, Heading, Logo, GridPattern, HeroPattern, Feedback, Tag, WebFrame };
+export type { RuntimeSlotEntry, RuntimeSlots, UISlotRegistration, UISlotName, SlotContext } from './slots';
+export { AppShell, render, OpenApisContext, useOpenApis, BuiltWithClarify, PageBanner, PageFooter, ThemeProvider, ThemeToggle, ThemeEditor, useTheme, SectionProvider, useSectionStore, remToPx, applyThemeVariables, themeEditorPresets, themePresets, themeBootstrapScript };
+export { Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, Pre, Prose, Heading, Logo, Mermaid, GridPattern, HeroPattern, Feedback, Tag, WebFrame };
 export { DocShell, Markdown, useMDXComponents, markdownRemarkPlugins };
+export { SlotProvider, RuntimeSlot, RuntimeSlotsProvider, useSlot };
 export { OpenApiDocument, OpenApiOperation };

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 { 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 Button, C as Code, D as Card, E as Mermaid, O as CardGroup, S as Collapse, T as Pre, _ as HeroPattern, b as Tag, f as Markdown, g as GridPattern, h as Prose, k as Callout, 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-J41rHO2l.js";
+import { M as useConfig, N as useLocale, O as useBuiltInText, P as useOpenApis, c as remToPx, g as useTheme, h as ThemeProvider, j as OpenApisContext, m as ThemeToggle, n as PageTitleActions, o as SectionProvider, s as useSectionStore } from "./PageActions-DR0asnKH.js";
+import { a as themeBootstrapScript, c as AppShell, d as BuiltWithClarify, f as RuntimeSlot, h as useSlot, i as themeEditorPresets, l as PageFooter, m as SlotProvider, n as ThemeEditor, o as themePresets, p as RuntimeSlotsProvider, r as applyThemeVariables, u as PageBanner } from "./ClarifyShell-BxB_6Uhd.js";
 import { t as markdownRemarkPlugins } from "./remark-Dd2WU50s.js";
-import { t as render } from "./render-D0ls3d2j.js";
+import { t as render } from "./render-mGozubG5.js";
 import { useLocation } from "react-router-dom";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region source/openapi/lib/spec-path.ts
@@ -25,23 +25,22 @@ function normalizeSpecPath(specPath, currentRoutePath, routePrefix = "") {
 /**
 * 为绝对 specPath 生成带 locale 前缀的候选模块 ID。
 *
-* 局部嵌入（OpenApiOperation / OpenApiDocument）通常使用 `/api` 这样的绝对路径。
-* 默认 locale 的 spec 注册在 `virtual:clarify-page/api`，而其他 locale 的 spec
-* 注册在 `virtual:clarify-page/<locale>/api`。相对路径会因为当前路由已含 locale 前缀
-* 而自动解析到正确的 spec，但绝对路径不会，因此这里显式注入 locale 前缀。
+* 所有 locale 的 spec 都注册在 `virtual:clarify-page/<locale>/...` 下，
+* 因此绝对路径（如 `/api`）需要显式注入 locale 前缀才能命中。
+* 相对路径会因为当前路由已含 locale 前缀而自动解析到正确的 spec。
 */
-function localizeSpecModuleId(moduleId, specPath, locale, defaultLocale) {
-	if (!locale || locale === defaultLocale) return void 0;
+function localizeSpecModuleId(moduleId, specPath, locale, _defaultLocale) {
+	if (!locale) return void 0;
 	if (!specPath.startsWith("/") || specPath.startsWith(VIRTUAL_PREFIX)) return void 0;
 	const rest = moduleId.slice(21);
 	if (rest.startsWith(`${locale}/`) || rest === locale) return void 0;
 	return `${VIRTUAL_PREFIX}${locale}/${rest}`;
 }
 function useOpenApiSpec(spec, specPath) {
-	const specs = useOpenApis();
-	const location = useLocation();
 	const config = useConfig();
 	const locale = useLocale();
+	const specs = useOpenApis();
+	const location = useLocation();
 	if (spec) return spec;
 	if (!specPath) return null;
 	const normalized = normalizeSpecPath(specPath, location.pathname, config.routePrefix);
@@ -202,7 +201,8 @@ function OpenApiOperation(arg0) {
 var builtInMDXComponents = {
 	...primitives_exports,
 	Markdown,
-	Collapse
+	Collapse,
+	Mermaid
 };
 var builtInOpenAPIComponents = {
 	OpenApiDocument,
@@ -237,6 +237,6 @@ function DocShell(arg0) {
 	});
 }
 //#endregion
-export { AppShell, BuiltWithClarify, Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, ConfigContext, DocShell, Feedback, GridPattern, Heading, HeroPattern, Logo, Markdown, OpenApiDocument, OpenApiOperation, OpenApisContext, PageBanner, PageFooter, Pre, Prose, SectionProvider, Tag, ThemeEditor, ThemeProvider, ThemeToggle, WebFrame, applyThemeVariables, markdownRemarkPlugins, remToPx, render, themeBootstrapScript, themeEditorPresets, themePresets, useConfig, useMDXComponents, useOpenApis, useSectionStore, useTheme };
+export { AppShell, BuiltWithClarify, Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, DocShell, Feedback, GridPattern, Heading, HeroPattern, Logo, Markdown, Mermaid, OpenApiDocument, OpenApiOperation, OpenApisContext, PageBanner, PageFooter, Pre, Prose, RuntimeSlot, RuntimeSlotsProvider, SectionProvider, SlotProvider, Tag, ThemeEditor, ThemeProvider, ThemeToggle, WebFrame, applyThemeVariables, markdownRemarkPlugins, remToPx, render, themeBootstrapScript, themeEditorPresets, themePresets, useMDXComponents, useOpenApis, useSectionStore, useSlot, useTheme };
 
 //# sourceMappingURL=index.js.map

package/output/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../source/openapi/lib/spec-path.ts","../source/openapi/lib/utils.ts","../source/openapi/entry.tsx","../source/mdx/components.ts","../source/mdx/DocShell.tsx"],"sourcesContent":["import { useLocation } from 'react-router-dom'\n\nimport { useConfig, useLocale, useOpenApis } from '../../core/context'\n\nimport type { OpenAPISpec } from './utils'\n\nconst VIRTUAL_PREFIX = 'virtual:clarify-page/'\n\nfunction resolveRelativePath(fromDir: string, to: string): string {\n  const parts = (fromDir + '/' + to).split('/').filter(Boolean)\n  const stack: string[] = []\n  for (const part of parts) {\n    if (part === '..') {\n      stack.pop()\n    } else if (part !== '.') {\n      stack.push(part)\n    }\n  }\n  return stack.join('/')\n}\n\nfunction normalizeSpecPath(specPath: string, currentRoutePath?: string, routePrefix = ''): string {\n  if (specPath.startsWith(VIRTUAL_PREFIX)) return specPath\n\n  const normalizedRoutePrefix = routePrefix.replace(/^\\/+|\\/+$/g, '')\n  const normalizedSpecPath = specPath.startsWith('/') && normalizedRoutePrefix && specPath.slice(1).startsWith(`${normalizedRoutePrefix}/`)\n    ? '/' + specPath.slice(normalizedRoutePrefix.length + 2)\n    : specPath\n\n  if (normalizedSpecPath.startsWith('/')) {\n    return VIRTUAL_PREFIX + normalizedSpecPath.replace(/^\\//, '')\n  }\n  const fromDir = currentRoutePath === '/' ? '' : currentRoutePath?.replace(/^\\//, '').replace(/\\/[^/]*$/, '') ?? ''\n  const normalizedFromDir = normalizedRoutePrefix && fromDir.startsWith(`${normalizedRoutePrefix}/`)\n    ? fromDir.slice(normalizedRoutePrefix.length + 1)\n    : fromDir\n  return VIRTUAL_PREFIX + resolveRelativePath(normalizedFromDir, normalizedSpecPath)\n}\n\n/**\n * 为绝对 specPath 生成带 locale 前缀的候选模块 ID。\n *\n * 局部嵌入（OpenApiOperation / OpenApiDocument）通常使用 `/api` 这样的绝对路径。\n * 默认 locale 的 spec 注册在 `virtual:clarify-page/api`，而其他 locale 的 spec\n * 注册在 `virtual:clarify-page/<locale>/api`。相对路径会因为当前路由已含 locale 前缀\n * 而自动解析到正确的 spec，但绝对路径不会，因此这里显式注入 locale 前缀。\n */\nfunction localizeSpecModuleId(moduleId: string, specPath: string, locale: string | undefined, defaultLocale: string | undefined): string | undefined {\n  if (!locale || locale === defaultLocale) return undefined\n  // 仅处理绝对路径；相对路径已经基于含 locale 前缀的当前路由解析。\n  if (!specPath.startsWith('/') || specPath.startsWith(VIRTUAL_PREFIX)) return undefined\n  const rest = moduleId.slice(VIRTUAL_PREFIX.length)\n  if (rest.startsWith(`${locale}/`) || rest === locale) return undefined\n  return `${VIRTUAL_PREFIX}${locale}/${rest}`\n}\n\nexport function useOpenApiSpec(spec?: OpenAPISpec, specPath?: string): OpenAPISpec | null {\n  const specs = useOpenApis()\n  const location = useLocation()\n  const config = useConfig()\n  const locale = useLocale()\n\n  if (spec) return spec\n  if (!specPath) return null\n\n  const normalized = normalizeSpecPath(specPath, location.pathname, config.routePrefix)\n  const localized = localizeSpecModuleId(normalized, specPath, locale, config.i18n?.defaultLocale)\n\n  if (localized && specs[localized]) return specs[localized]\n  return specs[normalized] ?? null\n}\n","import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\n\nimport type { OpenApiRecord } from '../types'\n\nexport type OpenAPISpec = OpenAPIV3.Document | OpenAPIV3_1.Document\nexport type OpenAPIOperation = OpenAPIV3.OperationObject | OpenAPIV3_1.OperationObject\n\nexport const OPENAPI_HTTP_METHODS = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'] as const\n\nexport type OpenAPIHttpMethod = typeof OPENAPI_HTTP_METHODS[number]\n\nexport function isOpenAPIHttpMethod(method: string): method is OpenAPIHttpMethod {\n  return (OPENAPI_HTTP_METHODS as readonly string[]).includes(method.toLowerCase())\n}\n\nfunction isRecord(value: unknown): value is OpenApiRecord {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction resolveOpenApiRef(spec: OpenAPISpec, ref: string): unknown {\n  if (!ref.startsWith('#/')) return undefined\n\n  return ref\n    .slice(2)\n    .split('/')\n    .map((part) => part.replace(/~1/g, '/').replace(/~0/g, '~'))\n    .reduce<unknown>((current, part) => (isRecord(current) ? current[part] : undefined), spec)\n}\n\nfunction getPathItem(spec: OpenAPISpec, path: string): OpenApiRecord | undefined {\n  const pathItem = spec.paths?.[path]\n  const resolved = isRecord(pathItem) && typeof pathItem.$ref === 'string' ? resolveOpenApiRef(spec, pathItem.$ref) : pathItem\n  return isRecord(resolved) ? resolved : undefined\n}\n\nexport function getOpenApiOperation(spec: OpenAPISpec, path: string, method: string): OpenAPIOperation | undefined {\n  if (!isOpenAPIHttpMethod(method)) return undefined\n  return getPathItem(spec, path)?.[method.toLowerCase() as OpenAPIHttpMethod] as OpenAPIOperation | undefined\n}\n\nexport function listOpenApiOperations(spec: OpenAPISpec): Array<{ path: string; method: OpenAPIHttpMethod; operation: OpenAPIOperation }> {\n  const paths = spec.paths ?? {}\n  const operations: Array<{ path: string; method: OpenAPIHttpMethod; operation: OpenAPIOperation }> = []\n\n  for (const path of Object.keys(paths)) {\n    const pathItem = getPathItem(spec, path)\n    if (!pathItem) continue\n    for (const method of OPENAPI_HTTP_METHODS) {\n      const operation = pathItem[method]\n      if (operation) operations.push({ path, method, operation: operation as OpenAPIOperation })\n    }\n  }\n\n  return operations\n}\n","import type { ReactNode } from 'react'\n\nimport { PageTitleActions } from '../app/PageActions'\nimport { Prose } from '../components/Prose'\nimport { useBuiltInText } from '../core/i18n'\nimport { Markdown } from '../mdx/Markdown'\n\nimport { OpenApiOperation as OpenApiOperationComponent } from './components/OpenApiOperation'\nimport { useOpenApiSpec } from './lib/spec-path'\nimport { getOpenApiOperation, listOpenApiOperations } from './lib/utils'\nimport type { OpenAPISpec } from './lib/utils'\n\ntype OpenApiPathsProps = { spec: OpenAPISpec; tagFilter?: string[] }\n\ntype OpenApiHeaderProps = { spec: OpenAPISpec }\n\ntype WarningBoxProps = {\n  children: ReactNode\n  tone?: 'amber' | 'red'\n}\n\nexport type OpenApiDocumentProps = {\n  spec?: OpenAPISpec\n  specPath?: string\n  tagFilter?: string[]\n}\n\ntype OpenApiOperationWithSpecProps = {\n  spec: OpenAPISpec\n  path: string\n  method: string\n}\n\nexport type OpenApiOperationProps = {\n  specPath: string\n  path: string\n  method: string\n}\n\nfunction OpenApiHeader(arg0: OpenApiHeaderProps): ReactNode {\n  const { spec } = arg0\n\n  const t = useBuiltInText()\n  return (\n    <header className=\"clarify-openapi-header mb-16 border-b border-(--clarify-theme-tokens-colors-border) pb-8\">\n      <p className=\"mb-3 text-xs/6 font-medium tracking-widest text-(--clarify-ui-accent-text) uppercase\">\n        {t('openapi.openApiReference')}\n      </p>\n      <div className=\"clarify-page-title-row flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between\">\n        <h1 className=\"clarify-page-title min-w-0 flex-1\">{spec.info?.title ?? t('openapi.apiDocumentation')}</h1>\n        <PageTitleActions />\n      </div>\n      {spec.info?.description ? <Markdown className=\"lead mt-4 *:first:mt-0 *:last:mb-0\">{spec.info.description}</Markdown> : null}\n      {spec.info?.version ? <p className=\"mt-4 text-sm text-(--clarify-ui-text-faint)\">{t('openapi.version', { version: spec.info.version })}</p> : null}\n    </header>\n  )\n}\n\nfunction operationMatchesTags(operationTags: string[] | undefined, filterTags: string[] | undefined): boolean {\n  if (!filterTags?.length) return true\n  return operationTags?.some(tag => filterTags.includes(tag)) ?? false\n}\n\nfunction OpenApiPaths(arg0: OpenApiPathsProps): ReactNode {\n  const { spec, tagFilter } = arg0\n\n  const entries = listOpenApiOperations(spec)\n    .filter(({ operation }) => operationMatchesTags(operation.tags, tagFilter))\n    .map(({ path, method, operation }) => ({\n      path,\n      method: method.toUpperCase(),\n      operation,\n    }))\n\n  return (\n    <div className=\"clarify-api-endpoints divide-y divide-zinc-200/70 dark:divide-white/10\">\n      {entries.map(({ path, method, operation }) => (\n        <OpenApiOperationComponent key={`${method}-${path}`} spec={spec} path={path} method={method} operation={operation} />\n      ))}\n    </div>\n  )\n}\n\nfunction WarningBox(arg0: WarningBoxProps): ReactNode {\n  const { children, tone = 'amber' } = arg0\n\n  const classes = tone === 'red'\n    ? 'rounded-lg border border-red-200 bg-red-50 p-4 text-sm text-red-700 dark:border-red-500/30 dark:bg-red-500/10 dark:text-red-200'\n    : 'rounded-lg border border-amber-200 bg-amber-50 p-4 text-sm text-amber-700 dark:border-amber-500/30 dark:bg-amber-500/10 dark:text-amber-200'\n\n  return <div className={`clarify-warning ${classes}`}>{children}</div>\n}\n\nexport function OpenApiDocument(arg0: OpenApiDocumentProps): ReactNode {\n  const { spec, specPath, tagFilter } = arg0\n  const t = useBuiltInText()\n  const resolved = useOpenApiSpec(spec, specPath)\n\n  if (!resolved) {\n    return <WarningBox>{t('openapi.specNotFound', { specPath: specPath ?? t('openapi.specPathMissing') })}</WarningBox>\n  }\n\n  return (\n    <article className=\"clarify-openapi-page flex h-full flex-col pt-16 pb-10\">\n      <Prose className=\"flex-auto\">\n        <OpenApiHeader spec={resolved} />\n        <OpenApiPaths spec={resolved} tagFilter={tagFilter} />\n      </Prose>\n    </article>\n  )\n}\n\nfunction OpenApiOperationWithSpec(arg0: OpenApiOperationWithSpecProps): ReactNode {\n  const { spec, path, method } = arg0\n  const t = useBuiltInText()\n  const op = getOpenApiOperation(spec, path, method)\n\n  if (!op) {\n    return <WarningBox tone=\"red\">{t('openapi.endpointNotFound', { endpoint: `${method.toUpperCase()} ${path}` })}</WarningBox>\n  }\n\n  const normalizedMethod = method.toUpperCase()\n  return <OpenApiOperationComponent key={`${normalizedMethod}-${path}`} spec={spec} path={path} method={normalizedMethod} operation={op} />\n}\n\nexport function OpenApiOperation(arg0: OpenApiOperationProps): ReactNode {\n  const { specPath, path, method } = arg0\n  const t = useBuiltInText()\n  const spec = useOpenApiSpec(undefined, specPath)\n\n  if (!spec) {\n    return <WarningBox>{t('openapi.specNotFound', { specPath })}</WarningBox>\n  }\n\n  return <OpenApiOperationWithSpec spec={spec} path={path} method={method} />\n}\n","import { Collapse } from '../components/Collapse'\nimport { OpenApiDocument, OpenApiOperation } from '../openapi'\n\nimport { Markdown } from './Markdown'\nimport * as mdxPrimitives from './primitives'\n\nconst builtInMDXComponents = {\n  ...mdxPrimitives,\n  Markdown,\n  Collapse,\n}\n\nconst builtInOpenAPIComponents = {\n  OpenApiDocument,\n  OpenApiOperation,\n}\n\nexport function useMDXComponents(components: Record<string, unknown> = {}) {\n  return {\n    ...components,\n    ...builtInMDXComponents,\n    ...builtInOpenAPIComponents,\n  }\n}\n","import type { ReactNode } from 'react'\n\nimport { Prose } from '../components/Prose'\n\nexport type DocShellProps = {\n  title: string\n  subtitle?: string\n  children: ReactNode\n}\n\nexport function DocShell(arg0: DocShellProps) {\n  const { title, subtitle, children } = arg0\n\n  return (\n    <main className=\"clarify-doc-shell min-h-screen bg-(--clarify-theme-tokens-colors-background) px-6 py-10 text-(--clarify-theme-tokens-colors-foreground) md:px-10\">\n      <div className=\"mx-auto max-w-6xl\">\n        <header className=\"mb-10\">\n          <h1 className=\"text-3xl font-bold tracking-tight md:text-5xl\">{title}</h1>\n          {subtitle ? <p className=\"mt-3 max-w-2xl text-(--clarify-ui-text-soft)\">{subtitle}</p> : null}\n        </header>\n        <Prose>{children}</Prose>\n      </div>\n    </main>\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../source/openapi/lib/spec-path.ts","../source/openapi/lib/utils.ts","../source/openapi/entry.tsx","../source/mdx/components.ts","../source/mdx/DocShell.tsx"],"sourcesContent":["import { useLocation } from 'react-router-dom'\n\nimport { useConfig, useLocale, useOpenApis } from '../../core/context'\n\nimport type { OpenAPISpec } from './utils'\n\nconst VIRTUAL_PREFIX = 'virtual:clarify-page/'\n\nfunction resolveRelativePath(fromDir: string, to: string): string {\n  const parts = (fromDir + '/' + to).split('/').filter(Boolean)\n  const stack: string[] = []\n  for (const part of parts) {\n    if (part === '..') {\n      stack.pop()\n    } else if (part !== '.') {\n      stack.push(part)\n    }\n  }\n  return stack.join('/')\n}\n\nfunction normalizeSpecPath(specPath: string, currentRoutePath?: string, routePrefix = ''): string {\n  if (specPath.startsWith(VIRTUAL_PREFIX)) return specPath\n\n  const normalizedRoutePrefix = routePrefix.replace(/^\\/+|\\/+$/g, '')\n  const normalizedSpecPath = specPath.startsWith('/') && normalizedRoutePrefix && specPath.slice(1).startsWith(`${normalizedRoutePrefix}/`)\n    ? '/' + specPath.slice(normalizedRoutePrefix.length + 2)\n    : specPath\n\n  if (normalizedSpecPath.startsWith('/')) {\n    return VIRTUAL_PREFIX + normalizedSpecPath.replace(/^\\//, '')\n  }\n  const fromDir = currentRoutePath === '/' ? '' : currentRoutePath?.replace(/^\\//, '').replace(/\\/[^/]*$/, '') ?? ''\n  const normalizedFromDir = normalizedRoutePrefix && fromDir.startsWith(`${normalizedRoutePrefix}/`)\n    ? fromDir.slice(normalizedRoutePrefix.length + 1)\n    : fromDir\n  return VIRTUAL_PREFIX + resolveRelativePath(normalizedFromDir, normalizedSpecPath)\n}\n\n/**\n * 为绝对 specPath 生成带 locale 前缀的候选模块 ID。\n *\n * 所有 locale 的 spec 都注册在 `virtual:clarify-page/<locale>/...` 下，\n * 因此绝对路径（如 `/api`）需要显式注入 locale 前缀才能命中。\n * 相对路径会因为当前路由已含 locale 前缀而自动解析到正确的 spec。\n */\nfunction localizeSpecModuleId(moduleId: string, specPath: string, locale: string | undefined, _defaultLocale: string | undefined): string | undefined {\n  if (!locale) return undefined\n  // 仅处理绝对路径；相对路径已经基于含 locale 前缀的当前路由解析。\n  if (!specPath.startsWith('/') || specPath.startsWith(VIRTUAL_PREFIX)) return undefined\n  const rest = moduleId.slice(VIRTUAL_PREFIX.length)\n  if (rest.startsWith(`${locale}/`) || rest === locale) return undefined\n  return `${VIRTUAL_PREFIX}${locale}/${rest}`\n}\n\nexport function useOpenApiSpec(spec?: OpenAPISpec, specPath?: string): OpenAPISpec | null {\n  const config = useConfig()\n  const locale = useLocale()\n  const specs = useOpenApis()\n  const location = useLocation()\n\n  if (spec) return spec\n  if (!specPath) return null\n\n  const normalized = normalizeSpecPath(specPath, location.pathname, config.routePrefix)\n  const localized = localizeSpecModuleId(normalized, specPath, locale, config.i18n?.defaultLocale)\n\n  if (localized && specs[localized]) return specs[localized]\n  return specs[normalized] ?? null\n}\n","import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\n\nimport type { OpenApiRecord } from '../types'\n\nexport type OpenAPISpec = OpenAPIV3.Document | OpenAPIV3_1.Document\nexport type OpenAPIOperation = OpenAPIV3.OperationObject | OpenAPIV3_1.OperationObject\n\nexport const OPENAPI_HTTP_METHODS = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'] as const\n\nexport type OpenAPIHttpMethod = typeof OPENAPI_HTTP_METHODS[number]\n\nexport function isOpenAPIHttpMethod(method: string): method is OpenAPIHttpMethod {\n  return (OPENAPI_HTTP_METHODS as readonly string[]).includes(method.toLowerCase())\n}\n\nfunction isRecord(value: unknown): value is OpenApiRecord {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction resolveOpenApiRef(spec: OpenAPISpec, ref: string): unknown {\n  if (!ref.startsWith('#/')) return undefined\n\n  return ref\n    .slice(2)\n    .split('/')\n    .map((part) => part.replace(/~1/g, '/').replace(/~0/g, '~'))\n    .reduce<unknown>((current, part) => (isRecord(current) ? current[part] : undefined), spec)\n}\n\nfunction getPathItem(spec: OpenAPISpec, path: string): OpenApiRecord | undefined {\n  const pathItem = spec.paths?.[path]\n  const resolved = isRecord(pathItem) && typeof pathItem.$ref === 'string' ? resolveOpenApiRef(spec, pathItem.$ref) : pathItem\n  return isRecord(resolved) ? resolved : undefined\n}\n\nexport function getOpenApiOperation(spec: OpenAPISpec, path: string, method: string): OpenAPIOperation | undefined {\n  if (!isOpenAPIHttpMethod(method)) return undefined\n  return getPathItem(spec, path)?.[method.toLowerCase() as OpenAPIHttpMethod] as OpenAPIOperation | undefined\n}\n\nexport function listOpenApiOperations(spec: OpenAPISpec): Array<{ path: string; method: OpenAPIHttpMethod; operation: OpenAPIOperation }> {\n  const paths = spec.paths ?? {}\n  const operations: Array<{ path: string; method: OpenAPIHttpMethod; operation: OpenAPIOperation }> = []\n\n  for (const path of Object.keys(paths)) {\n    const pathItem = getPathItem(spec, path)\n    if (!pathItem) continue\n    for (const method of OPENAPI_HTTP_METHODS) {\n      const operation = pathItem[method]\n      if (operation) operations.push({ path, method, operation: operation as OpenAPIOperation })\n    }\n  }\n\n  return operations\n}\n","import type { ReactNode } from 'react'\n\nimport { PageTitleActions } from '../app/PageActions'\nimport { Prose } from '../components/Prose'\nimport { useBuiltInText } from '../core/i18n'\nimport { Markdown } from '../mdx/Markdown'\n\nimport { OpenApiOperation as OpenApiOperationComponent } from './components/OpenApiOperation'\nimport { useOpenApiSpec } from './lib/spec-path'\nimport { getOpenApiOperation, listOpenApiOperations } from './lib/utils'\nimport type { OpenAPISpec } from './lib/utils'\n\ntype OpenApiPathsProps = { spec: OpenAPISpec; tagFilter?: string[] }\n\ntype OpenApiHeaderProps = { spec: OpenAPISpec }\n\ntype WarningBoxProps = {\n  children: ReactNode\n  tone?: 'amber' | 'red'\n}\n\nexport type OpenApiDocumentProps = {\n  spec?: OpenAPISpec\n  specPath?: string\n  tagFilter?: string[]\n}\n\ntype OpenApiOperationWithSpecProps = {\n  spec: OpenAPISpec\n  path: string\n  method: string\n}\n\nexport type OpenApiOperationProps = {\n  specPath: string\n  path: string\n  method: string\n}\n\nfunction OpenApiHeader(arg0: OpenApiHeaderProps): ReactNode {\n  const { spec } = arg0\n\n  const t = useBuiltInText()\n  return (\n    <header className=\"clarify-openapi-header mb-16 border-b border-(--clarify-theme-tokens-colors-border) pb-8\">\n      <p className=\"mb-3 text-xs/6 font-medium tracking-widest text-(--clarify-ui-accent-text) uppercase\">\n        {t('openapi.openApiReference')}\n      </p>\n      <div className=\"clarify-page-title-row flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between\">\n        <h1 className=\"clarify-page-title min-w-0 flex-1\">{spec.info?.title ?? t('openapi.apiDocumentation')}</h1>\n        <PageTitleActions />\n      </div>\n      {spec.info?.description ? <Markdown className=\"lead mt-4 *:first:mt-0 *:last:mb-0\">{spec.info.description}</Markdown> : null}\n      {spec.info?.version ? <p className=\"mt-4 text-sm text-(--clarify-ui-text-faint)\">{t('openapi.version', { version: spec.info.version })}</p> : null}\n    </header>\n  )\n}\n\nfunction operationMatchesTags(operationTags: string[] | undefined, filterTags: string[] | undefined): boolean {\n  if (!filterTags?.length) return true\n  return operationTags?.some(tag => filterTags.includes(tag)) ?? false\n}\n\nfunction OpenApiPaths(arg0: OpenApiPathsProps): ReactNode {\n  const { spec, tagFilter } = arg0\n\n  const entries = listOpenApiOperations(spec)\n    .filter(({ operation }) => operationMatchesTags(operation.tags, tagFilter))\n    .map(({ path, method, operation }) => ({\n      path,\n      method: method.toUpperCase(),\n      operation,\n    }))\n\n  return (\n    <div className=\"clarify-api-endpoints divide-y divide-zinc-200/70 dark:divide-white/10\">\n      {entries.map(({ path, method, operation }) => (\n        <OpenApiOperationComponent key={`${method}-${path}`} spec={spec} path={path} method={method} operation={operation} />\n      ))}\n    </div>\n  )\n}\n\nfunction WarningBox(arg0: WarningBoxProps): ReactNode {\n  const { children, tone = 'amber' } = arg0\n\n  const classes = tone === 'red'\n    ? 'rounded-lg border border-red-200 bg-red-50 p-4 text-sm text-red-700 dark:border-red-500/30 dark:bg-red-500/10 dark:text-red-200'\n    : 'rounded-lg border border-amber-200 bg-amber-50 p-4 text-sm text-amber-700 dark:border-amber-500/30 dark:bg-amber-500/10 dark:text-amber-200'\n\n  return <div className={`clarify-warning ${classes}`}>{children}</div>\n}\n\nexport function OpenApiDocument(arg0: OpenApiDocumentProps): ReactNode {\n  const { spec, specPath, tagFilter } = arg0\n  const t = useBuiltInText()\n  const resolved = useOpenApiSpec(spec, specPath)\n\n  if (!resolved) {\n    return <WarningBox>{t('openapi.specNotFound', { specPath: specPath ?? t('openapi.specPathMissing') })}</WarningBox>\n  }\n\n  return (\n    <article className=\"clarify-openapi-page flex h-full flex-col pt-16 pb-10\">\n      <Prose className=\"flex-auto\">\n        <OpenApiHeader spec={resolved} />\n        <OpenApiPaths spec={resolved} tagFilter={tagFilter} />\n      </Prose>\n    </article>\n  )\n}\n\nfunction OpenApiOperationWithSpec(arg0: OpenApiOperationWithSpecProps): ReactNode {\n  const { spec, path, method } = arg0\n  const t = useBuiltInText()\n  const op = getOpenApiOperation(spec, path, method)\n\n  if (!op) {\n    return <WarningBox tone=\"red\">{t('openapi.endpointNotFound', { endpoint: `${method.toUpperCase()} ${path}` })}</WarningBox>\n  }\n\n  const normalizedMethod = method.toUpperCase()\n  return <OpenApiOperationComponent key={`${normalizedMethod}-${path}`} spec={spec} path={path} method={normalizedMethod} operation={op} />\n}\n\nexport function OpenApiOperation(arg0: OpenApiOperationProps): ReactNode {\n  const { specPath, path, method } = arg0\n  const t = useBuiltInText()\n  const spec = useOpenApiSpec(undefined, specPath)\n\n  if (!spec) {\n    return <WarningBox>{t('openapi.specNotFound', { specPath })}</WarningBox>\n  }\n\n  return <OpenApiOperationWithSpec spec={spec} path={path} method={method} />\n}\n","import { Collapse } from '../components/Collapse'\nimport { Mermaid } from '../components/Mermaid'\nimport { OpenApiDocument, OpenApiOperation } from '../openapi'\n\nimport { Markdown } from './Markdown'\nimport * as mdxPrimitives from './primitives'\n\nconst builtInMDXComponents = {\n  ...mdxPrimitives,\n  Markdown,\n  Collapse,\n  Mermaid,\n}\n\nconst builtInOpenAPIComponents = {\n  OpenApiDocument,\n  OpenApiOperation,\n}\n\nexport function useMDXComponents(components: Record<string, unknown> = {}) {\n  return {\n    ...components,\n    ...builtInMDXComponents,\n    ...builtInOpenAPIComponents,\n  }\n}\n","import type { ReactNode } from 'react'\n\nimport { Prose } from '../components/Prose'\n\nexport type DocShellProps = {\n  title: string\n  subtitle?: string\n  children: ReactNode\n}\n\nexport function DocShell(arg0: DocShellProps) {\n  const { title, subtitle, children } = arg0\n\n  return (\n    <main className=\"clarify-doc-shell min-h-screen bg-(--clarify-theme-tokens-colors-background) px-6 py-10 text-(--clarify-theme-tokens-colors-foreground) md:px-10\">\n      <div className=\"mx-auto max-w-6xl\">\n        <header className=\"mb-10\">\n          <h1 className=\"text-3xl font-bold tracking-tight md:text-5xl\">{title}</h1>\n          {subtitle ? <p className=\"mt-3 max-w-2xl text-(--clarify-ui-text-soft)\">{subtitle}</p> : null}\n        </header>\n        <Prose>{children}</Prose>\n      </div>\n    </main>\n  )\n}\n"],"mappings":"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"}

package/output/mdx/components.d.ts

@@ -1,4 +1,5 @@
 import { Collapse } from '../components/Collapse';
+import { Mermaid } from '../components/Mermaid';
 import { OpenApiDocument, OpenApiOperation } from '../openapi';
 import { Markdown } from './Markdown';
 import * as mdxPrimitives from './primitives';
@@ -7,9 +8,11 @@ export declare function useMDXComponents(components?: Record<string, unknown>):
     OpenApiOperation: typeof OpenApiOperation;
     Markdown: typeof Markdown;
     Collapse: typeof Collapse;
+    Mermaid: typeof Mermaid;
     wrapper(arg0: {
         children: import('react').ReactNode;
     }): import("react").JSX.Element;
+    table(arg0: import('react').ComponentPropsWithoutRef<"table">): import("react").JSX.Element;
     a(arg0: import('react').ComponentPropsWithoutRef<"a">): import("react").JSX.Element;
     h1(arg0: import('react').ComponentPropsWithoutRef<"h1">): import("react").JSX.Element;
     h2(props: Omit<import('react').ComponentPropsWithoutRef<typeof import('..').Heading>, "level">): import('react').FunctionComponentElement<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>, "ref"> & {
@@ -31,6 +34,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

@@ -5,6 +5,7 @@ type WrapperProps = {
     children: ReactNode;
 };
 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;
 export declare function h1(arg0: ComponentPropsWithoutRef<'h1'>): import("react").JSX.Element;
 export declare const code: typeof Code;
@@ -30,6 +31,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_PageActions = require("./PageActions-yycPlNyL.cjs");
+const require_OpenApiOperation = require("./OpenApiOperation-9SvCA_B4.cjs");
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let lucide_react = require("lucide-react");