@scalar/api-reference 1.64.0 → 1.65.0

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.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'\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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"}
+{"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.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-plugins-from-urls.js","names":[],"sources":["../../../src/standalone/lib/load-plugins-from-urls.ts"],"sourcesContent":["import type { AnyApiReferenceConfiguration, ApiReferencePlugin } from '@scalar/types/api-reference'\n\n/**\n * Import a plugin module with a browser-native dynamic `import()`.\n *\n * The specifier is fully dynamic, so bundlers can't analyze it and leave the `import()` call\n * as-is in the output (including the UMD standalone bundle) — the `@vite-ignore` comment just\n * silences the warning about that.\n */\nconst importModule = (url: string): Promise<Record<string, unknown>> => import(/* @vite-ignore */ url)\n\n/**\n * Load a single plugin module and return its default export.\n *\n * Failures (network errors, modules without a function default export) are logged and swallowed\n * so a broken plugin URL never prevents the API reference itself from mounting.\n */\nconst loadPluginFromUrl = async (url: string): Promise<ApiReferencePlugin | undefined> => {\n  try {\n    const pluginModule = await importModule(url)\n    const plugin = pluginModule?.default\n\n    if (typeof plugin !== 'function') {\n      console.error(\n        `[@scalar/api-reference] The module at ${url} does not export an API Reference plugin as its default export.`,\n      )\n      return undefined\n    }\n\n    return plugin as ApiReferencePlugin\n  } catch (error) {\n    console.error(`[@scalar/api-reference] Failed to load the plugin module at ${url}:`, error)\n    return undefined\n  }\n}\n\n/** Normalize the configuration input to a list of configuration objects */\nconst getConfigurations = (configuration: AnyApiReferenceConfiguration) =>\n  Array.isArray(configuration) ? configuration : [configuration]\n\n/** Whether any of the passed configurations reference a plugin by URL */\nexport const hasPluginUrls = (configuration: AnyApiReferenceConfiguration): boolean =>\n  getConfigurations(configuration).some((config) => Boolean(config.pluginUrls?.length))\n\n/**\n * Resolve the `pluginUrls` of all passed configurations and append the loaded plugins to the\n * respective configuration's `plugins`.\n *\n * Plugin registration is not reactive — plugins are read once when the API reference renders for\n * the first time — so this must complete before the app is mounted. Each URL is imported only\n * once, even when multiple configurations reference it.\n */\nexport const loadPluginsFromUrls = async (configuration: AnyApiReferenceConfiguration): Promise<void> => {\n  const pendingImports = new Map<string, Promise<ApiReferencePlugin | undefined>>()\n\n  const importOnce = (url: string) => {\n    const pending = pendingImports.get(url) ?? loadPluginFromUrl(url)\n    pendingImports.set(url, pending)\n    return pending\n  }\n\n  await Promise.all(\n    getConfigurations(configuration).map(async (config) => {\n      if (!config.pluginUrls?.length) {\n        return\n      }\n\n      const loadedPlugins = await Promise.all(config.pluginUrls.map(importOnce))\n      const plugins = loadedPlugins.filter((plugin): plugin is ApiReferencePlugin => plugin !== undefined)\n\n      if (plugins.length) {\n        config.plugins = [...(config.plugins ?? []), ...plugins]\n      }\n    }),\n  )\n}\n"],"mappings":";;;;;;;;AASA,IAAM,gBAAgB,QAAkD;;CAA0B;;;;;;;;AAQlG,IAAM,oBAAoB,OAAO,QAAyD;AACxF,KAAI;EAEF,MAAM,UADe,MAAM,aAAa,IAAI,GACf;AAE7B,MAAI,OAAO,WAAW,YAAY;AAChC,WAAQ,MACN,yCAAyC,IAAI,iEAC9C;AACD;;AAGF,SAAO;UACA,OAAO;AACd,UAAQ,MAAM,+DAA+D,IAAI,IAAI,MAAM;AAC3F;;;;AAKJ,IAAM,qBAAqB,kBACzB,MAAM,QAAQ,cAAc,GAAG,gBAAgB,CAAC,cAAc;;AAGhE,IAAa,iBAAiB,kBAC5B,kBAAkB,cAAc,CAAC,MAAM,WAAW,QAAQ,OAAO,YAAY,OAAO,CAAC;;;;;;;;;AAUvF,IAAa,sBAAsB,OAAO,kBAA+D;CACvG,MAAM,iCAAiB,IAAI,KAAsD;CAEjF,MAAM,cAAc,QAAgB;EAClC,MAAM,UAAU,eAAe,IAAI,IAAI,IAAI,kBAAkB,IAAI;AACjE,iBAAe,IAAI,KAAK,QAAQ;AAChC,SAAO;;AAGT,OAAM,QAAQ,IACZ,kBAAkB,cAAc,CAAC,IAAI,OAAO,WAAW;AACrD,MAAI,CAAC,OAAO,YAAY,OACtB;EAIF,MAAM,WADgB,MAAM,QAAQ,IAAI,OAAO,WAAW,IAAI,WAAW,CAAC,EAC5C,QAAQ,WAAyC,WAAW,KAAA,EAAU;AAEpG,MAAI,QAAQ,OACV,QAAO,UAAU,CAAC,GAAI,OAAO,WAAW,EAAE,EAAG,GAAG,QAAQ;GAE1D,CACH"}
+{"version":3,"file":"load-plugins-from-urls.js","names":[],"sources":["../../../src/standalone/lib/load-plugins-from-urls.ts"],"sourcesContent":["import type { AnyApiReferenceConfiguration, ApiReferencePlugin } from '@scalar/types/api-reference'\n\n/**\n * Import a plugin module with a browser-native dynamic `import()`.\n *\n * The specifier is fully dynamic, so bundlers can't analyze it and leave the `import()` call\n * as-is in the output (including the UMD standalone bundle) — the `@vite-ignore` comment just\n * silences the warning about that.\n */\nconst importModule = (url: string): Promise<Record<string, unknown>> => import(/* @vite-ignore */ url)\n\n/**\n * Load a single plugin module and return its default export.\n *\n * Failures (network errors, modules without a function default export) are logged and swallowed\n * so a broken plugin URL never prevents the API reference itself from mounting.\n */\nconst loadPluginFromUrl = async (url: string): Promise<ApiReferencePlugin | undefined> => {\n  try {\n    const pluginModule = await importModule(url)\n    const plugin = pluginModule?.default\n\n    if (typeof plugin !== 'function') {\n      console.error(\n        `[@scalar/api-reference] The module at ${url} does not export an API Reference plugin as its default export.`,\n      )\n      return undefined\n    }\n\n    return plugin as ApiReferencePlugin\n  } catch (error) {\n    console.error(`[@scalar/api-reference] Failed to load the plugin module at ${url}:`, error)\n    return undefined\n  }\n}\n\n/** Normalize the configuration input to a list of configuration objects */\nconst getConfigurations = (configuration: AnyApiReferenceConfiguration) =>\n  Array.isArray(configuration) ? configuration : [configuration]\n\n/** Whether any of the passed configurations reference a plugin by URL */\nexport const hasPluginUrls = (configuration: AnyApiReferenceConfiguration): boolean =>\n  getConfigurations(configuration).some((config) => Boolean(config.pluginUrls?.length))\n\n/**\n * Resolve the `pluginUrls` of all passed configurations and append the loaded plugins to the\n * respective configuration's `plugins`.\n *\n * Plugin registration is not reactive — plugins are read once when the API reference renders for\n * the first time — so this must complete before the app is mounted. Each URL is imported only\n * once, even when multiple configurations reference it.\n */\nexport const loadPluginsFromUrls = async (configuration: AnyApiReferenceConfiguration): Promise<void> => {\n  const pendingImports = new Map<string, Promise<ApiReferencePlugin | undefined>>()\n\n  const importOnce = (url: string) => {\n    const pending = pendingImports.get(url) ?? loadPluginFromUrl(url)\n    pendingImports.set(url, pending)\n    return pending\n  }\n\n  await Promise.all(\n    getConfigurations(configuration).map(async (config) => {\n      if (!config.pluginUrls?.length) {\n        return\n      }\n\n      const loadedPlugins = await Promise.all(config.pluginUrls.map(importOnce))\n      const plugins = loadedPlugins.filter((plugin): plugin is ApiReferencePlugin => plugin !== undefined)\n\n      if (plugins.length) {\n        config.plugins = [...(config.plugins ?? []), ...plugins]\n      }\n    }),\n  )\n}\n"],"mappings":";;;;;;;;AASA,IAAM,gBAAgB,QAAkD;;CAA0B;;;;;;;;AAQlG,IAAM,oBAAoB,OAAO,QAAyD;CACxF,IAAI;EAEF,MAAM,UAAS,MADY,aAAa,GAAG,EAAA,EACd;EAE7B,IAAI,OAAO,WAAW,YAAY;GAChC,QAAQ,MACN,yCAAyC,IAAI,gEAC/C;GACA;EACF;EAEA,OAAO;CACT,SAAS,OAAO;EACd,QAAQ,MAAM,+DAA+D,IAAI,IAAI,KAAK;EAC1F;CACF;AACF;;AAGA,IAAM,qBAAqB,kBACzB,MAAM,QAAQ,aAAa,IAAI,gBAAgB,CAAC,aAAa;;AAG/D,IAAa,iBAAiB,kBAC5B,kBAAkB,aAAa,CAAC,CAAC,MAAM,WAAW,QAAQ,OAAO,YAAY,MAAM,CAAC;;;;;;;;;AAUtF,IAAa,sBAAsB,OAAO,kBAA+D;CACvG,MAAM,iCAAiB,IAAI,IAAqD;CAEhF,MAAM,cAAc,QAAgB;EAClC,MAAM,UAAU,eAAe,IAAI,GAAG,KAAK,kBAAkB,GAAG;EAChE,eAAe,IAAI,KAAK,OAAO;EAC/B,OAAO;CACT;CAEA,MAAM,QAAQ,IACZ,kBAAkB,aAAa,CAAC,CAAC,IAAI,OAAO,WAAW;EACrD,IAAI,CAAC,OAAO,YAAY,QACtB;EAIF,MAAM,WAAU,MADY,QAAQ,IAAI,OAAO,WAAW,IAAI,UAAU,CAAC,EAAA,CAC3C,QAAQ,WAAyC,WAAW,KAAA,CAAS;EAEnG,IAAI,QAAQ,QACV,OAAO,UAAU,CAAC,GAAI,OAAO,WAAW,CAAC,GAAI,GAAG,OAAO;CAE3D,CAAC,CACH;AACF"}