@redocly/framework 1.0.0-next.6 → 1.0.0-next.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (189) hide show
  1. package/dist/bundler/build/output-metadata.js +1 -1
  2. package/dist/bundler/build/run.js +1 -1
  3. package/dist/bundler/dev/dev-content-build.js +1 -0
  4. package/dist/bundler/dev/dev-problems.js +1 -1
  5. package/dist/bundler/dev/dev-reporter.js +1 -1
  6. package/dist/bundler/dev/routes/dev-content-build-route.js +1 -0
  7. package/dist/bundler/dev/routes/dev-problems-route.js +1 -1
  8. package/dist/bundler/dev/run.js +1 -1
  9. package/dist/bundler/dev/runtime-app.js +1 -1
  10. package/dist/cli/args.js +1 -1
  11. package/dist/cli/commands/build.js +1 -1
  12. package/dist/cli/commands/ingest.js +1 -1
  13. package/dist/cli/commands/translate.js +1 -1
  14. package/dist/cli/dev-console/{sweep.js → content-build.js} +1 -1
  15. package/dist/cli/dev-console/index.js +1 -1
  16. package/dist/cli/dev-console/lines.js +2 -2
  17. package/dist/cli/dev-console/plain.js +1 -1
  18. package/dist/cli/dev-console/tui.js +2 -2
  19. package/dist/cli/validate-react-pages.js +1 -1
  20. package/dist/client/app.js +2 -7
  21. package/dist/client/client-entry.js +1 -1
  22. package/dist/client/dev-problems/ProblemsBar.js +75 -15
  23. package/dist/client/dev-problems/build-segment.js +1 -0
  24. package/dist/client/dev-problems/index.js +1 -1
  25. package/dist/client/dev-problems/use-dev-problems.js +1 -1
  26. package/dist/client/review/ReviewBar.js +163 -69
  27. package/dist/client/review/login-url.js +1 -0
  28. package/dist/client/use-bar-position.js +1 -0
  29. package/dist/client/use-page-versions.js +1 -1
  30. package/dist/client/use-search.js +1 -1
  31. package/dist/content-layer/api-outputs.js +1 -1
  32. package/dist/content-layer/config-schema.js +1 -1
  33. package/dist/content-layer/config.d.ts +2 -1
  34. package/dist/content-layer/config.js +1 -1
  35. package/dist/content-layer/database/files.js +1 -1
  36. package/dist/content-layer/database/finalize.js +1 -1
  37. package/dist/content-layer/database/origins.js +1 -1
  38. package/dist/content-layer/database/problems.d.ts +2 -0
  39. package/dist/content-layer/database/problems.js +1 -1
  40. package/dist/content-layer/database/reset.js +1 -1
  41. package/dist/content-layer/database/schema.d.ts +17 -0
  42. package/dist/content-layer/database/schema.js +1 -1
  43. package/dist/content-layer/ingest/finalize-phase.js +1 -1
  44. package/dist/content-layer/ingest/git-last-modified.js +3 -3
  45. package/dist/content-layer/ingest/hash.js +1 -1
  46. package/dist/content-layer/ingest/run.js +1 -1
  47. package/dist/content-layer/ingest/search-sync.js +1 -1
  48. package/dist/content-layer/ingest/sync.js +1 -1
  49. package/dist/content-layer/link-checker/delta.js +1 -1
  50. package/dist/content-layer/link-checker/fingerprint.js +1 -1
  51. package/dist/content-layer/link-checker/load-view.js +1 -1
  52. package/dist/content-layer/link-checker/run-build.js +1 -1
  53. package/dist/content-layer/link-checker/validate.js +1 -1
  54. package/dist/content-layer/link-checker/view.js +1 -1
  55. package/dist/content-layer/loaders/context.js +1 -1
  56. package/dist/content-layer/loaders/define.d.ts +3 -0
  57. package/dist/content-layer/markdown/client/JsonSchemaTag.js +1 -1
  58. package/dist/content-layer/markdown/client/code-highlight-notation.js +3 -3
  59. package/dist/content-layer/markdown/client/markdoc-components.js +2 -2
  60. package/dist/content-layer/markdown/resolve/audience-tag.d.ts +1 -5
  61. package/dist/content-layer/markdown/resolve/audience-tag.js +1 -1
  62. package/dist/content-layer/markdown/resolve/markdoc-resolvers/json-schema.js +1 -1
  63. package/dist/content-layer/markdown/resolve/markdoc-resolvers/operation-samples.js +1 -1
  64. package/dist/content-layer/markdown/resolve/references.js +1 -1
  65. package/dist/content-layer/markdown/search/to-sections.d.ts +1 -1
  66. package/dist/content-layer/markdown/search/to-sections.js +1 -1
  67. package/dist/content-layer/markdown/tags/html.d.ts +2 -2
  68. package/dist/content-layer/markdown/tags/html.js +1 -1
  69. package/dist/content-layer/markdown/tags/openapi.js +1 -1
  70. package/dist/content-layer/materialization/entity.js +1 -1
  71. package/dist/content-layer/materialization/static-files.js +1 -1
  72. package/dist/content-layer/plugins/internal/api-docs/client/event-handlers.js +1 -1
  73. package/dist/content-layer/plugins/internal/api-docs/client/template.js +11 -3
  74. package/dist/content-layer/plugins/internal/api-docs/index.js +1 -1
  75. package/dist/content-layer/plugins/internal/api-docs/server/build-definition.d.ts +21 -11
  76. package/dist/content-layer/plugins/internal/api-docs/server/build-definition.js +1 -1
  77. package/dist/content-layer/plugins/internal/api-docs/server/build-sidebar.js +1 -1
  78. package/dist/content-layer/plugins/internal/api-docs/server/markdown-decorator.d.ts +1 -4
  79. package/dist/content-layer/plugins/internal/api-docs/server/markdown-decorator.js +1 -1
  80. package/dist/content-layer/plugins/internal/api-docs/server/markdown-docs.js +14 -14
  81. package/dist/content-layer/plugins/internal/api-docs/server/spec-download.js +1 -1
  82. package/dist/content-layer/plugins/internal/api-functions/server/access.js +1 -1
  83. package/dist/content-layer/plugins/internal/api-functions/server/dispatch.js +1 -1
  84. package/dist/content-layer/plugins/internal/app-data/index.d.ts +1 -1
  85. package/dist/content-layer/plugins/internal/app-data/index.js +1 -1
  86. package/dist/content-layer/plugins/internal/markdoc/index.js +1 -1
  87. package/dist/content-layer/plugins/internal/mcp/constants.d.ts +17 -0
  88. package/dist/content-layer/plugins/internal/mcp/constants.js +1 -1
  89. package/dist/content-layer/plugins/internal/mcp/content-tools.js +1 -1
  90. package/dist/content-layer/plugins/internal/mcp/server/agent-card.js +1 -1
  91. package/dist/content-layer/plugins/internal/mcp/server/audit.js +1 -1
  92. package/dist/content-layer/plugins/internal/mcp/server/auth.js +1 -1
  93. package/dist/content-layer/plugins/internal/mcp/server/codemode/capabilities.js +6 -6
  94. package/dist/content-layer/plugins/internal/mcp/server/codemode/constants.js +1 -1
  95. package/dist/content-layer/plugins/internal/mcp/server/codemode/discover.js +1 -1
  96. package/dist/content-layer/plugins/internal/mcp/server/codemode/prompts.js +8 -8
  97. package/dist/content-layer/plugins/internal/mcp/server/custom-tools.js +1 -1
  98. package/dist/content-layer/plugins/internal/mcp/server/gateway/allowed-http-methods.js +1 -1
  99. package/dist/content-layer/plugins/internal/mcp/server/gateway/api-call-operations.js +1 -1
  100. package/dist/content-layer/plugins/internal/mcp/server/gateway/call-api.js +2 -0
  101. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials-page/form-page.js +10 -10
  102. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials-page/outcome-pages.js +1 -1
  103. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials.js +1 -1
  104. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/fetch-bridge.js +1 -1
  105. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/ssrf-guard.js +1 -1
  106. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/upstream-detail.js +1 -1
  107. package/dist/content-layer/plugins/internal/mcp/server/gateway/index.js +3 -3
  108. package/dist/content-layer/plugins/internal/mcp/server/gateway/tool-list.js +1 -0
  109. package/dist/content-layer/plugins/internal/mcp/server/gateway/tools.js +4 -4
  110. package/dist/content-layer/plugins/internal/mcp/server/gateway/upstream-auth-scheme.js +1 -1
  111. package/dist/content-layer/plugins/internal/mcp/server/handler.js +1 -1
  112. package/dist/content-layer/plugins/internal/mcp/server/mcp-server.js +1 -1
  113. package/dist/content-layer/plugins/internal/mcp/server/mcp-telemetry.js +1 -1
  114. package/dist/content-layer/plugins/internal/mcp/server/oauth/authorize.js +1 -1
  115. package/dist/content-layer/plugins/internal/mcp/server/oauth/callback.js +1 -1
  116. package/dist/content-layer/plugins/internal/mcp/server/oauth/discovery.js +1 -1
  117. package/dist/content-layer/plugins/internal/mcp/server/oauth/token.js +1 -1
  118. package/dist/content-layer/plugins/internal/mcp/server/oauth/tokens.js +1 -1
  119. package/dist/content-layer/plugins/internal/mcp/server/server-card.js +1 -1
  120. package/dist/content-layer/plugins/internal/mcp/server/skills-resources.js +1 -1
  121. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-catalog.js +1 -1
  122. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-document.js +1 -1
  123. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi.js +1 -1
  124. package/dist/content-layer/plugins/internal/mcp/server/tools/pages.js +2 -2
  125. package/dist/content-layer/plugins/internal/mcp/server/tools/schemas.js +1 -1
  126. package/dist/content-layer/plugins/internal/mock/server/handler.js +1 -1
  127. package/dist/content-layer/plugins/internal/sidebar/index.d.ts +2 -1
  128. package/dist/content-layer/plugins/internal/sidebar/index.js +1 -1
  129. package/dist/content-layer/plugins/internal/sidebar/subtree.js +1 -1
  130. package/dist/content-layer/plugins/internal/skills/server/routes.js +1 -1
  131. package/dist/content-layer/plugins/types/markdoc.d.ts +2 -0
  132. package/dist/content-layer/plugins/utils/route-index.js +1 -1
  133. package/dist/content-layer/problems/codes.js +1 -1
  134. package/dist/content-layer/search/postings/fragment-field.d.ts +2 -0
  135. package/dist/content-layer/search/postings/fragment-field.js +1 -1
  136. package/dist/content-layer/search/postings/postings-store.js +1 -1
  137. package/dist/content-layer/server/database.js +1 -1
  138. package/dist/content-layer/static/registry.js +1 -1
  139. package/dist/content-layer/versions/version-groups.d.ts +5 -1
  140. package/dist/content-layer/versions/version-groups.js +1 -1
  141. package/dist/server/app.js +3 -3
  142. package/dist/server/ask-ai/route.js +1 -1
  143. package/dist/server/auth/access-config.js +1 -1
  144. package/dist/server/auth/gate.js +1 -1
  145. package/dist/server/auth/middleware.js +1 -1
  146. package/dist/server/auth/oidc.js +1 -1
  147. package/dist/server/auth/routes.js +1 -1
  148. package/dist/server/content.js +9 -9
  149. package/dist/server/lambda-entry.js +1 -1
  150. package/dist/server/node-entry.js +1 -1
  151. package/dist/server/page-handlers.js +2 -2
  152. package/dist/server/redirects.js +1 -1
  153. package/dist/server/review/route.js +1 -1
  154. package/dist/server/search/route.js +1 -1
  155. package/dist/server/static-files/serve.js +1 -1
  156. package/dist/server/subprocess/child-entry.js +1 -1
  157. package/dist/server/subprocess/host.js +1 -1
  158. package/dist/server/telemetry/mock-server-events.js +1 -0
  159. package/dist/server/telemetry/redirect-event.js +1 -0
  160. package/dist/server/telemetry/sender.js +1 -1
  161. package/dist/shared/constants/content-update.js +1 -1
  162. package/dist/shared/constants/dev-content-build.js +1 -0
  163. package/dist/shared/constants/dev-problems.js +1 -1
  164. package/dist/shared/constants/dev-source-sync.js +1 -1
  165. package/dist/shared/constants/manifest-version.d.ts +3 -1
  166. package/dist/shared/constants/openapi-operation-methods.d.ts +2 -0
  167. package/dist/shared/constants/openapi-operation-methods.js +1 -0
  168. package/dist/shared/constants/review.d.ts +5 -0
  169. package/dist/shared/constants/review.js +1 -1
  170. package/dist/shared/load-dot-env.js +1 -1
  171. package/dist/shared/rbac/api-docs.d.ts +2 -1
  172. package/dist/shared/rbac/api-docs.js +1 -1
  173. package/dist/shared/rbac/engine.d.ts +12 -9
  174. package/dist/shared/rbac/engine.js +0 -0
  175. package/dist/shared/rbac/filter.js +1 -1
  176. package/dist/shared/rbac/route-scope.d.ts +1 -1
  177. package/dist/shared/types/auth.d.ts +1 -0
  178. package/dist/shared/types/config.d.ts +1 -0
  179. package/dist/shared/types/search.d.ts +7 -2
  180. package/drizzle/20261111152552_page_markdown_rbac_scope/migration.sql +1 -0
  181. package/package.json +26 -5
  182. package/dist/bundler/dev/__tests__/reset-content-update-state.js +0 -1
  183. package/dist/bundler/dev/materialization-sweeper.js +0 -1
  184. package/dist/client/dev-problems/sweep-segment.js +0 -1
  185. package/dist/client/review/use-bar-position.js +0 -1
  186. package/dist/content-layer/plugins/internal/mcp/server/gateway/__tests__/fake-kv.js +0 -1
  187. package/dist/content-layer/plugins/internal/mcp/server/gateway/__tests__/secret-store-fixture.js +0 -1
  188. package/dist/server/__tests__/rbac-fixture.js +0 -1
  189. package/dist/server/__tests__/test-session.js +0 -1
@@ -1 +1 @@
1
- import{hashContentBytes as e}from"../../shared/utils/content-hash.js";import{inventoryKey as t}from"./view.js";import"./validate.js";const n=`route:`,r=`file:`,i=new TextEncoder;async function a(e,i){let a={};for(let[t,r]of e.routeBySlug)a[`${n}${t}`]=JSON.stringify([r.wildcardPrefix,r.sourcePath]);for(let t of e.servedStaticPaths)a[`static:${t}`]=``;for(let n of e.filePaths)a[`${r}${n}`]=JSON.stringify([i.get(n)??null,e.primaryRouteByFilePath.get(n)??null,await s(e.inventories.get(t(n,`anchor`))),await s(e.inventories.get(t(n,`subpath`)))]);return{unboundedInputs:JSON.stringify([3,e.localeContext.defaultLocale,e.localeContext.locales,[...e.redirects.keys()].sort(),[...e.redirectWildcards].sort(),[...e.wildcardSlugs].sort(),e.checkAnchors]),targets:a}}function o(e,t){let i=[],a=[],o=e=>{e.startsWith(r)?a.push(e.slice(5)):i.push(e.slice(e.startsWith(n)?6:7))};for(let[n,r]of Object.entries(t))e[n]!==r&&o(n);for(let n of Object.keys(e))Object.hasOwn(t,n)||o(n);return{changedSlugs:i,changedFilePaths:a}}async function s(t){if(t===void 0)return null;let n=`${t.exhaustive}\0${[...t.targets].join(`\0`)}`;return e(i.encode(n))}export{o as diffLinkCheckTargets,a as fingerprintLinkCheckView};
1
+ import{hashContentBytes as e}from"../../shared/utils/content-hash.js";import{inventoryKey as t}from"./view.js";import"./validate.js";const n=`route:`,r=`file:`,i=new TextEncoder;async function a(e,i){let a={};for(let[t,r]of e.routeBySlug)a[`${n}${t}`]=JSON.stringify([r.wildcardPrefix,r.sourcePath]);for(let t of e.servedStaticPaths)a[`static:${t}`]=``;for(let n of e.filePaths)a[`${r}${n}`]=JSON.stringify([i.get(n)??null,e.primaryRouteByFilePath.get(n)??null,await s(e.inventories.get(t(n,`anchor`))),await s(e.inventories.get(t(n,`subpath`)))]);return{unboundedInputs:JSON.stringify([4,e.localeContext.defaultLocale,e.localeContext.locales,[...e.redirects.keys()].sort(),[...e.redirectWildcards].sort(),[...e.wildcardSlugs].sort(),e.checkAnchors,e.anchorSeverity]),targets:a}}function o(e,t){let i=[],a=[],o=e=>{e.startsWith(r)?a.push(e.slice(5)):i.push(e.slice(e.startsWith(n)?6:7))};for(let[n,r]of Object.entries(t))e[n]!==r&&o(n);for(let n of Object.keys(e))Object.hasOwn(t,n)||o(n);return{changedSlugs:i,changedFilePaths:a}}async function s(t){if(t===void 0)return null;let n=`${t.exhaustive}\0${[...t.targets].join(`\0`)}`;return e(i.encode(n))}export{o as diffLinkCheckTargets,a as fingerprintLinkCheckView};
@@ -1 +1 @@
1
- import{collectL10nDirLocales as e,resolveLocaleContext as t}from"../../shared/utils/l10n.js";import{files as n,routes as r,staticFiles as i,targetInventories as a}from"../database/schema.js";import{toPublicVersionedSlug as o}from"../../shared/constants/versions.js";import{getVersionCatalog as s}from"../versions/resolve.js";import{buildLinkCheckView as c}from"./view.js";import{asc as l,eq as u}from"drizzle-orm";async function d(o){let{database:s}=o,[d,m,h,g]=await Promise.all([s.db.select({slug:r.slug,wildcardPrefix:r.wildcardPrefix,sourcePath:n.path,version:r.version,versionGroup:r.versionGroup}).from(r).leftJoin(n,u(r.sourceId,n.id)).orderBy(l(r.id)),s.db.select({filePath:n.path,kind:a.kind,exhaustive:a.exhaustive,targets:a.targets}).from(a).innerJoin(n,u(a.fileId,n.id)),s.db.select({path:n.path}).from(n),s.db.select({path:i.path}).from(i)]),_=h.map(e=>e.path),v=t(o.config.l10n,e(_));return c({routes:await p(s,d),filePaths:_,inventories:m,redirects:f(o.config),servedStaticPaths:g.map(e=>`/${e.path}`),localeContext:v,checkAnchors:o.config.linkChecker?.anchors?.hide!==!0})}function f(e){return Object.fromEntries(Object.entries(e.redirects??{}).map(([e,t])=>[e,t.to]))}async function p(e,t){let n=await s(e.db),r=new Set(t.map(e=>e.slug)),i=[];for(let e of t){if(!e.versionGroup||!e.version||(await n.groupInfo(e.versionGroup)).defaultVersion!==e.version)continue;let t=o(e.slug,e.versionGroup,e.version,!0);t!==e.slug&&!r.has(t)&&i.push({...e,slug:t})}return[...t,...i]}export{d as loadLinkCheckView};
1
+ import{collectL10nDirLocales as e,resolveLocaleContext as t}from"../../shared/utils/l10n.js";import{files as n,routes as r,staticFiles as i,targetInventories as a}from"../database/schema.js";import{toPublicVersionedSlug as o}from"../../shared/constants/versions.js";import{getVersionCatalog as s}from"../versions/resolve.js";import{buildLinkCheckView as c}from"./view.js";import{asc as l,eq as u}from"drizzle-orm";async function d(o){let{database:s}=o,[d,m,h,g]=await Promise.all([s.db.select({slug:r.slug,wildcardPrefix:r.wildcardPrefix,sourcePath:n.path,version:r.version,versionGroup:r.versionGroup}).from(r).leftJoin(n,u(r.sourceId,n.id)).orderBy(l(r.id)),s.db.select({filePath:n.path,kind:a.kind,exhaustive:a.exhaustive,targets:a.targets}).from(a).innerJoin(n,u(a.fileId,n.id)),s.db.select({path:n.path}).from(n),s.db.select({path:i.path}).from(i)]),_=h.map(e=>e.path),v=t(o.config.l10n,e(_));return c({routes:await p(s,d),filePaths:_,inventories:m,redirects:f(o.config),servedStaticPaths:g.map(e=>`/${e.path}`),localeContext:v,checkAnchors:o.config.linkChecker?.anchors?.hide!==!0,anchorSeverity:o.config.linkChecker?.anchors?.severity??`warning`})}function f(e){return Object.fromEntries(Object.entries(e.redirects??{}).map(([e,t])=>[e,t.to]))}async function p(e,t){let n=await s(e.db),r=new Set(t.map(e=>e.slug)),i=[];for(let e of t){if(!e.versionGroup||!e.version||(await n.groupInfo(e.versionGroup)).defaultVersion!==e.version)continue;let t=o(e.slug,e.versionGroup,e.version,!0);t!==e.slug&&!r.has(t)&&i.push({...e,slug:t})}return[...t,...i]}export{d as loadLinkCheckView};
@@ -1 +1 @@
1
- import{entities as e,files as t,linkRefs as n,problems as r}from"../database/schema.js";import{captureSnippet as i,splitSourceLines as a}from"../../shared/utils/capture-snippet.js";import{createProblem as o}from"../problems/codes.js";import{deleteOrphanedLinkProblemsTx as s,deleteProblemsForLinkRefsTx as c,insertProblemsTx as l,problemRow as u,replaceAllLinkProblemsTx as d}from"../database/problems.js";import{loadLinkCheckCheckpoint as f,writeLinkCheckCheckpointTx as p}from"../database/link-check-checkpoint.js";import{loadLinkCheckView as m}from"./load-view.js";import{validateLinkRefs as h}from"./validate.js";import{loadAffectedRefs as g}from"./delta.js";import{narrowRangeToTarget as _}from"../../shared/utils/narrow-range-to-target.js";import{diffLinkCheckTargets as v,fingerprintLinkCheckView as y}from"./fingerprint.js";import{and as b,asc as x,count as S,eq as C,gt as w}from"drizzle-orm";async function T(e){try{return await E(e)}catch(t){return e.logger?.warn(`Link check failed; stored link problems were left unchanged.`,{error:t instanceof Error?t.message:String(t)}),{ok:!1}}}async function E(e){let[t,n,r]=await Promise.all([m(e),A(e.database),f(e.database)]),i=await y(t,n);return r===null||r.unboundedInputs!==i.unboundedInputs?D(e,t,i):O(e,t,i,r)}async function D(e,t,n){let r=[],{judged:i,judgedThroughRefId:a}=await k(e.database,t,0,r),o=await M(r,e.readSourceFile);return await e.database.db.transaction(async e=>{await d(e,o),await p(e,{...n,judgedThroughRefId:a})}),{ok:!0,checked:i,broken:o.length,judged:i}}async function O(e,t,i,a){let{database:o}=e,u=v(a.targets,i.targets),d=await j(o),f=(await g(o,{entityIds:d,originFilePaths:u.changedFilePaths,changedSlugs:u.changedSlugs,changedFilePaths:u.changedFilePaths},t)).filter(e=>e.id<=a.judgedThroughRefId),m=h(f,t),_=await k(o,t,a.judgedThroughRefId,m),y=f.length+_.judged,b=u.changedSlugs.length>0||u.changedFilePaths.length>0;if(y>0||b){let t=await M(m,e.readSourceFile);await o.db.transaction(async e=>{await c(e,f.map(e=>e.id)),await l(e,t),await s(e),await p(e,{...i,judgedThroughRefId:_.judgedThroughRefId})})}let[[x],[w]]=await Promise.all([o.db.select({value:S()}).from(n),o.db.select({value:S()}).from(r).where(C(r.scope,`link`))]);return{ok:!0,checked:x?.value??0,broken:w?.value??0,judged:y}}async function k(e,t,r,i){let a=0,o=r;for(;;){let r=await e.db.select().from(n).where(w(n.id,o)).orderBy(x(n.id)).limit(1e4),s=r.at(-1);if(s===void 0)break;for(let e of h(r,t))i.push(e);a+=r.length,o=s.id}return{judged:a,judgedThroughRefId:o}}async function A(e){let n=await e.db.select({path:t.path,hash:t.hash}).from(t);return new Map(n.map(e=>[e.path,e.hash]))}async function j(t){return(await t.db.select({id:e.id}).from(e).where(b(C(e.status,`stale`),C(e.isCurrent,1)))).map(e=>e.id)}async function M(e,t){let n=/* @__PURE__ */ new Map;e.forEach(({ref:e,problem:t},r)=>{let i=t.location;if(i?.range===void 0)return;let a={index:r,raw:e.raw,location:i,range:i.range},o=n.get(e.filePath);o===void 0?n.set(e.filePath,[a]):o.push(a)});let r=/* @__PURE__ */ new Map;for(let[e,o]of n){let n=await t(e);if(n===null)continue;let s=a(n);for(let{index:e,raw:t,location:n,range:a}of o){let o=_(s,a,t);r.set(e,{...n,range:o,snippet:i(s,o)})}}return e.map(({ref:e,problem:t},n)=>{let i=r.get(n),a=i===void 0?t:{...t,location:i};return u(o(a),{scope:`link`,linkRefId:e.id})})}export{T as runBuildLinkCheck};
1
+ import{entities as e,files as t,linkRefs as n,problems as r}from"../database/schema.js";import{captureSnippet as i,splitSourceLines as a}from"../../shared/utils/capture-snippet.js";import{deleteOrphanedLinkProblemsTx as o,deleteProblemsForLinkRefsTx as s,insertProblemsTx as c,problemRow as l,replaceAllLinkProblemsTx as u}from"../database/problems.js";import{createProblem as d}from"../problems/codes.js";import{loadLinkCheckCheckpoint as f,writeLinkCheckCheckpointTx as p}from"../database/link-check-checkpoint.js";import{loadLinkCheckView as m}from"./load-view.js";import{validateLinkRefs as h}from"./validate.js";import{loadAffectedRefs as g}from"./delta.js";import{narrowRangeToTarget as _}from"../../shared/utils/narrow-range-to-target.js";import{diffLinkCheckTargets as v,fingerprintLinkCheckView as y}from"./fingerprint.js";import{and as b,asc as x,count as S,eq as C,gt as w}from"drizzle-orm";async function T(e){try{return await E(e)}catch(t){return e.logger?.warn(`Link check failed; stored link problems were left unchanged.`,{error:t instanceof Error?t.message:String(t)}),{ok:!1}}}async function E(e){let[t,n,r]=await Promise.all([m(e),A(e.database),f(e.database)]),i=await y(t,n);return r===null||r.unboundedInputs!==i.unboundedInputs?D(e,t,i):O(e,t,i,r)}async function D(e,t,n){let r=[],{judged:i,judgedThroughRefId:a}=await k(e.database,t,0,r),o=await M(r,e.readSourceFile);return await e.database.db.transaction(async e=>{await u(e,o),await p(e,{...n,judgedThroughRefId:a})}),{ok:!0,checked:i,broken:o.length,judged:i}}async function O(e,t,i,a){let{database:l}=e,u=v(a.targets,i.targets),d=await j(l),f=(await g(l,{entityIds:d,originFilePaths:u.changedFilePaths,changedSlugs:u.changedSlugs,changedFilePaths:u.changedFilePaths},t)).filter(e=>e.id<=a.judgedThroughRefId),m=h(f,t),_=await k(l,t,a.judgedThroughRefId,m),y=f.length+_.judged,b=u.changedSlugs.length>0||u.changedFilePaths.length>0;if(y>0||b){let t=await M(m,e.readSourceFile);await l.db.transaction(async e=>{await s(e,f.map(e=>e.id)),await c(e,t),await o(e),await p(e,{...i,judgedThroughRefId:_.judgedThroughRefId})})}let[[x],[w]]=await Promise.all([l.db.select({value:S()}).from(n),l.db.select({value:S()}).from(r).where(C(r.scope,`link`))]);return{ok:!0,checked:x?.value??0,broken:w?.value??0,judged:y}}async function k(e,t,r,i){let a=0,o=r;for(;;){let r=await e.db.select().from(n).where(w(n.id,o)).orderBy(x(n.id)).limit(1e4),s=r.at(-1);if(s===void 0)break;for(let e of h(r,t))i.push(e);a+=r.length,o=s.id}return{judged:a,judgedThroughRefId:o}}async function A(e){let n=await e.db.select({path:t.path,hash:t.hash}).from(t);return new Map(n.map(e=>[e.path,e.hash]))}async function j(t){return(await t.db.select({id:e.id}).from(e).where(b(C(e.status,`stale`),C(e.isCurrent,1)))).map(e=>e.id)}async function M(e,t){let n=/* @__PURE__ */ new Map;e.forEach(({ref:e,problem:t},r)=>{let i=t.location;if(i?.range===void 0)return;let a={index:r,raw:e.raw,location:i,range:i.range},o=n.get(e.filePath);o===void 0?n.set(e.filePath,[a]):o.push(a)});let r=/* @__PURE__ */ new Map;for(let[e,o]of n){let n=await t(e);if(n===null)continue;let s=a(n);for(let{index:e,raw:t,location:n,range:a}of o){let o=_(s,a,t);r.set(e,{...n,range:o,snippet:i(s,o)})}}return e.map(({ref:e,problem:t},n)=>{let i=r.get(n),a=i===void 0?t:{...t,location:i};return l(d(a),{scope:`link`,linkRefId:e.id})})}export{T as runBuildLinkCheck};
@@ -1 +1 @@
1
- import{delocalizeL10nPath as e}from"../../shared/utils/l10n.js";import{filePathToRouteSlug as t}from"../../shared/utils/routes/file-path-to-route-slug.js";import{computePathPrefixes as n}from"../../shared/utils/routes/compute-path-prefixes.js";import{isIndexPagePath as r,resolveRelativeSlug as i}from"../../shared/utils/routes/resolve-relative-slug.js";import{splitHash as a}from"../markdown/resolve/references.js";import"../plugins/internal/api-docs/server/shared.js";import{inventoryKey as o}from"./view.js";import{posix as s}from"node:path";function c(e,t){let n=[];for(let r of e){let e=r.targetKind===`slug`?u(r,t):f(r,t);e!==null&&n.push({ref:r,problem:e})}return n}function l(t,n){let r=[t.target,t.filePath],i=[],a=e=>{t.raw.startsWith(`/`)?i.push(`/${e}`):s.extname(e)===``&&i.push(m(t,e,n))};a(t.target);let o=e(t.target);return o!==void 0&&(r.push(o),a(o)),{filePaths:r,slugs:i}}function u(e,t){let n=d(e,e.target,t);return n===void 0?S(e,e.target):n}function d(e,t,n){let r=n.routeBySlug.get(t);if(r!==void 0)return g(e,r.sourcePath,n,t);if(n.redirects.has(t)||v(t,n)||n.servedStaticPaths.has(t))return null;let i=y(t,n);if(i===null)return;let a=b(n,i.sourcePath,`subpath`);return x(a,i.remainder)&&x(a,i.remainder.toLowerCase())?S(e,t):null}function f(t,n){let r=p(t,t.target,n);if(r!==void 0)return r;let i=e(t.target);if(i!==void 0){let{locale:e}=n.localeContext.splitLocaleFromPath(t.target),r=p(t,i,n,e);if(r!==void 0)return r}return S(t,h(t.target,n))}function p(e,t,n,r){let i=n.primaryRouteByFilePath.get(t);if(i!==void 0)return g(e,t,n,r===void 0?i:n.localeContext.toL10nSlug(i,r));if(n.filePaths.has(t))return null;if(e.raw.startsWith(`/`))return d(e,`/${t}`,n);if(s.extname(t)===``)return e.originPluginId===`internal.api-docs`?null:d(e,m(e,t,n),n)}function m(e,n,o){let s=o.primaryRouteByFilePath.get(e.filePath);if(s===void 0)return t(n);let c=a(e.raw).path.split(`?`,1)[0]??``;return i(c,s,r(e.filePath))}function h(n,r){let i=e(n);if(i===void 0)return t(n);let{locale:a}=r.localeContext.splitLocaleFromPath(n);return r.localeContext.toL10nSlug(t(i),a)}function g(e,t,n,r){if(!n.checkAnchors||e.kind===`image`||e.fragment===null||e.fragment===``||t===null)return null;let i=_(e.fragment);if(i.toLowerCase()===`top`)return null;let a=b(n,t,`anchor`);return x(a,e.fragment)&&x(a,i)?C(e,r):null}function _(e){try{return decodeURIComponent(e)}catch{return e}}function v(e,t){return t.redirectWildcards.some(t=>t===`/`||e===t||e.startsWith(`${t}/`))}function y(e,t){let r=new Set(n(e));for(let n of t.wildcardSlugs){if(!r.has(n))continue;let i=t.routeBySlug.get(n),a=n===`/`?e:e.slice(n.length);return{sourcePath:i?.sourcePath??null,remainder:a.replace(/^\/+/,``)}}return null}function b(e,t,n){return t===null?void 0:e.inventories.get(o(t,n))}function x(e,t){return e!==void 0&&e.exhaustive&&!e.targets.has(t)}function S(e,t){return w(e,`link/missing-target`,e.targetKind===`slug`?`Route "${e.target}" does not exist.`:`"${E(e)}" does not exist.`,T(t,e.fragment))}function C(e,t){return w(e,`link/missing-anchor`,`"#${e.fragment}" does not exist on "${E(e)}".`,T(t,e.fragment))}function w(e,t,n,r){return{code:t,message:n,location:{filePath:e.filePath,...e.range===null?{}:{range:e.range}},data:{raw:e.raw,target:e.target,fragment:e.fragment,kind:e.kind,title:e.title,url:r,...e.data??{}}}}function T(e,t){return t===null||t===``?e:`${e}#${t}`}function E(e){let t=a(e.raw).path;return t===``?e.target:t}export{l as unresolvedFilePathRefReads,c as validateLinkRefs};
1
+ import{delocalizeL10nPath as e}from"../../shared/utils/l10n.js";import{filePathToRouteSlug as t}from"../../shared/utils/routes/file-path-to-route-slug.js";import{computePathPrefixes as n}from"../../shared/utils/routes/compute-path-prefixes.js";import{isIndexPagePath as r,resolveRelativeSlug as i}from"../../shared/utils/routes/resolve-relative-slug.js";import{splitHash as a}from"../markdown/resolve/references.js";import"../plugins/internal/api-docs/server/shared.js";import{inventoryKey as o}from"./view.js";import{posix as s}from"node:path";function c(e,t){let n=[];for(let r of e){let e=r.targetKind===`slug`?u(r,t):f(r,t);e!==null&&n.push({ref:r,problem:e})}return n}function l(t,n){let r=[t.target,t.filePath],i=[],a=e=>{t.raw.startsWith(`/`)?i.push(`/${e}`):s.extname(e)===``&&i.push(m(t,e,n))};a(t.target);let o=e(t.target);return o!==void 0&&(r.push(o),a(o)),{filePaths:r,slugs:i}}function u(e,t){let n=d(e,e.target,t);return n===void 0?S(e,e.target):n}function d(e,t,n){let r=n.routeBySlug.get(t);if(r!==void 0)return g(e,r.sourcePath,n,t);if(n.redirects.has(t)||v(t,n)||n.servedStaticPaths.has(t))return null;let i=y(t,n);if(i===null)return;let a=b(n,i.sourcePath,`subpath`);return x(a,i.remainder)&&x(a,i.remainder.toLowerCase())?S(e,t):null}function f(t,n){let r=p(t,t.target,n);if(r!==void 0)return r;let i=e(t.target);if(i!==void 0){let{locale:e}=n.localeContext.splitLocaleFromPath(t.target),r=p(t,i,n,e);if(r!==void 0)return r}return S(t,h(t.target,n))}function p(e,t,n,r){let i=n.primaryRouteByFilePath.get(t);if(i!==void 0)return g(e,t,n,r===void 0?i:n.localeContext.toL10nSlug(i,r));if(n.filePaths.has(t))return null;if(e.raw.startsWith(`/`))return d(e,`/${t}`,n);if(s.extname(t)===``)return e.originPluginId===`internal.api-docs`?null:d(e,m(e,t,n),n)}function m(e,n,o){let s=o.primaryRouteByFilePath.get(e.filePath);if(s===void 0)return t(n);let c=a(e.raw).path.split(`?`,1)[0]??``;return i(c,s,r(e.filePath))}function h(n,r){let i=e(n);if(i===void 0)return t(n);let{locale:a}=r.localeContext.splitLocaleFromPath(n);return r.localeContext.toL10nSlug(t(i),a)}function g(e,t,n,r){if(!n.checkAnchors||e.kind===`image`||e.fragment===null||e.fragment===``||t===null)return null;let i=_(e.fragment);if(i.toLowerCase()===`top`)return null;let a=b(n,t,`anchor`);return x(a,e.fragment)&&x(a,i)?C(e,r,n.anchorSeverity):null}function _(e){try{return decodeURIComponent(e)}catch{return e}}function v(e,t){return t.redirectWildcards.some(t=>t===`/`||e===t||e.startsWith(`${t}/`))}function y(e,t){let r=new Set(n(e));for(let n of t.wildcardSlugs){if(!r.has(n))continue;let i=t.routeBySlug.get(n),a=n===`/`?e:e.slice(n.length);return{sourcePath:i?.sourcePath??null,remainder:a.replace(/^\/+/,``)}}return null}function b(e,t,n){return t===null?void 0:e.inventories.get(o(t,n))}function x(e,t){return e!==void 0&&e.exhaustive&&!e.targets.has(t)}function S(e,t){return w(e,`link/missing-target`,e.targetKind===`slug`?`Route "${e.target}" does not exist.`:`"${E(e)}" does not exist.`,T(t,e.fragment))}function C(e,t,n){return w(e,`link/missing-anchor`,`"#${e.fragment}" does not exist on "${E(e)}".`,T(t,e.fragment),n)}function w(e,t,n,r,i){return{code:t,message:n,...i===void 0?{}:{severity:i},location:{filePath:e.filePath,...e.range===null?{}:{range:e.range}},data:{raw:e.raw,target:e.target,fragment:e.fragment,kind:e.kind,title:e.title,url:r,...e.data??{}}}}function T(e,t){return t===null||t===``?e:`${e}#${t}`}function E(e){let t=a(e.raw).path;return t===``?e.target:t}export{l as unresolvedFilePathRefReads,c as validateLinkRefs};
@@ -1 +1 @@
1
- import{DEFAULT_LOCALE_PLACEHOLDER as e}from"../../shared/constants/l10n/defaults.js";import{LocaleContext as t}from"../../shared/utils/l10n.js";const n=new t(e,[]);function r(e){let t=/* @__PURE__ */ new Map,r=/* @__PURE__ */ new Map,i=/* @__PURE__ */ new Map,c=[];for(let n of e.routes)if(t.set(n.slug,{wildcardPrefix:n.wildcardPrefix,sourcePath:n.sourcePath}),n.wildcardPrefix&&c.push(n.slug),n.sourcePath!==null&&!r.has(n.sourcePath)&&r.set(n.sourcePath,n.slug),n.sourcePath!==null){let e=i.get(n.sourcePath);e===void 0?i.set(n.sourcePath,[n.slug]):e.push(n.slug)}c.sort((e,t)=>t.length-e.length);let l=/* @__PURE__ */ new Map;a(l,e.inventories);let u=/* @__PURE__ */ new Map,d=[];for(let[t,n]of Object.entries(e.redirects??{})){let e=o(t);e.endsWith(`*`)?d.push(s(e)):u.set(e,n)}return{localeContext:e.localeContext??n,routeBySlug:t,wildcardSlugs:c,primaryRouteByFilePath:r,routeSlugsBySourcePath:i,filePaths:new Set(e.filePaths),inventories:l,redirects:u,redirectWildcards:d,servedStaticPaths:new Set(e.servedStaticPaths??[]),checkAnchors:e.checkAnchors??!0}}function i(e,t){return`${e}\n${t}`}function a(e,t){for(let n of t){let t=i(n.filePath,n.kind),r=e.get(t);if(r===void 0){e.set(t,{exhaustive:n.exhaustive,targets:new Set(n.targets)});continue}r.exhaustive=r.exhaustive&&n.exhaustive;for(let e of n.targets)r.targets.add(e)}}function o(e){let t=(e.startsWith(`/`)?e:`/${e}`).replace(/(?<!\/)\/+$/,``);return t===``?`/`:t}function s(e){let t=e.slice(0,-1).replace(/(?<!\/)\/+$/,``);return t===``?`/`:t}export{r as buildLinkCheckView,i as inventoryKey,a as mergeInventoryRows};
1
+ import{DEFAULT_LOCALE_PLACEHOLDER as e}from"../../shared/constants/l10n/defaults.js";import{LocaleContext as t}from"../../shared/utils/l10n.js";const n=new t(e,[]);function r(e){let t=/* @__PURE__ */ new Map,r=/* @__PURE__ */ new Map,i=/* @__PURE__ */ new Map,c=[];for(let n of e.routes)if(t.set(n.slug,{wildcardPrefix:n.wildcardPrefix,sourcePath:n.sourcePath}),n.wildcardPrefix&&c.push(n.slug),n.sourcePath!==null&&!r.has(n.sourcePath)&&r.set(n.sourcePath,n.slug),n.sourcePath!==null){let e=i.get(n.sourcePath);e===void 0?i.set(n.sourcePath,[n.slug]):e.push(n.slug)}c.sort((e,t)=>t.length-e.length);let l=/* @__PURE__ */ new Map;a(l,e.inventories);let u=/* @__PURE__ */ new Map,d=[];for(let[t,n]of Object.entries(e.redirects??{})){let e=o(t);e.endsWith(`*`)?d.push(s(e)):u.set(e,n)}return{localeContext:e.localeContext??n,routeBySlug:t,wildcardSlugs:c,primaryRouteByFilePath:r,routeSlugsBySourcePath:i,filePaths:new Set(e.filePaths),inventories:l,redirects:u,redirectWildcards:d,servedStaticPaths:new Set(e.servedStaticPaths??[]),checkAnchors:e.checkAnchors??!0,anchorSeverity:e.anchorSeverity??`warning`}}function i(e,t){return`${e}\n${t}`}function a(e,t){for(let n of t){let t=i(n.filePath,n.kind),r=e.get(t);if(r===void 0){e.set(t,{exhaustive:n.exhaustive,targets:new Set(n.targets)});continue}r.exhaustive=r.exhaustive&&n.exhaustive;for(let e of n.targets)r.targets.add(e)}}function o(e){let t=(e.startsWith(`/`)?e:`/${e}`).replace(/(?<!\/)\/+$/,``);return t===``?`/`:t}function s(e){let t=e.slice(0,-1).replace(/(?<!\/)\/+$/,``);return t===``?`/`:t}export{r as buildLinkCheckView,i as inventoryKey,a as mergeInventoryRows};
@@ -1 +1 @@
1
- import{collectL10nDirLocales as e,resolveLocaleContext as t}from"../../shared/utils/l10n.js";import{matchGlob as n}from"../plugins/utils/glob.js";import{createTrackedRedoclyConfig as r}from"../config-deps.js";import{buildDataRefMarker as i,hashBlobContent as a}from"../materialization/data-ref.js";import{resolveDataRef as o,upsertBlob as s}from"../database/blobs.js";import{createEntityStore as c}from"../database/entity-store.js";import{createRouteQueryEvaluator as l}from"../plugins/utils/route-index.js";import{createSearchHandle as u}from"../search/store.js";import{createAudienceTagResolver as d}from"../markdown/resolve/audience-tag.js";import{createMarkdownService as f}from"../markdown/service.js";import{resolve as p}from"node:path";function m(m,h,g){let _,v,y,b,x;return function(S,C,w){let T=m.pluginRegistry.getById(S.pluginId);if(!T)throw Error(`Entity loader "${S.definition.id}" references missing plugin "${S.pluginId}".`);let{state:E}=m,D=r(m.config),O=D.config.access?.rbac,k=m.config.access?.rbac;(k!==_||v===void 0)&&(_=k,v=d(O,e=>m.logger.warn(e)));let A=v,j=D.config.l10n?.defaultLocale;(x===void 0||x.defaultLocale!==j)&&(b??=e(E.filesByPath.keys()),x={defaultLocale:j,locales:t({defaultLocale:j},b).locales});let M=x.locales,N=[],P=[],F=[];return(y?.state!==E||y.config!==m.config)&&(y={state:E,config:m.config,evaluator:l(E,m.config)}),{args:C??{},config:D.config,contentDir:m.contentDir,file:{absolutePath:p(m.contentDir,w),path:w,lastModifiedAt:E.filesByPath.get(w)?.lastModifiedAt??null},io:{...m.pluginIO,async glob(e){return F.push(e),n(E.filesByPath.keys(),e)}},entities:c({database:h,state:E,materialize:g,onEntityRead:e=>N.push(e),record:e=>P.push(e)}),search:u(h),logger:m.logger.child(`content-layer:entity:${S.definition.id}`),plugin:{id:T.id,version:T.version},pluginRegistry:m.pluginRegistry,resolveAudienceTag:A,routes:y.evaluator.index(e=>P.push(e)),markdown:f({state:E,resolveAudienceTag:A,contentLocales:M}),createBlobRef:async(e,t)=>{let n=t?.format??`json`,r=typeof e==`string`?e:Buffer.from(e).toString(`base64`),o=a(r);return await s(h,{key:o,content:r,size:r.length}),i(o,n)},resolveDataRef:e=>o(h,e),_trackedConfig:D,_loadedEntityKeys:N,_globPatterns:F,_routeQueries:P}}}export{m as createBuildTimeEntityLoaderContextFactory};
1
+ import{collectL10nDirLocales as e,resolveLocaleContext as t}from"../../shared/utils/l10n.js";import{matchGlob as n}from"../plugins/utils/glob.js";import{createTrackedRedoclyConfig as r}from"../config-deps.js";import{buildDataRefMarker as i,hashBlobContent as a}from"../materialization/data-ref.js";import{resolveDataRef as o,upsertBlob as s}from"../database/blobs.js";import{createEntityStore as c}from"../database/entity-store.js";import{createRouteQueryEvaluator as l}from"../plugins/utils/route-index.js";import{createAudienceTagResolver as u}from"../markdown/resolve/audience-tag.js";import{createMarkdownService as d}from"../markdown/service.js";import{createSearchHandle as f}from"../search/store.js";import{resolve as p}from"node:path";function m(m,h,g){let _,v,y,b,x;return function(S,C,w){let T=m.pluginRegistry.getById(S.pluginId);if(!T)throw Error(`Entity loader "${S.definition.id}" references missing plugin "${S.pluginId}".`);let{state:E}=m,D=r(m.config),O=D.config.access?.rbac,k=m.config.access?.rbac;(k!==_||v===void 0)&&(_=k,v=u(O));let A=v,j=D.config.l10n?.defaultLocale;(x===void 0||x.defaultLocale!==j)&&(b??=e(E.filesByPath.keys()),x={defaultLocale:j,locales:t({defaultLocale:j},b).locales});let M=x.locales,N=[],P=[],F=[];return(y?.state!==E||y.config!==m.config)&&(y={state:E,config:m.config,evaluator:l(E,m.config)}),{args:C??{},config:D.config,contentDir:m.contentDir,file:{absolutePath:p(m.contentDir,w),path:w,lastModifiedAt:E.filesByPath.get(w)?.lastModifiedAt??null},io:{...m.pluginIO,async glob(e){return F.push(e),n(E.filesByPath.keys(),e)}},entities:c({database:h,state:E,materialize:g,onEntityRead:e=>N.push(e),record:e=>P.push(e)}),search:f(h),logger:m.logger.child(`content-layer:entity:${S.definition.id}`),plugin:{id:T.id,version:T.version},pluginRegistry:m.pluginRegistry,resolveAudienceTag:A,routes:y.evaluator.index(e=>P.push(e)),markdown:d({state:E,resolveAudienceTag:A,contentLocales:M}),createBlobRef:async(e,t)=>{let n=t?.format??`json`,r=typeof e==`string`?e:Buffer.from(e).toString(`base64`),o=a(r);return await s(h,{key:o,content:r,size:r.length}),i(o,n)},resolveDataRef:e=>o(h,e),_trackedConfig:D,_loadedEntityKeys:N,_globPatterns:F,_routeQueries:P}}}export{m as createBuildTimeEntityLoaderContextFactory};
@@ -15,6 +15,7 @@ import type { SearchableResult } from '../plugins/types/search.js';
15
15
  import type { SearchHandle } from '../search/store.js';
16
16
  import type { EntityStore } from '../database/entity-store.js';
17
17
  import type { Logger } from '../../shared/logger.js';
18
+ import type { RbacScope } from '../../shared/rbac/types.js';
18
19
  export declare const ENTITY_LOADER_REFERENCE_KIND = "runtime.entity.loader";
19
20
  export declare const INLINE_ENTITY_REFERENCE_KIND = "runtime.entity.inline";
20
21
  export type EntityLoaderReference<TArgs = unknown> = {
@@ -88,6 +89,8 @@ export type MarkdownDoc = {
88
89
  title?: string;
89
90
  /** The page's one-line summary in `/llms.txt`, already in its LLM form. */
90
91
  description?: string;
92
+ /** Narrows the route's audience to the viewers it also admits (an operation's `x-rbac`). */
93
+ rbacScope?: RbacScope;
91
94
  };
92
95
  export type EntityMarkdownHandler<TResult = JsonValue> = (value: TResult, context: EntitySearchableContext) => Promise<string[] | MarkdownDoc[] | null> | string[] | MarkdownDoc[] | null;
93
96
  export type EntityLoaderOptions<TResult = JsonValue> = {
@@ -1 +1 @@
1
- import{OpenApiComponentWrap as e}from"./OpenApiComponentWrap.js";import*as t from"react";import{jsx as n,jsxs as r}from"react/jsx-runtime";import{Admonition as i}from"@redocly/theme/markdoc/components/Admonition/Admonition";import{MarkdownAdapterProvider as a,RedocSchema as o,StoreProvider as s,createMarkdocAdapter as c,markdocParser as l}from"@redocly/api-docs";function u(u){let{options:d,title:f,schemaResolved:p,schemaResolvedErrors:m,schema:h}=u,g=t.useMemo(()=>c(),[]);if(!h&&!p)return null;let _={openapi:`3.0.0`,info:{version:`1`,title:`json-schema`,description:``},paths:{},"x-root":p?.components?.schemas?.__root??h,components:{schemas:{...p?.components?.schemas}}};return/* @__PURE__ */ r(e,{"data-testid":`json-schema`,children:[f?/* @__PURE__ */ n(`h3`,{children:f}):null,/* @__PURE__ */ n(s,{options:{...d,specType:`openapi`,markdownParser:l},definition:_,children:/* @__PURE__ */ r(a,{value:g,children:[m?.length?/* @__PURE__ */ n(i,{name:`Problem in json-schema tag`,type:`danger`,children:m.map((e,t)=>/* @__PURE__ */ n(`div`,{children:e},t))}):null,/* @__PURE__ */ n(o,{pointer:`#/x-root`,disableDeepLinks:!0})]})})]})}export{u as JsonSchemaTag};
1
+ import{markdocComponents as e}from"./markdoc-components.js";import{OpenApiComponentWrap as t}from"./OpenApiComponentWrap.js";import n from"@redocly/markdoc";import*as r from"react";import{jsx as i,jsxs as a}from"react/jsx-runtime";import{Admonition as o}from"@redocly/theme/markdoc/components/Admonition/Admonition";import{MarkdownAdapterProvider as s,RedocSchema as c,StoreProvider as l,createMarkdocAdapter as u,markdocParser as d}from"@redocly/api-docs";function f(f){let{options:p,title:m,schemaResolved:h,schemaResolvedErrors:g,schema:_}=f,v=r.useMemo(()=>u({nodes:{link:{...n.nodes.link,render:`MarkdownLink`}},components:{MarkdownLink:e.MarkdownLink}}),[]);if(!_&&!h)return null;let y={openapi:`3.0.0`,info:{version:`1`,title:`json-schema`,description:``},paths:{},"x-root":h?.components?.schemas?.__root??_,components:{schemas:{...h?.components?.schemas}}};return/* @__PURE__ */ a(t,{"data-testid":`json-schema`,children:[m?/* @__PURE__ */ i(`h3`,{children:m}):null,/* @__PURE__ */ i(l,{options:{...p,specType:`openapi`,markdownParser:d},definition:y,children:/* @__PURE__ */ a(s,{value:v,children:[g?.length?/* @__PURE__ */ i(o,{name:`Problem in json-schema tag`,type:`danger`,children:g.map((e,t)=>/* @__PURE__ */ i(`div`,{children:e},t))}):null,/* @__PURE__ */ i(c,{pointer:`#/x-root`,disableDeepLinks:!0})]})})]})}export{f as JsonSchemaTag};
@@ -1,3 +1,3 @@
1
- const e=/\[!code\s+(\+\+|--|highlight|hl|focus|error|warning|word:((?:\\.|[^:\]])+))(?::(\d+))?\]/g,t=/\[\\!code/g,n=[[`{/*`,`*/}`],[`/*`,`*/`],[`<!--`,`-->`]],r=/(?:^|\s)(\/\/|#|--|;{1,2}|%{1,2})/g,i={"++":[`diff add`,`has-diff`],"--":[`diff remove`,`has-diff`],error:[`highlighted error`,`has-highlighted`],focus:[`focused`,`has-focused`],highlight:[`highlighted`,`has-highlighted`],hl:[`highlighted`,`has-highlighted`],warning:[`highlighted warning`,`has-highlighted`]},a=`highlighted-word`;function o(e,t){for(let[r,i]of n){let n=e.lastIndexOf(r,t),a=n===-1?-1:e.indexOf(i,t);if(n!==-1&&a!==-1)return{start:n,open:r,body:e.slice(n+r.length,a),close:i}}let i;for(let n of e.slice(0,t).matchAll(r)){let t=n.index+n[0].length-n[1].length;i={start:t,open:n[1],body:e.slice(t+n[1].length),close:``}}return i}function s(e,t,n){let r=e.slice(0,t.start);if(n.trim()===``){let e=r.trimEnd();return e===``?void 0:e}let i=t.close?` ${t.close}`:``;return`${r}${t.open}${n.trimEnd()}${i}`}function c(e,t){let n=[],r=0;for(let t of e)n.push(r),r+=t.length+1;let i=[];for(let{word:r,from:o,count:s}of t)for(let t=o;t<Math.min(o+s,e.length+1);t++){let o=e[t-1],s=o.indexOf(r);for(;s!==-1;){let e=n[t-1]+s;i.push({className:a,range:[e,e+r.length]}),s=o.indexOf(r,s+r.length)}}return i}function l(n){let r=[],a=[],l=/* @__PURE__ */ new Set,u=[];for(let c of n.split(`
2
- `)){let n=[...c.matchAll(e)],d=n.length?o(c,n[0].index):void 0;if(!d||n.some(e=>e.index<d.start)){r.push(c.replace(t,`[!code`));continue}let f=r.length+1;for(let[,e,t,r]of n){if(t!==void 0){u.push({word:t.replace(/\\(.)/g,`$1`),from:f,count:r?Number(r):1/0});continue}let[n,o]=i[e],s=r?Number(r):1;a.push({className:n,lines:s===1?f:[f,f+s-1]}),l.add(o)}let p=s(c,d,d.body.replace(e,``));p!==void 0&&r.push(p.replace(t,`[!code`))}return{code:r.join(`
3
- `),codeClassNames:[...l],decorations:[...a,...c(r,u)]}}function u(e){let t=[];for(let n of e.split(`,`)){let e=n.trim().match(/^(\d+)(?:-(\d+))?$/);if(!e)continue;let r=Number(e[1]),i=e[2]?Number(e[2]):r;t.push({className:`highlighted`,lines:r===i?r:[r,i]})}return t}function d(e,t){let n=[],r=/* @__PURE__ */ new Set,i=e.match(/\{([\d,\s-]+)\}/)?.[1]??(/^[\d,\s-]+$/.test(e)?e:``);i&&n.push(...u(i));for(let[,r]of e.matchAll(/\/((?:\\.|[^/])+)\//g)){let e=r.replace(/\\(.)/g,`$1`),i=t.indexOf(e);for(;i!==-1;)n.push({className:a,range:[i,i+e.length]}),i=t.indexOf(e,i+e.length)}return n.length&&r.add(`has-highlighted`),{codeClassNames:[...r],decorations:n}}export{d as parseHighlightMeta,l as parseNotation};
1
+ import{parseCodeHighlightNotationLine as e}from"@redocly/theme/core/utils";const t={"++":[`diff add`,`has-diff`],"--":[`diff remove`,`has-diff`],error:[`highlighted error`,`has-highlighted`],focus:[`focused`,`has-focused`],highlight:[`highlighted`,`has-highlighted`],hl:[`highlighted`,`has-highlighted`],warning:[`highlighted warning`,`has-highlighted`]},n=`highlighted-word`;function r(e,t){let r=[],i=0;for(let t of e)r.push(i),i+=t.length+1;let a=[];for(let{word:i,from:o,count:s}of t)for(let t=o;t<Math.min(o+s,e.length+1);t++){let o=e[t-1],s=o.indexOf(i);for(;s!==-1;){let e=r[t-1]+s;a.push({className:n,range:[e,e+i.length]}),s=o.indexOf(i,s+i.length)}}return a}function i(n){let i=[],a=[],o=/* @__PURE__ */ new Set,s=[];for(let r of n.split(`
2
+ `)){let{text:n,notations:c}=e(r),l=i.length+1;for(let{kind:e,word:n,count:r}of c){if(n!==void 0){s.push({word:n,from:l,count:r??1/0});continue}let[i,c]=t[e],u=r??1;a.push({className:i,lines:u===1?l:[l,l+u-1]}),o.add(c)}n!==void 0&&i.push(n)}return{code:i.join(`
3
+ `),codeClassNames:[...o],decorations:[...a,...r(i,s)]}}function a(e){let t=[];for(let n of e.split(`,`)){let e=n.trim().match(/^(\d+)(?:-(\d+))?$/);if(!e)continue;let r=Number(e[1]),i=e[2]?Number(e[2]):r;t.push({className:`highlighted`,lines:r===i?r:[r,i]})}return t}function o(e,t){let r=[],i=/* @__PURE__ */ new Set,o=e.match(/\{([\d,\s-]+)\}/)?.[1]??(/^[\d,\s-]+$/.test(e)?e:``);o&&r.push(...a(o));for(let[,i]of e.matchAll(/\/((?:\\.|[^/])+)\//g)){let e=i.replace(/\\(.)/g,`$1`),a=t.indexOf(e);for(;a!==-1;)r.push({className:n,range:[a,a+e.length]}),a=t.indexOf(e,a+e.length)}return r.length&&i.add(`has-highlighted`),{codeClassNames:[...i],decorations:r}}export{o as parseHighlightMeta,i as parseNotation};
@@ -1,4 +1,4 @@
1
- import{withPathPrefix as e,withPathPrefixForSrcSet as t}from"../../../shared/path-prefix.js";import{isRouterPath as n}from"../../../client/utils/routes/is-router-path.js";import{resolveRelativeHref as r}from"../../../client/utils/routes/resolve-relative-href.js";import*as i from"react";import a from"styled-components";import{Link as o,useLocation as s}from"react-router";import{dynamic as c}from"@redocly/theme/core/utils";import{jsx as l}from"react/jsx-runtime";import{CodeSnippetProvider as u,PageActionsContext as d}from"@redocly/theme/core/contexts";import{Accordion as ee}from"@redocly/theme/markdoc/components/Accordion/Accordion";import{AccordionGroup as f}from"@redocly/theme/markdoc/components/Accordion/AccordionGroup";import{Admonition as p}from"@redocly/theme/markdoc/components/Admonition/Admonition";import{Card as m}from"@redocly/theme/markdoc/components/Cards/Card";import{Cards as h}from"@redocly/theme/markdoc/components/Cards/Cards";import{CodeBlock as g}from"@redocly/theme/markdoc/components/CodeBlock/CodeBlock";import{CodeGroup as _}from"@redocly/theme/markdoc/components/CodeGroup/CodeGroup";import{CodeStep as te}from"@redocly/theme/markdoc/components/CodeWalkthrough/CodeStep";import{CodeToggle as ne}from"@redocly/theme/markdoc/components/CodeWalkthrough/CodeToggle";import{CodeWalkthrough as re}from"@redocly/theme/markdoc/components/CodeWalkthrough/CodeWalkthrough";import{ConnectMCP as v}from"@redocly/theme/markdoc/components/ConnectMCP/ConnectMCP";import{Diagram as y}from"@redocly/theme/markdoc/components/Diagram/Diagram";import{Experiment as b}from"@redocly/theme/components/Experiment/Experiment";import{Variant as x}from"@redocly/theme/components/Experiment/Variant";import{Heading as S}from"@redocly/theme/markdoc/components/Heading/Heading";import{Input as C}from"@redocly/theme/markdoc/components/CodeWalkthrough/Input";import{Icon as w}from"@redocly/theme/markdoc/components/Icon/Icon";import{Image as T}from"@redocly/theme/markdoc/components/Image/Image";import{InlineSvg as E}from"@redocly/theme/markdoc/components/InlineSvg/InlineSvg";import{LoginButton as D}from"@redocly/theme/markdoc/components/LoginButton/LoginButton";import{MarkdocExample as O}from"@redocly/theme/markdoc/components/MarkdocExample/MarkdocExample";import{NumberedItem as k}from"@redocly/theme/markdoc/components/NumberedList/NumberedItem";import{NumberedList as A}from"@redocly/theme/markdoc/components/NumberedList/NumberedList";import{Prompt as j}from"@redocly/theme/markdoc/components/Prompt/Prompt";import{Tabs as M}from"@redocly/theme/markdoc/components/Tabs/Tabs";import{TabItemFragment as N}from"@redocly/theme/markdoc/components/Tabs/TabItemFragment";import{Markdown as P}from"@redocly/theme/components/Markdown/Markdown";import{SearchAiCitation as F}from"@redocly/theme/components/Search/SearchAiCitation";import I from"@redocly/markdoc/dist/react.js";import{useL10nHref as ie}from"virtual:realm-runtime";import{userMarkdocComponents as L}from"virtual:realm-markdoc-components";const R=t=>typeof t==`string`?e(t):void 0,z=e=>typeof e==`string`?t(e):void 0,B=e=>/^(https?:|\/\/)/.test(e);function V(e){let t=ie(),{pathname:i}=s();if(!e||B(e)||e.startsWith(`mailto:`))return{kind:`external`,href:e};let a=r(e,i);return n(a)?{kind:`page`,href:t(a)}:{kind:`file`,href:a}}function H({href:t,children:n,...r}){let i=V(t);if(i.kind===`external`){let e=t&&B(t)?`_blank`:void 0;return/* @__PURE__ */ l(`a`,{href:t,target:e,...r,rel:typeof r.rel==`string`?r.rel:`noreferrer`,children:n})}return i.kind===`file`?/* @__PURE__ */ l(`a`,{href:e(i.href),...r,children:n}):/* @__PURE__ */ l(o,{to:i.href,...r,children:n})}function U(e){return function({href:t,...n}){return/* @__PURE__ */ l(e,{...n,href:V(t).href})}}const{MarkdownLink:W,...G}=L;function K({src:e,srcSet:t,...n}){return/* @__PURE__ */ l(T,{...n,src:R(e),srcSet:z(t)})}let q=Promise.resolve();function J(){return q}function Y(e,t){return new Promise(n=>{t&&(e.addEventListener(`load`,()=>n()),e.addEventListener(`error`,()=>n())),document.body.appendChild(e),t||n()})}function X({src:e,children:t,...n}){return i.useEffect(()=>{let r=typeof e==`string`?e:void 0;if(r&&document.querySelector(`script[src="${CSS.escape(r)}"]`))return;let a=document.createElement(`script`);r?a.src=r:t!=null&&(a.textContent=i.Children.toArray(t).join(``));for(let[e,t]of Object.entries(n))(typeof t==`string`||typeof t==`boolean`)&&a.setAttribute(e,String(t));r&&n.async?Y(a,!0):q=q.then(()=>Y(a,!!r))},[e]),null}function Z({image:e,icon:t,...n}){return/* @__PURE__ */ l(m,{...n,image:R(e),icon:R(t)})}const ae=a.span.attrs({role:`alert`,"data-component-name":`MarkdocInlineError`})`
1
+ import{withPathPrefix as e,withPathPrefixForSrcSet as t}from"../../../shared/path-prefix.js";import{isRouterPath as n}from"../../../client/utils/routes/is-router-path.js";import{resolveRelativeHref as r}from"../../../client/utils/routes/resolve-relative-href.js";import*as i from"react";import a from"styled-components";import{Link as o,useLocation as s}from"react-router";import{dynamic as c}from"@redocly/theme/core/utils";import{jsx as l}from"react/jsx-runtime";import{CodeSnippetProvider as u,PageActionsContext as ee}from"@redocly/theme/core/contexts";import{Accordion as te}from"@redocly/theme/markdoc/components/Accordion/Accordion";import{AccordionGroup as d}from"@redocly/theme/markdoc/components/Accordion/AccordionGroup";import{Admonition as f}from"@redocly/theme/markdoc/components/Admonition/Admonition";import{Card as p}from"@redocly/theme/markdoc/components/Cards/Card";import{Cards as m}from"@redocly/theme/markdoc/components/Cards/Cards";import{CodeBlock as h}from"@redocly/theme/markdoc/components/CodeBlock/CodeBlock";import{CodeGroup as g}from"@redocly/theme/markdoc/components/CodeGroup/CodeGroup";import{CodeStep as _}from"@redocly/theme/markdoc/components/CodeWalkthrough/CodeStep";import{CodeToggle as v}from"@redocly/theme/markdoc/components/CodeWalkthrough/CodeToggle";import{CodeWalkthrough as y}from"@redocly/theme/markdoc/components/CodeWalkthrough/CodeWalkthrough";import{ConnectMCP as ne}from"@redocly/theme/markdoc/components/ConnectMCP/ConnectMCP";import{Diagram as re}from"@redocly/theme/markdoc/components/Diagram/Diagram";import{Experiment as ie}from"@redocly/theme/components/Experiment/Experiment";import{Variant as b}from"@redocly/theme/components/Experiment/Variant";import{Heading as x}from"@redocly/theme/markdoc/components/Heading/Heading";import{Input as S}from"@redocly/theme/markdoc/components/CodeWalkthrough/Input";import{Icon as C}from"@redocly/theme/markdoc/components/Icon/Icon";import{Image as w}from"@redocly/theme/markdoc/components/Image/Image";import{InlineSvg as T}from"@redocly/theme/markdoc/components/InlineSvg/InlineSvg";import{LoginButton as E}from"@redocly/theme/markdoc/components/LoginButton/LoginButton";import{MarkdocExample as D}from"@redocly/theme/markdoc/components/MarkdocExample/MarkdocExample";import{NumberedItem as O}from"@redocly/theme/markdoc/components/NumberedList/NumberedItem";import{NumberedList as k}from"@redocly/theme/markdoc/components/NumberedList/NumberedList";import{Prompt as A}from"@redocly/theme/markdoc/components/Prompt/Prompt";import{Tabs as j}from"@redocly/theme/markdoc/components/Tabs/Tabs";import{TabItemFragment as M}from"@redocly/theme/markdoc/components/Tabs/TabItemFragment";import{Markdown as N}from"@redocly/theme/components/Markdown/Markdown";import{SearchAiCitation as P}from"@redocly/theme/components/Search/SearchAiCitation";import F from"@redocly/markdoc/dist/react.js";import{useL10nHref as I}from"virtual:realm-runtime";import{userMarkdocComponents as L}from"virtual:realm-markdoc-components";const R=t=>typeof t==`string`?e(t):void 0,ae=e=>typeof e==`string`?t(e):void 0,z=e=>/^(https?:|\/\/)/.test(e);function B(e){let t=I(),{pathname:i}=s();if(!e||z(e)||e.startsWith(`mailto:`))return{kind:`external`,href:e};let a=r(e,i);return n(a)?{kind:`page`,href:t(a)}:{kind:`file`,href:a}}function V({href:t,children:n,...r}){let i=B(t);if(i.kind===`external`){let e=t&&z(t)?`_blank`:void 0;return/* @__PURE__ */ l(`a`,{href:t,target:e,...r,rel:typeof r.rel==`string`?r.rel:`noreferrer`,children:n})}return i.kind===`file`?/* @__PURE__ */ l(`a`,{href:e(i.href),...r,children:n}):/* @__PURE__ */ l(o,{to:i.href,...r,children:n})}function H(e){return function({href:t,...n}){return/* @__PURE__ */ l(e,{...n,href:B(t).href})}}const{MarkdownLink:U,...W}=L;function G({src:e,srcSet:t,...n}){return/* @__PURE__ */ l(w,{...n,src:R(e),srcSet:ae(t)})}let K=Promise.resolve();function q(){return K}function J(e,t){return new Promise(n=>{t&&(e.addEventListener(`load`,()=>n()),e.addEventListener(`error`,()=>n())),document.body.appendChild(e),t||n()})}function Y({src:e,children:t,...n}){return i.useEffect(()=>{let r=typeof e==`string`?e:void 0;if(r&&document.querySelector(`script[src="${CSS.escape(r)}"]`))return;let a=document.createElement(`script`);r?a.src=r:t!=null&&(a.textContent=i.Children.toArray(t).join(``));for(let[e,t]of Object.entries(n))(typeof t==`string`||typeof t==`boolean`)&&a.setAttribute(e,String(t));r&&n.async?J(a,!0):K=K.then(()=>J(a,!!r))},[e]),null}function X({image:e,icon:t,...n}){return/* @__PURE__ */ l(p,{...n,image:R(e),icon:R(t)})}const oe=a.span.attrs({role:`alert`,"data-component-name":`MarkdocInlineError`})`
2
2
  display: inline;
3
3
  padding: 0 var(--spacing-xs);
4
4
  border: var(--admonition-danger-border);
@@ -6,4 +6,4 @@ import{withPathPrefix as e,withPathPrefixForSrcSet as t}from"../../../shared/pat
6
6
  background-color: var(--admonition-danger-bg-color);
7
7
  color: var(--admonition-danger-text-color);
8
8
  font-size: var(--font-size-sm);
9
- `,Q={Accordion:ee,AccordionGroup:f,Admonition:p,AiCitation:F,Card:Z,Cards:h,CodeBlock:g,CodeGroup:_,CodeStep:te,CodeToggle:ne,CodeWalkthrough:re,ConnectMCP:v,Diagram:y,Experiment:b,ExperimentVariant:x,Heading:S,HtmlScript:X,Icon:w,Image:K,InlineSvg:E,Input:C,JsonExample:c(()=>import(`./OpenapiTagComponents.js`).then(e=>e.JsonExample)),JsonSchema:c(()=>import(`./JsonSchemaTag.js`).then(e=>e.JsonSchemaTag)),LoginButton:D,MarkdocExample:O,MarkdocInlineError:ae,NumberedItem:k,NumberedList:A,OpenApiCodeSample:c(()=>import(`./OpenApiEmbedTags.js`).then(e=>e.OpenApiCodeSample)),OpenApiExample:c(()=>import(`./OpenApiEmbedTags.js`).then(e=>e.OpenApiExample)),OpenApiResponseSample:c(()=>import(`./OpenApiEmbedTags.js`).then(e=>e.OpenApiResponseSample)),Prompt:j,ReplayOpenApi:c(()=>import(`./ReplayOpenApiTag.js`).then(e=>e.ReplayOpenApiTag)),Tabs:M,TabItemFragment:N,Link:H,...G,MarkdownLink:W===void 0?H:U(W)},oe=I;function $(e,t=Q){return/* @__PURE__ */ l(u,{children:oe(e,i,{components:t})})}function se({ast:e,components:t=Q,withPageActions:n}){let r=i.useMemo(()=>$(e,t),[e,t]);return/* @__PURE__ */ l(d.Provider,{value:n??null,children:/* @__PURE__ */ l(P,{children:r})})}export{X as HtmlScript,Z as MarkdocCard,K as MarkdocImage,H as MarkdocLink,se as MarkdocRenderer,Q as markdocComponents,$ as renderMarkdocAst,J as waitForMarkdownScripts};
9
+ `,Z={Accordion:te,AccordionGroup:d,Admonition:f,AiCitation:P,Card:X,Cards:m,CodeBlock:h,CodeGroup:g,CodeStep:_,CodeToggle:v,CodeWalkthrough:y,ConnectMCP:ne,Diagram:re,Experiment:ie,ExperimentVariant:b,Heading:x,HtmlScript:Y,Icon:C,Image:G,InlineSvg:T,Input:S,JsonExample:c(()=>import(`./OpenapiTagComponents.js`).then(e=>e.JsonExample)),JsonSchema:c(()=>import(`./JsonSchemaTag.js`).then(e=>e.JsonSchemaTag)),LoginButton:E,MarkdocExample:D,MarkdocInlineError:oe,NumberedItem:O,NumberedList:k,OpenApiCodeSample:c(()=>import(`./OpenApiEmbedTags.js`).then(e=>e.OpenApiCodeSample)),OpenApiExample:c(()=>import(`./OpenApiEmbedTags.js`).then(e=>e.OpenApiExample)),OpenApiResponseSample:c(()=>import(`./OpenApiEmbedTags.js`).then(e=>e.OpenApiResponseSample)),Prompt:A,ReplayOpenApi:c(()=>import(`./ReplayOpenApiTag.js`).then(e=>e.ReplayOpenApiTag)),Tabs:j,TabItemFragment:M,Link:V,...W,MarkdownLink:U===void 0?V:H(U)},Q=F;function $(e,t=Z){return/* @__PURE__ */ l(u,{children:Q(e,i,{components:t})})}function se({ast:e,components:t=Z,withPageActions:n}){let r=i.useMemo(()=>$(e,t),[e,t]);return/* @__PURE__ */ l(ee.Provider,{value:n??null,children:/* @__PURE__ */ l(N,{children:r})})}function ce({ast:e,components:t}){return i.useMemo(()=>/* @__PURE__ */ l(u,{children:le(e).map((e,n)=>/* @__PURE__ */ l(N,{as:`div`,children:typeof e==`string`?/* @__PURE__ */ l(`p`,{children:e}):Q(e,i,{components:t})},n))}),[e,t])}function le(e){return(Array.isArray(e)?e:[e]).flatMap(e=>e===null||e===``?[]:ue(e)?e.children:[e])}function ue(e){let t=e;return typeof e==`object`&&t?.$$mdtype===`Tag`&&t.name===`article`}export{Y as HtmlScript,ce as MarkdocBlocks,X as MarkdocCard,G as MarkdocImage,V as MarkdocLink,se as MarkdocRenderer,Z as markdocComponents,$ as renderMarkdocAst,q as waitForMarkdownScripts};
@@ -16,12 +16,8 @@ export type AudienceTagResolver = (path: string) => Promise<string | null>;
16
16
  * Absent config (`parseRbacConfigData` returns `null`) -> every path
17
17
  * resolves to `null` (no tag), preserving today's fully-public behavior for
18
18
  * every project that hasn't configured RBAC.
19
- *
20
- * `warn`, when given, is called once per path that matches no rule at all —
21
- * an unsatisfiable-by-anyone audience, almost always a missing catch-all
22
- * `'**'` rule rather than an intentional lockout.
23
19
  */
24
- export declare function createAudienceTagResolver(rawRbacConfig: unknown, warn?: (message: string) => void): AudienceTagResolver;
20
+ export declare function createAudienceTagResolver(rawRbacConfig: unknown): AudienceTagResolver;
25
21
  /**
26
22
  * The `{tag -> descriptor}` table for a raw `access.rbac` config value and a
27
23
  * concrete asset-path set — `compileAssetAudiences` behind the same raw-config
@@ -1 +1 @@
1
- import{compileAssetAudiences as e,compileRbacMatcher as t,deriveAssetTag as n,parseRbacConfigData as r,resolveAssetTagInputs as i}from"../../../shared/rbac/engine.js";function a(e,a){let o=r(e);if(!o)return async()=>null;let s=t(o);return async e=>{let t=i(s,e);return t===null?null:(t.pattern===``&&a?.(`rbac config: "${e}" matches no content rule — it will be unreachable by any viewer. Add a catch-all "**" rule if this asset should be public.`),n(t))}}async function o(n,i){let a=r(n);return a?e(t(a),i):null}export{o as compileAssetAudienceTable,a as createAudienceTagResolver};
1
+ import{compileAssetAudiences as e,compileRbacMatcher as t,deriveAssetTag as n,parseRbacConfigData as r,resolveAssetTagInputs as i}from"../../../shared/rbac/engine.js";function a(e){let a=r(e);if(!a)return async()=>null;let o=t(a);return async e=>{let t=i(o,e);return t===null?null:n(t)}}async function o(n,i){let a=r(n);return a?e(t(a),i):null}export{o as compileAssetAudienceTable,a as createAudienceTagResolver};
@@ -1 +1 @@
1
- import{isObject as e}from"../../../../shared/utils/is-object.js";import{toContainedContentPath as t}from"../../../ingest/scan.js";import{markdocNodeProblem as n}from"../../utils/node-source-range.js";import{resolveResolverTarget as r}from"./context-paths.js";import{join as i}from"node:path";async function a(e,t){let{bundle:n,createConfig:r,Source:a}=await import(`@redocly/openapi-core`),s=JSON.parse(JSON.stringify({openapi:`3.1.0`,components:{schemas:{__root:t}}})),c=i(e.contentDir,e.sourceFilePath),l=await n({config:await r({}),doc:{source:new a(c,``),parsed:s}}),u=l.bundle.parsed,d=u.components?.schemas,f=d?.__root?.$ref,p=typeof f==`string`?f.split(`/`).at(-1):void 0;return{oas:u,schema:p?d?.[p]:d?.__root,errors:(l.problems??[]).slice(0,1).map(e=>e.message),fileDeps:o(l.fileDependencies,e.contentDir,c)}}function o(e,n,r){if(e===void 0)return[];let i=/* @__PURE__ */ new Set;for(let a of e){let e=t(n,a);a!==r&&e!==null&&i.add(e)}return[...i].sort()}function s(e,t=[]){return e.length>0||t.length>0?{entityDeps:e.map(e=>({kind:`file`,path:e})),problems:t}:null}function c(e,t){let{node:r,attributeName:i}=e;return r.attributes[`${i}ResolvedErrors`]=t,e.logger?.warn(`${r.tag} in ${e.sourceFilePath}: ${t[0]}`),n(r,t[0],e.sourceFilePath)}async function l(t){let{node:n,attributeName:r}=t,i=n.attributes[r];if(!e(i))return null;let{oas:o,errors:l,fileDeps:u}=await a(t,i);return n.attributes[`${r}Resolved`]=o,l.length>0?s(u,[c(t,l)]):s(u)}async function u(t){let{node:n,attributeName:r}=t,i=n.attributes[r];if(!e(i)||n.attributes.value!==void 0)return null;let{oas:o,schema:l,errors:u,fileDeps:d}=await a(t,i);if(u.length>0)return s(d,[c(t,u)]);let f=n.attributes.mode,p=await import(`openapi-sampler`);try{n.attributes[`${r}Resolved`]=p.sample(l,{...f===`read`?{skipWriteOnly:!0}:void 0,...f===`write`?{skipReadOnly:!0}:void 0},o)}catch(e){return s(d,[c(t,[`Failed to generate a sample from the schema: ${e?.message??e}`])])}return s(d)}async function d(t){let{node:n,attributeName:i}=t,a=n.attributes[i],o=e=>({problems:[c(t,[e])]});if(a!==void 0&&n.attributes.schema!==void 0)return o(`The "schema" and "value" attributes are mutually exclusive, use only one.`);if(a===void 0)return n.attributes.schema===void 0?o(`The tag requires a "schema" or "value" attribute.`):null;let s=e(a)?a.$ref:void 0;if(typeof s!=`string`)return n.attributes[`${i}Resolved`]=a,null;let[l,u]=s.split(`#`),d=l?r(t,l):null;if(d===null||t.io===void 0)return o(`Invalid $ref "${s}": the path must stay inside the content directory.`);if(!await t.io.exists(d.absolutePath))return o(`Invalid $ref: no such file ${d.contentPath}`);let p=await t.io.readFile(d.absolutePath),m=[{kind:`file`,path:d.contentPath}],h;try{h=(await import(`js-yaml`)).load(p)}catch(e){return{entityDeps:m,...o(`File ${d.contentPath} must be valid JSON or YAML: ${e.message}`)}}let g=u?f(h,u):h;return u&&g===void 0?{entityDeps:m,...o(`Invalid $ref: ${d.contentPath} has no value at #${u}`)}:(n.attributes[`${i}Resolved`]=g,{entityDeps:m})}function f(t,n){let r=t;for(let t of n.split(`/`).slice(+!!n.startsWith(`/`))){let n=t.replaceAll(`~1`,`/`).replaceAll(`~0`,`~`);if(Array.isArray(r))r=r[Number(n)];else if(e(r))r=r[n];else return}return r}export{d as resolveJsonExampleRefAttribute,l as resolveJsonSchemaRefAttribute,u as resolveSampleFromJsonSchemaAttribute};
1
+ import{isObject as e}from"../../../../shared/utils/is-object.js";import{toContainedContentPath as t}from"../../../ingest/scan.js";import{markdocNodeProblem as n}from"../../utils/node-source-range.js";import{resolveResolverTarget as r}from"./context-paths.js";import{join as i}from"node:path";async function a(e,t,n){let{bundle:r,createConfig:a,Source:o}=await import(`@redocly/openapi-core`),l=n?{...await import(`../../../plugins/internal/api-docs/server/build-definition.js`),resolution:{markdown:e.markdown,loader:{...e,inJsonSchemaDescription:!0},sink:n}}:void 0,u=JSON.parse(JSON.stringify({openapi:`3.1.0`,components:{schemas:{__root:t}}})),d=i(e.contentDir,e.sourceFilePath),f=await r({config:l?await l.createBundleConfig(a,{bundle:{config:{},configDir:``,plugins:[]},specRelativePath:e.sourceFilePath,rootDir:e.contentDir,resolution:l.resolution}):await a({}),doc:{source:new o(d,``),parsed:u}}),p=f.bundle.parsed,m;if(l){let n=structuredClone(p),{sink:r}=l.resolution;await l.resolvePendingMarkdown(l.resolution,r.pending,e.contentDir,e.sourceFilePath),r.pending.some(e=>typeof e.read()==`object`)&&(m=n),r.problems=s(e,r.problems,t)}let h=p.components?.schemas,g=h?.__root?.$ref,_=typeof g==`string`?g.split(`/`).at(-1):void 0,v=_?h?.[_]:h?.__root;return{oas:p,asWritten:m,schema:v,errors:(f.problems??[]).slice(0,1).map(e=>e.message),fileDeps:c(f.fileDependencies,e.contentDir,d)}}function o(){return{entityDeps:[],assetUsages:[],linkRefs:[],problems:[],pending:[]}}function s(t,r,i){let a=r.find(e=>e.code.startsWith(`markdoc/`));if(a===void 0)return r;let o=e(i)?i.$ref:void 0,s=typeof o==`string`?`the schema ${o}`:`the schema`;return[...r.filter(e=>!e.code.startsWith(`markdoc/`)),{...n(t.node,`A description in ${s} is not valid Markdoc, so it renders as text: ${a.message}`,t.sourceFilePath,a.code),severity:`warning`}]}function c(e,n,r){if(e===void 0)return[];let i=/* @__PURE__ */ new Set;for(let a of e){let e=t(n,a);a!==r&&e!==null&&i.add(e)}return[...i].sort()}function l(e,t=[]){return e.length>0||t.length>0?{entityDeps:e.map(e=>({kind:`file`,path:e})),problems:t}:null}function u(e,t){let{node:r,attributeName:i}=e;return r.attributes[`${i}ResolvedErrors`]=t,e.logger?.warn(`${r.tag} in ${e.sourceFilePath}: ${t[0]}`),n(r,t[0],e.sourceFilePath)}async function d(t){let{node:n,attributeName:r}=t,i=n.attributes[r];if(!e(i))return null;let s=o(),{oas:c,asWritten:l,errors:d,fileDeps:f}=await a(t,i,t.inJsonSchemaDescription?void 0:s);n.attributes[`${r}Resolved`]=c,l!==void 0&&(n.attributes[`${r}AsWritten`]=l);let p=d.length>0?[u(t,d)]:[];return{entityDeps:[...f.map(e=>({kind:`file`,path:e})),...s.entityDeps],assetUsages:s.assetUsages,linkRefs:s.linkRefs,problems:[...p,...s.problems]}}async function f(t){let{node:n,attributeName:r}=t,i=n.attributes[r];if(!e(i)||n.attributes.value!==void 0)return null;let{oas:o,schema:s,errors:c,fileDeps:d}=await a(t,i);if(c.length>0)return l(d,[u(t,c)]);let f=n.attributes.mode,p=await import(`openapi-sampler`);try{n.attributes[`${r}Resolved`]=p.sample(s,{...f===`read`?{skipWriteOnly:!0}:void 0,...f===`write`?{skipReadOnly:!0}:void 0},o)}catch(e){return l(d,[u(t,[`Failed to generate a sample from the schema: ${e?.message??e}`])])}return l(d)}async function p(t){let{node:n,attributeName:i}=t,a=n.attributes[i],o=e=>({problems:[u(t,[e])]});if(a!==void 0&&n.attributes.schema!==void 0)return o(`The "schema" and "value" attributes are mutually exclusive, use only one.`);if(a===void 0)return n.attributes.schema===void 0?o(`The tag requires a "schema" or "value" attribute.`):null;let s=e(a)?a.$ref:void 0;if(typeof s!=`string`)return n.attributes[`${i}Resolved`]=a,null;let[c,l]=s.split(`#`),d=c?r(t,c):null;if(d===null||t.io===void 0)return o(`Invalid $ref "${s}": the path must stay inside the content directory.`);if(!await t.io.exists(d.absolutePath))return o(`Invalid $ref: no such file ${d.contentPath}`);let f=await t.io.readFile(d.absolutePath),p=[{kind:`file`,path:d.contentPath}],h;try{h=(await import(`js-yaml`)).load(f)}catch(e){return{entityDeps:p,...o(`File ${d.contentPath} must be valid JSON or YAML: ${e.message}`)}}let g=l?m(h,l):h;return l&&g===void 0?{entityDeps:p,...o(`Invalid $ref: ${d.contentPath} has no value at #${l}`)}:(n.attributes[`${i}Resolved`]=g,{entityDeps:p})}function m(t,n){let r=t;for(let t of n.split(`/`).slice(+!!n.startsWith(`/`))){let n=t.replaceAll(`~1`,`/`).replaceAll(`~0`,`~`);if(Array.isArray(r))r=r[Number(n)];else if(e(r))r=r[n];else return}return r}export{p as resolveJsonExampleRefAttribute,d as resolveJsonSchemaRefAttribute,f as resolveSampleFromJsonSchemaAttribute};
@@ -1 +1 @@
1
- import{compileRouteAccessMatcher as e,matchContentScope as t}from"../../../../shared/rbac/engine.js";import{isObject as n}from"../../../../shared/utils/is-object.js";import{SPEC_KIND_OPENAPI as r}from"../../../../shared/constants/api-spec-kinds.js";import{markdocNodeProblem as i}from"../../utils/node-source-range.js";import{createLruCache as a}from"../../../../shared/utils/lru-cache.js";import{parseMarkdownCached as o}from"../../utils/parse-cache.js";import{resolveResolverTarget as s}from"./context-paths.js";import{createApiEntityKey as c}from"../../../plugins/utils/api-entity-key.js";import{withMockServerOption as l}from"../../../plugins/internal/api-docs/server/options.js";import{annotateApiDocsRbac as u}from"../../../../shared/rbac/api-docs.js";import{posix as d}from"node:path";import{REDOCLY_TEAMS_RBAC as f}from"@redocly/config";const p={curl:`shell`,JavaScript:`javascript`,"Node.js":`javascript`,Python:`python`,Java:`java`,"Java8+Apache":`java`,"C#":`csharp`,"C#+Newtonsoft":`csharp`,PHP:`php`,Go:`go`,Ruby:`ruby`,R:`r`},m=/* @__PURE__ */ new WeakMap;async function h(e){let t=m.get(e.node);t===void 0&&(t=g(e),m.set(e.node,t));let n=await t;return{definition:n.definition,problems:n.problems.splice(0)}}async function g(e){let t=e.node.attributes.descriptionFile;if(typeof t!=`string`||t===``||e.entities===void 0)return{definition:null,problems:[]};let n=s(e,t);if(n===null)return _(e,`descriptionFile "${t}" must stay inside the content directory`);let r=c(n.contentPath),i=await e.entities.get(r);return i===null||i.type!==`api`?_(e,`no API description found at ${n.contentPath}`):i.metadata?.specType===`openapi`?{definition:{contentPath:n.contentPath,document:await e.entities.load(r),metadata:i.metadata??{},dataHash:i.status===`ready`?i.dataHash??null:null},problems:[]}:_(e,`${n.contentPath} is not an OpenAPI description`)}function _(e,t){return e.logger?.warn(`${e.node.tag} in ${e.sourceFilePath}: ${t}`),e.node.attributes.descriptionFileInvalid=!0,{definition:null,problems:[i(e.node,t,e.sourceFilePath)]}}const v=(e,t)=>e.node.attributes[t]??void 0;function y(e){let t=n(e.options)?e.options:{};return n(t.mockServer)?{...t,mockServer:{...t.mockServer,position:`off`}}:t}function b(e,t){let r=v(e,`language`),i=v(e,`options`);return{...t,...i,codeSamples:{...n(t.codeSamples)?t.codeSamples:{},...i?.codeSamples,...r&&{languages:[{lang:r}]}}}}async function x(e){let{definition:t,problems:n}=await h(e);if(t===null)return{problems:n};let{buildCodeSamples:r,getRequestBodySamples:i,normalizeOptions:a,resolveOperationSampleContext:s}=await import(`@redocly/api-docs/server`),c=a({specType:`openapi`,...b(e,y(t.metadata)),markdownParser:o}),l=s(t.document,c,{operationId:v(e,`operationId`),pointer:v(e,`pointer`)});if(!l)return null;let u={exampleKey:v(e,`exampleKey`),mimeType:v(e,`mimeType`),parameters:v(e,`parameters`),requestBody:v(e,`requestBody`),environments:v(e,`environments`),environment:v(e,`environment`)},d=r(l,u).map(e=>({lang:p[e.lang]??e.lang.toLowerCase(),title:e.label??e.lang,source:e.source})),f=c.codeSamples?.languages??[],m=f.findIndex(({lang:e})=>e===`Payload`);if(m!==-1){let e=i(l,{exampleKey:u.exampleKey,mimeType:u.mimeType,titlePrefix:f[m].label});d.splice(m,0,...e)}return d.length>0&&(e.node.attributes[e.attributeName]=d),null}async function S(e){let{definition:t,problems:n}=await h(e);if(t===null)return{problems:n};let{getResponseSamples:r,normalizeOptions:i,resolveOperationSampleContext:a}=await import(`@redocly/api-docs/server`),s=a(t.document,i({specType:`openapi`,...y(t.metadata),markdownParser:o}),{operationId:v(e,`operationId`),pointer:v(e,`pointer`)});if(!s)return null;let c=r(s,{exampleKey:v(e,`exampleKey`)});return c.length>0&&(e.node.attributes[e.attributeName]=c),null}const C=a({budget:4});function w(e,t,n){let i=async()=>{let{buildItems:i}=await import(`@redocly/api-docs/server`),a=u(t.document,r,{warn:t=>e.logger?.warn(t)}),{items:s,store:c}=await i({type:r,document:a,options:{...n,specType:r,markdownParser:o},basePath:`/`,markdownParser:o});return{items:s,store:c}};if(t.dataHash===null)return i();let a=JSON.stringify([t.contentPath,t.dataHash,n]),s=C.get(a);return s===void 0&&(s=i(),C.set(a,s)),s}function T(e){return e.startsWith(`#`)?e.slice(1):e}function E(e,t){let n=v(t,`pointer`),r=v(t,`operationId`);if(n!==void 0||r!==void 0)for(let i of e){let e=i.content?.meta;if(n!==void 0&&e?.pointer!==void 0&&T(e.pointer)===T(n)||r!==void 0&&e?.sourceId===r)return i;let a=E(i.items??[],t);if(a!==void 0)return a}}function D(e){return e[f]}function O(e,t,n){for(let r of e){if(r.nodeType!==`container`)continue;let e=D(r)??n;for(let n of r.panels??[]){let r=`children`in n?n.children.find(t):void 0;if(r!==void 0){let t=D(n)??e;return{entry:r,scope:t===void 0?{}:{[f]:t}}}}let i=O(r.children,t,e);if(i!==void 0)return i}}async function k(e,t){return F(e,t,await P(e,t))}async function A(e){let{definition:t,problems:n}=await h(e);if(t===null)return{problems:n};let r=y(t.metadata),{items:i,store:a}=await w(e,t,r),o=E(i,e),s=o?.content?O(o.content.children,e=>e.kind===`code-sample`,D(o)):void 0;if(s===void 0)return null;let c=s.entry,{appendUndeclaredConfigureParameters:l}=await import(`@redocly/api-docs/server`),u=v(e,`parameters`),d={apiStore:a,options:b(e,r),panel:{...c,source:l(c.source,{...u?.path&&{path:u.path},...u?.query&&{query:u.query},...u?.header&&{headers:u.header},...u?.cookie&&{cookie:u.cookie}}),...s.scope},...await k(e,t.contentPath)};return e.node.attributes[e.attributeName]=d,null}async function j(e){let{definition:t,problems:n}=await h(e);if(t===null)return{problems:n};let r=y(t.metadata),{items:i,store:a}=await w(e,t,r),o=E(i,e),s=o?.content?O(o.content.children,e=>e.kind===`response`&&!!e.responseCodes?.length,D(o)):void 0;if(s?.entry.responseCodes===void 0)return null;let c={apiStore:a,options:r,panel:{responseCodes:s.entry.responseCodes,...s.entry.schemaId!==void 0&&{schemaId:s.entry.schemaId},...s.scope},...await k(e,t.contentPath)};return e.node.attributes[e.attributeName]=c,null}async function M(e){let t=v(e,`pointer`);if(t===void 0)return null;let{definition:n,problems:r}=await h(e);if(n===null)return{problems:r};let i=y(n.metadata),{items:a,store:o}=await w(e,n,i),s=T(t).replace(/^\//,``),c=Object.fromEntries([s,s.replace(/\/value$/,``)].filter(e=>o.exampleStore[e]!==void 0).map(e=>[e,o.exampleStore[e]]));if(Object.keys(c).length===0)return null;let l=(await import(`@redocly/api-docs/server`)).findExampleEncoding(a,t),u={apiStore:{schemaStore:{},exampleStore:c,securitySchemeStore:{}},options:{...i,...v(e,`options`)},...l!==void 0&&{encoding:l},...await k(e,n.contentPath)};return e.node.attributes[e.attributeName]=u,null}function N(e,t,n,r,i){if(!e.requestBody||!t&&!n)return e;let a={...e.requestBody};if(t&&(a=a[t]?{[t]:a[t]}:{}),n)for(let[e,t]of Object.entries(a)){let o=t.exampleIds?.filter(e=>r[e]?.key!==void 0);if(!o?.length)continue;let s=i(o,n,e=>r[e]);a[e]={...t,exampleIds:s?[s]:[]}}return{...e,requestBody:a}}async function P(e,t){let n=d.relative(d.dirname(e.sourceFilePath),t),{result:r}=await e.markdown.resolveLocalReference(n,e.sourceFilePath);return r.kind===`pageUrl`?r.url:void 0}function F(n,r,i){let a=e(n.config);if(a===null)return{};let o=t(a,{filePath:r,slug:i??null});return{[f]:o??{}}}async function I(e){let{definition:t,problems:i}=await h(e);if(t===null)return{problems:i};let{findExampleIdByKey:a,JsonPointer:s,normalizeOptions:c,resolveOperationSampleContext:d}=await import(`@redocly/api-docs/server`),f=t.metadata,p=n(f.options)?f.options:{},m=await P(e,t.contentPath),g=l(p,e.config,m),_=v(e,`options`),y={...g,..._??{}},b=c({specType:`openapi`,...y,markdownParser:o}),x=u(t.document,r,{warn:t=>e.logger?.warn(t)}),S=d(x,b,{operationId:v(e,`operationId`),pointer:v(e,`pointer`)});if(!S)return null;let C=N(S.source,v(e,`mimeType`),v(e,`exampleKey`),S.storeCtx.exampleStore,a),w={apiStore:{schemaStore:S.storeCtx.schemaStore,exampleStore:S.storeCtx.exampleStore,securitySchemeStore:S.storeCtx.securitySchemeStore,specVersion:x.openapi},definition:x,operationId:S.operation.operationId??``,operationSource:C,options:y,pointer:s.compile([`paths`,S.pathName,S.method.toLowerCase()]),...F(e,t.contentPath,m)};return e.node.attributes[e.attributeName]=w,null}export{A as resolveOpenapiCodeSamplePanelAttribute,x as resolveOpenapiCodeSamplesAttribute,M as resolveOpenapiExampleAttribute,I as resolveOpenapiReplayAttribute,j as resolveOpenapiResponsePanelAttribute,S as resolveOpenapiResponseSamplesAttribute};
1
+ import{compileRouteAccessMatcher as e,matchContentScope as t}from"../../../../shared/rbac/engine.js";import{isObject as n}from"../../../../shared/utils/is-object.js";import{SPEC_KIND_OPENAPI as r}from"../../../../shared/constants/api-spec-kinds.js";import{markdocNodeProblem as i}from"../../utils/node-source-range.js";import{createLruCache as a}from"../../../../shared/utils/lru-cache.js";import{parseMarkdownCached as o}from"../../utils/parse-cache.js";import{resolveResolverTarget as s}from"./context-paths.js";import{createApiEntityKey as c}from"../../../plugins/utils/api-entity-key.js";import{withMockServerOption as l}from"../../../plugins/internal/api-docs/server/options.js";import{annotateApiDocsRbac as u}from"../../../../shared/rbac/api-docs.js";import{posix as d}from"node:path";import{REDOCLY_TEAMS_RBAC as f}from"@redocly/config";const p={curl:`shell`,JavaScript:`javascript`,"Node.js":`javascript`,Python:`python`,Java:`java`,"Java8+Apache":`java`,"C#":`csharp`,"C#+Newtonsoft":`csharp`,PHP:`php`,Go:`go`,Ruby:`ruby`,R:`r`},m=/* @__PURE__ */ new WeakMap;async function h(e){let t=m.get(e.node);t===void 0&&(t=g(e),m.set(e.node,t));let n=await t;return{definition:n.definition,problems:n.problems.splice(0)}}async function g(e){let t=e.node.attributes.descriptionFile;if(typeof t!=`string`||t===``||e.entities===void 0)return{definition:null,problems:[]};let n=s(e,t);if(n===null)return _(e,`descriptionFile "${t}" must stay inside the content directory`);let r=c(n.contentPath),i=await e.entities.get(r);return i===null||i.type!==`api`?_(e,`no API description found at ${n.contentPath}`):i.metadata?.specType===`openapi`?{definition:{contentPath:n.contentPath,document:await e.entities.load(r),metadata:i.metadata??{},dataHash:i.status===`ready`?i.dataHash??null:null},problems:[]}:_(e,`${n.contentPath} is not an OpenAPI description`)}function _(e,t){return e.logger?.warn(`${e.node.tag} in ${e.sourceFilePath}: ${t}`),e.node.attributes.descriptionFileInvalid=!0,{definition:null,problems:[i(e.node,t,e.sourceFilePath)]}}const v=(e,t)=>e.node.attributes[t]??void 0;function y(e){let t=n(e.options)?e.options:{};return n(t.mockServer)?{...t,mockServer:{...t.mockServer,position:`off`}}:t}function b(e,t){let r=v(e,`language`),i=v(e,`options`);return{...t,...i,codeSamples:{...n(t.codeSamples)?t.codeSamples:{},...i?.codeSamples,...r&&{languages:[{lang:r}]}}}}async function x(e){let{definition:t,problems:n}=await h(e);if(t===null)return{problems:n};let{buildCodeSamples:r,getRequestBodySamples:i,normalizeOptions:a,resolveOperationSampleContext:s}=await import(`@redocly/api-docs/server`),c=a({specType:`openapi`,...b(e,y(t.metadata)),markdownParser:o}),l=s(t.document,c,{operationId:v(e,`operationId`),pointer:v(e,`pointer`)});if(!l)return null;let u={exampleKey:v(e,`exampleKey`),mimeType:v(e,`mimeType`),parameters:v(e,`parameters`),requestBody:v(e,`requestBody`),environments:v(e,`environments`),environment:v(e,`environment`)},d=r(l,u).map(e=>({lang:p[e.lang]??e.lang.toLowerCase(),title:e.label??e.lang,source:e.source})),f=c.codeSamples?.languages??[],m=f.findIndex(({lang:e})=>e===`Payload`);if(m!==-1){let e=i(l,{exampleKey:u.exampleKey,mimeType:u.mimeType,titlePrefix:f[m].label});d.splice(m,0,...e)}return d.length>0&&(e.node.attributes[e.attributeName]=d),null}async function S(e){let{definition:t,problems:n}=await h(e);if(t===null)return{problems:n};let{getResponseSamples:r,normalizeOptions:i,resolveOperationSampleContext:a}=await import(`@redocly/api-docs/server`),s=a(t.document,i({specType:`openapi`,...y(t.metadata),markdownParser:o}),{operationId:v(e,`operationId`),pointer:v(e,`pointer`)});if(!s)return null;let c=r(s,{exampleKey:v(e,`exampleKey`)});return c.length>0&&(e.node.attributes[e.attributeName]=c),null}const C=a({budget:4});function w(e,t,n){let i=async()=>{let{buildItems:i}=await import(`@redocly/api-docs/server`),a=u(t.document,r,{warn:t=>e.logger?.warn(t)}),{items:s,store:c}=await i({type:r,document:a,options:{...n,specType:r,markdownParser:o},basePath:`/`,markdownParser:o});return{items:s,store:c}};if(t.dataHash===null)return i();let a=JSON.stringify([t.contentPath,t.dataHash,n]),s=C.get(a);return s===void 0&&(s=i(),C.set(a,s)),s}function T(e){return e.startsWith(`#`)?e.slice(1):e}function E(e,t){let n=v(t,`pointer`),r=v(t,`operationId`);if(n!==void 0||r!==void 0)for(let i of e){let e=i.content?.meta;if(n!==void 0&&e?.pointer!==void 0&&T(e.pointer)===T(n)||r!==void 0&&e?.sourceId===r)return i;let a=E(i.items??[],t);if(a!==void 0)return a}}function D(e){return e[f]}function O(e,t,n){for(let r of e){if(r.nodeType!==`container`)continue;let e=D(r)??n;for(let n of r.panels??[]){let r=`children`in n?n.children.find(t):void 0;if(r!==void 0){let t=D(n)??e;return{entry:r,scope:t===void 0?{}:{[f]:t}}}}let i=O(r.children,t,e);if(i!==void 0)return i}}async function k(e,t){return F(e,t,await P(e,t))}async function A(e){let{definition:t,problems:n}=await h(e);if(t===null)return{problems:n};let r=y(t.metadata),{items:i,store:a}=await w(e,t,r),o=E(i,e),s=o?.content?O(o.content.children,e=>e.kind===`code-sample`,D(o)):void 0;if(s===void 0)return null;let c=s.entry,{appendUndeclaredConfigureParameters:l}=await import(`@redocly/api-docs/server`),u=v(e,`parameters`),d={apiStore:a,options:b(e,r),panel:{...c,source:l(c.source,{...u?.path&&{path:u.path},...u?.query&&{query:u.query},...u?.header&&{headers:u.header},...u?.cookie&&{cookie:u.cookie}}),...s.scope},...await k(e,t.contentPath)};return e.node.attributes[e.attributeName]=d,null}async function j(e){let{definition:t,problems:n}=await h(e);if(t===null)return{problems:n};let r=y(t.metadata),{items:i,store:a}=await w(e,t,r),o=E(i,e),s=o?.content?O(o.content.children,e=>e.kind===`response`&&!!e.responseCodes?.length,D(o)):void 0;if(s?.entry.responseCodes===void 0)return null;let c={apiStore:a,options:r,panel:{responseCodes:s.entry.responseCodes,...s.entry.schemaId!==void 0&&{schemaId:s.entry.schemaId},...s.scope},...await k(e,t.contentPath)};return e.node.attributes[e.attributeName]=c,null}async function M(e){let t=v(e,`pointer`);if(t===void 0)return null;let{definition:n,problems:r}=await h(e);if(n===null)return{problems:r};let i=y(n.metadata),{items:a,store:o}=await w(e,n,i),s=T(t).replace(/^\//,``),c=Object.fromEntries([s,s.replace(/\/value$/,``)].filter(e=>o.exampleStore[e]!==void 0).map(e=>[e,o.exampleStore[e]]));if(Object.keys(c).length===0)return null;let l=(await import(`@redocly/api-docs/server`)).findExampleEncoding(a,t),u={apiStore:{schemaStore:{},exampleStore:c,securitySchemeStore:{}},options:{...i,...v(e,`options`)},...l!==void 0&&{encoding:l},...await k(e,n.contentPath)};return e.node.attributes[e.attributeName]=u,null}function N(e,t,n,r,i){if(!e.requestBody||!t&&!n)return e;let a={...e.requestBody};if(t&&(a=a[t]?{[t]:a[t]}:{}),n)for(let[e,t]of Object.entries(a)){let o=t.exampleIds?.filter(e=>r[e]?.key!==void 0);if(!o?.length)continue;let s=i(o,n,e=>r[e]);a[e]={...t,exampleIds:s?[s]:[]}}return{...e,requestBody:a}}async function P(e,t){let n=d.relative(d.dirname(e.sourceFilePath),t),{result:r}=await e.markdown.resolveLocalReference(n,e.sourceFilePath);return r.kind===`pageUrl`?r.url:void 0}function F(n,r,i){let a=e(n.config);if(a===null)return{};let o=t(a,{filePath:r,slug:i??null});return{[f]:o}}async function I(e){let{definition:t,problems:i}=await h(e);if(t===null)return{problems:i};let{findExampleIdByKey:a,JsonPointer:s,normalizeOptions:c,resolveOperationSampleContext:d}=await import(`@redocly/api-docs/server`),f=t.metadata,p=n(f.options)?f.options:{},m=await P(e,t.contentPath),g=l(p,e.config,m),_=v(e,`options`),y={...g,..._??{}},b=c({specType:`openapi`,...y,markdownParser:o}),x=u(t.document,r,{warn:t=>e.logger?.warn(t)}),S=d(x,b,{operationId:v(e,`operationId`),pointer:v(e,`pointer`)});if(!S)return null;let C=N(S.source,v(e,`mimeType`),v(e,`exampleKey`),S.storeCtx.exampleStore,a),w={apiStore:{schemaStore:S.storeCtx.schemaStore,exampleStore:S.storeCtx.exampleStore,securitySchemeStore:S.storeCtx.securitySchemeStore,specVersion:x.openapi},definition:x,operationId:S.operation.operationId??``,operationSource:C,options:y,pointer:s.compile([`paths`,S.pathName,S.method.toLowerCase()]),...F(e,t.contentPath,m)};return e.node.attributes[e.attributeName]=w,null}export{A as resolveOpenapiCodeSamplePanelAttribute,x as resolveOpenapiCodeSamplesAttribute,M as resolveOpenapiExampleAttribute,I as resolveOpenapiReplayAttribute,j as resolveOpenapiResponsePanelAttribute,S as resolveOpenapiResponseSamplesAttribute};
@@ -1 +1 @@
1
- import{buildContentAssetUrl as e}from"../../plugins/internal/assets/url.js";import{L10N_DIR as t}from"../../../shared/constants/l10n/defaults.js";import{delocalizeL10nPath as n,l10nDirOf as r,toLocaleSlug as i}from"../../../shared/utils/l10n.js";import{resolveContentPath as a}from"../../../shared/utils/resolve-content-path.js";import{computePathPrefixes as o}from"../../../shared/utils/routes/compute-path-prefixes.js";import{IMAGE_EXTENSIONS as s}from"../../plugins/internal/assets/extensions.js";import{isRouteSlugTarget as c}from"../../../shared/utils/routes/is-route-slug-target.js";import{safeDecodeURI as l}from"../../../shared/utils/safe-decode-uri.js";import{joinSrcSet as u,parseSrcSet as d}from"../../plugins/internal/assets/srcset.js";import{isIndexPagePath as f,resolveRelativeSlug as p}from"../../../shared/utils/routes/resolve-relative-slug.js";import{posix as m}from"node:path";const h=/[[\]()*_`#!|<>~]|\{%|^\s{0,3}([-+*]\s|\d+\.\s|>|-{3,}|={2,})/m;function g(e){return h.test(e)}function _(e){return e.startsWith(`#`)||e.startsWith(`//`)||/^[a-z][a-z0-9+.-]*:/i.test(e)?!1:!e.startsWith(`/`)||!c(y(e).path)}function v(e){let t=e.indexOf(`?`);return t===-1?[e,``]:[e.slice(0,t),e.slice(t)]}function y(e){let t=e.indexOf(`#`);return t===-1?{path:e,hash:``}:{path:e.slice(0,t),hash:e.slice(t)}}async function b(e,t){let r=await t(e);if(r)return r;let i=n(e);if(i!==void 0){let n=await t(i);if(n){let t=e.slice(0,e.length-i.length),r=n.entityDeps.filter(e=>e.kind===`file`).map(e=>({kind:`file`,path:`${t}${e.path}`}));return{...n,entityDeps:[...r,...n.entityDeps]}}}return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]}}async function x(e,t){let i=n(e),a=r(e);if(i===void 0||a===void 0)return null;let o=await t(i,a);return o===null?null:{...o,entityDeps:[{kind:`file`,path:e},...o.entityDeps]}}async function S(n,r,i,a,o){let[s]=n.assetUsages;if(!s||!a?.length||n.result.kind!==`assetRef`||r.startsWith(`@l10n/`))return n;let c=e(s.path,s.hash,s.tag),l=[];for(let e of a){let n=`${t}/${e}/${s.path}`,r=i.filesByPath.get(n);if(!r)continue;let a=await o?.(n)??null;l.push({path:n,hash:r.hash,kind:s.kind,tag:a,l10n:{locale:e,canonicalUrl:c}})}return l.length===0?n:{...n,assetUsages:[s,...l]}}function C(e,t){let n=e.routeBySlug.get(t);return n===void 0?o(t).reverse().map(t=>e.routeBySlug.get(t)).find(e=>e?.wildcardPrefix===!0):n}async function w(t,n,r,o,c,u){if(!_(t))return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]};let{path:d,hash:h}=y(t),g=async(t,n)=>{let a=r.primaryRouteByFilePath.get(t);if(a!==void 0)return{result:{kind:`pageUrl`,url:`${n===void 0?a:i(a,n)}${h}`},entityDeps:[{kind:`file`,path:t}],assetUsages:[]};let c=r.filesByPath.get(t);if(c){let n=m.extname(t).toLowerCase(),r=s.has(n)?`image`:`file`,i=await o?.(t)??null;return{result:{kind:`assetRef`,url:`${e(t,c.hash,i)}${h}`,path:t,hash:c.hash},entityDeps:[{kind:`file`,path:t}],assetUsages:[{path:t,hash:c.hash,kind:r,tag:i}]}}return null};return S(await b(n,async e=>{let t=a(l(d),e);if(t===null)return null;let n=await g(t)??await x(t,g);if(n!==null)return n;let[i=``,o=``]=v(d);if(!d.startsWith(`/`)&&m.extname(i)===``){let t=u??e,n=r.primaryRouteByFilePath.get(t),a=n===void 0?void 0:p(i,n,f(t)),s=a===void 0?void 0:C(r,a);if(a!==void 0&&s!==void 0)return{result:{kind:`pageUrl`,url:`${a}${o}${h}`},entityDeps:s.originFilePath===null?[]:[{kind:`file`,path:s.originFilePath}],assetUsages:[]}}return null}),n,r,c,o)}async function T(t,n,r,i,o){if(!_(t))return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]};let{path:s}=y(t),c=async t=>{let n=r.filesByPath.get(t);if(!n)return null;let a=await i?.(t)??null;return{result:{kind:`assetRef`,url:e(t,n.hash,a),path:t,hash:n.hash},entityDeps:[{kind:`file`,path:t}],assetUsages:[{path:t,hash:n.hash,kind:`image`,tag:a}]}};return S(await b(n,async e=>{let t=a(l(s),e);return t===null?null:await c(t)??await x(t,c)}),n,r,o,i)}async function E(e,t,n,r,i){let a=[],o=[],s=d(e);if(!s||s.length===0)return{value:e,entityDeps:a,assetUsages:o};let c=await Promise.all(s.map(async e=>{let s=await T(e.src,t,n,r,i);return s.result.kind===`assetRef`&&(a.push(...s.entityDeps),o.push(...s.assetUsages),e.src=s.result.url),e}));return{value:u(c),entityDeps:a,assetUsages:o}}export{_ as isLocalReference,g as looksLikeMarkdown,T as resolveImageReference,E as resolveImageSrcSet,w as resolveLocalReference,y as splitHash};
1
+ import{buildContentAssetUrl as e}from"../../plugins/internal/assets/url.js";import{L10N_DIR as t}from"../../../shared/constants/l10n/defaults.js";import{delocalizeL10nPath as n,l10nDirOf as r,toLocaleSlug as i}from"../../../shared/utils/l10n.js";import{resolveContentPath as a}from"../../../shared/utils/resolve-content-path.js";import{computePathPrefixes as o}from"../../../shared/utils/routes/compute-path-prefixes.js";import{IMAGE_EXTENSIONS as s}from"../../plugins/internal/assets/extensions.js";import{isRouteSlugTarget as c}from"../../../shared/utils/routes/is-route-slug-target.js";import{safeDecodeURI as l}from"../../../shared/utils/safe-decode-uri.js";import{joinSrcSet as u,parseSrcSet as d}from"../../plugins/internal/assets/srcset.js";import{isIndexPagePath as f,resolveRelativeSlug as p}from"../../../shared/utils/routes/resolve-relative-slug.js";import{posix as m}from"node:path";const h=/[[\]()*_`#!|<>~]|\{%|\n[ \t\r]*\n|^\s{0,3}([-+*]\s|\d+\.\s|>|-{3,}|={2,})/m;function g(e){return h.test(e)}function _(e){return e.startsWith(`#`)||e.startsWith(`//`)||/^[a-z][a-z0-9+.-]*:/i.test(e)?!1:!e.startsWith(`/`)||!c(y(e).path)}function v(e){let t=e.indexOf(`?`);return t===-1?[e,``]:[e.slice(0,t),e.slice(t)]}function y(e){let t=e.indexOf(`#`);return t===-1?{path:e,hash:``}:{path:e.slice(0,t),hash:e.slice(t)}}async function b(e,t){let r=await t(e);if(r)return r;let i=n(e);if(i!==void 0){let n=await t(i);if(n){let t=e.slice(0,e.length-i.length),r=n.entityDeps.filter(e=>e.kind===`file`).map(e=>({kind:`file`,path:`${t}${e.path}`}));return{...n,entityDeps:[...r,...n.entityDeps]}}}return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]}}async function x(e,t){let i=n(e),a=r(e);if(i===void 0||a===void 0)return null;let o=await t(i,a);return o===null?null:{...o,entityDeps:[{kind:`file`,path:e},...o.entityDeps]}}async function S(n,r,i,a,o){let[s]=n.assetUsages;if(!s||!a?.length||n.result.kind!==`assetRef`||r.startsWith(`@l10n/`))return n;let c=e(s.path,s.hash,s.tag),l=[];for(let e of a){let n=`${t}/${e}/${s.path}`,r=i.filesByPath.get(n);if(!r)continue;let a=await o?.(n)??null;l.push({path:n,hash:r.hash,kind:s.kind,tag:a,l10n:{locale:e,canonicalUrl:c}})}return l.length===0?n:{...n,assetUsages:[s,...l]}}function C(e,t){let n=e.routeBySlug.get(t);return n===void 0?o(t).reverse().map(t=>e.routeBySlug.get(t)).find(e=>e?.wildcardPrefix===!0):n}async function w(t,n,r,o,c,u){if(!_(t))return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]};let{path:d,hash:h}=y(t),g=async(t,n)=>{let a=r.primaryRouteByFilePath.get(t);if(a!==void 0)return{result:{kind:`pageUrl`,url:`${n===void 0?a:i(a,n)}${h}`},entityDeps:[{kind:`file`,path:t}],assetUsages:[]};let c=r.filesByPath.get(t);if(c){let n=m.extname(t).toLowerCase(),r=s.has(n)?`image`:`file`,i=await o?.(t)??null;return{result:{kind:`assetRef`,url:`${e(t,c.hash,i)}${h}`,path:t,hash:c.hash},entityDeps:[{kind:`file`,path:t}],assetUsages:[{path:t,hash:c.hash,kind:r,tag:i}]}}return null};return S(await b(n,async e=>{let t=a(l(d),e);if(t===null)return null;let n=await g(t)??await x(t,g);if(n!==null)return n;let[i=``,o=``]=v(d);if(!d.startsWith(`/`)&&m.extname(i)===``){let t=u??e,n=r.primaryRouteByFilePath.get(t),a=n===void 0?m.extname(t).toLowerCase()===`.md`?void 0:p(i,`/${t}`,!1):p(i,n,f(t)),s=a===void 0?void 0:C(r,a);if(a!==void 0&&s!==void 0)return{result:{kind:`pageUrl`,url:`${a}${o}${h}`},entityDeps:s.originFilePath===null?[]:[{kind:`file`,path:s.originFilePath}],assetUsages:[]}}return null}),n,r,c,o)}async function T(t,n,r,i,o){if(!_(t))return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]};let{path:s}=y(t),c=async t=>{let n=r.filesByPath.get(t);if(!n)return null;let a=await i?.(t)??null;return{result:{kind:`assetRef`,url:e(t,n.hash,a),path:t,hash:n.hash},entityDeps:[{kind:`file`,path:t}],assetUsages:[{path:t,hash:n.hash,kind:`image`,tag:a}]}};return S(await b(n,async e=>{let t=a(l(s),e);return t===null?null:await c(t)??await x(t,c)}),n,r,o,i)}async function E(e,t,n,r,i){let a=[],o=[],s=d(e);if(!s||s.length===0)return{value:e,entityDeps:a,assetUsages:o};let c=await Promise.all(s.map(async e=>{let s=await T(e.src,t,n,r,i);return s.result.kind===`assetRef`&&(a.push(...s.entityDeps),o.push(...s.assetUsages),e.src=s.result.url),e}));return{value:u(c),entityDeps:a,assetUsages:o}}export{_ as isLocalReference,g as looksLikeMarkdown,T as resolveImageReference,E as resolveImageSrcSet,w as resolveLocalReference,y as splitHash};
@@ -21,7 +21,7 @@ export declare function teamBlockSectionKey(docKey: string): string;
21
21
  * page's own title opens the page, not `#title`. Section anchors follow the rendered heading
22
22
  * ids: an explicit `{% #id %}`, else the theme's slug of the heading's rendered text, numbered
23
23
  * on repeats in document order — headings nested in a tag count too, though only top-level
24
- * headings open a section. A section's `path` is its heading chain: the latest top-level
24
+ * headings and headings in raw HTML elements (`<details>`) open a section. A section's `path` is its heading chain: the latest top-level
25
25
  * heading of each shallower level, a shallower heading clearing the deeper ones and a
26
26
  * level-1 heading clearing them all.
27
27
  */
@@ -1 +1 @@
1
- import{HeadingSlugger as e}from"../utils/heading-slugger.js";import{hidesBodyFromSearch as t,markdocAstToText as n}from"./to-text.js";import{renderedHeadingText as r}from"../utils/heading-text.js";import{isNonControlVariant as i}from"@redocly/theme/markdoc/tags/variant";import{isForAgentsOnly as a}from"@redocly/theme/markdoc/tags/visibility";const o=/^(page|section-\d+)-team-\d+$/;function s(e){return o.exec(e)?.[1]??e}function c(t,i,a={}){let o=g(t)&&Array.isArray(t.children)?t.children:[],s=new e,c={title:i,body:[]},u=[],d=c,f=!1,p=[],_=e=>{let t=e.attributes?.id;return typeof t==`string`?t:s.slug(r(e,a))};for(let e of o){if(!g(e)||e.type!==`heading`){d.body.push(e);for(let t of h(e))_(t);continue}let t=r(e,a),n=_(e),o=m(e);if(o===1){!f&&t!==``&&(c.title=t,f=!0),d=c,p.length=0;continue}let s=t||i,l=p.slice(0,o).filter(e=>e!==void 0);p.length=o,p[o]=s;let v={anchor:n,title:s,ancestors:l,body:[]};u.push(v),d=v}let v=e=>n({type:`document`,children:e}),y=(e,t)=>[e,...l(t).map(({teams:t,children:n},r)=>({...e,docKey:`${e.docKey}-team-${r+1}`,text:v(n),rbacTeams:t})).filter(e=>e.text!==``)];return[...y({docKey:`page`,title:c.title,text:v(c.body)},c.body),...u.flatMap((e,t)=>y({docKey:`section-${t+1}`,anchor:e.anchor,title:e.title,text:v(e.body),path:[c.title,...e.ancestors,e.title]},e.body))]}function l(e){let n=[],r=(e,i)=>{if(g(e)&&!t(e)){if(e.type===`tag`&&e.tag===`if`){let t=u(e.attributes?.primary);if(t===void 0)return;let a=i===void 0?t:t.filter(e=>i.includes(e));if(a.length===0)return;let o=e.children??[],s=o.findIndex(e=>g(e)&&e.type===`tag`&&e.tag===`else`),c=s===-1?o:o.slice(0,s);n.push({teams:a,children:c});for(let e of c)r(e,a);return}for(let t of Object.values(e.slots??{}))r(t,i);for(let t of e.children??[])r(t,i)}};for(let t of e)r(t,void 0);return n}function u(e){if(!f(e))return;let t=Object.values(e.parameters??{});if(e.name===`includes`){let e=d(t);return e===void 0?void 0:[e]}if(e.name!==`or`)return;let n=t.map(e=>f(e)&&e.name===`includes`?d(Object.values(e.parameters??{})):void 0).filter(e=>e!==void 0);return n.length===0?void 0:n}function d([e,t]){let n=p(e,`Variable`)?e.path:void 0;return Array.isArray(n)&&n.length===2&&n[0]===`rbac`&&n[1]===`teams`&&typeof t==`string`&&t!==`*`?t:void 0}function f(e){return p(e,`Function`)}function p(e,t){return typeof e==`object`&&!!e&&e.$$mdtype===t}function m(e){let t=e.attributes?.level;return typeof t==`number`?t:2}function*h(e){if(!(!g(e)||a(e)||i(e))){for(let t of e.children??[])g(t)&&t.type===`heading`&&(yield t),yield*h(t);for(let t of Object.values(e.slots??{}))yield*h(t)}}function g(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{c as markdocAstToSearchSections,s as teamBlockSectionKey};
1
+ import{HeadingSlugger as e}from"../utils/heading-slugger.js";import{hidesBodyFromSearch as t,markdocAstToText as n}from"./to-text.js";import{renderedHeadingText as r}from"../utils/heading-text.js";import{isNonControlVariant as i}from"@redocly/theme/markdoc/tags/variant";import{isForAgentsOnly as a}from"@redocly/theme/markdoc/tags/visibility";const o=/^(page|section-\d+)-team-\d+$/;function s(e){return o.exec(e)?.[1]??e}function c(t,i,a={}){let o=v(t)&&Array.isArray(t.children)?t.children:[],s=new e,c={title:i,body:[]},u=[],d=c,f=!1,p=[],g=e=>{let t=e.attributes?.id;return typeof t==`string`?t:s.slug(r(e,a))};for(let e of h(o)){if(!v(e)||e.type!==`heading`){d.body.push(e);for(let t of _(e))g(t);continue}let t=r(e,a),n=g(e),o=m(e);if(o===1){!f&&t!==``&&(c.title=t,f=!0),d=c,p.length=0;continue}let s=t||i,l=p.slice(0,o).filter(e=>e!==void 0);p.length=o,p[o]=s;let h={anchor:n,title:s,ancestors:l,body:[]};u.push(h),d=h}let y=e=>n({type:`document`,children:e}),b=(e,t)=>[e,...l(t).map(({teams:t,children:n},r)=>({...e,docKey:`${e.docKey}-team-${r+1}`,text:y(n),rbacTeams:t})).filter(e=>e.text!==``)];return[...b({docKey:`page`,title:c.title,text:y(c.body)},c.body),...u.flatMap((e,t)=>b({docKey:`section-${t+1}`,anchor:e.anchor,title:e.title,text:y(e.body),path:[c.title,...e.ancestors,e.title]},e.body))]}function l(e){let n=[],r=(e,i)=>{if(v(e)&&!t(e)){if(e.type===`tag`&&e.tag===`if`){let t=u(e.attributes?.primary);if(t===void 0)return;let a=i===void 0?t:t.filter(e=>i.includes(e));if(a.length===0)return;let o=e.children??[],s=o.findIndex(e=>v(e)&&e.type===`tag`&&e.tag===`else`),c=s===-1?o:o.slice(0,s);n.push({teams:a,children:c});for(let e of c)r(e,a);return}for(let t of Object.values(e.slots??{}))r(t,i);for(let t of e.children??[])r(t,i)}};for(let t of e)r(t,void 0);return n}function u(e){if(!f(e))return;let t=Object.values(e.parameters??{});if(e.name===`includes`){let e=d(t);return e===void 0?void 0:[e]}if(e.name!==`or`)return;let n=t.map(e=>f(e)&&e.name===`includes`?d(Object.values(e.parameters??{})):void 0).filter(e=>e!==void 0);return n.length===0?void 0:n}function d([e,t]){let n=p(e,`Variable`)?e.path:void 0;return Array.isArray(n)&&n.length===2&&n[0]===`rbac`&&n[1]===`teams`&&typeof t==`string`&&t!==`*`?t:void 0}function f(e){return p(e,`Function`)}function p(e,t){return typeof e==`object`&&!!e&&e.$$mdtype===t}function m(e){let t=e.attributes?.level;return typeof t==`number`?t:2}function*h(e){for(let t of e)v(t)&&t.type===`tag`&&t.tag===`html`&&g(t)?yield*h(t.children??[]):yield t}function g(e){return!_(e).next().done}function*_(e){if(!(!v(e)||a(e)||i(e))){for(let t of e.children??[])v(t)&&t.type===`heading`&&(yield t),yield*_(t);for(let t of Object.values(e.slots??{}))yield*_(t)}}function v(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{c as markdocAstToSearchSections,s as teamBlockSectionKey};
@@ -1,6 +1,6 @@
1
- import { type Schema } from '@redocly/markdoc';
1
+ import type { MarkdocTagSchema as Schema } from '@redocly/theme/markdoc/tags/types';
2
2
  /**
3
3
  * Render vehicle for raw HTML in markdown: the parser's `htmlTags()` turns HTML into this tag.
4
- * An `<html>`, `<head>` or `<body>` element is a validation error and renders as its content.
4
+ * An `<html>`, `<head>` or `<body>` element is a validation warning and renders as its content.
5
5
  */
6
6
  export declare const html: Schema;
@@ -1 +1 @@
1
- import e from"@redocly/markdoc";const t={a:`Link`,img:`Image`,script:`HtmlScript`},n=/* @__PURE__ */ new Set([`html`,`head`,`body`]),r={attributes:{name:{type:String,required:!0},attrs:{type:Object,buildTimeResolver:`htmlAttrs`}},validate(e){let t=String(e.attributes.name??``).toLowerCase();return n.has(t)?[{id:`html-document-element`,level:`error`,message:`HTML element <${t}> is not allowed in page content`}]:[]},transform(r,i){let a=String(r.attributes.name??``),o=r.attributes.attrs??{},s=r.transformChildren(i);return n.has(a.toLowerCase())?s:new e.Tag(t[a.toLowerCase()]??a,o,s)}};export{r as html};
1
+ import e from"@redocly/markdoc";const t={a:`Link`,img:`Image`,script:`HtmlScript`},n=/* @__PURE__ */ new Set([`html`,`head`,`body`]),r={attributes:{name:{type:String,required:!0},attrs:{type:Object,buildTimeResolver:`htmlAttrs`}},validate(e){let t=String(e.attributes.name??``).toLowerCase();return n.has(t)?[{id:`html-document-element`,level:`warning`,message:`HTML element <${t}> is not allowed in page content`}]:[]},transform(r,i){let a=String(r.attributes.name??``),o=r.attributes.attrs??{},s=r.transformChildren(i);return n.has(a.toLowerCase())?s:new e.Tag(t[a.toLowerCase()]??a,o,s)},renderForLlms(e,{getBody:t}){let n=e.attributes.attrs?.href;return String(e.attributes.name??``).toLowerCase()===`a`&&typeof n==`string`?`[${t()}](${n})`:t()}};export{r as html};
@@ -1 +1 @@
1
- import{isObject as e}from"../../../shared/utils/is-object.js";import t from"@redocly/markdoc";function n({lang:e,title:t,source:n}){return`\n\`\`\`${`${e??``}${t?`${e?` `:``}${t}`:``}`}\n${(n??``).trimEnd()}\n\`\`\`\n`}function r(e,t){let n=e.attributes?.[t];return Array.isArray(n)?n:[]}function i(e,t){return e===void 0?``:`\n\`\`\`${typeof t==`string`&&t!==``?`json ${t}`:`json`}\n${JSON.stringify(e,null,2)}\n\`\`\`\n`}function a(t){if(!e(t))return t;let{components:n,openapi:r,...i}=t,{__root:a,...o}=e(n)&&e(n.schemas)?n.schemas:{};return e(a)?{...i,...a,...Object.keys(o).length>0?{components:{schemas:o}}:{}}:t}function o(e,t){let{codeSamplesResolved:n,responseSamplesResolved:r,...i}=e.transformAttributes(t);return i}const s={attributes:{schema:{type:Object,buildTimeResolver:`jsonSchemaRef`},title:{type:String},options:{type:Object,default:{}},schemaResolved:{type:Object},schemaResolvedErrors:{type:Array,default:[]}},render:`JsonSchema`,selfClosing:!0,renderForLlms(e){return i(a(e.attributes?.schemaResolved),e.attributes?.title)}},c={attributes:{value:{buildTimeResolver:`jsonExampleRef`},schema:{buildTimeResolver:`sampleFromJsonSchema`},mode:{type:String,matches:[`read`,`write`]},title:{type:String},valueResolved:{},valueResolvedErrors:{type:Array,default:[]},schemaResolved:{},schemaResolvedErrors:{type:Array,default:[]}},render:`JsonExample`,selfClosing:!0,transform(e,n){let{valueResolved:r,valueResolvedErrors:i,schemaResolved:a,schemaResolvedErrors:o,title:s}=e.transformAttributes(n),c=r!==void 0||i.length>0;return new t.Tag(`JsonExample`,{title:s,json:c?r:a,errors:c?i:o})}},l={attributes:{descriptionFile:{type:String,required:!0},pointer:{type:String},operationId:{type:String},exampleKey:{type:String},mimeType:{type:String},language:{type:String},parameters:{type:Object,default:{}},requestBody:{type:Object},options:{type:Object,default:{}},environments:{type:Object,default:{}},environment:{type:String},codeSamplesResolved:{type:Array,buildTimeResolver:`openapiCodeSamples`},codeSamplePanelResolved:{type:Object,buildTimeResolver:`openapiCodeSamplePanel`},descriptionFileInvalid:{type:Boolean}},render:`OpenApiCodeSample`,selfClosing:!0,transform(e,n){return new t.Tag(`OpenApiCodeSample`,o(e,n))},renderForLlms(e){let t=r(e,`codeSamplesResolved`),i=t.find(({lang:e})=>e===`shell`)??t[0];return i===void 0?``:n(i)}},u={attributes:{descriptionFile:{type:String,required:!0},pointer:{type:String},operationId:{type:String},exampleKey:{type:String},responseSamplesResolved:{type:Array,buildTimeResolver:`openapiResponseSamples`},responsePanelResolved:{type:Object,buildTimeResolver:`openapiResponsePanel`},descriptionFileInvalid:{type:Boolean}},render:`OpenApiResponseSample`,selfClosing:!0,transform(e,n){return new t.Tag(`OpenApiResponseSample`,o(e,n))},renderForLlms(e){return r(e,`responseSamplesResolved`).map(n).join(``)}},d={attributes:{descriptionFile:{type:String,required:!0},pointer:{type:String,required:!0},mimeType:{type:String},options:{type:Object,default:{}},exampleResolved:{type:Object,buildTimeResolver:`openapiExample`},descriptionFileInvalid:{type:Boolean}},render:`OpenApiExample`,selfClosing:!0,renderForLlms(t){let n=t.attributes?.exampleResolved,r=e(n)&&e(n.apiStore)?n.apiStore:{},[a]=Object.values(e(r.exampleStore)?r.exampleStore:{});return e(a)?i(a.value,a.summary):``}},f={attributes:{descriptionFile:{type:String,required:!0},pointer:{type:String},operationId:{type:String},exampleKey:{type:String},mimeType:{type:String},parameters:{type:Object,default:{}},requestBody:{type:Object},options:{type:Object,default:{}},environments:{type:Object,default:{}},environment:{type:String},hideOtherSecuritySchemes:{type:Boolean},replayResolved:{type:Object,buildTimeResolver:`openapiReplay`},descriptionFileInvalid:{type:Boolean}},validate(e){return e.attributes.pointer&&e.attributes.operationId?[{id:`pointer-and-operationId-attributes-are-mutually-exclusive`,level:`error`,message:`The "pointer" and "operationId" attributes are mutually exclusive. Use only one.`}]:!e.attributes.pointer&&!e.attributes.operationId?[{id:`pointer-or-operationId-attribute-required`,level:`error`,message:`The tag requires a "pointer" or "operationId" attribute.`}]:[]},render:`ReplayOpenApi`,selfClosing:!0};export{c as jsonExampleTag,s as jsonSchemaTag,l as openapiCodeSampleTag,d as openapiExampleTag,u as openapiResponseSampleTag,f as replayOpenapiTag,n as sampleCodeBlock};
1
+ import{isObject as e}from"../../../shared/utils/is-object.js";import t from"@redocly/markdoc";function n({lang:e,title:t,source:n}){return`\n\`\`\`${`${e??``}${t?`${e?` `:``}${t}`:``}`}\n${(n??``).trimEnd()}\n\`\`\`\n`}function r(e,t){let n=e.attributes?.[t];return Array.isArray(n)?n:[]}function i(e,t){return e===void 0?``:`\n\`\`\`${typeof t==`string`&&t!==``?`json ${t}`:`json`}\n${JSON.stringify(e,null,2)}\n\`\`\`\n`}function a(t){if(!e(t))return t;let{components:n,openapi:r,...i}=t,{__root:a,...o}=e(n)&&e(n.schemas)?n.schemas:{};return e(a)?{...i,...a,...Object.keys(o).length>0?{components:{schemas:o}}:{}}:t}function o(e,t){let{codeSamplesResolved:n,responseSamplesResolved:r,schemaAsWritten:i,...a}=e.transformAttributes(t);return a}const s={attributes:{schema:{type:Object,buildTimeResolver:`jsonSchemaRef`},title:{type:String},options:{type:Object,default:{}},schemaResolved:{type:Object},schemaAsWritten:{type:Object},schemaResolvedErrors:{type:Array,default:[]}},render:`JsonSchema`,selfClosing:!0,transform(e,n){return new t.Tag(`JsonSchema`,o(e,n))},renderForLlms(e){return i(a(e.attributes?.schemaAsWritten??e.attributes?.schemaResolved),e.attributes?.title)}},c={attributes:{value:{buildTimeResolver:`jsonExampleRef`},schema:{buildTimeResolver:`sampleFromJsonSchema`},mode:{type:String,matches:[`read`,`write`]},title:{type:String},valueResolved:{},valueResolvedErrors:{type:Array,default:[]},schemaResolved:{},schemaResolvedErrors:{type:Array,default:[]}},render:`JsonExample`,selfClosing:!0,transform(e,n){let{valueResolved:r,valueResolvedErrors:i,schemaResolved:a,schemaResolvedErrors:o,title:s}=e.transformAttributes(n),c=r!==void 0||i.length>0;return new t.Tag(`JsonExample`,{title:s,json:c?r:a,errors:c?i:o})}},l={attributes:{descriptionFile:{type:String,required:!0},pointer:{type:String},operationId:{type:String},exampleKey:{type:String},mimeType:{type:String},language:{type:String},parameters:{type:Object,default:{}},requestBody:{type:Object},options:{type:Object,default:{}},environments:{type:Object,default:{}},environment:{type:String},codeSamplesResolved:{type:Array,buildTimeResolver:`openapiCodeSamples`},codeSamplePanelResolved:{type:Object,buildTimeResolver:`openapiCodeSamplePanel`},descriptionFileInvalid:{type:Boolean}},render:`OpenApiCodeSample`,selfClosing:!0,transform(e,n){return new t.Tag(`OpenApiCodeSample`,o(e,n))},renderForLlms(e){let t=r(e,`codeSamplesResolved`),i=t.find(({lang:e})=>e===`shell`)??t[0];return i===void 0?``:n(i)}},u={attributes:{descriptionFile:{type:String,required:!0},pointer:{type:String},operationId:{type:String},exampleKey:{type:String},responseSamplesResolved:{type:Array,buildTimeResolver:`openapiResponseSamples`},responsePanelResolved:{type:Object,buildTimeResolver:`openapiResponsePanel`},descriptionFileInvalid:{type:Boolean}},render:`OpenApiResponseSample`,selfClosing:!0,transform(e,n){return new t.Tag(`OpenApiResponseSample`,o(e,n))},renderForLlms(e){return r(e,`responseSamplesResolved`).map(n).join(``)}},d={attributes:{descriptionFile:{type:String,required:!0},pointer:{type:String,required:!0},mimeType:{type:String},options:{type:Object,default:{}},exampleResolved:{type:Object,buildTimeResolver:`openapiExample`},descriptionFileInvalid:{type:Boolean}},render:`OpenApiExample`,selfClosing:!0,renderForLlms(t){let n=t.attributes?.exampleResolved,r=e(n)&&e(n.apiStore)?n.apiStore:{},[a]=Object.values(e(r.exampleStore)?r.exampleStore:{});return e(a)?i(a.value,a.summary):``}},f={attributes:{descriptionFile:{type:String,required:!0},pointer:{type:String},operationId:{type:String},exampleKey:{type:String},mimeType:{type:String},parameters:{type:Object,default:{}},requestBody:{type:Object},options:{type:Object,default:{}},environments:{type:Object,default:{}},environment:{type:String},hideOtherSecuritySchemes:{type:Boolean},replayResolved:{type:Object,buildTimeResolver:`openapiReplay`},descriptionFileInvalid:{type:Boolean}},validate(e){return e.attributes.pointer&&e.attributes.operationId?[{id:`pointer-and-operationId-attributes-are-mutually-exclusive`,level:`error`,message:`The "pointer" and "operationId" attributes are mutually exclusive. Use only one.`}]:!e.attributes.pointer&&!e.attributes.operationId?[{id:`pointer-or-operationId-attribute-required`,level:`error`,message:`The tag requires a "pointer" or "operationId" attribute.`}]:[]},render:`ReplayOpenApi`,selfClosing:!0};export{c as jsonExampleTag,s as jsonSchemaTag,l as openapiCodeSampleTag,d as openapiExampleTag,u as openapiResponseSampleTag,f as replayOpenapiTag,n as sampleCodeBlock};
@@ -1 +1 @@
1
- import{hashJsonValue as e}from"../database/utils/json.js";import{entities as t,entityDeps as n,files as r,loaderConfigDeps as i}from"../database/schema.js";import{collectDataRefMarkers as a}from"./data-ref.js";import{replaceBlobRefsForEntityTx as o}from"../database/blobs.js";import{dedupeRouteQueryDependencies as s}from"../plugins/utils/route-index.js";import{MaterializationError as c,ProblemError as l}from"../problems/problem-error.js";import{replaceAssetRefsForEntityTx as u,upsertAssetsTx as d}from"../database/assets.js";import{createProblem as f}from"../problems/codes.js";import{problemRow as p,replaceEntityProblemsExceptCodesTx as m}from"../database/problems.js";import{replaceLinkRefsForEntityTx as h,upsertTargetInventoryTx as g}from"../database/link-refs.js";import{detectMarkdocPayloadFlag as _}from"../markdown/server/render.js";import{buildL10nAssetMap as v,dedupeAssetUsages as y,reconcileAsset as b,removeReplacedAssetFiles as x}from"./asset-reconcile.js";import{cutEntityRevisionTx as S}from"../revisions/cut.js";import{replaceRouteQueryDepsTx as C}from"../database/route-query-deps.js";import{replaceEntityRuntimeDeps as w}from"../database/origins.js";import{SEARCH_PROBLEM_CODES as T}from"../problems/producers.js";import{and as E,eq as D}from"drizzle-orm";const O=/* @__PURE__ */ new WeakMap;async function k(e){let t=await A(e.database,e.key);if(!t)throw Error(`Entity "${e.key}" is not registered.`);if(t.kind===`inline`){if(t.data===null)throw Error(`Inline entity "${e.key}" is missing its stored data.`);return t.data}if(t.status===`ready`&&t.data!==null)return t.data;let n=O.get(e.database);n===void 0&&(n=/* @__PURE__ */ new Map,O.set(e.database,n));let r=n.get(e.key);if(r!==void 0)return r;let i=j(e,t);n.set(e.key,i);try{return await i}finally{n.delete(e.key)}}async function A(e,n){let[r]=await e.db.select({id:t.id,key:t.key,kind:t.kind,pluginId:t.pluginId,loaderId:t.loaderId,loaderArgs:t.loaderArgs,type:t.type,metadata:t.metadata,status:t.status,data:t.data,markdoc:t.markdoc,dataHash:t.dataHash,version:t.version,revisionCreatedAt:t.revisionCreatedAt,isSystem:t.isSystem,invalidationSeq:t.invalidationSeq}).from(t).where(E(D(t.key,n),D(t.isCurrent,1))).limit(1);return r}async function j(i,l){if(!l.loaderId)throw Error(`Entity "${i.key}" is missing its loader id.`);let O=i.loaderRegistry.getEntityLoaderById(l.loaderId);if(!O)throw Error(`Entity loader "${l.loaderId}" is not registered.`);let[k]=await i.database.db.select({path:r.path,fileId:r.id}).from(n).leftJoin(r,D(n.originFileId,r.id)).where(D(n.entityId,l.id)).limit(1);if(!k&&!l.isSystem)throw Error(`Entity "${i.key}" has no origin dependency.`);let A=i.loaderContextFactory(O,l.loaderArgs,k?.path??``),j;try{j=await O.definition.handler(A)}catch(e){throw await M(i,l.id,e),new c(`Entity "${i.key}" failed to load.`,{cause:e})}let P=JSON.stringify(j.value??null),F=JSON.parse(P),I=j.markdoc??_(P),L=I?v(j.assetUsages??[]):void 0,R=L?{...I,l10nAssets:L}:I,z=a(F),B=Array.from(new Set(z.map(e=>e.blobKey))),V=y(j.assetUsages??[]),{contentDir:H}=i,U=H?(await Promise.all(V.map(e=>b(A.io,{contentDir:H,usage:e})))).filter(e=>e!==null):[],W=[];return await i.database.db.transaction(async n=>{let r=Date.now(),a=e(F),c=(l.dataHash??null)!==a,_=l.revisionCreatedAt;if(c&&(_=Math.max(r,l.revisionCreatedAt+1)),(await n.update(t).set({status:`ready`,data:F,markdoc:R,type:j.type??l.type,metadata:j.metadata??l.metadata,dataHash:a,revisionCreatedAt:_}).where(E(D(t.id,l.id),D(t.invalidationSeq,l.invalidationSeq))).returning({id:t.id})).length===0)return;c&&l.data!==null&&i.revisions?.isTracked(k?.path??``)&&await S(n,{current:l,max:i.revisions.max});let v=A._trackedConfig;await N(n,l.id,v?.collectDependencies()??[]);let y=A._loadedEntityKeys,b=A._globPatterns;if((j.entityDeps!==void 0||y.length>0||b.length>0)&&await w(n,{entityId:l.id,originPluginId:O.pluginId,isSystem:!!l.isSystem,deps:[...j.entityDeps??[],...y.map(e=>({kind:`entity`,key:e})),...b.map(e=>({kind:`glob`,pattern:e}))]}),await C(n,{originPluginId:O.pluginId,hook:`loader`,entityId:l.id,dependencies:s(A._routeQueries)}),await m(n,l.id,T,(j.problems??[]).map(e=>p(f(e),{scope:`entity`,entityId:l.id}))),await o(n,{entityId:l.id,blobKeys:B}),W=await d(n,U),await u(n,{entityId:l.id,refs:V.map(({path:e,hash:t})=>({path:e,hash:t}))}),(j.linkRefs!==void 0||j.targetInventories!==void 0)&&k?.path&&(await h(n,{entityId:l.id,originFileId:k.fileId,originPluginId:O.pluginId,filePath:k.path,drafts:j.linkRefs??[]}),k.fileId!==null))for(let e of j.targetInventories??[])await g(n,{fileId:k.fileId,originPluginId:O.pluginId,draft:e})}),H&&W.length>0&&await x(A.io,{contentDir:H,filenames:W,logger:i.logger}),F}async function M(e,t,n){let r=n instanceof l?n.draft:{code:`plugin/loader-failed`,message:`Loader failed for entity "${e.key}": ${n instanceof Error?n.message:String(n)}`,data:{entityKey:e.key}};try{let n=p(f(r),{scope:`entity`,entityId:t});await e.database.db.transaction(async e=>{await m(e,t,T,[n])})}catch{}}async function N(e,t,n){await e.delete(i).where(D(i.entityId,t)),n.length!==0&&await e.insert(i).values(n.map(e=>({...e,entityId:t})))}export{k as materializeEntityByKey};
1
+ import{hashJsonValue as e}from"../database/utils/json.js";import{entities as t,entityDeps as n,files as r,loaderConfigDeps as i}from"../database/schema.js";import{collectDataRefMarkers as a}from"./data-ref.js";import{replaceBlobRefsForEntityTx as o}from"../database/blobs.js";import{dedupeRouteQueryDependencies as s}from"../plugins/utils/route-index.js";import{MaterializationError as c,ProblemError as l}from"../problems/problem-error.js";import{problemRow as u,replaceEntityProblemsExceptCodesTx as d}from"../database/problems.js";import{replaceAssetRefsForEntityTx as f,upsertAssetsTx as p}from"../database/assets.js";import{createProblem as m}from"../problems/codes.js";import{replaceLinkRefsForEntityTx as h,upsertTargetInventoryTx as g}from"../database/link-refs.js";import{buildL10nAssetMap as _,dedupeAssetUsages as v,reconcileAsset as y,removeReplacedAssetFiles as b}from"./asset-reconcile.js";import{cutEntityRevisionTx as x}from"../revisions/cut.js";import{detectMarkdocPayloadFlag as S}from"../markdown/server/render.js";import{replaceRouteQueryDepsTx as C}from"../database/route-query-deps.js";import{replaceEntityRuntimeDeps as w}from"../database/origins.js";import{SEARCH_PROBLEM_CODES as T}from"../problems/producers.js";import{and as E,eq as D}from"drizzle-orm";const O=/* @__PURE__ */ new WeakMap;async function k(e){let t=await A(e.database,e.key);if(!t)throw Error(`Entity "${e.key}" is not registered.`);if(t.kind===`inline`){if(t.data===null)throw Error(`Inline entity "${e.key}" is missing its stored data.`);return t.data}if(t.status===`ready`&&t.data!==null)return t.data;let n=O.get(e.database);n===void 0&&(n=/* @__PURE__ */ new Map,O.set(e.database,n));let r=n.get(e.key);if(r!==void 0)return r;let i=j(e,t);n.set(e.key,i);try{return await i}finally{n.delete(e.key)}}async function A(e,n){let[r]=await e.db.select({id:t.id,key:t.key,kind:t.kind,pluginId:t.pluginId,loaderId:t.loaderId,loaderArgs:t.loaderArgs,type:t.type,metadata:t.metadata,status:t.status,data:t.data,markdoc:t.markdoc,dataHash:t.dataHash,version:t.version,revisionCreatedAt:t.revisionCreatedAt,isSystem:t.isSystem,invalidationSeq:t.invalidationSeq}).from(t).where(E(D(t.key,n),D(t.isCurrent,1))).limit(1);return r}async function j(i,l){if(!l.loaderId)throw Error(`Entity "${i.key}" is missing its loader id.`);let O=i.loaderRegistry.getEntityLoaderById(l.loaderId);if(!O)throw Error(`Entity loader "${l.loaderId}" is not registered.`);let[k]=await i.database.db.select({path:r.path,fileId:r.id}).from(n).leftJoin(r,D(n.originFileId,r.id)).where(D(n.entityId,l.id)).limit(1);if(!k&&!l.isSystem)throw Error(`Entity "${i.key}" has no origin dependency.`);let A=i.loaderContextFactory(O,l.loaderArgs,k?.path??``),j;try{j=await O.definition.handler(A)}catch(e){throw await M(i,l.id,e),new c(`Entity "${i.key}" failed to load.`,{cause:e})}let P=JSON.stringify(j.value??null),F=JSON.parse(P),I=j.markdoc??S(P),L=I?_(j.assetUsages??[]):void 0,R=L?{...I,l10nAssets:L}:I,z=a(F),B=Array.from(new Set(z.map(e=>e.blobKey))),V=v(j.assetUsages??[]),{contentDir:H}=i,U=H?(await Promise.all(V.map(e=>y(A.io,{contentDir:H,usage:e})))).filter(e=>e!==null):[],W=[];return await i.database.db.transaction(async n=>{let r=Date.now(),a=e(F),c=(l.dataHash??null)!==a,_=l.revisionCreatedAt;if(c&&(_=Math.max(r,l.revisionCreatedAt+1)),(await n.update(t).set({status:`ready`,data:F,markdoc:R,type:j.type??l.type,metadata:j.metadata??l.metadata,dataHash:a,revisionCreatedAt:_}).where(E(D(t.id,l.id),D(t.invalidationSeq,l.invalidationSeq))).returning({id:t.id})).length===0)return;c&&l.data!==null&&i.revisions?.isTracked(k?.path??``)&&await x(n,{current:l,max:i.revisions.max});let v=A._trackedConfig;await N(n,l.id,v?.collectDependencies()??[]);let y=A._loadedEntityKeys,b=A._globPatterns;if((j.entityDeps!==void 0||y.length>0||b.length>0)&&await w(n,{entityId:l.id,originPluginId:O.pluginId,isSystem:!!l.isSystem,deps:[...j.entityDeps??[],...y.map(e=>({kind:`entity`,key:e})),...b.map(e=>({kind:`glob`,pattern:e}))]}),await C(n,{originPluginId:O.pluginId,hook:`loader`,entityId:l.id,dependencies:s(A._routeQueries)}),await d(n,l.id,T,(j.problems??[]).map(e=>u(m(e),{scope:`entity`,entityId:l.id}))),await o(n,{entityId:l.id,blobKeys:B}),W=await p(n,U),await f(n,{entityId:l.id,refs:V.map(({path:e,hash:t})=>({path:e,hash:t}))}),(j.linkRefs!==void 0||j.targetInventories!==void 0)&&k?.path&&(await h(n,{entityId:l.id,originFileId:k.fileId,originPluginId:O.pluginId,filePath:k.path,drafts:j.linkRefs??[]}),k.fileId!==null))for(let e of j.targetInventories??[])await g(n,{fileId:k.fileId,originPluginId:O.pluginId,draft:e})}),H&&W.length>0&&await b(A.io,{contentDir:H,filenames:W,logger:i.logger}),F}async function M(e,t,n){let r=n instanceof l?n.draft:{code:`plugin/loader-failed`,message:`Loader failed for entity "${e.key}": ${n instanceof Error?n.message:String(n)}`,data:{entityKey:e.key}};try{let n=u(m(r),{scope:`entity`,entityId:t});await e.database.db.transaction(async e=>{await d(e,t,T,[n])})}catch{}}async function N(e,t,n){await e.delete(i).where(D(i.entityId,t)),n.length!==0&&await e.insert(i).values(n.map(e=>({...e,entityId:t})))}export{k as materializeEntityByKey};
@@ -1 +1 @@
1
- import{compareStrings as e}from"../../shared/utils/compare-strings.js";import{getStaticFilesOutputDir as t,getStaticManifestPath as n}from"../../shared/constants/runtime-layout.js";import{isObject as r}from"../../shared/utils/is-object.js";import{isDataRefMarker as i}from"./data-ref.js";import{resolveDataRef as a}from"../database/blobs.js";import{MaterializationError as o}from"../problems/problem-error.js";import{loadEntityRecordByKey as s}from"../database/entities.js";import{updateStaticFileBodies as c}from"../database/static-files.js";import{producerContentType as l,toStaticBodyBytes as u}from"../static/producer-value.js";import{writeFileAtomically as d}from"./asset-reconcile.js";import{join as f}from"node:path";function p(e){return new Set(e.flatMap(e=>e.kind===`producer`&&e.entityKey?[e.entityKey]:[]))}async function m(e){let t=/* @__PURE__ */ new Set;for(let n of e.staleProducers)try{await e.materializeEntity(n)}catch(r){if(!(r instanceof o))throw r;t.add(n.key),e.logger.debug(`Could not materialize the static producer ${n.key}; recorded the problem and moved on`)}let n=[];for(let r of e.rows){let i=e.resolveAudience(r);if(r.kind===`copy`){n.push(h(e.io,e.contentDir,r,i));continue}let a=await g(e.io,e.database,r,i,r.entityKey!==null&&t.has(r.entityKey));a&&n.push(a)}let r=await _(e.io,{contentDir:e.contentDir,entries:n}),i=new Map(e.rows.map(e=>[e.path,e]));return await c(e.database,r.manifest.files.filter(e=>{let t=i.get(e.path);return t?.hash!==e.hash||t.size!==e.size}).map(e=>({path:e.path,hash:e.hash,size:e.size}))),e.logger.info(`Static files: ${r.manifest.files.length} registered, ${r.written.length} written, ${r.removed.length} removed`),r.manifest}function h(e,t,n,r){if(!n.sourcePath||!n.hash)throw Error(`Static file "${n.path}" has no copy source.`);let i=f(t,n.sourcePath);return{path:n.path,hash:n.hash,contentType:n.contentType,audience:r,write:t=>e.copyFile(i,t)}}async function g(e,t,n,o,c){let d=n.entityKey?await s(t,n.entityKey):null;if(!d||d.status!==`ready`&&!c)throw Error(`Static file "${n.path}": producer entity "${n.entityKey}" is not ready.`);let f=d.data;if(!r(f)||!i(f.body)){if(c)return null;throw Error(`Static file "${n.path}": producer "${n.entityKey}" must return { body: BlobReference }.`)}let p=f.body;return{path:n.path,hash:p.blobKey,contentType:l(f,n),audience:o,write:async n=>e.writeFile(n,u(await a(t,p)))}}async function _(r,i){let a=t(i.contentDir),o=n(i.contentDir),s=new Map((await v(r,o))?.files.map(e=>[e.path,e])??[]),c=new Set(await y(r,a)),l=[],u=[];for(let e=0;e<i.entries.length;e+=16)await Promise.all(i.entries.slice(e,e+16).map(async e=>{let t=f(a,...e.path.split(`/`)),n=s.get(e.path),i=n?.hash===e.hash&&c.has(e.path)?n.size:null;i===null&&(await d(r,t,e.write),i=(await r.stat(t))?.size??0,l.push(e.path)),u.push({path:e.path,hash:e.hash,contentType:e.contentType,size:i,audience:e.audience})}));let p=new Set(i.entries.map(e=>e.path)),m=[...c].filter(e=>!p.has(e));await Promise.all(m.map(e=>r.unlink(f(a,...e.split(`/`))))),u.sort((t,n)=>e(t.path,n.path));let h={formatVersion:1,files:u};return await r.writeFile(o,JSON.stringify(h,null,2),{recursive:!0}),{manifest:h,written:l,removed:m}}async function v(e,t){try{let n=JSON.parse(await e.readFile(t));return Array.isArray(n.files)?n:null}catch{return null}}async function y(e,t,n=``){let r=[],i;try{i=await e.readdir(t)}catch{return r}for(let a of i){let i=`${n}${a.name}`;a.type===`directory`?r.push(...await y(e,f(t,a.name),`${i}/`)):a.type===`file`&&r.push(i)}return r}export{p as collectStaticProducerKeys,m as materializeStaticProducers,_ as reconcileStaticFiles};
1
+ import{compareStrings as e}from"../../shared/utils/compare-strings.js";import{getStaticFilesOutputDir as t,getStaticManifestPath as n}from"../../shared/constants/runtime-layout.js";import{isObject as r}from"../../shared/utils/is-object.js";import{isDataRefMarker as i}from"./data-ref.js";import{resolveDataRef as a}from"../database/blobs.js";import{MaterializationError as o}from"../problems/problem-error.js";import{loadEntityRecordByKey as s}from"../database/entities.js";import{updateStaticFileBodies as c}from"../database/static-files.js";import{writeFileAtomically as l}from"./asset-reconcile.js";import{producerContentType as u,toStaticBodyBytes as d}from"../static/producer-value.js";import{join as f}from"node:path";function p(e){return new Set(e.flatMap(e=>e.kind===`producer`&&e.entityKey?[e.entityKey]:[]))}async function m(e){let t=/* @__PURE__ */ new Set;for(let n of e.staleProducers)try{await e.materializeEntity(n)}catch(r){if(!(r instanceof o))throw r;t.add(n.key),e.logger.debug(`Could not materialize the static producer ${n.key}; recorded the problem and moved on`)}let n=[];for(let r of e.rows){let i=e.resolveAudience(r);if(r.kind===`copy`){n.push(h(e.io,e.contentDir,r,i));continue}let a=await g(e.io,e.database,r,i,r.entityKey!==null&&t.has(r.entityKey));a&&n.push(a)}let r=await _(e.io,{contentDir:e.contentDir,entries:n}),i=new Map(e.rows.map(e=>[e.path,e]));return await c(e.database,r.manifest.files.filter(e=>{let t=i.get(e.path);return t?.hash!==e.hash||t.size!==e.size}).map(e=>({path:e.path,hash:e.hash,size:e.size}))),e.logger.info(`Static files: ${r.manifest.files.length} registered, ${r.written.length} written, ${r.removed.length} removed`),r.manifest}function h(e,t,n,r){if(!n.sourcePath||!n.hash)throw Error(`Static file "${n.path}" has no copy source.`);let i=f(t,n.sourcePath);return{path:n.path,hash:n.hash,contentType:n.contentType,audience:r,write:t=>e.copyFile(i,t)}}async function g(e,t,n,o,c){let l=n.entityKey?await s(t,n.entityKey):null;if(!l||l.status!==`ready`&&!c)throw Error(`Static file "${n.path}": producer entity "${n.entityKey}" is not ready.`);let f=l.data;if(!r(f)||!i(f.body)){if(c)return null;throw Error(`Static file "${n.path}": producer "${n.entityKey}" must return { body: BlobReference }.`)}let p=f.body;return{path:n.path,hash:p.blobKey,contentType:u(f,n),audience:o,write:async n=>e.writeFile(n,d(await a(t,p)))}}async function _(r,i){let a=t(i.contentDir),o=n(i.contentDir),s=new Map((await v(r,o))?.files.map(e=>[e.path,e])??[]),c=new Set(await y(r,a)),u=[],d=[];for(let e=0;e<i.entries.length;e+=16)await Promise.all(i.entries.slice(e,e+16).map(async e=>{let t=f(a,...e.path.split(`/`)),n=s.get(e.path),i=n?.hash===e.hash&&c.has(e.path)?n.size:null;i===null&&(await l(r,t,e.write),i=(await r.stat(t))?.size??0,u.push(e.path)),d.push({path:e.path,hash:e.hash,contentType:e.contentType,size:i,audience:e.audience})}));let p=new Set(i.entries.map(e=>e.path)),m=[...c].filter(e=>!p.has(e));await Promise.all(m.map(e=>r.unlink(f(a,...e.split(`/`))))),d.sort((t,n)=>e(t.path,n.path));let h={formatVersion:1,files:d};return await r.writeFile(o,JSON.stringify(h,null,2),{recursive:!0}),{manifest:h,written:u,removed:m}}async function v(e,t){try{let n=JSON.parse(await e.readFile(t));return Array.isArray(n.files)?n:null}catch{return null}}async function y(e,t,n=``){let r=[],i;try{i=await e.readdir(t)}catch{return r}for(let a of i){let i=`${n}${a.name}`;a.type===`directory`?r.push(...await y(e,f(t,a.name),`${i}/`)):a.type===`file`&&r.push(i)}return r}export{p as collectStaticProducerKeys,m as materializeStaticProducers,_ as reconcileStaticFiles};
@@ -1 +1 @@
1
- import{isObject as e}from"../../../../../shared/utils/is-object.js";function t(t){if(!e(t.events))return t;let r={};if(typeof window<`u`)for(let[e,i]of Object.entries(t.events)){let t=n(i);t===void 0?console.error(`The openapi.events.${e} handler is not a function and is not used.`):r[e]=t}return{...t,events:r}}function n(e){if(typeof e==`string`)try{let t=Function(`return (${e});`)();return typeof t==`function`?t:void 0}catch{return}}export{t as withEventHandlers};
1
+ import{isObject as e}from"../../../../../shared/utils/is-object.js";function t(t){if(!e(t.events))return t;let r={};if(typeof window<`u`)for(let[e,i]of Object.entries(t.events)){let t=n(i);t===void 0?console.error(`The openapi.events.${e} handler is not a function and is not used.`):r[e]=t}return{...t,events:r}}function n(e){if(typeof e==`string`)try{let t=Function(`const __redoclyEventHandler = ${e}\nreturn __redoclyEventHandler;`)();return typeof t==`function`?t:void 0}catch{return}}export{t as withEventHandlers};
@@ -1,7 +1,15 @@
1
- import{REPLAY_OAUTH2_ROUTE_PATH as e}from"../../../../../shared/constants/replay.js";import{withPathPrefix as t}from"../../../../../shared/path-prefix.js";import{API_DOCS_INFO_BLOCK_DEP_KEY as n,API_DOCS_RENDER_DEP_KEY as r,apiPageTitle as i}from"../server/shared.js";import{ApiDocsLayoutContext as a,PageContext as o}from"../../../../../client/contexts.js";import{expandSecurityRequestValues as s,useDynamicRequestValues as c}from"../../../../../client/ApiAccess.js";import{MarkdocRenderer as l,markdocComponents as u}from"../../../../markdown/client/markdoc-components.js";import{rebaseItemLinks as d}from"./rebase-item-links.js";import{apiDocsTelemetryConfig as f}from"../../../../../client/telemetry/config.js";import{withReplayOptions as p}from"../../../../../client/replay-options.js";import{JsonSchemaTag as m}from"../../../../markdown/client/JsonSchemaTag.js";import{JsonExample as h}from"../../../../markdown/client/OpenapiTagComponents.js";import{withEventHandlers as g}from"./event-handlers.js";import{useContext as _,useEffect as v,useMemo as y}from"react";import b from"styled-components";import{useLocation as x}from"react-router";import{Fragment as S,jsx as C,jsxs as w}from"react/jsx-runtime";import{useThemeConfig as T}from"@redocly/theme/core/hooks";import{LayoutVariant as E}from"@redocly/theme/components/SidebarActions/SidebarActions";import{useLoaderData as D}from"virtual:realm-runtime";import{userMarkdocComponents as O}from"virtual:realm-markdoc-components";import{RedoclyApiDocs as k,apiDocsMarkdocComponents as A}from"@redocly/api-docs";import{Breadcrumbs as j}from"@redocly/theme/components/Breadcrumbs/Breadcrumbs";import{CatalogClassicInfoBlock as M}from"@redocly/theme/components/CatalogClassic/CatalogClassicInfoBlock";import{MissingTranslationNotice as N}from"@redocly/theme/components/MissingTranslationNotice/MissingTranslationNotice";import{ThreePanelLayout as P}from"@redocly/theme/layouts/ThreePanelLayout";const F={...u,JsonSchema:O.JsonSchema??m,JsonExample:O.JsonExample??h,...A},I={parse:e=>e,render:e=>/* @__PURE__ */ C(l,{ast:e,components:F})},L={MiddlePanelHeader:R};function R(){return/* @__PURE__ */ w(S,{children:[/* @__PURE__ */ C(j,{}),/* @__PURE__ */ C(U,{})]})}function z(e){return(e.length>1&&e.endsWith(`/`)?e.slice(0,-1):e).toLowerCase()}function B({page:e}){let t=D(r),i=D(n),{layout:o}=_(a),l=V(),u=c(),m=y(()=>{if(!t)return t;let e=s(u,Object.values(t.store.securitySchemeStore??{}));return{...g(p(t.options)),oAuth2RedirectURI:H(),userClaims:l,unstable_hooks:L,dynamicRequestValues:e}},[t,l,u]),h=e.slug.toLowerCase(),v=y(()=>t&&t.basePath!==h?d(t.items,t.basePath,h):t?.items,[t,h]);if(G(e.metadata,v,t?.title),!t)return null;let b=f();return/* @__PURE__ */ w(S,{children:[i&&/* @__PURE__ */ C(W,{layout:o,children:/* @__PURE__ */ C(M,{metadata:i})}),/* @__PURE__ */ C(k,{items:v,store:t.store,options:m,basePath:h,layout:o,markdownAdapter:I,telemetryConfig:b})]})}function V(){let e=_(o)?.auth?.userInfo,t=e?.isAuthenticated?e.email:void 0,n=e?.isAuthenticated?e.name:void 0;return y(()=>({email:t,name:n}),[t,n])}function H(){if(typeof window<`u`)return new URL(t(e),window.location.origin).toString()}const U=b(N)`
1
+ import{REPLAY_OAUTH2_ROUTE_PATH as e}from"../../../../../shared/constants/replay.js";import{withPathPrefix as t}from"../../../../../shared/path-prefix.js";import{API_DOCS_INFO_BLOCK_DEP_KEY as n,API_DOCS_RENDER_DEP_KEY as r,apiPageTitle as i}from"../server/shared.js";import{ApiDocsLayoutContext as a,PageContext as o}from"../../../../../client/contexts.js";import{expandSecurityRequestValues as s,useDynamicRequestValues as c}from"../../../../../client/ApiAccess.js";import{MarkdocBlocks as l,markdocComponents as u}from"../../../../markdown/client/markdoc-components.js";import{rebaseItemLinks as d}from"./rebase-item-links.js";import{apiDocsTelemetryConfig as f}from"../../../../../client/telemetry/config.js";import{withReplayOptions as p}from"../../../../../client/replay-options.js";import{JsonSchemaTag as m}from"../../../../markdown/client/JsonSchemaTag.js";import{JsonExample as h}from"../../../../markdown/client/OpenapiTagComponents.js";import{withEventHandlers as g}from"./event-handlers.js";import{useContext as _,useEffect as v,useMemo as y}from"react";import b from"styled-components";import{useLocation as x}from"react-router";import{Fragment as S,jsx as C,jsxs as w}from"react/jsx-runtime";import{useThemeConfig as T}from"@redocly/theme/core/hooks";import{LayoutVariant as E}from"@redocly/theme/components/SidebarActions/SidebarActions";import{useLoaderData as D}from"virtual:realm-runtime";import{userMarkdocComponents as O}from"virtual:realm-markdoc-components";import{RedoclyApiDocs as k,apiDocsMarkdocComponents as A}from"@redocly/api-docs";import{Breadcrumbs as j}from"@redocly/theme/components/Breadcrumbs/Breadcrumbs";import{CatalogClassicInfoBlock as M}from"@redocly/theme/components/CatalogClassic/CatalogClassicInfoBlock";import{MissingTranslationNotice as N}from"@redocly/theme/components/MissingTranslationNotice/MissingTranslationNotice";import{ThreePanelLayout as P}from"@redocly/theme/layouts/ThreePanelLayout";const F={...u,JsonSchema:O.JsonSchema??m,JsonExample:O.JsonExample??h,...A},I={parse:e=>e,render:e=>/* @__PURE__ */ C(l,{ast:e,components:F})},L={MiddlePanelHeader:R};function R(){return/* @__PURE__ */ w(S,{children:[/* @__PURE__ */ C(j,{}),/* @__PURE__ */ C(W,{})]})}function z(e){return(e.length>1&&e.endsWith(`/`)?e.slice(0,-1):e).toLowerCase()}function B({page:e}){let t=D(r),i=D(n),{layout:o}=_(a),l=V(),u=c(),m=y(()=>{if(!t)return t;let e=s(u,Object.values(t.store.securitySchemeStore??{}));return{...g(p(t.options)),oAuth2RedirectURI:H(),userClaims:l,unstable_hooks:L,dynamicRequestValues:e}},[t,l,u]),h=e.slug.toLowerCase(),v=y(()=>t&&t.basePath!==h?d(t.items,t.basePath,h):t?.items,[t,h]);if(K(e.metadata,v,t?.title),!t)return null;let b=f();return/* @__PURE__ */ w(U,{children:[i&&/* @__PURE__ */ C(G,{layout:o,children:/* @__PURE__ */ C(M,{metadata:i})}),/* @__PURE__ */ C(k,{items:v,store:t.store,options:m,basePath:h,layout:o,markdownAdapter:I,telemetryConfig:b})]})}function V(){let e=_(o)?.auth?.userInfo,t=e?.isAuthenticated?e.email:void 0,n=e?.isAuthenticated?e.name:void 0;return y(()=>({email:t,name:n}),[t,n])}function H(){if(typeof window<`u`)return new URL(t(e),window.location.origin).toString()}const U=b.main`
2
+ [data-section-id] {
3
+ scroll-margin-top: var(--navbar-offset);
4
+ }
5
+
6
+ [id]:not([data-section-id]):has([data-deep-link-anchor]) {
7
+ scroll-margin-top: calc(var(--navbar-offset) + var(--deep-link-scroll-gap, var(--spacing-xl)));
8
+ }
9
+ `,W=b(N)`
2
10
  width: 100%;
3
- `,W=b(P)`
11
+ `,G=b(P)`
4
12
  && {
5
13
  padding-right: ${({layout:e})=>e===E.THREE_PANEL?`calc(var(--panel-gap-horizontal) * 2)`:`var(--panel-gap-horizontal)`};
6
14
  }
7
- `;function G(e,t,n){let{pathname:r}=x(),{seo:a}=T(),o=a?.projectTitle,s=t?i(e,t,z(r),n):void 0;v(()=>{s&&(document.title=o?`${s} | ${o}`:s)},[s,o])}export{B as default};
15
+ `;function K(e,t,n){let{pathname:r}=x(),{seo:a}=T(),o=a?.projectTitle,s=t?i(e,t,z(r),n):void 0;v(()=>{s&&(document.title=o?`${s} | ${o}`:s)},[s,o])}export{B as default};
@@ -1 +1 @@
1
- import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t}from"../../../loaders/define.js";import{runtimeFile as n}from"../../utils/runtime-file.js";import{runtimeTemplate as r}from"../../templates.js";import{SEARCH_API_TITLE_FACET_FIELD as i,SEARCH_API_VERSION_FACET_FIELD as a,SEARCH_GROUP_FACET_FIELD as o}from"../../../../shared/search/facets.js";import{configuredFacetFields as s,extractFacetsFromFrontmatter as c,invalidFacetValueProblems as l,searchCategoryOf as u}from"../../../search/facet-values.js";import{isPlanFeatureGranted as d}from"../../../../shared/plan-gates.js";import{toPosixPath as f}from"../../../../shared/utils/to-posix-path.js";import{TRANSLATIONS_FILE_PATTERN as p}from"../../../../shared/constants/l10n/defaults.js";import{isObject as m}from"../../../../shared/utils/is-object.js";import{notInPlanProblem as h}from"../../../plan-gates.js";import{filePathToRouteSlug as g}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{SPEC_KIND_ARAZZO as _,SPEC_KIND_ASYNCAPI as v,SPEC_KIND_GRAPHQL as y,SPEC_KIND_OPENAPI as b}from"../../../../shared/constants/api-spec-kinds.js";import{packMarkdocAstsDeep as x,unpackMarkdocAstsDeep as S}from"../../../../shared/utils/packed-ast.js";import{parseMarkdownCached as C}from"../../../markdown/utils/parse-cache.js";import{createApiEntityKey as w}from"../../utils/api-entity-key.js";import{API_DOCS_API_LOADER_ID as ee,API_DOCS_PLUGIN_ID as T,API_DOCS_RENDER_DEP_KEY as te,API_DOCS_RENDER_LOADER_ID as ne,API_DOCS_SIDEBAR_LOADER_ID as E,API_DOCS_TEMPLATE_ID as D,SPEC_DOWNLOAD_ROUTE_PATHS as O,SPEC_PATH_PARAM as k}from"./server/shared.js";import{resolveApiBundleConfig as re,resolveApiOptions as ie,resolveNestedFeedback as ae,schemaCatalogLink as oe,withDownloadUrls as se,withFeedbackOption as ce,withMockServerOption as le}from"./server/options.js";import{annotateApiDocsRbac as ue}from"../../../../shared/rbac/api-docs.js";import{SERVER_ONLY_VALUE_KEY as A}from"../../../loaders/server-only-value.js";import{getLoadedProjectPlugins as de}from"../../project/loaded-set.js";import{API_OUTPUT_MANIFEST_KEY as j}from"../../../api-outputs.js";import{API_DOCS_MARKDOC_TAG_SET as M,resolveMarkdocTagSet as N}from"../../../markdown/constants/tag-sets.js";import{pageLocale as P}from"../../utils/page-locale.js";import{buildBundledApiDefinition as F,resolveLlmsDescriptions as I}from"./server/build-definition.js";import{collectSidebarSubpathTargets as L,toSidebarSubtree as R,toSubpathTarget as z}from"./server/build-sidebar.js";import{buildApiDocsMarkdownDocs as B}from"./server/markdown-docs.js";import{join as V,relative as H}from"node:path";import fe from"@redocly/markdoc";const pe=[`.yaml`,`.yml`,`.json`,`.gql`,`.graphql`],me={[b]:`OpenAPI`,[v]:`AsyncAPI`,[y]:`GraphQL`,[_]:`Arazzo`},U=t(ne,async e=>{let{buildItems:t}=await import(`@redocly/api-docs/server`),n=K(e),r=await e.io.readFile(n.absolutePath),i=e.routes.byFilePath(e.file.path)?.slug,a=se(e.args.options,e.file.path,e.args.kind),o=e.args.kind===`openapi`?le(a,e.config,i):a,s={entityDeps:[],assetUsages:[],linkRefs:[],problems:[],pending:[]},c=G(e.contentDir),l={markdown:e.markdown,loader:{config:e.config,entities:e.entities,file:e.file,io:e.io,logger:e.logger,plugin:e.plugin},sink:s},u=await F({kind:e.args.kind,source:r,relativePath:n.relativePath,contentDir:e.contentDir,pagePath:e.file.path,options:o,bundle:q(e.args,c),metadata:X(e.args.options),markdownResolution:l,rbac:{warn:t=>e.logger?.warn(t)}}),d={...m(u.document)&&m(u.document.info)?{infoDescription:u.document.info.description}:{},...await I(u.document,l,{contentDir:e.contentDir,specPath:n.relativePath,pagePath:e.file.path})};e.args.kind===`openapi`&&o.showSchemaCatalogLinks&&m(u.document)&&(u.document[`x-schema-catalog-link`]=oe(e.file.path)),u.options=ce(u.options,u.document,e.args.feedback??e.config.feedback);let f=i?.toLowerCase()??`/`,{items:p,store:h,specType:g}=await t({...u,basePath:f,markdownParser:e=>fe.compact(C(e))}),_=JSON.stringify({items:x(p),store:x(h),options:u.options,specType:g,basePath:f,title:be(u.document,e.args.kind,p),metadata:ye(u.document),[A]:{llms:d}});return{value:await e.createBlobRef(_,{format:`json`}),entityDeps:[...Y(e.file.path,[...u.fileDependencies,...c.paths]),...s.entityDeps],assetUsages:s.assetUsages,markdoc:{tagSet:M},linkRefs:s.linkRefs,problems:s.problems}},{async searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let n=S(e),r=await Ee(t.entities,t.route.originFilePath),d={...t.route.metadata,...m(n.metadata)?n.metadata:{}},{category:f,isInvalid:p}=u(d),{facets:h,invalidFields:g}=c({[i]:t.route.metadata.title,[a]:t.route.metadata.version,...d},s(t.config)),{buildApiDocsSearchDocuments:_}=await import(`./server/search-documents.js`);return{..._(n,r,{groupKey:f,facets:h,warn:e=>t.logger?.warn(e)}),problems:l([...g,...p?[o]:[]],t.route.originFilePath)}},async markdown(e,t){if(t.route===void 0)return null;let n=S(e),r=t.route.originFilePath??void 0,i=r?await t.entities.load(w(r)).catch(()=>void 0):void 0,{tags:a}=await N(M);return B(n,ve(i,n[A]?.llms),r,{tags:a,locale:P(t)})},usesProjectMarkdocSchema:!0}),W=t(ee,async e=>{let t=K(e),n=await e.io.readFile(t.absolutePath),r=G(e.contentDir),i=await F({kind:e.args.kind,source:n,relativePath:t.relativePath,contentDir:e.contentDir,bundle:q(e.args,r),metadata:X(e.args.options)}),a=e.args.kind===y,o=a?n:JSON.stringify(i.document);return{value:o.length>65536?await e.createBlobRef(o,{format:a?`text`:`json`}):a?n:i.document,metadata:{...Z(e.file.path,e.args.kind,e.args.options,e.args.rbac),...ge(i.document,e.routes.byFilePath(e.file.path)?.slug)},entityDeps:Y(e.file.path,[...i.fileDependencies,...r.paths])}});function G(e){let t=de(e)?.lintPlugins??[];return{plugins:t,paths:t.map(t=>f(H(e,t.path))).filter(e=>e!==``&&!e.startsWith(`../`))}}function K(e){let t=e.args.source?.path??e.file.path;return{relativePath:t,absolutePath:V(e.contentDir,t)}}function he(e){let t=e[j];return m(t)&&typeof t.root==`string`?t.root:void 0}function q(e,t){let{config:n,configDir:r}=e.bundleConfig??{config:{},configDir:``};return{config:n,configDir:r,plugins:t.plugins}}function ge(e,t){let n=m(e)&&m(e.info)?e.info:{},r=m(n[`x-metadata`])?n[`x-metadata`]:{},i=typeof n.description==`string`?n.description.trim():``;return{...t===void 0?{}:{routeSlug:t},...Q(n.version)?{version:String(n.version)}:{},...typeof r.apiId==`string`?{apiId:r.apiId}:{},description:i||void 0}}const J=t(E,async e=>{let{buildNavItems:t,collectPreviousRouteSlugs:n}=await import(`@redocly/api-docs/server`),r=await e.entities.load(w(e.file.path)),i=e.args.kind===`graphql`?(await import(`graphql`)).parse(r):r,a=ue(i,e.args.kind,{warn:t=>e.logger?.warn(t)}),{items:o}=await t({type:e.args.kind,document:a,options:e.args.options,basePath:`/`,markdownParser:C}),s=R(o),c=n(o).map(({from:e})=>z(e));return{value:s,targetInventories:[{kind:`subpath`,exhaustive:!0,targets:[...L(s),...c]}]}});function Y(e,t){return[{kind:`file`,path:e},...t.map(e=>({kind:`file`,path:e}))]}const _e={arazzo:`Arazzo Docs`,asyncapi:`AsyncAPI Docs`,graphql:`GraphQL Docs`,openapi:`OpenAPI Docs`};function ve(e,t){if(t===void 0||!m(e))return e;let n=m(e.info)?e.info:{},r=m(e.components)?e.components:{};return{...e,...t.infoDescription===void 0?{}:{info:{...n,description:t.infoDescription}},...t.servers===void 0?{}:{servers:t.servers},...t.securitySchemes===void 0?{}:{components:{...r,securitySchemes:t.securitySchemes}}}}function ye(e){let t=m(e)&&m(e.info)?e.info:{};return m(t[`x-metadata`])?t[`x-metadata`]:{}}function be(e,t,n){let r=m(e)&&m(e.info)?e.info:{};if(typeof r.title==`string`&&r.title!==``)return r.title;let i=m(n[0])?n[0].label:void 0;return typeof i==`string`&&i!==``?i:_e[t]}const xe=[`rbac`,`sidebar`,`excludeFromSearch`,`template`];function Se(e,t){let n=m(e.manifest.info)?e.manifest.info:{},r={};typeof n.title==`string`&&(r.title=n.title),Q(n.version)&&(r.version=String(n.version)),typeof n.summary==`string`&&(r.summary=n.summary),m(n[`x-metadata`])&&Object.assign(r,n[`x-metadata`]),m(t.metadata)&&Object.assign(r,t.metadata);for(let e of xe)delete r[e];return r}function X(e){return m(e.metadata)?e.metadata:void 0}function Ce(e){let t=X(e)?.title;return typeof t==`string`&&t.length>0?t:void 0}function Z(e,t,n,r){let i=Ce(n);return{specType:t,sourcePath:e,...i===void 0?{}:{title:i},...r===void 0?{}:{rbac:r},...Object.keys(n).length>0?{options:n}:{},...m(n.mockServer)?{mockServer:n.mockServer}:{}}}function Q(e){return typeof e==`string`||typeof e==`number`}function we(e){if(e.ext===`.gql`||e.ext===`.graphql`)return y;let{openapi:t,swagger:n,asyncapi:r,arazzo:i}=e.manifest;return Q(t)||Q(n)?b:Q(r)?v:Q(i)?_:null}const Te=e({id:T,version:`0.45.0`,content:{filter:{extensions:pe},async extractFile(e,t){if(p.test(e.path))return null;let n=we(e);if(n===null)return null;if(n!==`arazzo`&&!d(t.config,n))return{routes:[],problems:[h(`${me[n]} documents`)]};let r=e.path,i=he(e.manifest),a=i??r,{rbac:o,...s}=await ie(t.io,t.config,r,n,a),c={filePath:r,kind:n,options:s,...o===void 0||!d(t.config,`rbac`)?{}:{rbac:o}};i!==void 0&&(c.source={path:i});let l=await ae(t.io,t.config,a);if(l!==void 0&&(c.feedback=l),n!==`graphql`){let e=await re(t.io,t.config,r,a);Object.keys(e.config).length>0&&(c.bundleConfig=e)}let u=W.withArgs(c,{stableKey:w(r),type:`api`,metadata:Z(r,n,s,c.rbac)});if(n===`arazzo`)return{routes:[],entities:[u]};let f=Se(e,s);s.excludeFromSearch===!0&&(f.excludeFromSearch=!0),f.type=n,c.rbac!==void 0&&(f.rbac=c.rbac);let m=U.withArgs(c,{stableKey:`api-docs:render:${r}`}),_=J.withArgs(c,{stableKey:`api-docs:sidebar:${r}`}),v=g(r);return{routes:[{deps:{[te]:m},metadata:f,routeId:`page`,sidebarSubtree:_,slug:null,slugHint:v,template:D,wildcardPrefix:!0}],entities:[u,m,_]}}},loaders:[W,U,J],templates:{[D]:r(n(`./client/template.tsx`,import.meta.url))},server:{routes:[$(O.bundle,`bundle`),$(O.deprecatedBundle,`bundle`),$(O.graphql,`graphql`)]}});function $(e,t){return{method:`GET`,path:e+k,handler:{filePath:`./server/spec-download.ts`,importer:import.meta.url,exportName:t}}}async function Ee(e,t){if(t)try{return await e.load(w(t))}catch{return}}export{Te as apiDocsContentPlugin};
1
+ import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t}from"../../../loaders/define.js";import{runtimeFile as n}from"../../utils/runtime-file.js";import{runtimeTemplate as r}from"../../templates.js";import{SEARCH_API_TITLE_FACET_FIELD as i,SEARCH_API_VERSION_FACET_FIELD as a,SEARCH_GROUP_FACET_FIELD as o}from"../../../../shared/search/facets.js";import{configuredFacetFields as s,extractFacetsFromFrontmatter as c,invalidFacetValueProblems as l,searchCategoryOf as u}from"../../../search/facet-values.js";import{isPlanFeatureGranted as d}from"../../../../shared/plan-gates.js";import{toPosixPath as f}from"../../../../shared/utils/to-posix-path.js";import{TRANSLATIONS_FILE_PATTERN as p}from"../../../../shared/constants/l10n/defaults.js";import{isObject as m}from"../../../../shared/utils/is-object.js";import{notInPlanProblem as h}from"../../../plan-gates.js";import{filePathToRouteSlug as g}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{SPEC_KIND_ARAZZO as _,SPEC_KIND_ASYNCAPI as v,SPEC_KIND_GRAPHQL as y,SPEC_KIND_OPENAPI as b}from"../../../../shared/constants/api-spec-kinds.js";import{packMarkdocAstsDeep as x,unpackMarkdocAstsDeep as S}from"../../../../shared/utils/packed-ast.js";import{findVersionFolder as ee}from"../../utils/version-path.js";import{toPublicVersionedSlug as C}from"../../../../shared/constants/versions.js";import{readVersionsYaml as te,versionsYamlPath as ne}from"../../../versions/version-groups.js";import{parseMarkdownCached as w}from"../../../markdown/utils/parse-cache.js";import{createApiEntityKey as T}from"../../utils/api-entity-key.js";import{API_DOCS_API_LOADER_ID as E,API_DOCS_PLUGIN_ID as D,API_DOCS_RENDER_DEP_KEY as re,API_DOCS_RENDER_LOADER_ID as ie,API_DOCS_SIDEBAR_LOADER_ID as ae,API_DOCS_TEMPLATE_ID as O,SPEC_DOWNLOAD_ROUTE_PATHS as k,SPEC_PATH_PARAM as oe}from"./server/shared.js";import{resolveApiBundleConfig as se,resolveApiOptions as ce,resolveNestedFeedback as le,schemaCatalogLink as ue,withDownloadUrls as de,withFeedbackOption as fe,withMockServerOption as pe}from"./server/options.js";import{annotateApiDocsRbac as A}from"../../../../shared/rbac/api-docs.js";import{SERVER_ONLY_VALUE_KEY as j}from"../../../loaders/server-only-value.js";import{getLoadedProjectPlugins as M}from"../../project/loaded-set.js";import{API_OUTPUT_MANIFEST_KEY as N}from"../../../api-outputs.js";import{API_DOCS_MARKDOC_TAG_SET as P,resolveMarkdocTagSet as F}from"../../../markdown/constants/tag-sets.js";import{pageLocale as I}from"../../utils/page-locale.js";import{buildBundledApiDefinition as L,resolveLlmsDescriptions as R}from"./server/build-definition.js";import{collectSidebarSubpathTargets as z,toSidebarSubtree as B,toSubpathTarget as me}from"./server/build-sidebar.js";import{buildApiDocsMarkdownDocs as he}from"./server/markdown-docs.js";import{join as ge,relative as _e,resolve as V}from"node:path";import ve from"@redocly/markdoc";async function ye(e,t){let n=t.originFilePath===null?null:ee(t.originFilePath);if(n===null||t.version===null||t.versionGroup===null)return{slug:t.slug,entityDeps:[]};let r=(await te({io:{exists:t=>e.io.exists(V(e.contentDir,t)),readFile:t=>e.io.readFile(V(e.contentDir,t))},directory:n.parent}))?.default===t.version;return{slug:C(t.slug,t.versionGroup,t.version,r),entityDeps:[{kind:`file`,path:ne(n.parent)}]}}const be=[`.yaml`,`.yml`,`.json`,`.gql`,`.graphql`],xe={[b]:`OpenAPI`,[v]:`AsyncAPI`,[y]:`GraphQL`,[_]:`Arazzo`},H=t(ie,async e=>{let{buildItems:t,descriptionOptions:n}=await import(`@redocly/api-docs/server`),r=G(e),i=await e.io.readFile(r.absolutePath),a=e.routes.byFilePath(e.file.path),o=a?.slug,s=a&&e.args.kind===`openapi`?await ye(e,a):{slug:void 0,entityDeps:[]},c=de(e.args.options,e.file.path,e.args.kind),l=e.args.kind===`openapi`?pe(c,e.config,s.slug):c,u={entityDeps:[],assetUsages:[],linkRefs:[],problems:[],pending:[]},d=W(e.contentDir),f={markdown:e.markdown,loader:{config:e.config,entities:e.entities,file:e.file,io:e.io,logger:e.logger,plugin:e.plugin},sink:u},p=await L({kind:e.args.kind,source:i,relativePath:r.relativePath,contentDir:e.contentDir,pagePath:e.file.path,options:l,bundle:K(e.args,d),metadata:X(e.args.options),markdownResolution:f,rbac:{warn:t=>e.logger?.warn(t)}}),h={...m(p.document)&&m(p.document.info)?{infoDescription:p.document.info.description}:{},...await R(p.document,f,{contentDir:e.contentDir,specPath:r.relativePath,pagePath:e.file.path})};e.args.kind===`openapi`&&l.showSchemaCatalogLinks&&m(p.document)&&(p.document[`x-schema-catalog-link`]=ue(e.file.path)),p.options={...fe(p.options,p.document,e.args.feedback??e.config.feedback),...n(e.args.kind,p.document,X(e.args.options))};let g=o?.toLowerCase()??`/`,{items:_,store:v,specType:y}=await t({...p,basePath:g,markdownParser:e=>ve.compact(w(e))}),b=JSON.stringify({items:x(_),store:x(v),options:p.options,specType:y,basePath:g,title:Ee(p.document,e.args.kind,_),metadata:Te(p.document),[j]:{llms:h}});return{value:await e.createBlobRef(b,{format:`json`}),entityDeps:[...J(e.file.path,[...p.fileDependencies,...d.paths]),...u.entityDeps,...s.entityDeps],assetUsages:u.assetUsages,markdoc:{tagSet:P},linkRefs:u.linkRefs,problems:u.problems}},{async searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let n=S(e),r=await Me(t.entities,t.route.originFilePath),d={...t.route.metadata,...m(n.metadata)?n.metadata:{}},{category:f,isInvalid:p}=u(d),{facets:h,invalidFields:g}=c({[i]:t.route.metadata.title,[a]:t.route.metadata.version,...d},s(t.config)),{buildApiDocsSearchDocuments:_}=await import(`./server/search-documents.js`);return{..._(n,r,{groupKey:f,facets:h,warn:e=>t.logger?.warn(e)}),problems:l([...g,...p?[o]:[]],t.route.originFilePath)}},async markdown(e,t){if(t.route===void 0)return null;let n=S(e),r=t.route.originFilePath??void 0,i=r?await t.entities.load(T(r)).catch(()=>void 0):void 0,{tags:a}=await F(P);return he(n,A(Y(i,n[j]?.llms),n.specType,{warn:e=>t.logger?.warn(e)}),r,{tags:a,locale:I(t)})},usesProjectMarkdocSchema:!0}),U=t(E,async e=>{let t=G(e),n=await e.io.readFile(t.absolutePath),r=W(e.contentDir),i=await L({kind:e.args.kind,source:n,relativePath:t.relativePath,contentDir:e.contentDir,bundle:K(e.args,r),metadata:X(e.args.options)}),a=e.args.kind===y,o=a?n:JSON.stringify(i.document);return{value:o.length>65536?await e.createBlobRef(o,{format:a?`text`:`json`}):a?n:i.document,metadata:{...Z(e.file.path,e.args.kind,e.args.options,e.args.rbac),...Ce(i.document,e.routes.byFilePath(e.file.path)?.slug)},entityDeps:J(e.file.path,[...i.fileDependencies,...r.paths]),problems:i.problems}});function W(e){let t=M(e)?.lintPlugins??[];return{plugins:t,paths:t.map(t=>f(_e(e,t.path))).filter(e=>e!==``&&!e.startsWith(`../`))}}function G(e){let t=e.args.source?.path??e.file.path;return{relativePath:t,absolutePath:ge(e.contentDir,t)}}function Se(e){let t=e[N];return m(t)&&typeof t.root==`string`?t.root:void 0}function K(e,t){let{config:n,configDir:r}=e.bundleConfig??{config:{},configDir:``};return{config:n,configDir:r,plugins:t.plugins}}function Ce(e,t){let n=m(e)&&m(e.info)?e.info:{},r=m(n[`x-metadata`])?n[`x-metadata`]:{},i=typeof n.description==`string`?n.description.trim():``;return{...t===void 0?{}:{routeSlug:t},...Q(n.version)?{version:String(n.version)}:{},...typeof r.apiId==`string`?{apiId:r.apiId}:{},description:i||void 0}}const q=t(ae,async e=>{let{buildNavItems:t,collectPreviousRouteSlugs:n}=await import(`@redocly/api-docs/server`),r=await e.entities.load(T(e.file.path)),i=e.args.kind===`graphql`?(await import(`graphql`)).parse(r):r,a=A(i,e.args.kind,{warn:t=>e.logger?.warn(t)}),{items:o}=await t({type:e.args.kind,document:a,options:e.args.options,basePath:`/`,markdownParser:w}),s=B(o),c=n(o).map(({from:e})=>me(e));return{value:s,targetInventories:[{kind:`subpath`,exhaustive:!0,targets:[...z(s),...c]}]}});function J(e,t){return[{kind:`file`,path:e},...t.map(e=>({kind:`file`,path:e}))]}const we={arazzo:`Arazzo Docs`,asyncapi:`AsyncAPI Docs`,graphql:`GraphQL Docs`,openapi:`OpenAPI Docs`};function Y(e,t){if(t===void 0||!m(e))return e;let n=m(e.info)?e.info:{},r=m(e.components)?e.components:{};return{...e,...t.infoDescription===void 0?{}:{info:{...n,description:t.infoDescription}},...t.servers===void 0?{}:{servers:t.servers},...t.securitySchemes===void 0?{}:{components:{...r,securitySchemes:t.securitySchemes}}}}function Te(e){let t=m(e)&&m(e.info)?e.info:{};return m(t[`x-metadata`])?t[`x-metadata`]:{}}function Ee(e,t,n){let r=m(e)&&m(e.info)?e.info:{};if(typeof r.title==`string`&&r.title!==``)return r.title;let i=m(n[0])?n[0].label:void 0;return typeof i==`string`&&i!==``?i:we[t]}const De=[`rbac`,`sidebar`,`excludeFromSearch`,`template`];function Oe(e,t){let n=m(e.manifest.info)?e.manifest.info:{},r={};typeof n.title==`string`&&(r.title=n.title),Q(n.version)&&(r.version=String(n.version)),typeof n.summary==`string`&&(r.summary=n.summary),m(n[`x-metadata`])&&Object.assign(r,n[`x-metadata`]),m(t.metadata)&&Object.assign(r,t.metadata);for(let e of De)delete r[e];return r}function X(e){return m(e.metadata)?e.metadata:void 0}function ke(e){let t=X(e)?.title;return typeof t==`string`&&t.length>0?t:void 0}function Z(e,t,n,r){let i=ke(n);return{specType:t,sourcePath:e,...i===void 0?{}:{title:i},...r===void 0?{}:{rbac:r},...Object.keys(n).length>0?{options:n}:{},...m(n.mockServer)?{mockServer:n.mockServer}:{}}}function Q(e){return typeof e==`string`||typeof e==`number`}function Ae(e){if(e.ext===`.gql`||e.ext===`.graphql`)return y;let{openapi:t,swagger:n,asyncapi:r,arazzo:i}=e.manifest;return Q(t)||Q(n)?b:Q(r)?v:Q(i)?_:null}const je=e({id:D,version:`0.48.0`,content:{filter:{extensions:be},async extractFile(e,t){if(p.test(e.path))return null;let n=Ae(e);if(n===null)return null;if(n!==`arazzo`&&!d(t.config,n))return{routes:[],problems:[h(`${xe[n]} documents`)]};let r=e.path,i=Se(e.manifest),a=i??r,{rbac:o,...s}=await ce(t.io,t.config,r,n,a),c={filePath:r,kind:n,options:s,...o===void 0||!d(t.config,`rbac`)?{}:{rbac:o}};i!==void 0&&(c.source={path:i});let l=await le(t.io,t.config,a);if(l!==void 0&&(c.feedback=l),n!==`graphql`){let e=await se(t.io,t.config,r,a);Object.keys(e.config).length>0&&(c.bundleConfig=e)}let u=U.withArgs(c,{stableKey:T(r),type:`api`,metadata:Z(r,n,s,c.rbac)});if(n===`arazzo`)return{routes:[],entities:[u]};let f=Oe(e,s);s.excludeFromSearch===!0&&(f.excludeFromSearch=!0),f.type=n,c.rbac!==void 0&&(f.rbac=c.rbac);let m=H.withArgs(c,{stableKey:`api-docs:render:${r}`}),_=q.withArgs(c,{stableKey:`api-docs:sidebar:${r}`}),v=g(r);return{routes:[{deps:{[re]:m},metadata:f,routeId:`page`,sidebarSubtree:_,slug:null,slugHint:v,template:O,wildcardPrefix:!0}],entities:[u,m,_]}}},loaders:[U,H,q],templates:{[O]:r(n(`./client/template.tsx`,import.meta.url))},server:{routes:[$(k.bundle,`bundle`),$(k.deprecatedBundle,`bundle`),$(k.graphql,`graphql`)]}});function $(e,t){return{method:`GET`,path:e+oe,handler:{filePath:`./server/spec-download.ts`,importer:import.meta.url,exportName:t}}}async function Me(e,t){if(t)try{return await e.load(T(t))}catch{return}}export{je as apiDocsContentPlugin};