@scalar/api-reference 1.63.0 → 1.64.1

package/dist/helpers/id-routing.d.ts

@@ -24,17 +24,31 @@ export declare const getIdFromUrl: (url: string | URL, basePath: string | undefi
  * @param isMultiDocument - Whether the document is multi-document or single-document. Single-document documents will strip the document slug from the id
  */
 export declare const makeUrlFromId: (_id: string, basePath: string | undefined, isMultiDocument: boolean) => URL | undefined;
+/**
+ * Source data for a single webhook redirect: the raw event name, its method, and the current id.
+ *
+ * The current slug is read back off the id, so this layer does not need to know the (dot-keeping)
+ * slug rule — it only reproduces the legacy (dot-dropping) slug to match old bookmarks.
+ */
+export type WebhookRedirectSource = {
+    /** Raw webhook event name from the OpenAPI `webhooks` key, e.g. `account_holder.created`. */
+    name: string;
+    /** HTTP method of the webhook operation. */
+    method: string;
+    /** Current navigation id of the webhook, e.g. `default/webhook/POST/account-holder.created`. */
+    id: string;
+};
 /**
  * Rewrites navigation ids in a URL to their current form.
  *
  * The URL is reduced to its routing-agnostic id (see {@link locateIdCarriers}), each redirect rule
- * is applied in id-space (see {@link buildRedirects}), and the result is spliced back into the
- * original location. This handles hash, hash-base-path, and path routing uniformly, so a new
- * redirect only has to be added to the list once.
+ * is applied in id-space (see {@link buildRedirects} for models and {@link buildWebhookRedirects} for
+ * webhooks), and the result is spliced back into the original location. This handles hash,
+ * hash-base-path, and path routing uniformly, so a new redirect only has to be added to the list once.
  *
  * Returns the canonicalized URL when a rewrite happens, or null otherwise.
  */
-export declare const redirectUrl: (url: string | URL, modelsSectionSlug: string, documentSlug: string, isMultiDocument: boolean, basePath?: string) => URL | null;
+export declare const redirectUrl: (url: string | URL, modelsSectionSlug: string, documentSlug: string, isMultiDocument: boolean, basePath?: string, webhooks?: WebhookRedirectSource[]) => URL | null;
 /** Extracts the schema parameters from the id if they are present */
 export declare const getSchemaParamsFromId: (id: string) => {
     rawId: string;

package/dist/helpers/id-routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id-routing.d.ts","sourceRoot":"","sources":["../../src/helpers/id-routing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,WAEhD,CAAA;AAyCD,mEAAmE;AACnE,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,GAAG,GAAG,EAAE,YAAY,MAAM,GAAG,SAAS,WAMnF,CAAA;AACD,mEAAmE;AACnE,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,GAAG,GAAG,EAAE,UAAU,MAAM,EAAE,YAAY,MAAM,GAAG,SAAS,WAYrG,CAAA;AAED,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,GAAG,GAAG,EAAE,UAAU,MAAM,EAAE,YAAY,MAAM,GAAG,SAAS,WAW7G,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,GAAG,GAAG,EAAE,UAAU,MAAM,YAWvE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,GAAG,GAAG,EAAE,UAAU,MAAM,GAAG,SAAS,EAAE,YAAY,MAAM,GAAG,SAAS,WAQ3G,CAAA;AAmBD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,GAAG,SAAS,EAAE,iBAAiB,OAAO,oBAsBhG,CAAA;AAqKD;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,GAAG,GAAG,EACjB,mBAAmB,MAAM,EACzB,cAAc,MAAM,EACpB,iBAAiB,OAAO,EACxB,WAAW,MAAM,KAChB,GAAG,GAAG,IAyBR,CAAA;AAUD,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,GAAI,IAAI,MAAM,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CA2BjF,CAAA"}
+{"version":3,"file":"id-routing.d.ts","sourceRoot":"","sources":["../../src/helpers/id-routing.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,WAEhD,CAAA;AAyCD,mEAAmE;AACnE,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,GAAG,GAAG,EAAE,YAAY,MAAM,GAAG,SAAS,WAMnF,CAAA;AACD,mEAAmE;AACnE,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,GAAG,GAAG,EAAE,UAAU,MAAM,EAAE,YAAY,MAAM,GAAG,SAAS,WAYrG,CAAA;AAED,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,GAAG,GAAG,EAAE,UAAU,MAAM,EAAE,YAAY,MAAM,GAAG,SAAS,WAW7G,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,GAAG,GAAG,EAAE,UAAU,MAAM,YAWvE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,GAAG,GAAG,EAAE,UAAU,MAAM,GAAG,SAAS,EAAE,YAAY,MAAM,GAAG,SAAS,WAQ3G,CAAA;AAmBD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,GAAG,SAAS,EAAE,iBAAiB,OAAO,oBAsBhG,CAAA;AA6KD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IACd,gGAAgG;IAChG,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAqED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,GAAG,GAAG,EACjB,mBAAmB,MAAM,EACzB,cAAc,MAAM,EACpB,iBAAiB,OAAO,EACxB,WAAW,MAAM,EACjB,WAAU,qBAAqB,EAAO,KACrC,GAAG,GAAG,IA4BR,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,GAAI,IAAI,MAAM,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CA2BjF,CAAA"}

package/dist/helpers/id-routing.js

@@ -1,3 +1,4 @@
+import { slugify } from "@scalar/helpers/string/slugify";
 //#region src/helpers/id-routing.ts
 var sanitizeBasePath = (basePath) => {
 	return basePath.replace(/^\/+|\/+$/g, "");
@@ -172,23 +173,82 @@ var buildRedirects = ({ modelsSectionSlug, documentSlug, isMultiDocument }) => {
 	return redirects;
 };
 /**
+* Markers that separate an operation id from a schema path within an anchor id.
+* `responses` mirrors the request-body/parameter markers so response property
+* anchors (e.g. `operation.responses.200.name`) resolve back to the operation id.
+* Without it, deep links into responses cannot find their operation.
+*/
+var SCHEMA_PARAM_MARKERS = [
+	".body.",
+	".path.",
+	".query.",
+	".header.",
+	".responses."
+];
+/**
+* Builds redirect rules mapping each webhook's legacy dot-dropped slug to its current slug.
+*
+* Webhook ids used to slugify the event name with no options, which dropped dots
+* (`account_holder.created` -> `account-holdercreated`); the current id keeps them
+* (`account-holder.created`). That rewrite cannot be reversed generically, so we emit one exact rule
+* per webhook whose legacy slug differs from the current one. Each rule matches the invariant
+* `webhook/<METHOD>/<legacy-slug>` tail, so it applies regardless of the document/tag prefix in front
+* of it and preserves any sub-anchor after it. A sub-anchor is either a `/` segment or a dot-joined
+* schema property anchor (e.g. `.body.id`, see {@link SCHEMA_PARAM_MARKERS}); a dot followed by
+* anything else is not treated as a boundary, because the legacy slug never contains a dot while a
+* current webhook slug can, so such a URL belongs to a different webhook.
+*
+* Because the legacy slug is lossy, two things can make a redirect unsafe, and both are dropped so an
+* ambiguous link falls through to normal not-found handling instead of landing on the wrong webhook:
+* - the legacy slug is already another webhook's *current* slug (redirecting it would hijack a valid
+*   URL), or
+* - two webhooks collapse to the same legacy slug (the old bookmark is genuinely ambiguous).
+*/
+var buildWebhookRedirects = (webhooks) => {
+	const key = (method, slug) => `${method.toUpperCase()}/${slug}`;
+	const currentKeys = /* @__PURE__ */ new Set();
+	const legacyCounts = /* @__PURE__ */ new Map();
+	for (const { name, method, id } of webhooks) {
+		currentKeys.add(key(method, id.slice(id.lastIndexOf("/") + 1)));
+		const legacySlug = slugify(name);
+		if (legacySlug) {
+			const legacyKey = key(method, legacySlug);
+			legacyCounts.set(legacyKey, (legacyCounts.get(legacyKey) ?? 0) + 1);
+		}
+	}
+	const boundary = `(?=$|/|${SCHEMA_PARAM_MARKERS.map(escapeRegex).join("|")})`;
+	const redirects = [];
+	for (const { name, method, id } of webhooks) {
+		const upperMethod = method.toUpperCase();
+		const currentSlug = id.slice(id.lastIndexOf("/") + 1);
+		const legacySlug = slugify(name);
+		const legacyKey = key(method, legacySlug);
+		if (!legacySlug || legacySlug === currentSlug || currentKeys.has(legacyKey) || (legacyCounts.get(legacyKey) ?? 0) > 1) continue;
+		redirects.push({
+			match: new RegExp(`(^|/)webhook/${escapeRegex(upperMethod)}/${escapeRegex(legacySlug)}${boundary}`),
+			replace: (_match, prefix) => `${prefix}webhook/${upperMethod}/${currentSlug}`
+		});
+	}
+	return redirects;
+};
+/**
 * Rewrites navigation ids in a URL to their current form.
 *
 * The URL is reduced to its routing-agnostic id (see {@link locateIdCarriers}), each redirect rule
-* is applied in id-space (see {@link buildRedirects}), and the result is spliced back into the
-* original location. This handles hash, hash-base-path, and path routing uniformly, so a new
-* redirect only has to be added to the list once.
+* is applied in id-space (see {@link buildRedirects} for models and {@link buildWebhookRedirects} for
+* webhooks), and the result is spliced back into the original location. This handles hash,
+* hash-base-path, and path routing uniformly, so a new redirect only has to be added to the list once.
 *
 * Returns the canonicalized URL when a rewrite happens, or null otherwise.
 */
-var redirectUrl = (url, modelsSectionSlug, documentSlug, isMultiDocument, basePath) => {
+var redirectUrl = (url, modelsSectionSlug, documentSlug, isMultiDocument, basePath, webhooks = []) => {
 	if (!documentSlug) return null;
 	const target = new URL(typeof url === "string" ? url : url.toString());
-	const redirects = buildRedirects({
+	const redirects = [...buildRedirects({
 		modelsSectionSlug,
 		documentSlug,
 		isMultiDocument
-	});
+	}), ...buildWebhookRedirects(webhooks)];
 	let didRedirect = false;
 	for (const carrier of locateIdCarriers(target, basePath)) {
 		const rewritten = applyIdRedirects(carrier.value, redirects);
@@ -199,19 +259,6 @@ var redirectUrl = (url, modelsSectionSlug, documentSlug, isMultiDocument, basePa
 	}
 	return didRedirect ? target : null;
 };
-/**
-* Markers that separate an operation id from a schema path within an anchor id.
-* `responses` mirrors the request-body/parameter markers so response property
-* anchors (e.g. `operation.responses.200.name`) resolve back to the operation id.
-* Without it, deep links into responses cannot find their operation.
-*/
-var SCHEMA_PARAM_MARKERS = [
-	".body.",
-	".path.",
-	".query.",
-	".header.",
-	".responses."
-];
 /** Extracts the schema parameters from the id if they are present */
 var getSchemaParamsFromId = (id) => {
 	let markerIndex = -1;
@@ -229,6 +276,6 @@ var getSchemaParamsFromId = (id) => {
 	};
 };
 //#endregion
-export { getIdFromUrl, getSchemaParamsFromId, makeUrlFromId, matchesBasePath, redirectUrl };
+export { getIdFromHash, getIdFromHashBasePath, getIdFromPath, getIdFromUrl, getSchemaParamsFromId, makeUrlFromId, matchesBasePath, redirectUrl, sanitizeBasePath };
 
 //# sourceMappingURL=id-routing.js.map

package/dist/helpers/id-routing.js.map

@@ -1 +1 @@
-{"version":3,"file":"id-routing.js","names":[],"sources":["../../src/helpers/id-routing.ts"],"sourcesContent":["export const sanitizeBasePath = (basePath: string) => {\n  return basePath.replace(/^\\/+|\\/+$/g, '')\n}\n\nconst isHashBasePath = (basePath: string) => basePath.startsWith('#')\n\nconst sanitizeHashBasePath = (basePath: string) => {\n  return basePath.replace(/^#+/, '').replace(/\\/+$/g, '')\n}\n\nconst applySlugPrefix = (base: string, slugPrefix: string | undefined) => {\n  return slugPrefix ? `${slugPrefix}${base ? '/' : ''}${base}` : base\n}\n\nconst stripBasePathPrefix = (value: string, basePath: string) => {\n  if (value === basePath) {\n    return ''\n  }\n\n  if (value.startsWith(`${basePath}/`)) {\n    return value.slice(basePath.length + 1)\n  }\n\n  return null\n}\n\n/**\n * Builds the URL-encoded, slash-prefixed form of a sanitized base path.\n *\n * Each segment is encoded separately so the result matches how the browser stores\n * `location.pathname` (which encodes within segments but leaves the slashes between them).\n */\nconst encodeBasePath = (sanitized: string) => {\n  if (!sanitized) {\n    return ''\n  }\n\n  return `/${sanitized\n    .split('/')\n    .map((segment) => encodeURIComponent(segment))\n    .join('/')}`\n}\n\n/** Extracts an element id from the hash when using hash routing */\nexport const getIdFromHash = (location: string | URL, slugPrefix: string | undefined) => {\n  const url = typeof location === 'string' ? new URL(location) : location\n\n  const base = decodeURIComponent(url.hash.slice(1))\n\n  return applySlugPrefix(base, slugPrefix)\n}\n/** Extracts an element id from the path when using path routing */\nexport const getIdFromPath = (location: string | URL, basePath: string, slugPrefix: string | undefined) => {\n  const url = typeof location === 'string' ? new URL(location) : location\n  const basePathWithSlash = encodeBasePath(sanitizeBasePath(basePath))\n\n  // Extract the portion after the basePath\n  if (url.pathname.startsWith(basePathWithSlash)) {\n    const remainder = url.pathname.slice(basePathWithSlash.length)\n    const base = decodeURIComponent(remainder.startsWith('/') ? remainder.slice(1) : remainder)\n    return applySlugPrefix(base, slugPrefix)\n  }\n\n  return slugPrefix ?? ''\n}\n\n/** Extracts an element id from a hash-prefixed basePath */\nexport const getIdFromHashBasePath = (location: string | URL, basePath: string, slugPrefix: string | undefined) => {\n  const url = typeof location === 'string' ? new URL(location) : location\n  const hash = decodeURIComponent(url.hash.slice(1))\n  const sanitized = sanitizeHashBasePath(basePath)\n\n  const remainder = stripBasePathPrefix(hash, sanitized)\n  if (remainder !== null) {\n    return applySlugPrefix(remainder, slugPrefix)\n  }\n\n  return slugPrefix ?? ''\n}\n\n/** Determines whether a URL matches the provided basePath. */\nexport const matchesBasePath = (location: string | URL, basePath: string) => {\n  const url = typeof location === 'string' ? new URL(location) : location\n\n  if (isHashBasePath(basePath)) {\n    const hash = decodeURIComponent(url.hash)\n    return hash === basePath || hash.startsWith(`${basePath}/`)\n  }\n\n  const basePathWithSlash = encodeBasePath(sanitizeBasePath(basePath))\n\n  return url.pathname === basePathWithSlash || url.pathname.startsWith(`${basePathWithSlash}/`)\n}\n\n/**\n * Extracts a navigation id from a URL based on the routing type\n *\n * @param url - The URL to extract the id from\n * @param basePath - The base path used in path routing\n * @param slugPrefix - If the document slug is not expected in the URL then we must prefix it\n */\nexport const getIdFromUrl = (url: string | URL, basePath: string | undefined, slugPrefix: string | undefined) => {\n  if (typeof basePath !== 'string') {\n    return getIdFromHash(url, slugPrefix)\n  }\n\n  return isHashBasePath(basePath)\n    ? getIdFromHashBasePath(url, basePath, slugPrefix)\n    : getIdFromPath(url, basePath, slugPrefix)\n}\n\n/**\n * Strips the first segment from an id and preserves trailing slashes\n * Used in single-document mode where the document slug is not needed in the URL\n *\n * @param id - The full id to process\n * @returns The id with the first segment removed, preserving trailing slash if present\n */\nconst stripFirstSegment = (id: string): string => {\n  // For preserving trailing slash in the id\n  const hasTrailingSlash = id.endsWith('/')\n  const segments = id.split('/').filter(Boolean).slice(1)\n  const result = segments.join('/')\n\n  // Only preserve trailing slash if there's actual content\n  return hasTrailingSlash && result ? `${result}/` : result\n}\n\n/**\n * Generate a new URL and applies the ID to the path or hash\n * depending on the type of routing used\n *\n * @param id - The id to apply to the URL\n * @param basePath - The base path used in path routing\n * @param isMultiDocument - Whether the document is multi-document or single-document. Single-document documents will strip the document slug from the id\n */\nexport const makeUrlFromId = (_id: string, basePath: string | undefined, isMultiDocument: boolean) => {\n  if (typeof window === 'undefined') {\n    return undefined\n  }\n\n  /** When there is only 1 document we don't need to include the document name in the URL */\n  const id = isMultiDocument ? _id : stripFirstSegment(_id)\n  const url = new URL(window.location.href)\n\n  if (typeof basePath === 'string') {\n    if (isHashBasePath(basePath)) {\n      const base = sanitizeHashBasePath(basePath)\n      url.hash = [base, id].filter(Boolean).join('/')\n    } else {\n      const base = sanitizeBasePath(basePath)\n      url.pathname = `${base}/${id}`\n    }\n  } else {\n    url.hash = id\n  }\n\n  return url\n}\n\nconst escapeRegex = (value: string) => value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * A located navigation id: the decoded id plus a way to write a rewritten id back.\n */\ntype IdCarrier = {\n  /** The decoded navigation id with all routing chrome (`#`, base path) removed. */\n  value: string\n  /** Splices `next` back into the location this id came from, preserving the URL shape. */\n  write: (next: string) => void\n}\n\n/** Carrier for an id that lives in the bare hash fragment (`#<id>`). */\nconst bareHashCarrier = (url: URL): IdCarrier => ({\n  value: decodeURIComponent(url.hash.slice(1)),\n  write: (next) => {\n    url.hash = next\n  },\n})\n\n/**\n * Locates the navigation id inside a URL regardless of the routing mode.\n *\n * The id can live in three places — the bare hash, a hash base path (`#<base>/<id>`), or the\n * pathname after a path base path. Each carrier pairs the decoded id with a `write` callback, so\n * callers edit ids in id-space without re-deriving the routing chrome for each mode.\n *\n * Multiple carriers are returned: the canonical location for the active routing mode comes first,\n * followed by a legacy bare-hash carrier. Both path and hash-base-path routing include the bare hash\n * so a stale `#default/model/User` bookmark (left over from before the base path was configured) is\n * still canonicalized — the previous implementation rewrote such doc-slug-anchored hashes on every\n * load regardless of the routing mode. Callers rewrite every carrier that matches, not just the\n * first, so a legacy id sitting in both the pathname and the hash is cleaned up in one pass.\n */\nconst locateIdCarriers = (url: URL, basePath: string | undefined): IdCarrier[] => {\n  // Hash routing: the id is the bare fragment.\n  if (typeof basePath !== 'string') {\n    return [bareHashCarrier(url)]\n  }\n\n  // Hash base path routing: the id follows a `#<base>/` prefix.\n  if (isHashBasePath(basePath)) {\n    const base = sanitizeHashBasePath(basePath)\n    const hash = decodeURIComponent(url.hash.slice(1))\n\n    return [\n      {\n        value: stripBasePathPrefix(hash, base) ?? '',\n        write: (next) => {\n          url.hash = [base, next].filter(Boolean).join('/')\n        },\n      },\n      // Legacy fallback: an old bookmark may carry the id in the fragment without the base prefix.\n      bareHashCarrier(url),\n    ]\n  }\n\n  // Path routing: the id follows the (URL-encoded) base path in the pathname.\n  const base = sanitizeBasePath(basePath)\n  const remainder = stripBasePathPrefix(url.pathname, encodeBasePath(base))\n\n  return [\n    {\n      value: remainder === null ? '' : decodeURIComponent(remainder),\n      write: (next) => {\n        // Assigning to `pathname` re-encodes characters, so we splice with the decoded base.\n        url.pathname = base ? `/${base}/${next}` : `/${next}`\n      },\n    },\n    // Legacy fallback: an old hash-routing bookmark may still carry the id in the fragment.\n    bareHashCarrier(url),\n  ]\n}\n\n/**\n * A single redirect rule, expressed in routing-agnostic id-space.\n *\n * Ids are navigation strings with all routing chrome (`#`, base path) stripped — see\n * {@link locateIdCarrier}. A rule is just the shape of an id rewrite: `match` is tested against the\n * id and `replace` follows the native `String.prototype.replace` contract, so a rule can be a plain\n * segment swap or an arbitrary replacer function. A rule that does not match leaves the id alone.\n */\ntype IdRedirect = {\n  /** Pattern tested against the routing-agnostic id. */\n  match: RegExp\n  /** Replacement passed straight to `String.prototype.replace` (template string or replacer fn). */\n  replace: string | ((substring: string, ...groups: string[]) => string)\n}\n\n/**\n * Applies redirect rules to an id and returns the first rewrite that changes it.\n *\n * Rules are tried in order and the search stops at the first match, so list more specific rules\n * before more general ones. Returns the id unchanged when no rule applies.\n */\nconst applyIdRedirects = (id: string, redirects: IdRedirect[]): string => {\n  for (const { match, replace } of redirects) {\n    // The ternary narrows the union so each `String.prototype.replace` overload type-checks.\n    const next = typeof replace === 'string' ? id.replace(match, replace) : id.replace(match, replace)\n    if (next !== id) {\n      return next\n    }\n  }\n\n  return id\n}\n\n/** Optional `(tag-group/<n>/)?tag/<slug>/` chrome that may sit in front of a section segment. */\nconst TAG_CHROME = '(?:(?:tag-group/[^/]+/)?tag/[^/]+/)?'\n\n/**\n * Runtime values the redirect rules are built from.\n *\n * The rules are data, but a few entries depend on per-document values (the configurable models\n * section slug, the active document slug, single- vs multi-document mode), so the list is built per\n * call rather than declared as a static constant.\n */\ntype RedirectContext = {\n  /** Current (possibly customized) slug of the models section, e.g. `models` or `schemas`. */\n  modelsSectionSlug: string\n  /** Slug of the active document; legacy ids are anchored to it to avoid false positives. */\n  documentSlug: string\n  /** Multi-document ids always carry the doc slug; single-document bookmarks may omit it. */\n  isMultiDocument: boolean\n}\n\n/**\n * Builds the list of id redirects for the current document.\n *\n * Add an entry here to support a new redirect. Each rule runs against every URL shape (hash, hash\n * base path, path) for free, because rules operate on routing-agnostic ids.\n */\nconst buildRedirects = ({ modelsSectionSlug, documentSlug, isMultiDocument }: RedirectContext): IdRedirect[] => {\n  const escapedDoc = escapeRegex(documentSlug)\n  // Keeping the tag chrome inside the doc-slug group is deliberate: a slug-less\n  // `tag/<slug>/<segment>/<name>` is left alone, since once the document slug is stripped it is\n  // ambiguous with an operation under a tag literally named after the segment.\n  const documentPrefix = isMultiDocument ? `${escapedDoc}/${TAG_CHROME}` : `(?:${escapedDoc}/${TAG_CHROME})?`\n\n  // Rewrites a leading `<from>/` section segment to the current models section slug. The trailing\n  // `/` leaves an already-correct segment and operation paths such as `default/POST/model/train`\n  // untouched.\n  const renameSectionSegment = (from: string): IdRedirect => ({\n    match: new RegExp(`^(${documentPrefix})${escapeRegex(from)}/`),\n    replace: (_match, prefix) => `${prefix}${modelsSectionSlug}/`,\n  })\n\n  const redirects = [\n    // Earlier versions hardcoded a singular `model/` prefix for individual schema entries even\n    // though the section itself was plural, so old bookmarks like `default/model/User` would 404.\n    renameSectionSegment('model'),\n  ]\n\n  // The models section used to live at the literal `models/`. Once a custom label moves it\n  // elsewhere (e.g. `schemas/`), older `models/<name>` bookmarks must follow it. When the slug is\n  // still the default `models` this would be a no-op, so only register it when it actually differs.\n  if (modelsSectionSlug !== 'models') {\n    redirects.push(renameSectionSegment('models'))\n  }\n\n  return redirects\n}\n\n/**\n * Rewrites navigation ids in a URL to their current form.\n *\n * The URL is reduced to its routing-agnostic id (see {@link locateIdCarriers}), each redirect rule\n * is applied in id-space (see {@link buildRedirects}), and the result is spliced back into the\n * original location. This handles hash, hash-base-path, and path routing uniformly, so a new\n * redirect only has to be added to the list once.\n *\n * Returns the canonicalized URL when a rewrite happens, or null otherwise.\n */\nexport const redirectUrl = (\n  url: string | URL,\n  modelsSectionSlug: string,\n  documentSlug: string,\n  isMultiDocument: boolean,\n  basePath?: string,\n): URL | null => {\n  if (!documentSlug) {\n    return null\n  }\n\n  const target = new URL(typeof url === 'string' ? url : url.toString())\n  const redirects = buildRedirects({ modelsSectionSlug, documentSlug, isMultiDocument })\n\n  // Canonicalize every place the id might live. The carriers are distinct physical locations (the\n  // pathname and the bare hash), so a single page load can carry a legacy id in more than one — for\n  // example a path-routing URL whose stale hash still holds an old bookmark. Rewriting all of them\n  // avoids the address bar showing a corrected path next to an outdated hash. A redirect rule is\n  // anchored to the document slug, so it never matches the base-prefixed value of a fallback carrier,\n  // which keeps carriers that happen to share a location (hash base path + bare hash) from clobbering\n  // each other.\n  let didRedirect = false\n  for (const carrier of locateIdCarriers(target, basePath)) {\n    const rewritten = applyIdRedirects(carrier.value, redirects)\n    if (rewritten !== carrier.value) {\n      carrier.write(rewritten)\n      didRedirect = true\n    }\n  }\n\n  return didRedirect ? target : null\n}\n\n/**\n * Markers that separate an operation id from a schema path within an anchor id.\n * `responses` mirrors the request-body/parameter markers so response property\n * anchors (e.g. `operation.responses.200.name`) resolve back to the operation id.\n * Without it, deep links into responses cannot find their operation.\n */\nconst SCHEMA_PARAM_MARKERS = ['.body.', '.path.', '.query.', '.header.', '.responses.']\n\n/** Extracts the schema parameters from the id if they are present */\nexport const getSchemaParamsFromId = (id: string): { rawId: string; params: string } => {\n  // Split at the first marker: an operation id never contains one, so everything\n  // before the first marker is the operation id and the rest is the schema path.\n  // (Splitting at the last marker would mishandle a property named like a marker\n  // keyword, e.g. a request body field called `responses`.) A plain string scan\n  // avoids the polynomial backtracking a `(.*)marker(.*)` regex would incur on\n  // long, marker-less ids.\n  let markerIndex = -1\n  for (const marker of SCHEMA_PARAM_MARKERS) {\n    const index = id.indexOf(marker)\n    if (index !== -1 && (markerIndex === -1 || index < markerIndex)) {\n      markerIndex = index\n    }\n  }\n\n  if (markerIndex === -1) {\n    return {\n      rawId: id,\n      params: '',\n    }\n  }\n\n  return {\n    rawId: id.slice(0, markerIndex),\n    // Drop the leading dot but keep the marker keyword (e.g. `body.name`).\n    params: id.slice(markerIndex + 1),\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"id-routing.js","names":[],"sources":["../../src/helpers/id-routing.ts"],"sourcesContent":["import { slugify } from '@scalar/helpers/string/slugify'\n\nexport const sanitizeBasePath = (basePath: string) => {\n  return basePath.replace(/^\\/+|\\/+$/g, '')\n}\n\nconst isHashBasePath = (basePath: string) => basePath.startsWith('#')\n\nconst sanitizeHashBasePath = (basePath: string) => {\n  return basePath.replace(/^#+/, '').replace(/\\/+$/g, '')\n}\n\nconst applySlugPrefix = (base: string, slugPrefix: string | undefined) => {\n  return slugPrefix ? `${slugPrefix}${base ? '/' : ''}${base}` : base\n}\n\nconst stripBasePathPrefix = (value: string, basePath: string) => {\n  if (value === basePath) {\n    return ''\n  }\n\n  if (value.startsWith(`${basePath}/`)) {\n    return value.slice(basePath.length + 1)\n  }\n\n  return null\n}\n\n/**\n * Builds the URL-encoded, slash-prefixed form of a sanitized base path.\n *\n * Each segment is encoded separately so the result matches how the browser stores\n * `location.pathname` (which encodes within segments but leaves the slashes between them).\n */\nconst encodeBasePath = (sanitized: string) => {\n  if (!sanitized) {\n    return ''\n  }\n\n  return `/${sanitized\n    .split('/')\n    .map((segment) => encodeURIComponent(segment))\n    .join('/')}`\n}\n\n/** Extracts an element id from the hash when using hash routing */\nexport const getIdFromHash = (location: string | URL, slugPrefix: string | undefined) => {\n  const url = typeof location === 'string' ? new URL(location) : location\n\n  const base = decodeURIComponent(url.hash.slice(1))\n\n  return applySlugPrefix(base, slugPrefix)\n}\n/** Extracts an element id from the path when using path routing */\nexport const getIdFromPath = (location: string | URL, basePath: string, slugPrefix: string | undefined) => {\n  const url = typeof location === 'string' ? new URL(location) : location\n  const basePathWithSlash = encodeBasePath(sanitizeBasePath(basePath))\n\n  // Extract the portion after the basePath\n  if (url.pathname.startsWith(basePathWithSlash)) {\n    const remainder = url.pathname.slice(basePathWithSlash.length)\n    const base = decodeURIComponent(remainder.startsWith('/') ? remainder.slice(1) : remainder)\n    return applySlugPrefix(base, slugPrefix)\n  }\n\n  return slugPrefix ?? ''\n}\n\n/** Extracts an element id from a hash-prefixed basePath */\nexport const getIdFromHashBasePath = (location: string | URL, basePath: string, slugPrefix: string | undefined) => {\n  const url = typeof location === 'string' ? new URL(location) : location\n  const hash = decodeURIComponent(url.hash.slice(1))\n  const sanitized = sanitizeHashBasePath(basePath)\n\n  const remainder = stripBasePathPrefix(hash, sanitized)\n  if (remainder !== null) {\n    return applySlugPrefix(remainder, slugPrefix)\n  }\n\n  return slugPrefix ?? ''\n}\n\n/** Determines whether a URL matches the provided basePath. */\nexport const matchesBasePath = (location: string | URL, basePath: string) => {\n  const url = typeof location === 'string' ? new URL(location) : location\n\n  if (isHashBasePath(basePath)) {\n    const hash = decodeURIComponent(url.hash)\n    return hash === basePath || hash.startsWith(`${basePath}/`)\n  }\n\n  const basePathWithSlash = encodeBasePath(sanitizeBasePath(basePath))\n\n  return url.pathname === basePathWithSlash || url.pathname.startsWith(`${basePathWithSlash}/`)\n}\n\n/**\n * Extracts a navigation id from a URL based on the routing type\n *\n * @param url - The URL to extract the id from\n * @param basePath - The base path used in path routing\n * @param slugPrefix - If the document slug is not expected in the URL then we must prefix it\n */\nexport const getIdFromUrl = (url: string | URL, basePath: string | undefined, slugPrefix: string | undefined) => {\n  if (typeof basePath !== 'string') {\n    return getIdFromHash(url, slugPrefix)\n  }\n\n  return isHashBasePath(basePath)\n    ? getIdFromHashBasePath(url, basePath, slugPrefix)\n    : getIdFromPath(url, basePath, slugPrefix)\n}\n\n/**\n * Strips the first segment from an id and preserves trailing slashes\n * Used in single-document mode where the document slug is not needed in the URL\n *\n * @param id - The full id to process\n * @returns The id with the first segment removed, preserving trailing slash if present\n */\nconst stripFirstSegment = (id: string): string => {\n  // For preserving trailing slash in the id\n  const hasTrailingSlash = id.endsWith('/')\n  const segments = id.split('/').filter(Boolean).slice(1)\n  const result = segments.join('/')\n\n  // Only preserve trailing slash if there's actual content\n  return hasTrailingSlash && result ? `${result}/` : result\n}\n\n/**\n * Generate a new URL and applies the ID to the path or hash\n * depending on the type of routing used\n *\n * @param id - The id to apply to the URL\n * @param basePath - The base path used in path routing\n * @param isMultiDocument - Whether the document is multi-document or single-document. Single-document documents will strip the document slug from the id\n */\nexport const makeUrlFromId = (_id: string, basePath: string | undefined, isMultiDocument: boolean) => {\n  if (typeof window === 'undefined') {\n    return undefined\n  }\n\n  /** When there is only 1 document we don't need to include the document name in the URL */\n  const id = isMultiDocument ? _id : stripFirstSegment(_id)\n  const url = new URL(window.location.href)\n\n  if (typeof basePath === 'string') {\n    if (isHashBasePath(basePath)) {\n      const base = sanitizeHashBasePath(basePath)\n      url.hash = [base, id].filter(Boolean).join('/')\n    } else {\n      const base = sanitizeBasePath(basePath)\n      url.pathname = `${base}/${id}`\n    }\n  } else {\n    url.hash = id\n  }\n\n  return url\n}\n\nconst escapeRegex = (value: string) => value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * A located navigation id: the decoded id plus a way to write a rewritten id back.\n */\ntype IdCarrier = {\n  /** The decoded navigation id with all routing chrome (`#`, base path) removed. */\n  value: string\n  /** Splices `next` back into the location this id came from, preserving the URL shape. */\n  write: (next: string) => void\n}\n\n/** Carrier for an id that lives in the bare hash fragment (`#<id>`). */\nconst bareHashCarrier = (url: URL): IdCarrier => ({\n  value: decodeURIComponent(url.hash.slice(1)),\n  write: (next) => {\n    url.hash = next\n  },\n})\n\n/**\n * Locates the navigation id inside a URL regardless of the routing mode.\n *\n * The id can live in three places — the bare hash, a hash base path (`#<base>/<id>`), or the\n * pathname after a path base path. Each carrier pairs the decoded id with a `write` callback, so\n * callers edit ids in id-space without re-deriving the routing chrome for each mode.\n *\n * Multiple carriers are returned: the canonical location for the active routing mode comes first,\n * followed by a legacy bare-hash carrier. Both path and hash-base-path routing include the bare hash\n * so a stale `#default/model/User` bookmark (left over from before the base path was configured) is\n * still canonicalized — the previous implementation rewrote such doc-slug-anchored hashes on every\n * load regardless of the routing mode. Callers rewrite every carrier that matches, not just the\n * first, so a legacy id sitting in both the pathname and the hash is cleaned up in one pass.\n */\nconst locateIdCarriers = (url: URL, basePath: string | undefined): IdCarrier[] => {\n  // Hash routing: the id is the bare fragment.\n  if (typeof basePath !== 'string') {\n    return [bareHashCarrier(url)]\n  }\n\n  // Hash base path routing: the id follows a `#<base>/` prefix.\n  if (isHashBasePath(basePath)) {\n    const base = sanitizeHashBasePath(basePath)\n    const hash = decodeURIComponent(url.hash.slice(1))\n\n    return [\n      {\n        value: stripBasePathPrefix(hash, base) ?? '',\n        write: (next) => {\n          url.hash = [base, next].filter(Boolean).join('/')\n        },\n      },\n      // Legacy fallback: an old bookmark may carry the id in the fragment without the base prefix.\n      bareHashCarrier(url),\n    ]\n  }\n\n  // Path routing: the id follows the (URL-encoded) base path in the pathname.\n  const base = sanitizeBasePath(basePath)\n  const remainder = stripBasePathPrefix(url.pathname, encodeBasePath(base))\n\n  return [\n    {\n      value: remainder === null ? '' : decodeURIComponent(remainder),\n      write: (next) => {\n        // Assigning to `pathname` re-encodes characters, so we splice with the decoded base.\n        url.pathname = base ? `/${base}/${next}` : `/${next}`\n      },\n    },\n    // Legacy fallback: an old hash-routing bookmark may still carry the id in the fragment.\n    bareHashCarrier(url),\n  ]\n}\n\n/**\n * A single redirect rule, expressed in routing-agnostic id-space.\n *\n * Ids are navigation strings with all routing chrome (`#`, base path) stripped — see\n * {@link locateIdCarrier}. A rule is just the shape of an id rewrite: `match` is tested against the\n * id and `replace` follows the native `String.prototype.replace` contract, so a rule can be a plain\n * segment swap or an arbitrary replacer function. A rule that does not match leaves the id alone.\n */\ntype IdRedirect = {\n  /** Pattern tested against the routing-agnostic id. */\n  match: RegExp\n  /** Replacement passed straight to `String.prototype.replace` (template string or replacer fn). */\n  replace: string | ((substring: string, ...groups: string[]) => string)\n}\n\n/**\n * Applies redirect rules to an id and returns the first rewrite that changes it.\n *\n * Rules are tried in order and the search stops at the first match, so list more specific rules\n * before more general ones. Returns the id unchanged when no rule applies.\n */\nconst applyIdRedirects = (id: string, redirects: IdRedirect[]): string => {\n  for (const { match, replace } of redirects) {\n    // The ternary narrows the union so each `String.prototype.replace` overload type-checks.\n    const next = typeof replace === 'string' ? id.replace(match, replace) : id.replace(match, replace)\n    if (next !== id) {\n      return next\n    }\n  }\n\n  return id\n}\n\n/** Optional `(tag-group/<n>/)?tag/<slug>/` chrome that may sit in front of a section segment. */\nconst TAG_CHROME = '(?:(?:tag-group/[^/]+/)?tag/[^/]+/)?'\n\n/**\n * Runtime values the redirect rules are built from.\n *\n * The rules are data, but a few entries depend on per-document values (the configurable models\n * section slug, the active document slug, single- vs multi-document mode), so the list is built per\n * call rather than declared as a static constant.\n */\ntype RedirectContext = {\n  /** Current (possibly customized) slug of the models section, e.g. `models` or `schemas`. */\n  modelsSectionSlug: string\n  /** Slug of the active document; legacy ids are anchored to it to avoid false positives. */\n  documentSlug: string\n  /** Multi-document ids always carry the doc slug; single-document bookmarks may omit it. */\n  isMultiDocument: boolean\n}\n\n/**\n * Builds the list of id redirects for the current document.\n *\n * Add an entry here to support a new redirect. Each rule runs against every URL shape (hash, hash\n * base path, path) for free, because rules operate on routing-agnostic ids.\n */\nconst buildRedirects = ({ modelsSectionSlug, documentSlug, isMultiDocument }: RedirectContext): IdRedirect[] => {\n  const escapedDoc = escapeRegex(documentSlug)\n  // Keeping the tag chrome inside the doc-slug group is deliberate: a slug-less\n  // `tag/<slug>/<segment>/<name>` is left alone, since once the document slug is stripped it is\n  // ambiguous with an operation under a tag literally named after the segment.\n  const documentPrefix = isMultiDocument ? `${escapedDoc}/${TAG_CHROME}` : `(?:${escapedDoc}/${TAG_CHROME})?`\n\n  // Rewrites a leading `<from>/` section segment to the current models section slug. The trailing\n  // `/` leaves an already-correct segment and operation paths such as `default/POST/model/train`\n  // untouched.\n  const renameSectionSegment = (from: string): IdRedirect => ({\n    match: new RegExp(`^(${documentPrefix})${escapeRegex(from)}/`),\n    replace: (_match, prefix) => `${prefix}${modelsSectionSlug}/`,\n  })\n\n  const redirects = [\n    // Earlier versions hardcoded a singular `model/` prefix for individual schema entries even\n    // though the section itself was plural, so old bookmarks like `default/model/User` would 404.\n    renameSectionSegment('model'),\n  ]\n\n  // The models section used to live at the literal `models/`. Once a custom label moves it\n  // elsewhere (e.g. `schemas/`), older `models/<name>` bookmarks must follow it. When the slug is\n  // still the default `models` this would be a no-op, so only register it when it actually differs.\n  if (modelsSectionSlug !== 'models') {\n    redirects.push(renameSectionSegment('models'))\n  }\n\n  return redirects\n}\n\n/**\n * Markers that separate an operation id from a schema path within an anchor id.\n * `responses` mirrors the request-body/parameter markers so response property\n * anchors (e.g. `operation.responses.200.name`) resolve back to the operation id.\n * Without it, deep links into responses cannot find their operation.\n */\nconst SCHEMA_PARAM_MARKERS = ['.body.', '.path.', '.query.', '.header.', '.responses.']\n\n/**\n * Source data for a single webhook redirect: the raw event name, its method, and the current id.\n *\n * The current slug is read back off the id, so this layer does not need to know the (dot-keeping)\n * slug rule — it only reproduces the legacy (dot-dropping) slug to match old bookmarks.\n */\nexport type WebhookRedirectSource = {\n  /** Raw webhook event name from the OpenAPI `webhooks` key, e.g. `account_holder.created`. */\n  name: string\n  /** HTTP method of the webhook operation. */\n  method: string\n  /** Current navigation id of the webhook, e.g. `default/webhook/POST/account-holder.created`. */\n  id: string\n}\n\n/**\n * Builds redirect rules mapping each webhook's legacy dot-dropped slug to its current slug.\n *\n * Webhook ids used to slugify the event name with no options, which dropped dots\n * (`account_holder.created` -> `account-holdercreated`); the current id keeps them\n * (`account-holder.created`). That rewrite cannot be reversed generically, so we emit one exact rule\n * per webhook whose legacy slug differs from the current one. Each rule matches the invariant\n * `webhook/<METHOD>/<legacy-slug>` tail, so it applies regardless of the document/tag prefix in front\n * of it and preserves any sub-anchor after it. A sub-anchor is either a `/` segment or a dot-joined\n * schema property anchor (e.g. `.body.id`, see {@link SCHEMA_PARAM_MARKERS}); a dot followed by\n * anything else is not treated as a boundary, because the legacy slug never contains a dot while a\n * current webhook slug can, so such a URL belongs to a different webhook.\n *\n * Because the legacy slug is lossy, two things can make a redirect unsafe, and both are dropped so an\n * ambiguous link falls through to normal not-found handling instead of landing on the wrong webhook:\n * - the legacy slug is already another webhook's *current* slug (redirecting it would hijack a valid\n *   URL), or\n * - two webhooks collapse to the same legacy slug (the old bookmark is genuinely ambiguous).\n */\nconst buildWebhookRedirects = (webhooks: WebhookRedirectSource[]): IdRedirect[] => {\n  const key = (method: string, slug: string) => `${method.toUpperCase()}/${slug}`\n\n  // Index current slugs so a legacy redirect never clobbers a real, current URL, and count legacy\n  // slugs so we can drop the ones two webhooks share.\n  const currentKeys = new Set<string>()\n  const legacyCounts = new Map<string, number>()\n  for (const { name, method, id } of webhooks) {\n    currentKeys.add(key(method, id.slice(id.lastIndexOf('/') + 1)))\n    const legacySlug = slugify(name)\n    if (legacySlug) {\n      const legacyKey = key(method, legacySlug)\n      legacyCounts.set(legacyKey, (legacyCounts.get(legacyKey) ?? 0) + 1)\n    }\n  }\n\n  // Property deep links append their breadcrumb to the operation id with dots\n  // (`<slug>.body.id`), so the slug boundary must accept a schema-param marker\n  // alongside the end of the id and a `/` segment.\n  const boundary = `(?=$|/|${SCHEMA_PARAM_MARKERS.map(escapeRegex).join('|')})`\n\n  const redirects: IdRedirect[] = []\n  for (const { name, method, id } of webhooks) {\n    const upperMethod = method.toUpperCase()\n    const currentSlug = id.slice(id.lastIndexOf('/') + 1)\n    const legacySlug = slugify(name)\n    const legacyKey = key(method, legacySlug)\n\n    // Skip when the slug did not change, when the legacy slug is a real current URL, or when it is\n    // shared by more than one webhook.\n    if (\n      !legacySlug ||\n      legacySlug === currentSlug ||\n      currentKeys.has(legacyKey) ||\n      (legacyCounts.get(legacyKey) ?? 0) > 1\n    ) {\n      continue\n    }\n\n    redirects.push({\n      match: new RegExp(`(^|/)webhook/${escapeRegex(upperMethod)}/${escapeRegex(legacySlug)}${boundary}`),\n      replace: (_match, prefix) => `${prefix}webhook/${upperMethod}/${currentSlug}`,\n    })\n  }\n\n  return redirects\n}\n\n/**\n * Rewrites navigation ids in a URL to their current form.\n *\n * The URL is reduced to its routing-agnostic id (see {@link locateIdCarriers}), each redirect rule\n * is applied in id-space (see {@link buildRedirects} for models and {@link buildWebhookRedirects} for\n * webhooks), and the result is spliced back into the original location. This handles hash,\n * hash-base-path, and path routing uniformly, so a new redirect only has to be added to the list once.\n *\n * Returns the canonicalized URL when a rewrite happens, or null otherwise.\n */\nexport const redirectUrl = (\n  url: string | URL,\n  modelsSectionSlug: string,\n  documentSlug: string,\n  isMultiDocument: boolean,\n  basePath?: string,\n  webhooks: WebhookRedirectSource[] = [],\n): URL | null => {\n  if (!documentSlug) {\n    return null\n  }\n\n  const target = new URL(typeof url === 'string' ? url : url.toString())\n  const redirects = [\n    ...buildRedirects({ modelsSectionSlug, documentSlug, isMultiDocument }),\n    ...buildWebhookRedirects(webhooks),\n  ]\n\n  // Canonicalize every place the id might live. The carriers are distinct physical locations (the\n  // pathname and the bare hash), so a single page load can carry a legacy id in more than one — for\n  // example a path-routing URL whose stale hash still holds an old bookmark. Rewriting all of them\n  // avoids the address bar showing a corrected path next to an outdated hash. A redirect rule is\n  // anchored to the document slug, so it never matches the base-prefixed value of a fallback carrier,\n  // which keeps carriers that happen to share a location (hash base path + bare hash) from clobbering\n  // each other.\n  let didRedirect = false\n  for (const carrier of locateIdCarriers(target, basePath)) {\n    const rewritten = applyIdRedirects(carrier.value, redirects)\n    if (rewritten !== carrier.value) {\n      carrier.write(rewritten)\n      didRedirect = true\n    }\n  }\n\n  return didRedirect ? target : null\n}\n\n/** Extracts the schema parameters from the id if they are present */\nexport const getSchemaParamsFromId = (id: string): { rawId: string; params: string } => {\n  // Split at the first marker: an operation id never contains one, so everything\n  // before the first marker is the operation id and the rest is the schema path.\n  // (Splitting at the last marker would mishandle a property named like a marker\n  // keyword, e.g. a request body field called `responses`.) A plain string scan\n  // avoids the polynomial backtracking a `(.*)marker(.*)` regex would incur on\n  // long, marker-less ids.\n  let markerIndex = -1\n  for (const marker of SCHEMA_PARAM_MARKERS) {\n    const index = id.indexOf(marker)\n    if (index !== -1 && (markerIndex === -1 || index < markerIndex)) {\n      markerIndex = index\n    }\n  }\n\n  if (markerIndex === -1) {\n    return {\n      rawId: id,\n      params: '',\n    }\n  }\n\n  return {\n    rawId: id.slice(0, markerIndex),\n    // Drop the leading dot but keep the marker keyword (e.g. `body.name`).\n    params: id.slice(markerIndex + 1),\n  }\n}\n"],"mappings":"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"}

package/dist/helpers/is-introduction-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-introduction-entry.js","names":[],"sources":["../../src/helpers/is-introduction-entry.ts"],"sourcesContent":["/**\n * The auto-generated \"Introduction\" navigation entry always uses the `introduction` slug, so its id\n * ends with this suffix regardless of the active locale or the displayed title.\n */\nexport const INTRODUCTION_ENTRY_ID_SUFFIX = '/description/introduction'\n\n/**\n * Whether a navigation entry is the auto-generated introduction section.\n *\n * We match on the stable entry id instead of the English title so localization does not accidentally\n * rewrite unrelated description headings that happen to be called \"Introduction\".\n */\nexport const isIntroductionEntry = (entry: { type?: string; id?: string }): boolean =>\n  entry.type === 'text' && typeof entry.id === 'string' && entry.id.endsWith(INTRODUCTION_ENTRY_ID_SUFFIX)\n"],"mappings":";;;;;AAIA,IAAa,+BAA+B;;;;;;;AAQ5C,IAAa,uBAAuB,UAClC,MAAM,SAAS,UAAU,OAAO,MAAM,OAAO,YAAY,MAAM,GAAG,SAAA,4BAAsC"}
+{"version":3,"file":"is-introduction-entry.js","names":[],"sources":["../../src/helpers/is-introduction-entry.ts"],"sourcesContent":["/**\n * The auto-generated \"Introduction\" navigation entry always uses the `introduction` slug, so its id\n * ends with this suffix regardless of the active locale or the displayed title.\n */\nexport const INTRODUCTION_ENTRY_ID_SUFFIX = '/description/introduction'\n\n/**\n * Whether a navigation entry is the auto-generated introduction section.\n *\n * We match on the stable entry id instead of the English title so localization does not accidentally\n * rewrite unrelated description headings that happen to be called \"Introduction\".\n */\nexport const isIntroductionEntry = (entry: { type?: string; id?: string }): boolean =>\n  entry.type === 'text' && typeof entry.id === 'string' && entry.id.endsWith(INTRODUCTION_ENTRY_ID_SUFFIX)\n"],"mappings":";;;;;AAIA,IAAa,+BAA+B;;;;;;;AAQ5C,IAAa,uBAAuB,UAClC,MAAM,SAAS,UAAU,OAAO,MAAM,OAAO,YAAY,MAAM,GAAG,SAAA,2BAAqC"}

package/dist/helpers/lazy-bus.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-bus.js","names":[],"sources":["../../src/helpers/lazy-bus.ts"],"sourcesContent":["import { watchDebounced } from '@vueuse/core'\nimport { nanoid } from 'nanoid'\nimport { computed, nextTick, onBeforeUnmount, reactive, ref } from 'vue'\n\nimport { getSchemaParamsFromId } from './id-routing'\n\n/**\n * List of items that are in the priority queue and will be rendered first (e.g. scroll target).\n */\nconst priorityQueue = reactive<Set<string>>(new Set())\n/** List of items that are pending to be loaded (in viewport overscan). */\nconst pendingQueue = reactive<Set<string>>(new Set())\n/** List of items that are already loaded and stay mounted (no eviction). */\nconst readyQueue = reactive<Set<string>>(new Set())\n/**\n * Flag to indicate if the lazy bus is currently running\n * Blocks ID changes while running\n */\nconst isRunning = ref(false)\n\n/** How long tryScroll keeps retrying to find the element (ms). */\nconst SCROLL_RETRY_MS = 3000\n\n/** Tracks when the initial load is complete. */\nexport const firstLazyLoadComplete = ref(false)\n\n/**\n * The id of the element we are currently scrolling to (the anchor target).\n *\n * Schema properties live inside collapsible disclosures that are not part of the\n * navigation tree, so the lazy bus cannot expand them the way it expands sidebar\n * parents. Instead we publish the active target here and let each collapsible\n * schema disclosure open itself when its breadcrumb is on the path to the target.\n * This is what makes deep links to hidden (collapsed) schema properties work.\n */\nexport const scrollTargetId = ref<string>('')\n\n/**\n * Clears the scroll target once we are done with it, so a stale target cannot\n * re-open a disclosure the user later collapsed (or that remounts). Guarded by\n * the id so a newer navigation that started during the scroll retry is kept.\n */\nconst clearScrollTarget = (id: string): void => {\n  if (scrollTargetId.value === id) {\n    scrollTargetId.value = ''\n  }\n}\n\n/** List of unique identifiers that are blocking intersection */\nconst intersectionBlockers = reactive<Set<string>>(new Set())\n\nconst onRenderComplete = new Set<() => void>()\n\n/** Cached content heights so placeholders can match when not rendered. */\nconst lazyPlaceholderHeights = reactive<Map<string, number>>(new Map())\n\nexport const getLazyPlaceholderHeight = (id: string): number | undefined => lazyPlaceholderHeights.get(id)\n\nexport const setLazyPlaceholderHeight = (id: string, height: number): void => {\n  if (!Number.isFinite(height) || height <= 0) {\n    return\n  }\n  lazyPlaceholderHeights.set(id, Math.round(height))\n}\n\n/** Adds a one time callback to be executed when the lazy bus has finished loading */\nconst addLazyCompleteCallback = (callback: (() => void) | undefined) => {\n  if (callback) {\n    onRenderComplete.add(callback)\n  }\n}\n\ntype UnblockFn = () => void\n\n/**\n * Blocks intersection until the returned unblock callback is run.\n * Prevents scroll jump while we render new lazy content.\n */\nexport const blockIntersection = (): UnblockFn => {\n  const blockId = nanoid()\n  intersectionBlockers.add(blockId)\n\n  /** Unblock uses a small delay to ensure the scroll is complete before enabling intersection */\n  return () => setTimeout(() => intersectionBlockers.delete(blockId), 100)\n}\n\n/** If there are any pending blocking operations we disable intersection */\nexport const intersectionEnabled = computed(() => intersectionBlockers.size === 0)\n\n/**\n * Processes the full queue: priority first, then pending. Blocks intersection while\n * rendering so the viewport does not jump. No eviction — items stay in readyQueue.\n */\nconst runLazyBus = () => {\n  // We always render the lazy bus when the window is undefined (see useLazyBus)\n  if (typeof window === 'undefined') {\n    return\n  }\n\n  if (isRunning.value) {\n    return\n  }\n\n  isRunning.value = true\n\n  /**\n   * Sets all the pending elements into the ready queue\n   * After waiting for Vue to update the DOM we execute the callbacks and unblock intersection\n   */\n  const processQueue = async () => {\n    const priorityIds = [...priorityQueue]\n    const pendingIds = [...pendingQueue]\n\n    if (priorityIds.length === 0 && pendingIds.length === 0) {\n      onRenderComplete.forEach((fn) => fn())\n      onRenderComplete.clear()\n      isRunning.value = false\n      firstLazyLoadComplete.value = true\n      return\n    }\n\n    for (const id of priorityIds) {\n      readyQueue.add(id)\n      priorityQueue.delete(id)\n    }\n    for (const id of pendingIds) {\n      readyQueue.add(id)\n      pendingQueue.delete(id)\n    }\n\n    await nextTick()\n\n    onRenderComplete.forEach((fn) => fn())\n    onRenderComplete.clear()\n    isRunning.value = false\n    firstLazyLoadComplete.value = true\n  }\n\n  if (window.requestIdleCallback) {\n    window.requestIdleCallback(processQueue, { timeout: 1500 })\n  } else {\n    // biome-ignore lint/nursery/noFloatingPromises: Expected floating promise\n    nextTick(processQueue)\n  }\n}\n\n/**\n * Run the lazy bus when the queue changes and is not currently running\n * Debounce so that multiple changes to the queue are batched together\n *\n * We must run when the priority queue changes because we rely on finish callbacks\n * anytime we request potentially lazy elements. If we don't run when the priority queue changes\n * we may not have a finish callback even though the element is set to load.\n */\nwatchDebounced(\n  [() => pendingQueue.size, () => priorityQueue.size, () => isRunning.value],\n  () => {\n    if ((pendingQueue.size > 0 || priorityQueue.size > 0) && !isRunning.value) {\n      runLazyBus()\n    }\n  },\n  { debounce: 300, maxWait: 1500 },\n)\n\n/**\n * We only make elements pending if they are not already in the priority or ready queue\n */\nconst addToPendingQueue = (id: string | undefined) => {\n  if (id && !readyQueue.has(id) && !priorityQueue.has(id)) {\n    pendingQueue.add(id)\n  }\n}\n\n/**\n * Add elements to the priority queue for immediate rendering.\n * We allow adding items already in readyQueue so that callbacks are still triggered,\n * but processQueue will skip actual re-rendering for items already ready.\n */\nexport const addToPriorityQueue = (id: string | undefined) => {\n  if (id && !priorityQueue.has(id)) {\n    priorityQueue.add(id)\n  }\n}\n\n/**\n * Request an item to be rendered (e.g. when it re-enters the overscan zone).\n */\nexport const requestLazyRender = (id: string | undefined, priority = false): void => {\n  if (!id || readyQueue.has(id)) {\n    return\n  }\n  if (priority) {\n    addToPriorityQueue(id)\n  } else {\n    addToPendingQueue(id)\n  }\n  if (!isRunning.value) {\n    runLazyBus()\n  }\n}\n\n/**\n * Schedules a single run of the lazy bus so that documents with no Lazy components\n * (e.g. no operations, tags, or models) still get firstLazyLoadComplete set and the\n * full-viewport placeholder can be hidden. Call from content root on mount.\n */\nexport const scheduleInitialLoadComplete = (): void => {\n  if (typeof window === 'undefined') {\n    return\n  }\n  const delay = 400\n  window.setTimeout(() => runLazyBus(), delay)\n}\n\n/** When an element is unmounted we remove it from all queues */\nconst resetLazyElement = (id: string) => {\n  priorityQueue.delete(id)\n  pendingQueue.delete(id)\n  readyQueue.delete(id)\n  lazyPlaceholderHeights.delete(id)\n}\n\n// ---------------------------------------------------------------------------\n\n/**\n * Tracks the lazy loading state of an element.\n * Use isReady (or expanded) to decide whether to render the slot or show a placeholder.\n * The element is only added to the queue when it enters the viewport overscan (see Lazy.vue).\n */\nexport function useLazyBus(id: string) {\n  onBeforeUnmount(() => {\n    resetLazyElement(id)\n  })\n\n  return {\n    isReady: computed(() => typeof window === 'undefined' || priorityQueue.has(id) || readyQueue.has(id)),\n  }\n}\n\n/**\n * Scroll to a possibly lazy-loaded element. Expands parents and adds target (and\n * parents) to the priority queue, then scrolls after Vue has flushed.\n */\nexport const scrollToLazy = (\n  id: string,\n  setExpanded: (id: string, value: boolean) => void,\n  getEntryById: (id: string) => { id: string; parent?: { id: string }; children?: { id: string }[] } | undefined,\n) => {\n  const item = getEntryById(id)\n\n  /**\n   * If the element is lazy we must freeze the element so that it does not move until after the next lazy bus run\n   * If the element never loads then the scroll onFailure callback will be run to unfreeze the element\n   *\n   * If the readyQueue does not have the item we must freeze it while it renders\n   * If the item has lazy children we must freeze the item while the children are (potentially) loaded\n   */\n  const isLazy = !readyQueue.has(id) || item?.children?.some((child) => !readyQueue.has(child.id))\n\n  const unfreeze = isLazy ? freeze(id) : undefined\n  addLazyCompleteCallback(unfreeze)\n\n  // Disable intersection while we scroll to the element\n  const unblock = blockIntersection()\n  const { rawId } = getSchemaParamsFromId(id)\n\n  // Publish the target so collapsible schema disclosures on the path can open\n  // themselves. Schema properties are not in the navigation tree, so this is the\n  // only way the scroll target inside a collapsed schema becomes reachable.\n  scrollTargetId.value = id\n\n  addToPriorityQueue(id)\n  addToPriorityQueue(rawId)\n\n  // When there are children we ensure the first 2 are loaded\n  if (item?.children) {\n    item.children.slice(0, 2).forEach((child) => addToPriorityQueue(child.id))\n  }\n\n  // When there are sibling items we attempt to load the next 2 to better fill the viewport\n  if (item?.parent) {\n    const parent = getEntryById(item.parent.id)\n    const elementIdx = parent?.children?.findIndex((child) => child.id === id)\n    if (elementIdx !== undefined && elementIdx >= 0) {\n      parent?.children?.slice(elementIdx, elementIdx + 2).forEach((child) => addToPriorityQueue(child.id))\n    }\n  }\n\n  setExpanded(rawId, true)\n  /**\n   * Recursively expand the parents and set them as a loading priority\n   * This ensures all parents will be immediately loaded and open\n   */\n  const addParents = (currentId: string) => {\n    const parent = getEntryById(currentId)?.parent\n    if (parent) {\n      addToPriorityQueue(parent.id)\n      setExpanded(parent.id, true)\n      addParents(parent.id)\n    }\n  }\n  /** Must use the rawId as schema params are not in the navigation tree */\n  addParents(rawId)\n\n  void nextTick(() => {\n    tryScroll(id, Date.now() + SCROLL_RETRY_MS, unblock, unfreeze)\n  })\n}\n\n/**\n * Tiny wrapper around the scrollIntoView API\n * Retries up to the stopTime in case the element is not yet rendered\n *\n * @param id - The id of the element to scroll to\n * @param stopTime - The time to stop retrying in unix milliseconds\n */\nconst tryScroll = (id: string, stopTime: number, onComplete: UnblockFn, onFailure?: () => void): void => {\n  const element = document.getElementById(id)\n  if (element) {\n    element.scrollIntoView({ block: 'start' })\n    clearScrollTarget(id)\n    onComplete()\n  } else if (Date.now() < stopTime) {\n    requestAnimationFrame(() => tryScroll(id, stopTime, onComplete, onFailure))\n  } else {\n    // If the scroll has expired we enable intersection again\n    clearScrollTarget(id)\n    onComplete()\n    onFailure?.()\n  }\n}\n\nconst freeze = (id: string): (() => void) => {\n  let stop = false\n\n  /**\n   * Runs until the stop flag is set\n   * Executes the final frame after stop changes to true\n   */\n  const runFrame = (stopAfterFrame: boolean) => {\n    const element = document.getElementById(id)\n    if (element) {\n      element.scrollIntoView({ block: 'start' })\n    }\n    if (!stopAfterFrame) {\n      requestAnimationFrame(() => runFrame(stop))\n    }\n  }\n\n  runFrame(false)\n\n  return () => {\n    stop = true\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"lazy-bus.js","names":[],"sources":["../../src/helpers/lazy-bus.ts"],"sourcesContent":["import { watchDebounced } from '@vueuse/core'\nimport { nanoid } from 'nanoid'\nimport { computed, nextTick, onBeforeUnmount, reactive, ref } from 'vue'\n\nimport { getSchemaParamsFromId } from './id-routing'\n\n/**\n * List of items that are in the priority queue and will be rendered first (e.g. scroll target).\n */\nconst priorityQueue = reactive<Set<string>>(new Set())\n/** List of items that are pending to be loaded (in viewport overscan). */\nconst pendingQueue = reactive<Set<string>>(new Set())\n/** List of items that are already loaded and stay mounted (no eviction). */\nconst readyQueue = reactive<Set<string>>(new Set())\n/**\n * Flag to indicate if the lazy bus is currently running\n * Blocks ID changes while running\n */\nconst isRunning = ref(false)\n\n/** How long tryScroll keeps retrying to find the element (ms). */\nconst SCROLL_RETRY_MS = 3000\n\n/** Tracks when the initial load is complete. */\nexport const firstLazyLoadComplete = ref(false)\n\n/**\n * The id of the element we are currently scrolling to (the anchor target).\n *\n * Schema properties live inside collapsible disclosures that are not part of the\n * navigation tree, so the lazy bus cannot expand them the way it expands sidebar\n * parents. Instead we publish the active target here and let each collapsible\n * schema disclosure open itself when its breadcrumb is on the path to the target.\n * This is what makes deep links to hidden (collapsed) schema properties work.\n */\nexport const scrollTargetId = ref<string>('')\n\n/**\n * Clears the scroll target once we are done with it, so a stale target cannot\n * re-open a disclosure the user later collapsed (or that remounts). Guarded by\n * the id so a newer navigation that started during the scroll retry is kept.\n */\nconst clearScrollTarget = (id: string): void => {\n  if (scrollTargetId.value === id) {\n    scrollTargetId.value = ''\n  }\n}\n\n/** List of unique identifiers that are blocking intersection */\nconst intersectionBlockers = reactive<Set<string>>(new Set())\n\nconst onRenderComplete = new Set<() => void>()\n\n/** Cached content heights so placeholders can match when not rendered. */\nconst lazyPlaceholderHeights = reactive<Map<string, number>>(new Map())\n\nexport const getLazyPlaceholderHeight = (id: string): number | undefined => lazyPlaceholderHeights.get(id)\n\nexport const setLazyPlaceholderHeight = (id: string, height: number): void => {\n  if (!Number.isFinite(height) || height <= 0) {\n    return\n  }\n  lazyPlaceholderHeights.set(id, Math.round(height))\n}\n\n/** Adds a one time callback to be executed when the lazy bus has finished loading */\nconst addLazyCompleteCallback = (callback: (() => void) | undefined) => {\n  if (callback) {\n    onRenderComplete.add(callback)\n  }\n}\n\ntype UnblockFn = () => void\n\n/**\n * Blocks intersection until the returned unblock callback is run.\n * Prevents scroll jump while we render new lazy content.\n */\nexport const blockIntersection = (): UnblockFn => {\n  const blockId = nanoid()\n  intersectionBlockers.add(blockId)\n\n  /** Unblock uses a small delay to ensure the scroll is complete before enabling intersection */\n  return () => setTimeout(() => intersectionBlockers.delete(blockId), 100)\n}\n\n/** If there are any pending blocking operations we disable intersection */\nexport const intersectionEnabled = computed(() => intersectionBlockers.size === 0)\n\n/**\n * Processes the full queue: priority first, then pending. Blocks intersection while\n * rendering so the viewport does not jump. No eviction — items stay in readyQueue.\n */\nconst runLazyBus = () => {\n  // We always render the lazy bus when the window is undefined (see useLazyBus)\n  if (typeof window === 'undefined') {\n    return\n  }\n\n  if (isRunning.value) {\n    return\n  }\n\n  isRunning.value = true\n\n  /**\n   * Sets all the pending elements into the ready queue\n   * After waiting for Vue to update the DOM we execute the callbacks and unblock intersection\n   */\n  const processQueue = async () => {\n    const priorityIds = [...priorityQueue]\n    const pendingIds = [...pendingQueue]\n\n    if (priorityIds.length === 0 && pendingIds.length === 0) {\n      onRenderComplete.forEach((fn) => fn())\n      onRenderComplete.clear()\n      isRunning.value = false\n      firstLazyLoadComplete.value = true\n      return\n    }\n\n    for (const id of priorityIds) {\n      readyQueue.add(id)\n      priorityQueue.delete(id)\n    }\n    for (const id of pendingIds) {\n      readyQueue.add(id)\n      pendingQueue.delete(id)\n    }\n\n    await nextTick()\n\n    onRenderComplete.forEach((fn) => fn())\n    onRenderComplete.clear()\n    isRunning.value = false\n    firstLazyLoadComplete.value = true\n  }\n\n  if (window.requestIdleCallback) {\n    window.requestIdleCallback(processQueue, { timeout: 1500 })\n  } else {\n    // biome-ignore lint/nursery/noFloatingPromises: Expected floating promise\n    nextTick(processQueue)\n  }\n}\n\n/**\n * Run the lazy bus when the queue changes and is not currently running\n * Debounce so that multiple changes to the queue are batched together\n *\n * We must run when the priority queue changes because we rely on finish callbacks\n * anytime we request potentially lazy elements. If we don't run when the priority queue changes\n * we may not have a finish callback even though the element is set to load.\n */\nwatchDebounced(\n  [() => pendingQueue.size, () => priorityQueue.size, () => isRunning.value],\n  () => {\n    if ((pendingQueue.size > 0 || priorityQueue.size > 0) && !isRunning.value) {\n      runLazyBus()\n    }\n  },\n  { debounce: 300, maxWait: 1500 },\n)\n\n/**\n * We only make elements pending if they are not already in the priority or ready queue\n */\nconst addToPendingQueue = (id: string | undefined) => {\n  if (id && !readyQueue.has(id) && !priorityQueue.has(id)) {\n    pendingQueue.add(id)\n  }\n}\n\n/**\n * Add elements to the priority queue for immediate rendering.\n * We allow adding items already in readyQueue so that callbacks are still triggered,\n * but processQueue will skip actual re-rendering for items already ready.\n */\nexport const addToPriorityQueue = (id: string | undefined) => {\n  if (id && !priorityQueue.has(id)) {\n    priorityQueue.add(id)\n  }\n}\n\n/**\n * Request an item to be rendered (e.g. when it re-enters the overscan zone).\n */\nexport const requestLazyRender = (id: string | undefined, priority = false): void => {\n  if (!id || readyQueue.has(id)) {\n    return\n  }\n  if (priority) {\n    addToPriorityQueue(id)\n  } else {\n    addToPendingQueue(id)\n  }\n  if (!isRunning.value) {\n    runLazyBus()\n  }\n}\n\n/**\n * Schedules a single run of the lazy bus so that documents with no Lazy components\n * (e.g. no operations, tags, or models) still get firstLazyLoadComplete set and the\n * full-viewport placeholder can be hidden. Call from content root on mount.\n */\nexport const scheduleInitialLoadComplete = (): void => {\n  if (typeof window === 'undefined') {\n    return\n  }\n  const delay = 400\n  window.setTimeout(() => runLazyBus(), delay)\n}\n\n/** When an element is unmounted we remove it from all queues */\nconst resetLazyElement = (id: string) => {\n  priorityQueue.delete(id)\n  pendingQueue.delete(id)\n  readyQueue.delete(id)\n  lazyPlaceholderHeights.delete(id)\n}\n\n// ---------------------------------------------------------------------------\n\n/**\n * Tracks the lazy loading state of an element.\n * Use isReady (or expanded) to decide whether to render the slot or show a placeholder.\n * The element is only added to the queue when it enters the viewport overscan (see Lazy.vue).\n */\nexport function useLazyBus(id: string) {\n  onBeforeUnmount(() => {\n    resetLazyElement(id)\n  })\n\n  return {\n    isReady: computed(() => typeof window === 'undefined' || priorityQueue.has(id) || readyQueue.has(id)),\n  }\n}\n\n/**\n * Scroll to a possibly lazy-loaded element. Expands parents and adds target (and\n * parents) to the priority queue, then scrolls after Vue has flushed.\n */\nexport const scrollToLazy = (\n  id: string,\n  setExpanded: (id: string, value: boolean) => void,\n  getEntryById: (id: string) => { id: string; parent?: { id: string }; children?: { id: string }[] } | undefined,\n) => {\n  const item = getEntryById(id)\n\n  /**\n   * If the element is lazy we must freeze the element so that it does not move until after the next lazy bus run\n   * If the element never loads then the scroll onFailure callback will be run to unfreeze the element\n   *\n   * If the readyQueue does not have the item we must freeze it while it renders\n   * If the item has lazy children we must freeze the item while the children are (potentially) loaded\n   */\n  const isLazy = !readyQueue.has(id) || item?.children?.some((child) => !readyQueue.has(child.id))\n\n  const unfreeze = isLazy ? freeze(id) : undefined\n  addLazyCompleteCallback(unfreeze)\n\n  // Disable intersection while we scroll to the element\n  const unblock = blockIntersection()\n  const { rawId } = getSchemaParamsFromId(id)\n\n  // Publish the target so collapsible schema disclosures on the path can open\n  // themselves. Schema properties are not in the navigation tree, so this is the\n  // only way the scroll target inside a collapsed schema becomes reachable.\n  scrollTargetId.value = id\n\n  addToPriorityQueue(id)\n  addToPriorityQueue(rawId)\n\n  // When there are children we ensure the first 2 are loaded\n  if (item?.children) {\n    item.children.slice(0, 2).forEach((child) => addToPriorityQueue(child.id))\n  }\n\n  // When there are sibling items we attempt to load the next 2 to better fill the viewport\n  if (item?.parent) {\n    const parent = getEntryById(item.parent.id)\n    const elementIdx = parent?.children?.findIndex((child) => child.id === id)\n    if (elementIdx !== undefined && elementIdx >= 0) {\n      parent?.children?.slice(elementIdx, elementIdx + 2).forEach((child) => addToPriorityQueue(child.id))\n    }\n  }\n\n  setExpanded(rawId, true)\n  /**\n   * Recursively expand the parents and set them as a loading priority\n   * This ensures all parents will be immediately loaded and open\n   */\n  const addParents = (currentId: string) => {\n    const parent = getEntryById(currentId)?.parent\n    if (parent) {\n      addToPriorityQueue(parent.id)\n      setExpanded(parent.id, true)\n      addParents(parent.id)\n    }\n  }\n  /** Must use the rawId as schema params are not in the navigation tree */\n  addParents(rawId)\n\n  void nextTick(() => {\n    tryScroll(id, Date.now() + SCROLL_RETRY_MS, unblock, unfreeze)\n  })\n}\n\n/**\n * Tiny wrapper around the scrollIntoView API\n * Retries up to the stopTime in case the element is not yet rendered\n *\n * @param id - The id of the element to scroll to\n * @param stopTime - The time to stop retrying in unix milliseconds\n */\nconst tryScroll = (id: string, stopTime: number, onComplete: UnblockFn, onFailure?: () => void): void => {\n  const element = document.getElementById(id)\n  if (element) {\n    element.scrollIntoView({ block: 'start' })\n    clearScrollTarget(id)\n    onComplete()\n  } else if (Date.now() < stopTime) {\n    requestAnimationFrame(() => tryScroll(id, stopTime, onComplete, onFailure))\n  } else {\n    // If the scroll has expired we enable intersection again\n    clearScrollTarget(id)\n    onComplete()\n    onFailure?.()\n  }\n}\n\nconst freeze = (id: string): (() => void) => {\n  let stop = false\n\n  /**\n   * Runs until the stop flag is set\n   * Executes the final frame after stop changes to true\n   */\n  const runFrame = (stopAfterFrame: boolean) => {\n    const element = document.getElementById(id)\n    if (element) {\n      element.scrollIntoView({ block: 'start' })\n    }\n    if (!stopAfterFrame) {\n      requestAnimationFrame(() => runFrame(stop))\n    }\n  }\n\n  runFrame(false)\n\n  return () => {\n    stop = true\n  }\n}\n"],"mappings":"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"}

package/dist/helpers/load-from-perssistance.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-from-perssistance.js","names":[],"sources":["../../src/helpers/load-from-perssistance.ts"],"sourcesContent":["import { isSelectedClient } from '@scalar/blocks/code-example'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\n\nimport { authStorage, clientStorage } from '@/helpers/storage'\n\n/**\n * Loads the default HTTP client from storage and applies it to the workspace.\n * Only updates if no default client is already set. Accepts both built-in client\n * ids and custom sample ids (e.g. `custom/python`) so a custom selection persists.\n */\nexport const loadClientFromStorage = (store: WorkspaceStore): void => {\n  const storedClient = clientStorage().get()\n\n  if (isSelectedClient(storedClient) && !store.workspace['x-scalar-default-client']) {\n    store.update('x-scalar-default-client', storedClient)\n  }\n}\n\n/**\n * Loads the authentication data from storage and applies it to the workspace.\n * Only updates if no authentication data is already set.\n */\nexport const loadAuthFromStorage = (store: WorkspaceStore, slug: string): void => {\n  const authPersistence = authStorage()\n  const auth = authPersistence.getAuth(slug)\n  store.auth.load({ [slug]: auth })\n}\n"],"mappings":";;;;;;;;AAUA,IAAa,yBAAyB,UAAgC;CACpE,MAAM,eAAe,eAAe,CAAC,KAAK;AAE1C,KAAI,iBAAiB,aAAa,IAAI,CAAC,MAAM,UAAU,2BACrD,OAAM,OAAO,2BAA2B,aAAa;;;;;;AAQzD,IAAa,uBAAuB,OAAuB,SAAuB;CAEhF,MAAM,OADkB,aAAa,CACR,QAAQ,KAAK;AAC1C,OAAM,KAAK,KAAK,GAAG,OAAO,MAAM,CAAC"}
+{"version":3,"file":"load-from-perssistance.js","names":[],"sources":["../../src/helpers/load-from-perssistance.ts"],"sourcesContent":["import { isSelectedClient } from '@scalar/blocks/code-example'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\n\nimport { authStorage, clientStorage } from '@/helpers/storage'\n\n/**\n * Loads the default HTTP client from storage and applies it to the workspace.\n * Only updates if no default client is already set. Accepts both built-in client\n * ids and custom sample ids (e.g. `custom/python`) so a custom selection persists.\n */\nexport const loadClientFromStorage = (store: WorkspaceStore): void => {\n  const storedClient = clientStorage().get()\n\n  if (isSelectedClient(storedClient) && !store.workspace['x-scalar-default-client']) {\n    store.update('x-scalar-default-client', storedClient)\n  }\n}\n\n/**\n * Loads the authentication data from storage and applies it to the workspace.\n * Only updates if no authentication data is already set.\n */\nexport const loadAuthFromStorage = (store: WorkspaceStore, slug: string): void => {\n  const authPersistence = authStorage()\n  const auth = authPersistence.getAuth(slug)\n  store.auth.load({ [slug]: auth })\n}\n"],"mappings":";;;;;;;;AAUA,IAAa,yBAAyB,UAAgC;CACpE,MAAM,eAAe,cAAc,CAAC,CAAC,IAAI;CAEzC,IAAI,iBAAiB,YAAY,KAAK,CAAC,MAAM,UAAU,4BACrD,MAAM,OAAO,2BAA2B,YAAY;AAExD;;;;;AAMA,IAAa,uBAAuB,OAAuB,SAAuB;CAEhF,MAAM,OADkB,YACX,CAAA,CAAgB,QAAQ,IAAI;CACzC,MAAM,KAAK,KAAK,GAAG,OAAO,KAAK,CAAC;AAClC"}

package/dist/helpers/map-config-plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-config-plugins.js","names":[],"sources":["../../src/helpers/map-config-plugins.ts"],"sourcesContent":["import { buildSafeBodyRequest } from '@scalar/helpers/http/can-method-have-body'\nimport type { ClientPlugin } from '@scalar/oas-utils/helpers'\nimport type { ApiReferenceConfiguration } from '@scalar/types/api-reference'\nimport { buildRequest, getEnvironmentVariables } from '@scalar/workspace-store/request-example'\nimport type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport { type ComputedRef, watch } from 'vue'\n\n/**\n * Maps API reference configuration callbacks to client plugins.\n *\n * This function transforms the onBeforeRequest, onRequestBuilt, and onRequestSent\n * callbacks into the new plugin hook system. The mapping is reactive, so changes\n * to the configuration will automatically update the plugin hooks.\n *\n * Note: onRequestBuilt is mapped to the requestBuilt hook so the callback receives\n * the exact fetch Request that is sent over the wire. Mutating its headers modifies\n * the outgoing request, and hashing its body produces a hash that matches what the\n * server receives (a rebuilt multipart body would get a different boundary).\n *\n * Note: onRequestSent is mapped to responseReceived hook. This is not a perfect\n * one-to-one mapping, but it maintains backward compatibility with the old API.\n * The old callback receives only the URL string, while the new hook receives\n * the full response object.\n *\n * @param config - Reactive configuration object containing optional hook callbacks\n * @returns Array containing a single plugin with the mapped hooks\n */\nexport const mapConfigPlugins = (\n  config: ComputedRef<ApiReferenceConfiguration>,\n  environment: ComputedRef<XScalarEnvironment>,\n): ClientPlugin[] => {\n  // Create a new plugin with the hooks which is going to be updated by the watcher when config changes\n  const plugin: ClientPlugin = { hooks: {} }\n\n  watch(\n    [\n      () => config.value.onBeforeRequest,\n      () => config.value.onRequestBuilt,\n      () => config.value.onRequestSent,\n      () => environment.value,\n    ],\n    ([onBeforeRequest, onRequestBuilt, onRequestSent, environment]) => {\n      // Get the environment variables for the current environment\n      const envVariables = getEnvironmentVariables(environment)\n\n      // Initialize the hooks object if it doesn't exist\n      if (!plugin.hooks) {\n        plugin.hooks = {}\n      }\n\n      plugin.hooks.beforeRequest = onBeforeRequest\n        ? async (payload) => {\n            const built = buildRequest(payload.requestBuilder, {\n              envVariables,\n              allowMissingRequestServerBase: true,\n            })\n            if (!built.ok) {\n              console.error(\n                '[@scalar/api-reference] onBeforeRequest was not run because the request could not be built:',\n                built.message ?? built.error,\n              )\n              return\n            }\n            await onBeforeRequest({\n              // We need to build the request to get the fetch `Request`\n              request: buildSafeBodyRequest(...built.data.requestPayload),\n              requestBuilder: payload.requestBuilder,\n              envVariables,\n            })\n          }\n        : undefined\n\n      /**\n       * Maps onRequestBuilt to the requestBuilt hook. The payload request is the\n       * exact fetch Request that will be sent, so header mutations apply and body\n       * hashes match what goes over the wire.\n       */\n      plugin.hooks.requestBuilt = onRequestBuilt\n        ? async (payload) => {\n            await onRequestBuilt({\n              request: payload.request,\n              requestBuilder: payload.requestBuilder,\n              envVariables,\n            })\n          }\n        : undefined\n\n      /**\n       * Maps onRequestSent to responseReceived hook.\n       * The old API only passed the URL string, so we extract it from the request.\n       */\n      plugin.hooks.responseReceived = onRequestSent\n        ? (payload) => {\n            onRequestSent(payload.request.url)\n          }\n        : undefined\n    },\n    { immediate: true },\n  )\n\n  return [plugin]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA2BA,IAAa,oBACX,QACA,gBACmB;CAEnB,MAAM,SAAuB,EAAE,OAAO,EAAE,EAAE;AAE1C,OACE;QACQ,OAAO,MAAM;QACb,OAAO,MAAM;QACb,OAAO,MAAM;QACb,YAAY;EACnB,GACA,CAAC,iBAAiB,gBAAgB,eAAe,iBAAiB;EAEjE,MAAM,eAAe,wBAAwB,YAAY;AAGzD,MAAI,CAAC,OAAO,MACV,QAAO,QAAQ,EAAE;AAGnB,SAAO,MAAM,gBAAgB,kBACzB,OAAO,YAAY;GACjB,MAAM,QAAQ,aAAa,QAAQ,gBAAgB;IACjD;IACA,+BAA+B;IAChC,CAAC;AACF,OAAI,CAAC,MAAM,IAAI;AACb,YAAQ,MACN,+FACA,MAAM,WAAW,MAAM,MACxB;AACD;;AAEF,SAAM,gBAAgB;IAEpB,SAAS,qBAAqB,GAAG,MAAM,KAAK,eAAe;IAC3D,gBAAgB,QAAQ;IACxB;IACD,CAAC;MAEJ,KAAA;;;;;;AAOJ,SAAO,MAAM,eAAe,iBACxB,OAAO,YAAY;AACjB,SAAM,eAAe;IACnB,SAAS,QAAQ;IACjB,gBAAgB,QAAQ;IACxB;IACD,CAAC;MAEJ,KAAA;;;;;AAMJ,SAAO,MAAM,mBAAmB,iBAC3B,YAAY;AACX,iBAAc,QAAQ,QAAQ,IAAI;MAEpC,KAAA;IAEN,EAAE,WAAW,MAAM,CACpB;AAED,QAAO,CAAC,OAAO"}
+{"version":3,"file":"map-config-plugins.js","names":[],"sources":["../../src/helpers/map-config-plugins.ts"],"sourcesContent":["import { buildSafeBodyRequest } from '@scalar/helpers/http/can-method-have-body'\nimport type { ClientPlugin } from '@scalar/oas-utils/helpers'\nimport type { ApiReferenceConfiguration } from '@scalar/types/api-reference'\nimport { buildRequest, getEnvironmentVariables } from '@scalar/workspace-store/request-example'\nimport type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport { type ComputedRef, watch } from 'vue'\n\n/**\n * Maps API reference configuration callbacks to client plugins.\n *\n * This function transforms the onBeforeRequest, onRequestBuilt, and onRequestSent\n * callbacks into the new plugin hook system. The mapping is reactive, so changes\n * to the configuration will automatically update the plugin hooks.\n *\n * Note: onRequestBuilt is mapped to the requestBuilt hook so the callback receives\n * the exact fetch Request that is sent over the wire. Mutating its headers modifies\n * the outgoing request, and hashing its body produces a hash that matches what the\n * server receives (a rebuilt multipart body would get a different boundary).\n *\n * Note: onRequestSent is mapped to responseReceived hook. This is not a perfect\n * one-to-one mapping, but it maintains backward compatibility with the old API.\n * The old callback receives only the URL string, while the new hook receives\n * the full response object.\n *\n * @param config - Reactive configuration object containing optional hook callbacks\n * @returns Array containing a single plugin with the mapped hooks\n */\nexport const mapConfigPlugins = (\n  config: ComputedRef<ApiReferenceConfiguration>,\n  environment: ComputedRef<XScalarEnvironment>,\n): ClientPlugin[] => {\n  // Create a new plugin with the hooks which is going to be updated by the watcher when config changes\n  const plugin: ClientPlugin = { hooks: {} }\n\n  watch(\n    [\n      () => config.value.onBeforeRequest,\n      () => config.value.onRequestBuilt,\n      () => config.value.onRequestSent,\n      () => environment.value,\n    ],\n    ([onBeforeRequest, onRequestBuilt, onRequestSent, environment]) => {\n      // Get the environment variables for the current environment\n      const envVariables = getEnvironmentVariables(environment)\n\n      // Initialize the hooks object if it doesn't exist\n      if (!plugin.hooks) {\n        plugin.hooks = {}\n      }\n\n      plugin.hooks.beforeRequest = onBeforeRequest\n        ? async (payload) => {\n            const built = buildRequest(payload.requestBuilder, {\n              envVariables,\n              allowMissingRequestServerBase: true,\n            })\n            if (!built.ok) {\n              console.error(\n                '[@scalar/api-reference] onBeforeRequest was not run because the request could not be built:',\n                built.message ?? built.error,\n              )\n              return\n            }\n            await onBeforeRequest({\n              // We need to build the request to get the fetch `Request`\n              request: buildSafeBodyRequest(...built.data.requestPayload),\n              requestBuilder: payload.requestBuilder,\n              envVariables,\n            })\n          }\n        : undefined\n\n      /**\n       * Maps onRequestBuilt to the requestBuilt hook. The payload request is the\n       * exact fetch Request that will be sent, so header mutations apply and body\n       * hashes match what goes over the wire.\n       */\n      plugin.hooks.requestBuilt = onRequestBuilt\n        ? async (payload) => {\n            await onRequestBuilt({\n              request: payload.request,\n              requestBuilder: payload.requestBuilder,\n              envVariables,\n            })\n          }\n        : undefined\n\n      /**\n       * Maps onRequestSent to responseReceived hook.\n       * The old API only passed the URL string, so we extract it from the request.\n       */\n      plugin.hooks.responseReceived = onRequestSent\n        ? (payload) => {\n            onRequestSent(payload.request.url)\n          }\n        : undefined\n    },\n    { immediate: true },\n  )\n\n  return [plugin]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA2BA,IAAa,oBACX,QACA,gBACmB;CAEnB,MAAM,SAAuB,EAAE,OAAO,CAAC,EAAE;CAEzC,MACE;QACQ,OAAO,MAAM;QACb,OAAO,MAAM;QACb,OAAO,MAAM;QACb,YAAY;CACpB,IACC,CAAC,iBAAiB,gBAAgB,eAAe,iBAAiB;EAEjE,MAAM,eAAe,wBAAwB,WAAW;EAGxD,IAAI,CAAC,OAAO,OACV,OAAO,QAAQ,CAAC;EAGlB,OAAO,MAAM,gBAAgB,kBACzB,OAAO,YAAY;GACjB,MAAM,QAAQ,aAAa,QAAQ,gBAAgB;IACjD;IACA,+BAA+B;GACjC,CAAC;GACD,IAAI,CAAC,MAAM,IAAI;IACb,QAAQ,MACN,+FACA,MAAM,WAAW,MAAM,KACzB;IACA;GACF;GACA,MAAM,gBAAgB;IAEpB,SAAS,qBAAqB,GAAG,MAAM,KAAK,cAAc;IAC1D,gBAAgB,QAAQ;IACxB;GACF,CAAC;EACH,IACA,KAAA;;;;;;EAOJ,OAAO,MAAM,eAAe,iBACxB,OAAO,YAAY;GACjB,MAAM,eAAe;IACnB,SAAS,QAAQ;IACjB,gBAAgB,QAAQ;IACxB;GACF,CAAC;EACH,IACA,KAAA;;;;;EAMJ,OAAO,MAAM,mBAAmB,iBAC3B,YAAY;GACX,cAAc,QAAQ,QAAQ,GAAG;EACnC,IACA,KAAA;CACN,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,OAAO,CAAC,MAAM;AAChB"}

package/dist/helpers/map-config-to-workspace-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-config-to-workspace-store.js","names":[],"sources":["../../src/helpers/map-config-to-workspace-store.ts"],"sourcesContent":["import { isClient } from '@scalar/blocks/code-example'\nimport type { ApiReferenceConfigurationRaw } from '@scalar/types/api-reference'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\nimport { useSeoMeta } from '@unhead/vue'\nimport { useFavicon } from '@vueuse/core'\nimport { type MaybeRefOrGetter, type Ref, computed, toValue, watch } from 'vue'\n\nexport const mapConfigToWorkspaceStore = ({\n  config,\n  store,\n  isDarkMode,\n}: {\n  config: MaybeRefOrGetter<ApiReferenceConfigurationRaw>\n  store: WorkspaceStore\n  isDarkMode: Ref<boolean>\n}) => {\n  // Update the workspace store if default client changes\n  watch(\n    () => toValue(config).defaultHttpClient,\n    (newValue) => {\n      if (newValue) {\n        const { targetKey, clientKey } = newValue\n\n        const clientId = `${targetKey}/${clientKey}`\n        if (isClient(clientId)) {\n          store.update('x-scalar-default-client', clientId)\n        }\n      }\n    },\n    { immediate: true },\n  )\n\n  /** Update the dark mode state when props change */\n  watch(\n    () => toValue(config).darkMode,\n    (isDark) => store.update('x-scalar-color-mode', isDark ? 'dark' : 'light'),\n  )\n\n  // Temporary mapping of isDarkMode until we update the standalone component\n  watch(\n    () => isDarkMode.value,\n    (newIsDark) => store.update('x-scalar-color-mode', newIsDark ? 'dark' : 'light'),\n    { immediate: true },\n  )\n\n  if (toValue(config).metaData) {\n    useSeoMeta(toValue(config).metaData)\n  }\n\n  // Update the active proxy when the proxyUrl changes\n  watch(\n    () => toValue(config).proxyUrl,\n    (newProxyUrl) => store.update('x-scalar-active-proxy', newProxyUrl),\n    { immediate: true },\n  )\n\n  const favicon = computed(() => toValue(config).favicon)\n  useFavicon(favicon)\n}\n"],"mappings":";;;;;AAOA,IAAa,6BAA6B,EACxC,QACA,OACA,iBAKI;AAEJ,aACQ,QAAQ,OAAO,CAAC,oBACrB,aAAa;AACZ,MAAI,UAAU;GACZ,MAAM,EAAE,WAAW,cAAc;GAEjC,MAAM,WAAW,GAAG,UAAU,GAAG;AACjC,OAAI,SAAS,SAAS,CACpB,OAAM,OAAO,2BAA2B,SAAS;;IAIvD,EAAE,WAAW,MAAM,CACpB;;AAGD,aACQ,QAAQ,OAAO,CAAC,WACrB,WAAW,MAAM,OAAO,uBAAuB,SAAS,SAAS,QAAQ,CAC3E;AAGD,aACQ,WAAW,QAChB,cAAc,MAAM,OAAO,uBAAuB,YAAY,SAAS,QAAQ,EAChF,EAAE,WAAW,MAAM,CACpB;AAED,KAAI,QAAQ,OAAO,CAAC,SAClB,YAAW,QAAQ,OAAO,CAAC,SAAS;AAItC,aACQ,QAAQ,OAAO,CAAC,WACrB,gBAAgB,MAAM,OAAO,yBAAyB,YAAY,EACnE,EAAE,WAAW,MAAM,CACpB;AAGD,YADgB,eAAe,QAAQ,OAAO,CAAC,QAAQ,CACpC"}
+{"version":3,"file":"map-config-to-workspace-store.js","names":[],"sources":["../../src/helpers/map-config-to-workspace-store.ts"],"sourcesContent":["import { isClient } from '@scalar/blocks/code-example'\nimport type { ApiReferenceConfigurationRaw } from '@scalar/types/api-reference'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\nimport { useSeoMeta } from '@unhead/vue'\nimport { useFavicon } from '@vueuse/core'\nimport { type MaybeRefOrGetter, type Ref, computed, toValue, watch } from 'vue'\n\nexport const mapConfigToWorkspaceStore = ({\n  config,\n  store,\n  isDarkMode,\n}: {\n  config: MaybeRefOrGetter<ApiReferenceConfigurationRaw>\n  store: WorkspaceStore\n  isDarkMode: Ref<boolean>\n}) => {\n  // Update the workspace store if default client changes\n  watch(\n    () => toValue(config).defaultHttpClient,\n    (newValue) => {\n      if (newValue) {\n        const { targetKey, clientKey } = newValue\n\n        const clientId = `${targetKey}/${clientKey}`\n        if (isClient(clientId)) {\n          store.update('x-scalar-default-client', clientId)\n        }\n      }\n    },\n    { immediate: true },\n  )\n\n  /** Update the dark mode state when props change */\n  watch(\n    () => toValue(config).darkMode,\n    (isDark) => store.update('x-scalar-color-mode', isDark ? 'dark' : 'light'),\n  )\n\n  // Temporary mapping of isDarkMode until we update the standalone component\n  watch(\n    () => isDarkMode.value,\n    (newIsDark) => store.update('x-scalar-color-mode', newIsDark ? 'dark' : 'light'),\n    { immediate: true },\n  )\n\n  if (toValue(config).metaData) {\n    useSeoMeta(toValue(config).metaData)\n  }\n\n  // Update the active proxy when the proxyUrl changes\n  watch(\n    () => toValue(config).proxyUrl,\n    (newProxyUrl) => store.update('x-scalar-active-proxy', newProxyUrl),\n    { immediate: true },\n  )\n\n  const favicon = computed(() => toValue(config).favicon)\n  useFavicon(favicon)\n}\n"],"mappings":";;;;;AAOA,IAAa,6BAA6B,EACxC,QACA,OACA,iBAKI;CAEJ,YACQ,QAAQ,MAAM,CAAC,CAAC,oBACrB,aAAa;EACZ,IAAI,UAAU;GACZ,MAAM,EAAE,WAAW,cAAc;GAEjC,MAAM,WAAW,GAAG,UAAU,GAAG;GACjC,IAAI,SAAS,QAAQ,GACnB,MAAM,OAAO,2BAA2B,QAAQ;EAEpD;CACF,GACA,EAAE,WAAW,KAAK,CACpB;;CAGA,YACQ,QAAQ,MAAM,CAAC,CAAC,WACrB,WAAW,MAAM,OAAO,uBAAuB,SAAS,SAAS,OAAO,CAC3E;CAGA,YACQ,WAAW,QAChB,cAAc,MAAM,OAAO,uBAAuB,YAAY,SAAS,OAAO,GAC/E,EAAE,WAAW,KAAK,CACpB;CAEA,IAAI,QAAQ,MAAM,CAAC,CAAC,UAClB,WAAW,QAAQ,MAAM,CAAC,CAAC,QAAQ;CAIrC,YACQ,QAAQ,MAAM,CAAC,CAAC,WACrB,gBAAgB,MAAM,OAAO,yBAAyB,WAAW,GAClE,EAAE,WAAW,KAAK,CACpB;CAGA,WADgB,eAAe,QAAQ,MAAM,CAAC,CAAC,OACpC,CAAO;AACpB"}

package/dist/helpers/normalize-configurations.js

@@ -61,6 +61,6 @@ var addSlugAndTitle = (source, index = 0, slug) => {
 	};
 };
 //#endregion
-export { normalizeConfigurations };
+export { normalizeConfigurations, normalizeContent };
 
 //# sourceMappingURL=normalize-configurations.js.map

package/dist/helpers/normalize-configurations.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-configurations.js","names":[],"sources":["../../src/helpers/normalize-configurations.ts"],"sourcesContent":["import { slugger } from '@scalar/helpers/string/slugger'\nimport { parseJsonOrYaml } from '@scalar/oas-utils/helpers'\nimport { apiReferenceConfigurationWithSourceSchema } from '@scalar/schemas/api-reference'\nimport {\n  type AnyApiReferenceConfiguration,\n  type ApiReferenceConfigurationRaw,\n  type ApiReferenceConfigurationWithSource,\n  isConfigurationWithSources,\n} from '@scalar/types/api-reference'\n\n/** Processed API Reference Configuration\n *\n * Creates the required title and slug for the API Reference.\n * Separate the source into a dedicated object\n * Returns the raw configuration to pass to components\n */\nexport type NormalizedConfiguration = {\n  title: string\n  slug: string\n  config: ApiReferenceConfigurationRaw\n  default: boolean\n  agent: ApiReferenceConfigurationWithSource['agent']\n  source: { url: string; content?: never } | { content: Record<string, unknown>; url?: never }\n}\n\ntype NormalizedConfigurations = Record<string, NormalizedConfiguration>\n\ntype ConfigWithRequiredSource = Omit<ApiReferenceConfigurationWithSource, 'url' | 'content'> &\n  ({ url: string; content?: never } | { content: Record<string, unknown>; url?: never })\n\nconst isConfigWithRequiredSource = (input: ApiReferenceConfigurationWithSource): input is ConfigWithRequiredSource => {\n  return !!input.url?.trim() || !!input.content\n}\n\n/**\n * Take any configuration and return a flat array of configurations.\n */\nexport const normalizeConfigurations = (\n  configuration: AnyApiReferenceConfiguration | undefined,\n): NormalizedConfigurations => {\n  const { slug } = slugger()\n\n  const normalized: NormalizedConfigurations = {}\n\n  if (!configuration) {\n    return normalized\n  }\n\n  const configList = Array.isArray(configuration) ? configuration : [configuration]\n\n  configList\n    /** Create a flat array of configurations with their document source data integrated. */\n    .flatMap((c) => {\n      // Check if this config has a 'sources' array property\n      if (isConfigurationWithSources(c)) {\n        // Destructure to separate sources array from other config properties\n        const { sources: configSources, ...rest } = c\n\n        // For each source in the array:\n        // - Merge the source with the parent config properties\n        // - Handle undefined sources by returning empty array via ?? []\n        return configSources?.map((source) => ({ ...rest, ...source })) ?? []\n      }\n\n      // If config doesn't have sources array, treat the config itself as a source\n      return [c]\n    })\n    .map((source) => apiReferenceConfigurationWithSourceSchema(source) as ApiReferenceConfigurationWithSource)\n    /** Filter out configurations that failed validation or don't have a url or content */\n    .filter(isConfigWithRequiredSource)\n    /** Add required attributes to the source */\n    .map((source, index) => addSlugAndTitle(source, index, slug))\n    /** Separate the configuration and sources by slug */\n    .forEach((c) => {\n      const { url, content, ...config } = c\n      normalized[c.slug] = {\n        config,\n        title: c.title,\n        slug: c.slug,\n        default: !!c?.default,\n        agent: c.agent,\n        source: content ? { content: normalizeContent(content) ?? {} } : { url },\n      }\n    })\n\n  // Process them and return normalized\n  return normalized\n}\n\n/** Normalize content into a JS object or return null if it is falsey */\nexport const normalizeContent = (\n  content: string | Record<string, unknown> | (() => string | Record<string, unknown>),\n): Record<string, unknown> | null => {\n  if (!content) {\n    return null\n  }\n\n  if (typeof content === 'function') {\n    return normalizeContent(content())\n  }\n\n  if (typeof content === 'string') {\n    return parseJsonOrYaml(content)\n  }\n\n  return content\n}\n\n/** Process a single spec configuration so that it has a title and a slug */\nconst addSlugAndTitle = (\n  source: ConfigWithRequiredSource,\n  index = 0,\n  slug: (v: string) => string,\n): ConfigWithRequiredSource & { slug: string; title: string } => {\n  // Case 1: Title exists, generate slug from it\n  if (source.title) {\n    return {\n      ...source,\n      slug: source.slug || slug(source.title),\n      title: source.title,\n    }\n  }\n\n  // Case 2: Slug exists but no title, use slug as title\n  if (source.slug) {\n    return {\n      ...source,\n      slug: slug(source.slug),\n      title: source.slug,\n    }\n  }\n\n  // Case 3: Neither exists, use index\n  return {\n    ...source,\n    slug: `api-${index + 1}`,\n    title: `API #${index + 1}`,\n  }\n}\n"],"mappings":";;;;;AA8BA,IAAM,8BAA8B,UAAkF;AACpH,QAAO,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM;;;;;AAMxC,IAAa,2BACX,kBAC6B;CAC7B,MAAM,EAAE,SAAS,SAAS;CAE1B,MAAM,aAAuC,EAAE;AAE/C,KAAI,CAAC,cACH,QAAO;AAKT,EAFmB,MAAM,QAAQ,cAAc,GAAG,gBAAgB,CAAC,cAAc,EAI9E,SAAS,MAAM;AAEd,MAAI,2BAA2B,EAAE,EAAE;GAEjC,MAAM,EAAE,SAAS,eAAe,GAAG,SAAS;AAK5C,UAAO,eAAe,KAAK,YAAY;IAAE,GAAG;IAAM,GAAG;IAAQ,EAAE,IAAI,EAAE;;AAIvE,SAAO,CAAC,EAAE;GACV,CACD,KAAK,WAAW,0CAA0C,OAAO,CAAwC,CAEzG,OAAO,2BAA2B,CAElC,KAAK,QAAQ,UAAU,gBAAgB,QAAQ,OAAO,KAAK,CAAC,CAE5D,SAAS,MAAM;EACd,MAAM,EAAE,KAAK,SAAS,GAAG,WAAW;AACpC,aAAW,EAAE,QAAQ;GACnB;GACA,OAAO,EAAE;GACT,MAAM,EAAE;GACR,SAAS,CAAC,CAAC,GAAG;GACd,OAAO,EAAE;GACT,QAAQ,UAAU,EAAE,SAAS,iBAAiB,QAAQ,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK;GACzE;GACD;AAGJ,QAAO;;;AAIT,IAAa,oBACX,YACmC;AACnC,KAAI,CAAC,QACH,QAAO;AAGT,KAAI,OAAO,YAAY,WACrB,QAAO,iBAAiB,SAAS,CAAC;AAGpC,KAAI,OAAO,YAAY,SACrB,QAAO,gBAAgB,QAAQ;AAGjC,QAAO;;;AAIT,IAAM,mBACJ,QACA,QAAQ,GACR,SAC+D;AAE/D,KAAI,OAAO,MACT,QAAO;EACL,GAAG;EACH,MAAM,OAAO,QAAQ,KAAK,OAAO,MAAM;EACvC,OAAO,OAAO;EACf;AAIH,KAAI,OAAO,KACT,QAAO;EACL,GAAG;EACH,MAAM,KAAK,OAAO,KAAK;EACvB,OAAO,OAAO;EACf;AAIH,QAAO;EACL,GAAG;EACH,MAAM,OAAO,QAAQ;EACrB,OAAO,QAAQ,QAAQ;EACxB"}
+{"version":3,"file":"normalize-configurations.js","names":[],"sources":["../../src/helpers/normalize-configurations.ts"],"sourcesContent":["import { slugger } from '@scalar/helpers/string/slugger'\nimport { parseJsonOrYaml } from '@scalar/oas-utils/helpers'\nimport { apiReferenceConfigurationWithSourceSchema } from '@scalar/schemas/api-reference'\nimport {\n  type AnyApiReferenceConfiguration,\n  type ApiReferenceConfigurationRaw,\n  type ApiReferenceConfigurationWithSource,\n  isConfigurationWithSources,\n} from '@scalar/types/api-reference'\n\n/** Processed API Reference Configuration\n *\n * Creates the required title and slug for the API Reference.\n * Separate the source into a dedicated object\n * Returns the raw configuration to pass to components\n */\nexport type NormalizedConfiguration = {\n  title: string\n  slug: string\n  config: ApiReferenceConfigurationRaw\n  default: boolean\n  agent: ApiReferenceConfigurationWithSource['agent']\n  source: { url: string; content?: never } | { content: Record<string, unknown>; url?: never }\n}\n\ntype NormalizedConfigurations = Record<string, NormalizedConfiguration>\n\ntype ConfigWithRequiredSource = Omit<ApiReferenceConfigurationWithSource, 'url' | 'content'> &\n  ({ url: string; content?: never } | { content: Record<string, unknown>; url?: never })\n\nconst isConfigWithRequiredSource = (input: ApiReferenceConfigurationWithSource): input is ConfigWithRequiredSource => {\n  return !!input.url?.trim() || !!input.content\n}\n\n/**\n * Take any configuration and return a flat array of configurations.\n */\nexport const normalizeConfigurations = (\n  configuration: AnyApiReferenceConfiguration | undefined,\n): NormalizedConfigurations => {\n  const { slug } = slugger()\n\n  const normalized: NormalizedConfigurations = {}\n\n  if (!configuration) {\n    return normalized\n  }\n\n  const configList = Array.isArray(configuration) ? configuration : [configuration]\n\n  configList\n    /** Create a flat array of configurations with their document source data integrated. */\n    .flatMap((c) => {\n      // Check if this config has a 'sources' array property\n      if (isConfigurationWithSources(c)) {\n        // Destructure to separate sources array from other config properties\n        const { sources: configSources, ...rest } = c\n\n        // For each source in the array:\n        // - Merge the source with the parent config properties\n        // - Handle undefined sources by returning empty array via ?? []\n        return configSources?.map((source) => ({ ...rest, ...source })) ?? []\n      }\n\n      // If config doesn't have sources array, treat the config itself as a source\n      return [c]\n    })\n    .map((source) => apiReferenceConfigurationWithSourceSchema(source) as ApiReferenceConfigurationWithSource)\n    /** Filter out configurations that failed validation or don't have a url or content */\n    .filter(isConfigWithRequiredSource)\n    /** Add required attributes to the source */\n    .map((source, index) => addSlugAndTitle(source, index, slug))\n    /** Separate the configuration and sources by slug */\n    .forEach((c) => {\n      const { url, content, ...config } = c\n      normalized[c.slug] = {\n        config,\n        title: c.title,\n        slug: c.slug,\n        default: !!c?.default,\n        agent: c.agent,\n        source: content ? { content: normalizeContent(content) ?? {} } : { url },\n      }\n    })\n\n  // Process them and return normalized\n  return normalized\n}\n\n/** Normalize content into a JS object or return null if it is falsey */\nexport const normalizeContent = (\n  content: string | Record<string, unknown> | (() => string | Record<string, unknown>),\n): Record<string, unknown> | null => {\n  if (!content) {\n    return null\n  }\n\n  if (typeof content === 'function') {\n    return normalizeContent(content())\n  }\n\n  if (typeof content === 'string') {\n    return parseJsonOrYaml(content)\n  }\n\n  return content\n}\n\n/** Process a single spec configuration so that it has a title and a slug */\nconst addSlugAndTitle = (\n  source: ConfigWithRequiredSource,\n  index = 0,\n  slug: (v: string) => string,\n): ConfigWithRequiredSource & { slug: string; title: string } => {\n  // Case 1: Title exists, generate slug from it\n  if (source.title) {\n    return {\n      ...source,\n      slug: source.slug || slug(source.title),\n      title: source.title,\n    }\n  }\n\n  // Case 2: Slug exists but no title, use slug as title\n  if (source.slug) {\n    return {\n      ...source,\n      slug: slug(source.slug),\n      title: source.slug,\n    }\n  }\n\n  // Case 3: Neither exists, use index\n  return {\n    ...source,\n    slug: `api-${index + 1}`,\n    title: `API #${index + 1}`,\n  }\n}\n"],"mappings":";;;;;AA8BA,IAAM,8BAA8B,UAAkF;CACpH,OAAO,CAAC,CAAC,MAAM,KAAK,KAAK,KAAK,CAAC,CAAC,MAAM;AACxC;;;;AAKA,IAAa,2BACX,kBAC6B;CAC7B,MAAM,EAAE,SAAS,QAAQ;CAEzB,MAAM,aAAuC,CAAC;CAE9C,IAAI,CAAC,eACH,OAAO;CAKT,CAFmB,MAAM,QAAQ,aAAa,IAAI,gBAAgB,CAAC,aAAa,EAAA,CAI7E,SAAS,MAAM;EAEd,IAAI,2BAA2B,CAAC,GAAG;GAEjC,MAAM,EAAE,SAAS,eAAe,GAAG,SAAS;GAK5C,OAAO,eAAe,KAAK,YAAY;IAAE,GAAG;IAAM,GAAG;GAAO,EAAE,KAAK,CAAC;EACtE;EAGA,OAAO,CAAC,CAAC;CACX,CAAC,CAAC,CACD,KAAK,WAAW,0CAA0C,MAAM,CAAwC,CAAC,CAEzG,OAAO,0BAA0B,CAAC,CAElC,KAAK,QAAQ,UAAU,gBAAgB,QAAQ,OAAO,IAAI,CAAC,CAAC,CAE5D,SAAS,MAAM;EACd,MAAM,EAAE,KAAK,SAAS,GAAG,WAAW;EACpC,WAAW,EAAE,QAAQ;GACnB;GACA,OAAO,EAAE;GACT,MAAM,EAAE;GACR,SAAS,CAAC,CAAC,GAAG;GACd,OAAO,EAAE;GACT,QAAQ,UAAU,EAAE,SAAS,iBAAiB,OAAO,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI;EACzE;CACF,CAAC;CAGH,OAAO;AACT;;AAGA,IAAa,oBACX,YACmC;CACnC,IAAI,CAAC,SACH,OAAO;CAGT,IAAI,OAAO,YAAY,YACrB,OAAO,iBAAiB,QAAQ,CAAC;CAGnC,IAAI,OAAO,YAAY,UACrB,OAAO,gBAAgB,OAAO;CAGhC,OAAO;AACT;;AAGA,IAAM,mBACJ,QACA,QAAQ,GACR,SAC+D;CAE/D,IAAI,OAAO,OACT,OAAO;EACL,GAAG;EACH,MAAM,OAAO,QAAQ,KAAK,OAAO,KAAK;EACtC,OAAO,OAAO;CAChB;CAIF,IAAI,OAAO,MACT,OAAO;EACL,GAAG;EACH,MAAM,KAAK,OAAO,IAAI;EACtB,OAAO,OAAO;CAChB;CAIF,OAAO;EACL,GAAG;EACH,MAAM,OAAO,QAAQ;EACrB,OAAO,QAAQ,QAAQ;CACzB;AACF"}

package/dist/helpers/openapi.d.ts

@@ -37,7 +37,12 @@ export declare function extractSchemaFieldNames(schema: SchemaObject | undefined
  */
 export declare function extractSchemaDescriptions(schema: SchemaObject | undefined): string[];
 /**
- * Deep merge for objects
+ * Deep merge for objects.
+ *
+ * OpenAPI documents are untrusted input and can carry keys like `__proto__`, `constructor`, or
+ * `prototype` (a schema is free to describe a property named `constructor`). Those keys are merged
+ * as ordinary own data, so nothing is silently dropped, but the merge never writes through the
+ * prototype chain, which would otherwise pollute `Object.prototype` for every object on the page.
  */
 export declare function deepMerge(source: Record<any, any>, target: Record<any, any>): Record<any, any>;
 /**

package/dist/helpers/openapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/helpers/openapi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EAEb,MAAM,8DAA8D,CAAA;AAmFrE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,EAAE,GAAG,MAAM,EAAE,CAS5F;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,EAAE,GAAG,MAAM,EAAE,CASnG;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,EAAE,CAQ1E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,EAAE,CAU5E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,EAAE,CAQlF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,EAAE,CAYpF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,oBAW3E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,mBA4BvF"}
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/helpers/openapi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EAEb,MAAM,8DAA8D,CAAA;AAmFrE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,EAAE,GAAG,MAAM,EAAE,CAS5F;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,EAAE,GAAG,MAAM,EAAE,CASnG;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,EAAE,CAQ1E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,EAAE,CAU5E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,EAAE,CAQlF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,EAAE,CAYpF;AA2BD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAe9F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,mBA4BvF"}

package/dist/helpers/openapi.js

@@ -65,7 +65,8 @@ function forEachRequestBodyProperty(operation, visit) {
 function extractParameterNames(parameters) {
 	const names = [];
 	parameters.forEach((parameter) => {
-		pushUnique(names, getResolvedRef(parameter)?.name);
+		const resolved = getResolvedRef(parameter);
+		pushUnique(names, resolved?.name);
 	});
 	return names;
 }
@@ -77,7 +78,8 @@ function extractParameterNames(parameters) {
 function extractParameterDescriptions(parameters) {
 	const descriptions = [];
 	parameters.forEach((parameter) => {
-		pushUnique(descriptions, getResolvedRef(parameter)?.description);
+		const resolved = getResolvedRef(parameter);
+		pushUnique(descriptions, resolved?.description);
 	});
 	return descriptions;
 }
@@ -134,13 +136,42 @@ function extractSchemaDescriptions(schema) {
 	return descriptions;
 }
 /**
-* Deep merge for objects
+* Assigns a value as an ordinary own, enumerable data property.
+*
+* `target.__proto__ = value` runs the prototype setter instead of creating a property, so a
+* document with a `__proto__` key could otherwise change the prototype of the merged object.
+* Defining the property explicitly keeps a key with that name as plain data.
+*/
+var defineOwnProperty = (target, key, value) => {
+	if (key === "__proto__") Object.defineProperty(target, key, {
+		value,
+		writable: true,
+		enumerable: true,
+		configurable: true
+	});
+	else target[key] = value;
+};
+/**
+* Whether `target` already has its own mergeable object under `key`.
+*
+* Only an own object is a safe merge target. Reaching an inherited property — every object inherits
+* `constructor`, and `__proto__` resolves to an accessor on `Object.prototype` — would let a
+* document walk up to `Object.prototype` and add a property to every object on the page.
+*/
+var hasOwnObject = (target, key) => Object.hasOwn(target, key) && target[key] !== null && typeof target[key] === "object";
+/**
+* Deep merge for objects.
+*
+* OpenAPI documents are untrusted input and can carry keys like `__proto__`, `constructor`, or
+* `prototype` (a schema is free to describe a property named `constructor`). Those keys are merged
+* as ordinary own data, so nothing is silently dropped, but the merge never writes through the
+* prototype chain, which would otherwise pollute `Object.prototype` for every object on the page.
 */
 function deepMerge(source, target) {
 	for (const [key, val] of Object.entries(source)) if (val !== null && typeof val === "object") {
-		target[key] ??= new val.__proto__.constructor();
+		if (!hasOwnObject(target, key)) defineOwnProperty(target, key, Array.isArray(val) ? [] : {});
 		deepMerge(val, target[key]);
-	} else if (typeof val !== "undefined") target[key] = val;
+	} else if (typeof val !== "undefined") defineOwnProperty(target, key, val);
 	return target;
 }
 /**
@@ -170,6 +201,6 @@ function createEmptySpecification(partialSpecification) {
 	return emptySpecification;
 }
 //#endregion
-export { createEmptySpecification, extractBodyDescriptions, extractBodyFieldNames, extractParameterDescriptions, extractParameterNames, extractSchemaDescriptions, extractSchemaFieldNames };
+export { createEmptySpecification, deepMerge, extractBodyDescriptions, extractBodyFieldNames, extractParameterDescriptions, extractParameterNames, extractSchemaDescriptions, extractSchemaFieldNames };
 
 //# sourceMappingURL=openapi.js.map