@clarify-labs/renderer 0.10.0 → 0.10.2

package/output/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../source/app/ContentDiagnostic.tsx","../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 type { ComponentType } from 'react'\n\nimport { RenderErrorPanel } from './RenderErrorPanel'\n\nexport type ContentDiagnostic = {\n  kind: string\n  title: string\n  message: string\n  details?: string\n  filePath?: string\n}\n\ntype ContentDiagnosticPanelProps = {\n  data: ContentDiagnostic\n}\n\nfunction ContentDiagnosticPanel(params: ContentDiagnosticPanelProps) {\n  const { data } = params\n  const typeLabel = data.kind === 'mdx' ? 'MDX' : data.kind === 'openapi' ? 'OpenAPI' : 'Route'\n  const detailsLabel = data.kind === 'mdx' ? 'Why it happened' : 'Details'\n  const pathLabel = 'File'\n\n  return (\n    <RenderErrorPanel\n      title={data.title}\n      description={data.message}\n      titleId=\"clarify-content-diagnostic-title\"\n      metadata={[\n        { label: pathLabel, value: data.filePath ?? 'Unknown' },\n        { label: 'Type', value: typeLabel },\n      ]}\n      detailsLabel={detailsLabel}\n      detailsContent={data.details ? (\n        <pre className=\"max-h-(--clarify-error-details-max-height) overflow-auto whitespace-pre-wrap wrap-break-word font-mono\">\n          {data.details}\n        </pre>\n      ) : null}\n    />\n  )\n}\n\nexport function createContentDiagnosticComponent(data: ContentDiagnostic): ComponentType {\n  return function ContentDiagnosticComponent() {\n    return <ContentDiagnosticPanel data={data} />\n  }\n}\n","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\nexport type OpenApiRouteData = {\n  spec: OpenAPISpec\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\nexport function createOpenApiRouteComponent(data: OpenApiRouteData) {\n  return function OpenApiRoutePage() {\n    return <OpenApiDocument spec={data.spec} tagFilter={data.tagFilter} />\n  }\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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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../source/app/ContentDiagnostic.tsx","../source/openapi/lib/spec-path.ts","../source/openapi/entry.tsx","../source/mdx/components.ts","../source/mdx/DocShell.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\n\nimport { RenderErrorPanel } from './RenderErrorPanel'\n\nexport type ContentDiagnostic = {\n  kind: string\n  title: string\n  message: string\n  details?: string\n  filePath?: string\n}\n\ntype ContentDiagnosticPanelProps = {\n  data: ContentDiagnostic\n}\n\nfunction ContentDiagnosticPanel(params: ContentDiagnosticPanelProps) {\n  const { data } = params\n  const typeLabel = data.kind === 'mdx' ? 'MDX' : data.kind === 'openapi' ? 'OpenAPI' : 'Route'\n  const detailsLabel = data.kind === 'mdx' ? 'Why it happened' : 'Details'\n  const pathLabel = 'File'\n\n  return (\n    <RenderErrorPanel\n      title={data.title}\n      description={data.message}\n      titleId=\"clarify-content-diagnostic-title\"\n      metadata={[\n        { label: pathLabel, value: data.filePath ?? 'Unknown' },\n        { label: 'Type', value: typeLabel },\n      ]}\n      detailsLabel={detailsLabel}\n      detailsContent={data.details ? (\n        <pre className=\"max-h-(--clarify-error-details-max-height) overflow-auto whitespace-pre-wrap wrap-break-word font-mono\">\n          {data.details}\n        </pre>\n      ) : null}\n    />\n  )\n}\n\nexport function createContentDiagnosticComponent(data: ContentDiagnostic): ComponentType {\n  return function ContentDiagnosticComponent() {\n    return <ContentDiagnosticPanel data={data} />\n  }\n}\n","import { useEffect, useState } from 'react'\nimport { useLocation } from 'react-router-dom'\n\nimport { useConfig, useLocale, useOpenApiSpecs } from '../../core/context'\n\nimport type { OpenAPISpec } from './utils'\n\ntype OpenApiSpecResult = {\n  spec: OpenAPISpec | null\n  loading: boolean\n}\n\ntype OpenApiSpecModule = { default: OpenAPISpec } | OpenAPISpec\n\ntype LoadedSpecState = {\n  loader?: () => Promise<OpenApiSpecModule>\n  spec: OpenAPISpec | null\n}\n\nfunction isOpenApiSpecLoader(value: unknown): value is () => Promise<OpenApiSpecModule> {\n  return typeof value === 'function'\n}\n\nfunction getLoadedSpec(value: OpenApiSpecModule): OpenAPISpec {\n  return value && typeof value === 'object' && 'default' in value\n    ? value.default\n    : value\n}\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 * Prefer a locale-qualified registry key for absolute specPath values, then\n * fall back to the normalized key. The CLI registers visible route aliases,\n * while relative paths already resolve through the current localized route.\n */\nfunction specModuleCandidates(moduleId: string, specPath: string, locale: string | undefined): string[] {\n  const candidates: string[] = []\n  if (locale && specPath.startsWith('/') && !specPath.startsWith(VIRTUAL_PREFIX)) {\n    const rest = moduleId.slice(VIRTUAL_PREFIX.length)\n    if (!rest.startsWith(`${locale}/`) && rest !== locale) candidates.push(`${VIRTUAL_PREFIX}${locale}/${rest}`)\n  }\n  candidates.push(moduleId)\n  return candidates\n}\n\nexport function useOpenApiSpec(spec?: OpenAPISpec, specPath?: string): OpenApiSpecResult {\n  const config = useConfig()\n  const locale = useLocale()\n  const specs = useOpenApiSpecs()\n  const location = useLocation()\n  const [loadedSpec, setLoadedSpec] = useState<LoadedSpecState>({ spec: null })\n  const normalized = specPath ? normalizeSpecPath(specPath, location.pathname, config.routePrefix) : undefined\n  const candidates = specPath && normalized ? specModuleCandidates(normalized, specPath, locale) : []\n  const registryValue = candidates.map(candidate => specs[candidate]).find(Boolean)\n\n  useEffect(() => {\n    let cancelled = false\n\n    if (!isOpenApiSpecLoader(registryValue)) return\n\n    registryValue().then(module => {\n      if (!cancelled) setLoadedSpec({ loader: registryValue, spec: getLoadedSpec(module) })\n    }).catch(() => {\n      if (!cancelled) setLoadedSpec({ loader: registryValue, spec: null })\n    })\n\n    return () => {\n      cancelled = true\n    }\n  }, [registryValue])\n\n  if (spec) return { spec, loading: false }\n  if (!specPath) return { spec: null, loading: false }\n  if (isOpenApiSpecLoader(registryValue)) {\n    return loadedSpec.loader === registryValue\n      ? { spec: loadedSpec.spec, loading: false }\n      : { spec: null, loading: true }\n  }\n  return { spec: registryValue ?? null, loading: false }\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 { getOpenApiOperationEntry, 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\nexport type OpenApiRouteData = {\n  spec: OpenAPISpec\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, source }) => ({\n      path,\n      method: method.toUpperCase(),\n      operation,\n      source,\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, source }) => (\n        <OpenApiOperationComponent key={`${source}-${method}-${path}`} spec={spec} path={path} method={method} operation={operation} operationSource={source} />\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 { spec: resolved, loading } = useOpenApiSpec(spec, specPath)\n\n  if (loading) {\n    return <WarningBox>{t('openapi.loading')}</WarningBox>\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 entry = getOpenApiOperationEntry(spec, path, method)\n\n  if (!entry) {\n    return <WarningBox tone=\"red\">{t('openapi.endpointNotFound', { endpoint: `${method.toUpperCase()} ${path}` })}</WarningBox>\n  }\n\n  const normalizedMethod = entry.method.toUpperCase()\n  return <OpenApiOperationComponent key={`${entry.source}-${normalizedMethod}-${path}`} spec={spec} path={path} method={normalizedMethod} operation={entry.operation} operationSource={entry.source} />\n}\n\nexport function OpenApiOperation(arg0: OpenApiOperationProps): ReactNode {\n  const { specPath, path, method } = arg0\n  const t = useBuiltInText()\n  const { spec, loading } = useOpenApiSpec(undefined, specPath)\n\n  if (loading) {\n    return <WarningBox>{t('openapi.loading')}</WarningBox>\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\nexport function createOpenApiRouteComponent(data: OpenApiRouteData) {\n  return function OpenApiRoutePage() {\n    return <OpenApiDocument spec={data.spec} />\n  }\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

@@ -5,11 +5,11 @@ 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, Mermaid, Pre, Prose, Tag, WebFrame } from './components';
-import { OpenApisContext, useOpenApis } from './context';
+import { OpenApiSpecsContext, useOpenApiSpecs } from './context';
 import { useMDXComponents } from './mdx/components';
 import { DocShell } from './mdx/DocShell';
 import { Markdown } from './mdx/Markdown';
-import { markdownRemarkPlugins } from './mdx/remark';
+import { markdownRemarkPlugins, parseCodeMeta } from './mdx/remark';
 import { OpenApiDocument, OpenApiOperation, createOpenApiRouteComponent } from './openapi';
 import { render } from './runtime/render';
 import { SlotProvider, RuntimeSlot, RuntimeSlotsProvider, useSlot } from './slots';
@@ -17,15 +17,15 @@ import { applyThemeVariables, themeEditorPresets, ThemeEditor } from './theme/Th
 import { ThemeProvider, useTheme } from './theme/ThemeProvider';
 import { ThemeToggle } from './theme/ThemeToggle';
 import { themePresets, themeBootstrapScript } from './theme/variables';
-import { Config, RouteItem, RenderOptions, ServerRenderOptions } from './types';
+import { Config, RouteItem, RouteSection, RenderOptions, ServerRenderOptions } from './types';
 import { remToPx } from './utils/remToPx';
 export type { OpenApiOperationProps, OpenApiDocumentProps, OpenAPIOperation, OpenAPISpec, OpenApiRouteData } from './openapi';
 export type { ThemeEditorProps } from './theme/ThemeEditor';
 export type { ContentDiagnostic };
-export type { Config, RouteItem, RenderOptions, ServerRenderOptions, Section };
-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, createContentDiagnosticComponent, createOpenApiRouteComponent };
+export type { Config, RouteItem, RouteSection, RenderOptions, ServerRenderOptions, Section };
+export type { RuntimeSlotEntry, RuntimeSlotRegistry, UISlotRegistration, UISlotName, UISlotContext } from './slots';
+export { AppShell, render, OpenApiSpecsContext, useOpenApiSpecs, BuiltWithClarify, PageBanner, PageFooter, ThemeProvider, ThemeToggle, ThemeEditor, useTheme, SectionProvider, useSectionStore, remToPx, applyThemeVariables, themeEditorPresets, themePresets, themeBootstrapScript, createContentDiagnosticComponent, createOpenApiRouteComponent };
 export { Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, Pre, Prose, Heading, Logo, Mermaid, GridPattern, HeroPattern, Feedback, Tag, WebFrame };
-export { DocShell, Markdown, useMDXComponents, markdownRemarkPlugins };
+export { DocShell, Markdown, useMDXComponents, markdownRemarkPlugins, parseCodeMeta };
 export { SlotProvider, RuntimeSlot, RuntimeSlotsProvider, useSlot };
 export { OpenApiDocument, OpenApiOperation };

package/output/index.js

@@ -1,8 +1,10 @@
-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-CyBkzvob.js";
-import { A as OpenApisContext, D as useBuiltInText, N as useLocale, P as useOpenApis, a as SectionProvider, h as useTheme, j as useConfig, m as ThemeProvider, n as PageTitleActions, o as useSectionStore, p as ThemeToggle, s as remToPx } from "./PageActions-Dn8IGWoL.js";
-import { a as themeBootstrapScript, c as AppShell, d as RenderErrorPanel, f as BuiltWithClarify, g as useSlot, h as SlotProvider, i as themeEditorPresets, l as PageFooter, m as RuntimeSlotsProvider, n as ThemeEditor, o as themePresets, p as RuntimeSlot, r as applyThemeVariables, u as PageBanner } from "./ClarifyShell-CxhXBtsR.js";
-import { t as markdownRemarkPlugins } from "./remark-Dd2WU50s.js";
-import { t as render } from "./render-CV0a-qtD.js";
+import { A as CardGroup, C as Feedback, D as Pre, E as CodeGroup, M as Button, O as Mermaid, S as Tag, T as Code, _ as Prose, b as Logo, d as listOpenApiOperations, g as WebFrame, h as primitives_exports, j as Callout, k as Card, m as Markdown, n as OpenApiOperation$1, u as getOpenApiOperationEntry, v as GridPattern, w as Collapse, x as Heading, y as HeroPattern } from "./OpenApiOperation-DgrqzeiS.js";
+import { a as useConfig, c as useOpenApiSpecs, i as OpenApiSpecsContext, s as useLocale, t as useBuiltInText } from "./i18n-DnqZHFT7.js";
+import { a as themeBootstrapScript, c as AppShell, d as RenderErrorPanel, f as BuiltWithClarify, g as useSlot, h as SlotProvider, i as themeEditorPresets, l as PageFooter, m as RuntimeSlotsProvider, n as ThemeEditor, o as themePresets, p as RuntimeSlot, r as applyThemeVariables, u as PageBanner } from "./ClarifyShell-1LuBliwt.js";
+import { a as SectionProvider, h as useTheme, m as ThemeProvider, n as PageTitleActions, o as useSectionStore, p as ThemeToggle, s as remToPx } from "./PageActions-D7K9LDGf.js";
+import { n as parseCodeMeta, t as markdownRemarkPlugins } from "./remark-C9iRQM0R.js";
+import { t as render } from "./render-DKj24Jqw.js";
+import { useEffect, useState } from "react";
 import { useLocation } from "react-router-dom";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region source/app/ContentDiagnostic.tsx
@@ -35,6 +37,12 @@ function createContentDiagnosticComponent(data) {
 }
 //#endregion
 //#region source/openapi/lib/spec-path.ts
+function isOpenApiSpecLoader(value) {
+	return typeof value === "function";
+}
+function getLoadedSpec(value) {
+	return value && typeof value === "object" && "default" in value ? value.default : value;
+}
 var VIRTUAL_PREFIX = "virtual:clarify-page/";
 function resolveRelativePath(fromDir, to) {
 	const parts = (fromDir + "/" + to).split("/").filter(Boolean);
@@ -52,78 +60,64 @@ function normalizeSpecPath(specPath, currentRoutePath, routePrefix = "") {
 	return VIRTUAL_PREFIX + resolveRelativePath(normalizedRoutePrefix && fromDir.startsWith(`${normalizedRoutePrefix}/`) ? fromDir.slice(normalizedRoutePrefix.length + 1) : fromDir, normalizedSpecPath);
 }
 /**
-* 为绝对 specPath 生成带 locale 前缀的候选模块 ID。
-*
-* 所有 locale 的 spec 都注册在 `virtual:clarify-page/<locale>/...` 下，
-* 因此绝对路径（如 `/api`）需要显式注入 locale 前缀才能命中。
-* 相对路径会因为当前路由已含 locale 前缀而自动解析到正确的 spec。
+* Prefer a locale-qualified registry key for absolute specPath values, then
+* fall back to the normalized key. The CLI registers visible route aliases,
+* while relative paths already resolve through the current localized route.
 */
-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 specModuleCandidates(moduleId, specPath, locale) {
+	const candidates = [];
+	if (locale && specPath.startsWith("/") && !specPath.startsWith(VIRTUAL_PREFIX)) {
+		const rest = moduleId.slice(21);
+		if (!rest.startsWith(`${locale}/`) && rest !== locale) candidates.push(`${VIRTUAL_PREFIX}${locale}/${rest}`);
+	}
+	candidates.push(moduleId);
+	return candidates;
 }
 function useOpenApiSpec(spec, specPath) {
 	const config = useConfig();
 	const locale = useLocale();
-	const specs = useOpenApis();
+	const specs = useOpenApiSpecs();
 	const location = useLocation();
-	if (spec) return spec;
-	if (!specPath) return 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
-var OPENAPI_HTTP_METHODS = [
-	"get",
-	"put",
-	"post",
-	"delete",
-	"options",
-	"head",
-	"patch",
-	"trace"
-];
-function isOpenAPIHttpMethod(method) {
-	return OPENAPI_HTTP_METHODS.includes(method.toLowerCase());
-}
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function resolveOpenApiRef(spec, ref) {
-	if (!ref.startsWith("#/")) return void 0;
-	return ref.slice(2).split("/").map((part) => part.replace(/~1/g, "/").replace(/~0/g, "~")).reduce((current, part) => isRecord(current) ? current[part] : void 0, spec);
-}
-function getPathItem(spec, path) {
-	const pathItem = spec.paths?.[path];
-	const resolved = isRecord(pathItem) && typeof pathItem.$ref === "string" ? resolveOpenApiRef(spec, pathItem.$ref) : pathItem;
-	return isRecord(resolved) ? resolved : void 0;
-}
-function getOpenApiOperation(spec, path, method) {
-	if (!isOpenAPIHttpMethod(method)) return void 0;
-	return getPathItem(spec, path)?.[method.toLowerCase()];
-}
-function listOpenApiOperations(spec) {
-	const paths = spec.paths ?? {};
-	const operations = [];
-	for (const path of Object.keys(paths)) {
-		const pathItem = getPathItem(spec, path);
-		if (!pathItem) continue;
-		for (const method of OPENAPI_HTTP_METHODS) {
-			const operation = pathItem[method];
-			if (operation) operations.push({
-				path,
-				method,
-				operation
+	const [loadedSpec, setLoadedSpec] = useState({ spec: null });
+	const normalized = specPath ? normalizeSpecPath(specPath, location.pathname, config.routePrefix) : void 0;
+	const registryValue = (specPath && normalized ? specModuleCandidates(normalized, specPath, locale) : []).map((candidate) => specs[candidate]).find(Boolean);
+	useEffect(() => {
+		let cancelled = false;
+		if (!isOpenApiSpecLoader(registryValue)) return;
+		registryValue().then((module) => {
+			if (!cancelled) setLoadedSpec({
+				loader: registryValue,
+				spec: getLoadedSpec(module)
 			});
-		}
-	}
-	return operations;
+		}).catch(() => {
+			if (!cancelled) setLoadedSpec({
+				loader: registryValue,
+				spec: null
+			});
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [registryValue]);
+	if (spec) return {
+		spec,
+		loading: false
+	};
+	if (!specPath) return {
+		spec: null,
+		loading: false
+	};
+	if (isOpenApiSpecLoader(registryValue)) return loadedSpec.loader === registryValue ? {
+		spec: loadedSpec.spec,
+		loading: false
+	} : {
+		spec: null,
+		loading: true
+	};
+	return {
+		spec: registryValue ?? null,
+		loading: false
+	};
 }
 //#endregion
 //#region source/openapi/entry.tsx
@@ -163,16 +157,18 @@ function OpenApiPaths(arg0) {
 	const { spec, tagFilter } = arg0;
 	return /* @__PURE__ */ jsx("div", {
 		className: "clarify-api-endpoints divide-y divide-zinc-200/70 dark:divide-white/10",
-		children: listOpenApiOperations(spec).filter(({ operation }) => operationMatchesTags(operation.tags, tagFilter)).map(({ path, method, operation }) => ({
+		children: listOpenApiOperations(spec).filter(({ operation }) => operationMatchesTags(operation.tags, tagFilter)).map(({ path, method, operation, source }) => ({
 			path,
 			method: method.toUpperCase(),
-			operation
-		})).map(({ path, method, operation }) => /* @__PURE__ */ jsx(OpenApiOperation$1, {
+			operation,
+			source
+		})).map(({ path, method, operation, source }) => /* @__PURE__ */ jsx(OpenApiOperation$1, {
 			spec,
 			path,
 			method,
-			operation
-		}, `${method}-${path}`))
+			operation,
+			operationSource: source
+		}, `${source}-${method}-${path}`))
 	});
 }
 function WarningBox(arg0) {
@@ -185,7 +181,8 @@ function WarningBox(arg0) {
 function OpenApiDocument(arg0) {
 	const { spec, specPath, tagFilter } = arg0;
 	const t = useBuiltInText();
-	const resolved = useOpenApiSpec(spec, specPath);
+	const { spec: resolved, loading } = useOpenApiSpec(spec, specPath);
+	if (loading) return /* @__PURE__ */ jsx(WarningBox, { children: t("openapi.loading") });
 	if (!resolved) return /* @__PURE__ */ jsx(WarningBox, { children: t("openapi.specNotFound", { specPath: specPath ?? t("openapi.specPathMissing") }) });
 	return /* @__PURE__ */ jsx("article", {
 		className: "clarify-openapi-page flex h-full flex-col pt-16 pb-10",
@@ -201,23 +198,25 @@ function OpenApiDocument(arg0) {
 function OpenApiOperationWithSpec(arg0) {
 	const { spec, path, method } = arg0;
 	const t = useBuiltInText();
-	const op = getOpenApiOperation(spec, path, method);
-	if (!op) return /* @__PURE__ */ jsx(WarningBox, {
+	const entry = getOpenApiOperationEntry(spec, path, method);
+	if (!entry) return /* @__PURE__ */ jsx(WarningBox, {
 		tone: "red",
 		children: t("openapi.endpointNotFound", { endpoint: `${method.toUpperCase()} ${path}` })
 	});
-	const normalizedMethod = method.toUpperCase();
+	const normalizedMethod = entry.method.toUpperCase();
 	return /* @__PURE__ */ jsx(OpenApiOperation$1, {
 		spec,
 		path,
 		method: normalizedMethod,
-		operation: op
-	}, `${normalizedMethod}-${path}`);
+		operation: entry.operation,
+		operationSource: entry.source
+	}, `${entry.source}-${normalizedMethod}-${path}`);
 }
 function OpenApiOperation(arg0) {
 	const { specPath, path, method } = arg0;
 	const t = useBuiltInText();
-	const spec = useOpenApiSpec(void 0, specPath);
+	const { spec, loading } = useOpenApiSpec(void 0, specPath);
+	if (loading) return /* @__PURE__ */ jsx(WarningBox, { children: t("openapi.loading") });
 	if (!spec) return /* @__PURE__ */ jsx(WarningBox, { children: t("openapi.specNotFound", { specPath }) });
 	return /* @__PURE__ */ jsx(OpenApiOperationWithSpec, {
 		spec,
@@ -227,10 +226,7 @@ function OpenApiOperation(arg0) {
 }
 function createOpenApiRouteComponent(data) {
 	return function OpenApiRoutePage() {
-		return /* @__PURE__ */ jsx(OpenApiDocument, {
-			spec: data.spec,
-			tagFilter: data.tagFilter
-		});
+		return /* @__PURE__ */ jsx(OpenApiDocument, { spec: data.spec });
 	};
 }
 //#endregion
@@ -274,6 +270,6 @@ function DocShell(arg0) {
 	});
 }
 //#endregion
-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, createContentDiagnosticComponent, createOpenApiRouteComponent, markdownRemarkPlugins, remToPx, render, themeBootstrapScript, themeEditorPresets, themePresets, useMDXComponents, useOpenApis, useSectionStore, useSlot, useTheme };
+export { AppShell, BuiltWithClarify, Button, Callout, Card, CardGroup, Code, CodeGroup, Collapse, DocShell, Feedback, GridPattern, Heading, HeroPattern, Logo, Markdown, Mermaid, OpenApiDocument, OpenApiOperation, OpenApiSpecsContext, PageBanner, PageFooter, Pre, Prose, RuntimeSlot, RuntimeSlotsProvider, SectionProvider, SlotProvider, Tag, ThemeEditor, ThemeProvider, ThemeToggle, WebFrame, applyThemeVariables, createContentDiagnosticComponent, createOpenApiRouteComponent, markdownRemarkPlugins, parseCodeMeta, remToPx, render, themeBootstrapScript, themeEditorPresets, themePresets, useMDXComponents, useOpenApiSpecs, useSectionStore, useSlot, useTheme };
 
 //# sourceMappingURL=index.js.map

package/output/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../source/app/ContentDiagnostic.tsx","../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 type { ComponentType } from 'react'\n\nimport { RenderErrorPanel } from './RenderErrorPanel'\n\nexport type ContentDiagnostic = {\n  kind: string\n  title: string\n  message: string\n  details?: string\n  filePath?: string\n}\n\ntype ContentDiagnosticPanelProps = {\n  data: ContentDiagnostic\n}\n\nfunction ContentDiagnosticPanel(params: ContentDiagnosticPanelProps) {\n  const { data } = params\n  const typeLabel = data.kind === 'mdx' ? 'MDX' : data.kind === 'openapi' ? 'OpenAPI' : 'Route'\n  const detailsLabel = data.kind === 'mdx' ? 'Why it happened' : 'Details'\n  const pathLabel = 'File'\n\n  return (\n    <RenderErrorPanel\n      title={data.title}\n      description={data.message}\n      titleId=\"clarify-content-diagnostic-title\"\n      metadata={[\n        { label: pathLabel, value: data.filePath ?? 'Unknown' },\n        { label: 'Type', value: typeLabel },\n      ]}\n      detailsLabel={detailsLabel}\n      detailsContent={data.details ? (\n        <pre className=\"max-h-(--clarify-error-details-max-height) overflow-auto whitespace-pre-wrap wrap-break-word font-mono\">\n          {data.details}\n        </pre>\n      ) : null}\n    />\n  )\n}\n\nexport function createContentDiagnosticComponent(data: ContentDiagnostic): ComponentType {\n  return function ContentDiagnosticComponent() {\n    return <ContentDiagnosticPanel data={data} />\n  }\n}\n","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\nexport type OpenApiRouteData = {\n  spec: OpenAPISpec\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\nexport function createOpenApiRouteComponent(data: OpenApiRouteData) {\n  return function OpenApiRoutePage() {\n    return <OpenApiDocument spec={data.spec} tagFilter={data.tagFilter} />\n  }\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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"}
+{"version":3,"file":"index.js","names":[],"sources":["../source/app/ContentDiagnostic.tsx","../source/openapi/lib/spec-path.ts","../source/openapi/entry.tsx","../source/mdx/components.ts","../source/mdx/DocShell.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\n\nimport { RenderErrorPanel } from './RenderErrorPanel'\n\nexport type ContentDiagnostic = {\n  kind: string\n  title: string\n  message: string\n  details?: string\n  filePath?: string\n}\n\ntype ContentDiagnosticPanelProps = {\n  data: ContentDiagnostic\n}\n\nfunction ContentDiagnosticPanel(params: ContentDiagnosticPanelProps) {\n  const { data } = params\n  const typeLabel = data.kind === 'mdx' ? 'MDX' : data.kind === 'openapi' ? 'OpenAPI' : 'Route'\n  const detailsLabel = data.kind === 'mdx' ? 'Why it happened' : 'Details'\n  const pathLabel = 'File'\n\n  return (\n    <RenderErrorPanel\n      title={data.title}\n      description={data.message}\n      titleId=\"clarify-content-diagnostic-title\"\n      metadata={[\n        { label: pathLabel, value: data.filePath ?? 'Unknown' },\n        { label: 'Type', value: typeLabel },\n      ]}\n      detailsLabel={detailsLabel}\n      detailsContent={data.details ? (\n        <pre className=\"max-h-(--clarify-error-details-max-height) overflow-auto whitespace-pre-wrap wrap-break-word font-mono\">\n          {data.details}\n        </pre>\n      ) : null}\n    />\n  )\n}\n\nexport function createContentDiagnosticComponent(data: ContentDiagnostic): ComponentType {\n  return function ContentDiagnosticComponent() {\n    return <ContentDiagnosticPanel data={data} />\n  }\n}\n","import { useEffect, useState } from 'react'\nimport { useLocation } from 'react-router-dom'\n\nimport { useConfig, useLocale, useOpenApiSpecs } from '../../core/context'\n\nimport type { OpenAPISpec } from './utils'\n\ntype OpenApiSpecResult = {\n  spec: OpenAPISpec | null\n  loading: boolean\n}\n\ntype OpenApiSpecModule = { default: OpenAPISpec } | OpenAPISpec\n\ntype LoadedSpecState = {\n  loader?: () => Promise<OpenApiSpecModule>\n  spec: OpenAPISpec | null\n}\n\nfunction isOpenApiSpecLoader(value: unknown): value is () => Promise<OpenApiSpecModule> {\n  return typeof value === 'function'\n}\n\nfunction getLoadedSpec(value: OpenApiSpecModule): OpenAPISpec {\n  return value && typeof value === 'object' && 'default' in value\n    ? value.default\n    : value\n}\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 * Prefer a locale-qualified registry key for absolute specPath values, then\n * fall back to the normalized key. The CLI registers visible route aliases,\n * while relative paths already resolve through the current localized route.\n */\nfunction specModuleCandidates(moduleId: string, specPath: string, locale: string | undefined): string[] {\n  const candidates: string[] = []\n  if (locale && specPath.startsWith('/') && !specPath.startsWith(VIRTUAL_PREFIX)) {\n    const rest = moduleId.slice(VIRTUAL_PREFIX.length)\n    if (!rest.startsWith(`${locale}/`) && rest !== locale) candidates.push(`${VIRTUAL_PREFIX}${locale}/${rest}`)\n  }\n  candidates.push(moduleId)\n  return candidates\n}\n\nexport function useOpenApiSpec(spec?: OpenAPISpec, specPath?: string): OpenApiSpecResult {\n  const config = useConfig()\n  const locale = useLocale()\n  const specs = useOpenApiSpecs()\n  const location = useLocation()\n  const [loadedSpec, setLoadedSpec] = useState<LoadedSpecState>({ spec: null })\n  const normalized = specPath ? normalizeSpecPath(specPath, location.pathname, config.routePrefix) : undefined\n  const candidates = specPath && normalized ? specModuleCandidates(normalized, specPath, locale) : []\n  const registryValue = candidates.map(candidate => specs[candidate]).find(Boolean)\n\n  useEffect(() => {\n    let cancelled = false\n\n    if (!isOpenApiSpecLoader(registryValue)) return\n\n    registryValue().then(module => {\n      if (!cancelled) setLoadedSpec({ loader: registryValue, spec: getLoadedSpec(module) })\n    }).catch(() => {\n      if (!cancelled) setLoadedSpec({ loader: registryValue, spec: null })\n    })\n\n    return () => {\n      cancelled = true\n    }\n  }, [registryValue])\n\n  if (spec) return { spec, loading: false }\n  if (!specPath) return { spec: null, loading: false }\n  if (isOpenApiSpecLoader(registryValue)) {\n    return loadedSpec.loader === registryValue\n      ? { spec: loadedSpec.spec, loading: false }\n      : { spec: null, loading: true }\n  }\n  return { spec: registryValue ?? null, loading: false }\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 { getOpenApiOperationEntry, 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\nexport type OpenApiRouteData = {\n  spec: OpenAPISpec\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, source }) => ({\n      path,\n      method: method.toUpperCase(),\n      operation,\n      source,\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, source }) => (\n        <OpenApiOperationComponent key={`${source}-${method}-${path}`} spec={spec} path={path} method={method} operation={operation} operationSource={source} />\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 { spec: resolved, loading } = useOpenApiSpec(spec, specPath)\n\n  if (loading) {\n    return <WarningBox>{t('openapi.loading')}</WarningBox>\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 entry = getOpenApiOperationEntry(spec, path, method)\n\n  if (!entry) {\n    return <WarningBox tone=\"red\">{t('openapi.endpointNotFound', { endpoint: `${method.toUpperCase()} ${path}` })}</WarningBox>\n  }\n\n  const normalizedMethod = entry.method.toUpperCase()\n  return <OpenApiOperationComponent key={`${entry.source}-${normalizedMethod}-${path}`} spec={spec} path={path} method={normalizedMethod} operation={entry.operation} operationSource={entry.source} />\n}\n\nexport function OpenApiOperation(arg0: OpenApiOperationProps): ReactNode {\n  const { specPath, path, method } = arg0\n  const t = useBuiltInText()\n  const { spec, loading } = useOpenApiSpec(undefined, specPath)\n\n  if (loading) {\n    return <WarningBox>{t('openapi.loading')}</WarningBox>\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\nexport function createOpenApiRouteComponent(data: OpenApiRouteData) {\n  return function OpenApiRoutePage() {\n    return <OpenApiDocument spec={data.spec} />\n  }\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/markdown.cjs

@@ -1,3 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_remark = require("./remark-zSQT0MBv.cjs");
+const require_remark = require("./remark-DTLbG8PK.cjs");
 exports.markdownRemarkPlugins = require_remark.markdownRemarkPlugins;
+exports.parseCodeMeta = require_remark.parseCodeMeta;

package/output/markdown.d.ts

@@ -1 +1 @@
-export { markdownRemarkPlugins } from './mdx/remark';
+export { markdownRemarkPlugins, parseCodeMeta } from './mdx/remark';

package/output/markdown.js

@@ -1,2 +1,2 @@
-import { t as markdownRemarkPlugins } from "./remark-Dd2WU50s.js";
-export { markdownRemarkPlugins };
+import { n as parseCodeMeta, t as markdownRemarkPlugins } from "./remark-C9iRQM0R.js";
+export { markdownRemarkPlugins, parseCodeMeta };

package/output/mdx/remark.d.ts

@@ -7,6 +7,7 @@ export type MarkdownNode = {
     };
     children?: MarkdownNode[];
 };
+export declare function parseCodeMeta(meta: string | null | undefined): Record<string, string>;
 declare function remarkCodeMeta(): (tree: MarkdownNode) => void;
 export declare const markdownRemarkPlugins: (typeof remarkGfm | typeof remarkCodeMeta)[];
 export {};

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

@@ -1,10 +1,11 @@
 import { ReactNode } from 'react';
-import { OpenAPIOperation, OpenAPISpec } from '../lib/utils';
+import { OpenAPIOperation, OpenAPIOperationSource, OpenAPISpec } from '../lib/utils';
 import { MediaTypeEntry, OpenApiParameter, OpenApiRecord, OpenApiServer, RequestAuthInput } from '../types';
 type EndpointRequestProps = {
     spec: OpenAPISpec;
     path: string;
     method: string;
+    operationSource?: OpenAPIOperationSource;
     description?: string;
     groupedParameters: {
         path: OpenApiParameter[];
@@ -27,6 +28,7 @@ export declare function EndpointRequest(arg0: EndpointRequestProps): ReactNode;
 type EndpointResponseProps = {
     spec: OpenAPISpec;
     operation: OpenAPIOperation;
+    operationSource?: OpenAPIOperationSource;
     sharedExampleKey?: string;
     onSelectExampleKey?: (value: string) => void;
     selectedStatus?: string;

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

@@ -1,7 +1,7 @@
 import { ReactNode } from 'react';
 import { buildRequestCodeExamples } from '../lib/request-code';
-import { OpenAPIOperation, OpenAPISpec } from '../lib/utils';
-import { MediaTypeEntry, OpenApiParameter, RequestAuthInput } from '../types';
+import { OpenAPIOperation, OpenAPIOperationSource, OpenAPISpec } from '../lib/utils';
+import { ExampleEntry, MediaTypeEntry, OpenApiParameter, RequestAuthInput } from '../types';
 type RequestExamplesPanelProps = {
     spec: OpenAPISpec;
     path: string;
@@ -13,6 +13,7 @@ type RequestExamplesPanelProps = {
     selectedServer: Parameters<typeof buildRequestCodeExamples>[0]['server'];
     serverVariables: Record<string, string>;
     auth?: RequestAuthInput;
+    operationSource?: OpenAPIOperationSource;
     sharedExampleKey?: string;
     onSelectExampleKey?: (value: string) => void;
 };
@@ -20,10 +21,12 @@ export declare function RequestExamplesPanel(arg0: RequestExamplesPanelProps): R
 type ResponseExamplesPanelProps = {
     operation: OpenAPIOperation;
     spec?: OpenAPISpec;
+    title?: string;
     sharedExampleKey?: string;
     onSelectExampleKey?: (value: string) => void;
     selectedStatus?: string;
     onSelectStatus?: (value: string) => void;
 };
+export declare function getResponseExampleBody(content: MediaTypeEntry | undefined, example: ExampleEntry | undefined): string;
 export declare function ResponseExamplesPanel(arg0: ResponseExamplesPanelProps): ReactNode;
 export { getServers, getServerKey, getServerLabel, defaultServerVariables, authPlaceholder, authLabel, getAuthOptions, type AuthOption, } from './helpers';

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

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { OpenAPIOperation, OpenAPISpec } from '../lib/utils';
+import { OpenAPIOperation, OpenAPIOperationSource, OpenAPISpec } from '../lib/utils';
 import { OpenApiServer } from '../types';
 import { AuthOption } from './ExamplePanels';
 export type OpenApiOperationProps = {
@@ -7,6 +7,7 @@ export type OpenApiOperationProps = {
     path: string;
     method: string;
     operation: OpenAPIOperation;
+    operationSource?: OpenAPIOperationSource;
 };
 type EndpointPathProps = {
     path: string;
@@ -16,6 +17,7 @@ type EndpointPathProps = {
 export declare function EndpointPath(arg0: EndpointPathProps): ReactNode;
 type EndpointIdentityProps = {
     method: string;
+    operationSource: OpenAPIOperationSource;
     path: string;
     servers: OpenApiServer[];
     selectedServerKey: string;

package/output/openapi/components/OpenApiOperation.state.d.ts

@@ -1,5 +1,5 @@
 import { getMediaTypeEntries, getRequestBody } from '../lib/helpers';
-import { OpenAPIOperation, OpenAPISpec } from '../lib/utils';
+import { OpenAPIOperation, OpenAPIOperationSource, OpenAPISpec } from '../lib/utils';
 import { OpenApiParameter, OpenApiServer, RequestAuthInput } from '../types';
 import { AuthOption } from './ExamplePanels';
 export type OperationRequestState = {
@@ -15,7 +15,7 @@ export type OperationRequestState = {
         header: OpenApiParameter[];
     };
 };
-export declare function useOperationRequestState(spec: OpenAPISpec, path: string, operation: OpenAPIOperation): OperationRequestState;
+export declare function useOperationRequestState(spec: OpenAPISpec, path: string, operation: OpenAPIOperation, source?: OpenAPIOperationSource): OperationRequestState;
 export type OperationServerState = {
     servers: OpenApiServer[];
     selectedServerKey: string;
@@ -27,7 +27,7 @@ export type OperationServerState = {
     onToggleServer: () => void;
     closeServer: () => void;
 };
-export declare function useOperationServerState(spec: OpenAPISpec, operation: OpenAPIOperation, path: string): OperationServerState;
+export declare function useOperationServerState(spec: OpenAPISpec, operation: OpenAPIOperation, path: string, source?: OpenAPIOperationSource): OperationServerState;
 export type OperationAuthState = {
     authOptions: AuthOption[];
     selectedAuthName: string;

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

@@ -14,6 +14,7 @@ type ParameterListProps = {
 };
 export declare function ParameterList(arg0: ParameterListProps): ReactNode;
 type ResponseListProps = {
+    title?: string;
     operation: OpenAPIOperation;
     spec?: OpenAPISpec;
     selectedStatus?: string;