@scalar/api-reference 1.63.0 → 1.64.1

package/dist/helpers/openapi.js.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.js","names":[],"sources":["../../src/helpers/openapi.ts"],"sourcesContent":["import { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport type {\n  MediaTypeObject,\n  OpenApiDocument,\n  OperationObject,\n  ParameterObject,\n  ReferenceType,\n  SchemaObject,\n  SchemaReferenceType,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isObjectSchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\n\nconst isSchemaObject = (value: unknown): value is SchemaObject => typeof value === 'object' && value !== null\n\n/**\n * Resolves a schema reference from workspace-store to a SchemaObject.\n * Returns undefined when a reference exists but has not been resolved yet.\n */\nfunction resolveSchemaRef(ref: SchemaReferenceType<SchemaObject>): SchemaObject | undefined {\n  if (typeof ref === 'object' && ref !== null && '$ref' in ref) {\n    return isSchemaObject(ref['$ref-value']) ? ref['$ref-value'] : undefined\n  }\n\n  return ref\n}\n\nfunction pushUnique(target: string[], value: string | undefined): void {\n  if (!value) {\n    return\n  }\n  if (!target.includes(value)) {\n    target.push(value)\n  }\n}\n\ntype CollectOptions = {\n  visit: (key: string, schema: SchemaObject | undefined) => void\n  visited: Set<SchemaObject>\n  maxPropertyDepth: number\n}\n\n/**\n * Recursively visits every property of a schema, descending transparently through composition\n * keywords (`oneOf`, `anyOf`, `allOf`) and one level into nested object properties.\n *\n * Composition is treated as transparent — a `oneOf` of two object variants is *the same level* as a\n * single object, just expressed as multiple shapes. Property nesting is capped to keep the index\n * focused on shallow, commonly-searched fields. A visited-set keyed by resolved-schema identity\n * guards against recursive (`Tree → Tree`) schemas.\n */\nfunction collectSchemaProperties(schema: SchemaObject | undefined, options: CollectOptions, propertyDepth = 0): void {\n  if (!schema || options.visited.has(schema)) {\n    return\n  }\n  options.visited.add(schema)\n\n  const variants = [...(schema.oneOf ?? []), ...(schema.anyOf ?? []), ...(schema.allOf ?? [])]\n  variants.forEach((variantRef) => {\n    collectSchemaProperties(resolveSchemaRef(variantRef), options, propertyDepth)\n  })\n\n  if (isObjectSchema(schema) && schema.properties) {\n    Object.entries(schema.properties).forEach(([key, propRef]) => {\n      const property = resolveSchemaRef(propRef)\n      options.visit(key, property)\n      if (propertyDepth + 1 < options.maxPropertyDepth) {\n        collectSchemaProperties(property, options, propertyDepth + 1)\n      }\n    })\n  }\n}\n\n/**\n * Walks the request body schemas of an operation and yields each property schema with its key.\n */\nfunction forEachRequestBodyProperty(\n  operation: OperationObject,\n  visit: (key: string, schema: SchemaObject | undefined) => void,\n): void {\n  const content = getResolvedRef(operation?.requestBody)?.content\n  if (!content) {\n    return\n  }\n\n  const visited = new Set<SchemaObject>()\n  Object.values(content).forEach((media) => {\n    const resolvedMedia = getResolvedRef(media) as MediaTypeObject | undefined\n    const schema = getResolvedRef(resolvedMedia?.schema)\n    collectSchemaProperties(schema, { visit, visited, maxPropertyDepth: 2 })\n  })\n}\n\n/**\n * Extracts the names of every parameter on an operation.\n *\n * The returned strings contain only parameter names (e.g. `userId`, `limit`) so they can be indexed\n * as a high-signal field for search. Filter-style metadata like `REQUIRED`, `optional`, `query` and\n * the schema type are intentionally excluded — those tokens dilute fuzzy matches and produce false\n * positives for queries like `query` or `integer`.\n */\nexport function extractParameterNames(parameters: ReferenceType<ParameterObject>[]): string[] {\n  const names: string[] = []\n\n  parameters.forEach((parameter) => {\n    const resolved = getResolvedRef(parameter)\n    pushUnique(names, resolved?.name)\n  })\n\n  return names\n}\n\n/**\n * Extracts the descriptions of every parameter on an operation.\n *\n * Kept separate from parameter names so the search index can weight each independently.\n */\nexport function extractParameterDescriptions(parameters: ReferenceType<ParameterObject>[]): string[] {\n  const descriptions: string[] = []\n\n  parameters.forEach((parameter) => {\n    const resolved = getResolvedRef(parameter)\n    pushUnique(descriptions, resolved?.description)\n  })\n\n  return descriptions\n}\n\n/**\n * Extracts the names of properties from the request body schema(s) of an operation.\n *\n * Walks every media type and includes both top-level and one level of nested property names so\n * common fields like `email` or `username` surface in search regardless of how the body is shaped.\n */\nexport function extractBodyFieldNames(operation: OperationObject): string[] {\n  const names: string[] = []\n\n  forEachRequestBodyProperty(operation, (key) => {\n    pushUnique(names, key)\n  })\n\n  return names\n}\n\n/**\n * Extracts the descriptions of properties from the request body schema(s) of an operation.\n */\nexport function extractBodyDescriptions(operation: OperationObject): string[] {\n  const descriptions: string[] = []\n\n  forEachRequestBodyProperty(operation, (_key, schema) => {\n    if (schema && 'description' in schema && typeof schema.description === 'string') {\n      pushUnique(descriptions, schema.description)\n    }\n  })\n\n  return descriptions\n}\n\n/**\n * Extracts the property names of a schema for the search index.\n *\n * Same depth and composition behavior as `extractBodyFieldNames` — descends transparently through\n * `oneOf`/`anyOf`/`allOf`, walks one level into nested object properties, dedupes.\n */\nexport function extractSchemaFieldNames(schema: SchemaObject | undefined): string[] {\n  const names: string[] = []\n  collectSchemaProperties(schema, {\n    visit: (key) => pushUnique(names, key),\n    visited: new Set<SchemaObject>(),\n    maxPropertyDepth: 2,\n  })\n  return names\n}\n\n/**\n * Extracts the property descriptions of a schema for the search index.\n */\nexport function extractSchemaDescriptions(schema: SchemaObject | undefined): string[] {\n  const descriptions: string[] = []\n  collectSchemaProperties(schema, {\n    visit: (_key, propertySchema) => {\n      if (propertySchema && 'description' in propertySchema && typeof propertySchema.description === 'string') {\n        pushUnique(descriptions, propertySchema.description)\n      }\n    },\n    visited: new Set<SchemaObject>(),\n    maxPropertyDepth: 2,\n  })\n  return descriptions\n}\n\n/**\n * Deep merge for objects\n */\nexport function deepMerge(source: Record<any, any>, target: Record<any, any>) {\n  for (const [key, val] of Object.entries(source)) {\n    if (val !== null && typeof val === 'object') {\n      target[key] ??= new val.__proto__.constructor()\n      deepMerge(val, target[key])\n    } else if (typeof val !== 'undefined') {\n      target[key] = val\n    }\n  }\n\n  return target\n}\n\n/**\n * Creates an empty specification object.\n * The returning object has the same structure as a valid OpenAPI specification, but everything is empty.\n */\nexport function createEmptySpecification(partialSpecification?: Partial<OpenApiDocument>) {\n  const emptySpecification = {\n    openapi: '3.1.0',\n    info: {\n      title: '',\n      description: '',\n      termsOfService: '',\n      version: '',\n      license: {\n        name: '',\n        url: '',\n      },\n      contact: {\n        email: '',\n      },\n    },\n    servers: [],\n    tags: [],\n    'x-scalar-original-document-hash': '',\n  }\n\n  if (!partialSpecification) {\n    return emptySpecification as OpenApiDocument\n  }\n\n  deepMerge(partialSpecification, emptySpecification)\n\n  return emptySpecification as OpenApiDocument\n}\n"],"mappings":"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"}
+{"version":3,"file":"openapi.js","names":[],"sources":["../../src/helpers/openapi.ts"],"sourcesContent":["import { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport type {\n  MediaTypeObject,\n  OpenApiDocument,\n  OperationObject,\n  ParameterObject,\n  ReferenceType,\n  SchemaObject,\n  SchemaReferenceType,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isObjectSchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\n\nconst isSchemaObject = (value: unknown): value is SchemaObject => typeof value === 'object' && value !== null\n\n/**\n * Resolves a schema reference from workspace-store to a SchemaObject.\n * Returns undefined when a reference exists but has not been resolved yet.\n */\nfunction resolveSchemaRef(ref: SchemaReferenceType<SchemaObject>): SchemaObject | undefined {\n  if (typeof ref === 'object' && ref !== null && '$ref' in ref) {\n    return isSchemaObject(ref['$ref-value']) ? ref['$ref-value'] : undefined\n  }\n\n  return ref\n}\n\nfunction pushUnique(target: string[], value: string | undefined): void {\n  if (!value) {\n    return\n  }\n  if (!target.includes(value)) {\n    target.push(value)\n  }\n}\n\ntype CollectOptions = {\n  visit: (key: string, schema: SchemaObject | undefined) => void\n  visited: Set<SchemaObject>\n  maxPropertyDepth: number\n}\n\n/**\n * Recursively visits every property of a schema, descending transparently through composition\n * keywords (`oneOf`, `anyOf`, `allOf`) and one level into nested object properties.\n *\n * Composition is treated as transparent — a `oneOf` of two object variants is *the same level* as a\n * single object, just expressed as multiple shapes. Property nesting is capped to keep the index\n * focused on shallow, commonly-searched fields. A visited-set keyed by resolved-schema identity\n * guards against recursive (`Tree → Tree`) schemas.\n */\nfunction collectSchemaProperties(schema: SchemaObject | undefined, options: CollectOptions, propertyDepth = 0): void {\n  if (!schema || options.visited.has(schema)) {\n    return\n  }\n  options.visited.add(schema)\n\n  const variants = [...(schema.oneOf ?? []), ...(schema.anyOf ?? []), ...(schema.allOf ?? [])]\n  variants.forEach((variantRef) => {\n    collectSchemaProperties(resolveSchemaRef(variantRef), options, propertyDepth)\n  })\n\n  if (isObjectSchema(schema) && schema.properties) {\n    Object.entries(schema.properties).forEach(([key, propRef]) => {\n      const property = resolveSchemaRef(propRef)\n      options.visit(key, property)\n      if (propertyDepth + 1 < options.maxPropertyDepth) {\n        collectSchemaProperties(property, options, propertyDepth + 1)\n      }\n    })\n  }\n}\n\n/**\n * Walks the request body schemas of an operation and yields each property schema with its key.\n */\nfunction forEachRequestBodyProperty(\n  operation: OperationObject,\n  visit: (key: string, schema: SchemaObject | undefined) => void,\n): void {\n  const content = getResolvedRef(operation?.requestBody)?.content\n  if (!content) {\n    return\n  }\n\n  const visited = new Set<SchemaObject>()\n  Object.values(content).forEach((media) => {\n    const resolvedMedia = getResolvedRef(media) as MediaTypeObject | undefined\n    const schema = getResolvedRef(resolvedMedia?.schema)\n    collectSchemaProperties(schema, { visit, visited, maxPropertyDepth: 2 })\n  })\n}\n\n/**\n * Extracts the names of every parameter on an operation.\n *\n * The returned strings contain only parameter names (e.g. `userId`, `limit`) so they can be indexed\n * as a high-signal field for search. Filter-style metadata like `REQUIRED`, `optional`, `query` and\n * the schema type are intentionally excluded — those tokens dilute fuzzy matches and produce false\n * positives for queries like `query` or `integer`.\n */\nexport function extractParameterNames(parameters: ReferenceType<ParameterObject>[]): string[] {\n  const names: string[] = []\n\n  parameters.forEach((parameter) => {\n    const resolved = getResolvedRef(parameter)\n    pushUnique(names, resolved?.name)\n  })\n\n  return names\n}\n\n/**\n * Extracts the descriptions of every parameter on an operation.\n *\n * Kept separate from parameter names so the search index can weight each independently.\n */\nexport function extractParameterDescriptions(parameters: ReferenceType<ParameterObject>[]): string[] {\n  const descriptions: string[] = []\n\n  parameters.forEach((parameter) => {\n    const resolved = getResolvedRef(parameter)\n    pushUnique(descriptions, resolved?.description)\n  })\n\n  return descriptions\n}\n\n/**\n * Extracts the names of properties from the request body schema(s) of an operation.\n *\n * Walks every media type and includes both top-level and one level of nested property names so\n * common fields like `email` or `username` surface in search regardless of how the body is shaped.\n */\nexport function extractBodyFieldNames(operation: OperationObject): string[] {\n  const names: string[] = []\n\n  forEachRequestBodyProperty(operation, (key) => {\n    pushUnique(names, key)\n  })\n\n  return names\n}\n\n/**\n * Extracts the descriptions of properties from the request body schema(s) of an operation.\n */\nexport function extractBodyDescriptions(operation: OperationObject): string[] {\n  const descriptions: string[] = []\n\n  forEachRequestBodyProperty(operation, (_key, schema) => {\n    if (schema && 'description' in schema && typeof schema.description === 'string') {\n      pushUnique(descriptions, schema.description)\n    }\n  })\n\n  return descriptions\n}\n\n/**\n * Extracts the property names of a schema for the search index.\n *\n * Same depth and composition behavior as `extractBodyFieldNames` — descends transparently through\n * `oneOf`/`anyOf`/`allOf`, walks one level into nested object properties, dedupes.\n */\nexport function extractSchemaFieldNames(schema: SchemaObject | undefined): string[] {\n  const names: string[] = []\n  collectSchemaProperties(schema, {\n    visit: (key) => pushUnique(names, key),\n    visited: new Set<SchemaObject>(),\n    maxPropertyDepth: 2,\n  })\n  return names\n}\n\n/**\n * Extracts the property descriptions of a schema for the search index.\n */\nexport function extractSchemaDescriptions(schema: SchemaObject | undefined): string[] {\n  const descriptions: string[] = []\n  collectSchemaProperties(schema, {\n    visit: (_key, propertySchema) => {\n      if (propertySchema && 'description' in propertySchema && typeof propertySchema.description === 'string') {\n        pushUnique(descriptions, propertySchema.description)\n      }\n    },\n    visited: new Set<SchemaObject>(),\n    maxPropertyDepth: 2,\n  })\n  return descriptions\n}\n\n/**\n * Assigns a value as an ordinary own, enumerable data property.\n *\n * `target.__proto__ = value` runs the prototype setter instead of creating a property, so a\n * document with a `__proto__` key could otherwise change the prototype of the merged object.\n * Defining the property explicitly keeps a key with that name as plain data.\n */\nconst defineOwnProperty = (target: Record<any, any>, key: string, value: unknown): void => {\n  if (key === '__proto__') {\n    Object.defineProperty(target, key, { value, writable: true, enumerable: true, configurable: true })\n  } else {\n    target[key] = value\n  }\n}\n\n/**\n * Whether `target` already has its own mergeable object under `key`.\n *\n * Only an own object is a safe merge target. Reaching an inherited property — every object inherits\n * `constructor`, and `__proto__` resolves to an accessor on `Object.prototype` — would let a\n * document walk up to `Object.prototype` and add a property to every object on the page.\n */\nconst hasOwnObject = (target: Record<any, any>, key: string): boolean =>\n  Object.hasOwn(target, key) && target[key] !== null && typeof target[key] === 'object'\n\n/**\n * Deep merge for objects.\n *\n * OpenAPI documents are untrusted input and can carry keys like `__proto__`, `constructor`, or\n * `prototype` (a schema is free to describe a property named `constructor`). Those keys are merged\n * as ordinary own data, so nothing is silently dropped, but the merge never writes through the\n * prototype chain, which would otherwise pollute `Object.prototype` for every object on the page.\n */\nexport function deepMerge(source: Record<any, any>, target: Record<any, any>): Record<any, any> {\n  for (const [key, val] of Object.entries(source)) {\n    if (val !== null && typeof val === 'object') {\n      if (!hasOwnObject(target, key)) {\n        // Match the shape of the source value rather than reaching through its prototype, which\n        // also keeps objects created with a `null` prototype from throwing.\n        defineOwnProperty(target, key, Array.isArray(val) ? [] : {})\n      }\n      deepMerge(val, target[key])\n    } else if (typeof val !== 'undefined') {\n      defineOwnProperty(target, key, val)\n    }\n  }\n\n  return target\n}\n\n/**\n * Creates an empty specification object.\n * The returning object has the same structure as a valid OpenAPI specification, but everything is empty.\n */\nexport function createEmptySpecification(partialSpecification?: Partial<OpenApiDocument>) {\n  const emptySpecification = {\n    openapi: '3.1.0',\n    info: {\n      title: '',\n      description: '',\n      termsOfService: '',\n      version: '',\n      license: {\n        name: '',\n        url: '',\n      },\n      contact: {\n        email: '',\n      },\n    },\n    servers: [],\n    tags: [],\n    'x-scalar-original-document-hash': '',\n  }\n\n  if (!partialSpecification) {\n    return emptySpecification as OpenApiDocument\n  }\n\n  deepMerge(partialSpecification, emptySpecification)\n\n  return emptySpecification as OpenApiDocument\n}\n"],"mappings":"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"}

package/dist/helpers/safe-deep-clone.js.map

@@ -1 +1 @@
-{"version":3,"file":"safe-deep-clone.js","names":[],"sources":["../../src/helpers/safe-deep-clone.ts"],"sourcesContent":["import { deepClone } from '@scalar/workspace-store/helpers/deep-clone'\n\n/**\n * Deep-clones plain data for use where mutation must not affect the source.\n *\n * In the browser we use `structuredClone`, which preserves `Date`, `Map`, `Set`,\n * typed arrays, and other structured types. During SSR there is no `window`, so\n * we fall back to `JSON.parse(JSON.stringify(...))`, which only supports JSON\n * values (functions, `undefined` in objects, symbols, etc. are dropped or altered).\n *\n * @example\n * ```ts\n * const copy = safeDeepClone(spec)\n * copy.info.title = 'Draft'\n * // original spec is unchanged\n * ```\n */\nexport const safeDeepClone = <T>(value: T): T => {\n  if (typeof window === 'undefined') {\n    return deepClone(value)\n  }\n  return window.structuredClone(value) as T\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,IAAa,iBAAoB,UAAgB;AAC/C,KAAI,OAAO,WAAW,YACpB,QAAO,UAAU,MAAM;AAEzB,QAAO,OAAO,gBAAgB,MAAM"}
+{"version":3,"file":"safe-deep-clone.js","names":[],"sources":["../../src/helpers/safe-deep-clone.ts"],"sourcesContent":["import { deepClone } from '@scalar/workspace-store/helpers/deep-clone'\n\n/**\n * Deep-clones plain data for use where mutation must not affect the source.\n *\n * In the browser we use `structuredClone`, which preserves `Date`, `Map`, `Set`,\n * typed arrays, and other structured types. During SSR there is no `window`, so\n * we fall back to `JSON.parse(JSON.stringify(...))`, which only supports JSON\n * values (functions, `undefined` in objects, symbols, etc. are dropped or altered).\n *\n * @example\n * ```ts\n * const copy = safeDeepClone(spec)\n * copy.info.title = 'Draft'\n * // original spec is unchanged\n * ```\n */\nexport const safeDeepClone = <T>(value: T): T => {\n  if (typeof window === 'undefined') {\n    return deepClone(value)\n  }\n  return window.structuredClone(value) as T\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,IAAa,iBAAoB,UAAgB;CAC/C,IAAI,OAAO,WAAW,aACpB,OAAO,UAAU,KAAK;CAExB,OAAO,OAAO,gBAAgB,KAAK;AACrC"}

package/dist/helpers/storage.d.ts

@@ -225,7 +225,7 @@ export declare const authStorage: () => {
                     authorizationUrl: string;
                     tokenUrl: string;
                 } & {
-                    'x-usePkce': "SHA-256" | "plain" | "no";
+                    'x-usePkce': "plain" | "SHA-256" | "no";
                 } & {
                     'x-scalar-credentials-location'?: "body" | "header" | undefined;
                 } & {
@@ -242,7 +242,26 @@ export declare const authStorage: () => {
                     'x-scalar-credentials-location'?: "body" | "header" | undefined;
                 }) | undefined;
                 type: "openIdConnect";
-            };
+            } | ({
+                type: "userPassword" | "plain" | "scramSha256" | "scramSha512";
+            } & {
+                'x-scalar-secret-username': string;
+                'x-scalar-secret-password': string;
+            }) | ({
+                type: "X509";
+            } & {
+                'x-scalar-secret-client-certificate': string;
+            } & {
+                'x-scalar-secret-private-key': string;
+            }) | ({
+                type: "symmetricEncryption" | "asymmetricEncryption";
+            } & {
+                'x-scalar-secret-token': string;
+            }) | ({
+                type: "gssapi";
+            } & {
+                'x-scalar-secret-service-name': string;
+            });
         };
     };
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/helpers/storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAc,MAAM,uCAAuC,CAAA;AAM7E;;;GAGG;AACH,eAAO,MAAM,aAAa;IAGtB;;OAEG;;IAIH;;;OAGG;iBACU,MAAM;CAItB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW;IAMpB;;OAEG;oBACa,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAItB;;;OAGG;oBACa,MAAM,SAAS,IAAI;CAItC,CAAA"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/helpers/storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAc,MAAM,uCAAuC,CAAA;AAM7E;;;GAGG;AACH,eAAO,MAAM,aAAa;IAGtB;;OAEG;;IAIH;;;OAGG;iBACU,MAAM;CAItB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW;IAMpB;;OAEG;oBACa,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAItB;;;OAGG;oBACa,MAAM,SAAS,IAAI;CAItC,CAAA"}

package/dist/helpers/storage.js

@@ -10,9 +10,16 @@ var storage = safeLocalStorage();
 var clientStorage = () => {
 	const key = REFERENCE_LS_KEYS.SELECTED_CLIENT;
 	return {
+		/**
+		* Gets the stored selected client from local storage.
+		*/
 		get: () => {
 			return storage.getItem(key);
 		},
+		/**
+		* Stores the selected client value in local storage.
+		* @param value The value to store
+		*/
 		set: (value) => {
 			storage.setItem(key, value);
 		}
@@ -28,9 +35,16 @@ var authStorage = () => {
 		return `${REFERENCE_LS_KEYS.AUTH}-${slug}`;
 	};
 	return {
+		/**
+		* Retrieves and coerces the authentication schemes stored in local storage.
+		*/
 		getAuth: (slug) => {
 			return coerceValue(AuthSchema, JSON.parse(storage.getItem(getKey(slug)) ?? "{}"));
 		},
+		/**
+		* Stores the authentication schemes in local storage.
+		* @param value The Auth object to stringify and store.
+		*/
 		setAuth: (slug, value) => {
 			storage.setItem(getKey(slug), JSON.stringify(value));
 		}

package/dist/helpers/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","names":[],"sources":["../../src/helpers/storage.ts"],"sourcesContent":["import { REFERENCE_LS_KEYS, safeLocalStorage } from '@scalar/helpers/object/local-storage'\nimport { type Auth, AuthSchema } from '@scalar/workspace-store/entities/auth'\nimport { coerceValue } from '@scalar/workspace-store/schemas/typebox-coerce'\n\n// Local storage helper instance, safely wrapped.\nconst storage = safeLocalStorage()\n\n/**\n * Provides an interface to store and retrieve the selected client value\n * in local storage.\n */\nexport const clientStorage = () => {\n  const key = REFERENCE_LS_KEYS.SELECTED_CLIENT\n  return {\n    /**\n     * Gets the stored selected client from local storage.\n     */\n    get: () => {\n      return storage.getItem(key)\n    },\n    /**\n     * Stores the selected client value in local storage.\n     * @param value The value to store\n     */\n    set: (value: string) => {\n      storage.setItem(key, value as string)\n    },\n  }\n}\n\n/**\n * Provides an interface to store and retrieve authentication scheme\n * information in local storage, including both the available schemes and\n * the user's selected schemes.\n */\nexport const authStorage = () => {\n  const getKey = (slug: string) => {\n    return `${REFERENCE_LS_KEYS.AUTH}-${slug}`\n  }\n\n  return {\n    /**\n     * Retrieves and coerces the authentication schemes stored in local storage.\n     */\n    getAuth: (slug: string) => {\n      const parsed = JSON.parse(storage.getItem(getKey(slug)) ?? '{}')\n      return coerceValue(AuthSchema, parsed)\n    },\n    /**\n     * Stores the authentication schemes in local storage.\n     * @param value The Auth object to stringify and store.\n     */\n    setAuth: (slug: string, value: Auth) => {\n      storage.setItem(getKey(slug), JSON.stringify(value))\n    },\n  }\n}\n"],"mappings":";;;;AAKA,IAAM,UAAU,kBAAkB;;;;;AAMlC,IAAa,sBAAsB;CACjC,MAAM,MAAM,kBAAkB;AAC9B,QAAO;EAIL,WAAW;AACT,UAAO,QAAQ,QAAQ,IAAI;;EAM7B,MAAM,UAAkB;AACtB,WAAQ,QAAQ,KAAK,MAAgB;;EAExC;;;;;;;AAQH,IAAa,oBAAoB;CAC/B,MAAM,UAAU,SAAiB;AAC/B,SAAO,GAAG,kBAAkB,KAAK,GAAG;;AAGtC,QAAO;EAIL,UAAU,SAAiB;AAEzB,UAAO,YAAY,YADJ,KAAK,MAAM,QAAQ,QAAQ,OAAO,KAAK,CAAC,IAAI,KAAK,CAC1B;;EAMxC,UAAU,MAAc,UAAgB;AACtC,WAAQ,QAAQ,OAAO,KAAK,EAAE,KAAK,UAAU,MAAM,CAAC;;EAEvD"}
+{"version":3,"file":"storage.js","names":[],"sources":["../../src/helpers/storage.ts"],"sourcesContent":["import { REFERENCE_LS_KEYS, safeLocalStorage } from '@scalar/helpers/object/local-storage'\nimport { type Auth, AuthSchema } from '@scalar/workspace-store/entities/auth'\nimport { coerceValue } from '@scalar/workspace-store/schemas/typebox-coerce'\n\n// Local storage helper instance, safely wrapped.\nconst storage = safeLocalStorage()\n\n/**\n * Provides an interface to store and retrieve the selected client value\n * in local storage.\n */\nexport const clientStorage = () => {\n  const key = REFERENCE_LS_KEYS.SELECTED_CLIENT\n  return {\n    /**\n     * Gets the stored selected client from local storage.\n     */\n    get: () => {\n      return storage.getItem(key)\n    },\n    /**\n     * Stores the selected client value in local storage.\n     * @param value The value to store\n     */\n    set: (value: string) => {\n      storage.setItem(key, value as string)\n    },\n  }\n}\n\n/**\n * Provides an interface to store and retrieve authentication scheme\n * information in local storage, including both the available schemes and\n * the user's selected schemes.\n */\nexport const authStorage = () => {\n  const getKey = (slug: string) => {\n    return `${REFERENCE_LS_KEYS.AUTH}-${slug}`\n  }\n\n  return {\n    /**\n     * Retrieves and coerces the authentication schemes stored in local storage.\n     */\n    getAuth: (slug: string) => {\n      const parsed = JSON.parse(storage.getItem(getKey(slug)) ?? '{}')\n      return coerceValue(AuthSchema, parsed)\n    },\n    /**\n     * Stores the authentication schemes in local storage.\n     * @param value The Auth object to stringify and store.\n     */\n    setAuth: (slug: string, value: Auth) => {\n      storage.setItem(getKey(slug), JSON.stringify(value))\n    },\n  }\n}\n"],"mappings":";;;;AAKA,IAAM,UAAU,iBAAiB;;;;;AAMjC,IAAa,sBAAsB;CACjC,MAAM,MAAM,kBAAkB;CAC9B,OAAO;;;;EAIL,WAAW;GACT,OAAO,QAAQ,QAAQ,GAAG;EAC5B;;;;;EAKA,MAAM,UAAkB;GACtB,QAAQ,QAAQ,KAAK,KAAe;EACtC;CACF;AACF;;;;;;AAOA,IAAa,oBAAoB;CAC/B,MAAM,UAAU,SAAiB;EAC/B,OAAO,GAAG,kBAAkB,KAAK,GAAG;CACtC;CAEA,OAAO;;;;EAIL,UAAU,SAAiB;GAEzB,OAAO,YAAY,YADJ,KAAK,MAAM,QAAQ,QAAQ,OAAO,IAAI,CAAC,KAAK,IAC5B,CAAM;EACvC;;;;;EAKA,UAAU,MAAc,UAAgB;GACtC,QAAQ,QAAQ,OAAO,IAAI,GAAG,KAAK,UAAU,KAAK,CAAC;EACrD;CACF;AACF"}

package/dist/helpers/upload-temp-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload-temp-document.js","names":[],"sources":["../../src/helpers/upload-temp-document.ts"],"sourcesContent":["import { redirectToProxy } from '@scalar/helpers/url/redirect-to-proxy'\nimport type { ExternalUrls } from '@scalar/types/api-reference'\n\n/** Type guard for the response body */\nfunction isResponseBody(data: unknown): data is { url: string } {\n  return !!data && typeof data === 'object' && 'url' in data && typeof (data as any).url === 'string'\n}\n\n/** Upload a document and return a temporary URL */\nexport async function uploadTempDocument(\n  document: string,\n  urls: Pick<ExternalUrls, 'proxyUrl' | 'apiBaseUrl'>,\n): Promise<string> {\n  const body = JSON.stringify({ document })\n  const uploadUrl = `${urls.apiBaseUrl}/core/share/upload/apis`\n\n  // Proxy the request to avoid localhost CORS issues\n  const response = await fetch(redirectToProxy(urls.proxyUrl, uploadUrl), {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body,\n  })\n\n  if (!response.ok) {\n    throw new Error(` Failed to generate temporary link, server responded with ${response.status}`)\n  }\n  const data = (await response.json()) as unknown\n\n  if (!isResponseBody(data)) {\n    throw new Error('Failed to generate temporary link, invalid response from server')\n  }\n\n  return data.url\n}\n"],"mappings":";;;AAIA,SAAS,eAAe,MAAwC;AAC9D,QAAO,CAAC,CAAC,QAAQ,OAAO,SAAS,YAAY,SAAS,QAAQ,OAAQ,KAAa,QAAQ;;;AAI7F,eAAsB,mBACpB,UACA,MACiB;CACjB,MAAM,OAAO,KAAK,UAAU,EAAE,UAAU,CAAC;CACzC,MAAM,YAAY,GAAG,KAAK,WAAW;CAGrC,MAAM,WAAW,MAAM,MAAM,gBAAgB,KAAK,UAAU,UAAU,EAAE;EACtE,QAAQ;EACR,SAAS,EAAE,gBAAgB,oBAAoB;EAC/C;EACD,CAAC;AAEF,KAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,6DAA6D,SAAS,SAAS;CAEjG,MAAM,OAAQ,MAAM,SAAS,MAAM;AAEnC,KAAI,CAAC,eAAe,KAAK,CACvB,OAAM,IAAI,MAAM,kEAAkE;AAGpF,QAAO,KAAK"}
+{"version":3,"file":"upload-temp-document.js","names":[],"sources":["../../src/helpers/upload-temp-document.ts"],"sourcesContent":["import { redirectToProxy } from '@scalar/helpers/url/redirect-to-proxy'\nimport type { ExternalUrls } from '@scalar/types/api-reference'\n\n/** Type guard for the response body */\nfunction isResponseBody(data: unknown): data is { url: string } {\n  return !!data && typeof data === 'object' && 'url' in data && typeof (data as any).url === 'string'\n}\n\n/** Upload a document and return a temporary URL */\nexport async function uploadTempDocument(\n  document: string,\n  urls: Pick<ExternalUrls, 'proxyUrl' | 'apiBaseUrl'>,\n): Promise<string> {\n  const body = JSON.stringify({ document })\n  const uploadUrl = `${urls.apiBaseUrl}/core/share/upload/apis`\n\n  // Proxy the request to avoid localhost CORS issues\n  const response = await fetch(redirectToProxy(urls.proxyUrl, uploadUrl), {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body,\n  })\n\n  if (!response.ok) {\n    throw new Error(` Failed to generate temporary link, server responded with ${response.status}`)\n  }\n  const data = (await response.json()) as unknown\n\n  if (!isResponseBody(data)) {\n    throw new Error('Failed to generate temporary link, invalid response from server')\n  }\n\n  return data.url\n}\n"],"mappings":";;;AAIA,SAAS,eAAe,MAAwC;CAC9D,OAAO,CAAC,CAAC,QAAQ,OAAO,SAAS,YAAY,SAAS,QAAQ,OAAQ,KAAa,QAAQ;AAC7F;;AAGA,eAAsB,mBACpB,UACA,MACiB;CACjB,MAAM,OAAO,KAAK,UAAU,EAAE,SAAS,CAAC;CACxC,MAAM,YAAY,GAAG,KAAK,WAAW;CAGrC,MAAM,WAAW,MAAM,MAAM,gBAAgB,KAAK,UAAU,SAAS,GAAG;EACtE,QAAQ;EACR,SAAS,EAAE,gBAAgB,mBAAmB;EAC9C;CACF,CAAC;CAED,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,6DAA6D,SAAS,QAAQ;CAEhG,MAAM,OAAQ,MAAM,SAAS,KAAK;CAElC,IAAI,CAAC,eAAe,IAAI,GACtB,MAAM,IAAI,MAAM,iEAAiE;CAGnF,OAAO,KAAK;AACd"}

package/dist/hooks/use-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent.js","names":[],"sources":["../../src/hooks/use-agent.ts"],"sourcesContent":["import { isLocalUrl } from '@scalar/helpers/url/is-local-url'\nimport type { ComputedRef, Ref } from 'vue'\nimport { type InjectionKey, computed, inject, ref } from 'vue'\n\ntype UseAgentOptions = {\n  /** Optional. When provided, controls whether the agent UI is enabled (e.g. from doc config). Defaults to isLocalUrl. */\n  agentEnabled?: ComputedRef<boolean>\n}\n\ntype UseAgentReturn = {\n  showAgent: Ref<boolean>\n  agentEnabled: ComputedRef<boolean>\n  /** Ref used to pass a prefill message into the agent when opening. Cleared on close. */\n  prefilledMessage: Ref<string>\n  openAgent: (message?: string) => void\n  closeAgent: () => void\n  toggleAgent: () => void\n}\n\nexport const AGENT_CONTEXT_SYMBOL = Symbol() as InjectionKey<UseAgentReturn>\n\n/**\n * Module-level ref so useAgentContext() can resolve context even when inject fails\n * (e.g. async component boundary or mount order). Set when ApiReference calls useAgent().\n */\nconst agentStateRef: Ref<UseAgentReturn | null> = ref(null)\n\n/**\n * Hook for agent visibility and enabled state.\n * Call from the API Reference root (e.g. ApiReference.vue) with options to create the state, then provide it so descendants can inject it.\n *\n * Returns:\n * - showAgent: whether the agent panel is visible\n * - agentEnabled: whether the agent is enabled\n * - openAgent, closeAgent, toggleAgent: imperative controls\n */\nexport function useAgent(options: UseAgentOptions): UseAgentReturn {\n  const showAgent = ref(false)\n  const prefilledMessage = ref('')\n\n  const agentEnabled = options.agentEnabled ?? computed(() => isLocalUrl(window.location.href))\n\n  const openAgent = (message?: string) => {\n    prefilledMessage.value = message ?? ''\n    showAgent.value = true\n  }\n\n  const closeAgent = () => {\n    showAgent.value = false\n    prefilledMessage.value = ''\n  }\n\n  const toggleAgent = () => {\n    showAgent.value = !showAgent.value\n    if (!showAgent.value) {\n      prefilledMessage.value = ''\n    }\n  }\n\n  const state: UseAgentReturn = {\n    showAgent,\n    agentEnabled,\n    prefilledMessage,\n    openAgent,\n    closeAgent,\n    toggleAgent,\n  }\n  agentStateRef.value = state\n  return state\n}\n\n/**\n * Inject the agent context provided by ApiReference.\n * Falls back to module-level state when inject is undefined (e.g. async boundary or mount order).\n * Use in descendant components (e.g. AskAgentButton) to open the agent or check if it is enabled.\n *\n * Returns a computed ref; use v-if=\"agentContext?.agentEnabled\" so the button only renders when context exists and agent is enabled.\n */\nexport function useAgentContext(): ComputedRef<UseAgentReturn | undefined> {\n  const injected = inject(AGENT_CONTEXT_SYMBOL, undefined)\n  return computed((): UseAgentReturn | undefined => injected ?? agentStateRef.value ?? undefined)\n}\n"],"mappings":";;;AAmBA,IAAa,uBAAuB,QAAQ;;;;;AAM5C,IAAM,gBAA4C,IAAI,KAAK;;;;;;;;;;AAW3D,SAAgB,SAAS,SAA0C;CACjE,MAAM,YAAY,IAAI,MAAM;CAC5B,MAAM,mBAAmB,IAAI,GAAG;CAEhC,MAAM,eAAe,QAAQ,gBAAgB,eAAe,WAAW,OAAO,SAAS,KAAK,CAAC;CAE7F,MAAM,aAAa,YAAqB;AACtC,mBAAiB,QAAQ,WAAW;AACpC,YAAU,QAAQ;;CAGpB,MAAM,mBAAmB;AACvB,YAAU,QAAQ;AAClB,mBAAiB,QAAQ;;CAG3B,MAAM,oBAAoB;AACxB,YAAU,QAAQ,CAAC,UAAU;AAC7B,MAAI,CAAC,UAAU,MACb,kBAAiB,QAAQ;;CAI7B,MAAM,QAAwB;EAC5B;EACA;EACA;EACA;EACA;EACA;EACD;AACD,eAAc,QAAQ;AACtB,QAAO;;;;;;;;;AAUT,SAAgB,kBAA2D;CACzE,MAAM,WAAW,OAAO,sBAAsB,KAAA,EAAU;AACxD,QAAO,eAA2C,YAAY,cAAc,SAAS,KAAA,EAAU"}
+{"version":3,"file":"use-agent.js","names":[],"sources":["../../src/hooks/use-agent.ts"],"sourcesContent":["import { isLocalUrl } from '@scalar/helpers/url/is-local-url'\nimport type { ComputedRef, Ref } from 'vue'\nimport { type InjectionKey, computed, inject, ref } from 'vue'\n\ntype UseAgentOptions = {\n  /** Optional. When provided, controls whether the agent UI is enabled (e.g. from doc config). Defaults to isLocalUrl. */\n  agentEnabled?: ComputedRef<boolean>\n}\n\ntype UseAgentReturn = {\n  showAgent: Ref<boolean>\n  agentEnabled: ComputedRef<boolean>\n  /** Ref used to pass a prefill message into the agent when opening. Cleared on close. */\n  prefilledMessage: Ref<string>\n  openAgent: (message?: string) => void\n  closeAgent: () => void\n  toggleAgent: () => void\n}\n\nexport const AGENT_CONTEXT_SYMBOL = Symbol() as InjectionKey<UseAgentReturn>\n\n/**\n * Module-level ref so useAgentContext() can resolve context even when inject fails\n * (e.g. async component boundary or mount order). Set when ApiReference calls useAgent().\n */\nconst agentStateRef: Ref<UseAgentReturn | null> = ref(null)\n\n/**\n * Hook for agent visibility and enabled state.\n * Call from the API Reference root (e.g. ApiReference.vue) with options to create the state, then provide it so descendants can inject it.\n *\n * Returns:\n * - showAgent: whether the agent panel is visible\n * - agentEnabled: whether the agent is enabled\n * - openAgent, closeAgent, toggleAgent: imperative controls\n */\nexport function useAgent(options: UseAgentOptions): UseAgentReturn {\n  const showAgent = ref(false)\n  const prefilledMessage = ref('')\n\n  const agentEnabled = options.agentEnabled ?? computed(() => isLocalUrl(window.location.href))\n\n  const openAgent = (message?: string) => {\n    prefilledMessage.value = message ?? ''\n    showAgent.value = true\n  }\n\n  const closeAgent = () => {\n    showAgent.value = false\n    prefilledMessage.value = ''\n  }\n\n  const toggleAgent = () => {\n    showAgent.value = !showAgent.value\n    if (!showAgent.value) {\n      prefilledMessage.value = ''\n    }\n  }\n\n  const state: UseAgentReturn = {\n    showAgent,\n    agentEnabled,\n    prefilledMessage,\n    openAgent,\n    closeAgent,\n    toggleAgent,\n  }\n  agentStateRef.value = state\n  return state\n}\n\n/**\n * Inject the agent context provided by ApiReference.\n * Falls back to module-level state when inject is undefined (e.g. async boundary or mount order).\n * Use in descendant components (e.g. AskAgentButton) to open the agent or check if it is enabled.\n *\n * Returns a computed ref; use v-if=\"agentContext?.agentEnabled\" so the button only renders when context exists and agent is enabled.\n */\nexport function useAgentContext(): ComputedRef<UseAgentReturn | undefined> {\n  const injected = inject(AGENT_CONTEXT_SYMBOL, undefined)\n  return computed((): UseAgentReturn | undefined => injected ?? agentStateRef.value ?? undefined)\n}\n"],"mappings":";;;AAmBA,IAAa,uBAAuB,OAAO;;;;;AAM3C,IAAM,gBAA4C,IAAI,IAAI;;;;;;;;;;AAW1D,SAAgB,SAAS,SAA0C;CACjE,MAAM,YAAY,IAAI,KAAK;CAC3B,MAAM,mBAAmB,IAAI,EAAE;CAE/B,MAAM,eAAe,QAAQ,gBAAgB,eAAe,WAAW,OAAO,SAAS,IAAI,CAAC;CAE5F,MAAM,aAAa,YAAqB;EACtC,iBAAiB,QAAQ,WAAW;EACpC,UAAU,QAAQ;CACpB;CAEA,MAAM,mBAAmB;EACvB,UAAU,QAAQ;EAClB,iBAAiB,QAAQ;CAC3B;CAEA,MAAM,oBAAoB;EACxB,UAAU,QAAQ,CAAC,UAAU;EAC7B,IAAI,CAAC,UAAU,OACb,iBAAiB,QAAQ;CAE7B;CAEA,MAAM,QAAwB;EAC5B;EACA;EACA;EACA;EACA;EACA;CACF;CACA,cAAc,QAAQ;CACtB,OAAO;AACT;;;;;;;;AASA,SAAgB,kBAA2D;CACzE,MAAM,WAAW,OAAO,sBAAsB,KAAA,CAAS;CACvD,OAAO,eAA2C,YAAY,cAAc,SAAS,KAAA,CAAS;AAChG"}

package/dist/hooks/use-intersection.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-intersection.js","names":[],"sources":["../../src/hooks/use-intersection.ts"],"sourcesContent":["import { useIntersectionObserver } from '@vueuse/core'\nimport { type TemplateRef, onMounted } from 'vue'\n\n/**\n * Shrinks the observation root to a thin horizontal strip at the vertical middle of\n * the viewport (~2% of viewport height). Emits only while the target overlaps that line.\n */\nconst VIEWPORT_VERTICAL_CENTER_ROOT_MARGIN = '-49% 0px -49% 0px'\n\ntype UseIntersectionOptions = {\n  /** Called when the element stops intersecting. */\n  onExit?: () => void\n  /**\n   * Whether to immediately fire the intersection as soon as the element is on the screen.\n   *\n   * When false (default) we use a root margin that is 2% of the viewport height on the middle of the viewport.\n   */\n  immediate?: boolean\n}\n\nexport const useIntersection = (\n  el: TemplateRef<HTMLElement | undefined>,\n  onIntersect: () => void,\n  options?: UseIntersectionOptions,\n) => {\n  onMounted(() => {\n    const observerOptions = {\n      rootMargin: options?.immediate ? '0px 0px 0px 0px' : VIEWPORT_VERTICAL_CENTER_ROOT_MARGIN,\n      threshold: 0,\n    } as const\n\n    if (el.value) {\n      useIntersectionObserver(\n        el,\n        ([entry]) => {\n          if (entry?.isIntersecting) {\n            onIntersect()\n          } else {\n            options?.onExit?.()\n          }\n        },\n        observerOptions,\n      )\n    }\n  })\n}\n"],"mappings":";;;;;;;AAOA,IAAM,uCAAuC;AAa7C,IAAa,mBACX,IACA,aACA,YACG;AACH,iBAAgB;EACd,MAAM,kBAAkB;GACtB,YAAY,SAAS,YAAY,oBAAoB;GACrD,WAAW;GACZ;AAED,MAAI,GAAG,MACL,yBACE,KACC,CAAC,WAAW;AACX,OAAI,OAAO,eACT,cAAa;OAEb,UAAS,UAAU;KAGvB,gBACD;GAEH"}
+{"version":3,"file":"use-intersection.js","names":[],"sources":["../../src/hooks/use-intersection.ts"],"sourcesContent":["import { useIntersectionObserver } from '@vueuse/core'\nimport { type TemplateRef, onMounted } from 'vue'\n\n/**\n * Shrinks the observation root to a thin horizontal strip at the vertical middle of\n * the viewport (~2% of viewport height). Emits only while the target overlaps that line.\n */\nconst VIEWPORT_VERTICAL_CENTER_ROOT_MARGIN = '-49% 0px -49% 0px'\n\ntype UseIntersectionOptions = {\n  /** Called when the element stops intersecting. */\n  onExit?: () => void\n  /**\n   * Whether to immediately fire the intersection as soon as the element is on the screen.\n   *\n   * When false (default) we use a root margin that is 2% of the viewport height on the middle of the viewport.\n   */\n  immediate?: boolean\n}\n\nexport const useIntersection = (\n  el: TemplateRef<HTMLElement | undefined>,\n  onIntersect: () => void,\n  options?: UseIntersectionOptions,\n) => {\n  onMounted(() => {\n    const observerOptions = {\n      rootMargin: options?.immediate ? '0px 0px 0px 0px' : VIEWPORT_VERTICAL_CENTER_ROOT_MARGIN,\n      threshold: 0,\n    } as const\n\n    if (el.value) {\n      useIntersectionObserver(\n        el,\n        ([entry]) => {\n          if (entry?.isIntersecting) {\n            onIntersect()\n          } else {\n            options?.onExit?.()\n          }\n        },\n        observerOptions,\n      )\n    }\n  })\n}\n"],"mappings":";;;;;;;AAOA,IAAM,uCAAuC;AAa7C,IAAa,mBACX,IACA,aACA,YACG;CACH,gBAAgB;EACd,MAAM,kBAAkB;GACtB,YAAY,SAAS,YAAY,oBAAoB;GACrD,WAAW;EACb;EAEA,IAAI,GAAG,OACL,wBACE,KACC,CAAC,WAAW;GACX,IAAI,OAAO,gBACT,YAAY;QAEZ,SAAS,SAAS;EAEtB,GACA,eACF;CAEJ,CAAC;AACH"}

package/dist/plugins/hooks/usePluginManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePluginManager.js","names":[],"sources":["../../../src/plugins/hooks/usePluginManager.ts"],"sourcesContent":["import { type PluginManager, createPluginManager } from '@/plugins/plugin-manager'\nimport { type InjectionKey, inject } from 'vue'\n\nexport const PLUGIN_MANAGER_SYMBOL = Symbol() as InjectionKey<PluginManager>\n\n/**\n * Hook to access the plugin manager\n */\nexport const usePluginManager = (): PluginManager => {\n  const manager = inject(PLUGIN_MANAGER_SYMBOL)\n\n  // No plugin manager provided, creating a new one.\n  if (!manager) {\n    return createPluginManager({})\n  }\n\n  return manager\n}\n"],"mappings":";;;AAGA,IAAa,wBAAwB,QAAQ;;;;AAK7C,IAAa,yBAAwC;CACnD,MAAM,UAAU,OAAO,sBAAsB;AAG7C,KAAI,CAAC,QACH,QAAO,oBAAoB,EAAE,CAAC;AAGhC,QAAO"}
+{"version":3,"file":"usePluginManager.js","names":[],"sources":["../../../src/plugins/hooks/usePluginManager.ts"],"sourcesContent":["import { type PluginManager, createPluginManager } from '@/plugins/plugin-manager'\nimport { type InjectionKey, inject } from 'vue'\n\nexport const PLUGIN_MANAGER_SYMBOL = Symbol() as InjectionKey<PluginManager>\n\n/**\n * Hook to access the plugin manager\n */\nexport const usePluginManager = (): PluginManager => {\n  const manager = inject(PLUGIN_MANAGER_SYMBOL)\n\n  // No plugin manager provided, creating a new one.\n  if (!manager) {\n    return createPluginManager({})\n  }\n\n  return manager\n}\n"],"mappings":";;;AAGA,IAAa,wBAAwB,OAAO;;;;AAK5C,IAAa,yBAAwC;CACnD,MAAM,UAAU,OAAO,qBAAqB;CAG5C,IAAI,CAAC,SACH,OAAO,oBAAoB,CAAC,CAAC;CAG/B,OAAO;AACT"}

package/dist/plugins/persistence-plugin.js

@@ -15,7 +15,12 @@ var persistencePlugin = ({ debounceDelay = 500, maxWait = 1e4, persistAuth = fal
 		if (typeof persistAuth === "function") return persistAuth();
 		return persistAuth;
 	};
-	return { hooks: { onWorkspaceStateChanges(event) {
+	return { hooks: { 
+	/**
+	* Handles all workspace state change events.
+	* Each write is debounced by a key to prevent frequent writes for the same entity.
+	*/
+onWorkspaceStateChanges(event) {
 		if (event.type === "meta") {
 			const defaultClient = event.value["x-scalar-default-client"];
 			if (defaultClient !== void 0) execute("x-scalar-default-client", () => clientPersistence.set(defaultClient));

package/dist/plugins/persistence-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistence-plugin.js","names":[],"sources":["../../src/plugins/persistence-plugin.ts"],"sourcesContent":["import { debounce } from '@scalar/helpers/general/debounce'\nimport type { WorkspacePlugin } from '@scalar/workspace-store/workspace-plugin'\n\nimport { authStorage, clientStorage } from '@/helpers/storage'\n\n/**\n * Plugin to persist workspace state changes with debounced writes.\n */\nexport const persistencePlugin = ({\n  debounceDelay = 500,\n  maxWait = 10000,\n  persistAuth = false,\n}: {\n  debounceDelay?: number\n  /** Maximum time in milliseconds to wait before forcing execution, even with continuous calls. */\n  maxWait?: number\n  /**\n   * Determines whether authentication details should be persisted.\n   * Accepts a boolean or a function that returns a boolean.\n   * Allows for conditional persistence logic, e.g., based on environment or user settings.\n   */\n  persistAuth?: boolean | (() => boolean)\n}): WorkspacePlugin => {\n  // Debounced execute function for batching similar state changes\n  const { execute } = debounce({ delay: debounceDelay, maxWait })\n  const authPersistence = authStorage()\n  const clientPersistence = clientStorage()\n\n  const getPersistAuth = () => {\n    if (typeof persistAuth === 'function') {\n      return persistAuth()\n    }\n\n    return persistAuth\n  }\n\n  return {\n    hooks: {\n      /**\n       * Handles all workspace state change events.\n       * Each write is debounced by a key to prevent frequent writes for the same entity.\n       */\n      onWorkspaceStateChanges(event) {\n        // If the event is for workspace meta data, debounce by workspaceId\n        if (event.type === 'meta') {\n          // Persist the meta fields\n          const defaultClient = event.value['x-scalar-default-client']\n          if (defaultClient !== undefined) {\n            execute('x-scalar-default-client', () => clientPersistence.set(defaultClient))\n          }\n          return\n        }\n\n        // Persist auth and [server](TODO)\n        // Use event.documentName as both the debounce key and the storage key so that\n        // concurrent auth changes across multiple documents do not clobber each other and\n        // the correct slug is used even when the active document has already changed.\n        if (getPersistAuth() && event.type === 'auth') {\n          execute(`auth-${event.documentName}`, () => authPersistence.setAuth(event.documentName, event.value))\n        }\n\n        // No action for other event types\n        return\n      },\n    },\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAa,qBAAqB,EAChC,gBAAgB,KAChB,UAAU,KACV,cAAc,YAWO;CAErB,MAAM,EAAE,YAAY,SAAS;EAAE,OAAO;EAAe;EAAS,CAAC;CAC/D,MAAM,kBAAkB,aAAa;CACrC,MAAM,oBAAoB,eAAe;CAEzC,MAAM,uBAAuB;AAC3B,MAAI,OAAO,gBAAgB,WACzB,QAAO,aAAa;AAGtB,SAAO;;AAGT,QAAO,EACL,OAAO,EAKL,wBAAwB,OAAO;AAE7B,MAAI,MAAM,SAAS,QAAQ;GAEzB,MAAM,gBAAgB,MAAM,MAAM;AAClC,OAAI,kBAAkB,KAAA,EACpB,SAAQ,iCAAiC,kBAAkB,IAAI,cAAc,CAAC;AAEhF;;AAOF,MAAI,gBAAgB,IAAI,MAAM,SAAS,OACrC,SAAQ,QAAQ,MAAM,sBAAsB,gBAAgB,QAAQ,MAAM,cAAc,MAAM,MAAM,CAAC;IAM1G,EACF"}
+{"version":3,"file":"persistence-plugin.js","names":[],"sources":["../../src/plugins/persistence-plugin.ts"],"sourcesContent":["import { debounce } from '@scalar/helpers/general/debounce'\nimport type { WorkspacePlugin } from '@scalar/workspace-store/workspace-plugin'\n\nimport { authStorage, clientStorage } from '@/helpers/storage'\n\n/**\n * Plugin to persist workspace state changes with debounced writes.\n */\nexport const persistencePlugin = ({\n  debounceDelay = 500,\n  maxWait = 10000,\n  persistAuth = false,\n}: {\n  debounceDelay?: number\n  /** Maximum time in milliseconds to wait before forcing execution, even with continuous calls. */\n  maxWait?: number\n  /**\n   * Determines whether authentication details should be persisted.\n   * Accepts a boolean or a function that returns a boolean.\n   * Allows for conditional persistence logic, e.g., based on environment or user settings.\n   */\n  persistAuth?: boolean | (() => boolean)\n}): WorkspacePlugin => {\n  // Debounced execute function for batching similar state changes\n  const { execute } = debounce({ delay: debounceDelay, maxWait })\n  const authPersistence = authStorage()\n  const clientPersistence = clientStorage()\n\n  const getPersistAuth = () => {\n    if (typeof persistAuth === 'function') {\n      return persistAuth()\n    }\n\n    return persistAuth\n  }\n\n  return {\n    hooks: {\n      /**\n       * Handles all workspace state change events.\n       * Each write is debounced by a key to prevent frequent writes for the same entity.\n       */\n      onWorkspaceStateChanges(event) {\n        // If the event is for workspace meta data, debounce by workspaceId\n        if (event.type === 'meta') {\n          // Persist the meta fields\n          const defaultClient = event.value['x-scalar-default-client']\n          if (defaultClient !== undefined) {\n            execute('x-scalar-default-client', () => clientPersistence.set(defaultClient))\n          }\n          return\n        }\n\n        // Persist auth and [server](TODO)\n        // Use event.documentName as both the debounce key and the storage key so that\n        // concurrent auth changes across multiple documents do not clobber each other and\n        // the correct slug is used even when the active document has already changed.\n        if (getPersistAuth() && event.type === 'auth') {\n          execute(`auth-${event.documentName}`, () => authPersistence.setAuth(event.documentName, event.value))\n        }\n\n        // No action for other event types\n        return\n      },\n    },\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAa,qBAAqB,EAChC,gBAAgB,KAChB,UAAU,KACV,cAAc,YAWO;CAErB,MAAM,EAAE,YAAY,SAAS;EAAE,OAAO;EAAe;CAAQ,CAAC;CAC9D,MAAM,kBAAkB,YAAY;CACpC,MAAM,oBAAoB,cAAc;CAExC,MAAM,uBAAuB;EAC3B,IAAI,OAAO,gBAAgB,YACzB,OAAO,YAAY;EAGrB,OAAO;CACT;CAEA,OAAO,EACL,OAAO;;;;;AAKL,wBAAwB,OAAO;EAE7B,IAAI,MAAM,SAAS,QAAQ;GAEzB,MAAM,gBAAgB,MAAM,MAAM;GAClC,IAAI,kBAAkB,KAAA,GACpB,QAAQ,iCAAiC,kBAAkB,IAAI,aAAa,CAAC;GAE/E;EACF;EAMA,IAAI,eAAe,KAAK,MAAM,SAAS,QACrC,QAAQ,QAAQ,MAAM,sBAAsB,gBAAgB,QAAQ,MAAM,cAAc,MAAM,KAAK,CAAC;CAKxG,EACF,EACF;AACF"}

package/dist/plugins/plugin-manager.js

@@ -35,11 +35,21 @@ var createPluginManager = ({ plugins = [], auth }) => {
 		registeredPlugins.set(pluginInstance.name, pluginInstance);
 	});
 	return {
+		/**
+		* Get all extensions with the given name from registered plugins
+		*/
 		getSpecificationExtensions: (name) => {
 			const extensions = [];
 			for (const plugin of registeredPlugins.values()) for (const extension of plugin.extensions) if (extension.name === name) extensions.push(extension);
 			return extensions;
 		},
+		/**
+		* Get all components for a specific view from registered plugins.
+		*
+		* Each component carries a stable `id` (scoped to the active document slug) so the rendered
+		* DOM element and the sidebar entry (see `getSidebarEntries`) share the same id and stay in
+		* sync for scroll navigation and deep-linking.
+		*/
 		getViewComponents: (viewName, documentSlug) => {
 			const components = [];
 			for (const plugin of registeredPlugins.values()) {
@@ -53,27 +63,52 @@ var createPluginManager = ({ plugins = [], auth }) => {
 			}
 			return components;
 		},
+		/**
+		* Notify all plugins that the API Reference has been initialized
+		*/
 		notifyInit: (config) => {
 			for (const plugin of registeredPlugins.values()) plugin.hooks?.onInit?.({
 				config,
 				auth: authState
 			});
 		},
+		/**
+		* Notify all plugins that the configuration has changed
+		*/
 		notifyConfigChange: (config) => {
 			for (const plugin of registeredPlugins.values()) plugin.hooks?.onConfigChange?.({
 				config,
 				auth: authState
 			});
 		},
+		/**
+		* Get the read-only accessor for the global authentication state.
+		*
+		* Plugin view components can call this (via `usePluginManager`) to read stored secrets and the
+		* selected security schemes. Returns an empty auth state when no accessor was provided.
+		*/
 		getAuthState: () => authState,
+		/**
+		* Notify all plugins that the API Reference is being destroyed
+		*/
 		notifyDestroy: () => {
 			for (const plugin of registeredPlugins.values()) plugin.hooks?.onDestroy?.();
 		},
+		/**
+		* Get all client plugins provided by registered plugins
+		*/
 		getApiClientPlugins: () => {
 			const apiClientPlugins = [];
 			for (const plugin of registeredPlugins.values()) if (plugin.apiClientPlugins) apiClientPlugins.push(...plugin.apiClientPlugins);
 			return apiClientPlugins;
 		},
+		/**
+		* Get all sidebar entries contributed by plugin views.
+		*
+		* Only views that opt in via `sidebar.show` are returned. Each entry's `id` matches the
+		* id of the rendered component (see `getViewComponents`), so the API Reference can add it
+		* to the sidebar navigation and scrolling/active-tracking work out of the box.
+		*/
 		getSidebarEntries: (documentSlug) => {
 			const entries = [];
 			for (const plugin of registeredPlugins.values()) for (const viewName of PLUGIN_VIEW_NAMES) (plugin.views?.[viewName])?.forEach((component, index) => {

package/dist/plugins/plugin-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-manager.js","names":[],"sources":["../../src/plugins/plugin-manager.ts"],"sourcesContent":["import type { ClientPlugin } from '@scalar/oas-utils/helpers'\nimport type {\n  ApiReferencePlugin as OriginalApiReferencePlugin,\n  PluginAuthState,\n  SpecificationExtension,\n  ViewComponent,\n} from '@scalar/types/api-reference'\n\nexport type ApiReferencePlugin = OriginalApiReferencePlugin\n\nexport type { PluginAuthState }\n\ntype CreatePluginManagerParams = {\n  plugins?: ApiReferencePlugin[]\n  /**\n   * Read-only accessor for the global authentication state.\n   *\n   * Passed through to plugin lifecycle hooks and exposed via `getAuthState`, letting plugins read\n   * stored secrets and the selected security schemes without being able to mutate them.\n   */\n  auth?: PluginAuthState\n}\n\n/**\n * A no-op auth state used when no accessor is provided (e.g. in tests or a standalone manager).\n * It reports an empty authentication state so plugins can call the read methods unconditionally.\n */\nconst createEmptyAuthState = (): PluginAuthState => ({\n  export: () => ({}),\n  getAuthSecrets: () => undefined,\n  getAuthSelectedSchemas: () => undefined,\n})\n\n/** Plugin view slots that can render custom components in the content area */\nconst PLUGIN_VIEW_NAMES = ['content.start', 'content.end'] as const\n\ntype PluginViewName = (typeof PLUGIN_VIEW_NAMES)[number]\n\n/** A plugin view component paired with the stable id used for the DOM and sidebar navigation */\nexport type PluginViewComponent = ViewComponent & { id: string }\n\n/** A sidebar entry contributed by a plugin view */\ntype PluginSidebarEntry = {\n  id: string\n  label: string\n  viewName: PluginViewName\n}\n\n/**\n * Build a stable, unique id for a plugin view component.\n *\n * The same id is used as the DOM element id (so scroll navigation can find it) and as the\n * sidebar navigation entry id (so clicking it scrolls to the element). Keeping both in sync\n * is what lets plugin views participate in the existing scroll-spy and navigation logic.\n *\n * The id is prefixed with the document slug so it matches the navigation id convention. That is\n * what lets URL deep-linking work: `getIdFromUrl` re-prepends the document slug on initial load,\n * so a hash like `plugin-view/<plugin>/<view>/<index>` resolves back to this exact id.\n */\nconst getPluginViewId = (documentSlug: string, pluginName: string, viewName: PluginViewName, index: number): string =>\n  `${documentSlug}/plugin-view/${pluginName}/${viewName}/${index}`\n\n/**\n * Create the plugin manager store\n *\n * This store manages all plugins registered with the API client\n */\nexport const createPluginManager = ({ plugins = [], auth }: CreatePluginManagerParams) => {\n  const registeredPlugins = new Map<string, ReturnType<ApiReferencePlugin>>()\n\n  // Fall back to an empty read-only auth state so hooks and `getAuthState` always have an accessor.\n  const authState = auth ?? createEmptyAuthState()\n\n  // Register initial plugins\n  plugins.forEach((plugin) => {\n    const pluginInstance = plugin()\n    registeredPlugins.set(pluginInstance.name, pluginInstance)\n  })\n\n  return {\n    /**\n     * Get all extensions with the given name from registered plugins\n     */\n    getSpecificationExtensions: (name: `x-${string}`): SpecificationExtension[] => {\n      const extensions: SpecificationExtension[] = []\n\n      for (const plugin of registeredPlugins.values()) {\n        for (const extension of plugin.extensions) {\n          if (extension.name === name) {\n            extensions.push(extension)\n          }\n        }\n      }\n\n      return extensions\n    },\n\n    /**\n     * Get all components for a specific view from registered plugins.\n     *\n     * Each component carries a stable `id` (scoped to the active document slug) so the rendered\n     * DOM element and the sidebar entry (see `getSidebarEntries`) share the same id and stay in\n     * sync for scroll navigation and deep-linking.\n     */\n    getViewComponents: (viewName: PluginViewName, documentSlug: string): PluginViewComponent[] => {\n      const components: PluginViewComponent[] = []\n\n      for (const plugin of registeredPlugins.values()) {\n        const viewComponents = plugin.views?.[viewName]\n        if (viewComponents) {\n          viewComponents.forEach((component: ViewComponent, index: number) => {\n            components.push({ ...component, id: getPluginViewId(documentSlug, plugin.name, viewName, index) })\n          })\n        }\n      }\n\n      return components\n    },\n\n    /**\n     * Notify all plugins that the API Reference has been initialized\n     */\n    notifyInit: (config: Record<string, unknown>): void => {\n      for (const plugin of registeredPlugins.values()) {\n        plugin.hooks?.onInit?.({ config, auth: authState })\n      }\n    },\n\n    /**\n     * Notify all plugins that the configuration has changed\n     */\n    notifyConfigChange: (config: Record<string, unknown>): void => {\n      for (const plugin of registeredPlugins.values()) {\n        plugin.hooks?.onConfigChange?.({ config, auth: authState })\n      }\n    },\n\n    /**\n     * Get the read-only accessor for the global authentication state.\n     *\n     * Plugin view components can call this (via `usePluginManager`) to read stored secrets and the\n     * selected security schemes. Returns an empty auth state when no accessor was provided.\n     */\n    getAuthState: (): PluginAuthState => authState,\n\n    /**\n     * Notify all plugins that the API Reference is being destroyed\n     */\n    notifyDestroy: (): void => {\n      for (const plugin of registeredPlugins.values()) {\n        plugin.hooks?.onDestroy?.()\n      }\n    },\n\n    /**\n     * Get all client plugins provided by registered plugins\n     */\n    getApiClientPlugins: (): ClientPlugin[] => {\n      const apiClientPlugins: ClientPlugin[] = []\n\n      for (const plugin of registeredPlugins.values()) {\n        if (plugin.apiClientPlugins) {\n          apiClientPlugins.push(...(plugin.apiClientPlugins as ClientPlugin[]))\n        }\n      }\n\n      return apiClientPlugins\n    },\n\n    /**\n     * Get all sidebar entries contributed by plugin views.\n     *\n     * Only views that opt in via `sidebar.show` are returned. Each entry's `id` matches the\n     * id of the rendered component (see `getViewComponents`), so the API Reference can add it\n     * to the sidebar navigation and scrolling/active-tracking work out of the box.\n     */\n    getSidebarEntries: (documentSlug: string): PluginSidebarEntry[] => {\n      const entries: PluginSidebarEntry[] = []\n\n      for (const plugin of registeredPlugins.values()) {\n        for (const viewName of PLUGIN_VIEW_NAMES) {\n          const viewComponents = plugin.views?.[viewName]\n          viewComponents?.forEach((component: ViewComponent, index: number) => {\n            if (component.sidebar?.show && component.sidebar.label) {\n              entries.push({\n                id: getPluginViewId(documentSlug, plugin.name, viewName, index),\n                label: component.sidebar.label,\n                viewName,\n              })\n            }\n          })\n        }\n      }\n\n      return entries\n    },\n  }\n}\n\nexport type PluginManager = ReturnType<typeof createPluginManager>\n"],"mappings":";;;;;AA2BA,IAAM,8BAA+C;CACnD,eAAe,EAAE;CACjB,sBAAsB,KAAA;CACtB,8BAA8B,KAAA;CAC/B;;AAGD,IAAM,oBAAoB,CAAC,iBAAiB,cAAc;;;;;;;;;;;;AAyB1D,IAAM,mBAAmB,cAAsB,YAAoB,UAA0B,UAC3F,GAAG,aAAa,eAAe,WAAW,GAAG,SAAS,GAAG;;;;;;AAO3D,IAAa,uBAAuB,EAAE,UAAU,EAAE,EAAE,WAAsC;CACxF,MAAM,oCAAoB,IAAI,KAA6C;CAG3E,MAAM,YAAY,QAAQ,sBAAsB;AAGhD,SAAQ,SAAS,WAAW;EAC1B,MAAM,iBAAiB,QAAQ;AAC/B,oBAAkB,IAAI,eAAe,MAAM,eAAe;GAC1D;AAEF,QAAO;EAIL,6BAA6B,SAAkD;GAC7E,MAAM,aAAuC,EAAE;AAE/C,QAAK,MAAM,UAAU,kBAAkB,QAAQ,CAC7C,MAAK,MAAM,aAAa,OAAO,WAC7B,KAAI,UAAU,SAAS,KACrB,YAAW,KAAK,UAAU;AAKhC,UAAO;;EAUT,oBAAoB,UAA0B,iBAAgD;GAC5F,MAAM,aAAoC,EAAE;AAE5C,QAAK,MAAM,UAAU,kBAAkB,QAAQ,EAAE;IAC/C,MAAM,iBAAiB,OAAO,QAAQ;AACtC,QAAI,eACF,gBAAe,SAAS,WAA0B,UAAkB;AAClE,gBAAW,KAAK;MAAE,GAAG;MAAW,IAAI,gBAAgB,cAAc,OAAO,MAAM,UAAU,MAAM;MAAE,CAAC;MAClG;;AAIN,UAAO;;EAMT,aAAa,WAA0C;AACrD,QAAK,MAAM,UAAU,kBAAkB,QAAQ,CAC7C,QAAO,OAAO,SAAS;IAAE;IAAQ,MAAM;IAAW,CAAC;;EAOvD,qBAAqB,WAA0C;AAC7D,QAAK,MAAM,UAAU,kBAAkB,QAAQ,CAC7C,QAAO,OAAO,iBAAiB;IAAE;IAAQ,MAAM;IAAW,CAAC;;EAU/D,oBAAqC;EAKrC,qBAA2B;AACzB,QAAK,MAAM,UAAU,kBAAkB,QAAQ,CAC7C,QAAO,OAAO,aAAa;;EAO/B,2BAA2C;GACzC,MAAM,mBAAmC,EAAE;AAE3C,QAAK,MAAM,UAAU,kBAAkB,QAAQ,CAC7C,KAAI,OAAO,iBACT,kBAAiB,KAAK,GAAI,OAAO,iBAAoC;AAIzE,UAAO;;EAUT,oBAAoB,iBAA+C;GACjE,MAAM,UAAgC,EAAE;AAExC,QAAK,MAAM,UAAU,kBAAkB,QAAQ,CAC7C,MAAK,MAAM,YAAY,kBAErB,EADuB,OAAO,QAAQ,YACtB,SAAS,WAA0B,UAAkB;AACnE,QAAI,UAAU,SAAS,QAAQ,UAAU,QAAQ,MAC/C,SAAQ,KAAK;KACX,IAAI,gBAAgB,cAAc,OAAO,MAAM,UAAU,MAAM;KAC/D,OAAO,UAAU,QAAQ;KACzB;KACD,CAAC;KAEJ;AAIN,UAAO;;EAEV"}
+{"version":3,"file":"plugin-manager.js","names":[],"sources":["../../src/plugins/plugin-manager.ts"],"sourcesContent":["import type { ClientPlugin } from '@scalar/oas-utils/helpers'\nimport type {\n  ApiReferencePlugin as OriginalApiReferencePlugin,\n  PluginAuthState,\n  SpecificationExtension,\n  ViewComponent,\n} from '@scalar/types/api-reference'\n\nexport type ApiReferencePlugin = OriginalApiReferencePlugin\n\nexport type { PluginAuthState }\n\ntype CreatePluginManagerParams = {\n  plugins?: ApiReferencePlugin[]\n  /**\n   * Read-only accessor for the global authentication state.\n   *\n   * Passed through to plugin lifecycle hooks and exposed via `getAuthState`, letting plugins read\n   * stored secrets and the selected security schemes without being able to mutate them.\n   */\n  auth?: PluginAuthState\n}\n\n/**\n * A no-op auth state used when no accessor is provided (e.g. in tests or a standalone manager).\n * It reports an empty authentication state so plugins can call the read methods unconditionally.\n */\nconst createEmptyAuthState = (): PluginAuthState => ({\n  export: () => ({}),\n  getAuthSecrets: () => undefined,\n  getAuthSelectedSchemas: () => undefined,\n})\n\n/** Plugin view slots that can render custom components in the content area */\nconst PLUGIN_VIEW_NAMES = ['content.start', 'content.end'] as const\n\ntype PluginViewName = (typeof PLUGIN_VIEW_NAMES)[number]\n\n/** A plugin view component paired with the stable id used for the DOM and sidebar navigation */\nexport type PluginViewComponent = ViewComponent & { id: string }\n\n/** A sidebar entry contributed by a plugin view */\ntype PluginSidebarEntry = {\n  id: string\n  label: string\n  viewName: PluginViewName\n}\n\n/**\n * Build a stable, unique id for a plugin view component.\n *\n * The same id is used as the DOM element id (so scroll navigation can find it) and as the\n * sidebar navigation entry id (so clicking it scrolls to the element). Keeping both in sync\n * is what lets plugin views participate in the existing scroll-spy and navigation logic.\n *\n * The id is prefixed with the document slug so it matches the navigation id convention. That is\n * what lets URL deep-linking work: `getIdFromUrl` re-prepends the document slug on initial load,\n * so a hash like `plugin-view/<plugin>/<view>/<index>` resolves back to this exact id.\n */\nconst getPluginViewId = (documentSlug: string, pluginName: string, viewName: PluginViewName, index: number): string =>\n  `${documentSlug}/plugin-view/${pluginName}/${viewName}/${index}`\n\n/**\n * Create the plugin manager store\n *\n * This store manages all plugins registered with the API client\n */\nexport const createPluginManager = ({ plugins = [], auth }: CreatePluginManagerParams) => {\n  const registeredPlugins = new Map<string, ReturnType<ApiReferencePlugin>>()\n\n  // Fall back to an empty read-only auth state so hooks and `getAuthState` always have an accessor.\n  const authState = auth ?? createEmptyAuthState()\n\n  // Register initial plugins\n  plugins.forEach((plugin) => {\n    const pluginInstance = plugin()\n    registeredPlugins.set(pluginInstance.name, pluginInstance)\n  })\n\n  return {\n    /**\n     * Get all extensions with the given name from registered plugins\n     */\n    getSpecificationExtensions: (name: `x-${string}`): SpecificationExtension[] => {\n      const extensions: SpecificationExtension[] = []\n\n      for (const plugin of registeredPlugins.values()) {\n        for (const extension of plugin.extensions) {\n          if (extension.name === name) {\n            extensions.push(extension)\n          }\n        }\n      }\n\n      return extensions\n    },\n\n    /**\n     * Get all components for a specific view from registered plugins.\n     *\n     * Each component carries a stable `id` (scoped to the active document slug) so the rendered\n     * DOM element and the sidebar entry (see `getSidebarEntries`) share the same id and stay in\n     * sync for scroll navigation and deep-linking.\n     */\n    getViewComponents: (viewName: PluginViewName, documentSlug: string): PluginViewComponent[] => {\n      const components: PluginViewComponent[] = []\n\n      for (const plugin of registeredPlugins.values()) {\n        const viewComponents = plugin.views?.[viewName]\n        if (viewComponents) {\n          viewComponents.forEach((component: ViewComponent, index: number) => {\n            components.push({ ...component, id: getPluginViewId(documentSlug, plugin.name, viewName, index) })\n          })\n        }\n      }\n\n      return components\n    },\n\n    /**\n     * Notify all plugins that the API Reference has been initialized\n     */\n    notifyInit: (config: Record<string, unknown>): void => {\n      for (const plugin of registeredPlugins.values()) {\n        plugin.hooks?.onInit?.({ config, auth: authState })\n      }\n    },\n\n    /**\n     * Notify all plugins that the configuration has changed\n     */\n    notifyConfigChange: (config: Record<string, unknown>): void => {\n      for (const plugin of registeredPlugins.values()) {\n        plugin.hooks?.onConfigChange?.({ config, auth: authState })\n      }\n    },\n\n    /**\n     * Get the read-only accessor for the global authentication state.\n     *\n     * Plugin view components can call this (via `usePluginManager`) to read stored secrets and the\n     * selected security schemes. Returns an empty auth state when no accessor was provided.\n     */\n    getAuthState: (): PluginAuthState => authState,\n\n    /**\n     * Notify all plugins that the API Reference is being destroyed\n     */\n    notifyDestroy: (): void => {\n      for (const plugin of registeredPlugins.values()) {\n        plugin.hooks?.onDestroy?.()\n      }\n    },\n\n    /**\n     * Get all client plugins provided by registered plugins\n     */\n    getApiClientPlugins: (): ClientPlugin[] => {\n      const apiClientPlugins: ClientPlugin[] = []\n\n      for (const plugin of registeredPlugins.values()) {\n        if (plugin.apiClientPlugins) {\n          apiClientPlugins.push(...(plugin.apiClientPlugins as ClientPlugin[]))\n        }\n      }\n\n      return apiClientPlugins\n    },\n\n    /**\n     * Get all sidebar entries contributed by plugin views.\n     *\n     * Only views that opt in via `sidebar.show` are returned. Each entry's `id` matches the\n     * id of the rendered component (see `getViewComponents`), so the API Reference can add it\n     * to the sidebar navigation and scrolling/active-tracking work out of the box.\n     */\n    getSidebarEntries: (documentSlug: string): PluginSidebarEntry[] => {\n      const entries: PluginSidebarEntry[] = []\n\n      for (const plugin of registeredPlugins.values()) {\n        for (const viewName of PLUGIN_VIEW_NAMES) {\n          const viewComponents = plugin.views?.[viewName]\n          viewComponents?.forEach((component: ViewComponent, index: number) => {\n            if (component.sidebar?.show && component.sidebar.label) {\n              entries.push({\n                id: getPluginViewId(documentSlug, plugin.name, viewName, index),\n                label: component.sidebar.label,\n                viewName,\n              })\n            }\n          })\n        }\n      }\n\n      return entries\n    },\n  }\n}\n\nexport type PluginManager = ReturnType<typeof createPluginManager>\n"],"mappings":";;;;;AA2BA,IAAM,8BAA+C;CACnD,eAAe,CAAC;CAChB,sBAAsB,KAAA;CACtB,8BAA8B,KAAA;AAChC;;AAGA,IAAM,oBAAoB,CAAC,iBAAiB,aAAa;;;;;;;;;;;;AAyBzD,IAAM,mBAAmB,cAAsB,YAAoB,UAA0B,UAC3F,GAAG,aAAa,eAAe,WAAW,GAAG,SAAS,GAAG;;;;;;AAO3D,IAAa,uBAAuB,EAAE,UAAU,CAAC,GAAG,WAAsC;CACxF,MAAM,oCAAoB,IAAI,IAA4C;CAG1E,MAAM,YAAY,QAAQ,qBAAqB;CAG/C,QAAQ,SAAS,WAAW;EAC1B,MAAM,iBAAiB,OAAO;EAC9B,kBAAkB,IAAI,eAAe,MAAM,cAAc;CAC3D,CAAC;CAED,OAAO;;;;EAIL,6BAA6B,SAAkD;GAC7E,MAAM,aAAuC,CAAC;GAE9C,KAAK,MAAM,UAAU,kBAAkB,OAAO,GAC5C,KAAK,MAAM,aAAa,OAAO,YAC7B,IAAI,UAAU,SAAS,MACrB,WAAW,KAAK,SAAS;GAK/B,OAAO;EACT;;;;;;;;EASA,oBAAoB,UAA0B,iBAAgD;GAC5F,MAAM,aAAoC,CAAC;GAE3C,KAAK,MAAM,UAAU,kBAAkB,OAAO,GAAG;IAC/C,MAAM,iBAAiB,OAAO,QAAQ;IACtC,IAAI,gBACF,eAAe,SAAS,WAA0B,UAAkB;KAClE,WAAW,KAAK;MAAE,GAAG;MAAW,IAAI,gBAAgB,cAAc,OAAO,MAAM,UAAU,KAAK;KAAE,CAAC;IACnG,CAAC;GAEL;GAEA,OAAO;EACT;;;;EAKA,aAAa,WAA0C;GACrD,KAAK,MAAM,UAAU,kBAAkB,OAAO,GAC5C,OAAO,OAAO,SAAS;IAAE;IAAQ,MAAM;GAAU,CAAC;EAEtD;;;;EAKA,qBAAqB,WAA0C;GAC7D,KAAK,MAAM,UAAU,kBAAkB,OAAO,GAC5C,OAAO,OAAO,iBAAiB;IAAE;IAAQ,MAAM;GAAU,CAAC;EAE9D;;;;;;;EAQA,oBAAqC;;;;EAKrC,qBAA2B;GACzB,KAAK,MAAM,UAAU,kBAAkB,OAAO,GAC5C,OAAO,OAAO,YAAY;EAE9B;;;;EAKA,2BAA2C;GACzC,MAAM,mBAAmC,CAAC;GAE1C,KAAK,MAAM,UAAU,kBAAkB,OAAO,GAC5C,IAAI,OAAO,kBACT,iBAAiB,KAAK,GAAI,OAAO,gBAAmC;GAIxE,OAAO;EACT;;;;;;;;EASA,oBAAoB,iBAA+C;GACjE,MAAM,UAAgC,CAAC;GAEvC,KAAK,MAAM,UAAU,kBAAkB,OAAO,GAC5C,KAAK,MAAM,YAAY,mBAErB,CADuB,OAAO,QAAQ,UAAA,EACtB,SAAS,WAA0B,UAAkB;IACnE,IAAI,UAAU,SAAS,QAAQ,UAAU,QAAQ,OAC/C,QAAQ,KAAK;KACX,IAAI,gBAAgB,cAAc,OAAO,MAAM,UAAU,KAAK;KAC9D,OAAO,UAAU,QAAQ;KACzB;IACF,CAAC;GAEL,CAAC;GAIL,OAAO;EACT;CACF;AACF"}

package/dist/plugins/posthog/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/plugins/posthog/index.ts"],"sourcesContent":["import { PostHogClientPlugin, type PostHogConfig } from '@scalar/api-client/plugins/posthog'\nimport type { PostHog } from 'posthog-js'\nimport ph from 'posthog-js'\n\nimport type { ApiReferencePlugin } from '../plugin-manager'\n\nexport type { PostHogConfig }\n\n/**\n * PostHog analytics plugin for the API Reference.\n *\n * Loading this plugin opts in to analytics for both the API Reference\n * and the embedded API Client (tracked as separate products).\n *\n * Respects the `telemetry` configuration option — when set to `false`,\n * capturing is disabled. Reacts dynamically to config changes at runtime.\n *\n * If the plugin is not loaded, no tracking occurs.\n */\nexport const PostHogPlugin = (config: PostHogConfig): ApiReferencePlugin => {\n  let posthog: PostHog | null = null\n  const clientPlugin = PostHogClientPlugin(config)\n\n  return () => ({\n    name: 'posthog',\n    extensions: [],\n    apiClientPlugins: [clientPlugin],\n    hooks: {\n      onInit({ config: referenceConfig }) {\n        if (typeof window === 'undefined') {\n          return\n        }\n\n        const instance = ph.init(\n          config.apiKey,\n          {\n            api_host: config.apiHost,\n            ...(config.uiHost ? { ui_host: config.uiHost } : {}),\n            ...(config.defaults ? { defaults: config.defaults } : {}),\n            opt_out_capturing_by_default: true,\n          },\n          'scalar-api-reference',\n        )\n\n        if (instance) {\n          posthog = instance\n          posthog.register({ product: 'api-reference' })\n\n          if (referenceConfig.telemetry !== false) {\n            posthog.opt_in_capturing()\n          }\n        }\n\n        clientPlugin.lifecycle?.onInit?.({ config: referenceConfig })\n      },\n      onConfigChange({ config: referenceConfig }) {\n        if (posthog) {\n          if (referenceConfig.telemetry === false) {\n            posthog.opt_out_capturing()\n          } else {\n            posthog.opt_in_capturing()\n          }\n        }\n\n        clientPlugin.lifecycle?.onConfigChange?.({ config: referenceConfig })\n      },\n      onDestroy() {\n        posthog?.reset()\n        posthog = null\n\n        clientPlugin.lifecycle?.onDestroy?.()\n      },\n    },\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,IAAa,iBAAiB,WAA8C;CAC1E,IAAI,UAA0B;CAC9B,MAAM,eAAe,oBAAoB,OAAO;AAEhD,eAAc;EACZ,MAAM;EACN,YAAY,EAAE;EACd,kBAAkB,CAAC,aAAa;EAChC,OAAO;GACL,OAAO,EAAE,QAAQ,mBAAmB;AAClC,QAAI,OAAO,WAAW,YACpB;IAGF,MAAM,WAAW,GAAG,KAClB,OAAO,QACP;KACE,UAAU,OAAO;KACjB,GAAI,OAAO,SAAS,EAAE,SAAS,OAAO,QAAQ,GAAG,EAAE;KACnD,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;KACxD,8BAA8B;KAC/B,EACD,uBACD;AAED,QAAI,UAAU;AACZ,eAAU;AACV,aAAQ,SAAS,EAAE,SAAS,iBAAiB,CAAC;AAE9C,SAAI,gBAAgB,cAAc,MAChC,SAAQ,kBAAkB;;AAI9B,iBAAa,WAAW,SAAS,EAAE,QAAQ,iBAAiB,CAAC;;GAE/D,eAAe,EAAE,QAAQ,mBAAmB;AAC1C,QAAI,QACF,KAAI,gBAAgB,cAAc,MAChC,SAAQ,mBAAmB;QAE3B,SAAQ,kBAAkB;AAI9B,iBAAa,WAAW,iBAAiB,EAAE,QAAQ,iBAAiB,CAAC;;GAEvE,YAAY;AACV,aAAS,OAAO;AAChB,cAAU;AAEV,iBAAa,WAAW,aAAa;;GAExC;EACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/plugins/posthog/index.ts"],"sourcesContent":["import { PostHogClientPlugin, type PostHogConfig } from '@scalar/api-client/plugins/posthog'\nimport type { PostHog } from 'posthog-js'\nimport ph from 'posthog-js'\n\nimport type { ApiReferencePlugin } from '../plugin-manager'\n\nexport type { PostHogConfig }\n\n/**\n * PostHog analytics plugin for the API Reference.\n *\n * Loading this plugin opts in to analytics for both the API Reference\n * and the embedded API Client (tracked as separate products).\n *\n * Respects the `telemetry` configuration option — when set to `false`,\n * capturing is disabled. Reacts dynamically to config changes at runtime.\n *\n * If the plugin is not loaded, no tracking occurs.\n */\nexport const PostHogPlugin = (config: PostHogConfig): ApiReferencePlugin => {\n  let posthog: PostHog | null = null\n  const clientPlugin = PostHogClientPlugin(config)\n\n  return () => ({\n    name: 'posthog',\n    extensions: [],\n    apiClientPlugins: [clientPlugin],\n    hooks: {\n      onInit({ config: referenceConfig }) {\n        if (typeof window === 'undefined') {\n          return\n        }\n\n        const instance = ph.init(\n          config.apiKey,\n          {\n            api_host: config.apiHost,\n            ...(config.uiHost ? { ui_host: config.uiHost } : {}),\n            ...(config.defaults ? { defaults: config.defaults } : {}),\n            opt_out_capturing_by_default: true,\n          },\n          'scalar-api-reference',\n        )\n\n        if (instance) {\n          posthog = instance\n          posthog.register({ product: 'api-reference' })\n\n          if (referenceConfig.telemetry !== false) {\n            posthog.opt_in_capturing()\n          }\n        }\n\n        clientPlugin.lifecycle?.onInit?.({ config: referenceConfig })\n      },\n      onConfigChange({ config: referenceConfig }) {\n        if (posthog) {\n          if (referenceConfig.telemetry === false) {\n            posthog.opt_out_capturing()\n          } else {\n            posthog.opt_in_capturing()\n          }\n        }\n\n        clientPlugin.lifecycle?.onConfigChange?.({ config: referenceConfig })\n      },\n      onDestroy() {\n        posthog?.reset()\n        posthog = null\n\n        clientPlugin.lifecycle?.onDestroy?.()\n      },\n    },\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,IAAa,iBAAiB,WAA8C;CAC1E,IAAI,UAA0B;CAC9B,MAAM,eAAe,oBAAoB,MAAM;CAE/C,cAAc;EACZ,MAAM;EACN,YAAY,CAAC;EACb,kBAAkB,CAAC,YAAY;EAC/B,OAAO;GACL,OAAO,EAAE,QAAQ,mBAAmB;IAClC,IAAI,OAAO,WAAW,aACpB;IAGF,MAAM,WAAW,GAAG,KAClB,OAAO,QACP;KACE,UAAU,OAAO;KACjB,GAAI,OAAO,SAAS,EAAE,SAAS,OAAO,OAAO,IAAI,CAAC;KAClD,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,SAAS,IAAI,CAAC;KACvD,8BAA8B;IAChC,GACA,sBACF;IAEA,IAAI,UAAU;KACZ,UAAU;KACV,QAAQ,SAAS,EAAE,SAAS,gBAAgB,CAAC;KAE7C,IAAI,gBAAgB,cAAc,OAChC,QAAQ,iBAAiB;IAE7B;IAEA,aAAa,WAAW,SAAS,EAAE,QAAQ,gBAAgB,CAAC;GAC9D;GACA,eAAe,EAAE,QAAQ,mBAAmB;IAC1C,IAAI,SACF,IAAI,gBAAgB,cAAc,OAChC,QAAQ,kBAAkB;SAE1B,QAAQ,iBAAiB;IAI7B,aAAa,WAAW,iBAAiB,EAAE,QAAQ,gBAAgB,CAAC;GACtE;GACA,YAAY;IACV,SAAS,MAAM;IACf,UAAU;IAEV,aAAa,WAAW,YAAY;GACtC;EACF;CACF;AACF"}

package/dist/standalone/lib/html-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-api.d.ts","sourceRoot":"","sources":["../../../src/standalone/lib/html-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,mCAAmC,EACnC,kBAAkB,EACnB,MAAM,6BAA6B,CAAA;AAqEpC;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,QAAQ,GAAG,mCAAmC,CA+GrG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,mCAAmC,QAiBnG;AAID,eAAO,MAAM,eAAe,GAAI,KAAK,QAAQ,EAAE,UAAU,OAAO,GAAG,IAAI,mBAatE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAkJhC,CAAA"}
+{"version":3,"file":"html-api.d.ts","sourceRoot":"","sources":["../../../src/standalone/lib/html-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,mCAAmC,EACnC,kBAAkB,EACnB,MAAM,6BAA6B,CAAA;AAsEpC;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,QAAQ,GAAG,mCAAmC,CA+GrG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,mCAAmC,QAiBnG;AAID,eAAO,MAAM,eAAe,GAAI,KAAK,QAAQ,EAAE,UAAU,OAAO,GAAG,IAAI,mBAatE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAoKhC,CAAA"}

package/dist/standalone/lib/html-api.js

@@ -1,4 +1,5 @@
 import ApiReference_default from "../../components/ApiReference.vue.js";
+import { hasPluginUrls, loadPluginsFromUrls } from "./load-plugins-from-urls.js";
 import { createApp, createSSRApp, h, reactive } from "vue";
 import "@scalar/schemas/api-reference";
 import { createHead } from "@unhead/vue/client";
@@ -73,9 +74,15 @@ var createApiReference = (elementOrSelectorOrConfig, optionalConfiguration) => {
 	let app = createReferenceApp(!!optionalConfiguration && !!mountElement && mountElement.children.length > 0);
 	let hasMounted = false;
 	if (optionalConfiguration) if (mountElement) {
-		app.mount(mountElement);
-		hasMounted = true;
-		retainStandaloneStyles(document);
+		const mount = () => {
+			app.mount(mountElement);
+			hasMounted = true;
+			retainStandaloneStyles(document);
+		};
+		if (hasPluginUrls(props.configuration)) loadPluginsFromUrls(props.configuration).then(() => {
+			if (!abortController.signal.aborted) mount();
+		});
+		else mount();
 	} else console.error("Could not find a mount point for API References:", elementOrSelectorOrConfig);
 	const abortController = new AbortController();
 	const listenerOptions = {
@@ -100,9 +107,9 @@ var createApiReference = (elementOrSelectorOrConfig, optionalConfiguration) => {
 	const destroy = () => {
 		abortController.abort();
 		props.configuration = {};
-		app.unmount();
 		if (hasMounted) {
 			hasMounted = false;
+			app.unmount();
 			releaseStandaloneStyles(document);
 		}
 	};

package/dist/standalone/lib/html-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"html-api.js","names":[],"sources":["../../../src/standalone/lib/html-api.ts"],"sourcesContent":["import { apiReferenceConfigurationWithSourceSchema } from '@scalar/schemas/api-reference'\nimport type {\n  AnyApiReferenceConfiguration,\n  ApiReferenceConfigurationWithSource,\n  CreateApiReference,\n} from '@scalar/types/api-reference'\nimport { createHead } from '@unhead/vue/client'\nimport { createApp, createSSRApp, h, reactive } from 'vue'\n\nimport { default as ApiReference } from '@/components/ApiReference.vue'\n\nconst getSpecScriptTag = (doc: Document) => doc.getElementById('api-reference')\n\n/**\n * The id given to the standalone build's single injected `<style>` tag.\n * Keep in sync with `vite.standalone.config.ts` and `vite.standalone.esm.config.ts`.\n */\nconst STANDALONE_STYLE_ID = 'scalar-style'\n\n/**\n * Per-document bookkeeping for the standalone build's injected styles.\n *\n * The CDN build injects all of its CSS into one `<style>` tag in `<head>`. Under\n * SPA-style navigation (Turbo Drive, htmx boost, Astro view transitions) the host\n * swaps the DOM without reloading the window, so those document-level styles\n * (`@layer scalar-base`, the `:root` theme variables) would otherwise linger and\n * bleed into the host app's next page. We reference-count the live instances and\n * detach the styles when the last one is destroyed, re-attaching them when a new\n * instance mounts so navigating back to the reference is still styled.\n *\n * State is keyed by document so the counter survives navigations (the JS context\n * persists) while staying isolated per page.\n */\nconst standaloneStyleState = new WeakMap<Document, { count: number; detachedStyle: HTMLStyleElement | null }>()\n\nconst getStandaloneStyleState = (doc: Document): { count: number; detachedStyle: HTMLStyleElement | null } => {\n  const existing = standaloneStyleState.get(doc)\n  if (existing) {\n    return existing\n  }\n\n  const state = { count: 0, detachedStyle: null }\n  standaloneStyleState.set(doc, state)\n\n  return state\n}\n\n/** Track a freshly mounted instance and restore previously detached styles. */\nconst retainStandaloneStyles = (doc: Document): void => {\n  const state = getStandaloneStyleState(doc)\n  state.count += 1\n\n  if (state.detachedStyle && !doc.getElementById(STANDALONE_STYLE_ID)) {\n    doc.head.appendChild(state.detachedStyle)\n    state.detachedStyle = null\n  }\n}\n\n/** Release an instance and detach the injected styles once the last one is gone. */\nconst releaseStandaloneStyles = (doc: Document): void => {\n  const state = getStandaloneStyleState(doc)\n  state.count = Math.max(0, state.count - 1)\n\n  if (state.count > 0) {\n    return\n  }\n\n  const styleElement = doc.getElementById(STANDALONE_STYLE_ID)\n  if (styleElement instanceof HTMLStyleElement) {\n    state.detachedStyle = styleElement\n    styleElement.remove()\n  }\n}\n\n/**\n * Reading the configuration from the data-attributes.\n */\nexport function getConfigurationFromDataAttributes(doc: Document): ApiReferenceConfigurationWithSource {\n  const specElement = doc.querySelector('[data-spec]')\n  const specUrlElement = doc.querySelector('[data-spec-url]')\n  const configurationScriptElement = doc.querySelector('#api-reference[data-configuration]')\n\n  const getConfiguration = () => {\n    // <script data-configuration=\"{ … }\" />\n    if (configurationScriptElement) {\n      const configurationFromElement = configurationScriptElement.getAttribute('data-configuration')\n\n      if (configurationFromElement) {\n        return {\n          _integration: 'html',\n          ...JSON.parse(configurationFromElement.split('&quot;').join('\"')),\n        }\n      }\n    }\n\n    return apiReferenceConfigurationWithSourceSchema({ _integration: 'html' })\n  }\n\n  const getUrl = () => {\n    // Let's first check if the user passed a spec URL in the configuration.\n    if (getConfiguration().url) {\n      return getConfiguration().url\n    }\n\n    if (getConfiguration().spec?.url) {\n      return getConfiguration().spec?.url\n    }\n\n    // <script id=\"api-reference\" data-url=\"/scalar.json\" />\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const urlFromScriptTag = specScriptTag.getAttribute('data-url')?.trim()\n\n      if (urlFromScriptTag) {\n        return urlFromScriptTag\n      }\n    }\n\n    // <div data-spec-url=\"/scalar.json\" />\n    if (specUrlElement) {\n      console.warn(\n        '[@scalar/api-reference] The [data-spec-url] HTML API is deprecated. Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead.',\n      )\n      const urlFromSpecUrlElement = specUrlElement.getAttribute('data-spec-url')\n\n      if (urlFromSpecUrlElement) {\n        return urlFromSpecUrlElement\n      }\n    }\n\n    return undefined\n  }\n\n  const getContent = (): string | undefined => {\n    // <script id=\"api-reference\" type=\"application/json\">{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}</script>\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const specFromScriptTag = specScriptTag.innerHTML?.trim()\n\n      if (specFromScriptTag) {\n        return specFromScriptTag\n      }\n    }\n\n    // <div data-spec='{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}' />\n    if (specElement) {\n      console.warn(\n        '[@scalar/api-reference] The [data-spec] HTML API is deprecated. Use the new <script id=\"api-reference\" type=\"application/json\">{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}</script> API instead.',\n      )\n      const specFromSpecElement = specElement.getAttribute('data-spec')?.trim()\n\n      if (specFromSpecElement) {\n        return specFromSpecElement\n      }\n    }\n\n    return undefined\n  }\n\n  const getProxyUrl = () => {\n    // <script id=\"api-reference\" data-proxy-url=\"https://proxy.scalar.com\">…</script>\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const proxyUrl = specScriptTag.getAttribute('data-proxy-url')\n\n      if (proxyUrl) {\n        return proxyUrl.trim()\n      }\n    }\n\n    return undefined\n  }\n\n  // Ensure Reference Props are reactive\n  if (!specUrlElement && !specElement && !getSpecScriptTag(doc)) {\n    // Stay quiet.\n  } else {\n    const urlOrContent = getContent() ? { content: getContent() } : { url: getUrl() }\n\n    return apiReferenceConfigurationWithSourceSchema({\n      _integration: 'html',\n      proxyUrl: getProxyUrl(),\n      ...getConfiguration(),\n      ...urlOrContent,\n    })\n  }\n\n  return apiReferenceConfigurationWithSourceSchema({ _integration: 'html' })\n}\n\n/**\n * Mount the Scalar API Reference on a given document.\n * Read the HTML data-attributes for configuration.\n */\nexport function findDataAttributes(doc: Document, configuration: ApiReferenceConfigurationWithSource) {\n  /** @deprecated Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead. */\n  const specElement = doc.querySelector('[data-spec]')\n  /** @deprecated Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead. */\n  const specUrlElement = doc.querySelector('[data-spec-url]')\n\n  if (configuration?.darkMode) {\n    doc.body?.classList.add('dark-mode')\n  } else {\n    doc.body?.classList.add('light-mode')\n  }\n\n  const container = createContainer(doc, specElement || specUrlElement)\n\n  if (container) {\n    createApiReference(container, configuration)\n  }\n}\n\n// If it's a script tag, we can't mount the Vue.js app inside that tag.\n// We need to add a new container element before the script tag.\nexport const createContainer = (doc: Document, element?: Element | null) => {\n  let _container: Element | null = null\n\n  const specScriptTag = getSpecScriptTag(doc)\n\n  if (specScriptTag) {\n    _container = doc.createElement('div')\n    specScriptTag?.parentNode?.insertBefore(_container, specScriptTag)\n  } else if (element) {\n    _container = element\n  }\n\n  return _container\n}\n\n/**\n * Create (and mount) a new Scalar API Reference\n *\n * @example createApiReference({ url: '/scalar.json' }).mount('#app')\n * @example createApiReference('#app', { url: '/scalar.json' })\n * @example createApiReference(document.getElementById('app'), { url: '/scalar.json' })\n */\nexport const createApiReference: CreateApiReference = (\n  elementOrSelectorOrConfig,\n  optionalConfiguration?: AnyApiReferenceConfiguration,\n) => {\n  // Create an id prefix for useId so we don't have collisions with other Vue apps\n  const idPrefix = 'scalar-refs'\n\n  const props = reactive<{ configuration: AnyApiReferenceConfiguration }>({\n    // Either the configuration will be the second argument or it MUST be the first (configuration only)\n    configuration: optionalConfiguration ?? (elementOrSelectorOrConfig as AnyApiReferenceConfiguration) ?? {},\n  })\n\n  const createReferenceApp = (isSsr = false) => {\n    const referenceApp = isSsr ? createSSRApp(() => h(ApiReference, props)) : createApp(() => h(ApiReference, props))\n\n    // Meta tags, etc.\n    referenceApp.use(createHead())\n    referenceApp.config.idPrefix = idPrefix\n\n    return referenceApp\n  }\n\n  // If we have an optional config, then we must mount the element immediately (not sure why type is not narrowing)\n  const mountElement = optionalConfiguration\n    ? typeof elementOrSelectorOrConfig === 'string'\n      ? document.querySelector(elementOrSelectorOrConfig)\n      : (elementOrSelectorOrConfig as Element)\n    : null\n\n  // Detect server-rendered content and use createSSRApp for hydration\n  const shouldHydrate = !!optionalConfiguration && !!mountElement && mountElement.children.length > 0\n  let app = createReferenceApp(shouldHydrate)\n\n  // Track whether this instance mounted so `destroy` only releases the shared\n  // standalone styles for instances that actually retained them.\n  let hasMounted = false\n\n  if (optionalConfiguration) {\n    if (mountElement) {\n      app.mount(mountElement)\n      hasMounted = true\n      retainStandaloneStyles(document)\n    } else {\n      console.error('Could not find a mount point for API References:', elementOrSelectorOrConfig)\n    }\n  }\n\n  // Tie the deprecated `document` listeners to an AbortController so `destroy`\n  // can remove them all at once. Without this, every `createApiReference()`\n  // call leaks three permanent listeners — visible during Astro view\n  // transitions where each navigation creates a new instance.\n  const abortController = new AbortController()\n  const listenerOptions: AddEventListenerOptions = {\n    capture: false,\n    signal: abortController.signal,\n  }\n\n  /**\n   * Reload the API Reference\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:reload-references',\n    () => {\n      console.warn(\n        'scalar:reload-references event has been deprecated, please use the scalarInstance.app.mount method instead.',\n      )\n      if (!props.configuration) {\n        return\n      }\n\n      // Snag the current element\n      const currentElement =\n        typeof elementOrSelectorOrConfig === 'string'\n          ? document.querySelector(elementOrSelectorOrConfig)\n          : (elementOrSelectorOrConfig as Element)\n\n      if (!currentElement) {\n        return\n      }\n\n      // Ensure we re-attach the element if it was unmounted\n      if (currentElement && !document.body.contains(currentElement)) {\n        document.body.appendChild(currentElement)\n      }\n\n      // Create a new Vue app instance\n      app.unmount()\n      app = createReferenceApp()\n      app.mount(currentElement)\n    },\n    listenerOptions,\n  )\n\n  /** Destroy the current API Reference instance */\n  const destroy = () => {\n    abortController.abort()\n    props.configuration = {}\n    app.unmount()\n\n    if (hasMounted) {\n      hasMounted = false\n      releaseStandaloneStyles(document)\n    }\n  }\n\n  /**\n   * Allow user to destroy the API Reference\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:destroy-references',\n    () => {\n      console.warn('scalar:destroy-references event has been deprecated, please use scalarInstance.destroy instead.')\n      destroy()\n    },\n    listenerOptions,\n  )\n\n  /**\n   * Allow user to update configuration\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:update-references-config',\n    (ev) => {\n      console.warn(\n        'scalar:update-references-config event has been deprecated, please use scalarInstance.updateConfiguration instead.',\n      )\n      if ('detail' in ev) {\n        Object.assign(props, ev.detail)\n      }\n    },\n    listenerOptions,\n  )\n\n  const instance = {\n    app,\n    getConfiguration: () => props.configuration ?? {},\n    updateConfiguration: (newConfig: AnyApiReferenceConfiguration) => {\n      props.configuration = newConfig\n    },\n    destroy,\n  }\n\n  return instance\n}\n"],"mappings":";;;;;;;;;AAiBA,IAAM,sBAAsB;;;;;;;;;;;;;;;AAgB5B,IAAM,uCAAuB,IAAI,SAA8E;AAE/G,IAAM,2BAA2B,QAA6E;CAC5G,MAAM,WAAW,qBAAqB,IAAI,IAAI;AAC9C,KAAI,SACF,QAAO;CAGT,MAAM,QAAQ;EAAE,OAAO;EAAG,eAAe;EAAM;AAC/C,sBAAqB,IAAI,KAAK,MAAM;AAEpC,QAAO;;;AAIT,IAAM,0BAA0B,QAAwB;CACtD,MAAM,QAAQ,wBAAwB,IAAI;AAC1C,OAAM,SAAS;AAEf,KAAI,MAAM,iBAAiB,CAAC,IAAI,eAAe,oBAAoB,EAAE;AACnE,MAAI,KAAK,YAAY,MAAM,cAAc;AACzC,QAAM,gBAAgB;;;;AAK1B,IAAM,2BAA2B,QAAwB;CACvD,MAAM,QAAQ,wBAAwB,IAAI;AAC1C,OAAM,QAAQ,KAAK,IAAI,GAAG,MAAM,QAAQ,EAAE;AAE1C,KAAI,MAAM,QAAQ,EAChB;CAGF,MAAM,eAAe,IAAI,eAAe,oBAAoB;AAC5D,KAAI,wBAAwB,kBAAkB;AAC5C,QAAM,gBAAgB;AACtB,eAAa,QAAQ;;;;;;;;;;AAuKzB,IAAa,sBACX,2BACA,0BACG;CAEH,MAAM,WAAW;CAEjB,MAAM,QAAQ,SAA0D,EAEtE,eAAe,yBAA0B,6BAA8D,EAAE,EAC1G,CAAC;CAEF,MAAM,sBAAsB,QAAQ,UAAU;EAC5C,MAAM,eAAe,QAAQ,mBAAmB,EAAE,sBAAc,MAAM,CAAC,GAAG,gBAAgB,EAAE,sBAAc,MAAM,CAAC;AAGjH,eAAa,IAAI,YAAY,CAAC;AAC9B,eAAa,OAAO,WAAW;AAE/B,SAAO;;CAIT,MAAM,eAAe,wBACjB,OAAO,8BAA8B,WACnC,SAAS,cAAc,0BAA0B,GAChD,4BACH;CAIJ,IAAI,MAAM,mBADY,CAAC,CAAC,yBAAyB,CAAC,CAAC,gBAAgB,aAAa,SAAS,SAAS,EACvD;CAI3C,IAAI,aAAa;AAEjB,KAAI,sBACF,KAAI,cAAc;AAChB,MAAI,MAAM,aAAa;AACvB,eAAa;AACb,yBAAuB,SAAS;OAEhC,SAAQ,MAAM,oDAAoD,0BAA0B;CAQhG,MAAM,kBAAkB,IAAI,iBAAiB;CAC7C,MAAM,kBAA2C;EAC/C,SAAS;EACT,QAAQ,gBAAgB;EACzB;;;;;AAMD,UAAS,iBACP,kCACM;AACJ,UAAQ,KACN,8GACD;AACD,MAAI,CAAC,MAAM,cACT;EAIF,MAAM,iBACJ,OAAO,8BAA8B,WACjC,SAAS,cAAc,0BAA0B,GAChD;AAEP,MAAI,CAAC,eACH;AAIF,MAAI,kBAAkB,CAAC,SAAS,KAAK,SAAS,eAAe,CAC3D,UAAS,KAAK,YAAY,eAAe;AAI3C,MAAI,SAAS;AACb,QAAM,oBAAoB;AAC1B,MAAI,MAAM,eAAe;IAE3B,gBACD;;CAGD,MAAM,gBAAgB;AACpB,kBAAgB,OAAO;AACvB,QAAM,gBAAgB,EAAE;AACxB,MAAI,SAAS;AAEb,MAAI,YAAY;AACd,gBAAa;AACb,2BAAwB,SAAS;;;;;;;AAQrC,UAAS,iBACP,mCACM;AACJ,UAAQ,KAAK,kGAAkG;AAC/G,WAAS;IAEX,gBACD;;;;;AAMD,UAAS,iBACP,oCACC,OAAO;AACN,UAAQ,KACN,oHACD;AACD,MAAI,YAAY,GACd,QAAO,OAAO,OAAO,GAAG,OAAO;IAGnC,gBACD;AAWD,QATiB;EACf;EACA,wBAAwB,MAAM,iBAAiB,EAAE;EACjD,sBAAsB,cAA4C;AAChE,SAAM,gBAAgB;;EAExB;EACD"}
+{"version":3,"file":"html-api.js","names":[],"sources":["../../../src/standalone/lib/html-api.ts"],"sourcesContent":["import { apiReferenceConfigurationWithSourceSchema } from '@scalar/schemas/api-reference'\nimport type {\n  AnyApiReferenceConfiguration,\n  ApiReferenceConfigurationWithSource,\n  CreateApiReference,\n} from '@scalar/types/api-reference'\nimport { createHead } from '@unhead/vue/client'\nimport { createApp, createSSRApp, h, reactive } from 'vue'\n\nimport { default as ApiReference } from '@/components/ApiReference.vue'\nimport { hasPluginUrls, loadPluginsFromUrls } from '@/standalone/lib/load-plugins-from-urls'\n\nconst getSpecScriptTag = (doc: Document) => doc.getElementById('api-reference')\n\n/**\n * The id given to the standalone build's single injected `<style>` tag.\n * Keep in sync with `vite.standalone.config.ts` and `vite.standalone.esm.config.ts`.\n */\nconst STANDALONE_STYLE_ID = 'scalar-style'\n\n/**\n * Per-document bookkeeping for the standalone build's injected styles.\n *\n * The CDN build injects all of its CSS into one `<style>` tag in `<head>`. Under\n * SPA-style navigation (Turbo Drive, htmx boost, Astro view transitions) the host\n * swaps the DOM without reloading the window, so those document-level styles\n * (`@layer scalar-base`, the `:root` theme variables) would otherwise linger and\n * bleed into the host app's next page. We reference-count the live instances and\n * detach the styles when the last one is destroyed, re-attaching them when a new\n * instance mounts so navigating back to the reference is still styled.\n *\n * State is keyed by document so the counter survives navigations (the JS context\n * persists) while staying isolated per page.\n */\nconst standaloneStyleState = new WeakMap<Document, { count: number; detachedStyle: HTMLStyleElement | null }>()\n\nconst getStandaloneStyleState = (doc: Document): { count: number; detachedStyle: HTMLStyleElement | null } => {\n  const existing = standaloneStyleState.get(doc)\n  if (existing) {\n    return existing\n  }\n\n  const state = { count: 0, detachedStyle: null }\n  standaloneStyleState.set(doc, state)\n\n  return state\n}\n\n/** Track a freshly mounted instance and restore previously detached styles. */\nconst retainStandaloneStyles = (doc: Document): void => {\n  const state = getStandaloneStyleState(doc)\n  state.count += 1\n\n  if (state.detachedStyle && !doc.getElementById(STANDALONE_STYLE_ID)) {\n    doc.head.appendChild(state.detachedStyle)\n    state.detachedStyle = null\n  }\n}\n\n/** Release an instance and detach the injected styles once the last one is gone. */\nconst releaseStandaloneStyles = (doc: Document): void => {\n  const state = getStandaloneStyleState(doc)\n  state.count = Math.max(0, state.count - 1)\n\n  if (state.count > 0) {\n    return\n  }\n\n  const styleElement = doc.getElementById(STANDALONE_STYLE_ID)\n  if (styleElement instanceof HTMLStyleElement) {\n    state.detachedStyle = styleElement\n    styleElement.remove()\n  }\n}\n\n/**\n * Reading the configuration from the data-attributes.\n */\nexport function getConfigurationFromDataAttributes(doc: Document): ApiReferenceConfigurationWithSource {\n  const specElement = doc.querySelector('[data-spec]')\n  const specUrlElement = doc.querySelector('[data-spec-url]')\n  const configurationScriptElement = doc.querySelector('#api-reference[data-configuration]')\n\n  const getConfiguration = () => {\n    // <script data-configuration=\"{ … }\" />\n    if (configurationScriptElement) {\n      const configurationFromElement = configurationScriptElement.getAttribute('data-configuration')\n\n      if (configurationFromElement) {\n        return {\n          _integration: 'html',\n          ...JSON.parse(configurationFromElement.split('&quot;').join('\"')),\n        }\n      }\n    }\n\n    return apiReferenceConfigurationWithSourceSchema({ _integration: 'html' })\n  }\n\n  const getUrl = () => {\n    // Let's first check if the user passed a spec URL in the configuration.\n    if (getConfiguration().url) {\n      return getConfiguration().url\n    }\n\n    if (getConfiguration().spec?.url) {\n      return getConfiguration().spec?.url\n    }\n\n    // <script id=\"api-reference\" data-url=\"/scalar.json\" />\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const urlFromScriptTag = specScriptTag.getAttribute('data-url')?.trim()\n\n      if (urlFromScriptTag) {\n        return urlFromScriptTag\n      }\n    }\n\n    // <div data-spec-url=\"/scalar.json\" />\n    if (specUrlElement) {\n      console.warn(\n        '[@scalar/api-reference] The [data-spec-url] HTML API is deprecated. Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead.',\n      )\n      const urlFromSpecUrlElement = specUrlElement.getAttribute('data-spec-url')\n\n      if (urlFromSpecUrlElement) {\n        return urlFromSpecUrlElement\n      }\n    }\n\n    return undefined\n  }\n\n  const getContent = (): string | undefined => {\n    // <script id=\"api-reference\" type=\"application/json\">{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}</script>\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const specFromScriptTag = specScriptTag.innerHTML?.trim()\n\n      if (specFromScriptTag) {\n        return specFromScriptTag\n      }\n    }\n\n    // <div data-spec='{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}' />\n    if (specElement) {\n      console.warn(\n        '[@scalar/api-reference] The [data-spec] HTML API is deprecated. Use the new <script id=\"api-reference\" type=\"application/json\">{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}</script> API instead.',\n      )\n      const specFromSpecElement = specElement.getAttribute('data-spec')?.trim()\n\n      if (specFromSpecElement) {\n        return specFromSpecElement\n      }\n    }\n\n    return undefined\n  }\n\n  const getProxyUrl = () => {\n    // <script id=\"api-reference\" data-proxy-url=\"https://proxy.scalar.com\">…</script>\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const proxyUrl = specScriptTag.getAttribute('data-proxy-url')\n\n      if (proxyUrl) {\n        return proxyUrl.trim()\n      }\n    }\n\n    return undefined\n  }\n\n  // Ensure Reference Props are reactive\n  if (!specUrlElement && !specElement && !getSpecScriptTag(doc)) {\n    // Stay quiet.\n  } else {\n    const urlOrContent = getContent() ? { content: getContent() } : { url: getUrl() }\n\n    return apiReferenceConfigurationWithSourceSchema({\n      _integration: 'html',\n      proxyUrl: getProxyUrl(),\n      ...getConfiguration(),\n      ...urlOrContent,\n    })\n  }\n\n  return apiReferenceConfigurationWithSourceSchema({ _integration: 'html' })\n}\n\n/**\n * Mount the Scalar API Reference on a given document.\n * Read the HTML data-attributes for configuration.\n */\nexport function findDataAttributes(doc: Document, configuration: ApiReferenceConfigurationWithSource) {\n  /** @deprecated Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead. */\n  const specElement = doc.querySelector('[data-spec]')\n  /** @deprecated Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead. */\n  const specUrlElement = doc.querySelector('[data-spec-url]')\n\n  if (configuration?.darkMode) {\n    doc.body?.classList.add('dark-mode')\n  } else {\n    doc.body?.classList.add('light-mode')\n  }\n\n  const container = createContainer(doc, specElement || specUrlElement)\n\n  if (container) {\n    createApiReference(container, configuration)\n  }\n}\n\n// If it's a script tag, we can't mount the Vue.js app inside that tag.\n// We need to add a new container element before the script tag.\nexport const createContainer = (doc: Document, element?: Element | null) => {\n  let _container: Element | null = null\n\n  const specScriptTag = getSpecScriptTag(doc)\n\n  if (specScriptTag) {\n    _container = doc.createElement('div')\n    specScriptTag?.parentNode?.insertBefore(_container, specScriptTag)\n  } else if (element) {\n    _container = element\n  }\n\n  return _container\n}\n\n/**\n * Create (and mount) a new Scalar API Reference\n *\n * @example createApiReference({ url: '/scalar.json' }).mount('#app')\n * @example createApiReference('#app', { url: '/scalar.json' })\n * @example createApiReference(document.getElementById('app'), { url: '/scalar.json' })\n */\nexport const createApiReference: CreateApiReference = (\n  elementOrSelectorOrConfig,\n  optionalConfiguration?: AnyApiReferenceConfiguration,\n) => {\n  // Create an id prefix for useId so we don't have collisions with other Vue apps\n  const idPrefix = 'scalar-refs'\n\n  const props = reactive<{ configuration: AnyApiReferenceConfiguration }>({\n    // Either the configuration will be the second argument or it MUST be the first (configuration only)\n    configuration: optionalConfiguration ?? (elementOrSelectorOrConfig as AnyApiReferenceConfiguration) ?? {},\n  })\n\n  const createReferenceApp = (isSsr = false) => {\n    const referenceApp = isSsr ? createSSRApp(() => h(ApiReference, props)) : createApp(() => h(ApiReference, props))\n\n    // Meta tags, etc.\n    referenceApp.use(createHead())\n    referenceApp.config.idPrefix = idPrefix\n\n    return referenceApp\n  }\n\n  // If we have an optional config, then we must mount the element immediately (not sure why type is not narrowing)\n  const mountElement = optionalConfiguration\n    ? typeof elementOrSelectorOrConfig === 'string'\n      ? document.querySelector(elementOrSelectorOrConfig)\n      : (elementOrSelectorOrConfig as Element)\n    : null\n\n  // Detect server-rendered content and use createSSRApp for hydration\n  const shouldHydrate = !!optionalConfiguration && !!mountElement && mountElement.children.length > 0\n  let app = createReferenceApp(shouldHydrate)\n\n  // Track whether this instance mounted so `destroy` only releases the shared\n  // standalone styles for instances that actually retained them.\n  let hasMounted = false\n\n  if (optionalConfiguration) {\n    if (mountElement) {\n      const mount = () => {\n        app.mount(mountElement)\n        hasMounted = true\n        retainStandaloneStyles(document)\n      }\n\n      if (hasPluginUrls(props.configuration)) {\n        // Plugins referenced by URL must be resolved before the app mounts — plugin registration\n        // happens once at first render and is not reactive, so a plugin that arrives later would\n        // never be picked up.\n        loadPluginsFromUrls(props.configuration).then(() => {\n          // Skip mounting when the instance was destroyed while the plugins were loading.\n          if (!abortController.signal.aborted) {\n            mount()\n          }\n        })\n      } else {\n        mount()\n      }\n    } else {\n      console.error('Could not find a mount point for API References:', elementOrSelectorOrConfig)\n    }\n  }\n\n  // Tie the deprecated `document` listeners to an AbortController so `destroy`\n  // can remove them all at once. Without this, every `createApiReference()`\n  // call leaks three permanent listeners — visible during Astro view\n  // transitions where each navigation creates a new instance.\n  const abortController = new AbortController()\n  const listenerOptions: AddEventListenerOptions = {\n    capture: false,\n    signal: abortController.signal,\n  }\n\n  /**\n   * Reload the API Reference\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:reload-references',\n    () => {\n      console.warn(\n        'scalar:reload-references event has been deprecated, please use the scalarInstance.app.mount method instead.',\n      )\n      if (!props.configuration) {\n        return\n      }\n\n      // Snag the current element\n      const currentElement =\n        typeof elementOrSelectorOrConfig === 'string'\n          ? document.querySelector(elementOrSelectorOrConfig)\n          : (elementOrSelectorOrConfig as Element)\n\n      if (!currentElement) {\n        return\n      }\n\n      // Ensure we re-attach the element if it was unmounted\n      if (currentElement && !document.body.contains(currentElement)) {\n        document.body.appendChild(currentElement)\n      }\n\n      // Create a new Vue app instance\n      app.unmount()\n      app = createReferenceApp()\n      app.mount(currentElement)\n    },\n    listenerOptions,\n  )\n\n  /** Destroy the current API Reference instance */\n  const destroy = () => {\n    abortController.abort()\n    props.configuration = {}\n\n    // Only unmount an app that actually mounted. With `pluginUrls`, mounting is deferred until the\n    // plugin modules resolve, so `destroy` can run first — unmounting then would just warn.\n    if (hasMounted) {\n      hasMounted = false\n      app.unmount()\n      releaseStandaloneStyles(document)\n    }\n  }\n\n  /**\n   * Allow user to destroy the API Reference\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:destroy-references',\n    () => {\n      console.warn('scalar:destroy-references event has been deprecated, please use scalarInstance.destroy instead.')\n      destroy()\n    },\n    listenerOptions,\n  )\n\n  /**\n   * Allow user to update configuration\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:update-references-config',\n    (ev) => {\n      console.warn(\n        'scalar:update-references-config event has been deprecated, please use scalarInstance.updateConfiguration instead.',\n      )\n      if ('detail' in ev) {\n        Object.assign(props, ev.detail)\n      }\n    },\n    listenerOptions,\n  )\n\n  const instance = {\n    app,\n    getConfiguration: () => props.configuration ?? {},\n    updateConfiguration: (newConfig: AnyApiReferenceConfiguration) => {\n      props.configuration = newConfig\n    },\n    destroy,\n  }\n\n  return instance\n}\n"],"mappings":"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"}

package/dist/standalone/lib/load-plugins-from-urls.d.ts

@@ -0,0 +1,13 @@
+import type { AnyApiReferenceConfiguration } from '@scalar/types/api-reference';
+/** Whether any of the passed configurations reference a plugin by URL */
+export declare const hasPluginUrls: (configuration: AnyApiReferenceConfiguration) => boolean;
+/**
+ * Resolve the `pluginUrls` of all passed configurations and append the loaded plugins to the
+ * respective configuration's `plugins`.
+ *
+ * Plugin registration is not reactive — plugins are read once when the API reference renders for
+ * the first time — so this must complete before the app is mounted. Each URL is imported only
+ * once, even when multiple configurations reference it.
+ */
+export declare const loadPluginsFromUrls: (configuration: AnyApiReferenceConfiguration) => Promise<void>;
+//# sourceMappingURL=load-plugins-from-urls.d.ts.map

package/dist/standalone/lib/load-plugins-from-urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-plugins-from-urls.d.ts","sourceRoot":"","sources":["../../../src/standalone/lib/load-plugins-from-urls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAsB,MAAM,6BAA6B,CAAA;AAwCnG,yEAAyE;AACzE,eAAO,MAAM,aAAa,GAAI,eAAe,4BAA4B,KAAG,OACW,CAAA;AAEvF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAU,eAAe,4BAA4B,KAAG,OAAO,CAAC,IAAI,CAuBnG,CAAA"}

package/dist/standalone/lib/load-plugins-from-urls.js

@@ -0,0 +1,60 @@
+//#region src/standalone/lib/load-plugins-from-urls.ts
+/**
+* Import a plugin module with a browser-native dynamic `import()`.
+*
+* The specifier is fully dynamic, so bundlers can't analyze it and leave the `import()` call
+* as-is in the output (including the UMD standalone bundle) — the `@vite-ignore` comment just
+* silences the warning about that.
+*/
+var importModule = (url) => import(
+	/* @vite-ignore */
+	url
+);
+/**
+* Load a single plugin module and return its default export.
+*
+* Failures (network errors, modules without a function default export) are logged and swallowed
+* so a broken plugin URL never prevents the API reference itself from mounting.
+*/
+var loadPluginFromUrl = async (url) => {
+	try {
+		const plugin = (await importModule(url))?.default;
+		if (typeof plugin !== "function") {
+			console.error(`[@scalar/api-reference] The module at ${url} does not export an API Reference plugin as its default export.`);
+			return;
+		}
+		return plugin;
+	} catch (error) {
+		console.error(`[@scalar/api-reference] Failed to load the plugin module at ${url}:`, error);
+		return;
+	}
+};
+/** Normalize the configuration input to a list of configuration objects */
+var getConfigurations = (configuration) => Array.isArray(configuration) ? configuration : [configuration];
+/** Whether any of the passed configurations reference a plugin by URL */
+var hasPluginUrls = (configuration) => getConfigurations(configuration).some((config) => Boolean(config.pluginUrls?.length));
+/**
+* Resolve the `pluginUrls` of all passed configurations and append the loaded plugins to the
+* respective configuration's `plugins`.
+*
+* Plugin registration is not reactive — plugins are read once when the API reference renders for
+* the first time — so this must complete before the app is mounted. Each URL is imported only
+* once, even when multiple configurations reference it.
+*/
+var loadPluginsFromUrls = async (configuration) => {
+	const pendingImports = /* @__PURE__ */ new Map();
+	const importOnce = (url) => {
+		const pending = pendingImports.get(url) ?? loadPluginFromUrl(url);
+		pendingImports.set(url, pending);
+		return pending;
+	};
+	await Promise.all(getConfigurations(configuration).map(async (config) => {
+		if (!config.pluginUrls?.length) return;
+		const plugins = (await Promise.all(config.pluginUrls.map(importOnce))).filter((plugin) => plugin !== void 0);
+		if (plugins.length) config.plugins = [...config.plugins ?? [], ...plugins];
+	}));
+};
+//#endregion
+export { hasPluginUrls, loadPluginsFromUrls };
+
+//# sourceMappingURL=load-plugins-from-urls.js.map