@scalar/api-reference 1.49.3 → 1.49.5

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import type { AnyApiReferenceConfiguration } from '@scalar/types/api-reference';
 export type { ApiReferenceConfiguration } from '@scalar/types/api-reference';
-export { default as ApiReference } from './components/ApiReference.vue';
-export { default as GettingStarted } from './components/GettingStarted.vue';
+export { default as ApiReference } from './components/ApiReference.vue.js';
+export { default as GettingStarted } from './components/GettingStarted.vue.js';
 export { SearchButton, SearchModal } from './features/Search';
-export { createEmptySpecification } from './helpers/openapi';
-export { createApiReference } from './standalone/lib/html-api';
+export { createEmptySpecification } from './helpers/openapi.js';
+export { createApiReference } from './standalone/lib/html-api.js';
 export type ReferenceProps = {
     configuration?: AnyApiReferenceConfiguration;
 };

package/dist/index.js

@@ -1,7 +1,7 @@
-import { n as GettingStarted_default, r as ApiReference_default, t as createApiReference } from "./src-DJwsRvMU.js";
-import "./ExternalDocs-phu7GxpZ.js";
-import "./MobileHeader-DAm6yQX0.js";
-import "./ServerSelector-5y29y2BJ.js";
-import "./Operation-CvpVIkc3.js";
-import { n as SearchModal_default, r as createEmptySpecification, t as SearchButton_default } from "./SearchButton-xzhIpMCZ.js";
+import { createEmptySpecification } from "./helpers/openapi.js";
+import SearchModal_default from "./features/Search/components/SearchModal.vue.js";
+import SearchButton_default from "./features/Search/components/SearchButton.vue.js";
+import ApiReference_default from "./components/ApiReference.vue.js";
+import GettingStarted_default from "./components/GettingStarted.vue.js";
+import { createApiReference } from "./standalone/lib/html-api.js";
 export { ApiReference_default as ApiReference, GettingStarted_default as GettingStarted, SearchButton_default as SearchButton, SearchModal_default as SearchModal, createApiReference, createEmptySpecification };

package/dist/plugins/hooks/usePluginManager.d.ts

@@ -1,4 +1,4 @@
-import { type PluginManager } from '../../plugins/plugin-manager';
+import { type PluginManager } from '../../plugins/plugin-manager.js';
 import { type InjectionKey } from 'vue';
 export declare const PLUGIN_MANAGER_SYMBOL: InjectionKey<PluginManager>;
 /**

package/dist/plugins/hooks/usePluginManager.js

@@ -0,0 +1,16 @@
+import { createPluginManager } from "../plugin-manager.js";
+import { inject } from "vue";
+//#region src/plugins/hooks/usePluginManager.ts
+var PLUGIN_MANAGER_SYMBOL = Symbol();
+/**
+* Hook to access the plugin manager
+*/
+var usePluginManager = () => {
+	const manager = inject(PLUGIN_MANAGER_SYMBOL);
+	if (!manager) return createPluginManager({});
+	return manager;
+};
+//#endregion
+export { PLUGIN_MANAGER_SYMBOL, usePluginManager };
+
+//# sourceMappingURL=usePluginManager.js.map

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

@@ -0,0 +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"}

package/dist/plugins/index.d.ts

@@ -1,4 +1,4 @@
-export { PLUGIN_MANAGER_SYMBOL, usePluginManager } from '../plugins/hooks/usePluginManager';
-export { type ApiReferencePlugin, type PluginManager, createPluginManager, } from '../plugins/plugin-manager';
-export { persistencePlugin } from './persistance-plugin';
+export { PLUGIN_MANAGER_SYMBOL, usePluginManager } from '../plugins/hooks/usePluginManager.js';
+export { type ApiReferencePlugin, type PluginManager, createPluginManager, } from '../plugins/plugin-manager.js';
+export { persistencePlugin } from './persistance-plugin.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.js

@@ -1,2 +1,4 @@
-import { i as createPluginManager, n as PLUGIN_MANAGER_SYMBOL, r as usePluginManager, t as persistencePlugin } from "../plugins-4EyiUD_A.js";
+import { createPluginManager } from "./plugin-manager.js";
+import { PLUGIN_MANAGER_SYMBOL, usePluginManager } from "./hooks/usePluginManager.js";
+import { persistencePlugin } from "./persistance-plugin.js";
 export { PLUGIN_MANAGER_SYMBOL, createPluginManager, persistencePlugin, usePluginManager };

package/dist/plugins/persistance-plugin.js

@@ -0,0 +1,39 @@
+import { authStorage, clientStorage } from "../helpers/storage.js";
+import { debounce } from "@scalar/helpers/general/debounce";
+//#region src/plugins/persistance-plugin.ts
+/**
+* Plugin to persist workspace state changes with debounced writes.
+*/
+var persistencePlugin = ({ debounceDelay = 500, maxWait = 1e4, prefix = "", persistAuth = false }) => {
+	const { execute } = debounce({
+		delay: debounceDelay,
+		maxWait
+	});
+	const authPersistence = authStorage();
+	const clientPersistence = clientStorage();
+	/**
+	* Resolves the prefix to use for local storage keys.
+	* If 'prefix' is a string, returns it directly.
+	* If 'prefix' is a function, calls and returns its value.
+	*/
+	const getPrefix = () => {
+		if (typeof prefix === "string") return prefix;
+		return prefix();
+	};
+	const getPersistAuth = () => {
+		if (typeof persistAuth === "function") return persistAuth();
+		return persistAuth;
+	};
+	return { hooks: { 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));
+			return;
+		}
+		if (getPersistAuth() && event.type === "auth") execute("auth", () => authPersistence.setAuth(getPrefix(), event.value));
+	} } };
+};
+//#endregion
+export { persistencePlugin };
+
+//# sourceMappingURL=persistance-plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistance-plugin.js","names":[],"sources":["../../src/plugins/persistance-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  prefix = '',\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   * Prefix to use for local storage keys.\n   * This can be a string or a function returning a string.\n   * For example, to persist data per document, use the document name as the prefix.\n   */\n  prefix?: string | (() => string)\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  /**\n   * Resolves the prefix to use for local storage keys.\n   * If 'prefix' is a string, returns it directly.\n   * If 'prefix' is a function, calls and returns its value.\n   */\n  const getPrefix = () => {\n    if (typeof prefix === 'string') {\n      return prefix\n    }\n\n    return prefix()\n  }\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        if (getPersistAuth() && event.type === 'auth') {\n          execute('auth', () => authPersistence.setAuth(getPrefix(), 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,SAAS,IACT,cAAc,YAiBO;CAErB,MAAM,EAAE,YAAY,SAAS;EAAE,OAAO;EAAe;EAAS,CAAC;CAC/D,MAAM,kBAAkB,aAAa;CACrC,MAAM,oBAAoB,eAAe;;;;;;CAOzC,MAAM,kBAAkB;AACtB,MAAI,OAAO,WAAW,SACpB,QAAO;AAGT,SAAO,QAAQ;;CAGjB,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;;AAIF,MAAI,gBAAgB,IAAI,MAAM,SAAS,OACrC,SAAQ,cAAc,gBAAgB,QAAQ,WAAW,EAAE,MAAM,MAAM,CAAC;IAM7E,EACF"}

package/dist/plugins/plugin-manager.js

@@ -0,0 +1,32 @@
+//#region src/plugins/plugin-manager.ts
+/**
+* Create the plugin manager store
+*
+* This store manages all plugins registered with the API client
+*/
+var createPluginManager = ({ plugins = [] }) => {
+	const registeredPlugins = /* @__PURE__ */ new Map();
+	plugins.forEach((plugin) => {
+		const pluginInstance = plugin();
+		registeredPlugins.set(pluginInstance.name, pluginInstance);
+	});
+	return {
+		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;
+		},
+		getViewComponents: (viewName) => {
+			const components = [];
+			for (const plugin of registeredPlugins.values()) {
+				const viewComponents = plugin.views?.[viewName];
+				if (viewComponents) components.push(...viewComponents);
+			}
+			return components;
+		}
+	};
+};
+//#endregion
+export { createPluginManager };
+
+//# sourceMappingURL=plugin-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.js","names":[],"sources":["../../src/plugins/plugin-manager.ts"],"sourcesContent":["import type {\n  ApiReferencePlugin as OriginalApiReferencePlugin,\n  SpecificationExtension,\n  ViewComponent,\n} from '@scalar/types/api-reference'\n\nexport type ApiReferencePlugin = OriginalApiReferencePlugin\n\ntype CreatePluginManagerParams = {\n  plugins?: ApiReferencePlugin[]\n}\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 = [] }: CreatePluginManagerParams) => {\n  const registeredPlugins = new Map<string, ReturnType<ApiReferencePlugin>>()\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    getViewComponents: (viewName: 'content.end'): ViewComponent[] => {\n      const components: ViewComponent[] = []\n\n      for (const plugin of registeredPlugins.values()) {\n        const viewComponents = plugin.views?.[viewName]\n        if (viewComponents) {\n          components.push(...viewComponents)\n        }\n      }\n\n      return components\n    },\n  }\n}\n\nexport type PluginManager = ReturnType<typeof createPluginManager>\n"],"mappings":";;;;;;AAiBA,IAAa,uBAAuB,EAAE,UAAU,EAAE,OAAkC;CAClF,MAAM,oCAAoB,IAAI,KAA6C;AAG3E,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;;EAMT,oBAAoB,aAA6C;GAC/D,MAAM,aAA8B,EAAE;AAEtC,QAAK,MAAM,UAAU,kBAAkB,QAAQ,EAAE;IAC/C,MAAM,iBAAiB,OAAO,QAAQ;AACtC,QAAI,eACF,YAAW,KAAK,GAAG,eAAe;;AAItC,UAAO;;EAEV"}

package/dist/ssr.js

@@ -1,7 +1,7 @@
-import { n as GettingStarted_default, r as ApiReference_default, t as createApiReference } from "./src-DJwsRvMU.js";
-import "./ExternalDocs-phu7GxpZ.js";
-import "./MobileHeader-DAm6yQX0.js";
-import "./ServerSelector-5y29y2BJ.js";
-import "./Operation-CvpVIkc3.js";
-import { n as SearchModal_default, r as createEmptySpecification, t as SearchButton_default } from "./SearchButton-xzhIpMCZ.js";
+import { createEmptySpecification } from "./helpers/openapi.js";
+import SearchModal_default from "./features/Search/components/SearchModal.vue.js";
+import SearchButton_default from "./features/Search/components/SearchButton.vue.js";
+import ApiReference_default from "./components/ApiReference.vue.js";
+import GettingStarted_default from "./components/GettingStarted.vue.js";
+import { createApiReference } from "./standalone/lib/html-api.js";
 export { ApiReference_default as ApiReference, GettingStarted_default as GettingStarted, SearchButton_default as SearchButton, SearchModal_default as SearchModal, createApiReference, createEmptySpecification };

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

@@ -0,0 +1,73 @@
+import ApiReference_default from "../../components/ApiReference.vue.js";
+import { createApp, h, reactive } from "vue";
+import "@scalar/types/api-reference";
+import { createHead } from "@unhead/vue/client";
+//#region src/standalone/lib/html-api.ts
+/**
+* Create (and mount) a new Scalar API Reference
+*
+* @example createApiReference({ url: '/scalar.json' }).mount('#app')
+* @example createApiReference('#app', { url: '/scalar.json' })
+* @example createApiReference(document.getElementById('app'), { url: '/scalar.json' })
+*/
+var createApiReference = (elementOrSelectorOrConfig, optionalConfiguration) => {
+	const idPrefix = "scalar-refs";
+	const props = reactive({ configuration: optionalConfiguration ?? elementOrSelectorOrConfig ?? {} });
+	let app = createApp(() => h(ApiReference_default, props));
+	app.use(createHead());
+	app.config.idPrefix = idPrefix;
+	if (optionalConfiguration) {
+		const element = typeof elementOrSelectorOrConfig === "string" ? document.querySelector(elementOrSelectorOrConfig) : elementOrSelectorOrConfig;
+		if (element) app.mount(element);
+		else console.error("Could not find a mount point for API References:", elementOrSelectorOrConfig);
+	}
+	/**
+	* Reload the API Reference
+	* @deprecated
+	*/
+	document.addEventListener("scalar:reload-references", () => {
+		console.warn("scalar:reload-references event has been deprecated, please use the scalarInstance.app.mount method instead.");
+		if (!props.configuration) return;
+		const currentElement = typeof elementOrSelectorOrConfig === "string" ? document.querySelector(elementOrSelectorOrConfig) : elementOrSelectorOrConfig;
+		if (!currentElement) return;
+		if (currentElement && !document.body.contains(currentElement)) document.body.appendChild(currentElement);
+		app.unmount();
+		app = createApp(() => h(ApiReference_default, props));
+		app.use(createHead());
+		app.config.idPrefix = idPrefix;
+		app.mount(currentElement);
+	}, false);
+	/** Destroy the current API Reference instance */
+	const destroy = () => {
+		props.configuration = {};
+		app.unmount();
+	};
+	/**
+	* Allow user to destroy the API Reference
+	* @deprecated
+	*/
+	document.addEventListener("scalar:destroy-references", () => {
+		console.warn("scalar:destroy-references event has been deprecated, please use scalarInstance.destroy instead.");
+		destroy();
+	}, false);
+	/**
+	* Allow user to update configuration
+	* @deprecated
+	*/
+	document.addEventListener("scalar:update-references-config", (ev) => {
+		console.warn("scalar:update-references-config event has been deprecated, please use scalarInstance.updateConfiguration instead.");
+		if ("detail" in ev) Object.assign(props, ev.detail);
+	}, false);
+	return {
+		app,
+		getConfiguration: () => props.configuration ?? {},
+		updateConfiguration: (newConfig) => {
+			props.configuration = newConfig;
+		},
+		destroy
+	};
+};
+//#endregion
+export { createApiReference };
+
+//# sourceMappingURL=html-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"html-api.js","names":[],"sources":["../../../src/standalone/lib/html-api.ts"],"sourcesContent":["import type {\n  AnyApiReferenceConfiguration,\n  ApiReferenceConfigurationWithSource,\n  CreateApiReference,\n} from '@scalar/types/api-reference'\nimport { apiReferenceConfigurationWithSourceSchema } from '@scalar/types/api-reference'\nimport { createHead } from '@unhead/vue/client'\nimport { createApp, 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 * 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.parse({ _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.parse({\n      _integration: 'html',\n      proxyUrl: getProxyUrl(),\n      ...getConfiguration(),\n      ...urlOrContent,\n    })\n  }\n\n  return apiReferenceConfigurationWithSourceSchema.parse({ _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  // Create a new Vue app instance\n  let app = createApp(() => h(ApiReference, props))\n\n  // Meta tags, etc.\n  app.use(createHead())\n\n  app.config.idPrefix = idPrefix\n\n  // If we have an optional config, then we must mount the element immediately (not sure why type is not narrowing)\n  if (optionalConfiguration) {\n    // If the element is a string, we need to find the actual DOM element\n    const element =\n      typeof elementOrSelectorOrConfig === 'string'\n        ? document.querySelector(elementOrSelectorOrConfig)\n        : (elementOrSelectorOrConfig as Element)\n\n    if (element) {\n      app.mount(element)\n    } else {\n      console.error('Could not find a mount point for API References:', elementOrSelectorOrConfig)\n    }\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 = createApp(() => h(ApiReference, props))\n      app.use(createHead())\n      app.config.idPrefix = idPrefix\n      app.mount(currentElement)\n    },\n    false,\n  )\n\n  /** Destroy the current API Reference instance */\n  const destroy = () => {\n    props.configuration = {}\n    app.unmount()\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    false,\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    false,\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":";;;;;;;;;;;;AAgLA,IAAa,sBACX,2BACA,0BACG;CAEH,MAAM,WAAW;CAEjB,MAAM,QAAQ,SAA0D,EAEtE,eAAe,yBAA0B,6BAA8D,EAAE,EAC1G,CAAC;CAGF,IAAI,MAAM,gBAAgB,EAAE,sBAAc,MAAM,CAAC;AAGjD,KAAI,IAAI,YAAY,CAAC;AAErB,KAAI,OAAO,WAAW;AAGtB,KAAI,uBAAuB;EAEzB,MAAM,UACJ,OAAO,8BAA8B,WACjC,SAAS,cAAc,0BAA0B,GAChD;AAEP,MAAI,QACF,KAAI,MAAM,QAAQ;MAElB,SAAQ,MAAM,oDAAoD,0BAA0B;;;;;;AAQhG,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,gBAAgB,EAAE,sBAAc,MAAM,CAAC;AAC7C,MAAI,IAAI,YAAY,CAAC;AACrB,MAAI,OAAO,WAAW;AACtB,MAAI,MAAM,eAAe;IAE3B,MACD;;CAGD,MAAM,gBAAgB;AACpB,QAAM,gBAAgB,EAAE;AACxB,MAAI,SAAS;;;;;;AAOf,UAAS,iBACP,mCACM;AACJ,UAAQ,KAAK,kGAAkG;AAC/G,WAAS;IAEX,MACD;;;;;AAMD,UAAS,iBACP,oCACC,OAAO;AACN,UAAQ,KACN,oHACD;AACD,MAAI,YAAY,GACd,QAAO,OAAO,OAAO,GAAG,OAAO;IAGnC,MACD;AAWD,QATiB;EACf;EACA,wBAAwB,MAAM,iBAAiB,EAAE;EACjD,sBAAsB,cAA4C;AAChE,SAAM,gBAAgB;;EAExB;EACD"}