@clarify-labs/renderer 0.6.7 → 0.7.1

package/output/core/types.d.ts

@@ -1,11 +1,13 @@
 import { ComponentType } from 'react';
 import { OpenAPISpec } from '../openapi/lib/utils';
+export type FooterComponentPath = string;
 export type RouteComponent = ComponentType | (() => Promise<{
     default: ComponentType;
 }>);
 export type RouteSection = {
     id: string;
     title: string;
+    level?: number;
     badge?: string;
     tags?: string[];
 };
@@ -32,122 +34,127 @@ export type RouteItem = {
     contentArtifactUrl?: string;
     sourceUrl?: string;
 };
-export type ClarifyLogoConfig = string | {
+export type LogoConfig = string | {
     light?: string;
     dark?: string;
 };
-export type ClarifyFaviconConfig = string | {
+export type FaviconConfig = string | {
     light?: string;
     dark?: string;
 };
-export type ClarifyLocalizedText = string | Record<string, string>;
-export type ClarifyLocaleConfig = {
+export type LocalizedText = string | Record<string, string>;
+export type LocaleConfig = {
     code: string;
     label: string;
     dir?: 'ltr' | 'rtl';
 };
-export type ClarifyI18nConfig = {
+export type I18nConfig = {
     defaultLocale: string;
     missing: 'fallback' | '404' | 'hide';
-    locales: ClarifyLocaleConfig[];
+    locales: LocaleConfig[];
 };
-export type ClarifyNavbarLink = {
-    label: ClarifyLocalizedText;
+export type NavbarLink = {
+    label: LocalizedText;
     href: string;
     external?: boolean;
 };
-export type ClarifyBannerConfig = {
-    content: ClarifyLocalizedText;
+export type BannerComponentPath = string;
+export type BannerConfigOptions = {
+    content: LocalizedText;
     dismissible?: boolean;
+    link?: NavbarLink;
 };
-export type ClarifyFooterConfig = {
-    links?: ClarifyNavbarLink[];
+export type BannerConfig = BannerConfigOptions | BannerComponentPath;
+export type FooterLinksConfig = {
+    links?: NavbarLink[];
     socials?: Record<string, string>;
-    copyright?: ClarifyLocalizedText;
+    copyright?: LocalizedText;
 };
-export type ClarifySourceConfig = {
+export type FooterConfig = FooterLinksConfig | FooterComponentPath;
+export type SourceConfig = {
     repository: string;
     branch?: string;
     directory?: string;
 };
-export type ClarifyThemePreset = 'default' | 'base';
-export type ClarifyThemeModeColorValue = {
+export type ThemePreset = 'default' | 'base';
+export type ThemeModeColorValue = {
     light?: string;
     dark?: string;
 };
-export type ClarifyThemeColorValue = string | ClarifyThemeModeColorValue;
-export type ClarifyThemeColorTokensConfig = {
-    primary: ClarifyThemeColorValue;
-    accent: ClarifyThemeColorValue;
-    background: ClarifyThemeColorValue;
-    foreground: ClarifyThemeColorValue;
-    surface: ClarifyThemeColorValue;
-    muted: ClarifyThemeColorValue;
-    border: ClarifyThemeColorValue;
-    codeBackground: ClarifyThemeColorValue;
-};
-export type ClarifyThemeRadiusTokensConfig = {
+export type ThemeColorValue = string | ThemeModeColorValue;
+export type ThemeColorTokensConfig = {
+    primary: ThemeColorValue;
+    accent: ThemeColorValue;
+    background: ThemeColorValue;
+    foreground: ThemeColorValue;
+    surface: ThemeColorValue;
+    muted: ThemeColorValue;
+    border: ThemeColorValue;
+    codeBackground: ThemeColorValue;
+};
+export type ThemeRadiusTokensConfig = {
     sm: string;
     md: string;
     lg: string;
     xl: string;
 };
-export type ClarifyThemeTokensConfig = {
-    colors: ClarifyThemeColorTokensConfig;
-    radius: ClarifyThemeRadiusTokensConfig;
+export type ThemeTokensConfig = {
+    colors: ThemeColorTokensConfig;
+    radius: ThemeRadiusTokensConfig;
 };
-export type ClarifyThemeLayoutConfig = {
+export type ThemeLayoutConfig = {
     maxWidth: string;
 };
-export type ClarifyThemeConfig = {
-    preset: ClarifyThemePreset;
-    tokens: ClarifyThemeTokensConfig;
-    layout: ClarifyThemeLayoutConfig;
+export type ThemeConfig = {
+    preset: ThemePreset;
+    tokens: ThemeTokensConfig;
+    layout: ThemeLayoutConfig;
     editor: boolean;
 };
-export type ClarifyPagesItem = string | {
+export type PagesItem = string | {
     page: string;
-    title?: ClarifyLocalizedText;
+    title?: LocalizedText;
     icon?: string;
     redirect?: string;
 } | {
     openapi: string;
     icon?: string;
-    title?: ClarifyLocalizedText;
+    title?: LocalizedText;
     filter?: {
         tags?: string[];
     };
 };
-export type ClarifyPagesGroup = {
-    group: ClarifyLocalizedText;
+export type PagesGroup = {
+    group: LocalizedText;
     icon?: string;
-    pages: ClarifyPagesItem[];
+    pages: PagesItem[];
 };
-export type ClarifyPagesConfig = ClarifyPagesGroup[] | 'FileTree';
-export type ClarifyTabItem = {
-    tab: ClarifyLocalizedText;
+export type PagesConfig = PagesGroup[] | 'FileTree';
+export type TabItem = {
+    tab: LocalizedText;
     icon?: string;
-    pages?: ClarifyPagesConfig;
+    pages?: PagesConfig;
 };
-export type ClarifyTabsConfig = ClarifyTabItem[];
-export type ClarifyConfig = {
+export type TabsConfig = TabItem[];
+export type Config = {
     title: string;
-    logo?: ClarifyLogoConfig;
-    favicon?: ClarifyFaviconConfig;
-    theme: ClarifyThemeConfig;
+    logo?: LogoConfig;
+    homeUrl?: string;
+    favicon?: FaviconConfig;
+    theme: ThemeConfig;
     description: string;
     siteUrl?: string;
-    source?: ClarifySourceConfig;
+    source?: SourceConfig;
     rootDirectory: string;
     routePrefix: string;
     outputDirectory: string;
     navbar?: {
-        links?: ClarifyNavbarLink[];
+        links?: NavbarLink[];
     };
-    banner?: ClarifyBannerConfig;
-    footer?: ClarifyFooterConfig;
-    i18n?: ClarifyI18nConfig;
-    tabs?: ClarifyTabsConfig;
+    banner?: BannerConfig;
+    footer?: FooterConfig;
+    i18n?: I18nConfig;
+    tabs?: TabsConfig;
 };
 export type NavigationTab = {
     type: 'tab';
@@ -164,13 +171,17 @@ export type LocalizedTabbedNavigation = Record<string, TabbedNavigation>;
 export type NavigationTree = NavigationNode[] | LocalizedNavigation | TabbedNavigation | LocalizedTabbedNavigation;
 export type RenderOptions = {
     /** 从 virtual:clarify-config 导入的 config */
-    config: ClarifyConfig;
+    config: Config;
     /** 从 virtual:clarify-routes 导入的路由数组 */
     routes: RouteItem[];
     /** 从 virtual:clarify-routes 导入的导航树；启用 i18n 时为按 locale 分组的导航树 */
     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;
     /** Whether to render the live theme editor inside the app tree. */
     themeEditor?: boolean;
     /** 挂载节点，默认 document.getElementById('root') */
@@ -181,13 +192,17 @@ export type ServerRouteItem = Omit<RouteItem, 'component'> & {
 };
 export type ServerRenderOptions = {
     /** 从 virtual:clarify-config 导入的 config */
-    config: ClarifyConfig;
+    config: Config;
     /** 从 virtual:clarify-routes 导入的服务端路由数组 */
     routes: ServerRouteItem[];
     /** 从 virtual:clarify-routes 导入的导航树；启用 i18n 时为按 locale 分组的导航树 */
     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;
     /** 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_shell = require("./shell-D4tS8Jts.cjs");
-const require_ThemeRoot = require("./ThemeRoot-BhP5M3Hd.cjs");
-const require_OpenApiOperation = require("./OpenApiOperation-CxQQyEHK.cjs");
+const require_PageActions = require("./PageActions-1RDCHcUY.cjs");
+const require_ThemeRoot = require("./ThemeRoot-DYS-lcK-.cjs");
+const require_OpenApiOperation = require("./OpenApiOperation-C4xZu4i0.cjs");
 const require_remark = require("./remark-Dv3owbSH.cjs");
-const require_render = require("./render-C_NHO3rz.cjs");
+const require_render = require("./render-CRTqZzyY.cjs");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region source/openapi/lib/spec-path.ts
@@ -23,13 +23,32 @@ function normalizeSpecPath(specPath, currentRoutePath, routePrefix = "") {
 	const fromDir = currentRoutePath === "/" ? "" : currentRoutePath?.replace(/^\//, "").replace(/\/[^/]*$/, "") ?? "";
 	return VIRTUAL_PREFIX + resolveRelativePath(normalizedRoutePrefix && fromDir.startsWith(`${normalizedRoutePrefix}/`) ? fromDir.slice(normalizedRoutePrefix.length + 1) : fromDir, normalizedSpecPath);
 }
+/**
+* 为绝对 specPath 生成带 locale 前缀的候选模块 ID。
+*
+* 局部嵌入（OpenApiOperation / OpenApiDocument）通常使用 `/api` 这样的绝对路径。
+* 默认 locale 的 spec 注册在 `virtual:clarify-page/api`，而其他 locale 的 spec
+* 注册在 `virtual:clarify-page/<locale>/api`。相对路径会因为当前路由已含 locale 前缀
+* 而自动解析到正确的 spec，但绝对路径不会，因此这里显式注入 locale 前缀。
+*/
+function localizeSpecModuleId(moduleId, specPath, locale, defaultLocale) {
+	if (!locale || locale === defaultLocale) 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_shell.useOpenApis();
+	const specs = require_PageActions.useOpenApis();
 	const location = (0, react_router_dom.useLocation)();
-	const config = require_shell.useClarifyConfig();
+	const config = require_PageActions.useConfig();
+	const locale = require_PageActions.useLocale();
 	if (spec) return spec;
 	if (!specPath) return null;
-	return specs[normalizeSpecPath(specPath, location.pathname, config.routePrefix)] ?? null;
+	const normalized = normalizeSpecPath(specPath, location.pathname, config.routePrefix);
+	const localized = localizeSpecModuleId(normalized, specPath, locale, config.i18n?.defaultLocale);
+	if (localized && specs[localized]) return specs[localized];
+	return specs[normalized] ?? null;
 }
 //#endregion
 //#region source/openapi/lib/utils.ts
@@ -83,21 +102,27 @@ function listOpenApiOperations(spec) {
 //#region source/openapi/entry.tsx
 function OpenApiHeader(arg0) {
 	const { spec } = arg0;
-	const t = require_shell.useBuiltInText();
+	const t = require_PageActions.useBuiltInText();
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
-		className: "mb-16",
+		className: "clarify-openapi-header mb-16 border-b border-(--clarify-theme-tokens-colors-border) pb-8",
 		children: [
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-				className: "mb-3 text-xs/6 font-medium tracking-widest text-emerald-500 uppercase dark:text-emerald-400",
+				className: "mb-3 text-xs/6 font-medium tracking-widest text-(--clarify-ui-accent-text) uppercase",
 				children: t("openapi.openApiReference")
 			}),
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", { children: spec.info?.title ?? t("openapi.apiDocumentation") }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "clarify-page-title-row flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
+					className: "clarify-page-title min-w-0 flex-1",
+					children: spec.info?.title ?? t("openapi.apiDocumentation")
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_PageActions.PageTitleActions, {})]
+			}),
 			spec.info?.description ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_OpenApiOperation.Markdown, {
-				className: "lead *:first:mt-0 *:last:mb-0",
+				className: "lead mt-4 *:first:mt-0 *:last:mb-0",
 				children: spec.info.description
 			}) : null,
 			spec.info?.version ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-				className: "text-sm text-zinc-500 dark:text-zinc-400",
+				className: "mt-4 text-sm text-(--clarify-ui-text-faint)",
 				children: t("openapi.version", { version: spec.info.version })
 			}) : null
 		]
@@ -132,7 +157,7 @@ function WarningBox(arg0) {
 }
 function OpenApiDocument(arg0) {
 	const { spec, specPath, tagFilter } = arg0;
-	const t = require_shell.useBuiltInText();
+	const t = require_PageActions.useBuiltInText();
 	const resolved = useOpenApiSpec(spec, specPath);
 	if (!resolved) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(WarningBox, { children: t("openapi.specNotFound", { specPath: specPath ?? t("openapi.specPathMissing") }) });
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("article", {
@@ -148,7 +173,7 @@ function OpenApiDocument(arg0) {
 }
 function OpenApiOperationWithSpec(arg0) {
 	const { spec, path, method } = arg0;
-	const t = require_shell.useBuiltInText();
+	const t = require_PageActions.useBuiltInText();
 	const op = getOpenApiOperation(spec, path, method);
 	if (!op) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(WarningBox, {
 		tone: "red",
@@ -164,7 +189,7 @@ function OpenApiOperationWithSpec(arg0) {
 }
 function OpenApiOperation(arg0) {
 	const { specPath, path, method } = arg0;
-	const t = require_shell.useBuiltInText();
+	const t = require_PageActions.useBuiltInText();
 	const spec = useOpenApiSpec(void 0, specPath);
 	if (!spec) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(WarningBox, { children: t("openapi.specNotFound", { specPath }) });
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OpenApiOperationWithSpec, {
@@ -219,10 +244,10 @@ exports.Button = require_OpenApiOperation.Button;
 exports.Callout = require_OpenApiOperation.Callout;
 exports.Card = require_OpenApiOperation.Card;
 exports.CardGroup = require_OpenApiOperation.CardGroup;
-exports.ClarifyConfigContext = require_shell.ClarifyConfigContext;
 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;
@@ -232,24 +257,28 @@ exports.Logo = require_OpenApiOperation.Logo;
 exports.Markdown = require_OpenApiOperation.Markdown;
 exports.OpenApiDocument = OpenApiDocument;
 exports.OpenApiOperation = OpenApiOperation;
-exports.OpenApisContext = require_shell.OpenApisContext;
+exports.OpenApisContext = require_PageActions.OpenApisContext;
+exports.PageBanner = require_ThemeRoot.PageBanner;
 exports.PageFooter = require_ThemeRoot.PageFooter;
 exports.Pre = require_OpenApiOperation.Pre;
 exports.Prose = require_OpenApiOperation.Prose;
-exports.SectionProvider = require_shell.SectionProvider;
+exports.SectionProvider = require_PageActions.SectionProvider;
 exports.Tag = require_OpenApiOperation.Tag;
 exports.ThemeEditor = require_ThemeRoot.ThemeEditor;
-exports.ThemeProvider = require_shell.ThemeProvider;
-exports.ThemeToggle = require_shell.ThemeToggle;
-exports.applyClarifyThemeVariables = require_ThemeRoot.applyClarifyThemeVariables;
-exports.clarifyThemeEditorPresets = require_ThemeRoot.clarifyThemeEditorPresets;
+exports.ThemeProvider = require_PageActions.ThemeProvider;
+exports.ThemeToggle = require_PageActions.ThemeToggle;
+exports.WebFrame = require_OpenApiOperation.WebFrame;
+exports.applyThemeVariables = require_ThemeRoot.applyThemeVariables;
 exports.markdownRemarkPlugins = require_remark.markdownRemarkPlugins;
-exports.remToPx = require_shell.remToPx;
+exports.remToPx = require_PageActions.remToPx;
 exports.render = require_render.render;
-exports.useClarifyConfig = require_shell.useClarifyConfig;
+exports.themeBootstrapScript = require_ThemeRoot.themeBootstrapScript;
+exports.themeEditorPresets = require_ThemeRoot.themeEditorPresets;
+exports.themePresets = require_ThemeRoot.themePresets;
+exports.useConfig = require_PageActions.useConfig;
 exports.useMDXComponents = useMDXComponents;
-exports.useOpenApis = require_shell.useOpenApis;
-exports.useSectionStore = require_shell.useSectionStore;
-exports.useTheme = require_shell.useTheme;
+exports.useOpenApis = require_PageActions.useOpenApis;
+exports.useSectionStore = require_PageActions.useSectionStore;
+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 { useClarifyConfig, 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\nexport function useOpenApiSpec(spec?: OpenAPISpec, specPath?: string): OpenAPISpec | null {\n  const specs = useOpenApis()\n  const location = useLocation()\n  const config = useClarifyConfig()\n\n  if (spec) return spec\n  if (!specPath) return null\n\n  const normalized = normalizeSpecPath(specPath, location.pathname, config.routePrefix)\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 { 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=\"mb-16\">\n      <p className=\"mb-3 text-xs/6 font-medium tracking-widest text-emerald-500 uppercase dark:text-emerald-400\">\n        {t('openapi.openApiReference')}\n      </p>\n      <h1>{spec.info?.title ?? t('openapi.apiDocumentation')}</h1>\n      {spec.info?.description ? <Markdown className=\"lead *:first:mt-0 *:last:mb-0\">{spec.info.description}</Markdown> : null}\n      {spec.info?.version ? <p className=\"text-sm text-zinc-500 dark:text-zinc-400\">{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 * 局部嵌入（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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"}

package/output/index.d.ts

@@ -1,24 +1,26 @@
 import { AppShell } from './app/AppShell';
 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 } from './components';
-import { ClarifyConfigContext, OpenApisContext, useClarifyConfig, useOpenApis } from './context';
+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 { 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 { applyClarifyThemeVariables, clarifyThemeEditorPresets, ThemeEditor } from './theme/ThemeEditor';
+import { applyThemeVariables, themeEditorPresets, ThemeEditor } from './theme/ThemeEditor';
 import { ThemeProvider, useTheme } from './theme/ThemeProvider';
 import { ThemeToggle } from './theme/ThemeToggle';
-import { ClarifyConfig, RouteItem, RenderOptions, ServerRenderOptions } from './types';
+import { themePresets, themeBootstrapScript } from './theme/variables';
+import { Config, RouteItem, RenderOptions, ServerRenderOptions } from './types';
 import { remToPx } from './utils/remToPx';
 export type { OpenApiOperationProps, OpenApiDocumentProps, OpenAPIOperation, OpenAPISpec } from './openapi';
 export type { ThemeEditorProps } from './theme/ThemeEditor';
-export type { ClarifyConfig, RouteItem, RenderOptions, ServerRenderOptions, Section };
-export { AppShell, render, ClarifyConfigContext, OpenApisContext, useClarifyConfig, useOpenApis, BuiltWithClarify, PageFooter, ThemeProvider, ThemeToggle, ThemeEditor, useTheme, SectionProvider, useSectionStore, remToPx, applyClarifyThemeVariables, clarifyThemeEditorPresets };
-export { Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, Pre, Prose, Heading, Logo, GridPattern, HeroPattern, Feedback, Tag };
+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 { DocShell, Markdown, useMDXComponents, markdownRemarkPlugins };
 export { OpenApiDocument, OpenApiOperation };

package/output/index.js

@@ -1,8 +1,8 @@
-import { C as CodeGroup, D as Callout, E as CardGroup, O as Button, S as Code, T as Card, _ as Logo, b as Feedback, f as Markdown, g as HeroPattern, h as GridPattern, m as Prose, n as OpenApiOperation$1, p as primitives_exports, v as Heading, w as Pre, x as Collapse, y as Tag } from "./OpenApiOperation-CI_PeMSy.js";
-import { C as useClarifyConfig, S as OpenApisContext, a as useSectionStore, b as ClarifyConfigContext, d as ThemeToggle, f as ThemeProvider, i as SectionProvider, o as remToPx, p as useTheme, w as useOpenApis, y as useBuiltInText } from "./shell-DvTfFx6M.js";
-import { a as AppShell, i as clarifyThemeEditorPresets, n as ThemeEditor, o as PageFooter, r as applyClarifyThemeVariables, s as BuiltWithClarify } from "./ThemeRoot-DErmHskn.js";
+import { C as Code, D as CardGroup, E as Card, O as Callout, S as Collapse, T as Pre, _ as HeroPattern, b as Tag, f as Markdown, g as GridPattern, h as Prose, k as Button, m as WebFrame, n as OpenApiOperation$1, p as primitives_exports, v as Logo, w as CodeGroup, x as Feedback, y as Heading } from "./OpenApiOperation-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 { t as markdownRemarkPlugins } from "./remark-Dd2WU50s.js";
-import { t as render } from "./render-HeCAMIGm.js";
+import { t as render } from "./render-D0ls3d2j.js";
 import { useLocation } from "react-router-dom";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region source/openapi/lib/spec-path.ts
@@ -22,13 +22,32 @@ function normalizeSpecPath(specPath, currentRoutePath, routePrefix = "") {
 	const fromDir = currentRoutePath === "/" ? "" : currentRoutePath?.replace(/^\//, "").replace(/\/[^/]*$/, "") ?? "";
 	return VIRTUAL_PREFIX + resolveRelativePath(normalizedRoutePrefix && fromDir.startsWith(`${normalizedRoutePrefix}/`) ? fromDir.slice(normalizedRoutePrefix.length + 1) : fromDir, normalizedSpecPath);
 }
+/**
+* 为绝对 specPath 生成带 locale 前缀的候选模块 ID。
+*
+* 局部嵌入（OpenApiOperation / OpenApiDocument）通常使用 `/api` 这样的绝对路径。
+* 默认 locale 的 spec 注册在 `virtual:clarify-page/api`，而其他 locale 的 spec
+* 注册在 `virtual:clarify-page/<locale>/api`。相对路径会因为当前路由已含 locale 前缀
+* 而自动解析到正确的 spec，但绝对路径不会，因此这里显式注入 locale 前缀。
+*/
+function localizeSpecModuleId(moduleId, specPath, locale, defaultLocale) {
+	if (!locale || locale === defaultLocale) 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 = useClarifyConfig();
+	const config = useConfig();
+	const locale = useLocale();
 	if (spec) return spec;
 	if (!specPath) return null;
-	return specs[normalizeSpecPath(specPath, location.pathname, config.routePrefix)] ?? null;
+	const normalized = normalizeSpecPath(specPath, location.pathname, config.routePrefix);
+	const localized = localizeSpecModuleId(normalized, specPath, locale, config.i18n?.defaultLocale);
+	if (localized && specs[localized]) return specs[localized];
+	return specs[normalized] ?? null;
 }
 //#endregion
 //#region source/openapi/lib/utils.ts
@@ -84,19 +103,25 @@ function OpenApiHeader(arg0) {
 	const { spec } = arg0;
 	const t = useBuiltInText();
 	return /* @__PURE__ */ jsxs("header", {
-		className: "mb-16",
+		className: "clarify-openapi-header mb-16 border-b border-(--clarify-theme-tokens-colors-border) pb-8",
 		children: [
 			/* @__PURE__ */ jsx("p", {
-				className: "mb-3 text-xs/6 font-medium tracking-widest text-emerald-500 uppercase dark:text-emerald-400",
+				className: "mb-3 text-xs/6 font-medium tracking-widest text-(--clarify-ui-accent-text) uppercase",
 				children: t("openapi.openApiReference")
 			}),
-			/* @__PURE__ */ jsx("h1", { children: spec.info?.title ?? t("openapi.apiDocumentation") }),
+			/* @__PURE__ */ jsxs("div", {
+				className: "clarify-page-title-row flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between",
+				children: [/* @__PURE__ */ jsx("h1", {
+					className: "clarify-page-title min-w-0 flex-1",
+					children: spec.info?.title ?? t("openapi.apiDocumentation")
+				}), /* @__PURE__ */ jsx(PageTitleActions, {})]
+			}),
 			spec.info?.description ? /* @__PURE__ */ jsx(Markdown, {
-				className: "lead *:first:mt-0 *:last:mb-0",
+				className: "lead mt-4 *:first:mt-0 *:last:mb-0",
 				children: spec.info.description
 			}) : null,
 			spec.info?.version ? /* @__PURE__ */ jsx("p", {
-				className: "text-sm text-zinc-500 dark:text-zinc-400",
+				className: "mt-4 text-sm text-(--clarify-ui-text-faint)",
 				children: t("openapi.version", { version: spec.info.version })
 			}) : null
 		]
@@ -212,6 +237,6 @@ function DocShell(arg0) {
 	});
 }
 //#endregion
-export { AppShell, BuiltWithClarify, Button, Callout, Card, CardGroup, ClarifyConfigContext, Code, CodeGroup, Collapse, DocShell, Feedback, GridPattern, Heading, HeroPattern, Logo, Markdown, OpenApiDocument, OpenApiOperation, OpenApisContext, PageFooter, Pre, Prose, SectionProvider, Tag, ThemeEditor, ThemeProvider, ThemeToggle, applyClarifyThemeVariables, clarifyThemeEditorPresets, markdownRemarkPlugins, remToPx, render, useClarifyConfig, useMDXComponents, useOpenApis, useSectionStore, useTheme };
+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 };
 
 //# sourceMappingURL=index.js.map