@redocly/framework 1.0.0-next.2 → 1.0.0-next.4

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 (225) 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/build/vite-config.js +2 -2
  4. package/dist/bundler/dev/materialization-sweeper.js +1 -1
  5. package/dist/bundler/dev/routes/dev-problems-route.js +1 -1
  6. package/dist/bundler/dev/routes/source-sync-route.js +1 -1
  7. package/dist/bundler/dev/run.js +1 -1
  8. package/dist/bundler/dev/runtime-app.js +1 -1
  9. package/dist/bundler/dev/vite-chunk-url.js +1 -1
  10. package/dist/bundler/user-markdoc-schema.js +1 -1
  11. package/dist/bundler/vite-config.base.js +8 -8
  12. package/dist/cli/args.js +1 -1
  13. package/dist/cli/commands/build.js +1 -1
  14. package/dist/cli/commands/dev.js +1 -1
  15. package/dist/cli/commands/ingest.js +1 -1
  16. package/dist/cli/commands/translate.js +2 -2
  17. package/dist/cli/dev-console/index.js +1 -1
  18. package/dist/cli/log-output/index.js +1 -1
  19. package/dist/cli/validate-react-pages.js +1 -1
  20. package/dist/client/RuntimeLink.js +1 -0
  21. package/dist/client/ai-search/use-ai-search.js +1 -1
  22. package/dist/client/analytics-page-view.js +1 -1
  23. package/dist/client/app.js +3 -3
  24. package/dist/client/client-entry.js +1 -1
  25. package/dist/client/contexts.js +1 -1
  26. package/dist/client/dev-problems/ProblemsBar.js +1 -1
  27. package/dist/client/experiments/runtime.js +1 -1
  28. package/dist/client/feedback.js +1 -1
  29. package/dist/client/l10n/use-l10n-config.js +1 -1
  30. package/dist/client/products.js +1 -1
  31. package/dist/client/review/ReviewBar.js +50 -50
  32. package/dist/client/review/use-review.js +1 -1
  33. package/dist/client/sidebar/SidebarDataProvider.js +1 -1
  34. package/dist/client/sidebar/drilldown.js +1 -1
  35. package/dist/client/ssr.js +1 -1
  36. package/dist/client/telemetry/config.js +1 -1
  37. package/dist/client/use-entity-revisions.js +1 -1
  38. package/dist/client/use-page-versions.js +1 -1
  39. package/dist/client/use-router-for-local-links.js +1 -1
  40. package/dist/client/use-search.js +1 -1
  41. package/dist/client/utils/routes/is-router-path.js +1 -0
  42. package/dist/client/webmcp/tools/shared.js +1 -1
  43. package/dist/client/webmcp/tools/site-tools.js +1 -1
  44. package/dist/client/webmcp/use-webmcp-tools.js +1 -1
  45. package/dist/content-layer/config.js +1 -1
  46. package/dist/content-layer/database/files.js +1 -1
  47. package/dist/content-layer/database/finalize.js +1 -1
  48. package/dist/content-layer/database/invalidation.js +26 -26
  49. package/dist/content-layer/database/origins.js +1 -1
  50. package/dist/content-layer/ingest/finalize-phase.js +1 -1
  51. package/dist/content-layer/ingest/normalize-artifacts.js +1 -1
  52. package/dist/content-layer/ingest/run.js +1 -1
  53. package/dist/content-layer/ingest/search-sync.js +1 -1
  54. package/dist/content-layer/ingest/sync.js +1 -1
  55. package/dist/content-layer/link-checker/delta.js +1 -1
  56. package/dist/content-layer/link-checker/load-view.js +1 -1
  57. package/dist/content-layer/link-checker/run-build.js +1 -1
  58. package/dist/content-layer/link-checker/validate.js +1 -1
  59. package/dist/content-layer/loaders/context.js +1 -1
  60. package/dist/content-layer/markdown/client/markdoc-components.js +2 -2
  61. package/dist/content-layer/markdown/client/markdown-text.js +1 -1
  62. package/dist/content-layer/markdown/constants/builtin-tags.js +1 -1
  63. package/dist/content-layer/markdown/constants/markdown-text-tag-set.js +1 -1
  64. package/dist/content-layer/markdown/constants/tag-sets.js +1 -1
  65. package/dist/content-layer/markdown/nodes/heading.js +1 -1
  66. package/dist/content-layer/markdown/resolve/markdoc-resolvers/json-schema.js +1 -1
  67. package/dist/content-layer/markdown/resolve/markdoc-resolvers/operation-samples.js +1 -1
  68. package/dist/content-layer/markdown/resolve/markdoc.js +1 -1
  69. package/dist/content-layer/markdown/resolve/raw-partials.d.ts +2 -1
  70. package/dist/content-layer/markdown/resolve/raw-partials.js +1 -1
  71. package/dist/content-layer/markdown/resolve/references.js +1 -1
  72. package/dist/content-layer/markdown/search/to-sections.js +1 -1
  73. package/dist/content-layer/markdown/search/to-text.d.ts +4 -1
  74. package/dist/content-layer/markdown/search/to-text.js +5 -5
  75. package/dist/content-layer/markdown/server/render.js +1 -1
  76. package/dist/content-layer/markdown/tags/variant.d.ts +6 -0
  77. package/dist/content-layer/markdown/tags/variant.js +1 -0
  78. package/dist/content-layer/markdown/utils/collect-anchors.js +1 -1
  79. package/dist/content-layer/markdown/utils/collect-headings.d.ts +3 -1
  80. package/dist/content-layer/markdown/utils/collect-headings.js +1 -1
  81. package/dist/content-layer/markdown/utils/first-heading.js +1 -1
  82. package/dist/content-layer/markdown/utils/heading-slugger.d.ts +8 -0
  83. package/dist/content-layer/markdown/utils/heading-slugger.js +1 -1
  84. package/dist/content-layer/markdown/utils/parse-cache.js +1 -1
  85. package/dist/content-layer/materialization/entity.js +1 -1
  86. package/dist/content-layer/materialization/static-files.js +1 -1
  87. package/dist/content-layer/plugins/index.js +1 -1
  88. package/dist/content-layer/plugins/internal/api-docs/client/rebase-item-links.js +1 -1
  89. package/dist/content-layer/plugins/internal/api-docs/client/template.js +2 -2
  90. package/dist/content-layer/plugins/internal/api-docs/index.js +1 -1
  91. package/dist/content-layer/plugins/internal/api-docs/server/markdown-docs.js +13 -13
  92. package/dist/content-layer/plugins/internal/api-docs/server/options.js +1 -1
  93. package/dist/content-layer/plugins/internal/api-functions/server/api-function-telemetry.js +1 -0
  94. package/dist/content-layer/plugins/internal/api-functions/server/dispatch.js +1 -1
  95. package/dist/content-layer/plugins/internal/app-data/banner.js +1 -1
  96. package/dist/content-layer/plugins/internal/app-data/index.js +1 -1
  97. package/dist/content-layer/plugins/internal/catalog-classic/client/use-catalog-classic.js +1 -1
  98. package/dist/content-layer/plugins/internal/catalog-classic/index.js +1 -1
  99. package/dist/content-layer/plugins/internal/index.js +1 -1
  100. package/dist/content-layer/plugins/internal/markdoc/client/template.js +1 -1
  101. package/dist/content-layer/plugins/internal/markdoc/index.js +1 -1
  102. package/dist/content-layer/plugins/internal/mcp/constants.d.ts +0 -6
  103. package/dist/content-layer/plugins/internal/mcp/constants.js +1 -1
  104. package/dist/content-layer/plugins/internal/mcp/content-tools.js +1 -1
  105. package/dist/content-layer/plugins/internal/mcp/ignored-routes.js +1 -1
  106. package/dist/content-layer/plugins/internal/mcp/server/agent-card.js +1 -1
  107. package/dist/content-layer/plugins/internal/mcp/server/audit.js +1 -1
  108. package/dist/content-layer/plugins/internal/mcp/server/auth.js +1 -1
  109. package/dist/content-layer/plugins/internal/mcp/server/codemode/capabilities.js +3 -3
  110. package/dist/content-layer/plugins/internal/mcp/server/codemode/constants.js +1 -1
  111. package/dist/content-layer/plugins/internal/mcp/server/codemode/discover.js +1 -1
  112. package/dist/content-layer/plugins/internal/mcp/server/codemode/execute-schema.js +1 -1
  113. package/dist/content-layer/plugins/internal/mcp/server/codemode/index.js +1 -1
  114. package/dist/content-layer/plugins/internal/mcp/server/codemode/prompts.js +8 -8
  115. package/dist/content-layer/plugins/internal/mcp/server/codemode/sandbox.js +1 -1
  116. package/dist/content-layer/plugins/internal/mcp/server/codemode/tool-list.js +1 -1
  117. package/dist/content-layer/plugins/internal/mcp/server/custom-tools.js +1 -1
  118. package/dist/content-layer/plugins/internal/mcp/server/gateway/api-call-operations.js +1 -1
  119. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials-page/site-branding.js +1 -1
  120. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials.js +1 -1
  121. package/dist/content-layer/plugins/internal/mcp/server/gateway/elicitation.js +6 -5
  122. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/allowed-hosts.js +1 -1
  123. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/fetch-bridge.js +1 -1
  124. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/fetch-errors.js +1 -1
  125. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/ssrf-guard.js +1 -1
  126. package/dist/content-layer/plugins/internal/mcp/server/gateway/index.js +3 -3
  127. package/dist/content-layer/plugins/internal/mcp/server/gateway/subject.js +1 -1
  128. package/dist/content-layer/plugins/internal/mcp/server/gateway/tools.js +4 -4
  129. package/dist/content-layer/plugins/internal/mcp/server/gateway/upstream-auth-scheme.js +2 -2
  130. package/dist/content-layer/plugins/internal/mcp/server/handler.js +1 -1
  131. package/dist/content-layer/plugins/internal/mcp/server/mcp-server.js +1 -1
  132. package/dist/content-layer/plugins/internal/mcp/server/mcp-telemetry.js +1 -1
  133. package/dist/content-layer/plugins/internal/mcp/server/oauth/authorize.js +1 -1
  134. package/dist/content-layer/plugins/internal/mcp/server/oauth/discovery.js +1 -1
  135. package/dist/content-layer/plugins/internal/mcp/server/server-card.js +1 -1
  136. package/dist/content-layer/plugins/internal/mcp/server/server-info.js +1 -1
  137. package/dist/content-layer/plugins/internal/mcp/server/skills-resources.js +1 -1
  138. package/dist/content-layer/plugins/internal/mcp/server/tools/graphql-document.js +1 -1
  139. package/dist/content-layer/plugins/internal/mcp/server/tools/graphql.js +1 -1
  140. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-catalog.js +1 -1
  141. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-document.js +1 -1
  142. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi.js +1 -1
  143. package/dist/content-layer/plugins/internal/mcp/server/tools/pages-navigation.js +1 -1
  144. package/dist/content-layer/plugins/internal/mcp/server/tools/pages.js +3 -3
  145. package/dist/content-layer/plugins/internal/mcp/server/tools/search.js +1 -1
  146. package/dist/content-layer/plugins/internal/mcp/server/tools/submit-feedback.js +1 -1
  147. package/dist/content-layer/plugins/internal/mcp/server/tools/whoami.js +1 -1
  148. package/dist/content-layer/plugins/internal/mock/server/handler.js +1 -1
  149. package/dist/content-layer/plugins/internal/react-page/index.d.ts +3 -2
  150. package/dist/content-layer/plugins/internal/react-page/index.js +1 -1
  151. package/dist/content-layer/plugins/internal/scorecard-classic/index.js +1 -1
  152. package/dist/content-layer/plugins/internal/sidebar/bundle.js +1 -1
  153. package/dist/content-layer/plugins/internal/sidebar/index.js +2 -2
  154. package/dist/content-layer/plugins/internal/skills/index.js +1 -1
  155. package/dist/content-layer/plugins/internal/skills/server/routes.js +1 -1
  156. package/dist/content-layer/plugins/project/load.js +2 -2
  157. package/dist/content-layer/plugins/types/plugin.d.ts +5 -0
  158. package/dist/content-layer/plugins/utils/link-access.js +1 -1
  159. package/dist/content-layer/plugins/utils/route-index.js +1 -1
  160. package/dist/content-layer/search/postings/postings-store.js +1 -1
  161. package/dist/content-layer/search/store.d.ts +11 -0
  162. package/dist/content-layer/server/database.js +1 -1
  163. package/dist/content-layer/static/registry.js +1 -1
  164. package/dist/content-layer/versions/redirect.js +1 -1
  165. package/dist/content-layer/versions/resolve.js +1 -1
  166. package/dist/server/__tests__/rbac-fixture.js +1 -1
  167. package/dist/server/app.js +3 -3
  168. package/dist/server/ask-ai/route.js +1 -1
  169. package/dist/server/auth/middleware.js +1 -1
  170. package/dist/server/auth/request.js +1 -1
  171. package/dist/server/auth/routes.js +1 -1
  172. package/dist/server/constants/system-routes.js +1 -1
  173. package/dist/server/content.js +15 -14
  174. package/dist/server/cors-proxy/handler.js +1 -1
  175. package/dist/server/feedback/route.js +1 -1
  176. package/dist/server/html-tags.js +2 -1
  177. package/dist/server/lambda-entry.js +1 -1
  178. package/dist/server/llms-txt.js +1 -1
  179. package/dist/server/manifest-assets.js +4 -4
  180. package/dist/server/node-entry.js +1 -1
  181. package/dist/server/page-handlers.js +2 -2
  182. package/dist/server/plugin-context.js +1 -1
  183. package/dist/server/public-url.js +1 -0
  184. package/dist/server/rbac/l10n-rules.js +1 -1
  185. package/dist/server/rbac/team-templates.js +1 -1
  186. package/dist/server/search/cache.js +1 -0
  187. package/dist/server/search/route.js +1 -1
  188. package/dist/server/search/search-telemetry.js +1 -0
  189. package/dist/server/seo-tags.js +2 -2
  190. package/dist/server/ssrf/ssrf-blocklist.js +1 -1
  191. package/dist/server/static-files/serve.js +1 -1
  192. package/dist/server/subprocess/child-entry.js +1 -1
  193. package/dist/server/subprocess/host.js +1 -1
  194. package/dist/shared/constants/l10n/langs/ar.js +1 -1
  195. package/dist/shared/constants/l10n/langs/de.js +1 -1
  196. package/dist/shared/constants/l10n/langs/en.js +1 -1
  197. package/dist/shared/constants/l10n/langs/es.js +1 -1
  198. package/dist/shared/constants/l10n/langs/fr.js +1 -1
  199. package/dist/shared/constants/l10n/langs/hi.js +1 -1
  200. package/dist/shared/constants/l10n/langs/it.js +1 -1
  201. package/dist/shared/constants/l10n/langs/ja.js +1 -1
  202. package/dist/shared/constants/l10n/langs/ko.js +1 -1
  203. package/dist/shared/constants/l10n/langs/pl.js +1 -1
  204. package/dist/shared/constants/l10n/langs/pt-br.js +1 -1
  205. package/dist/shared/constants/l10n/langs/pt.js +1 -1
  206. package/dist/shared/constants/l10n/langs/ru.js +1 -1
  207. package/dist/shared/constants/l10n/langs/uk.js +1 -1
  208. package/dist/shared/constants/l10n/langs/zh.js +1 -1
  209. package/dist/shared/experiments.js +1 -1
  210. package/dist/shared/load-dot-env.js +1 -1
  211. package/dist/shared/public-env.d.ts +9 -0
  212. package/dist/shared/public-env.js +1 -1
  213. package/dist/shared/utils/routes/file-path-to-route-slug.js +1 -1
  214. package/dist/shared/utils/routes/markdown-copy-url.js +1 -0
  215. package/package.json +9 -6
  216. package/dist/content-layer/plugins/internal/mcp/server/codemode/execution-budget.js +0 -1
  217. package/dist/content-layer/plugins/internal/mcp/server/codemode/read-result.js +0 -1
  218. package/dist/content-layer/plugins/internal/mcp/server/codemode/return-last-expression.js +0 -6
  219. package/dist/content-layer/plugins/internal/mcp/server/codemode/returns-from-top-level.js +0 -1
  220. package/dist/content-layer/plugins/internal/mcp/server/codemode/tool-declarations.js +0 -4
  221. package/dist/content-layer/plugins/internal/mcp/server/codemode/unknown-tool-hint.js +0 -3
  222. package/dist/content-layer/plugins/internal/mcp/server/tools/graphql-constants.js +0 -1
  223. package/dist/content-layer/plugins/internal/mcp/server/tools/pages-constants.js +0 -1
  224. package/dist/content-layer/plugins/internal/mcp/server/tools/schemas.js +0 -1
  225. package/dist/shared/utils/routes/markdown-path.js +0 -1
@@ -1 +1 @@
1
- import{normalizeRouteSlug as e}from"../../../../../../shared/utils/routes/normalize-route-slug.js";import{normalizeRoutePath as t}from"../../../../../../shared/utils/routes/normalize-route-path.js";import"../../../../../../shared/constants/app-data.js";import{filterRbacAnnotatedValue as n}from"../../../../../../server/rbac/filter.js";import{stripPathPrefix as r,withPathPrefix as i}from"../../../../../../shared/path-prefix.js";import{FOLDER_SIDEBAR_FILENAME_REGEX as a,SIDEBAR_AGGREGATOR_LOADER_ID as o,SIDEBAR_PLUGIN_ID as s,isTabbedSidebar as c}from"../../../sidebar/index.js";import{readIgnoredRouteSlugs as l}from"../../ignored-routes.js";import{toAppData as u}from"../../../../../../shared/utils/app-data.js";import{posix as d}from"node:path";const f=/* @__PURE__ */ new Set,p=/(?:\/index(?:\.html\.md|\.html|\.md)|\.md|\.html)$/;async function m(e){let[t,n]=await Promise.all([l(e.entities),e.pageMarkdown.listPages()]);return{pages:n.filter(e=>!t.has(e.slug)),isVisible:n=>!t.has(n)&&e.isSlugVisible(n)}}async function h(t){let[{pages:r,isVisible:i},a,o]=await Promise.all([m(t),w(t),T(t)]),s=o.filter(t=>typeof t.link==`string`&&t.external!==!0&&i(e(t.link))),c=new Map(r.map(e=>[e.slug,e.title])),l=/* @__PURE__ */ new Set,u=[],d=g(a.map(({path:e})=>e)),p=a.map(({path:e,value:t},n)=>({path:e,value:t,id:d[n],links:M(k(t))})),h=D(p.flatMap(({links:e})=>e.slice(0,1)));for(let{path:e,value:r,id:a,links:o}of p){for(let e of o)l.add(e);let d=N(k(n(r,t.request.teams)),e=>i(e)&&c.has(e));if(d.length===0)continue;let p=a===`/`,m=p?t.config.seo?.title||`Documentation`:a,g=O(e,d,s,c,p?f:h)||m;u.push({id:a,title:g,nodes:d})}u.sort((e,t)=>Number(t.id===`/`)-Number(e.id===`/`));let _=r.filter(e=>!l.has(e.slug)).map(e=>({type:`page`,label:e.title,link:e.slug,items:[]}));return _.length>0&&u.push({id:`other-pages`,title:`Other pages`,nodes:_}),{sections:u,pages:r}}function g(e){let t=e.map(e=>{let t=d.dirname(e);return t===`.`?`/`:t}),n=/* @__PURE__ */ new Map;for(let e of t)n.set(e,(n.get(e)??0)+1);return e.map((e,r)=>{let i=t[r],o=!a.test(e),s=(n.get(i)??0)>1;return o&&s?e:i})}function _(e){let t=(e,n)=>n.flatMap(n=>{if(n.type!==`section`)return[];let r=v(e,n.label);return[{id:r,title:n.label,link:n.link,nodes:n.items},...t(r,n.items)]});return e.flatMap(e=>[e,...t(e.id,e.nodes)])}function v(e,t){return`${e} > ${t}`}function y(e,t,n){let r=_(e),i=t.trim().toLowerCase(),a=r.find(e=>e.id.toLowerCase()===i);if(a)return a;let o=C(t,n),s=r.find(e=>e.link!==void 0&&e.link===o);if(s)return s;let c=r.filter(e=>e.title.toLowerCase()===i);return c.find(e=>c.every(t=>t===e||t.id.startsWith(`${e.id} > `)))}function b(e){return e.flatMap(e=>[...e.link?[e.link]:[],...b(e.items)])}function x(e){return e.reduce((e,t)=>e+(t.type===`page`?1:x(t.items)),0)}function S(e,t){return`${t}${i(e)}`}function C(e,n){let i;try{i=new URL(e.trim(),n).pathname}catch{return null}let a=r(i)??i;return t(a.replace(p,``))}async function w(e){let t=(await e.entities.list({pluginId:s})).flatMap(e=>{let t=e.metadata?.sourcePath;return e.loaderId===o&&typeof t==`string`?[{path:t,key:e.key}]:[]});return t.sort((e,t)=>e.path<t.path?-1:+(e.path>t.path)),Promise.all(t.map(async({path:t,key:n})=>({path:t,value:await e.entities.load(n)})))}async function T(e){if(!await e.entities.get(`app-data`))return[];let t=u(await e.entities.load(`app-data`)).theme?.navbar?.items??[];return E(n(t,e.request.teams)??[])}function E(e){return e.flatMap(e=>[e,...E(e.items??[])])}function D(e){let t=/* @__PURE__ */ new Map;for(let n of e)t.set(n,(t.get(n)??0)+1);return new Set([...t].filter(([,e])=>e>1).map(([e])=>e))}function O(e,t,n,r,i){let a=n.find(t=>Array.isArray(t.linkedSidebars)&&t.linkedSidebars.includes(e));if(typeof a?.label==`string`&&a.label!==``)return a.label;let o=t.find(e=>!e.link||!i.has(e.link));if(o)return o.link?r.get(o.link):o.label}function k(e){return e===null?[]:c(e)?e.tabs.map(A):e}function A(e){return{label:e.label,link:e.link,items:e.menu??e.items??[]}}function j(e){return e.link!==void 0&&e.external!==!0}function M(t){return t.flatMap(t=>[...j(t)&&t.link?[e(t.link)]:[],...M(t.items??[])])}function N(t,n){return t.flatMap(t=>{let r=j(t)&&t.link?e(t.link):void 0,i=r!==void 0&&n(r)?r:void 0;if(t.items){let e=N(t.items,n);return e.length===0&&!i?[]:[{type:`section`,label:t.label??``,...i?{link:i}:{},items:e}]}return i?[{type:`page`,label:t.label??i,link:i,items:[]}]:[]})}export{b as collectNodeLinks,x as countPages,y as findSection,_ as flattenSections,h as loadPageNavigation,m as loadVisiblePages,C as toPageSlug,S as toPublicUrl,v as toSectionId};
1
+ import"../../../../../../shared/constants/app-data.js";import{toAppData as e}from"../../../../../../shared/utils/app-data.js";import{normalizeRouteSlug as t}from"../../../../../../shared/utils/routes/normalize-route-slug.js";import{stripPathPrefix as n,withPathPrefix as r}from"../../../../../../shared/path-prefix.js";import{normalizeRoutePath as i}from"../../../../../../shared/utils/routes/normalize-route-path.js";import{filterRbacAnnotatedValue as a}from"../../../../../../server/rbac/filter.js";import{FOLDER_SIDEBAR_FILENAME_REGEX as o,SIDEBAR_AGGREGATOR_LOADER_ID as s,SIDEBAR_PLUGIN_ID as c,isTabbedSidebar as l}from"../../../sidebar/index.js";import{readIgnoredRouteSlugs as u}from"../../ignored-routes.js";import{posix as d}from"node:path";const f=/* @__PURE__ */ new Set,p=/(?:\/index(?:\.html\.md|\.html|\.md)|\.md|\.html)$/;async function m(e){let[t,n]=await Promise.all([u(e.entities),e.pageMarkdown.listPages()]);return{pages:n.filter(e=>!t.has(e.slug)),isVisible:n=>!t.has(n)&&e.isSlugVisible(n)}}async function h(e){let[{pages:n,isVisible:r},i,o]=await Promise.all([m(e),w(e),T(e)]),s=o.filter(e=>typeof e.link==`string`&&e.external!==!0&&r(t(e.link))),c=new Map(n.map(e=>[e.slug,e.title])),l=/* @__PURE__ */ new Set,u=[],d=g(i.map(({path:e})=>e)),p=i.map(({path:e,value:t},n)=>({path:e,value:t,id:d[n],links:M(k(t))})),h=D(p.flatMap(({links:e})=>e.slice(0,1)));for(let{path:t,value:n,id:i,links:o}of p){for(let e of o)l.add(e);let d=N(k(a(n,e.request.teams)),e=>r(e)&&c.has(e));if(d.length===0)continue;let p=i===`/`,m=p?e.config.seo?.title||`Documentation`:i,g=O(t,d,s,c,p?f:h)||m;u.push({id:i,title:g,nodes:d})}u.sort((e,t)=>Number(t.id===`/`)-Number(e.id===`/`));let _=n.filter(e=>!l.has(e.slug)).map(e=>({type:`page`,label:e.title,link:e.slug,items:[]}));return _.length>0&&u.push({id:`other-pages`,title:`Other pages`,nodes:_}),{sections:u,pages:n}}function g(e){let t=e.map(e=>{let t=d.dirname(e);return t===`.`?`/`:t}),n=/* @__PURE__ */ new Map;for(let e of t)n.set(e,(n.get(e)??0)+1);return e.map((e,r)=>{let i=t[r],a=!o.test(e),s=(n.get(i)??0)>1;return a&&s?e:i})}function _(e){let t=(e,n)=>n.flatMap(n=>{if(n.type!==`section`)return[];let r=v(e,n.label);return[{id:r,title:n.label,link:n.link,nodes:n.items},...t(r,n.items)]});return e.flatMap(e=>[e,...t(e.id,e.nodes)])}function v(e,t){return`${e} > ${t}`}function y(e,t,n){let r=_(e),i=t.trim().toLowerCase(),a=r.find(e=>e.id.toLowerCase()===i);if(a)return a;let o=C(t,n),s=r.find(e=>e.link!==void 0&&e.link===o);if(s)return s;let c=r.filter(e=>e.title.toLowerCase()===i);return c.find(e=>c.every(t=>t===e||t.id.startsWith(`${e.id} > `)))}function b(e){return e.flatMap(e=>[...e.link?[e.link]:[],...b(e.items)])}function x(e){return e.reduce((e,t)=>e+(t.type===`page`?1:x(t.items)),0)}function S(e,t){return`${t}${r(e)}`}function C(e,t){let r;try{r=new URL(e.trim(),t).pathname}catch{return null}let a=n(r)??r;return i(a.replace(p,``))}async function w(e){let t=(await e.entities.list({pluginId:c})).flatMap(e=>{let t=e.metadata?.sourcePath;return e.loaderId===s&&typeof t==`string`?[{path:t,key:e.key}]:[]});return t.sort((e,t)=>e.path<t.path?-1:+(e.path>t.path)),Promise.all(t.map(async({path:t,key:n})=>({path:t,value:await e.entities.load(n)})))}async function T(t){if(!await t.entities.get(`app-data`))return[];let n=e(await t.entities.load(`app-data`)).theme?.navbar?.items??[];return E(a(n,t.request.teams)??[])}function E(e){return e.flatMap(e=>[e,...E(e.items??[])])}function D(e){let t=/* @__PURE__ */ new Map;for(let n of e)t.set(n,(t.get(n)??0)+1);return new Set([...t].filter(([,e])=>e>1).map(([e])=>e))}function O(e,t,n,r,i){let a=n.find(t=>Array.isArray(t.linkedSidebars)&&t.linkedSidebars.includes(e));if(typeof a?.label==`string`&&a.label!==``)return a.label;let o=t.find(e=>!e.link||!i.has(e.link));if(o)return o.link?r.get(o.link):o.label}function k(e){return e===null?[]:l(e)?e.tabs.map(A):e}function A(e){return{label:e.label,link:e.link,items:e.menu??e.items??[]}}function j(e){return e.link!==void 0&&e.external!==!0}function M(e){return e.flatMap(e=>[...j(e)&&e.link?[t(e.link)]:[],...M(e.items??[])])}function N(e,n){return e.flatMap(e=>{let r=j(e)&&e.link?t(e.link):void 0,i=r!==void 0&&n(r)?r:void 0;if(e.items){let t=N(e.items,n);return t.length===0&&!i?[]:[{type:`section`,label:e.label??``,...i?{link:i}:{},items:t}]}return i?[{type:`page`,label:e.label??i,link:i,items:[]}]:[]})}export{b as collectNodeLinks,x as countPages,y as findSection,_ as flattenSections,h as loadPageNavigation,m as loadVisiblePages,C as toPageSlug,S as toPublicUrl,v as toSectionId};
@@ -1,4 +1,4 @@
1
- import{readIgnoredRouteSlugs as e}from"../../ignored-routes.js";import{publicOrigin as t}from"../../../../utils/request-origin.js";import{recoveryToolNames as n}from"./openapi-document.js";import{MAX_PAGE_LINES as r}from"./pages-constants.js";import{GET_PAGE_SCHEMA as i,GREP_PAGES_SCHEMA as a,LIST_PAGES_SCHEMA as o,grepPagesToolSchema as s,listPagesToolSchema as c}from"./schemas.js";import{collectNodeLinks as l,countPages as u,findSection as d,flattenSections as f,loadPageNavigation as p,loadVisiblePages as m,toPageSlug as h,toPublicUrl as g,toSectionId as _}from"./pages-navigation.js";const v=/^(#{1,3}) +(\S.*)$/,y=/^\s*(```|~~~)/,b={schema:o,schemaFor:e=>c(e.mcpMode),async execute(e,n){let{section:r}=e??{},{sections:i}=await p(n),a=t(n.request);if(!r)return{sections:i.map(e=>({id:e.id,title:e.title,items:w(e.id,e.nodes,a)}))};let o=d(i,r,a);if(!o){let e=f(i).slice(0,50).map(({id:e})=>e);throw Error(`No section "${r}". Pass one of these section ids: ${e.join(`; `)}.`)}return{section:{id:o.id,title:o.title},items:w(o.id,o.nodes,a)}}},x={schema:i,async execute(e,i){let{url:a,startLine:o,lines:s}=e??{};if(typeof a!=`string`||a.trim()===``)throw Error(`The "url" parameter is required: a page URL or path.`);let c=t(i.request),l=h(a,c),u=l===null?null:await C(l,i);if(l===null||u===null)throw Error(`No page you can read is at "${a}": it does not exist, or your access does not include it. Do not describe it from other pages. Call ${n(i.mcpMode).listPages} to see the pages you can read.`);let d=D(u.text),f=Math.max(1,Math.floor(o??1));if(f>d.length)throw Error(`Line ${f} is past the end of "${u.title??l}", which has ${d.length} lines.`);let p=T(s,200,r),m=Math.min(d.length,f+p-1);return{url:g(l,c),title:u.title??l,totalLines:d.length,startLine:f,endLine:m,...m<d.length?{nextStartLine:m+1}:{},outline:O(d),content:d.slice(f-1,m).join(`
2
- `)}}},S={schema:a,schemaFor:e=>s(e.mcpMode),async execute(e,r){let{query:i,section:a,maxMatches:o}=e??{};if(typeof i!=`string`||i===``)throw Error(`The "query" parameter is required: a text to find.`);let s=t(r.request),c,u;if(a){let{sections:e,pages:t}=await p(r),i=d(e,a,s);if(!i)throw Error(`No section "${a}". Call ${n(r.mcpMode).listPages} to see the sections.`);let o=new Set(l(i.nodes));i.link&&o.add(i.link),c=t.filter(e=>o.has(e.slug)),u=i.title}else c=(await m(r)).pages;let f=T(o,20,100),h=i.toLowerCase(),_=c.length,v=[];for(let e of c){let t=(await r.pageMarkdown.readPage(e.slug))?.text??``;if(t.toLowerCase().includes(h))for(let[n,r]of D(t).entries()){let t=r.toLowerCase().indexOf(h);if(t!==-1){if(v.length===f)return{matches:v,searchedPages:_,truncated:!0};v.push({url:g(e.slug,s),title:e.title,line:n+1,text:E(r,t)})}}}return v.length>0?{matches:v,searchedPages:_,truncated:!1}:{matches:v,searchedPages:_,truncated:!1,note:`No page you can read ${u?`in "${u}" contains "${i}". All ${_} pages there were searched.`:`contains "${i}". All ${_} pages were searched. API references are not searched: use ${n(r.mcpMode).listApis} for them.`}`}}};async function C(t,n){return(await e(n.entities)).has(t)?null:n.pageMarkdown.readPage(t)}function w(e,t,n){return t.map(t=>t.type===`page`?{type:`page`,title:t.label,url:g(t.link??``,n)}:{type:`section`,id:_(e,t.label),title:t.label,...t.link?{url:g(t.link,n)}:{},pageCount:u(t.items)})}function T(e,t,n){return Math.min(Math.max(1,Math.floor(e??t)),n)}function E(e,t){let n=Math.max(0,Math.min(t-80,e.length-200));return e.slice(n,n+200).trim()}function D(e){return(e.endsWith(`
1
+ import{readIgnoredRouteSlugs as e}from"../../ignored-routes.js";import{publicOrigin as t}from"../../../../utils/request-origin.js";import{recoveryToolNames as n}from"./openapi-document.js";import{collectNodeLinks as r,countPages as i,findSection as a,flattenSections as o,loadPageNavigation as s,loadVisiblePages as c,toPageSlug as l,toPublicUrl as u,toSectionId as d}from"./pages-navigation.js";import{DEFAULT_GREP_MATCHES as f,DEFAULT_PAGE_LINES as p,GET_PAGE_SCHEMA as m,GREP_PAGES_SCHEMA as h,LIST_PAGES_SCHEMA as g,MAX_GREP_MATCHES as _,MAX_PAGE_LINES as v,grepPagesToolSchema as y,listPagesToolSchema as b}from"@redocly/mcp";const x=/^(#{1,3}) +(\S.*)$/,S=/^\s*(```|~~~)/,C={schema:g,schemaFor:e=>b(e.mcpMode),async execute(e,n){let{section:r}=e??{},{sections:i}=await s(n),c=t(n.request);if(!r)return{sections:i.map(e=>({id:e.id,title:e.title,items:D(e.id,e.nodes,c)}))};let l=a(i,r,c);if(!l){let e=o(i).slice(0,50).map(({id:e})=>e);throw Error(`No section "${r}". Pass one of these section ids: ${e.join(`; `)}.`)}return{section:{id:l.id,title:l.title},items:D(l.id,l.nodes,c)}}},w={schema:m,async execute(e,r){let{url:i,startLine:a,lines:o}=e??{};if(typeof i!=`string`||i.trim()===``)throw Error(`The "url" parameter is required: a page URL or path.`);let s=t(r.request),c=l(i,s),d=c===null?null:await E(c,r);if(c===null||d===null)throw Error(`No page you can read is at "${i}": it does not exist, or your access does not include it. Do not describe it from other pages. Call ${n(r.mcpMode).listPages} to see the pages you can read.`);let f=A(d.text),m=Math.max(1,Math.floor(a??1));if(m>f.length)throw Error(`Line ${m} is past the end of "${d.title??c}", which has ${f.length} lines.`);let h=O(o,p,v),g=Math.min(f.length,m+h-1);return{url:u(c,s),title:d.title??c,totalLines:f.length,startLine:m,endLine:g,...g<f.length?{nextStartLine:g+1}:{},outline:j(f),content:f.slice(m-1,g).join(`
2
+ `)}}},T={schema:h,schemaFor:e=>y(e.mcpMode),async execute(e,i){let{query:o,section:l,maxMatches:d}=e??{};if(typeof o!=`string`||o===``)throw Error(`The "query" parameter is required: a text to find.`);let p=t(i.request),m,h;if(l){let{sections:e,pages:t}=await s(i),o=a(e,l,p);if(!o)throw Error(`No section "${l}". Call ${n(i.mcpMode).listPages} to see the sections.`);let c=new Set(r(o.nodes));o.link&&c.add(o.link),m=t.filter(e=>c.has(e.slug)),h=o.title}else m=(await c(i)).pages;let g=O(d,f,_),v=o.toLowerCase(),y=m.length,b=[];for(let e of m){let t=(await i.pageMarkdown.readPage(e.slug))?.text??``;if(t.toLowerCase().includes(v))for(let[n,r]of A(t).entries()){let t=r.toLowerCase().indexOf(v);if(t!==-1){if(b.length===g)return{matches:b,searchedPages:y,truncated:!0};b.push({url:u(e.slug,p),title:e.title,line:n+1,text:k(r,t)})}}}return b.length>0?{matches:b,searchedPages:y,truncated:!1}:{matches:b,searchedPages:y,truncated:!1,note:`No page you can read ${h?`in "${h}" contains "${o}". All ${y} pages there were searched.`:`contains "${o}". All ${y} pages were searched. API references are not searched: use ${n(i.mcpMode).listApis} for them.`}`}}};async function E(t,n){return(await e(n.entities)).has(t)?null:n.pageMarkdown.readPage(t)}function D(e,t,n){return t.map(t=>t.type===`page`?{type:`page`,title:t.label,url:u(t.link??``,n)}:{type:`section`,id:d(e,t.label),title:t.label,...t.link?{url:u(t.link,n)}:{},pageCount:i(t.items)})}function O(e,t,n){return Math.min(Math.max(1,Math.floor(e??t)),n)}function k(e,t){let n=Math.max(0,Math.min(t-80,e.length-200));return e.slice(n,n+200).trim()}function A(e){return(e.endsWith(`
3
3
  `)?e.slice(0,-1):e).split(`
4
- `)}function O(e){let t=[],n=!1;return e.forEach((e,r)=>{if(y.test(e)){n=!n;return}let i=n?null:v.exec(e);i&&t.push({line:r+1,level:i[1].length,heading:i[2].trim()})}),t}const k=[b,x,S];export{k as pageTools};
4
+ `)}function j(e){let t=[],n=!1;return e.forEach((e,r)=>{if(S.test(e)){n=!n;return}let i=n?null:x.exec(e);i&&t.push({line:r+1,level:i[1].length,heading:i[2].trim()})}),t}const M=[C,w,T];export{M as pageTools};
@@ -1,3 +1,3 @@
1
- import{normalizeL10nConfig as e}from"../../../../../../shared/utils/l10n.js";import{withPathPrefix as t}from"../../../../../../shared/path-prefix.js";import{readIgnoredRouteSlugs as n}from"../../ignored-routes.js";import{publicOrigin as r}from"../../../../utils/request-origin.js";import{resolveSemanticSearchUpstreamUrl as i}from"../../../../../../shared/ask-ai/upstream.js";import{SemanticSearchError as a,fetchSemanticSearchDocuments as o,filterSemanticSearchDocuments as s}from"../semantic-search.js";import{SEARCH_SCHEMA as c,searchSchema as l}from"./schemas.js";const u=`No results found.`;function d(e,n){let r=e=>{try{return new URL(t(e),n).toString()}catch{return e}};return e.map(e=>`### [${e.title}](${r(e.url)})\n\n${e.content}\n`).join(`
1
+ import{normalizeL10nConfig as e}from"../../../../../../shared/utils/l10n.js";import{withPathPrefix as t}from"../../../../../../shared/path-prefix.js";import{readIgnoredRouteSlugs as n}from"../../ignored-routes.js";import{publicOrigin as r}from"../../../../utils/request-origin.js";import{resolveSemanticSearchUpstreamUrl as i}from"../../../../../../shared/ask-ai/upstream.js";import{SemanticSearchError as a,fetchSemanticSearchDocuments as o,filterSemanticSearchDocuments as s}from"../semantic-search.js";import{SEARCH_SCHEMA as c,searchSchema as l}from"@redocly/mcp";const u=`No results found.`;function d(e,n){let r=e=>{try{return new URL(t(e),n).toString()}catch{return e}};return e.map(e=>`### [${e.title}](${r(e.url)})\n\n${e.content}\n`).join(`
2
2
 
3
3
  `).trim()}const f=[{schema:c,schemaFor:t=>l(Object.values(t.config.products??{}).map(e=>e.name),e(t.config.l10n).locales?.map(e=>e.code)??[]),isAvailable:()=>i()!==``,async execute(t,i){let{query:c,product:l,locale:f}=t??{},p;try{p=await o({query:c,product:l||void 0,locale:f||e(i.config.l10n).defaultLocale})}catch(e){throw e instanceof a?(i.logger?.warn(`MCP search: ${e.message} ${e.detail}`),Error(`The search service failed. Try the call again later.`)):e}let m=await n(i.entities),h=await s(p,async e=>!m.has(e)&&i.isSlugVisible(e)&&await i.hasRoute(e));return h.length===0?u:d(h,r(i.request))||u}}];export{f as searchTools};
@@ -1 +1 @@
1
- import{publicOrigin as e}from"../../../../utils/request-origin.js";import{submitFeedback as t}from"../../../../../../server/feedback/route.js";import{SUBMIT_FEEDBACK_SCHEMA as n}from"./schemas.js";import{toPageSlug as r,toPublicUrl as i}from"./pages-navigation.js";function a(e){return{content:[{type:`text`,text:JSON.stringify(e)}],isError:!0}}function o(e){return e?.trim()||void 0}function s(e,t){let n=r(e,t);return n===null?void 0:new URL(i(n,t)).toString()}function c(e){return e.feedback?.hide!==!0}const l=[{schema:n,isAvailable:e=>c(e.config),async execute(n,r){let i=n??{},c=o(i.path),l=o(i.summary);if(!c||!l)return a({error:`Invalid arguments`,message:"`path` and `summary` are required."});let u=s(c,e(r.request));if(!u)return a({error:`Invalid arguments`,message:"`path` must be a page path or URL of this site."});let d=o(i.details),f=r.clientVersion?`${r.client}/${r.clientVersion}`:r.client,p;try{p=await t({body:{component:`comment`,path:u,comment:d?`${l}\n\n${d}`:l,agent:f,targetFeature:o(i.targetFeature),origin:`mcp`},request:r.request,isSlugVisible:e=>r.isSlugVisible(e)},{hasRoute:e=>r.hasRoute(e),logger:r.logger})}catch{return a({error:`Failed to submit feedback`,message:`The feedback endpoint could not be reached.`})}let{status:m,data:h}=p;return m===403?a({error:`Forbidden`,message:`You have no access to this page, so feedback for it is not accepted.`}):m===404?a({error:`Not found`,message:`No page exists at ${u}.`}):m===400?a({error:`Invalid feedback`,errors:Array.isArray(h.errors)?h.errors.filter(e=>typeof e==`string`):[]}):m<200||m>299?a({error:`Failed to submit feedback`,message:`The feedback endpoint answered ${m}.`}):{status:`received`,page:u,message:`Thanks for your feedback. The documentation team sees it on the Feedback page.`}}}];export{c as isFeedbackEnabled,l as submitFeedbackTools};
1
+ import{publicOrigin as e}from"../../../../utils/request-origin.js";import{submitFeedback as t}from"../../../../../../server/feedback/route.js";import{toPageSlug as n,toPublicUrl as r}from"./pages-navigation.js";import{SUBMIT_FEEDBACK_SCHEMA as i}from"@redocly/mcp";function a(e){return{content:[{type:`text`,text:JSON.stringify(e)}],isError:!0}}function o(e){return e?.trim()||void 0}function s(e,t){let i=n(e,t);return i===null?void 0:new URL(r(i,t)).toString()}function c(e){return e.feedback?.hide!==!0}const l=[{schema:i,isAvailable:e=>c(e.config),async execute(n,r){let i=n??{},c=o(i.path),l=o(i.summary);if(!c||!l)return a({error:`Invalid arguments`,message:"`path` and `summary` are required."});let u=s(c,e(r.request));if(!u)return a({error:`Invalid arguments`,message:"`path` must be a page path or URL of this site."});let d=o(i.details),f=r.clientVersion?`${r.client}/${r.clientVersion}`:r.client,p;try{p=await t({body:{component:`comment`,path:u,comment:d?`${l}\n\n${d}`:l,agent:f,targetFeature:o(i.targetFeature),origin:`mcp`},request:r.request,isSlugVisible:e=>r.isSlugVisible(e)},{hasRoute:e=>r.hasRoute(e),logger:r.logger})}catch{return a({error:`Failed to submit feedback`,message:`The feedback endpoint could not be reached.`})}let{status:m,data:h}=p;return m===403?a({error:`Forbidden`,message:`You have no access to this page, so feedback for it is not accepted.`}):m===404?a({error:`Not found`,message:`No page exists at ${u}.`}):m===400?a({error:`Invalid feedback`,errors:Array.isArray(h.errors)?h.errors.filter(e=>typeof e==`string`):[]}):m<200||m>299?a({error:`Failed to submit feedback`,message:`The feedback endpoint answered ${m}.`}):{status:`received`,page:u,message:`Thanks for your feedback. The documentation team sees it on the Feedback page.`}}}];export{c as isFeedbackEnabled,l as submitFeedbackTools};
@@ -1 +1 @@
1
- import{WHOAMI_SCHEMA as e}from"./schemas.js";function t(e){let t=typeof e==`number`?e:Number(e);return Number.isFinite(t)&&t>0?(/* @__PURE__ */ new Date(t*1e3)).toISOString():void 0}const n=[{schema:e,isAvailable:e=>e.isProtected,async execute(e,n){let r=n.request.viewer;if(!r?.isAuthenticated)return{authenticated:!1};let i=n.claims??{};return{authenticated:!0,email:r.email,name:r.name,subject:r.sub,clientId:i.client_id,scope:i.scope,issuedAt:t(i.iat),expiresAt:t(i.exp)}}}];export{n as whoamiTools};
1
+ import{WHOAMI_SCHEMA as e}from"@redocly/mcp";function t(e){let t=typeof e==`number`?e:Number(e);return Number.isFinite(t)&&t>0?(/* @__PURE__ */ new Date(t*1e3)).toISOString():void 0}const n=[{schema:e,isAvailable:e=>e.isProtected,async execute(e,n){let r=n.request.viewer;if(!r?.isAuthenticated)return{authenticated:!1};let i=n.claims??{};return{authenticated:!0,email:r.email,name:r.name,subject:r.sub,clientId:i.client_id,scope:i.scope,issuedAt:t(i.iat),expiresAt:t(i.exp)}}}];export{n as whoamiTools};
@@ -1 +1 @@
1
- import{isObject as e}from"../../../../../shared/utils/is-object.js";import{filePathToRouteSlug as t}from"../../../../../shared/utils/routes/file-path-to-route-slug.js";import{mockPathPrefix as n}from"../../../types/api-entity.js";import{isPlanFeatureGranted as r}from"../../../../../shared/plan-gates.js";import{stripPathPrefix as i}from"../../../../../shared/path-prefix.js";import{notFoundResponse as a}from"../../../../../server/plugin-context.js";const o={"Cache-Control":`no-store`},s=/* @__PURE__ */ new Map;function c(t,n){let r=n.metadata?.mockServer;return{...t,...e(r)?r:{}}}function l(e,t){let{specType:r,routeSlug:i}=e.metadata??{};return r!==`openapi`||typeof i!=`string`||c(t,e).off===!0?null:n(i)}function u(e,t,n=void 0){let r=null,i=-1;for(let a of e){let e=l(a,n);e===null||e.length<=i||d(e,t)&&(r={api:a,path:t.slice(e.length)||`/`},i=e.length)}return r}function d(e,t){return t===e||t.startsWith(`${e}/`)}function f(e,t,{createMockServer:n}){let r=s.get(t.key);if(r&&r.dataHash===t.dataHash)return r.handler;let{strictExamples:i,errorIfForcedExampleNotFound:a}=c(e.config.mockServer,t),o=e.entities.load(t.key).then(e=>n(structuredClone(e),{strictExamples:i,errorIfForcedExampleNotFound:a}));return s.set(t.key,{dataHash:t.dataHash,handler:o}),o.catch(()=>s.delete(t.key)),o}async function p(e,r){let i=await e.entities.list({type:`api`}),a=i.filter(({metadata:e})=>e?.specType!==`openapi`||e.routeSlug!==void 0?!1:d(n(t(String(e.sourcePath))),r));return a.length===0?i:(await Promise.all(a.map(t=>e.entities.load(t.key))),e.entities.list({type:`api`}))}function m(e,t){let n=(e.req.header(`x-http-method-override`)??e.req.method).toUpperCase(),{search:r}=new URL(e.req.url),i;return{path:t,method:n,query:r===``?void 0:r,headers:Object.fromEntries(e.req.raw.headers),getBody:()=>i??=e.req.arrayBuffer().then(e=>e.byteLength>0?Buffer.from(e):void 0)}}function h(e){return(i(new URL(e.req.url).pathname)??``).slice(6)||`/`}async function g(e,t){if(!r(t.config,`mockServer`))return a();let n=h(e),i=u(await p(t,n),n,t.config.mockServer);if(!i||!t.isSlugVisible(String(i.api.metadata?.routeSlug)))return a();let s;try{s=await import(`@redocly/mock-server`)}catch{return new Response(`Mock server is not available on this host`,{status:501})}let c=await(await f(t,i.api,s))(m(e,i.path));return new Response(c.body?new Uint8Array(c.body):null,{status:c.statusCode,headers:{...c.headers,...o}})}export{u as matchMockApi,g as mock,m as toMockRequest};
1
+ import{isObject as e}from"../../../../../shared/utils/is-object.js";import{stripPathPrefix as t}from"../../../../../shared/path-prefix.js";import{filePathToRouteSlug as n}from"../../../../../shared/utils/routes/file-path-to-route-slug.js";import{mockPathPrefix as r}from"../../../types/api-entity.js";import{isPlanFeatureGranted as i}from"../../../../../shared/plan-gates.js";import{notFoundResponse as a}from"../../../../../server/plugin-context.js";const o={"Cache-Control":`no-store`},s=/* @__PURE__ */ new Map;function c(t,n){let r=n.metadata?.mockServer;return{...t,...e(r)?r:{}}}function l(e,t){let{specType:n,routeSlug:i}=e.metadata??{};return n!==`openapi`||typeof i!=`string`||c(t,e).off===!0?null:r(i)}function u(e,t,n=void 0){let r=null,i=-1;for(let a of e){let e=l(a,n);e===null||e.length<=i||d(e,t)&&(r={api:a,path:t.slice(e.length)||`/`},i=e.length)}return r}function d(e,t){return t===e||t.startsWith(`${e}/`)}function f(e,t,{createMockServer:n}){let r=s.get(t.key);if(r&&r.dataHash===t.dataHash)return r.handler;let{strictExamples:i,errorIfForcedExampleNotFound:a}=c(e.config.mockServer,t),o=e.entities.load(t.key).then(e=>n(structuredClone(e),{strictExamples:i,errorIfForcedExampleNotFound:a}));return s.set(t.key,{dataHash:t.dataHash,handler:o}),o.catch(()=>s.delete(t.key)),o}async function p(e,t){let i=await e.entities.list({type:`api`}),a=i.filter(({metadata:e})=>e?.specType!==`openapi`||e.routeSlug!==void 0?!1:d(r(n(String(e.sourcePath))),t));return a.length===0?i:(await Promise.all(a.map(t=>e.entities.load(t.key))),e.entities.list({type:`api`}))}function m(e,t){let n=(e.req.header(`x-http-method-override`)??e.req.method).toUpperCase(),{search:r}=new URL(e.req.url),i;return{path:t,method:n,query:r===``?void 0:r,headers:Object.fromEntries(e.req.raw.headers),getBody:()=>i??=e.req.arrayBuffer().then(e=>e.byteLength>0?Buffer.from(e):void 0)}}function h(e){return(t(new URL(e.req.url).pathname)??``).slice(6)||`/`}async function g(e,t){if(!i(t.config,`mockServer`))return a();let n=h(e),r=u(await p(t,n),n,t.config.mockServer);if(!r||!t.isSlugVisible(String(r.api.metadata?.routeSlug)))return a();let s;try{s=await import(`@redocly/mock-server`)}catch{return new Response(`Mock server is not available on this host`,{status:501})}let c=await(await f(t,r.api,s))(m(e,r.path));return new Response(c.body?new Uint8Array(c.body):null,{status:c.statusCode,headers:{...c.headers,...o}})}export{u as matchMockApi,g as mock,m as toMockRequest};
@@ -5,7 +5,8 @@ export declare const REACT_PAGE_SEARCH_LOADER_KEY = "search";
5
5
  /**
6
6
  * Gives each `.page.tsx` or `.page.ts` file a route whose `template` is a `source:` reference
7
7
  * to the file itself. Such a file is its own template, so it needs no template registration.
8
- * An `export const frontmatter = { ... }` literal becomes the route metadata, and its `slug`
9
- * (a string or a list) the explicit route slugs: one route for each.
8
+ * An `export const frontmatter = { ... }` literal becomes the route metadata, its `slug`
9
+ * (a string or a list) the explicit route slugs: one route for each, and its `seo.title` the
10
+ * label of a sidebar entry that names none.
10
11
  */
11
12
  export declare const reactPageContentPlugin: import("../../types/plugin.js").ContentPlugin;
@@ -1 +1 @@
1
- import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t}from"../../../loaders/define.js";import{createPluginScopedId as n}from"../../utils/scoped-id.js";import{SEARCH_GROUP_FACET_FIELD as r}from"../../../../shared/search/facets.js";import{configuredFacetFields as i,extractFacetsFromFrontmatter as a,invalidFacetValueProblems as o,searchCategoryOf as s}from"../../../search/facet-values.js";import{isObject as c}from"../../../../shared/utils/is-object.js";import{normalizeRouteSlug as l}from"../../../../shared/utils/routes/normalize-route-slug.js";import{notInPlanProblem as u}from"../../../plan-gates.js";import{filePathToRouteSlug as d}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{isPlanFeatureGranted as f}from"../../../../shared/plan-gates.js";import{isInternalPagePath as p}from"../../utils/internal-page-path.js";import{parseExplicitSlugs as m}from"../../utils/explicit-slugs.js";import{SOURCE_TEMPLATE_PREFIX as h}from"../../../../shared/constants/template-ids.js";import{curationKeywordsOf as g}from"../../../search/keywords.js";import{readPageFrontmatter as _}from"./frontmatter.js";const v=[`.page.tsx`,`.page.ts`],y=`internal.react-page`,b=`search`,x=t(n(y,`search`),async e=>({value:e.args}),{searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let{category:n,isInvalid:c}=s(t.route.metadata),{facets:l,invalidFields:u}=a(t.route.metadata,i(t.config)),d={docKey:`page`,routeSlug:t.route.slug,title:e.title,text:e.text,groupKey:n??`Documentation`,facets:l};return e.keywords!==void 0&&(d.keywords=e.keywords),{docs:[d],problems:o([...u,...c?[r]:[]],t.route.originFilePath)}}});function S(e){if(e.excludeFromSearch===!0)return;let t=c(e.search)?e.search:{},n=c(e.seo)?e.seo:{},r=e=>typeof e==`string`?e.trim():``,i=r(t.title)||r(n.title)||r(e.title),a=r(t.description)||r(n.description)||r(e.description);if(i===``&&a===``)return;let o={title:i,text:[a,...Array.isArray(t.keywords)?t.keywords.filter(e=>typeof e==`string`):[]].filter(e=>e!==``).join(` `)},s=g(t.keywords);return s!==void 0&&(o.keywords=s),o}const C=t(n(y,`seo`),async e=>{let{result:t,entityDeps:n,assetUsages:r}=await e.markdown.resolveImageReference(e.args.image,e.file.path);return t.kind===`assetRef`?{value:{image:t.url},entityDeps:n,assetUsages:r}:{value:{image:e.args.image},entityDeps:n}}),w=e({id:y,version:`1.12.0`,loaders:[C,x],content:{filter:{extensions:v},async extractFile(e,t){if(p(e.path))return{routes:[]};if(!f(t.config,`reactPages`))return{routes:[],problems:[u(`React pages`)]};let{frontmatter:n,error:r}=_(await t.io.readFile(e.path));r!==void 0&&t.logger.warn(`Ignoring the frontmatter export of a page component`,{path:e.path,error:r});let i=m(n?.slug),a=c(n?.seo)&&typeof n.seo.image==`string`?n.seo.image:void 0,o=n===null?void 0:S(n),s={};a!==void 0&&(s.seo=C.withArgs({filePath:e.path,image:a})),o!==void 0&&(s[b]=x.withArgs(o,{stableKey:`react-page:search:${e.path}`}));let g=Object.keys(s).length===0?void 0:s,v=`${h}${e.path}`;return{routes:i.length>0?i.map(e=>({routeId:`page`,slug:l(e),template:v,metadata:n??void 0,deps:g})):[{routeId:`page`,slugHint:d(e.path,T(e.path)),template:v,metadata:n??void 0,deps:g}]}}}});function T(e){return e.toLowerCase().endsWith(`.page.ts`)?`.page.ts`:`.page.tsx`}export{b as REACT_PAGE_SEARCH_LOADER_KEY,w as reactPageContentPlugin};
1
+ import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t,createInlineEntity as n}from"../../../loaders/define.js";import{createPluginScopedId as r}from"../../utils/scoped-id.js";import{SEARCH_GROUP_FACET_FIELD as i}from"../../../../shared/search/facets.js";import{configuredFacetFields as a,extractFacetsFromFrontmatter as o,invalidFacetValueProblems as s,searchCategoryOf as c}from"../../../search/facet-values.js";import{isObject as l}from"../../../../shared/utils/is-object.js";import{normalizeRouteSlug as u}from"../../../../shared/utils/routes/normalize-route-slug.js";import{notInPlanProblem as d}from"../../../plan-gates.js";import{filePathToRouteSlug as f}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{isPlanFeatureGranted as p}from"../../../../shared/plan-gates.js";import{isInternalPagePath as m}from"../../utils/internal-page-path.js";import{parseExplicitSlugs as h}from"../../utils/explicit-slugs.js";import{SOURCE_TEMPLATE_PREFIX as g}from"../../../../shared/constants/template-ids.js";import{curationKeywordsOf as _}from"../../../search/keywords.js";import{readPageFrontmatter as v}from"./frontmatter.js";const y=[`.page.tsx`,`.page.ts`],b=`internal.react-page`,x=`search`,S=t(r(b,`search`),async e=>({value:e.args}),{searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let{category:n,isInvalid:r}=c(t.route.metadata),{facets:l,invalidFields:u}=o(t.route.metadata,a(t.config)),d={docKey:`page`,routeSlug:t.route.slug,title:e.title,text:e.text,groupKey:n??`Documentation`,facets:l};return e.keywords!==void 0&&(d.keywords=e.keywords),{docs:[d],problems:s([...u,...r?[i]:[]],t.route.originFilePath)}}});function C(e){if(e.excludeFromSearch===!0)return;let t=l(e.search)?e.search:{},n=l(e.seo)?e.seo:{},r=e=>typeof e==`string`?e.trim():``,i=r(t.title)||r(n.title)||r(e.title),a=r(t.description)||r(n.description)||r(e.description);if(i===``&&a===``)return;let o={title:i,text:[a,...Array.isArray(t.keywords)?t.keywords.filter(e=>typeof e==`string`):[]].filter(e=>e!==``).join(` `)},s=_(t.keywords);return s!==void 0&&(o.keywords=s),o}const w=t(r(b,`seo`),async e=>{let{result:t,entityDeps:n,assetUsages:r}=await e.markdown.resolveImageReference(e.args.image,e.file.path);return t.kind===`assetRef`?{value:{image:t.url},entityDeps:n,assetUsages:r}:{value:{image:e.args.image},entityDeps:n}}),T=e({id:b,version:`1.13.0`,loaders:[w,S],content:{filter:{extensions:y},async extractFile(e,t){if(m(e.path))return{routes:[]};if(!p(t.config,`reactPages`))return{routes:[],problems:[d(`React pages`)]};let{frontmatter:r,error:i}=v(await t.io.readFile(e.path));i!==void 0&&t.logger.warn(`Ignoring the frontmatter export of a page component`,{path:e.path,error:i});let a=h(r?.slug),o=l(r?.seo)&&typeof r.seo.image==`string`?r.seo.image:void 0,s=r===null?void 0:C(r),c={};o!==void 0&&(c.seo=w.withArgs({filePath:e.path,image:o})),s!==void 0&&(c[x]=S.withArgs(s,{stableKey:`react-page:search:${e.path}`}));let _=Object.keys(c).length===0?void 0:c,y=`${g}${e.path}`,b=l(r?.seo)?r.seo.title:void 0,T=typeof b==`string`&&b.trim()!==``?n({label:b}):void 0;return{routes:a.length>0?a.map(e=>({routeId:`page`,slug:u(e),template:y,metadata:r??void 0,deps:_,sidebarSubtree:T})):[{routeId:`page`,slugHint:f(e.path,E(e.path)),template:y,metadata:r??void 0,deps:_,sidebarSubtree:T}]}}}});function E(e){return e.toLowerCase().endsWith(`.page.ts`)?`.page.ts`:`.page.tsx`}export{x as REACT_PAGE_SEARCH_LOADER_KEY,T as reactPageContentPlugin};
@@ -1 +1 @@
1
- import{defineContentPlugin as e}from"../../define.js";import{toJsonValue as t}from"../../../database/utils/json.js";import{createEntityLoader as n}from"../../../loaders/define.js";import{runtimeFile as r}from"../../utils/runtime-file.js";import{createPluginScopedId as i}from"../../utils/scoped-id.js";import{runtimeTemplate as a}from"../../templates.js";import{toPosixPath as o}from"../../../../shared/utils/to-posix-path.js";import{isObject as s}from"../../../../shared/utils/is-object.js";import{normalizeRouteSlug as c}from"../../../../shared/utils/routes/normalize-route-slug.js";import{publicLink as l}from"../../../versions/public-link.js";import{createApiEntityKey as u}from"../../utils/api-entity-key.js";import{API_DOCS_INFO_BLOCK_DEP_KEY as d}from"../api-docs/server/shared.js";import{getLoadedProjectPlugins as f}from"../../project/loaded-set.js";import{API_OUTPUT_MANIFEST_KEY as p}from"../../../api-outputs.js";import{CATALOG_CLASSIC_DEP_KEY as m}from"../catalog-classic/client/contract.js";import{catalogEntityKey as h}from"../catalog-classic/entity-key.js";import{CATALOG_CARD_METADATA_ENTITY_TYPE as g}from"../catalog-classic/card-metadata.js";import{loadVersionGroups as _}from"../catalog-classic/resolve-items.js";import{NON_CONFORMANT as ee,apiPagePath as v,scorecardDetailsFile as y}from"./client/contract.js";import{findTarget as b,readScorecardSettings as x}from"./config.js";import{API_SCORECARD_ENTITY_TYPE as S,RULES_ENTITY_KEY as C,apiScorecardEntityKey as w,isScoredApi as T,scorecardPageEntityKey as E}from"./entities.js";import{collectRuleNames as te,lintApi as ne,resolveLevelConfigs as D,summarizeRules as O}from"./lint.js";import{gzip as k}from"../../../../shared/utils/gzip.js";import{join as A,posix as j,relative as M}from"node:path";import re from"picomatch";const N=`internal.scorecard-classic`,P=`scorecard-classic`,ie=i(N,`api`),ae=i(N,`rules`),oe=i(N,`page`),se=i(N,`card-metadata`),ce=i(N,`badge`),F=n(ie,async e=>{let t=e.file.path,n=e.args.source??t,r=e.routes.byFilePath(t),i=r&&e.routes.get(r.slug);if(!i)return{value:null,metadata:{sourcePath:t}};let a=async t=>({body:await e.createBlobRef(await k(new TextEncoder().encode(JSON.stringify(t))),{format:`binary`}),contentType:`application/gzip`}),o=x(e.config),s=J(e.contentDir),c=b(o.targets,i.metadata),l=b(o.targets.filter(e=>e.rules!==void 0),i.metadata),u=s.paths,d;try{let t=await D({contentDir:e.contentDir,settings:o,plugins:s.plugins,readFile:e.io.readFile});u=[...t.files,...s.paths];let r=l===void 0?void 0:t.targets[o.targets.indexOf(l)];d=await ne({contentDir:e.contentDir,filePath:n,source:await e.io.readFile(A(e.contentDir,n)),configs:Object.fromEntries(o.levels.map(e=>[e.name,r?.[e.name]??t.levels[e.name]]))})}catch(e){return{value:await a(null),metadata:{sourcePath:t},problems:[{code:`scorecard/lint-failed`,message:`The scorecard could not lint this API: ${e instanceof Error?e.message:String(e)}`,location:{filePath:t}}],entityDeps:Y([n,...u])}}let f={...L(o,d.levels,c?.minimumLevel),title:await I(e.entities,t)??j.basename(n),relativePath:t,levels:d.levels};i.version!==null&&(f.version=i.version);let{levels:p,...m}=f,h={...m,levels:Object.fromEntries(Object.entries(p).map(([e,{problems:t,...n}])=>[e,n])),rules:O(p),sourcePath:t,route:i.slug};return{value:await a(f),metadata:h,entityDeps:Y([n,...d.files,...u])}});async function I(e,t){let n=await e.load(u(t)).catch(()=>void 0),r=s(n)&&s(n.info)?n.info:{};return typeof r.title==`string`?r.title:void 0}function L(e,t,n){let r=e.levels.map(e=>e.name),i=r.findIndex(e=>t[e].errors>0),a=i===-1?r.length:i,o=n??r[0],s=r.indexOf(o),c=`HIGHEST`;return a-1<s?c=`BELOW_MINIMUM`:s<r.length-1&&(c=`MINIMUM`),{scorecardLevel:a===0?ee:r[a-1],scorecardLevelIdx:a,targetLevel:o,status:c}}async function R(e,t){let n=await e.get(t);return n!==null&&(n.status!==`ready`||!T(n.metadata))&&(await e.load(t).catch(()=>void 0),n=await e.get(t)),n!==null&&T(n.metadata)?n.metadata:null}async function z(e){let t=[];for(let n of await e.list({type:S})){let r=await R(e,n.key);r!==null&&t.push(r)}return t}function B({sourcePath:e,route:t,...n}){return n}const V=n(ae,async e=>{let t=x(e.config),{perLevel:n,all:r}=await D({contentDir:e.contentDir,settings:t,plugins:J(e.contentDir).plugins,readFile:e.io.readFile}).then(e=>te(e.levels),()=>({perLevel:{},all:[]}));return{value:{levelNames:t.levels.map(e=>e.name),rules:r,rulesPerLevel:n}}}),H=n(oe,async e=>{let t=await e.entities.load(h(e.args.catalogId)),n=await e.entities.load(C),r=(await z(e.entities)).flatMap(t=>{let n=e.routes.get(t.route);return n?[{route:n,api:t}]:[]}),{versionGroups:i,entityDeps:a}=await _(r,e),o=new Map(r.map(({route:e,api:t})=>[l(e,i),B(t)])),s=[];for(let e of t.items){let t=o.get(e.link);t!==void 0&&s.push({...e,metadata:{...e.metadata,scorecard:t,scorecardLevel:t.scorecardLevel}})}let c={...t,items:s,scorecard:{...n,teamMetadataProperty:x(e.config).teamMetadataProperty}},u=JSON.stringify(c);return{value:u.length>65536?await e.createBlobRef(u,{format:`json`}):c,entityDeps:a}}),U=n(se,async e=>({value:(await z(e.entities)).map(e=>({route:e.route,metadata:{scorecardStatus:e.status,scorecardLevel:e.scorecardLevel,scorecardLevelIdx:e.scorecardLevelIdx,scorecardLevels:G(e)}}))})),W=n(ce,async e=>{let t=await R(e.entities,w(e.args.file)),n=t&&e.routes.get(t.route);if(!t||!n)return{value:null};let{versionGroups:r,entityDeps:i}=await _([{route:n}],e),a=l(n,r),o=q(e.config);if(o.length===0)return{value:null};let s=o[0].slug;if(o.length>1){for(let{catalogId:t,slug:n}of o)if((await e.entities.load(h(t))).items.some(e=>e.link===a)){s=n;break}}return{value:{scorecardLevel:t.scorecardLevel,scorecardLevelIdx:t.scorecardLevelIdx,scorecardLevels:G(t),scoreCardSlug:v(K(s),a)},entityDeps:i}});function G(e){return Object.fromEntries(Object.entries(e.levels).map(([e,t])=>[e,{uniqueErrors:t.uniqueErrors,uniqueWarnings:t.uniqueWarnings}]))}function K(e){return j.join(c(e),`scorecard`)}function q(e){return Object.entries(e.catalogClassic??e.catalog??{}).map(([e,t])=>({catalogId:e,slug:String(t.slug)}))}function J(e){let t=f(e)?.lintPlugins??[];return{plugins:t,paths:t.map(t=>o(M(e,t.path))).filter(e=>e!==``&&!e.startsWith(`../`))}}function Y(e){return[...new Set(e)].map(e=>({kind:`file`,path:e}))}function X(e){let t=e=>typeof e==`string`||typeof e==`number`;return t(e.manifest.openapi)||t(e.manifest.swagger)}function Z(e){let t=e.manifest[p];return s(t)&&typeof t.root==`string`?t.root:e.path}function Q(e){let t=Z(e);return F.withArgs(t===e.path?{}:{source:t},{stableKey:w(e.path),type:S,metadata:{sourcePath:e.path}})}function $(e,t){if(!X(e))return!1;let n=(t.scorecardClassic??t.scorecard)?.ignore??[];return n.length===0||!re([...n])(Z(e))}function le(e,t){let n=e.filter(e=>e.status===`BELOW_MINIMUM`).map(e=>e.relativePath);if(n.length===0)return;let r=n.slice(0,15).map(e=>`\n - ${e}`),i=n.length-r.length,a=`Detected OpenAPI definitions with score below minimum level:${r.join(``)}${i>0?`\n ... and ${i} more`:``}`;t.config.platform?.ignoreLint??(t.config.scorecardClassic??t.config.scorecard)?.ignoreNonCompliant?t.logger.warn(a):t.logger.error(a)}const ue=e({id:N,version:`2.3.0`,content:{filter:{extensions:[`.yaml`,`.yml`,`.json`]},extractFile(e,t){return $(e,t.config)?{routes:[],entities:[Q(e)]}:null},extractAll(e){let t=e.config.catalogClassic??e.config.catalog??{};if(!e.files.some(X)&&Object.keys(t).length===0)return{routes:[]};let n=x(e.config),r=[V.withArgs({},{stableKey:C})];n.isDefault||r.push(U.withArgs({},{stableKey:`scorecard-classic:card-metadata`,type:g}));let i=[];for(let[e,n]of Object.entries(t)){let t=K(String(n.slug)),a=H.withArgs({catalogId:e},{stableKey:E(e),metadata:{sourcePath:t}});r.push(a),i.push({deps:{[m]:a},metadata:{title:typeof n.title==`string`?n.title:`API design scorecard`},routeId:e,slug:t,template:P,wildcardPrefix:!0})}return{entities:r,routes:i}}},finalize(e){let t=q(e.config).length>0&&!x(e.config).isDefault,n=[],r=[],i=[];for(let a of e.files){let o=$(a,e.config)?e.routes.byFilePath(a.path):void 0;if(o===void 0||(n.push({path:y(a.path),producer:Q(a),audience:{routeSlug:o.slug}}),!t))continue;let s=W.withArgs({file:a.path},{stableKey:`scorecard-classic:badge:${o.slug}`});r.push(s),i.push({slug:o.slug,deps:{[d]:s}})}return{entities:r,attach:i,staticFiles:n}},async buildMetadata(e){if(await e.entities.get(`scorecard-classic:rules`)===null)return;let n=await e.entities.load(C),r=await z(e.entities),i={};for(let e of r){let{rules:t,...n}=B(e);i[e.relativePath]=n}return le(r,e),{scorecardData:i,...n,reuniteIgnoreLint:t(e.config.platform?.ignoreLint)}},loaders:[F,V,H,U,W],templates:{[P]:a(r(`./client/template.tsx`,import.meta.url))}});export{N as SCORECARD_CLASSIC_PLUGIN_ID,P as SCORECARD_CLASSIC_TEMPLATE_ID,ue as scorecardClassicContentPlugin};
1
+ import{defineContentPlugin as e}from"../../define.js";import{toJsonValue as t}from"../../../database/utils/json.js";import{createEntityLoader as n}from"../../../loaders/define.js";import{runtimeFile as r}from"../../utils/runtime-file.js";import{createPluginScopedId as i}from"../../utils/scoped-id.js";import{runtimeTemplate as a}from"../../templates.js";import{isObject as o}from"../../../../shared/utils/is-object.js";import{normalizeRouteSlug as s}from"../../../../shared/utils/routes/normalize-route-slug.js";import{API_DOCS_INFO_BLOCK_DEP_KEY as c}from"../api-docs/server/shared.js";import{CATALOG_CLASSIC_DEP_KEY as l}from"../catalog-classic/client/contract.js";import{toPosixPath as u}from"../../../../shared/utils/to-posix-path.js";import{publicLink as d}from"../../../versions/public-link.js";import{createApiEntityKey as f}from"../../utils/api-entity-key.js";import{getLoadedProjectPlugins as p}from"../../project/loaded-set.js";import{API_OUTPUT_MANIFEST_KEY as m}from"../../../api-outputs.js";import{catalogEntityKey as h}from"../catalog-classic/entity-key.js";import{CATALOG_CARD_METADATA_ENTITY_TYPE as g}from"../catalog-classic/card-metadata.js";import{loadVersionGroups as _}from"../catalog-classic/resolve-items.js";import{NON_CONFORMANT as ee,apiPagePath as v,scorecardDetailsFile as y}from"./client/contract.js";import{findTarget as b,readScorecardSettings as x}from"./config.js";import{API_SCORECARD_ENTITY_TYPE as S,RULES_ENTITY_KEY as C,apiScorecardEntityKey as w,isScoredApi as T,scorecardPageEntityKey as E}from"./entities.js";import{collectRuleNames as te,lintApi as ne,resolveLevelConfigs as D,summarizeRules as O}from"./lint.js";import{gzip as k}from"../../../../shared/utils/gzip.js";import{join as A,posix as j,relative as M}from"node:path";import re from"picomatch";const N=`internal.scorecard-classic`,P=`scorecard-classic`,ie=i(N,`api`),ae=i(N,`rules`),oe=i(N,`page`),se=i(N,`card-metadata`),ce=i(N,`badge`),F=n(ie,async e=>{let t=e.file.path,n=e.args.source??t,r=e.routes.byFilePath(t),i=r&&e.routes.get(r.slug);if(!i)return{value:null,metadata:{sourcePath:t}};let a=async t=>({body:await e.createBlobRef(await k(new TextEncoder().encode(JSON.stringify(t))),{format:`binary`}),contentType:`application/gzip`}),o=x(e.config),s=J(e.contentDir),c=b(o.targets,i.metadata),l=b(o.targets.filter(e=>e.rules!==void 0),i.metadata),u=s.paths,d;try{let t=await D({contentDir:e.contentDir,settings:o,plugins:s.plugins,readFile:e.io.readFile});u=[...t.files,...s.paths];let r=l===void 0?void 0:t.targets[o.targets.indexOf(l)];d=await ne({contentDir:e.contentDir,filePath:n,source:await e.io.readFile(A(e.contentDir,n)),configs:Object.fromEntries(o.levels.map(e=>[e.name,r?.[e.name]??t.levels[e.name]]))})}catch(e){return{value:await a(null),metadata:{sourcePath:t},problems:[{code:`scorecard/lint-failed`,message:`The scorecard could not lint this API: ${e instanceof Error?e.message:String(e)}`,location:{filePath:t}}],entityDeps:Y([n,...u])}}let f={...L(o,d.levels,c?.minimumLevel),title:await I(e.entities,t)??j.basename(n),relativePath:t,levels:d.levels};i.version!==null&&(f.version=i.version);let{levels:p,...m}=f,h={...m,levels:Object.fromEntries(Object.entries(p).map(([e,{problems:t,...n}])=>[e,n])),rules:O(p),sourcePath:t,route:i.slug};return{value:await a(f),metadata:h,entityDeps:Y([n,...d.files,...u])}});async function I(e,t){let n=await e.load(f(t)).catch(()=>void 0),r=o(n)&&o(n.info)?n.info:{};return typeof r.title==`string`?r.title:void 0}function L(e,t,n){let r=e.levels.map(e=>e.name),i=r.findIndex(e=>t[e].errors>0),a=i===-1?r.length:i,o=n??r[0],s=r.indexOf(o),c=`HIGHEST`;return a-1<s?c=`BELOW_MINIMUM`:s<r.length-1&&(c=`MINIMUM`),{scorecardLevel:a===0?ee:r[a-1],scorecardLevelIdx:a,targetLevel:o,status:c}}async function R(e,t){let n=await e.get(t);return n!==null&&(n.status!==`ready`||!T(n.metadata))&&(await e.load(t).catch(()=>void 0),n=await e.get(t)),n!==null&&T(n.metadata)?n.metadata:null}async function z(e){let t=[];for(let n of await e.list({type:S})){let r=await R(e,n.key);r!==null&&t.push(r)}return t}function B({sourcePath:e,route:t,...n}){return n}const V=n(ae,async e=>{let t=x(e.config),{perLevel:n,all:r}=await D({contentDir:e.contentDir,settings:t,plugins:J(e.contentDir).plugins,readFile:e.io.readFile}).then(e=>te(e.levels),()=>({perLevel:{},all:[]}));return{value:{levelNames:t.levels.map(e=>e.name),rules:r,rulesPerLevel:n}}}),H=n(oe,async e=>{let t=await e.entities.load(h(e.args.catalogId)),n=await e.entities.load(C),r=(await z(e.entities)).flatMap(t=>{let n=e.routes.get(t.route);return n?[{route:n,api:t}]:[]}),{versionGroups:i,entityDeps:a}=await _(r,e),o=new Map(r.map(({route:e,api:t})=>[d(e,i),B(t)])),s=[];for(let e of t.items){let t=o.get(e.link);t!==void 0&&s.push({...e,metadata:{...e.metadata,scorecard:t,scorecardLevel:t.scorecardLevel}})}let c={...t,items:s,scorecard:{...n,teamMetadataProperty:x(e.config).teamMetadataProperty}},l=JSON.stringify(c);return{value:l.length>65536?await e.createBlobRef(l,{format:`json`}):c,entityDeps:a}}),U=n(se,async e=>({value:(await z(e.entities)).map(e=>({route:e.route,metadata:{scorecardStatus:e.status,scorecardLevel:e.scorecardLevel,scorecardLevelIdx:e.scorecardLevelIdx,scorecardLevels:G(e)}}))})),W=n(ce,async e=>{let t=await R(e.entities,w(e.args.file)),n=t&&e.routes.get(t.route);if(!t||!n)return{value:null};let{versionGroups:r,entityDeps:i}=await _([{route:n}],e),a=d(n,r),o=q(e.config);if(o.length===0)return{value:null};let s=o[0].slug;if(o.length>1){for(let{catalogId:t,slug:n}of o)if((await e.entities.load(h(t))).items.some(e=>e.link===a)){s=n;break}}return{value:{scorecardLevel:t.scorecardLevel,scorecardLevelIdx:t.scorecardLevelIdx,scorecardLevels:G(t),scoreCardSlug:v(K(s),a)},entityDeps:i}});function G(e){return Object.fromEntries(Object.entries(e.levels).map(([e,t])=>[e,{uniqueErrors:t.uniqueErrors,uniqueWarnings:t.uniqueWarnings}]))}function K(e){return j.join(s(e),`scorecard`)}function q(e){return Object.entries(e.catalogClassic??e.catalog??{}).map(([e,t])=>({catalogId:e,slug:String(t.slug)}))}function J(e){let t=p(e)?.lintPlugins??[];return{plugins:t,paths:t.map(t=>u(M(e,t.path))).filter(e=>e!==``&&!e.startsWith(`../`))}}function Y(e){return[...new Set(e)].map(e=>({kind:`file`,path:e}))}function X(e){let t=e=>typeof e==`string`||typeof e==`number`;return t(e.manifest.openapi)||t(e.manifest.swagger)}function Z(e){let t=e.manifest[m];return o(t)&&typeof t.root==`string`?t.root:e.path}function Q(e){let t=Z(e);return F.withArgs(t===e.path?{}:{source:t},{stableKey:w(e.path),type:S,metadata:{sourcePath:e.path}})}function $(e,t){if(!X(e))return!1;let n=(t.scorecardClassic??t.scorecard)?.ignore??[];return n.length===0||!re([...n])(Z(e))}function le(e,t){let n=e.filter(e=>e.status===`BELOW_MINIMUM`).map(e=>e.relativePath);if(n.length===0)return;let r=n.slice(0,15).map(e=>`\n - ${e}`),i=n.length-r.length,a=`Detected OpenAPI definitions with score below minimum level:${r.join(``)}${i>0?`\n ... and ${i} more`:``}`;t.config.platform?.ignoreLint??(t.config.scorecardClassic??t.config.scorecard)?.ignoreNonCompliant?t.logger.warn(a):t.logger.error(a)}const ue=e({id:N,version:`2.3.0`,content:{filter:{extensions:[`.yaml`,`.yml`,`.json`]},extractFile(e,t){return $(e,t.config)?{routes:[],entities:[Q(e)]}:null},extractAll(e){let t=e.config.catalogClassic??e.config.catalog??{};if(!e.files.some(X)&&Object.keys(t).length===0)return{routes:[]};let n=x(e.config),r=[V.withArgs({},{stableKey:C})];n.isDefault||r.push(U.withArgs({},{stableKey:`scorecard-classic:card-metadata`,type:g}));let i=[];for(let[e,n]of Object.entries(t)){let t=K(String(n.slug)),a=H.withArgs({catalogId:e},{stableKey:E(e),metadata:{sourcePath:t}});r.push(a),i.push({deps:{[l]:a},metadata:{title:typeof n.title==`string`?n.title:`API design scorecard`},routeId:e,slug:t,template:P,wildcardPrefix:!0})}return{entities:r,routes:i}}},finalize(e){let t=q(e.config).length>0&&!x(e.config).isDefault,n=[],r=[],i=[];for(let a of e.files){let o=$(a,e.config)?e.routes.byFilePath(a.path):void 0;if(o===void 0||(n.push({path:y(a.path),producer:Q(a),audience:{routeSlug:o.slug}}),!t))continue;let s=W.withArgs({file:a.path},{stableKey:`scorecard-classic:badge:${o.slug}`});r.push(s),i.push({slug:o.slug,deps:{[c]:s}})}return{entities:r,attach:i,staticFiles:n}},async buildMetadata(e){if(await e.entities.get(`scorecard-classic:rules`)===null)return;let n=await e.entities.load(C),r=await z(e.entities),i={};for(let e of r){let{rules:t,...n}=B(e);i[e.relativePath]=n}return le(r,e),{scorecardData:i,...n,reuniteIgnoreLint:t(e.config.platform?.ignoreLint)}},loaders:[F,V,H,U,W],templates:{[P]:a(r(`./client/template.tsx`,import.meta.url))}});export{N as SCORECARD_CLASSIC_PLUGIN_ID,P as SCORECARD_CLASSIC_TEMPLATE_ID,ue as scorecardClassicContentPlugin};
@@ -1 +1 @@
1
- import{L10N_DIR as e}from"../../../../shared/constants/l10n/defaults.js";import{isObject as t}from"../../../../shared/utils/is-object.js";import"../../../../shared/utils/l10n.js";import{resolveContentPath as n}from"../../../../shared/utils/resolve-content-path.js";import{isLocalImagePath as r}from"../assets/extensions.js";import{splitUrlSuffix as i}from"../../../../shared/utils/routes/split-url-suffix.js";import{toNavItemRbacAnnotation as a}from"../../../../server/rbac/filter.js";import{resolvePageTarget as o}from"../../../../shared/utils/routes/resolve-page-target.js";import{collectVersionGroups as s,findVersionedDirectories as c}from"../../../versions/version-groups.js";import{joinSrcSet as l,parseSrcSet as u}from"../assets/srcset.js";import{classifyLinkTarget as d}from"../../../link-checker/classify.js";import{posix as f}from"node:path";import p from"js-yaml";function m(e){return typeof e.tab==`string`}function h(e,t,n){e.report?.({code:t,message:n,location:{filePath:e.file.path}})}function g(e,r){let i=p.load(e);if(!Array.isArray(i))return[];let a=[],o=e=>{if(t(e)){if(typeof e.$ref==`string`){let t=n(e.$ref,r);t!==null&&a.push(t)}if(Array.isArray(e.items))for(let t of e.items)o(t);if(m(e)&&Array.isArray(e.menu))for(let t of e.menu)o(t)}};for(let e of i)o(e);return a}async function _(e){let t=p.load(e.source);if(!Array.isArray(t))return[];let n=[];return await v({entries:t,ownerFilePath:e.filePath,currentFilePath:e.filePath,readFile:e.readFile,visitedRefs:/* @__PURE__ */ new Set([e.filePath]),refs:n}),n}async function v(e){let{ownerFilePath:t,currentFilePath:r,readFile:i,refs:a}=e;for(let o of e.entries){let s=K(o);if(s===void 0)continue;if(typeof s.$ref==`string`){let o=n(s.$ref,r);if(o===null||i===void 0||e.visitedRefs.has(o))continue;let c;try{c=await i(o)}catch{continue}let l=p.load(c);if(!Array.isArray(l))continue;let u=new Set(e.visitedRefs);u.add(o),await v({entries:l,ownerFilePath:t,currentFilePath:o,readFile:i,visitedRefs:u,refs:a});continue}let c=typeof s.page==`string`?s.page:s.href;typeof c==`string`&&y(a,c,r,t),Array.isArray(s.items)&&await v({...e,entries:s.items}),m(s)&&Array.isArray(s.menu)&&await v({...e,entries:s.menu})}}function y(e,t,n,r){let i=d(t,n);i!==null&&e.push({kind:`link`,raw:t,...i,...n===r?{}:{filePath:n}})}async function b(e){let t=p.load(e.source);if(!Array.isArray(t))throw Error(`Sidebar "${e.file.path}" must be a YAML sequence at the top level.`);return x({...e,entries:t})}async function x(e){let n=e.entries,r=n.filter(e=>t(e)&&m(e));if(r.length>0&&r.length!==n.length)throw Error(`Sidebar "${e.file.path}": when a sidebar uses navigation tabs, every top-level entry must be a tab (found ${n.length-r.length} other entries).`);let i={file:e.file,routes:e.routes,assignedRouteSlugs:/* @__PURE__ */ new Set,versionedDirectories:/* @__PURE__ */ new Set,report:e.report,readFile:e.readFile,skipRoutes:e.skipRoutes,exists:e.exists,sidebarByDirectory:e.sidebarByDirectory??/* @__PURE__ */ new Map,visitedRefs:/* @__PURE__ */ new Set([e.file.path])},a=[];if(r.length>0){for(let[e,t]of r.entries())a.push(await P({...i,entry:t,tabIndex:e}));L({file:e.file,tabs:a,routes:e.routes})}else for(let e of n)a.push(...await S({...i,entry:e}));return{assignedRouteSlugs:[...i.assignedRouteSlugs].sort(),versionedDirectories:[...i.versionedDirectories].sort(),nodes:a}}async function S(e){let n=await C(e),r=t(e.entry)?e.entry.rbac:void 0;if(r===void 0)return n;let i=I({...e,rbac:r});for(let e of n)Object.assign(e,i);return n}async function C(e){let t=K(e.entry);if(t===void 0)return h(e,`sidebar/invalid-entry`,`Sidebar entry ${G(e.entry)} is not a page reference or a group.`),[];if(m(t))throw Error(`Sidebar "${e.file.path}": "tab" is only allowed at the top level (found nested tab "${t.tab}").`);if(t.menu!==void 0)throw Error(`Sidebar "${e.file.path}": "menu" is only allowed directly on a tab.`);if(typeof t.$ref==`string`)return D({...e,ref:t.$ref});if(typeof t.directory==`string`&&E(t)&&t.items===void 0)return C({...e,entry:{...t,directory:void 0,items:[{directory:t.directory,flatten:t.flatten}]}});if(typeof t.directory==`string`){let r=n(t.directory,e.file.path);if(r===null)return h(e,`sidebar/invalid-entry`,`Sidebar directory "${t.directory}" is outside the content root.`),[];let i=e.routes.inDirectory(r);i.length===0&&h(e,`sidebar/missing-target`,`Sidebar directory "${t.directory}" has no pages.`);let a=await z({...e,directoryPath:r,flatten:t.flatten===!0,pages:i.filter(t=>!e.skipRoutes?.has(t.slug))}),o=J(t.group)??J(t.label);return o===void 0?a:[{type:`group`,...X(t,e),menuStyle:Z(t),items:a.length>0?a:void 0,label:o,labelTranslationKey:T(t)}]}if(typeof t.separator==`string`)return[{type:`separator`,...X(t,e),label:t.separator,labelTranslationKey:J(t.separatorTranslationKey)}];let r=await V(t,e),i=r.route;if(i)for(let t of c([i]))e.versionedDirectories.add(t);let a;if(Array.isArray(t.items)){a=[];for(let n of t.items)a.push(...await S({...e,entry:n}))}let o=J(t.group)??J(t.label)??(i===void 0?J(t.href):void 0)??r.anchor,s=E(t);return[{type:w(t,i,r.linksConnectedHeading===!0),...X(t,e),menuStyle:s?Z(t):void 0,external:t.external===!0||void 0,languageInsensitive:r.languageInsensitive?!0:void 0,items:a&&a.length>0?a:void 0,label:o,labelTranslationKey:T(t),link:r.link,isGroup:s?!0:void 0,version:J(t.version)??i?.version??void 0,versionGroup:i?.versionGroup??void 0}]}function w(e,t,n){if(E(e)&&!n)return`group`;if(t!==void 0||e.href||e.label)return`link`}function T(e){return J(E(e)?e.groupTranslationKey:e.labelTranslationKey)}function E(e){return J(e.group)!==void 0}async function D(e){let{ref:t}=e,r=n(t,e.file.path);if(r===null)return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${t}" is outside the content root.`),[];if(e.readFile===void 0)return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${t}" is not supported here.`),[];if(e.visitedRefs.has(r))return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${r}" includes itself.`),[];let i;try{i=await e.readFile(r)}catch{return h(e,`sidebar/missing-target`,`Sidebar $ref "${r}" could not be read.`),[]}let a=p.load(i);return Array.isArray(a)?O(e,r,a):(h(e,`sidebar/invalid-entry`,`Sidebar $ref "${r}" must be a YAML sequence.`),[])}async function O(e,t,n){let r=/* @__PURE__ */ new Set([...e.visitedRefs,t]),i=[];for(let a of n)i.push(...await S({...e,entry:a,file:{path:t},visitedRefs:r}));return i}async function k(e,t){if(e.readFile===void 0)return[];let n=p.load(await e.readFile(t));return Array.isArray(n)?O({...e,assignedRouteSlugs:/* @__PURE__ */ new Set,report:void 0},t,n.map(A)):[]}function A(e){if(!t(e)||!m(e))return e;let{tab:n,menu:r,...i}=e;return{...i,group:n,items:i.items??r}}function j(e,t){return`${e}-${t.normalize(`NFKD`).replace(/[\u0300-\u036f]/g,``).toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-+|(?<!-)-+$/g,``)||`tab`}`}function M(e){return/* @__PURE__ */ Error(`Sidebar "${e.file.path}": tab "${e.label}" ${e.message}.`)}function N(e){let{file:t,entry:n}=e,r=n.tab,i=n.menu!==void 0;if(i&&n.items!==void 0)throw M({file:t,label:r,message:`cannot have both "menu" and "items"`});if(i&&n.page!==void 0)throw M({file:t,label:r,message:`has "menu" and cannot also have "page"`});if(!i&&n.page===void 0)throw M({file:t,label:r,message:`needs "page" or "menu"`});if(typeof n.page==`string`&&n.page.includes(`#`))throw M({file:t,label:r,message:`page must not contain a heading anchor`});if(i&&!Array.isArray(n.menu))throw M({file:t,label:r,message:`"menu" must be a list of entries`});if(i&&Array.isArray(n.menu)&&n.menu.length===0)throw M({file:t,label:r,message:`has an empty "menu"`});if(n.$ref!==void 0||n.directory!==void 0||n.group!==void 0||n.href!==void 0)throw M({file:t,label:r,message:`accepts only "page", "items", "menu" and "icon"; move "$ref"/"directory"/"group"/"href" into "items"`})}async function P(e){let{entry:t}=e,n=t.tab;N({file:e.file,entry:t});let r=j(e.tabIndex,n);if(t.menu!==void 0){let i=Array.isArray(t.menu)?t.menu:[],a=[];for(let[t,n]of i.entries()){let i=await F({...e,tabId:r,index:t,raw:n});i!==void 0&&a.push(i)}return{tab:!0,tabId:r,label:n,menu:a,...Q(t.icon,e),...I({...e,rbac:t.rbac})}}let[i]=await S({...e,entry:{page:t.page,label:n,items:t.items,rbac:t.rbac}}),a=i?.items??[];return{...i,tab:!0,tabId:r,...Q(t.icon,e),items:a}}async function F(e){let{file:t,entry:n,tabId:r,index:i,raw:a}=e,o=n.tab,s=K(a);if(s===void 0||typeof s.page!=`string`)throw Error(`Sidebar "${t.path}": menu entry ${i+1} of tab "${o}" needs "page".`);if(s.page.includes(`#`))throw Error(`Sidebar "${t.path}": menu entry ${i+1} of tab "${o}" page must not contain a heading anchor.`);let c=`${r}/${i}`,[l]=await S({...e,entry:s});return l?.link===void 0?void 0:{...l,tabId:c,items:l.items??[]}}function I(e){return a(e.rbac,()=>h(e,`sidebar/invalid-entry`,`Sidebar entry has an invalid "rbac" value, so it is hidden.`))}function L(e){let t=/* @__PURE__ */ new Map,n=(n,r)=>{for(let i of r){let r=t.get(i);if(r!==void 0&&r.tabId!==n.tabId)throw Error(`Sidebar "${e.file.path}": route "${i}" is claimed by two navigation tabs, "${r.label}" and "${n.label}". A route can belong to one tab only.`);t.set(i,n)}};for(let t of e.tabs){if(t.menu!==void 0){for(let r of t.menu)r.tabId!==void 0&&n({tabId:r.tabId,label:`${t.label} > ${r.label??r.link}`},R({routes:e.routes,link:r.link,items:r.items}));continue}t.tabId!==void 0&&n({tabId:t.tabId,label:t.label??t.link??``},R({routes:e.routes,link:t.link,items:t.items}))}}function R(e){let t=[],n=n=>{if(n.link===void 0||n.languageInsensitive===!0)return;let r=e.routes.bySlug(n.link);r!==void 0&&r.originFilePath!==null&&t.push(r.slug)};n({link:e.link});let r=e=>{if(e!==void 0)for(let t of e)n(t),r(t.items)};return r(e.items),t}async function z(t){let n=t.directoryPath===``?``:`${t.directoryPath}/`,r=[],i=/* @__PURE__ */ new Map,a=/* @__PURE__ */ new Set,o=t.directoryPath.startsWith(`${e}/`),s=t.pages.filter(e=>o||e.locale===``).map(e=>({route:e,relativePath:e.originFilePath?.startsWith(n)?e.originFilePath.slice(n.length):null})).sort((e,t)=>B(e.relativePath??e.route.slug,t.relativePath??t.route.slug));for(let e of s){let n=e.relativePath?.split(`/`).slice(0,-1)??[],r=c(n);if(r!==void 0){if(!a.has(r.path)){a.add(r.path);let e=await k(t,r.path);e.length>0&&u(l(n,r.depth)).push(...e)}continue}U(e.route,t),e.route.version&&t.versionedDirectories.add(t.directoryPath),u(l(n,n.length)).push({type:`link`,link:e.route.slug,version:e.route.version??void 0,versionGroup:e.route.versionGroup??void 0})}return r;function c(e){for(let n=0;n<=e.length;n++){let r=f.join(t.directoryPath,...e.slice(0,n)),i=t.sidebarByDirectory.get(r);if(i!==void 0&&!t.visitedRefs.has(i))return{depth:n,path:i}}}function l(e,n){return t.flatten?[]:e.slice(0,n).filter(e=>!e.startsWith(`@`))}function u(e){let t=r,n=``;for(let r of e){n=n===``?r:`${n}/${r}`;let e=i.get(n);if(e){t=e;continue}let a=[];t.push({type:`group`,items:a,label:r}),i.set(n,a),t=a}return t}}function B(e,t){return e.startsWith(`index.`)?-1:t.startsWith(`index.`)?1:e.localeCompare(t,void 0,{numeric:!0})}async function V(e,t){if(typeof e.page==`string`){let{path:n,suffix:r,anchor:a}=i(e.page.trim()),o=await H(n,t);if(!o)return{};let s=e.disconnect!==!0;return s&&U(o,t),{link:`${o.slug}${r}`,anchor:a,linksConnectedHeading:s&&a!==void 0,route:o}}if(typeof e.href==`string`){let n=e.href;if(n.startsWith(`/`)){let e=t.routes.bySlug(n);return e?{link:e.slug,route:e}:{link:n,languageInsensitive:!0}}return{link:n,languageInsensitive:!0}}return{}}async function H(e,t){let r=o(e,t.file.path,t.routes);if(r.kind===`escaped`){h(t,`sidebar/invalid-entry`,`Sidebar page "${e}" is outside the content root.`);return}if(r.kind===`missing`){let r=n(e,t.file.path);r!==null&&await t.exists?.(r)&&h(t,`sidebar/missing-target`,`Sidebar page "${e}" is a file that makes no page.`);return}return r.value}function U(e,t){t.assignedRouteSlugs.add(e.slug)}async function W(e){if(e.versionedDirectories.length===0)return;let t=await s({io:e.io,routes:e.routes,versionedDirectories:e.versionedDirectories}),n=e=>{for(let r of e){if(r.version!==void 0&&r.versionGroup!==void 0){let e=t.get(r.versionGroup),n=e?.labels.get(r.version);n&&(r.versionLabel=n),e?.defaultVersion===r.version&&(r.isDefaultVersion=!0)}r.items&&n(r.items),r.menu&&n(r.menu)}};n(e.nodes)}function G(e){let t=JSON.stringify(e)??String(e);return t.length>80?`${t.slice(0,79)}…`:t}function K(e){return typeof e==`string`?e.trim()===``?void 0:{page:e}:t(e)?e:void 0}function q(e){if(!Array.isArray(e))return;let n=[];for(let r of e){let e=t(r)?J(r.name):void 0;t(r)&&e!==void 0&&n.push({name:e,color:J(r.color),icon:J(r.icon),position:r.position===`before`||r.position===`after`?r.position:void 0})}return n.length>0?n:void 0}function J(e){return typeof e==`string`&&e.trim()!==``?e:void 0}function Y(e,t){return t.find(t=>t===e)}function X(e,t){return{badges:q(e.badges),...Q(e.icon,t),expanded:e.expanded===!0?`true`:Y(e.expanded,[`always`]),selectFirstItemOnExpand:e.selectFirstItemOnExpand===!0||void 0,separatorLine:e.separatorLine===!0||void 0,linePosition:Y(e.linePosition,[`top`,`bottom`]),target:J(e.target),sublabel:J(e.sublabel)}}function Z(e){return Y(e.menuStyle,[`drilldown`,`drilldown-header`])}function Q(e,n){let r=t(e)?J(e.srcSet):void 0;if(r!==void 0){let e=u(r);if(e===null)return{srcSet:r};for(let t of e)t.src=$(t.src,n);return{srcSet:l(e)}}let i=J(e);return i===void 0?{}:{icon:$(i,n)}}function $(e,t){if(!r(e))return e;let i=n(e,t.file.path);return i===null?(h(t,`sidebar/invalid-entry`,`Sidebar icon "${e}" is outside the content root.`),e):`/${i}`}export{b as bundleSidebar,x as bundleSidebarEntries,_ as collectSidebarLinkRefs,g as collectSidebarRefTargets,W as stampDefaultVersions};
1
+ import{L10N_DIR as e}from"../../../../shared/constants/l10n/defaults.js";import{isObject as t}from"../../../../shared/utils/is-object.js";import"../../../../shared/utils/l10n.js";import{splitUrlSuffix as n}from"../../../../shared/utils/routes/split-url-suffix.js";import{resolveContentPath as r}from"../../../../shared/utils/resolve-content-path.js";import{isLocalImagePath as i}from"../assets/extensions.js";import{toNavItemRbacAnnotation as a}from"../../../../server/rbac/filter.js";import{resolvePageTarget as o}from"../../../../shared/utils/routes/resolve-page-target.js";import{collectVersionGroups as s,findVersionedDirectories as c}from"../../../versions/version-groups.js";import{joinSrcSet as l,parseSrcSet as u}from"../assets/srcset.js";import{classifyLinkTarget as d}from"../../../link-checker/classify.js";import{posix as f}from"node:path";import p from"js-yaml";function m(e){return typeof e.tab==`string`}function h(e,t,n){e.report?.({code:t,message:n,location:{filePath:e.file.path}})}function g(e,n){let i=p.load(e);if(!Array.isArray(i))return[];let a=[],o=e=>{if(t(e)){if(typeof e.$ref==`string`){let t=r(e.$ref,n);t!==null&&a.push(t)}if(Array.isArray(e.items))for(let t of e.items)o(t);if(m(e)&&Array.isArray(e.menu))for(let t of e.menu)o(t)}};for(let e of i)o(e);return a}async function _(e){let t=p.load(e.source);if(!Array.isArray(t))return[];let n=[];return await v({entries:t,ownerFilePath:e.filePath,currentFilePath:e.filePath,readFile:e.readFile,visitedRefs:/* @__PURE__ */ new Set([e.filePath]),refs:n}),n}async function v(e){let{ownerFilePath:t,currentFilePath:n,readFile:i,refs:a}=e;for(let o of e.entries){let s=K(o);if(s===void 0)continue;if(typeof s.$ref==`string`){let o=r(s.$ref,n);if(o===null||i===void 0||e.visitedRefs.has(o))continue;let c;try{c=await i(o)}catch{continue}let l=p.load(c);if(!Array.isArray(l))continue;let u=new Set(e.visitedRefs);u.add(o),await v({entries:l,ownerFilePath:t,currentFilePath:o,readFile:i,visitedRefs:u,refs:a});continue}let c=typeof s.page==`string`?s.page:s.href;typeof c==`string`&&y(a,c,n,t),Array.isArray(s.items)&&await v({...e,entries:s.items}),m(s)&&Array.isArray(s.menu)&&await v({...e,entries:s.menu})}}function y(e,t,n,r){let i=d(t,n);i!==null&&e.push({kind:`link`,raw:t,...i,...n===r?{}:{filePath:n}})}async function b(e){let t=p.load(e.source);if(!Array.isArray(t))throw Error(`Sidebar "${e.file.path}" must be a YAML sequence at the top level.`);return x({...e,entries:t})}async function x(e){let n=e.entries,r=n.filter(e=>t(e)&&m(e));if(r.length>0&&r.length!==n.length)throw Error(`Sidebar "${e.file.path}": when a sidebar uses navigation tabs, every top-level entry must be a tab (found ${n.length-r.length} other entries).`);let i={file:e.file,routes:e.routes,assignedRouteSlugs:/* @__PURE__ */ new Set,versionedDirectories:/* @__PURE__ */ new Set,report:e.report,readFile:e.readFile,skipRoutes:e.skipRoutes,exists:e.exists,sidebarByDirectory:e.sidebarByDirectory??/* @__PURE__ */ new Map,visitedRefs:/* @__PURE__ */ new Set([e.file.path])},a=[];if(r.length>0){for(let[e,t]of r.entries())a.push(await P({...i,entry:t,tabIndex:e}));L({file:e.file,tabs:a,routes:e.routes})}else for(let e of n)a.push(...await S({...i,entry:e}));return{assignedRouteSlugs:[...i.assignedRouteSlugs].sort(),versionedDirectories:[...i.versionedDirectories].sort(),nodes:a}}async function S(e){let n=await C(e),r=t(e.entry)?e.entry.rbac:void 0;if(r===void 0)return n;let i=I({...e,rbac:r});for(let e of n)Object.assign(e,i);return n}async function C(e){let t=K(e.entry);if(t===void 0)return h(e,`sidebar/invalid-entry`,`Sidebar entry ${G(e.entry)} is not a page reference or a group.`),[];if(m(t))throw Error(`Sidebar "${e.file.path}": "tab" is only allowed at the top level (found nested tab "${t.tab}").`);if(t.menu!==void 0)throw Error(`Sidebar "${e.file.path}": "menu" is only allowed directly on a tab.`);if(typeof t.$ref==`string`)return D({...e,ref:t.$ref});if(typeof t.directory==`string`&&E(t)&&t.items===void 0)return C({...e,entry:{...t,directory:void 0,items:[{directory:t.directory,flatten:t.flatten}]}});if(typeof t.directory==`string`){let n=r(t.directory,e.file.path);if(n===null)return h(e,`sidebar/invalid-entry`,`Sidebar directory "${t.directory}" is outside the content root.`),[];let i=e.routes.inDirectory(n);i.length===0&&h(e,`sidebar/missing-target`,`Sidebar directory "${t.directory}" has no pages.`);let a=await z({...e,directoryPath:n,flatten:t.flatten===!0,pages:i.filter(t=>!e.skipRoutes?.has(t.slug))}),o=J(t.group)??J(t.label);return o===void 0?a:[{type:`group`,...X(t,e),menuStyle:Z(t),items:a.length>0?a:void 0,label:o,labelTranslationKey:T(t)}]}if(typeof t.separator==`string`)return[{type:`separator`,...X(t,e),label:t.separator,labelTranslationKey:J(t.separatorTranslationKey)}];let n=await V(t,e),i=n.route;if(i)for(let t of c([i]))e.versionedDirectories.add(t);let a;if(Array.isArray(t.items)){a=[];for(let n of t.items)a.push(...await S({...e,entry:n}))}let o=J(t.group)??J(t.label)??(i===void 0?J(t.href):void 0)??n.anchor,s=E(t);return[{type:w(t,i,n.linksConnectedHeading===!0),...X(t,e),menuStyle:s?Z(t):void 0,external:t.external===!0||void 0,languageInsensitive:n.languageInsensitive?!0:void 0,items:a&&a.length>0?a:void 0,label:o,labelTranslationKey:T(t),link:n.link,isGroup:s?!0:void 0,version:J(t.version)??i?.version??void 0,versionGroup:i?.versionGroup??void 0}]}function w(e,t,n){if(E(e)&&!n)return`group`;if(t!==void 0||e.href||e.label)return`link`}function T(e){return J(E(e)?e.groupTranslationKey:e.labelTranslationKey)}function E(e){return J(e.group)!==void 0}async function D(e){let{ref:t}=e,n=r(t,e.file.path);if(n===null)return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${t}" is outside the content root.`),[];if(e.readFile===void 0)return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${t}" is not supported here.`),[];if(e.visitedRefs.has(n))return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${n}" includes itself.`),[];let i;try{i=await e.readFile(n)}catch{return h(e,`sidebar/missing-target`,`Sidebar $ref "${n}" could not be read.`),[]}let a=p.load(i);return Array.isArray(a)?O(e,n,a):(h(e,`sidebar/invalid-entry`,`Sidebar $ref "${n}" must be a YAML sequence.`),[])}async function O(e,t,n){let r=/* @__PURE__ */ new Set([...e.visitedRefs,t]),i=[];for(let a of n)i.push(...await S({...e,entry:a,file:{path:t},visitedRefs:r}));return i}async function k(e,t){if(e.readFile===void 0)return[];let n=p.load(await e.readFile(t));return Array.isArray(n)?O({...e,assignedRouteSlugs:/* @__PURE__ */ new Set,report:void 0},t,n.map(A)):[]}function A(e){if(!t(e)||!m(e))return e;let{tab:n,menu:r,...i}=e;return{...i,group:n,items:i.items??r}}function j(e,t){return`${e}-${t.normalize(`NFKD`).replace(/[\u0300-\u036f]/g,``).toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-+|(?<!-)-+$/g,``)||`tab`}`}function M(e){return/* @__PURE__ */ Error(`Sidebar "${e.file.path}": tab "${e.label}" ${e.message}.`)}function N(e){let{file:t,entry:n}=e,r=n.tab,i=n.menu!==void 0;if(i&&n.items!==void 0)throw M({file:t,label:r,message:`cannot have both "menu" and "items"`});if(i&&n.page!==void 0)throw M({file:t,label:r,message:`has "menu" and cannot also have "page"`});if(!i&&n.page===void 0)throw M({file:t,label:r,message:`needs "page" or "menu"`});if(typeof n.page==`string`&&n.page.includes(`#`))throw M({file:t,label:r,message:`page must not contain a heading anchor`});if(i&&!Array.isArray(n.menu))throw M({file:t,label:r,message:`"menu" must be a list of entries`});if(i&&Array.isArray(n.menu)&&n.menu.length===0)throw M({file:t,label:r,message:`has an empty "menu"`});if(n.$ref!==void 0||n.directory!==void 0||n.group!==void 0||n.href!==void 0)throw M({file:t,label:r,message:`accepts only "page", "items", "menu" and "icon"; move "$ref"/"directory"/"group"/"href" into "items"`})}async function P(e){let{entry:t}=e,n=t.tab;N({file:e.file,entry:t});let r=j(e.tabIndex,n);if(t.menu!==void 0){let i=Array.isArray(t.menu)?t.menu:[],a=[];for(let[t,n]of i.entries()){let i=await F({...e,tabId:r,index:t,raw:n});i!==void 0&&a.push(i)}return{tab:!0,tabId:r,label:n,menu:a,...Q(t.icon,e),...I({...e,rbac:t.rbac})}}let[i]=await S({...e,entry:{page:t.page,label:n,items:t.items,rbac:t.rbac}}),a=i?.items??[];return{...i,tab:!0,tabId:r,...Q(t.icon,e),items:a}}async function F(e){let{file:t,entry:n,tabId:r,index:i,raw:a}=e,o=n.tab,s=K(a);if(s===void 0||typeof s.page!=`string`)throw Error(`Sidebar "${t.path}": menu entry ${i+1} of tab "${o}" needs "page".`);if(s.page.includes(`#`))throw Error(`Sidebar "${t.path}": menu entry ${i+1} of tab "${o}" page must not contain a heading anchor.`);let c=`${r}/${i}`,[l]=await S({...e,entry:s});return l?.link===void 0?void 0:{...l,tabId:c,items:l.items??[]}}function I(e){return a(e.rbac,()=>h(e,`sidebar/invalid-entry`,`Sidebar entry has an invalid "rbac" value, so it is hidden.`))}function L(e){let t=/* @__PURE__ */ new Map,n=(n,r)=>{for(let i of r){let r=t.get(i);if(r!==void 0&&r.tabId!==n.tabId)throw Error(`Sidebar "${e.file.path}": route "${i}" is claimed by two navigation tabs, "${r.label}" and "${n.label}". A route can belong to one tab only.`);t.set(i,n)}};for(let t of e.tabs){if(t.menu!==void 0){for(let r of t.menu)r.tabId!==void 0&&n({tabId:r.tabId,label:`${t.label} > ${r.label??r.link}`},R({routes:e.routes,link:r.link,items:r.items}));continue}t.tabId!==void 0&&n({tabId:t.tabId,label:t.label??t.link??``},R({routes:e.routes,link:t.link,items:t.items}))}}function R(e){let t=[],n=n=>{if(n.link===void 0||n.languageInsensitive===!0)return;let r=e.routes.bySlug(n.link);r!==void 0&&r.originFilePath!==null&&t.push(r.slug)};n({link:e.link});let r=e=>{if(e!==void 0)for(let t of e)n(t),r(t.items)};return r(e.items),t}async function z(t){let n=t.directoryPath===``?``:`${t.directoryPath}/`,r=[],i=/* @__PURE__ */ new Map,a=/* @__PURE__ */ new Set,o=t.directoryPath.startsWith(`${e}/`),s=t.pages.filter(e=>o||e.locale===``).map(e=>({route:e,relativePath:e.originFilePath?.startsWith(n)?e.originFilePath.slice(n.length):null})).sort((e,t)=>B(e.relativePath??e.route.slug,t.relativePath??t.route.slug));for(let e of s){let n=e.relativePath?.split(`/`).slice(0,-1)??[],r=c(n);if(r!==void 0){if(!a.has(r.path)){a.add(r.path);let e=await k(t,r.path);e.length>0&&u(l(n,r.depth)).push(...e)}continue}U(e.route,t),e.route.version&&t.versionedDirectories.add(t.directoryPath),u(l(n,n.length)).push({type:`link`,link:e.route.slug,version:e.route.version??void 0,versionGroup:e.route.versionGroup??void 0})}return r;function c(e){for(let n=0;n<=e.length;n++){let r=f.join(t.directoryPath,...e.slice(0,n)),i=t.sidebarByDirectory.get(r);if(i!==void 0&&!t.visitedRefs.has(i))return{depth:n,path:i}}}function l(e,n){return t.flatten?[]:e.slice(0,n).filter(e=>!e.startsWith(`@`))}function u(e){let t=r,n=``;for(let r of e){n=n===``?r:`${n}/${r}`;let e=i.get(n);if(e){t=e;continue}let a=[];t.push({type:`group`,items:a,label:r}),i.set(n,a),t=a}return t}}function B(e,t){return e.startsWith(`index.`)?-1:t.startsWith(`index.`)?1:e.localeCompare(t,void 0,{numeric:!0})}async function V(e,t){if(typeof e.page==`string`){let{path:r,suffix:i,anchor:a}=n(e.page.trim()),o=await H(r,t);if(!o)return{};let s=e.disconnect!==!0;return s&&U(o,t),{link:`${o.slug}${i}`,anchor:a,linksConnectedHeading:s&&a!==void 0,route:o}}if(typeof e.href==`string`){let n=e.href;if(n.startsWith(`/`)){let e=t.routes.bySlug(n);return e?{link:e.slug,route:e}:{link:n,languageInsensitive:!0}}return{link:n,languageInsensitive:!0}}return{}}async function H(e,t){let n=o(e,t.file.path,t.routes);if(n.kind===`escaped`){h(t,`sidebar/invalid-entry`,`Sidebar page "${e}" is outside the content root.`);return}if(n.kind===`missing`){let n=r(e,t.file.path);n!==null&&await t.exists?.(n)&&h(t,`sidebar/missing-target`,`Sidebar page "${e}" is a file that makes no page.`);return}return n.value}function U(e,t){t.assignedRouteSlugs.add(e.slug)}async function W(e){if(e.versionedDirectories.length===0)return;let t=await s({io:e.io,routes:e.routes,versionedDirectories:e.versionedDirectories}),n=e=>{for(let r of e){if(r.version!==void 0&&r.versionGroup!==void 0){let e=t.get(r.versionGroup),n=e?.labels.get(r.version);n&&(r.versionLabel=n),e?.defaultVersion===r.version&&(r.isDefaultVersion=!0)}r.items&&n(r.items),r.menu&&n(r.menu)}};n(e.nodes)}function G(e){let t=JSON.stringify(e)??String(e);return t.length>80?`${t.slice(0,79)}…`:t}function K(e){return typeof e==`string`?e.trim()===``?void 0:{page:e}:t(e)?e:void 0}function q(e){if(!Array.isArray(e))return;let n=[];for(let r of e){if(!t(r))continue;let e=J(r.name),i=J(r.icon);(e!==void 0||i!==void 0)&&n.push({name:e??``,color:J(r.color),icon:i,position:r.position===`before`||r.position===`after`?r.position:void 0})}return n.length>0?n:void 0}function J(e){return typeof e==`string`&&e.trim()!==``?e:void 0}function Y(e,t){return t.find(t=>t===e)}function X(e,t){return{badges:q(e.badges),...Q(e.icon,t),expanded:e.expanded===!0?`true`:Y(e.expanded,[`always`]),selectFirstItemOnExpand:e.selectFirstItemOnExpand===!0||void 0,separatorLine:e.separatorLine===!0||void 0,linePosition:Y(e.linePosition,[`top`,`bottom`]),target:J(e.target),sublabel:J(e.sublabel)}}function Z(e){return Y(e.menuStyle,[`drilldown`,`drilldown-header`])}function Q(e,n){let r=t(e)?J(e.srcSet):void 0;if(r!==void 0){let e=u(r);if(e===null)return{srcSet:r};for(let t of e)t.src=$(t.src,n);return{srcSet:l(e)}}let i=J(e);return i===void 0?{}:{icon:$(i,n)}}function $(e,t){if(!i(e))return e;let n=r(e,t.file.path);return n===null?(h(t,`sidebar/invalid-entry`,`Sidebar icon "${e}" is outside the content root.`),e):`/${n}`}export{b as bundleSidebar,x as bundleSidebarEntries,_ as collectSidebarLinkRefs,g as collectSidebarRefTargets,W as stampDefaultVersions};
@@ -1,2 +1,2 @@
1
- import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t,createInlineEntity as n}from"../../../loaders/define.js";import{createPluginScopedId as r}from"../../utils/scoped-id.js";import"../../../../shared/constants/l10n/defaults.js";import{NAV_ITEM_RBAC as i}from"../../../../server/rbac/types.js";import{compareStrings as a}from"../../../../shared/utils/compare-strings.js";import{isObject as o}from"../../../../shared/utils/is-object.js";import{toLocaleSlug as s}from"../../../../shared/utils/l10n.js";import{resolveContentPath as c}from"../../../../shared/utils/resolve-content-path.js";import{isLocalImagePath as l}from"../assets/extensions.js";import{splitUrlSuffix as u}from"../../../../shared/utils/routes/split-url-suffix.js";import{resolvePageTarget as d}from"../../../../shared/utils/routes/resolve-page-target.js";import{toPublicVersionedSlug as f}from"../../../../shared/constants/versions.js";import{collectVersionGroups as p,findVersionedDirectories as ee}from"../../../versions/version-groups.js";import{publicLink as m}from"../../../versions/public-link.js";import{linkedPageAccess as h}from"../../utils/link-access.js";import{safeDecodeURI as g}from"../../../../shared/utils/safe-decode-uri.js";import{joinSrcSet as _,parseSrcSet as v}from"../assets/srcset.js";import{bundleSidebar as y,bundleSidebarEntries as te,collectSidebarLinkRefs as b,collectSidebarRefTargets as ne,stampDefaultVersions as x}from"./bundle.js";import{SIDEBAR_CONTRIBUTIONS_ENTITY_TYPE as S,sidebarStartEntityKey as re}from"./contributions.js";import{applySubtree as C}from"./subtree.js";import{collectSlugOverrides as w}from"../../utils/slug-overrides.js";import{SIDEBAR_BACK_LINK_ROUTE_DEP_KEY as ie,SIDEBAR_BREADCRUMBS_ROUTE_DEP_KEY as T,SIDEBAR_ROUTE_DEP_KEY as E,localizedSidebarDepKey as D}from"../../../../shared/constants/route-deps.js";import{SITE_START_ENTITY_KEY as ae}from"../../../../shared/constants/site-start.js";import{posix as O}from"node:path";import{REDOCLY_TEAMS_RBAC as k}from"@redocly/config";const A=`internal.sidebar`,j=r(A,`aggregate`),M=/(^|\/)(?:[^/]*\.)?sidebars\.ya?ml$/i,N=/(^|\/)sidebars\.ya?ml$/i,P=`sidebars.yaml`,F=`redocly.yaml`;function I(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&Array.isArray(e.tabs)}function L(e){if(Array.isArray(e))return e.find(e=>R(e.label)!==void 0)?.label}function R(e){return typeof e==`string`&&e.trim()!==``?e:void 0}function z(e){let t=((e??``).split(/[?#]/)[0]?.split(`/`).filter(Boolean).pop()??``).replace(/[-_]+/g,` `).trim();return t.charAt(0).toUpperCase()+t.slice(1)}async function B(e,t){let n=[];for(let r of e){let e=r.link?t.subtreeKeyOf(r.link):void 0,a=e?await t.loadEntity(e):void 0,o=r.tabId!==void 0,s=o?{...r,isGroup:!0,label:r.label??L(a)}:r,c=a===void 0?[s]:C(s,a);for(let e of c){let a=e[`redocly::nav-item-rbac`]??r[`redocly::nav-item-rbac`],s=e[k]??(a===void 0&&e.link!==void 0?t.accessOf(e.link)??void 0:void 0);n.push({type:e.type,expanded:e.expanded,selectFirstItemOnExpand:e.selectFirstItemOnExpand,external:e.external,target:e.target,languageInsensitive:e.languageInsensitive,icon:e.icon===void 0?void 0:await t.resolveAsset(e.icon),srcSet:e.srcSet===void 0?void 0:await V(e.srcSet,t),items:e.items?await B(e.items,t):void 0,tab:e.tab,tabId:e.tabId,menu:e.menu?await B(e.menu,t):void 0,label:o?e.label??z(e.link):e.label,labelTranslationKey:e.labelTranslationKey,link:e.link!==void 0&&e.versionGroup!==void 0&&e.version!==void 0?f(e.link,e.versionGroup,e.version,e.isDefaultVersion===!0):e.link,separatorLine:e.separatorLine,linePosition:e.linePosition,variant:e.variant,menuStyle:e.menuStyle,sublabel:e.sublabel,version:e.version,versionGroup:e.versionGroup,isDefaultVersion:e.isDefaultVersion,versionLabel:e.versionLabel,httpVerb:e.httpVerb,deprecated:e.deprecated,badges:e.badges,[k]:s,[i]:a})}}return n}async function V(e,t){let n=v(e);if(n===null)return e;let r=await Promise.all(n.map(async e=>Object.assign(e,{src:await t.resolveAsset(e.src)})));return _(r)}function H(e){let t=/* @__PURE__ */ new Map,n=/* @__PURE__ */ new Map;return{async resolve(r){if(!l(r))return r;let i=await e.resolveImageReference(r,``),a=c(g(r),``);a!==null&&t.set(`file:${a}`,{kind:`file`,path:a});for(let e of i.entityDeps)t.set(e.kind===`file`?`file:${e.path}`:`entity:${e.key}`,e);for(let e of i.assetUsages)n.set(e.path,e);return i.result.kind===`assetRef`?i.result.url:r},collected(){return{entityDeps:[...t.values()],assetUsages:[...n.values()]}}}}function U(e){return e.tabId!==void 0}function W(e){return U(e)&&e.link!==void 0}function G(e){return{tabId:e.tabId,version:e.version,versionGroup:e.versionGroup,isDefaultVersion:e.isDefaultVersion,versionLabel:e.versionLabel,[k]:e[k],[i]:e[i]}}function K(e){return{...G(e),label:e.label,labelTranslationKey:e.labelTranslationKey,link:e.link,icon:e.icon,items:e.items??[]}}function q(e){return{...G(e),label:e.label,labelTranslationKey:e.labelTranslationKey,link:e.menu?void 0:e.link,icon:e.icon,items:e.menu?void 0:e.items??[],menu:e.menu?.filter(W).map(K)}}const J=t(j,async e=>{let t=H(e.markdown),{locale:n,slugOverrides:r={},versionedDirectories:i=[]}=e.args,a=t=>e.routes.bySlug(t)?.sidebarSubtreeEntityKey,o=i.length===0?/* @__PURE__ */ new Map:await p({io:e.io,routes:e.routes,versionedDirectories:i}),c=await B(e.args.nodes,{loadEntity:t=>e.entities.load(t),subtreeKeyOf:e=>(n===void 0?void 0:a(r[e]??s(e,n)))??a(e),accessOf:t=>h(t,e.routes,o),resolveAsset:t.resolve});return{value:e.args.nodes.some(e=>e.tab)?{tabs:c.filter(U).map(q)}:c,...t.collected()}});async function oe(e){let t=await e.loadEntity(e.subtreeKey);return B(C({link:e.routeSlug,...e.version},t),{loadEntity:e.loadEntity,subtreeKeyOf:()=>void 0,accessOf:()=>void 0,resolveAsset:async e=>e})}function se(e){let t=typeof e==`string`?e:o(e)?e.path:void 0;return typeof t==`string`&&t.trim()!==``?t.trim():null}function Y(e){return[e.originPluginId,e.originFilePath,e.routeId].join(`\0`)}async function X(e,t){let n=/* @__PURE__ */ new Map;for(let r of e.assignedRouteSlugs){let e=t.routes.bySlug(r),i=e?.originFilePath===null?e.sidebarSubtreeEntityKey:null;if(!i||await t.entities.get(i)===null)continue;let a=e=>{for(let i of e){let e=i.link===void 0?void 0:t.routes.bySlug(i.link);e!==void 0&&!n.has(e.slug)&&n.set(e.slug,r),i.items&&a(i.items)}};a(C({link:r},await t.entities.load(i)))}return n}function ce(e,t){for(let n of t)for(let[t,r]of n){let n=e.get(r);n!==void 0&&!e.has(t)&&e.set(t,n)}}async function le(e){let t=[];for(let n of await e.list({type:S}))t.push(...await e.load(n.key));return t}function ue(e,t=[]){let n=[];for(let[r,i]of e.entries()){if(t[r]?.link!==i.link)break;n.push(i)}return n}async function de(e,t,n,r,i){let a=await Promise.all(e.map(async e=>{let r=fe(e,t,n);return r===null?null:{item:e,link:r.link,label:await Z(e,r,i)}})),o=/* @__PURE__ */ new Map;for(let{item:e,link:t,label:n}of a.filter(e=>e!==null))for(let i of e.linkedSidebars??[]){let e=c(i,F),a=e===null?void 0:r.get(e);a!==void 0&&!o.has(a)&&o.set(a,{label:n,link:t})}return o}function fe(e,t,n){if(typeof e.href==`string`&&e.href.trim()!==``)return{link:e.href.trim()};if(typeof e.page!=`string`||e.page.trim()===``)return null;let{path:r,suffix:i,anchor:a}=u(e.page.trim()),o=d(r,F,t);if(o.kind!==`found`)return null;let s=o.value;return{link:`${m(s,n)}${i}`,anchor:a,route:s}}async function Z(e,t,n){let r=R(e.label)??R(e.group)??t.anchor;if(r!==void 0)return r;let i=t.route?.sidebarSubtreeEntityKey,a=i?await n(i):void 0;return(o(a)?R(a.label):void 0)??t.link}function Q(e,t){for(let n of e){if(!t(n))continue;if(n.link!==void 0&&n.languageInsensitive!==!0)return n;let e=Q([...n.items??[],...n.menu??[]],t);if(e!==null)return e}return null}function pe(e,t){return Q(e,e=>e.version===void 0||e.version===t)?.link??null}function $(e){let t=Q(e,e=>e.version===void 0||e.isDefaultVersion===!0);return t?.link===void 0?null:t.versionGroup!==void 0&&t.version!==void 0?f(t.link,t.versionGroup,t.version,!0):t.link}function me(e){let[t]=e;if(t===void 0)return null;let n=t.path.split(`/`).length;return(e.find(({path:e})=>e.split(`/`).length===n&&N.test(e))??t).link}function he(e){let t=null;for(let{slug:n,originFilePath:r,locale:i,versionGroup:o}of e)r!==null&&i===``&&o===null&&(t===null||n.length<t.length||n.length===t.length&&a(n,t)<0)&&(t=n);return t}const ge=e({id:A,version:`1.23.1`,content:{filter:{match:e=>M.test(e)},async extractFile(e,t){let n=await t.io.readFile(e.path);return{routes:[],linkRefs:await b({source:n,filePath:e.path,readFile:t.io.readFile})}}},async finalize(e){let t=[],r=[],i=/* @__PURE__ */ new Map,a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ new Map,s=[],c=/* @__PURE__ */ new Map,l=/* @__PURE__ */ new Map,d=[],f=await Promise.all(e.files.map(async t=>({path:t.path,source:await e.io.readFile(t.path)}))),m=e.routes.all(),g=w(m,e.localeContext),_=ee(m),v=_.length>0?_:void 0;f.sort((e,t)=>e.path.split(`/`).length-t.path.split(`/`).length);let b=new Map(f.map(({path:e,source:t})=>[e,t])),S=/* @__PURE__ */ new Map;for(let{path:e}of f)N.test(e)&&S.set(O.dirname(e),e);let C=/* @__PURE__ */ new Set;for(let{path:e,source:t}of f)for(let n of ne(t,e))C.add(n);let A={routes:e.routes,report:e=>r.push(e),readFile:async t=>b.get(t)??e.io.readFile(t),exists:t=>e.io.exists(t),sidebarByDirectory:S},j=async(n,r)=>{if(n.nodes.length===0)return;await x({io:e.io,routes:e.routes,logger:e.logger,nodes:n.nodes,versionedDirectories:_});let i=J.withArgs({nodes:n.nodes,versionedDirectories:v},r===void 0?void 0:{metadata:{sourcePath:r}});t.push(i),l.set(i,n.nodes);let a=/* @__PURE__ */ new Map;for(let r of e.localeContext.locales){let e=J.withArgs({nodes:n.nodes,locale:r,slugOverrides:g[r]??{},versionedDirectories:v});t.push(e),a.set(r,e)}return c.set(i,a),i};for(let{path:t,source:n}of f){if(C.has(t))continue;let c=await y({...A,file:{path:t},source:n}),l=await j(c,t);if(l===void 0)continue;a.set(t,l);let u=t.startsWith(`@l10n/`)?null:$(c.nodes);u!==null&&d.push({path:t,link:u}),s.push(await X(c,e));for(let e of c.assignedRouteSlugs){let n=o.get(e);n!==void 0&&r.push({code:`sidebar/route-conflict`,message:`Page "${e}" is in sidebars ${n} and ${t}; it shows ${t}.`,location:{filePath:t}}),i.set(e,l),o.set(e,t)}}ce(i,s);let M=new Map(m.map(e=>[e.slug,e]));for(let[t,n]of Object.entries(e.routes.metadata(`sidebar`))){let e=M.get(t);if(e===void 0||e.originFilePath===null)continue;let o=se(n);if(o===null)continue;let s=O.normalize(o.startsWith(`/`)?o.slice(1):O.join(O.dirname(e.originFilePath),o)),c=a.get(s);if(c===void 0){r.push({code:`sidebar/missing-target`,message:`Front matter sidebar "${o}" is not a sidebar file of this project.`,location:{filePath:e.originFilePath}});continue}i.set(e.slug,c)}let F=await le(e.entities),I=/* @__PURE__ */ new Set,L=/* @__PURE__ */ new Map,R=/* @__PURE__ */ new Map;for(let t of F){let n=i.get(t.route);if(n===void 0){let r=await te({...A,file:{path:P},entries:t.entries});if(n=await j(r),n===void 0)continue;let a=(await X(r,e)).keys();for(let e of[...r.assignedRouteSlugs,...a])i.has(e)||(i.set(e,n),I.add(e))}let r=L.get(n);L.set(n,r===void 0?t.backLink??null:r!==null&&r.link===t.backLink?.link?r:null);let a=R.get(n);R.set(n,a===void 0?t.breadcrumbs??[]:ue(a,t.breadcrumbs))}if(f.length===0&&m.length>0){let e=await y({...A,file:{path:P},source:`- directory: .
2
- `,skipRoutes:I}),t=await j(e);if(t!==void 0){for(let n of e.assignedRouteSlugs)i.has(n)||i.set(n,t);let n=$(e.nodes);n!==null&&d.push({path:P,link:n})}}let z=me(d)??he(m);if(z!==null){let{path:e}=u(z);t.push(n(e,{stableKey:ae}))}let B=/* @__PURE__ */ new Map;for(let e of m){if(e.originFilePath===null)continue;let t=Y(e);B.set(t,[...B.get(t)??[],e.slug])}for(let[e,t]of[...i]){let n=M.get(e);for(let e of(n&&B.get(Y(n)))??[])i.has(e)||i.set(e,t)}let V=/* @__PURE__ */ new Map,H=(e.config.navbar?.items??[]).filter(e=>e.linkedSidebars?.length),U=/* @__PURE__ */ new Map,W=R.size===0&&H.length===0||v===void 0?/* @__PURE__ */ new Map:await p({io:e.io,routes:e.routes,versionedDirectories:v});for(let[t,n]of await de(H,e.routes,W,a,t=>e.entities.load(t)))R.set(t,[n,...R.get(t)??[]]);let G=({label:t,link:n,icon:r})=>({label:t,link:n,icon:r,[k]:h(n,e.routes,W)??void 0});for(let[e,r]of L){if(r===null)continue;let i=n(G(r));t.push(i),V.set(e,i)}for(let[e,r]of R){if(r.length===0)continue;let i=n(r.map(G));t.push(i),U.set(e,i)}for(let r of new Set(F.map(e=>e.route))){let a=i.get(r),o=a===void 0?void 0:l.get(a),s=o===void 0?null:pe(o,e.routes.bySlug(r)?.version??null);s!==null&&t.push(n(s,{stableKey:re(r)}))}return{entities:t,attach:[...i.entries()].map(([e,t])=>{let n={[E]:t},r=V.get(t);r!==void 0&&(n[ie]=r);let i=U.get(t);if(i!==void 0&&(n[T]=i),M.get(e)?.locale===``)for(let[e,r]of c.get(t)??[])n[D(e)]=r;return{slug:e,deps:n}}),problems:r}},loaders:[J]});export{N as FOLDER_SIDEBAR_FILENAME_REGEX,j as SIDEBAR_AGGREGATOR_LOADER_ID,M as SIDEBAR_FILENAME_REGEX,A as SIDEBAR_PLUGIN_ID,E as SIDEBAR_ROUTE_DEP_KEY,I as isTabbedSidebar,oe as resolveAutoSidebar,ge as sidebarContentPlugin};
1
+ import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t,createInlineEntity as n}from"../../../loaders/define.js";import{createPluginScopedId as r}from"../../utils/scoped-id.js";import"../../../../shared/constants/l10n/defaults.js";import{compareStrings as i}from"../../../../shared/utils/compare-strings.js";import{isObject as a}from"../../../../shared/utils/is-object.js";import{toLocaleSlug as o}from"../../../../shared/utils/l10n.js";import{SIDEBAR_BACK_LINK_ROUTE_DEP_KEY as s,SIDEBAR_BREADCRUMBS_ROUTE_DEP_KEY as c,SIDEBAR_ROUTE_DEP_KEY as l,localizedSidebarDepKey as ee}from"../../../../shared/constants/route-deps.js";import{toPublicVersionedSlug as u}from"../../../../shared/constants/versions.js";import{splitUrlSuffix as d}from"../../../../shared/utils/routes/split-url-suffix.js";import{NAV_ITEM_RBAC as f}from"../../../../server/rbac/types.js";import{resolveContentPath as p}from"../../../../shared/utils/resolve-content-path.js";import{isLocalImagePath as m}from"../assets/extensions.js";import{resolvePageTarget as h}from"../../../../shared/utils/routes/resolve-page-target.js";import{collectVersionGroups as g,findVersionedDirectories as _}from"../../../versions/version-groups.js";import{publicLink as v}from"../../../versions/public-link.js";import{linkedPageAccess as y}from"../../utils/link-access.js";import{safeDecodeURI as b}from"../../../../shared/utils/safe-decode-uri.js";import{joinSrcSet as x,parseSrcSet as S}from"../assets/srcset.js";import{bundleSidebar as C,bundleSidebarEntries as te,collectSidebarLinkRefs as w,collectSidebarRefTargets as ne,stampDefaultVersions as re}from"./bundle.js";import{SIDEBAR_CONTRIBUTIONS_ENTITY_TYPE as T,sidebarStartEntityKey as E}from"./contributions.js";import{applySubtree as D}from"./subtree.js";import{collectSlugOverrides as O}from"../../utils/slug-overrides.js";import{SITE_START_ENTITY_KEY as ie}from"../../../../shared/constants/site-start.js";import{posix as k}from"node:path";import{REDOCLY_TEAMS_RBAC as A}from"@redocly/config";const j=`internal.sidebar`,M=r(j,`aggregate`),N=/(^|\/)(?:[^/]*\.)?sidebars\.ya?ml$/i,P=/(^|\/)sidebars\.ya?ml$/i,F=`sidebars.yaml`,I=`redocly.yaml`;function L(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&Array.isArray(e.tabs)}function R(e){if(Array.isArray(e))return e.find(e=>z(e.label)!==void 0)?.label}function z(e){return typeof e==`string`&&e.trim()!==``?e:void 0}function B(e){let t=((e??``).split(/[?#]/)[0]?.split(`/`).filter(Boolean).pop()??``).replace(/[-_]+/g,` `).trim();return t.charAt(0).toUpperCase()+t.slice(1)}async function V(e,t){let n=[];for(let r of e){let e=r.link?t.subtreeKeyOf(r.link):void 0,i=e?await t.loadEntity(e):void 0,a=r.tabId!==void 0,o=a?{...r,isGroup:!0,label:r.label??R(i)}:r,s=i===void 0?[o]:D(o,i);for(let e of s){let i=e[`redocly::nav-item-rbac`]??r[`redocly::nav-item-rbac`],o=e[A]??(i===void 0&&e.link!==void 0?t.accessOf(e.link)??void 0:void 0);n.push({type:e.type,expanded:e.expanded,selectFirstItemOnExpand:e.selectFirstItemOnExpand,external:e.external,target:e.target,languageInsensitive:e.languageInsensitive,icon:e.icon===void 0?void 0:await t.resolveAsset(e.icon),srcSet:e.srcSet===void 0?void 0:await H(e.srcSet,t),items:e.items?await V(e.items,t):void 0,tab:e.tab,tabId:e.tabId,menu:e.menu?await V(e.menu,t):void 0,label:a?e.label??B(e.link):e.label,labelTranslationKey:e.labelTranslationKey,link:e.link!==void 0&&e.versionGroup!==void 0&&e.version!==void 0?u(e.link,e.versionGroup,e.version,e.isDefaultVersion===!0):e.link,separatorLine:e.separatorLine,linePosition:e.linePosition,variant:e.variant,menuStyle:e.menuStyle,sublabel:e.sublabel,version:e.version,versionGroup:e.versionGroup,isDefaultVersion:e.isDefaultVersion,versionLabel:e.versionLabel,httpVerb:e.httpVerb,deprecated:e.deprecated,badges:e.badges,[A]:o,[f]:i})}}return n}async function H(e,t){let n=S(e);if(n===null)return e;let r=await Promise.all(n.map(async e=>Object.assign(e,{src:await t.resolveAsset(e.src)})));return x(r)}function U(e){let t=/* @__PURE__ */ new Map,n=/* @__PURE__ */ new Map;return{async resolve(r){if(!m(r))return r;let i=await e.resolveImageReference(r,``),a=p(b(r),``);a!==null&&t.set(`file:${a}`,{kind:`file`,path:a});for(let e of i.entityDeps)t.set(e.kind===`file`?`file:${e.path}`:`entity:${e.key}`,e);for(let e of i.assetUsages)n.set(e.path,e);return i.result.kind===`assetRef`?i.result.url:r},collected(){return{entityDeps:[...t.values()],assetUsages:[...n.values()]}}}}function W(e){return e.tabId!==void 0}function G(e){return W(e)&&e.link!==void 0}function K(e){return{tabId:e.tabId,version:e.version,versionGroup:e.versionGroup,isDefaultVersion:e.isDefaultVersion,versionLabel:e.versionLabel,[A]:e[A],[f]:e[f]}}function q(e){return{...K(e),label:e.label,labelTranslationKey:e.labelTranslationKey,link:e.link,icon:e.icon,items:e.items??[]}}function J(e){return{...K(e),label:e.label,labelTranslationKey:e.labelTranslationKey,link:e.menu?void 0:e.link,icon:e.icon,items:e.menu?void 0:e.items??[],menu:e.menu?.filter(G).map(q)}}const Y=t(M,async e=>{let t=U(e.markdown),{locale:n,slugOverrides:r={},versionedDirectories:i=[]}=e.args,a=t=>e.routes.bySlug(t)?.sidebarSubtreeEntityKey,s=i.length===0?/* @__PURE__ */ new Map:await g({io:e.io,routes:e.routes,versionedDirectories:i}),c=await V(e.args.nodes,{loadEntity:t=>e.entities.load(t),subtreeKeyOf:e=>(n===void 0?void 0:a(r[e]??o(e,n)))??a(e),accessOf:t=>y(t,e.routes,s),resolveAsset:t.resolve});return{value:e.args.nodes.some(e=>e.tab)?{tabs:c.filter(W).map(J)}:c,...t.collected()}});async function ae(e){let t=await e.loadEntity(e.subtreeKey);return V(D({link:e.routeSlug,...e.version},t),{loadEntity:e.loadEntity,subtreeKeyOf:()=>void 0,accessOf:()=>void 0,resolveAsset:async e=>e})}function oe(e){let t=typeof e==`string`?e:a(e)?e.path:void 0;return typeof t==`string`&&t.trim()!==``?t.trim():null}function X(e){return[e.originPluginId,e.originFilePath,e.routeId].join(`\0`)}async function Z(e,t){let n=/* @__PURE__ */ new Map;for(let r of e.assignedRouteSlugs){let e=t.routes.bySlug(r),i=e?.originFilePath===null?e.sidebarSubtreeEntityKey:null;if(!i||await t.entities.get(i)===null)continue;let a=e=>{for(let i of e){let e=i.link===void 0?void 0:t.routes.bySlug(i.link);e!==void 0&&!n.has(e.slug)&&n.set(e.slug,r),i.items&&a(i.items)}};a(D({link:r},await t.entities.load(i)))}return n}function se(e,t){for(let n of t)for(let[t,r]of n){let n=e.get(r);n!==void 0&&!e.has(t)&&e.set(t,n)}}async function ce(e){let t=[];for(let n of await e.list({type:T}))t.push(...await e.load(n.key));return t}function le(e,t=[]){let n=[];for(let[r,i]of e.entries()){if(t[r]?.link!==i.link)break;n.push(i)}return n}async function ue(e,t,n,r,i){let a=await Promise.all(e.map(async e=>{let r=de(e,t,n);return r===null?null:{item:e,link:r.link,label:await fe(e,r,i)}})),o=/* @__PURE__ */ new Map;for(let{item:e,link:t,label:n}of a.filter(e=>e!==null))for(let i of e.linkedSidebars??[]){let e=p(i,I),a=e===null?void 0:r.get(e);a!==void 0&&!o.has(a)&&o.set(a,{label:n,link:t})}return o}function de(e,t,n){if(typeof e.href==`string`&&e.href.trim()!==``)return{link:e.href.trim()};if(typeof e.page!=`string`||e.page.trim()===``)return null;let{path:r,suffix:i,anchor:a}=d(e.page.trim()),o=h(r,I,t);if(o.kind!==`found`)return null;let s=o.value;return{link:`${v(s,n)}${i}`,anchor:a,route:s}}async function fe(e,t,n){let r=z(e.label)??z(e.group)??t.anchor;if(r!==void 0)return r;let i=t.route?.sidebarSubtreeEntityKey,o=i?await n(i):void 0;return(a(o)?z(o.label):void 0)??t.link}function Q(e,t){for(let n of e){if(!t(n))continue;if(n.link!==void 0&&n.languageInsensitive!==!0)return n;let e=Q([...n.items??[],...n.menu??[]],t);if(e!==null)return e}return null}function pe(e,t){return Q(e,e=>e.version===void 0||e.version===t)?.link??null}function $(e){let t=Q(e,e=>e.version===void 0||e.isDefaultVersion===!0);return t?.link===void 0?null:t.versionGroup!==void 0&&t.version!==void 0?u(t.link,t.versionGroup,t.version,!0):t.link}function me(e){let[t]=e;if(t===void 0)return null;let n=t.path.split(`/`).length;return(e.find(({path:e})=>e.split(`/`).length===n&&P.test(e))??t).link}function he(e){let t=null;for(let{slug:n,originFilePath:r,locale:a,versionGroup:o}of e)r!==null&&a===``&&o===null&&(t===null||n.length<t.length||n.length===t.length&&i(n,t)<0)&&(t=n);return t}const ge=e({id:j,version:`1.24.0`,content:{filter:{match:e=>N.test(e)},async extractFile(e,t){let n=await t.io.readFile(e.path);return{routes:[],linkRefs:await w({source:n,filePath:e.path,readFile:t.io.readFile})}}},async finalize(e){let t=[],r=[],i=/* @__PURE__ */ new Map,a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ new Map,u=[],f=/* @__PURE__ */ new Map,p=/* @__PURE__ */ new Map,m=[],h=await Promise.all(e.files.map(async t=>({path:t.path,source:await e.io.readFile(t.path)}))),v=e.routes.all(),b=O(v,e.localeContext),x=_(v),S=x.length>0?x:void 0;h.sort((e,t)=>e.path.split(`/`).length-t.path.split(`/`).length);let w=new Map(h.map(({path:e,source:t})=>[e,t])),T=/* @__PURE__ */ new Map;for(let{path:e}of h)P.test(e)&&T.set(k.dirname(e),e);let D=/* @__PURE__ */ new Set;for(let{path:e,source:t}of h)for(let n of ne(t,e))D.add(n);let j={routes:e.routes,report:e=>r.push(e),readFile:async t=>w.get(t)??e.io.readFile(t),exists:t=>e.io.exists(t),sidebarByDirectory:T},M=async(n,r)=>{if(n.nodes.length===0)return;await re({io:e.io,routes:e.routes,logger:e.logger,nodes:n.nodes,versionedDirectories:x});let i=Y.withArgs({nodes:n.nodes,versionedDirectories:S},r===void 0?void 0:{metadata:{sourcePath:r}});t.push(i),p.set(i,n.nodes);let a=/* @__PURE__ */ new Map;for(let r of e.localeContext.locales){let e=Y.withArgs({nodes:n.nodes,locale:r,slugOverrides:b[r]??{},versionedDirectories:S});t.push(e),a.set(r,e)}return f.set(i,a),i};for(let{path:t,source:n}of h){if(D.has(t))continue;let s=await C({...j,file:{path:t},source:n}),c=await M(s,t);if(c===void 0)continue;a.set(t,c);let l=t.startsWith(`@l10n/`)?null:$(s.nodes);l!==null&&m.push({path:t,link:l}),u.push(await Z(s,e));for(let e of s.assignedRouteSlugs){let n=o.get(e);n!==void 0&&r.push({code:`sidebar/route-conflict`,message:`Page "${e}" is in sidebars ${n} and ${t}; it shows ${t}.`,location:{filePath:t}}),i.set(e,c),o.set(e,t)}}se(i,u);let N=new Map(v.map(e=>[e.slug,e]));for(let[t,n]of Object.entries(e.routes.metadata(`sidebar`))){let e=N.get(t);if(e===void 0||e.originFilePath===null)continue;let o=oe(n);if(o===null)continue;let s=k.normalize(o.startsWith(`/`)?o.slice(1):k.join(k.dirname(e.originFilePath),o)),c=a.get(s);if(c===void 0){r.push({code:`sidebar/missing-target`,message:`Front matter sidebar "${o}" is not a sidebar file of this project.`,location:{filePath:e.originFilePath}});continue}i.set(e.slug,c)}let I=await ce(e.entities),L=/* @__PURE__ */ new Set,R=/* @__PURE__ */ new Map,z=/* @__PURE__ */ new Map;for(let t of I){let n=i.get(t.route);if(n===void 0){let r=await te({...j,file:{path:F},entries:t.entries});if(n=await M(r),n===void 0)continue;let a=(await Z(r,e)).keys();for(let e of[...r.assignedRouteSlugs,...a])i.has(e)||(i.set(e,n),L.add(e))}let r=R.get(n);R.set(n,r===void 0?t.backLink??null:r!==null&&r.link===t.backLink?.link?r:null);let a=z.get(n);z.set(n,a===void 0?t.breadcrumbs??[]:le(a,t.breadcrumbs))}if(h.length===0&&v.length>0){let e=await C({...j,file:{path:F},source:`- directory: .
2
+ `,skipRoutes:L}),t=await M(e);if(t!==void 0){for(let n of e.assignedRouteSlugs)i.has(n)||i.set(n,t);let n=$(e.nodes);n!==null&&m.push({path:F,link:n})}}let B=me(m)??he(v);if(B!==null){let{path:e}=d(B);t.push(n(e,{stableKey:ie}))}let V=/* @__PURE__ */ new Map;for(let e of v){if(e.originFilePath===null)continue;let t=X(e);V.set(t,[...V.get(t)??[],e.slug])}for(let[e,t]of[...i]){let n=N.get(e);for(let e of(n&&V.get(X(n)))??[])i.has(e)||i.set(e,t)}let H=/* @__PURE__ */ new Map,U=(e.config.navbar?.items??[]).filter(e=>e.linkedSidebars?.length),W=/* @__PURE__ */ new Map,G=z.size===0&&U.length===0||S===void 0?/* @__PURE__ */ new Map:await g({io:e.io,routes:e.routes,versionedDirectories:S});for(let[t,n]of await ue(U,e.routes,G,a,t=>e.entities.load(t)))z.set(t,[n,...z.get(t)??[]]);let K=({label:t,link:n,icon:r})=>({label:t,link:n,icon:r,[A]:y(n,e.routes,G)??void 0});for(let[e,r]of R){if(r===null)continue;let i=n(K(r));t.push(i),H.set(e,i)}for(let[e,r]of z){if(r.length===0)continue;let i=n(r.map(K));t.push(i),W.set(e,i)}for(let r of new Set(I.map(e=>e.route))){let a=i.get(r),o=a===void 0?void 0:p.get(a),s=o===void 0?null:pe(o,e.routes.bySlug(r)?.version??null);s!==null&&t.push(n(s,{stableKey:E(r)}))}return{entities:t,attach:[...i.entries()].map(([e,t])=>{let n={[l]:t},r=H.get(t);r!==void 0&&(n[s]=r);let i=W.get(t);if(i!==void 0&&(n[c]=i),N.get(e)?.locale===``)for(let[e,r]of f.get(t)??[])n[ee(e)]=r;return{slug:e,deps:n}}),problems:r}},loaders:[Y]});export{P as FOLDER_SIDEBAR_FILENAME_REGEX,M as SIDEBAR_AGGREGATOR_LOADER_ID,N as SIDEBAR_FILENAME_REGEX,j as SIDEBAR_PLUGIN_ID,l as SIDEBAR_ROUTE_DEP_KEY,L as isTabbedSidebar,ae as resolveAutoSidebar,ge as sidebarContentPlugin};
@@ -1 +1 @@
1
- import{defineContentPlugin as e}from"../../define.js";import{createInlineEntity as t}from"../../../loaders/define.js";import{slugifySegment as n}from"../../../../shared/utils/routes/slugify-segment.js";import{compileContentGlob as r}from"../../utils/glob.js";import{isPlanFeatureGranted as i}from"../../../../shared/plan-gates.js";import{AGENT_SKILLS_BASE as a,SKILLS_FOLDER as o,SKILLS_INDEX_SLUG as s,SKILL_FILENAME as c}from"../../utils/skill-paths.js";import{SKILL_ENTITY_TYPE as l,skillEntityKey as u}from"../../types/skill-entity.js";import{parseSkill as d}from"./parse-skill.js";const f=`internal.skills`,p=`${a}/:slug/${c}`,m=c.toLowerCase();function h(e){let t=e.split(`/`);return t.length===3&&t[0]===`@skills`&&t[2].toLowerCase()===m}function g(e,t){let r=/* @__PURE__ */ new Map;for(let t of e){if(!h(t.path))continue;let[,e,n]=t.path.split(`/`),i=r.get(e);i?i.push(n):r.set(e,[n])}let i=[],a=/* @__PURE__ */ new Map;for(let[e,s]of r){let r=s.includes(`SKILL.md`)?c:s[0];s.length>1&&t.warn(`Multiple skill files in "${o}/${e}" differ only by case; using "${r}".`);let l=n(e),u=a.get(l);if(u!==void 0){t.warn(`Skipping skill folder "${o}/${e}": its slug "${l}" collides with the folder "${u}" after slugification.`);continue}a.set(l,e),i.push({slug:l,sourcePath:`${o}/${e}/${r}`})}return i}const _=e({id:f,version:`1.3.0`,server:{routes:[{method:`GET`,path:s,handler:{filePath:`./server/routes.ts`,importer:import.meta.url,exportName:`skillsIndex`}},{method:`GET`,path:p,handler:{filePath:`./server/routes.ts`,importer:import.meta.url,exportName:`skillMarkdown`}}]},content:{filter:{match:e=>e===`SKILL.md`||h(e)},async extractAll(e){let n=[...e.config.mcp?.ignore??[],...e.config.skills?.excludeFiles??[]],a=n.length>0?r(n):()=>!1,o=process.env.PROJECT_SLUG||`project-docs`,s=g(e.files,e.logger);e.files.some(e=>e.path===`SKILL.md`)&&s.push({slug:o,sourcePath:c});let f=/* @__PURE__ */ new Map,p=/* @__PURE__ */ new Map,m=i(e.config,`rbac`);for(let n of s){if(a(n.sourcePath))continue;let r=await e.io.readFile(n.sourcePath),i=d(n.sourcePath,r);if(`error`in i){e.logger.warn(i.error);continue}let o=p.get(n.slug);o!==void 0&&e.logger.warn(`Skill "${n.slug}" from "${o}" is replaced by "${n.sourcePath}".`);let s={slug:n.slug,title:i.title,description:i.description,sourcePath:n.sourcePath};`rbac`in i&&m&&(s.rbac=i.rbac);let c={content:r};p.set(n.slug,n.sourcePath),f.set(n.slug,t(c,{stableKey:u(n.slug),type:l,metadata:s}))}return{routes:[],entities:[...f.values()]}}}});export{f as SKILLS_PLUGIN_ID,p as SKILL_MARKDOWN_ROUTE_PATH,_ as skillsContentPlugin};
1
+ import{defineContentPlugin as e}from"../../define.js";import{createInlineEntity as t}from"../../../loaders/define.js";import{slugifySegment as n}from"../../../../shared/utils/routes/slugify-segment.js";import{AGENT_SKILLS_BASE as r,SKILLS_FOLDER as i,SKILLS_INDEX_SLUG as a,SKILL_FILENAME as o}from"../../utils/skill-paths.js";import{compileContentGlob as s}from"../../utils/glob.js";import{isPlanFeatureGranted as c}from"../../../../shared/plan-gates.js";import{SKILL_ENTITY_TYPE as l,skillEntityKey as u}from"../../types/skill-entity.js";import{parseSkill as d}from"./parse-skill.js";const f=`internal.skills`,p=`${r}/:slug/${o}`,m=o.toLowerCase();function h(e){let t=e.split(`/`);return t.length===3&&t[0]===`@skills`&&t[2].toLowerCase()===m}function g(e,t){let r=/* @__PURE__ */ new Map;for(let t of e){if(!h(t.path))continue;let[,e,n]=t.path.split(`/`),i=r.get(e);i?i.push(n):r.set(e,[n])}let a=[],s=/* @__PURE__ */ new Map;for(let[e,c]of r){let r=c.includes(`SKILL.md`)?o:c[0];c.length>1&&t.warn(`Multiple skill files in "${i}/${e}" differ only by case; using "${r}".`);let l=n(e),u=s.get(l);if(u!==void 0){t.warn(`Skipping skill folder "${i}/${e}": its slug "${l}" collides with the folder "${u}" after slugification.`);continue}s.set(l,e),a.push({slug:l,sourcePath:`${i}/${e}/${r}`})}return a}const _=e({id:f,version:`1.3.0`,server:{routes:[{method:`GET`,path:a,handler:{filePath:`./server/routes.ts`,importer:import.meta.url,exportName:`skillsIndex`}},{method:`GET`,path:p,handler:{filePath:`./server/routes.ts`,importer:import.meta.url,exportName:`skillMarkdown`}}]},content:{filter:{match:e=>e===`SKILL.md`||h(e)},async extractAll(e){let n=[...e.config.mcp?.ignore??[],...e.config.skills?.excludeFiles??[]],r=n.length>0?s(n):()=>!1,i=process.env.PROJECT_SLUG||`project-docs`,a=g(e.files,e.logger);e.files.some(e=>e.path===`SKILL.md`)&&a.push({slug:i,sourcePath:o});let f=/* @__PURE__ */ new Map,p=/* @__PURE__ */ new Map,m=c(e.config,`rbac`);for(let n of a){if(r(n.sourcePath))continue;let i=await e.io.readFile(n.sourcePath),a=d(n.sourcePath,i);if(`error`in a){e.logger.warn(a.error);continue}let o=p.get(n.slug);o!==void 0&&e.logger.warn(`Skill "${n.slug}" from "${o}" is replaced by "${n.sourcePath}".`);let s={slug:n.slug,title:a.title,description:a.description,sourcePath:n.sourcePath};`rbac`in a&&m&&(s.rbac=a.rbac);let c={content:i};p.set(n.slug,n.sourcePath),f.set(n.slug,t(c,{stableKey:u(n.slug),type:l,metadata:s}))}return{routes:[],entities:[...f.values()]}}}});export{f as SKILLS_PLUGIN_ID,p as SKILL_MARKDOWN_ROUTE_PATH,_ as skillsContentPlugin};
@@ -1 +1 @@
1
- import{hashString as e}from"../../../../database/utils/json.js";import{withPathPrefix as t}from"../../../../../shared/path-prefix.js";import{SKILLS_INDEX_SCHEMA_URL as n,skillMarkdownPath as r}from"../../../utils/skill-paths.js";import{SKILL_ENTITY_TYPE as i,skillEntityKey as a}from"../../../types/skill-entity.js";import{publicOrigin as o}from"../../../utils/request-origin.js";import{isEntityScopeVisible as s}from"../../../../../server/rbac/entity-scope.js";import{notFoundResponse as c}from"../../../../../server/plugin-context.js";const l={"Cache-Control":`no-store`,"Access-Control-Allow-Origin":`*`};function u(e){return e.config.skills?.hide===!0}async function d(a,d){if(u(d))return c();let f=o(d.request),p=await d.entities.list({type:i}),m=await Promise.all(p.map(async n=>{let{slug:i,title:a,description:o}=n.metadata??{};if(typeof i!=`string`||!s(n,d.request.teams,e=>d.logger?.warn(e)))return[];let{content:c}=await d.entities.load(n.key);return[{name:a??i,type:`skill-md`,description:o??``,url:`${f}${t(r(i))}`,digest:`sha256:${e(c)}`}]}));return a.json({$schema:n,skills:m.flat()},200,l)}async function f(e,t){if(u(t))return c();let n=e.req.param(`slug`)??``,r=a(n),i=await t.entities.get(r);if(!i||!s(i,t.request.teams,e=>t.logger?.warn(e)))return c();let{content:o}=await t.entities.load(r);return e.body(o,200,{"Content-Type":`text/markdown; charset=utf-8`,...l})}export{f as skillMarkdown,d as skillsIndex};
1
+ import{hashString as e}from"../../../../database/utils/json.js";import{withPathPrefix as t}from"../../../../../shared/path-prefix.js";import{SKILLS_INDEX_SCHEMA_URL as n,skillMarkdownPath as r}from"../../../utils/skill-paths.js";import{SKILL_ENTITY_TYPE as i,skillEntityKey as a}from"../../../types/skill-entity.js";import{isEntityScopeVisible as o}from"../../../../../server/rbac/entity-scope.js";import{notFoundResponse as s}from"../../../../../server/plugin-context.js";import{publicOrigin as c}from"../../../utils/request-origin.js";const l={"Cache-Control":`no-store`,"Access-Control-Allow-Origin":`*`};function u(e){return e.config.skills?.hide===!0}async function d(a,d){if(u(d))return s();let f=c(d.request),p=await d.entities.list({type:i}),m=await Promise.all(p.map(async n=>{let{slug:i,title:a,description:s}=n.metadata??{};if(typeof i!=`string`||!o(n,d.request.teams,e=>d.logger?.warn(e)))return[];let{content:c}=await d.entities.load(n.key);return[{name:a??i,type:`skill-md`,description:s??``,url:`${f}${t(r(i))}`,digest:`sha256:${e(c)}`}]}));return a.json({$schema:n,skills:m.flat()},200,l)}async function f(e,t){if(u(t))return s();let n=e.req.param(`slug`)??``,r=a(n),i=await t.entities.get(r);if(!i||!o(i,t.request.teams,e=>t.logger?.warn(e)))return s();let{content:c}=await t.entities.load(r);return e.body(c,200,{"Content-Type":`text/markdown; charset=utf-8`,...l})}export{f as skillMarkdown,d as skillsIndex};
@@ -1,2 +1,2 @@
1
- import{hashContentBytes as e}from"../../../shared/utils/content-hash.js";import{createNodePlatformFs as t}from"../../../platform/node/fs.js";import{isObject as n}from"../../../shared/utils/is-object.js";import{loadRedoclyConfig as r}from"../../config.js";import{isPlanFeatureGranted as i}from"../../../shared/plan-gates.js";import{BUILT_IN_CLASSIC_PLUGINS as a,DEFAULT_PROJECT_PLUGIN_FILES as o,INTERNAL_PLUGIN_ID_PREFIX as s,PLAN_GATED_PLUGINS as c}from"./constants.js";import{setLoadedProjectPlugins as l}from"./loaded-set.js";import{createInternalContentPlugins as u}from"../internal/index.js";import{createRequire as d}from"node:module";import{fileURLToPath as f,pathToFileURL as p}from"node:url";import{dirname as m,isAbsolute as h,join as g,resolve as _}from"node:path";async function v(e,n={}){let s=_(e),c=n.fs??t(),{config:l}=await r(s,c),d=[],f=S(l),p=[];for(let e of f){let t=C(e,a);if(t!==void 0){n.logger?.warn(`Project plugin "${e}" is skipped: ${t} are built in. Remove it from \`plugins\` in redocly.yaml.`);continue}let r=w(e),i=r===void 0?await T(e,s,c):E(e,s);if(i===null){d.push({entry:e,message:`Cannot resolve the plugin module from the project root, its node_modules or the Realm Plus installation.`});continue}p.some(e=>e.path===i)||p.push({entry:e,path:i,feature:r??`customPlugins`})}for(let e of o){let t=g(s,e);if(await c.exists(t)){p.some(e=>e.path===t)||p.push({entry:e,path:t,feature:`customPlugins`});break}}let m=[],h=[],v=new Set(u().map(e=>e.id));for(let{entry:e,path:t,feature:r}of p){let a=await D({entry:e,path:t,contentDir:s,config:l,fs:c});if(`lintPlugin`in a){h.push({entry:e,path:t,plugin:a.lintPlugin});continue}if(`message`in a){d.push(a);continue}if(!i(l,r)){n.logger?.warn(`Project plugin "${e}" is skipped: \`${r}\` is not in this project's plan.`);continue}if(v.has(a.plugin.id)){d.push({entry:e,path:t,message:`Plugin id "${a.plugin.id}" is already registered by another plugin.`});continue}v.add(a.plugin.id),m.push(a)}for(let e of d)n.logger?.error(`Project plugin "${e.entry}": ${e.message}`);return{plugins:m,lintPlugins:h,paths:p.map(e=>e.path),entries:f,diagnostics:d}}async function y(e,t={}){let n=await v(e,t);return l(e,n),n}function b(e){return e.map(e=>`- ${e.entry}${e.path?` (${e.path})`:``}: ${e.message}`).join(`
2
- `)}function x(e){return/* @__PURE__ */ Error(`Failed to load project plugins:\n${b(e)}`)}function S(e){return(e.plugins??[]).map(e=>e.trim()).filter(e=>e!==``)}function C(e,t){let n=Object.keys(t).find(t=>e===t||e.startsWith(`${t}/`));return n===void 0?void 0:t[n]}function w(e){let t=Object.keys(c).find(t=>e===t||e===`${t}/plugin.js`);return t===void 0?void 0:c[t]}async function T(e,t,n){if(h(e)){if(await n.exists(e))return e;let r=_(t,e.replace(/^[/\\]+/,``));return await n.exists(r)?r:null}if(e.startsWith(`./`)||e.startsWith(`../`)){let r=_(t,e);return await n.exists(r)?r:null}if(e.includes(`/`)){let r=_(t,e);if(await n.exists(r))return r}return E(e,t)}function E(e,t){try{return d(import.meta.url).resolve(e,{paths:[t,m(f(import.meta.url))]})}catch{return null}}async function D(t){let{entry:n,path:r}=t,i=await e(await t.fs.readBinaryFile(r)),a=p(r);a.searchParams.set(`v`,i),delete d(r).cache[r];let o;try{o=await import(a.href)}catch(e){return{entry:n,path:r,message:`Cannot import the plugin module: ${M(e)}`}}let s=O(o);if(s===void 0)return{entry:n,path:r,message:`The module has no default export.`};let c=s,l=i;if(typeof s==`function`){l+=`+${await e(new TextEncoder().encode(JSON.stringify(t.config)))}`;try{c=await s({engine:`realm-plus`,contentDir:t.contentDir,config:t.config})}catch(e){return{entry:n,path:r,message:`The plugin factory threw: ${M(e)}`}}}if(A(c))return{lintPlugin:c};let u=j(c);if(u!==null)return{entry:n,path:r,message:u};let f=c;return{entry:n,path:r,plugin:{...f,version:`${f.version}+${l}`}}}function O(e){if(!n(e))return;let t=e.default;return n(t)&&!(`id`in t)&&`default`in t?t.default:t}const k=[`rules`,`preprocessors`,`decorators`,`configs`,`assertions`];function A(e){return n(e)&&typeof e.processContent!=`function`&&typeof e.afterRoutesCreated!=`function`&&e.version===void 0&&k.some(t=>t in e)}function j(e){return n(e)?typeof e.processContent==`function`||typeof e.afterRoutesCreated==`function`?`This is a legacy Realm lifecycle plugin (processContent/afterRoutesCreated). Realm Plus loads content plugins; see docs/guides/authoring-plugins.md.`:typeof e.id!=`string`||e.id.trim()===``?"The plugin needs a non-empty string `id`.":e.id.startsWith(`internal.`)?`The plugin id prefix "${s}" is reserved for built-in plugins.`:typeof e.version!=`string`||e.version.trim()===``?"The plugin needs a non-empty string `version`.":null:`The default export must be a plugin object or a factory that returns one.`}function M(e){return e instanceof Error?e.message:String(e)}export{x as createProjectPluginLoadError,b as formatProjectPluginDiagnostics,y as loadAndRegisterProjectPlugins,v as loadProjectPlugins,S as readPluginEntries,T as resolveProjectPluginPath};
1
+ import{isObject as e}from"../../../shared/utils/is-object.js";import{hashContentBytes as t}from"../../../shared/utils/content-hash.js";import{createNodePlatformFs as n}from"../../../platform/node/fs.js";import{loadRedoclyConfig as r}from"../../config.js";import{isPlanFeatureGranted as i}from"../../../shared/plan-gates.js";import{BUILT_IN_CLASSIC_PLUGINS as a,DEFAULT_PROJECT_PLUGIN_FILES as o,INTERNAL_PLUGIN_ID_PREFIX as s,PLAN_GATED_PLUGINS as c}from"./constants.js";import{setLoadedProjectPlugins as l}from"./loaded-set.js";import{createInternalContentPlugins as u}from"../internal/index.js";import{createRequire as d}from"node:module";import{fileURLToPath as f,pathToFileURL as p}from"node:url";import{dirname as m,isAbsolute as h,join as g,resolve as _}from"node:path";async function v(e,t={}){let s=_(e),c=t.fs??n(),{config:l}=await r(s,c),d=[],f=S(l),p=[];for(let e of f){let n=C(e,a);if(n!==void 0){t.logger?.warn(`Project plugin "${e}" is skipped: ${n} are built in. Remove it from \`plugins\` in redocly.yaml.`);continue}let r=w(e),i=r===void 0?await T(e,s,c):E(e,s);if(i===null){d.push({entry:e,message:`Cannot resolve the plugin module from the project root, its node_modules or the Realm Plus installation.`});continue}p.some(e=>e.path===i)||p.push({entry:e,path:i,feature:r??`customPlugins`})}for(let e of o){let t=g(s,e);if(await c.exists(t)){p.some(e=>e.path===t)||p.push({entry:e,path:t,feature:`customPlugins`});break}}let m=[],h=[],v=new Set(u().map(e=>e.id));for(let{entry:e,path:n,feature:r}of p){let a=await D({entry:e,path:n,contentDir:s,config:l,fs:c});if(`lintPlugin`in a){h.push({entry:e,path:n,plugin:a.lintPlugin});continue}if(`message`in a){d.push(a);continue}if(!i(l,r)){t.logger?.warn(`Project plugin "${e}" is skipped: \`${r}\` is not in this project's plan.`);continue}if(v.has(a.plugin.id)){d.push({entry:e,path:n,message:`Plugin id "${a.plugin.id}" is already registered by another plugin.`});continue}v.add(a.plugin.id),m.push(a)}for(let e of d)t.logger?.error(`Project plugin "${e.entry}": ${e.message}`);return{plugins:m,lintPlugins:h,paths:p.map(e=>e.path),entries:f,diagnostics:d}}async function y(e,t={}){let n=await v(e,t);return l(e,n),n}function b(e){return e.map(e=>`- ${e.entry}${e.path?` (${e.path})`:``}: ${e.message}`).join(`
2
+ `)}function x(e){return/* @__PURE__ */ Error(`Failed to load project plugins:\n${b(e)}`)}function S(e){return(e.plugins??[]).map(e=>e.trim()).filter(e=>e!==``)}function C(e,t){let n=Object.keys(t).find(t=>e===t||e.startsWith(`${t}/`));return n===void 0?void 0:t[n]}function w(e){let t=Object.keys(c).find(t=>e===t||e===`${t}/plugin.js`);return t===void 0?void 0:c[t]}async function T(e,t,n){if(h(e)){if(await n.exists(e))return e;let r=_(t,e.replace(/^[/\\]+/,``));return await n.exists(r)?r:null}if(e.startsWith(`./`)||e.startsWith(`../`)){let r=_(t,e);return await n.exists(r)?r:null}if(e.includes(`/`)){let r=_(t,e);if(await n.exists(r))return r}return E(e,t)}function E(e,t){try{return d(import.meta.url).resolve(e,{paths:[t,m(f(import.meta.url))]})}catch{return null}}async function D(e){let{entry:n,path:r}=e,i=await t(await e.fs.readBinaryFile(r)),a=p(r);a.searchParams.set(`v`,i),delete d(r).cache[r];let o;try{o=await import(a.href)}catch(e){return{entry:n,path:r,message:`Cannot import the plugin module: ${M(e)}`}}let s=O(o);if(s===void 0)return{entry:n,path:r,message:`The module has no default export.`};let c=s,l=i;if(typeof s==`function`){l+=`+${await t(new TextEncoder().encode(JSON.stringify(e.config)))}`;try{c=await s({engine:`realm-plus`,contentDir:e.contentDir,config:e.config})}catch(e){return{entry:n,path:r,message:`The plugin factory threw: ${M(e)}`}}}if(A(c))return{lintPlugin:c};let u=j(c);if(u!==null)return{entry:n,path:r,message:u};let f=c;return{entry:n,path:r,plugin:{...f,version:`${f.version}+${l}`}}}function O(t){if(!e(t))return;let n=t.default;return e(n)&&!(`id`in n)&&`default`in n?n.default:n}const k=[`rules`,`preprocessors`,`decorators`,`configs`,`assertions`];function A(t){return e(t)&&typeof t.processContent!=`function`&&typeof t.afterRoutesCreated!=`function`&&t.version===void 0&&k.some(e=>e in t)}function j(t){return e(t)?typeof t.processContent==`function`||typeof t.afterRoutesCreated==`function`?`This is a legacy Realm lifecycle plugin (processContent/afterRoutesCreated). Realm Plus loads content plugins; see docs/guides/authoring-plugins.md.`:typeof t.id!=`string`||t.id.trim()===``?"The plugin needs a non-empty string `id`.":t.id.startsWith(`internal.`)?`The plugin id prefix "${s}" is reserved for built-in plugins.`:typeof t.version!=`string`||t.version.trim()===``?"The plugin needs a non-empty string `version`.":null:`The default export must be a plugin object or a factory that returns one.`}function M(e){return e instanceof Error?e.message:String(e)}export{x as createProjectPluginLoadError,b as formatProjectPluginDiagnostics,y as loadAndRegisterProjectPlugins,v as loadProjectPlugins,S as readPluginEntries,T as resolveProjectPluginPath};
@@ -95,6 +95,11 @@ export type FinalizeContext = {
95
95
  };
96
96
  export type FinalizeResult = {
97
97
  entities?: readonly AnyRawEntityReference[];
98
+ /**
99
+ * Named dependencies for existing routes. `slug` can be a page's locale fallback
100
+ * (`localeContext.toL10nSlug(slug, locale)`): the fallback serves these in place of the
101
+ * page's dependencies of the same key.
102
+ */
98
103
  attach?: readonly {
99
104
  slug: string;
100
105
  deps: Record<string, ContentDependencyReference>;
@@ -1 +1 @@
1
- import{splitUrlSuffix as e}from"../../../shared/utils/routes/split-url-suffix.js";import{toPhysicalVersionedSlug as t}from"../../../shared/constants/versions.js";function n(t,n,i){if(!t.startsWith(`/`))return;let{path:a}=e(t),o=n.getAccess(a);if(o!==void 0)return o;let s=r(a,i);return s===null?void 0:n.getAccess(s)}function r(e,n){let r=[...n].sort(([e],[t])=>t.length-e.length);for(let[n,i]of r){if(!i.defaultVersion)continue;let r=t(e,n,i.defaultVersion);if(r!==null&&r!==e)return r}return null}export{n as linkedPageAccess};
1
+ import{toPhysicalVersionedSlug as e}from"../../../shared/constants/versions.js";import{splitUrlSuffix as t}from"../../../shared/utils/routes/split-url-suffix.js";function n(e,n,i){if(!e.startsWith(`/`))return;let{path:a}=t(e),o=n.getAccess(a);if(o!==void 0)return o;let s=r(a,i);return s===null?void 0:n.getAccess(s)}function r(t,n){let r=[...n].sort(([e],[t])=>t.length-e.length);for(let[n,i]of r){if(!i.defaultVersion)continue;let r=e(t,n,i.defaultVersion);if(r!==null&&r!==t)return r}return null}export{n as linkedPageAccess};
@@ -1 +1 @@
1
- import{hashJsonValue as e,toStableJsonString as t}from"../../database/utils/json.js";import{compileRouteAccessMatcher as n}from"../../../server/rbac/engine.js";import{compareStrings as r}from"../../../shared/utils/compare-strings.js";import{computePathPrefixes as i}from"../../../shared/utils/routes/compute-path-prefixes.js";import{normalizeRoutePath as a}from"../../../shared/utils/routes/normalize-route-path.js";import{resolveRouteScope as o}from"../../../server/rbac/route-scope.js";import{hashEntityListMembership as s,hashEntityRead as c}from"../../database/entity-store.js";import{getRouteByFilePath as l,getRouteBySlug as u,getRoutesInDirectory as d}from"./state-lookup.js";function f(e,t){let f=n(t),m=e=>f===null?null:o(f,{hasRbacKey:`rbac`in e.metadata,rbacValue:e.metadata.rbac,slug:e.slug,sourcePath:e.originFilePath},()=>{})??{},h=e=>{let t=[];for(let n of e)t.push(v(n));return t.sort((e,t)=>r(e.slug,t.slug))};function*g(t){for(let n of e.routeBySlug.values())!n.isFallback&&(t===void 0||t(n))&&(yield n)}let y=e=>e!==void 0&&!e.isFallback?e:void 0,b=t=>{let n=a(t),r=y(u(e,n));if(r)return r;let o=i(n),s;for(let e of g(e=>e.wildcardPrefix&&o.includes(e.slug)))(s===void 0||e.slug.length>s.slug.length)&&(s=e);return s};function x(t,n){switch(t){case`byFilePath`:{let t=l(e,n);return _(t?v(t):void 0)}case`bySlug`:{let t=y(u(e,n));return _(t?v(t):void 0)}case`inDirectory`:return _(h(d(e,n)));case`all`:return _(h(g()));case`get`:{let t=y(u(e,n));return _(t?{...v(t),metadata:t.metadata,access:m(t)}:void 0)}case`getAccess`:{let e=b(n);return _(e?m(e):void 0)}case`list`:{let{sidebarKey:e}=JSON.parse(n);return _(h(g(t=>t.sidebarSubtreeEntityKey===e)))}case`metadata`:{let e={};for(let t of[...g()].sort((e,t)=>r(e.slug,t.slug)))Object.hasOwn(t.metadata,n)&&(e[t.slug]=t.metadata[n]);return _(e)}case`entity`:return{value:void 0,hash:c(e,n)};case`entity-type`:return{value:void 0,hash:s(e,n)};default:return{value:void 0,hash:``}}}return p(x)}function p(e){return{hash:(t,n)=>e(t,n).hash,index(n){let r=(t,r)=>{let i=e(t,r);return n?.({kind:t,argument:r,resultHash:i.hash}),i.value};return{byFilePath:e=>r(`byFilePath`,e),bySlug:e=>r(`bySlug`,e),inDirectory:e=>r(`inDirectory`,e),all:()=>r(`all`,``),get:e=>r(`get`,e),getAccess:e=>r(`getAccess`,e),list:e=>r(`list`,t({sidebarKey:e.sidebarKey})),metadata:e=>r(`metadata`,e)}},memoized(){let t=/* @__PURE__ */ new Map;return p((n,r)=>{if(n===`entity`||n===`entity-type`)return e(n,r);let i=`${n}\u0000${r}`,a=t.get(i);return a===void 0&&(a=e(n,r),t.set(i,a)),a})}}}function m(e,t,n){return f(e,t).index(n)}function h(e){let t=/* @__PURE__ */ new Map;for(let n of e)t.set(`${n.kind}\u0000${n.argument}`,n);return[...t.values()].sort((e,t)=>r(e.kind,t.kind)||r(e.argument,t.argument))}function g(e,t){return e.hash(t.kind,t.argument)!==t.resultHash}function _(t){return{value:t,hash:e(t===void 0?`absent`:t)}}function v(e){return{slug:e.slug,routeId:e.routeId,originPluginId:e.originPluginId,originFilePath:e.originFilePath,versionGroup:e.versionGroup,version:e.version,sidebarSubtreeEntityKey:e.sidebarSubtreeEntityKey,template:e.template,locale:e.locale,canonicalSlug:e.canonicalSlug}}export{m as createRouteIndex,f as createRouteQueryEvaluator,h as dedupeRouteQueryDependencies,g as isRouteQueryStale};
1
+ import{hashJsonValue as e,toStableJsonString as t}from"../../database/utils/json.js";import{compareStrings as n}from"../../../shared/utils/compare-strings.js";import{compileRouteAccessMatcher as r}from"../../../server/rbac/engine.js";import{computePathPrefixes as i}from"../../../shared/utils/routes/compute-path-prefixes.js";import{normalizeRoutePath as a}from"../../../shared/utils/routes/normalize-route-path.js";import{resolveRouteScope as o}from"../../../server/rbac/route-scope.js";import{hashEntityListMembership as s,hashEntityRead as c}from"../../database/entity-store.js";import{getRouteByFilePath as l,getRouteBySlug as u,getRoutesInDirectory as d}from"./state-lookup.js";function f(e,t){let f=r(t),m=e=>f===null?null:o(f,{hasRbacKey:`rbac`in e.metadata,rbacValue:e.metadata.rbac,slug:e.slug,sourcePath:e.originFilePath},()=>{})??{},h=e=>{let t=[];for(let n of e)t.push(v(n));return t.sort((e,t)=>n(e.slug,t.slug))};function*g(t){for(let n of e.routeBySlug.values())!n.isFallback&&(t===void 0||t(n))&&(yield n)}let y=e=>e!==void 0&&!e.isFallback?e:void 0,b=t=>{let n=a(t),r=y(u(e,n));if(r)return r;let o=i(n),s;for(let e of g(e=>e.wildcardPrefix&&o.includes(e.slug)))(s===void 0||e.slug.length>s.slug.length)&&(s=e);return s};function x(t,r){switch(t){case`byFilePath`:{let t=l(e,r);return _(t?v(t):void 0)}case`bySlug`:{let t=y(u(e,r));return _(t?v(t):void 0)}case`inDirectory`:return _(h(d(e,r)));case`all`:return _(h(g()));case`get`:{let t=y(u(e,r));return _(t?{...v(t),metadata:t.metadata,access:m(t)}:void 0)}case`getAccess`:{let e=b(r);return _(e?m(e):void 0)}case`list`:{let{sidebarKey:e}=JSON.parse(r);return _(h(g(t=>t.sidebarSubtreeEntityKey===e)))}case`metadata`:{let e={};for(let t of[...g()].sort((e,t)=>n(e.slug,t.slug)))Object.hasOwn(t.metadata,r)&&(e[t.slug]=t.metadata[r]);return _(e)}case`entity`:return{value:void 0,hash:c(e,r)};case`entity-type`:return{value:void 0,hash:s(e,r)};default:return{value:void 0,hash:``}}}return p(x)}function p(e){return{hash:(t,n)=>e(t,n).hash,index(n){let r=(t,r)=>{let i=e(t,r);return n?.({kind:t,argument:r,resultHash:i.hash}),i.value};return{byFilePath:e=>r(`byFilePath`,e),bySlug:e=>r(`bySlug`,e),inDirectory:e=>r(`inDirectory`,e),all:()=>r(`all`,``),get:e=>r(`get`,e),getAccess:e=>r(`getAccess`,e),list:e=>r(`list`,t({sidebarKey:e.sidebarKey})),metadata:e=>r(`metadata`,e)}},memoized(){let t=/* @__PURE__ */ new Map;return p((n,r)=>{if(n===`entity`||n===`entity-type`)return e(n,r);let i=`${n}\u0000${r}`,a=t.get(i);return a===void 0&&(a=e(n,r),t.set(i,a)),a})}}}function m(e,t,n){return f(e,t).index(n)}function h(e){let t=/* @__PURE__ */ new Map;for(let n of e)t.set(`${n.kind}\u0000${n.argument}`,n);return[...t.values()].sort((e,t)=>n(e.kind,t.kind)||n(e.argument,t.argument))}function g(e,t){return e.hash(t.kind,t.argument)!==t.resultHash}function _(t){return{value:t,hash:e(t===void 0?`absent`:t)}}function v(e){return{slug:e.slug,routeId:e.routeId,originPluginId:e.originPluginId,originFilePath:e.originFilePath,versionGroup:e.versionGroup,version:e.version,sidebarSubtreeEntityKey:e.sidebarSubtreeEntityKey,template:e.template,locale:e.locale,canonicalSlug:e.canonicalSlug}}export{m as createRouteIndex,f as createRouteQueryEvaluator,h as dedupeRouteQueryDependencies,g as isRouteQueryStale};
@@ -1 +1 @@
1
- import{SEARCH_GROUP_FACET_FIELD as e,SEARCH_TEAMS_FACET_FIELD as t,SEARCH_VERSION_FACET_FIELD as n}from"../../../shared/search/facets.js";import{searchDocuments as r,searchFacets as i,searchFragmentParents as a,searchFragmentPostings as o,searchFragmentUsages as s,searchFragments as c,searchPostings as l,searchVocab as u}from"../../database/schema.js";import{batchValues as d,normalizeBatchSize as f}from"../../database/connection.js";import{teamBlockSectionKey as p}from"../../markdown/search/to-sections.js";import{tokenizeSearchContent as m,tokenizeSearchQuery as h}from"../tokenize.js";import{SEARCH_HIDE_FACET_FIELD as g,SEARCH_PIN_FACET_FIELD as _}from"../keywords.js";import{refreshTermDocCounts as v,selectTermIdsOfDocuments as y,selectTermIdsOfFragments as b}from"../../database/search-vocab.js";import{SearchEngine as ee}from"../engine/core/search-engine.js";import{PATH_SEGMENT_SEPARATOR as x,indexedPathSegments as S,indexedPathText as C,splitIndexedPath as w}from"./path-field.js";import{descriptionOffsetGroups as T,highlightFragment as te,indexedFragmentText as E,splitAnchor as D}from"./fragment-field.js";import{createPostingsTermLookup as O,wordOffsets as k}from"./term-lookup.js";import{optionalTokens as A}from"../stopwords.js";import{maxEditsForToken as j,pickCorrection as ne}from"./typo-correction.js";import"../store.js";import{and as M,asc as N,between as re,desc as P,eq as F,exists as I,gte as L,inArray as R,lt as ie,lte as z,ne as B,notExists as ae,notInArray as V,or as H,sql as U}from"drizzle-orm";import{alias as oe,unionAll as W}from"drizzle-orm/sqlite-core";const G=/* @__PURE__ */ new Set([e]),K=[{name:`title`,weight:2},{name:`text`,weight:1},{name:`path`,weight:1},{name:`httpPath`,weight:1}],se={name:`parameters`,weight:1},q=Object.fromEntries(K.map(e=>[e.name,e.weight])),ce=/* @__PURE__ */ new Set([`get`,`put`,`post`,`delete`,`options`,`head`,`patch`,`trace`,`query`]),J=/[_.:']/g;function le(e,t){if(!e)return m(``);let n=t?.toLowerCase(),r=n&&ce.has(n)?`${x}${n}`:``,i=m(`${e}${r}`),a=m(`${e.replace(J,` `)}${r}`),o=/* @__PURE__ */ new Map;for(let e of[...i.tokens,...a.tokens]){let t=o.get(e.value)??/* @__PURE__ */ new Set;for(let n of e.offsets)t.add(n);o.set(e.value,t)}return{tokens:[...o].map(([e,t])=>({documentId:0,value:e,offsets:[...t].sort((e,t)=>e-t)})),length:a.length}}function ue(e,t,n,r){let i=m(t.title),a=m(t.text),o=m(C(t.path,t.title)),s=le(t.httpPath,t.httpMethod),c=t.path||t.badges||t.product||t.version||t.isAdditionalOperation?{path:t.path,badges:t.badges,product:t.product,version:t.version,isAdditionalOperation:t.isAdditionalOperation}:null;return{fields:{title:i,text:a,path:o,httpPath:s},facets:t.facets??{},row:{entityKey:e,docKey:t.docKey,routeSlug:t.routeSlug,locale:t.locale??``,anchor:t.anchor??null,title:t.title,text:t.text,titleTokens:i.length,textTokens:a.length,pathTokens:o.length,httpPathTokens:s.length,sourceHash:n,pluginVersion:r,groupKey:t.groupKey||null,httpMethod:t.httpMethod??null,httpPath:t.httpPath??null,deprecated:+!!t.deprecated,extra:c}}}function de(e){let t=new Map(e.docs.map(e=>[e.docKey,e.locale??``])),n=(e.uses??[]).filter(e=>t.has(e.docKey)),r=/* @__PURE__ */ new Map;for(let e of n)r.has(e.fragmentKey)||r.set(e.fragmentKey,t.get(e.docKey)??``);let i=[],a=/* @__PURE__ */ new Set;for(let t of e.fragments??[]){let e=r.get(t.fragmentKey);e===void 0||a.has(t.fragmentKey)||(a.add(t.fragmentKey),i.push({fragment:t,locale:e,tokens:m(E(t))}))}let o=/* @__PURE__ */ new Map;for(let e of n){if(!a.has(e.fragmentKey))continue;let t=JSON.stringify([e.docKey,e.fragmentKey]);o.has(t)||o.set(t,e)}let s=/* @__PURE__ */ new Map;for(let e of o.values()){let t=e.path??[],{prefix:n,tail:r}=D(e.anchor),i=JSON.stringify([e.docKey,e.place,t,n]),a=s.get(i);a||(a={docKey:e.docKey,place:e.place,path:t,anchorPrefix:n,uses:[]},s.set(i,a)),a.uses.push({fragmentKey:e.fragmentKey,anchorTail:r})}return{entityKey:e.entityKey,docs:e.docs.map(t=>ue(e.entityKey,t,e.sourceHash,e.pluginVersion)),fragments:i,parents:[...s.values()]}}function fe(e){let t={fragmentKey:e.fragmentKey,name:e.name,description:e.description};return e.example&&(t.example=e.example),e.enumValues&&e.enumValues.length>0&&(t.enum=e.enumValues),t}const Y=(e,t)=>JSON.stringify([e,t]),pe=(e,t)=>JSON.stringify([e,t]),me=[8,16],he=e=>me[e.length-1]??50;async function ge(e,t){let n=e.select({id:r.id}).from(r).where(R(r.entityKey,[...t])),u=e.select({id:c.id}).from(c).where(R(c.entityKey,[...t])),d=[...await y(e,n.getSQL()),...await b(e,u.getSQL())];return await e.delete(l).where(R(l.docId,n)),await e.delete(i).where(R(i.docId,n)),await e.delete(o).where(R(o.fragmentId,u)),await e.delete(a).where(R(a.docId,n)),await e.delete(s).where(R(s.fragmentId,u)),await e.delete(c).where(R(c.entityKey,[...t])),d}function _e(e,t){if(e.length<=t)return e;let n=e.lastIndexOf(` `,t);return`${e.slice(0,n>0?n:t)}…`}function X(e){let t=[];return e.forEach(([e,...n],r)=>{for(let i of n)t.push({start:i,end:i+(e??0),word:r})}),t.sort((e,t)=>e.start-t.start||t.end-e.end)}function Z(e,t,n,r){let i=``,a=n;for(let{start:n,end:o}of t)n<a||o>r||(i+=`${e.slice(a,n)}<mark>${e.slice(n,o)}</mark>`,a=o);return i+e.slice(a,r)}function ve(e,t){if(t?.length)return Z(e,X(t),0,e.length)}function ye(e,t,n,r){if(e===void 0||e.length<2)return;let i=S(e,t),a=i.length<e.length,o=ve(i.join(x),n),s=a?r:void 0;if(o===void 0&&s===void 0)return;let c=o===void 0?[...i]:w(o);return a?[...c,s??t]:c}function be(e,t,n=200){if(!t?.length)return;let r=X(t);if(r.length===0||e.length<=n)return Z(e,r,0,e.length);let i={first:0,last:0,words:0,matches:0};for(let e=0;e<r.length;e++){let t=r[e].start+n,a=/* @__PURE__ */ new Set,o=e;for(let n=e;n<r.length&&r[n].end<=t;n++)a.add(r[n].word),o=n;let s=o-e+1;(a.size>i.words||a.size===i.words&&s>i.matches)&&(i={first:e,last:o,words:a.size,matches:s})}let a=r[i.first].start,o=r[i.last].end,s=Math.max(0,Math.min(a-Math.floor((n-(o-a))/2),e.length-n)),c=Math.min(e.length,s+n);if(s>0){let t=e.lastIndexOf(` `,s);s=t===-1?0:Math.min(t+1,a)}if(c<e.length){let t=e.indexOf(` `,c);c=t===-1?e.length:Math.max(t,o)}let l=Z(e,r,s,c);return`${s>0?`…`:``}${l}${c<e.length?`…`:``}`}async function xe(e,t,n){let[r]=await e.select({max:U`max(${n})`}).from(t);return Number(r?.max??0)}function Se(e,t){if(t.length===0)return[...e];let n=new Set(t),r=e.filter(e=>n.has(e.id)),i=new Set(r.map(e=>e.id)),a=t.filter(e=>!i.has(e)).sort((e,t)=>e-t).map(e=>({id:e,rank:0,fields:[]})),o=e[0]?.rank??0,s=[...r,...a];return[...s.map((e,t)=>Object.assign(e,{rank:o+s.length-t})),...e.filter(e=>!n.has(e.id))]}function Q(m){let y=f(void 0);async function b(e,t){let n=t.map(e=>e.entityKey),f=[];for(let t of d(n,y)){for(let n of await ge(e,t))f.push(n);await e.delete(r).where(R(r.entityKey,t))}let p=t.flatMap(e=>e.docs);if(p.length===0){await v(e,f);return}for(let t of d(p,y))await e.insert(r).values(t.map(e=>e.row));let m=/* @__PURE__ */ new Map;for(let t of d(n,y)){let n=await e.select({id:r.id,entityKey:r.entityKey,docKey:r.docKey}).from(r).where(R(r.entityKey,t));for(let e of n)m.set(Y(e.entityKey,e.docKey),e.id)}let h=/* @__PURE__ */ new Map,g=(e,t)=>JSON.stringify([e,t]),_=await xe(e,c,c.id)+1,b=[];for(let e of t)for(let{fragment:t,locale:n}of e.fragments){let r=_++;h.set(g(e.entityKey,t.fragmentKey),r),b.push({id:r,entityKey:e.entityKey,fragmentKey:t.fragmentKey,locale:n,name:t.name,description:t.description??``,example:t.example??null,enumValues:t.enum??null})}let ee=await xe(e,a,a.id)+1,x=[],S=[];for(let e of t)for(let t of e.parents){let n=m.get(Y(e.entityKey,t.docKey));if(n===void 0)continue;let r=ee++;x.push({id:r,docId:n,place:t.place,path:t.path,anchorPrefix:t.anchorPrefix});for(let i of t.uses){let t=h.get(g(e.entityKey,i.fragmentKey));t!==void 0&&S.push({fragmentId:t,docId:n,parentId:r,anchorTail:i.anchorTail})}}for(let t of d(b,y))await e.insert(c).values(t);for(let t of d(x,y))await e.insert(a).values(t);for(let t of d(S,y))await e.insert(s).values(t);let C=/* @__PURE__ */ new Map,w=e=>{let t=C.get(e);return t||(t=/* @__PURE__ */ new Set,C.set(e,t)),t};for(let e of p){let t=w(e.row.locale??``);for(let n of K)for(let r of e.fields[n.name].tokens)t.add(r.value)}for(let e of t)for(let{locale:t,tokens:n}of e.fragments){let e=w(t);for(let t of n.tokens)e.add(t.value)}let T=/* @__PURE__ */ new Map;for(let[t,n]of C)for(let r of d([...n],y)){await e.insert(u).values(r.map(e=>({term:e,locale:t}))).onConflictDoNothing();let n=await e.select({id:u.id,term:u.term}).from(u).where(M(F(u.locale,t),R(u.term,r)));for(let e of n)T.set(pe(t,e.term),e.id)}let te=[];for(let e of p){let t=m.get(Y(e.row.entityKey,e.row.docKey));if(t!==void 0)for(let n of K)for(let r of e.fields[n.name].tokens){let i=T.get(pe(e.row.locale??``,r.value));i!==void 0&&te.push({termId:i,field:n.name,docId:t,offsets:JSON.stringify(r.offsets)})}}for(let t of d(te,y))await e.insert(l).values(t);let E=[];for(let e of t)for(let{fragment:t,locale:n,tokens:r}of e.fragments){let i=h.get(g(e.entityKey,t.fragmentKey));if(i!==void 0)for(let e of r.tokens){let t=T.get(pe(n,e.value));t!==void 0&&E.push({termId:t,fragmentId:i,offsets:JSON.stringify(e.offsets)})}}for(let t of d(E,y))await e.insert(o).values(t);let D=[];for(let e of p){let t=m.get(Y(e.row.entityKey,e.row.docKey));if(t!==void 0)for(let[n,r]of Object.entries(e.facets))for(let e of r)D.push({docId:t,field:n,value:e})}for(let t of d(D,y))await e.insert(i).values(t);await v(e,[...f,...T.values()])}let x=e=>e===void 0?void 0:R(u.locale,[...e]);function S(e,t,n=50){return m.db.select({id:u.id,term:u.term}).from(u).where(M(e,x(t))).orderBy(P(u.docCount),N(u.term)).limit(n)}let C=(e,t)=>S(M(L(u.term,e),z(u.term,`${e}\uffff`)),t,he(e));async function w(e,t){let n=j(e),r=e.codePointAt(0);if(n===0||r===void 0||r>=1114111)return[];let i=[...e].length,a=await m.db.select({id:u.id,term:u.term,docCount:u.docCount}).from(u).where(M(x(t),L(u.term,String.fromCodePoint(r)),ie(u.term,String.fromCodePoint(r+1)),re(U`length(${u.term})`,i-n,i+n))).orderBy(P(u.docCount),N(u.term)).limit(2e3),o=/* @__PURE__ */ new Map;for(let{id:e,term:t,docCount:n}of a){let r=o.get(t);r?(r.docCount+=n,r.ids.push(e)):o.set(t,{term:t,docCount:n,ids:[e]})}let s=ne(e,[...o.values()]);return s===null?[]:(o.get(s)?.ids??[]).map(e=>({id:e,term:s}))}async function E(e,t,n){let r=e.length-1,i=(e,n)=>t.has(e)&&n!==r,a=(e,t)=>t===r||t>r-3&&e.length>=3,[o,s]=await Promise.all([m.db.select({id:u.id,term:u.term}).from(u).where(M(R(u.term,e),x(n))),Promise.all(e.map(async(e,t)=>!i(e,t)&&a(e,t)?C(e,n):[]))]);return Promise.all(e.map(async(e,t)=>{let c=o.filter(t=>t.term===e);if(i(e,t))return D(e,c,!0);let l=[...c,...s[t]??[]];if(l.length>0)return D(e,l);let d=await w(e,n),f=d[0]?.term;if(f!==void 0){let e=a(f,t)?await C(f,n):[];return D(f,[...d,...e])}let p=t===r&&e.length>=3?await S(U`instr(${u.term}, ${e}) > 0`,n):[];return D(e,p)}))}let D=(e,t,n=!1)=>({word:e,ids:[...new Set(t.map(e=>e.id))],terms:new Set(t.map(e=>e.term)),optional:n});function ce(e){let t=/* @__PURE__ */ new Set,n=[];for(let r of[...e].reverse())t.has(r.word)||(t.add(r.word),n.push(r));return n.reverse()}let J=()=>({hits:[],facetCounts:{}});function le(e,t){let n=Math.max(0,Math.trunc(e.offset??0));return{offset:n,end:Math.min(n+t,500)}}function ue(e){let t=e?.trim().toLowerCase();if(t)return e=>e.toLowerCase().startsWith(t)}let me=e=>(e.filter??[]).filter(e=>e.values.length>0),X=oe(i,`carried`),Z=(e,t)=>t.length===0?U`0`:I(m.db.select({one:U`1`}).from(X).where(M(F(X.docId,r.id),F(X.field,e),R(X.value,[...t]))));function Q(e,i){let a=[];e.locales!==void 0&&a.push(R(r.locale,[...e.locales]));let{candidates:o}=e;if(o!==void 0&&(i===void 0||o.lifted!==i)&&a.push(R(r.id,o.ids)),e.hidden!==void 0&&a.push(V(r.id,e.hidden)),e.teams!==void 0&&a.push(Z(t,[...new Set(e.teams.map(e=>e.toLowerCase()))])),e.versions!==void 0){let t=ae(m.db.select({one:U`1`}).from(X).where(M(F(X.docId,r.id),F(X.field,n)))),i=[...new Set(e.versions)];a.push(i.length===0?t:H(t,Z(n,i)))}for(let t of e.selections)t.field!==i&&a.push(Z(t.field,t.values));return a}async function Ce(e,t){let n=await m.db.select({id:r.id,titleTokens:r.titleTokens,textTokens:r.textTokens,pathTokens:r.pathTokens,httpPathTokens:r.httpPathTokens,groupKey:r.groupKey,entityKey:r.entityKey,docKey:r.docKey,pinned:(t===void 0?U`0`:U`${R(r.id,t)}`).as(`pinned`)}).from(r).where(M(...Q(e)));return new Map(n.map(({id:e,pinned:t,...n})=>[e,{...n,pinned:Number(t)===1}]))}async function we(e,t,n){return m.db.select({field:i.field,value:i.value,count:U`count(*)`}).from(r).crossJoin(i).where(M(F(i.docId,r.id),R(i.field,[...t]),...Q(e,n))).groupBy(i.field,i.value)}let $=(e,t)=>m.db.select({docId:i.docId}).from(i).where(M(F(i.field,e),R(i.value,[...t])));function Te(e,a){let o=i.docId,s=[];if(e.locales!==void 0&&s.push(R(o,m.db.select({id:r.id}).from(r).where(R(r.locale,[...e.locales])))),e.teams!==void 0){let n=[...new Set(e.teams.map(e=>e.toLowerCase()))];s.push(n.length===0?U`0`:R(o,$(t,n)))}if(e.versions!==void 0){let t=V(o,m.db.select({docId:i.docId}).from(i).where(F(i.field,n))),r=[...new Set(e.versions)];s.push(r.length===0?t:H(t,R(o,$(n,r))))}for(let t of e.selections)t.field!==a&&s.push(R(o,$(t.field,t.values)));return s}async function Ee(e,t,n){return m.db.select({field:i.field,value:i.value,count:U`count(*)`}).from(i).where(M(R(i.field,[...t]),...Te(e,n))).groupBy(i.field,i.value)}async function De(e,t,n){let r=[...new Set(t)],i=r.filter(t=>e.candidates!==void 0&&e.candidates.lifted!==t),a=r.filter(e=>!i.includes(e)),o=new Set(e.selections.map(e=>e.field)),s=e=>{let t=e.filter(e=>!o.has(e));return[...t.length>0?[{fields:t,lift:void 0}]:[],...e.filter(e=>o.has(e)).map(e=>({fields:[e],lift:e}))]},c=(await Promise.all([...s(i).map(t=>we(e,t.fields,t.lift)),...s(a).map(t=>Ee(e,t.fields,t.lift))])).flat(),l=ue(n),u={};for(let e of r)u[e]=c.filter(t=>t.field===e&&(l===void 0||l(t.value))).map(e=>({value:e.value,count:Number(e.count)})).sort((e,t)=>t.count-e.count||(e.value<t.value?-1:1)).slice(0,G.has(e)?void 0:25);return u}async function Oe(e){let t=/* @__PURE__ */ new Map;for(let n of d(e,y)){let e=await m.db.select().from(r).where(R(r.id,n));for(let n of e)t.set(n.id,n)}return t}async function ke(e,t){let n=[];for(let r of d(e,y)){let e=await m.db.select({field:l.field,term:u.term,docId:l.docId,offsets:l.offsets}).from(l).innerJoin(u,F(u.id,l.termId)).where(M(R(l.termId,r),t===void 0?void 0:R(l.docId,t)));for(let t of e)n.push(t)}return n}function Ae(e,t){let n=m.db.select({docId:l.docId,termId:l.termId}).from(l).where(M(R(l.termId,e),B(l.field,`path`))),r=m.db.select({docId:s.docId,termId:o.termId}).from(o).innerJoin(s,F(s.fragmentId,o.fragmentId)).where(R(o.termId,e)),i=W(n,r).as(`occurrences`),a=m.db.select({docId:i.docId}).from(i);if(t===void 0)return a;let c=U.join(t.map(e=>U`max(case when ${R(i.termId,[...e])} then 1 else 0 end)`),U` + `);return a.groupBy(i.docId).having(U`${c} = ${t.length}`)}async function je(e){let t=(e,t)=>{let n=m.db.select({docId:l.docId}).from(l).where(M(R(l.termId,[...t]),B(l.field,`path`))),r=m.db.select({docId:s.docId}).from(o).innerJoin(s,F(s.fragmentId,o.fragmentId)).where(R(o.termId,[...t])),i=W(n,r).as(`reached`);return m.db.select({word:U`${e}`.as(`word`),count:U`count(distinct ${i.docId})`.as(`count`)}).from(i)},n=e.flatMap((e,n)=>e.length===0?[]:[t(n,e)]),r=e.map(()=>0);if(n.length===0)return r;let i=n.length===1?await n[0]:await W(...n);for(let e of i)r[Number(e.word)]=Number(e.count);return r}async function Me(e,t){let n=[];for(let r of d(e,y)){let e=await m.db.select({term:u.term,fragmentId:o.fragmentId,offsets:o.offsets,docId:s.docId}).from(o).innerJoin(u,F(u.id,o.termId)).innerJoin(s,F(s.fragmentId,o.fragmentId)).where(M(R(o.termId,r),t===void 0?void 0:R(U`+${s.docId}`,t)));for(let t of e)n.push(t)}return n}function Ne(e){let t=/* @__PURE__ */ new Map;return e.map(e=>{let n=`${e.docId}\u0000${e.fragmentId}`,r=t.get(n);r===void 0&&t.set(n,r=t.size);let i=r*1e6,a=JSON.parse(e.offsets).map(e=>i+e);return{term:e.term,docId:e.docId,offsets:JSON.stringify(a)}})}function Pe(e,t){let n=/* @__PURE__ */ new Map;for(let r of e){let e=n.get(r.docId);e||n.set(r.docId,e=/* @__PURE__ */ new Map);let i=e.get(r.fragmentId);i||(i={fragmentId:r.fragmentId,score:0,offsetGroups:[]},e.set(r.fragmentId,i));let a=JSON.parse(r.offsets);i.score+=a.length;for(let{word:e,terms:n}of t)n.has(r.term)&&i.offsetGroups.push([e.length,...k(e,r.term,a)])}let r=/* @__PURE__ */ new Map;for(let[e,t]of n){let n;for(let e of t.values())(n===void 0||e.score>n.score)&&(n=e);n&&r.set(e,{fragmentId:n.fragmentId,offsetGroups:n.offsetGroups})}return r}async function Fe(e){let t=/* @__PURE__ */ new Map;for(let n of d([...new Set(e)],y)){let e=await m.db.select().from(c).where(R(c.id,n));for(let n of e)t.set(n.id,fe(n))}return t}async function Ie(e){let t=/* @__PURE__ */ new Map;if(e.size===0)return t;let n=await m.db.select({docId:s.docId,fragmentId:s.fragmentId,anchorTail:s.anchorTail,place:a.place,path:a.path,anchorPrefix:a.anchorPrefix}).from(s).innerJoin(a,F(a.id,s.parentId)).where(M(R(s.docId,[...e.keys()]),R(s.fragmentId,[...new Set([...e.values()].map(e=>e.fragmentId))])));for(let r of n)e.get(r.docId)?.fragmentId===r.fragmentId&&t.set(r.docId,{place:r.place,path:r.path,anchor:r.anchorPrefix+r.anchorTail});return t}async function Le(e){let[t]=await m.db.select({total:U`count(*)`,averageTitle:U`avg(${r.titleTokens})`,averageText:U`avg(${r.textTokens})`,averagePath:U`avg(nullif(${r.pathTokens}, 0))`,averageHttpPath:U`avg(nullif(${r.httpPathTokens}, 0))`}).from(r).where(e===void 0?void 0:R(r.locale,[...e]));return t}async function Re(e){let t=/* @__PURE__ */ new Set;for(let n=0;n<e.length;n++){let r=Math.min(e.length,n+10);for(let i=n+1;i<=r;i++)t.add(e.slice(n,i).join(` `))}let n=[...t],r=await m.db.selectDistinct({field:i.field}).from(i).where(M(R(i.field,[_,g]),R(i.value,n))),a=e=>r.some(t=>t.field===e),o=a(`redocly_hide`)?$(g,n):void 0;if(!a(`redocly_pin`))return o?{hidden:o}:{};let s=m.db.select({docId:i.docId}).from(i).where(M(F(i.field,_),R(i.value,n)));return o?{pinned:s,hidden:o}:{pinned:s}}async function ze(e){return(await m.db.select({id:r.id}).from(r).where(M(...Q(e))).limit(1)).length>0}async function Be(t,n,r,i){let{locales:a}=r,o=ce(t),s=o.filter(e=>!e.optional).map(e=>e.ids).filter(e=>e.length>0),c=[...new Set(s.flat())];if(c.length===0&&n.pinned===void 0)return J();let l=o.filter(e=>e.optional).flatMap(e=>e.ids),u=[.../* @__PURE__ */ new Set([...c,...l])],d=o.map(e=>e.word),f=new Set(o.filter(e=>e.optional).map(e=>e.word)),{pinned:m}=n,h=e=>m===void 0?e:U`(select doc_id from ${e} union select doc_id from ${m})`,g=e=>({locales:a,candidates:{ids:e},hidden:n.hidden,teams:r.teams,versions:r.versions,selections:me(r)}),_=Ae(c,s.length>0?s:void 0),v=Ae(c),y=e=>De(e,r.countFields??[],r.countValuePrefix),b=m!==void 0&&s.length>1?ze(g(_)):void 0;if(r.countOnly){let[e,t]=await Promise.all([y(g(h(_))),b]),n=Object.values(e).every(e=>e.length===0);return c.length===0&&n?J():{hits:[],facetCounts:s.length>1&&!(t??!n)?await y(g(h(v))):e}}let x=Promise.all([Le(a),je(o.map(e=>e.ids))]),S=(e,t)=>{let n=h(e);return Promise.all([y(g(n)),Ce(g(n),m),ke(u,t?n:void 0),Me(c,t?n:void 0)])},[C,w]=await Promise.all([S(_,!0),b]),[E,D,k,A]=C;!(w??D.size>0)&&s.length>1&&([E,D,k,A]=await S(v,l.length>0));let[j,ne]=await x,M=[...D].filter(([,e])=>e.pinned).map(([e])=>e);if(M.length===0&&(D.size===0||k.length===0&&A.length===0))return c.length===0?J():{hits:[],facetCounts:E};let N=new Map(o.map((e,t)=>[e.word,ne[t]??0])),re=new Set([...k,...A].map(e=>e.docId)),P=le(r,i),F=(e,t)=>({totalDocuments:j?.total??0,averageDocumentLength:t??0,getDocumentLength:t=>D.get(t)?.[e]??0}),I=/* @__PURE__ */ new Map;for(let e of k){let t=I.get(e.field);t?t.push(e):I.set(e.field,[e])}let L=e=>I.get(e)??[],R=new ee({limit:re.size,fields:[{name:`title`,weight:q.title,lookup:O(L(`title`)),corpusStats:F(`titleTokens`,j?.averageTitle??null)},{name:`text`,weight:q.text,lookup:O(L(`text`)),corpusStats:F(`textTokens`,j?.averageText??null)},{name:`path`,weight:q.path,lookup:O(L(`path`)),corpusStats:F(`pathTokens`,j?.averagePath??null),countsTowardFrequency:!1},{name:`httpPath`,weight:q.httpPath,lookup:O(L(`httpPath`)),corpusStats:F(`httpPathTokens`,j?.averageHttpPath??null)},{name:se.name,weight:se.weight,lookup:O(Ne(A)),corpusStats:{totalDocuments:j?.total??0,averageDocumentLength:1,getDocumentLength:()=>1}}]}),ie=/* @__PURE__ */ new Set,z=/* @__PURE__ */ new Map,B=Se(R.search(d.join(` `),{optional:f,documentFrequencies:N,terms:new Map(o.map(e=>[e.word,e.terms]))}),M).filter(e=>{let t=D.get(e.id);if(t===void 0)return!1;let n=Y(t.entityKey,p(t.docKey));return ie.has(n)?(t.groupKey!==null&&z.set(t.groupKey,(z.get(t.groupKey)??0)+1),!1):(ie.add(n),!0)}),ae=E[e];ae!==void 0&&z.size>0&&(E[e]=ae.map(({value:e,count:t})=>({value:e,count:t-(z.get(e)??0)})).filter(({count:e})=>e>0));let V=r.perGroup,H=/* @__PURE__ */ new Map,oe=V===void 0?B.slice(P.offset,P.end):B.filter(e=>{let t=D.get(e.id)?.groupKey??null,n=H.get(t)??0;return H.set(t,n+1),n<V}),W=new Set(oe.map(e=>e.id)),G=Pe(A.filter(e=>W.has(e.docId)),o),[K,ue,de]=await Promise.all([Oe([...W]),Fe([...G.values()].map(e=>e.fragmentId)),Ie(G)]);return{hits:oe.flatMap(e=>{let t=K.get(e.id);if(!t)return[];let n=t=>e.fields.find(e=>e.name===t),r=e=>n(e)?.offsets,i={},a=ve(t.title,r(`title`)),o=be(t.text,r(`text`)),s=ye(t.extra?.path,t.title,r(`path`),a);a!==void 0&&(i.title=a),o!==void 0&&(i.text=o),s!==void 0&&(i.path=s);let c=ve(t.httpPath??``,r(`httpPath`));c?.includes(`<mark>`)&&(i.httpPath=c);let l=G.get(e.id),u=l?ue.get(l.fragmentId):void 0,d=de.get(e.id),p={...t,rank:e.rank,highlight:i};if(l===void 0||u===void 0||d===void 0)return[p];let m=te(u,d,l.offsetGroups),h=u.description??``;return m.description=be(h,T(u,l.offsetGroups))??_e(h,200),i.parameters=[m],[n(`title`)?.tokens.some(e=>!f.has(e))?p:{...p,parameterAnchor:d.anchor}]}),facetCounts:E}}async function Ve(e,t){let n=me(e),[a]=n,o={locales:e.locales,candidates:a&&{ids:m.db.select({docId:i.docId}).from(i).where(M(F(i.field,a.field),R(i.value,[...a.values]))),lifted:a.field},teams:e.teams,versions:e.versions,selections:n},s=await De(o,e.countFields??[],e.countValuePrefix),c=le(e,t);return e.countOnly||o.selections.length===0||c.end<=c.offset?{hits:[],facetCounts:s}:{hits:(await m.db.select().from(r).where(M(...Q(o))).orderBy(N(r.routeSlug),N(r.docKey)).limit(c.end-c.offset).offset(c.offset)).map(e=>Object.assign(e,{rank:0,highlight:{}})),facetCounts:s}}return{async replaceSourceDocuments(e,t){if(e.length===0)return;let n=e.map(de);t?await b(t,n):await m.db.transaction(e=>b(e,n))},async removeSource(e){await m.db.transaction(async t=>{let n=await ge(t,[e]);await t.delete(r).where(F(r.entityKey,e)),await v(t,n)})},async query(e){let t=Math.min(Math.max(1,Math.trunc(e.limit)),500),n=h(e.q);if(n.length===0)return Ve(e,t);let r=A(n,e.stopwords),[i,a]=await Promise.all([E(n,r,e.locales),Re(n)]);return Be(i,a,e,t)},async readDocuments(e={}){let t=[e.routeSlug===void 0?void 0:F(r.routeSlug,e.routeSlug),e.entityKey===void 0?void 0:F(r.entityKey,e.entityKey)].filter(e=>e!==void 0);return m.db.select().from(r).where(t.length>0?M(...t):void 0).orderBy(N(r.entityKey),N(r.docKey))}}}export{Q as createPostingsSearchStore,ve as highlightOffsets,ye as highlightPath,be as highlightSnippet,Se as pinFirst};
1
+ import{SEARCH_GROUP_FACET_FIELD as e,SEARCH_TEAMS_FACET_FIELD as t,SEARCH_VERSION_FACET_FIELD as n}from"../../../shared/search/facets.js";import{routes as r,searchDocuments as i,searchFacets as a,searchFragmentParents as o,searchFragmentPostings as s,searchFragmentUsages as c,searchFragments as l,searchPostings as u,searchVocab as d}from"../../database/schema.js";import{batchValues as f,normalizeBatchSize as p}from"../../database/connection.js";import{teamBlockSectionKey as m}from"../../markdown/search/to-sections.js";import{tokenizeSearchContent as h,tokenizeSearchQuery as g}from"../tokenize.js";import{SEARCH_HIDE_FACET_FIELD as _,SEARCH_PIN_FACET_FIELD as v}from"../keywords.js";import{refreshTermDocCounts as y,selectTermIdsOfDocuments as b,selectTermIdsOfFragments as x}from"../../database/search-vocab.js";import{SearchEngine as ee}from"../engine/core/search-engine.js";import{PATH_SEGMENT_SEPARATOR as S,indexedPathSegments as C,indexedPathText as w,splitIndexedPath as T}from"./path-field.js";import{descriptionOffsetGroups as te,highlightFragment as ne,indexedFragmentText as E,splitAnchor as D}from"./fragment-field.js";import{createPostingsTermLookup as O,wordOffsets as k}from"./term-lookup.js";import{optionalTokens as A}from"../stopwords.js";import{maxEditsForToken as re,pickCorrection as ie}from"./typo-correction.js";import"../store.js";import{and as j,asc as M,between as N,desc as P,eq as F,exists as I,gte as ae,inArray as L,lt as R,lte as oe,ne as z,notExists as B,notInArray as V,or as H,sql as U}from"drizzle-orm";import{alias as se,unionAll as W}from"drizzle-orm/sqlite-core";const ce=/* @__PURE__ */ new Set([e]),G=[{name:`title`,weight:2},{name:`text`,weight:1},{name:`path`,weight:1},{name:`httpPath`,weight:1}],le={name:`parameters`,weight:1},K=Object.fromEntries(G.map(e=>[e.name,e.weight])),ue=/* @__PURE__ */ new Set([`get`,`put`,`post`,`delete`,`options`,`head`,`patch`,`trace`,`query`]),q=/[_.:']/g;function de(e,t){if(!e)return h(``);let n=t?.toLowerCase(),r=n&&ue.has(n)?`${S}${n}`:``,i=h(`${e}${r}`),a=h(`${e.replace(q,` `)}${r}`),o=/* @__PURE__ */ new Map;for(let e of[...i.tokens,...a.tokens]){let t=o.get(e.value)??/* @__PURE__ */ new Set;for(let n of e.offsets)t.add(n);o.set(e.value,t)}return{tokens:[...o].map(([e,t])=>({documentId:0,value:e,offsets:[...t].sort((e,t)=>e-t)})),length:a.length}}function fe(e,t,n,r){let i=h(t.title),a=h(t.text),o=h(w(t.path,t.title)),s=de(t.httpPath,t.httpMethod),c=t.path||t.badges||t.product||t.version||t.isAdditionalOperation?{path:t.path,badges:t.badges,product:t.product,version:t.version,isAdditionalOperation:t.isAdditionalOperation}:null;return{fields:{title:i,text:a,path:o,httpPath:s},facets:t.facets??{},row:{entityKey:e,docKey:t.docKey,routeSlug:t.routeSlug,locale:t.locale??``,anchor:t.anchor??null,title:t.title,text:t.text,titleTokens:i.length,textTokens:a.length,pathTokens:o.length,httpPathTokens:s.length,sourceHash:n,pluginVersion:r,groupKey:t.groupKey||null,httpMethod:t.httpMethod??null,httpPath:t.httpPath??null,deprecated:+!!t.deprecated,extra:c}}}function pe(e){let t=new Map(e.docs.map(e=>[e.docKey,e.locale??``])),n=(e.uses??[]).filter(e=>t.has(e.docKey)),r=/* @__PURE__ */ new Map;for(let e of n)r.has(e.fragmentKey)||r.set(e.fragmentKey,t.get(e.docKey)??``);let i=[],a=/* @__PURE__ */ new Set;for(let t of e.fragments??[]){let e=r.get(t.fragmentKey);e===void 0||a.has(t.fragmentKey)||(a.add(t.fragmentKey),i.push({fragment:t,locale:e,tokens:h(E(t))}))}let o=/* @__PURE__ */ new Map;for(let e of n){if(!a.has(e.fragmentKey))continue;let t=JSON.stringify([e.docKey,e.fragmentKey]);o.has(t)||o.set(t,e)}let s=/* @__PURE__ */ new Map;for(let e of o.values()){let t=e.path??[],{prefix:n,tail:r}=D(e.anchor),i=JSON.stringify([e.docKey,e.place,t,n]),a=s.get(i);a||(a={docKey:e.docKey,place:e.place,path:t,anchorPrefix:n,uses:[]},s.set(i,a)),a.uses.push({fragmentKey:e.fragmentKey,anchorTail:r})}return{entityKey:e.entityKey,docs:e.docs.map(t=>fe(e.entityKey,t,e.sourceHash,e.pluginVersion)),fragments:i,parents:[...s.values()]}}function me(e){let t={fragmentKey:e.fragmentKey,name:e.name,description:e.description};return e.example&&(t.example=e.example),e.enumValues&&e.enumValues.length>0&&(t.enum=e.enumValues),t}const J=(e,t)=>JSON.stringify([e,t]),he=(e,t)=>JSON.stringify([e,t]),ge=[8,16],_e=e=>ge[e.length-1]??50;async function ve(e,t){let n=e.select({id:i.id}).from(i).where(L(i.entityKey,[...t])),r=e.select({id:l.id}).from(l).where(L(l.entityKey,[...t])),d=[...await b(e,n.getSQL()),...await x(e,r.getSQL())];return await e.delete(u).where(L(u.docId,n)),await e.delete(a).where(L(a.docId,n)),await e.delete(s).where(L(s.fragmentId,r)),await e.delete(o).where(L(o.docId,n)),await e.delete(c).where(L(c.fragmentId,r)),await e.delete(l).where(L(l.entityKey,[...t])),d}function ye(e,t){if(e.length<=t)return e;let n=e.lastIndexOf(` `,t);return`${e.slice(0,n>0?n:t)}…`}function Y(e){let t=[];return e.forEach(([e,...n],r)=>{for(let i of n)t.push({start:i,end:i+(e??0),word:r})}),t.sort((e,t)=>e.start-t.start||t.end-e.end)}function X(e,t,n,r){let i=``,a=n;for(let{start:n,end:o}of t)n<a||o>r||(i+=`${e.slice(a,n)}<mark>${e.slice(n,o)}</mark>`,a=o);return i+e.slice(a,r)}function Z(e,t){if(t?.length)return X(e,Y(t),0,e.length)}function be(e,t,n,r){if(e===void 0||e.length<2)return;let i=C(e,t),a=i.length<e.length,o=Z(i.join(S),n),s=a?r:void 0;if(o===void 0&&s===void 0)return;let c=o===void 0?[...i]:T(o);return a?[...c,s??t]:c}function xe(e,t,n=200){if(!t?.length)return;let r=Y(t);if(r.length===0||e.length<=n)return X(e,r,0,e.length);let i={first:0,last:0,words:0,matches:0};for(let e=0;e<r.length;e++){let t=r[e].start+n,a=/* @__PURE__ */ new Set,o=e;for(let n=e;n<r.length&&r[n].end<=t;n++)a.add(r[n].word),o=n;let s=o-e+1;(a.size>i.words||a.size===i.words&&s>i.matches)&&(i={first:e,last:o,words:a.size,matches:s})}let a=r[i.first].start,o=r[i.last].end,s=Math.max(0,Math.min(a-Math.floor((n-(o-a))/2),e.length-n)),c=Math.min(e.length,s+n);if(s>0){let t=e.lastIndexOf(` `,s);s=t===-1?0:Math.min(t+1,a)}if(c<e.length){let t=e.indexOf(` `,c);c=t===-1?e.length:Math.max(t,o)}let l=X(e,r,s,c);return`${s>0?`…`:``}${l}${c<e.length?`…`:``}`}async function Se(e,t,n){let[r]=await e.select({max:U`max(${n})`}).from(t);return Number(r?.max??0)}function Ce(e,t){if(t.length===0)return[...e];let n=new Set(t),r=e.filter(e=>n.has(e.id)),i=new Set(r.map(e=>e.id)),a=t.filter(e=>!i.has(e)).sort((e,t)=>e-t).map(e=>({id:e,rank:0,fields:[]})),o=e[0]?.rank??0,s=[...r,...a];return[...s.map((e,t)=>Object.assign(e,{rank:o+s.length-t})),...e.filter(e=>!n.has(e.id))]}function we(h){let b=p(void 0);async function x(e,t){let n=t.map(e=>e.entityKey),r=[];for(let t of f(n,b)){for(let n of await ve(e,t))r.push(n);await e.delete(i).where(L(i.entityKey,t))}let p=t.flatMap(e=>e.docs);if(p.length===0){await y(e,r);return}for(let t of f(p,b))await e.insert(i).values(t.map(e=>e.row));let m=/* @__PURE__ */ new Map;for(let t of f(n,b)){let n=await e.select({id:i.id,entityKey:i.entityKey,docKey:i.docKey}).from(i).where(L(i.entityKey,t));for(let e of n)m.set(J(e.entityKey,e.docKey),e.id)}let h=/* @__PURE__ */ new Map,g=(e,t)=>JSON.stringify([e,t]),_=await Se(e,l,l.id)+1,v=[];for(let e of t)for(let{fragment:t,locale:n}of e.fragments){let r=_++;h.set(g(e.entityKey,t.fragmentKey),r),v.push({id:r,entityKey:e.entityKey,fragmentKey:t.fragmentKey,locale:n,name:t.name,description:t.description??``,example:t.example??null,enumValues:t.enum??null})}let x=await Se(e,o,o.id)+1,ee=[],S=[];for(let e of t)for(let t of e.parents){let n=m.get(J(e.entityKey,t.docKey));if(n===void 0)continue;let r=x++;ee.push({id:r,docId:n,place:t.place,path:t.path,anchorPrefix:t.anchorPrefix});for(let i of t.uses){let t=h.get(g(e.entityKey,i.fragmentKey));t!==void 0&&S.push({fragmentId:t,docId:n,parentId:r,anchorTail:i.anchorTail})}}for(let t of f(v,b))await e.insert(l).values(t);for(let t of f(ee,b))await e.insert(o).values(t);for(let t of f(S,b))await e.insert(c).values(t);let C=/* @__PURE__ */ new Map,w=e=>{let t=C.get(e);return t||(t=/* @__PURE__ */ new Set,C.set(e,t)),t};for(let e of p){let t=w(e.row.locale??``);for(let n of G)for(let r of e.fields[n.name].tokens)t.add(r.value)}for(let e of t)for(let{locale:t,tokens:n}of e.fragments){let e=w(t);for(let t of n.tokens)e.add(t.value)}let T=/* @__PURE__ */ new Map;for(let[t,n]of C)for(let r of f([...n],b)){await e.insert(d).values(r.map(e=>({term:e,locale:t}))).onConflictDoNothing();let n=await e.select({id:d.id,term:d.term}).from(d).where(j(F(d.locale,t),L(d.term,r)));for(let e of n)T.set(he(t,e.term),e.id)}let te=[];for(let e of p){let t=m.get(J(e.row.entityKey,e.row.docKey));if(t!==void 0)for(let n of G)for(let r of e.fields[n.name].tokens){let i=T.get(he(e.row.locale??``,r.value));i!==void 0&&te.push({termId:i,field:n.name,docId:t,offsets:JSON.stringify(r.offsets)})}}for(let t of f(te,b))await e.insert(u).values(t);let ne=[];for(let e of t)for(let{fragment:t,locale:n,tokens:r}of e.fragments){let i=h.get(g(e.entityKey,t.fragmentKey));if(i!==void 0)for(let e of r.tokens){let t=T.get(he(n,e.value));t!==void 0&&ne.push({termId:t,fragmentId:i,offsets:JSON.stringify(e.offsets)})}}for(let t of f(ne,b))await e.insert(s).values(t);let E=[];for(let e of p){let t=m.get(J(e.row.entityKey,e.row.docKey));if(t!==void 0)for(let[n,r]of Object.entries(e.facets))for(let e of r)E.push({docId:t,field:n,value:e})}for(let t of f(E,b))await e.insert(a).values(t);await y(e,[...r,...T.values()])}let S=e=>e===void 0?void 0:L(d.locale,[...e]);function C(e,t,n=50){return h.db.select({id:d.id,term:d.term}).from(d).where(j(e,S(t))).orderBy(P(d.docCount),M(d.term)).limit(n)}let w=(e,t)=>C(j(ae(d.term,e),oe(d.term,`${e}\uffff`)),t,_e(e));async function T(e,t){let n=re(e),r=e.codePointAt(0);if(n===0||r===void 0||r>=1114111)return[];let i=[...e].length,a=await h.db.select({id:d.id,term:d.term,docCount:d.docCount}).from(d).where(j(S(t),ae(d.term,String.fromCodePoint(r)),R(d.term,String.fromCodePoint(r+1)),N(U`length(${d.term})`,i-n,i+n))).orderBy(P(d.docCount),M(d.term)).limit(2e3),o=/* @__PURE__ */ new Map;for(let{id:e,term:t,docCount:n}of a){let r=o.get(t);r?(r.docCount+=n,r.ids.push(e)):o.set(t,{term:t,docCount:n,ids:[e]})}let s=ie(e,[...o.values()]);return s===null?[]:(o.get(s)?.ids??[]).map(e=>({id:e,term:s}))}async function E(e,t,n){let r=e.length-1,i=(e,n)=>t.has(e)&&n!==r,a=(e,t)=>t===r||t>r-3&&e.length>=3,[o,s]=await Promise.all([h.db.select({id:d.id,term:d.term}).from(d).where(j(L(d.term,e),S(n))),Promise.all(e.map(async(e,t)=>!i(e,t)&&a(e,t)?w(e,n):[]))]);return Promise.all(e.map(async(e,t)=>{let c=o.filter(t=>t.term===e);if(i(e,t))return D(e,c,!0);let l=[...c,...s[t]??[]];if(l.length>0)return D(e,l);let u=await T(e,n),f=u[0]?.term;if(f!==void 0){let e=a(f,t)?await w(f,n):[];return D(f,[...u,...e])}let p=t===r&&e.length>=3?await C(U`instr(${d.term}, ${e}) > 0`,n):[];return D(e,p)}))}let D=(e,t,n=!1)=>({word:e,ids:[...new Set(t.map(e=>e.id))],terms:new Set(t.map(e=>e.term)),optional:n});function ue(e){let t=/* @__PURE__ */ new Set,n=[];for(let r of[...e].reverse())t.has(r.word)||(t.add(r.word),n.push(r));return n.reverse()}let q=()=>({hits:[],facetCounts:{}});function de(e,t){let n=Math.max(0,Math.trunc(e.offset??0));return{offset:n,end:Math.min(n+t,500)}}function fe(e){let t=e?.trim().toLowerCase();if(t)return e=>e.toLowerCase().startsWith(t)}let ge=e=>(e.filter??[]).filter(e=>e.values.length>0),Y=se(a,`carried`),X=(e,t)=>t.length===0?U`0`:I(h.db.select({one:U`1`}).from(Y).where(j(F(Y.docId,i.id),F(Y.field,e),L(Y.value,[...t]))));function we(e){if(e.locales===void 0)return;let t=L(i.locale,[...e.locales]),n=e.canonicalFallback;if(n===void 0)return t;let a=B(h.db.select({one:U`1`}).from(r).where(j(F(r.locale,n.locale),F(r.isFallback,!1),F(r.canonicalSlug,i.routeSlug)))),o=n.translatedPrefixes.length===0?void 0:H(I(h.db.select({one:U`1`}).from(r).where(F(r.slug,i.routeSlug))),j(...n.translatedPrefixes.map(e=>U`substr(${i.routeSlug}, 1, ${e.length+1}) <> ${`${e}/`}`)));return j(t,H(z(i.locale,``),j(a,o)))}function Q(e,r){let a=[we(e)],{candidates:o}=e;if(o!==void 0&&(r===void 0||o.lifted!==r)&&a.push(L(i.id,o.ids)),e.hidden!==void 0&&a.push(V(i.id,e.hidden)),e.teams!==void 0&&a.push(X(t,[...new Set(e.teams.map(e=>e.toLowerCase()))])),e.versions!==void 0){let t=B(h.db.select({one:U`1`}).from(Y).where(j(F(Y.docId,i.id),F(Y.field,n)))),r=[...new Set(e.versions)];a.push(r.length===0?t:H(t,X(n,r)))}for(let t of e.selections)t.field!==r&&a.push(X(t.field,t.values));return a}async function Te(e,t){let n=await h.db.select({id:i.id,titleTokens:i.titleTokens,textTokens:i.textTokens,pathTokens:i.pathTokens,httpPathTokens:i.httpPathTokens,groupKey:i.groupKey,entityKey:i.entityKey,docKey:i.docKey,pinned:(t===void 0?U`0`:U`${L(i.id,t)}`).as(`pinned`)}).from(i).where(j(...Q(e)));return new Map(n.map(({id:e,pinned:t,...n})=>[e,{...n,pinned:Number(t)===1}]))}async function Ee(e,t,n){return h.db.select({field:a.field,value:a.value,count:U`count(*)`}).from(i).crossJoin(a).where(j(F(a.docId,i.id),L(a.field,[...t]),...Q(e,n))).groupBy(a.field,a.value)}let $=(e,t)=>h.db.select({docId:a.docId}).from(a).where(j(F(a.field,e),L(a.value,[...t])));function De(e,r){let o=a.docId,s=[];if(e.locales!==void 0&&s.push(L(o,h.db.select({id:i.id}).from(i).where(we(e)))),e.teams!==void 0){let n=[...new Set(e.teams.map(e=>e.toLowerCase()))];s.push(n.length===0?U`0`:L(o,$(t,n)))}if(e.versions!==void 0){let t=V(o,h.db.select({docId:a.docId}).from(a).where(F(a.field,n))),r=[...new Set(e.versions)];s.push(r.length===0?t:H(t,L(o,$(n,r))))}for(let t of e.selections)t.field!==r&&s.push(L(o,$(t.field,t.values)));return s}async function Oe(e,t,n){return h.db.select({field:a.field,value:a.value,count:U`count(*)`}).from(a).where(j(L(a.field,[...t]),...De(e,n))).groupBy(a.field,a.value)}async function ke(e,t,n){let r=[...new Set(t)],i=r.filter(t=>e.candidates!==void 0&&e.candidates.lifted!==t),a=r.filter(e=>!i.includes(e)),o=new Set(e.selections.map(e=>e.field)),s=e=>{let t=e.filter(e=>!o.has(e));return[...t.length>0?[{fields:t,lift:void 0}]:[],...e.filter(e=>o.has(e)).map(e=>({fields:[e],lift:e}))]},c=(await Promise.all([...s(i).map(t=>Ee(e,t.fields,t.lift)),...s(a).map(t=>Oe(e,t.fields,t.lift))])).flat(),l=fe(n),u={};for(let e of r)u[e]=c.filter(t=>t.field===e&&(l===void 0||l(t.value))).map(e=>({value:e.value,count:Number(e.count)})).sort((e,t)=>t.count-e.count||(e.value<t.value?-1:1)).slice(0,ce.has(e)?void 0:25);return u}async function Ae(e){let t=/* @__PURE__ */ new Map;for(let n of f(e,b)){let e=await h.db.select().from(i).where(L(i.id,n));for(let n of e)t.set(n.id,n)}return t}async function je(e,t){let n=[];for(let r of f(e,b)){let e=await h.db.select({field:u.field,term:d.term,docId:u.docId,offsets:u.offsets}).from(u).innerJoin(d,F(d.id,u.termId)).where(j(L(u.termId,r),t===void 0?void 0:L(u.docId,t)));for(let t of e)n.push(t)}return n}function Me(e,t){let n=h.db.select({docId:u.docId,termId:u.termId}).from(u).where(j(L(u.termId,e),z(u.field,`path`))),r=h.db.select({docId:c.docId,termId:s.termId}).from(s).innerJoin(c,F(c.fragmentId,s.fragmentId)).where(L(s.termId,e)),i=W(n,r).as(`occurrences`),a=h.db.select({docId:i.docId}).from(i);if(t===void 0)return a;let o=U.join(t.map(e=>U`max(case when ${L(i.termId,[...e])} then 1 else 0 end)`),U` + `);return a.groupBy(i.docId).having(U`${o} = ${t.length}`)}async function Ne(e){let t=(e,t)=>{let n=h.db.select({docId:u.docId}).from(u).where(j(L(u.termId,[...t]),z(u.field,`path`))),r=h.db.select({docId:c.docId}).from(s).innerJoin(c,F(c.fragmentId,s.fragmentId)).where(L(s.termId,[...t])),i=W(n,r).as(`reached`);return h.db.select({word:U`${e}`.as(`word`),count:U`count(distinct ${i.docId})`.as(`count`)}).from(i)},n=e.flatMap((e,n)=>e.length===0?[]:[t(n,e)]),r=e.map(()=>0);if(n.length===0)return r;let i=n.length===1?await n[0]:await W(...n);for(let e of i)r[Number(e.word)]=Number(e.count);return r}async function Pe(e,t){let n=[];for(let r of f(e,b)){let e=await h.db.select({term:d.term,fragmentId:s.fragmentId,offsets:s.offsets,docId:c.docId}).from(s).innerJoin(d,F(d.id,s.termId)).innerJoin(c,F(c.fragmentId,s.fragmentId)).where(j(L(s.termId,r),t===void 0?void 0:L(U`+${c.docId}`,t)));for(let t of e)n.push(t)}return n}function Fe(e){let t=/* @__PURE__ */ new Map;return e.map(e=>{let n=`${e.docId}\u0000${e.fragmentId}`,r=t.get(n);r===void 0&&t.set(n,r=t.size);let i=r*1e6,a=JSON.parse(e.offsets).map(e=>i+e);return{term:e.term,docId:e.docId,offsets:JSON.stringify(a)}})}function Ie(e,t){let n=/* @__PURE__ */ new Map;for(let r of e){let e=n.get(r.docId);e||n.set(r.docId,e=/* @__PURE__ */ new Map);let i=e.get(r.fragmentId);i||(i={fragmentId:r.fragmentId,score:0,offsetGroups:[]},e.set(r.fragmentId,i));let a=JSON.parse(r.offsets);i.score+=a.length;for(let{word:e,terms:n}of t)n.has(r.term)&&i.offsetGroups.push([e.length,...k(e,r.term,a)])}let r=/* @__PURE__ */ new Map;for(let[e,t]of n){let n;for(let e of t.values())(n===void 0||e.score>n.score)&&(n=e);n&&r.set(e,{fragmentId:n.fragmentId,offsetGroups:n.offsetGroups})}return r}async function Le(e){let t=/* @__PURE__ */ new Map;for(let n of f([...new Set(e)],b)){let e=await h.db.select().from(l).where(L(l.id,n));for(let n of e)t.set(n.id,me(n))}return t}async function Re(e){let t=/* @__PURE__ */ new Map;if(e.size===0)return t;let n=await h.db.select({docId:c.docId,fragmentId:c.fragmentId,anchorTail:c.anchorTail,place:o.place,path:o.path,anchorPrefix:o.anchorPrefix}).from(c).innerJoin(o,F(o.id,c.parentId)).where(j(L(c.docId,[...e.keys()]),L(c.fragmentId,[...new Set([...e.values()].map(e=>e.fragmentId))])));for(let r of n)e.get(r.docId)?.fragmentId===r.fragmentId&&t.set(r.docId,{place:r.place,path:r.path,anchor:r.anchorPrefix+r.anchorTail});return t}async function ze(e){let[t]=await h.db.select({total:U`count(*)`,averageTitle:U`avg(${i.titleTokens})`,averageText:U`avg(${i.textTokens})`,averagePath:U`avg(nullif(${i.pathTokens}, 0))`,averageHttpPath:U`avg(nullif(${i.httpPathTokens}, 0))`}).from(i).where(e===void 0?void 0:L(i.locale,[...e]));return t}async function Be(e){let t=/* @__PURE__ */ new Set;for(let n=0;n<e.length;n++){let r=Math.min(e.length,n+10);for(let i=n+1;i<=r;i++)t.add(e.slice(n,i).join(` `))}let n=[...t],r=await h.db.selectDistinct({field:a.field}).from(a).where(j(L(a.field,[v,_]),L(a.value,n))),i=e=>r.some(t=>t.field===e),o=i(`redocly_hide`)?$(_,n):void 0;if(!i(`redocly_pin`))return o?{hidden:o}:{};let s=h.db.select({docId:a.docId}).from(a).where(j(F(a.field,v),L(a.value,n)));return o?{pinned:s,hidden:o}:{pinned:s}}async function Ve(e){return(await h.db.select({id:i.id}).from(i).where(j(...Q(e))).limit(1)).length>0}async function He(t,n,r,i){let{locales:a}=r,o=ue(t),s=o.filter(e=>!e.optional).map(e=>e.ids).filter(e=>e.length>0),c=[...new Set(s.flat())];if(c.length===0&&n.pinned===void 0)return q();let l=o.filter(e=>e.optional).flatMap(e=>e.ids),u=[.../* @__PURE__ */ new Set([...c,...l])],d=o.map(e=>e.word),f=new Set(o.filter(e=>e.optional).map(e=>e.word)),{pinned:p}=n,h=e=>p===void 0?e:U`(select doc_id from ${e} union select doc_id from ${p})`,g=e=>({locales:a,canonicalFallback:r.canonicalFallback,candidates:{ids:e},hidden:n.hidden,teams:r.teams,versions:r.versions,selections:ge(r)}),_=Me(c,s.length>0?s:void 0),v=Me(c),y=e=>ke(e,r.countFields??[],r.countValuePrefix),b=p!==void 0&&s.length>1?Ve(g(_)):void 0;if(r.countOnly){let[e,t]=await Promise.all([y(g(h(_))),b]),n=Object.values(e).every(e=>e.length===0);return c.length===0&&n?q():{hits:[],facetCounts:s.length>1&&!(t??!n)?await y(g(h(v))):e}}let x=Promise.all([ze(a),Ne(o.map(e=>e.ids))]),S=(e,t)=>{let n=h(e);return Promise.all([y(g(n)),Te(g(n),p),je(u,t?n:void 0),Pe(c,t?n:void 0)])},[C,w]=await Promise.all([S(_,!0),b]),[T,E,D,k]=C;!(w??E.size>0)&&s.length>1&&([T,E,D,k]=await S(v,l.length>0));let[A,re]=await x,ie=[...E].filter(([,e])=>e.pinned).map(([e])=>e);if(ie.length===0&&(E.size===0||D.length===0&&k.length===0))return c.length===0?q():{hits:[],facetCounts:T};let j=new Map(o.map((e,t)=>[e.word,re[t]??0])),M=new Set([...D,...k].map(e=>e.docId)),N=de(r,i),P=(e,t)=>({totalDocuments:A?.total??0,averageDocumentLength:t??0,getDocumentLength:t=>E.get(t)?.[e]??0}),F=/* @__PURE__ */ new Map;for(let e of D){let t=F.get(e.field);t?t.push(e):F.set(e.field,[e])}let I=e=>F.get(e)??[],ae=new ee({limit:M.size,fields:[{name:`title`,weight:K.title,lookup:O(I(`title`)),corpusStats:P(`titleTokens`,A?.averageTitle??null)},{name:`text`,weight:K.text,lookup:O(I(`text`)),corpusStats:P(`textTokens`,A?.averageText??null)},{name:`path`,weight:K.path,lookup:O(I(`path`)),corpusStats:P(`pathTokens`,A?.averagePath??null),countsTowardFrequency:!1},{name:`httpPath`,weight:K.httpPath,lookup:O(I(`httpPath`)),corpusStats:P(`httpPathTokens`,A?.averageHttpPath??null)},{name:le.name,weight:le.weight,lookup:O(Fe(k)),corpusStats:{totalDocuments:A?.total??0,averageDocumentLength:1,getDocumentLength:()=>1}}]}),L=/* @__PURE__ */ new Set,R=/* @__PURE__ */ new Map,oe=Ce(ae.search(d.join(` `),{optional:f,documentFrequencies:j,terms:new Map(o.map(e=>[e.word,e.terms]))}),ie).filter(e=>{let t=E.get(e.id);if(t===void 0)return!1;let n=J(t.entityKey,m(t.docKey));return L.has(n)?(t.groupKey!==null&&R.set(t.groupKey,(R.get(t.groupKey)??0)+1),!1):(L.add(n),!0)}),z=T[e];z!==void 0&&R.size>0&&(T[e]=z.map(({value:e,count:t})=>({value:e,count:t-(R.get(e)??0)})).filter(({count:e})=>e>0));let B=r.perGroup,V=/* @__PURE__ */ new Map,H=B===void 0?oe.slice(N.offset,N.end):oe.filter(e=>{let t=E.get(e.id)?.groupKey??null,n=V.get(t)??0;return V.set(t,n+1),n<B}),se=new Set(H.map(e=>e.id)),W=Ie(k.filter(e=>se.has(e.docId)),o),[ce,G,fe]=await Promise.all([Ae([...se]),Le([...W.values()].map(e=>e.fragmentId)),Re(W)]);return{hits:H.flatMap(e=>{let t=ce.get(e.id);if(!t)return[];let n=t=>e.fields.find(e=>e.name===t),r=e=>n(e)?.offsets,i={},a=Z(t.title,r(`title`)),o=xe(t.text,r(`text`)),s=be(t.extra?.path,t.title,r(`path`),a);a!==void 0&&(i.title=a),o!==void 0&&(i.text=o),s!==void 0&&(i.path=s);let c=Z(t.httpPath??``,r(`httpPath`));c?.includes(`<mark>`)&&(i.httpPath=c);let l=W.get(e.id),u=l?G.get(l.fragmentId):void 0,d=fe.get(e.id),p={...t,rank:e.rank,highlight:i};if(l===void 0||u===void 0||d===void 0)return[p];let m=ne(u,d,l.offsetGroups),h=u.description??``;return m.description=xe(h,te(u,l.offsetGroups))??ye(h,200),i.parameters=[m],[n(`title`)?.tokens.some(e=>!f.has(e))?p:{...p,parameterAnchor:d.anchor}]}),facetCounts:T}}async function Ue(e,t){let n=ge(e),[r]=n,o={locales:e.locales,canonicalFallback:e.canonicalFallback,candidates:r&&{ids:h.db.select({docId:a.docId}).from(a).where(j(F(a.field,r.field),L(a.value,[...r.values]))),lifted:r.field},teams:e.teams,versions:e.versions,selections:n},s=await ke(o,e.countFields??[],e.countValuePrefix),c=de(e,t);return e.countOnly||o.selections.length===0||c.end<=c.offset?{hits:[],facetCounts:s}:{hits:(await h.db.select().from(i).where(j(...Q(o))).orderBy(M(i.routeSlug),M(i.docKey)).limit(c.end-c.offset).offset(c.offset)).map(e=>Object.assign(e,{rank:0,highlight:{}})),facetCounts:s}}return{async replaceSourceDocuments(e,t){if(e.length===0)return;let n=e.map(pe);t?await x(t,n):await h.db.transaction(e=>x(e,n))},async removeSource(e){await h.db.transaction(async t=>{let n=await ve(t,[e]);await t.delete(i).where(F(i.entityKey,e)),await y(t,n)})},async query(e){let t=Math.min(Math.max(1,Math.trunc(e.limit)),500),n=g(e.q);if(n.length===0)return Ue(e,t);let r=A(n,e.stopwords),[i,a]=await Promise.all([E(n,r,e.locales),Be(n)]);return He(i,a,e,t)},async readDocuments(e={}){let t=[e.routeSlug===void 0?void 0:F(i.routeSlug,e.routeSlug),e.entityKey===void 0?void 0:F(i.entityKey,e.entityKey)].filter(e=>e!==void 0);return h.db.select().from(i).where(t.length>0?j(...t):void 0).orderBy(M(i.entityKey),M(i.docKey))}}}export{we as createPostingsSearchStore,Z as highlightOffsets,be as highlightPath,xe as highlightSnippet,Ce as pinFirst};