@scalar/api-client 2.38.4 → 2.39.1

package/dist/v2/features/app/components/SplashScreen.vue.script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SplashScreen.vue.script.js","names":[],"sources":["../../../../../src/v2/features/app/components/SplashScreen.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { ScalarIcon } from '@scalar/components'\n</script>\n\n<template>\n  <div\n    class=\"splash-screen bg-b-1 fixed inset-0 z-50 flex items-center justify-center\">\n    <div class=\"flex flex-col items-center gap-4\">\n      <ScalarIcon\n        class=\"logo-icon text-c-1 h-16 w-16\"\n        icon=\"Logo\" />\n    </div>\n  </div>\n</template>\n\n<style scoped>\n.splash-screen {\n  opacity: 0;\n  animation: fadeIn 0.5s ease-in-out forwards;\n}\n\n.logo-icon {\n  opacity: 0;\n  animation:\n    fadeInLogo 0.6s ease-in-out 0.2s forwards,\n    pulse 2s ease-in-out 0.8s infinite;\n}\n\n@keyframes fadeIn {\n  from {\n    opacity: 0;\n  }\n  to {\n    opacity: 0.9;\n  }\n}\n\n@keyframes fadeInLogo {\n  from {\n    opacity: 0;\n    transform: scale(0.9);\n  }\n  to {\n    opacity: 0.8;\n    transform: scale(1);\n  }\n}\n\n@keyframes pulse {\n  0%,\n  100% {\n    opacity: 0.8;\n  }\n  50% {\n    opacity: 0.6;\n  }\n}\n</style>\n"],"mappings":";;;;;;;;;uBAKE,mBAOM,OAPN,YAOM,CALJ,mBAIM,OAJN,YAIM,CAHJ,YAEgB,MAAA,WAAA,EAAA;IADd,OAAM;IACN,MAAK"}

package/dist/v2/features/app/components/index.d.ts

@@ -1,2 +1,2 @@
-export { default as App } from '../App.vue';
+export { default as App } from '../App.vue.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/v2/features/app/components/index.js

@@ -1,10 +1,2 @@
-import "../../../../CodeInput-BTN8cC5h.js";
-import "../../../../DataTableInput-RydMDjn2.js";
-import "../../../../code-input-iq-moLxi.js";
-import "../../../../data-table-PL7e8NRO.js";
-import "../../../../scalar-auth-selector-block-Bs79QOMA.js";
-import "../../../../ScalarAsciiArt-BjuSnj8e.js";
-import "../../../../resize-D2IYvVdh.js";
-import { t as App_default } from "../../../../App-Ckirvnv1.js";
-import "../../../../TheCommandPalette-Dl9TAeke.js";
+import App_default from "../App.vue.js";
 export { App_default as App };

package/dist/v2/features/app/helpers/create-api-client-app.d.ts

@@ -28,6 +28,10 @@ type CreateApiClientOptions = {
      * over x-scalar-original-source-url when syncing. Returns the document as a plain object.
      */
     fetchRegistryDocument?: ImportDocumentFromRegistry;
+    /**
+     * Whether or not to send telemetry events.
+     */
+    telemetry?: boolean;
 };
 /**
  * Creates the appropriate router with the appropriate routes based on the layout
@@ -36,9 +40,9 @@ export declare const createAppRouter: (layout: CreateApiClientOptions["layout"])
 /**
  * Create the API Client with router and passes in the workspace store as a prop
  */
-export declare const createApiClientApp: (el: HTMLElement | null, { layout, plugins, customThemes, fallbackThemeSlug, fetchRegistryDocument }: CreateApiClientOptions) => Promise<{
+export declare const createApiClientApp: (el: HTMLElement | null, { layout, plugins, customThemes, fallbackThemeSlug, fetchRegistryDocument, telemetry, }: CreateApiClientOptions) => Promise<{
     app: import("vue").App<Element>;
-    state: import("../../../../v2/features/app/app-state").AppState;
+    state: import("../../../../v2/features/app/app-state.js").AppState;
 } | undefined>;
 export {};
 //# sourceMappingURL=create-api-client-app.d.ts.map

package/dist/v2/features/app/helpers/create-api-client-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-api-client-app.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/create-api-client-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAO3C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAA;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,KAAK,sBAAsB,GAAG;IAC5B;;;;;OAKG;IACH,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,EAAE,CAAA;IACtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAA;IAChC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,0BAA0B,CAAA;CACnD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,sBAAsB,CAAC,QAAQ,CAAC,gCAQvE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,IAAI,WAAW,GAAG,IAAI,EACtB,6EAAyF,sBAAsB;;;cAqChH,CAAA"}
+{"version":3,"file":"create-api-client-app.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/create-api-client-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAO3C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAA;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,KAAK,sBAAsB,GAAG;IAC5B;;;;;OAKG;IACH,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,EAAE,CAAA;IACtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAA;IAChC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,0BAA0B,CAAA;IAClD;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,sBAAsB,CAAC,QAAQ,CAAC,gCAQvE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,IAAI,WAAW,GAAG,IAAI,EACtB,yFAOG,sBAAsB;;;cAsC1B,CAAA"}

package/dist/v2/features/app/helpers/create-api-client-app.js

@@ -0,0 +1,54 @@
+import { createAppState } from "../app-state.js";
+import { useCommandPaletteState } from "../../command-palette/hooks/use-command-palette-state.js";
+import App_default from "../App.vue.js";
+import { ROUTES } from "./routes.js";
+import { createApp } from "vue";
+import { createRouter, createWebHashHistory, createWebHistory } from "vue-router";
+//#region src/v2/features/app/helpers/create-api-client-app.ts
+/**
+* Creates the appropriate router with the appropriate routes based on the layout
+*/
+var createAppRouter = (layout) => {
+	if (layout === "web") return createRouter({
+		history: createWebHistory(),
+		routes: ROUTES
+	});
+	return createRouter({
+		history: createWebHashHistory(),
+		routes: ROUTES
+	});
+};
+/**
+* Create the API Client with router and passes in the workspace store as a prop
+*/
+var createApiClientApp = async (el, { layout = "desktop", plugins, customThemes, fallbackThemeSlug, fetchRegistryDocument, telemetry = true }) => {
+	const router = createAppRouter(layout);
+	const state = await createAppState({
+		router,
+		customThemes,
+		fallbackThemeSlug,
+		telemetryDefault: telemetry
+	});
+	const commandPaletteState = useCommandPaletteState();
+	const app = createApp(App_default, {
+		layout,
+		plugins,
+		getAppState: () => state,
+		getCommandPaletteState: () => commandPaletteState,
+		fetchRegistryDocument
+	});
+	app.use(router);
+	if (!el) {
+		console.error("[@scalar/api-client-modal] Could not create the API client.", "Invalid HTML element provided.", "Read more: https://github.com/scalar/scalar/tree/main/packages/api-client");
+		return;
+	}
+	app.mount(el);
+	return {
+		app,
+		state
+	};
+};
+//#endregion
+export { createApiClientApp, createAppRouter };
+
+//# sourceMappingURL=create-api-client-app.js.map

package/dist/v2/features/app/helpers/create-api-client-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-api-client-app.js","names":[],"sources":["../../../../../src/v2/features/app/helpers/create-api-client-app.ts"],"sourcesContent":["import type { ClientPlugin } from '@scalar/oas-utils/helpers'\nimport type { Theme } from '@scalar/themes'\nimport { createApp } from 'vue'\nimport { createRouter as createVueRouter, createWebHashHistory, createWebHistory } from 'vue-router'\n\nimport App from '@/v2/features/app/App.vue'\nimport { createAppState } from '@/v2/features/app/app-state'\nimport { ROUTES } from '@/v2/features/app/helpers/routes'\nimport type { ImportDocumentFromRegistry } from '@/v2/types/configuration'\nimport type { ClientLayout } from '@/v2/types/layout'\n\nimport { useCommandPaletteState } from '../../command-palette/hooks/use-command-palette-state'\n\ntype CreateApiClientOptions = {\n  /**\n   * The layout of the client, limited to web or desktop in app\n   * @see {@link ClientLayout}\n   *\n   * @default 'desktop'\n   */\n  layout: Exclude<ClientLayout, 'modal'>\n  /**\n   * Api client plugins to include in the app\n   */\n  plugins?: ClientPlugin[]\n  /**\n   * Custom themes to include in the app\n   */\n  customThemes?: Theme[]\n  /**\n   * Fallback theme slug to use if no theme is selected for the workspace\n   * @default 'default'\n   */\n  fallbackThemeSlug?: () => string\n  /**\n   * Fetches the full document from registry by meta. When set, registry meta takes priority\n   * over x-scalar-original-source-url when syncing. Returns the document as a plain object.\n   */\n  fetchRegistryDocument?: ImportDocumentFromRegistry\n  /**\n   * Whether or not to send telemetry events.\n   */\n  telemetry?: boolean\n}\n\n/**\n * Creates the appropriate router with the appropriate routes based on the layout\n */\nexport const createAppRouter = (layout: CreateApiClientOptions['layout']) => {\n  // Web uses the standard HTML5 history API\n  if (layout === 'web') {\n    return createVueRouter({ history: createWebHistory(), routes: ROUTES })\n  }\n\n  // Electron app has to use the webHashHistory due to file routing\n  return createVueRouter({ history: createWebHashHistory(), routes: ROUTES })\n}\n\n/**\n * Create the API Client with router and passes in the workspace store as a prop\n */\nexport const createApiClientApp = async (\n  el: HTMLElement | null,\n  {\n    layout = 'desktop',\n    plugins,\n    customThemes,\n    fallbackThemeSlug,\n    fetchRegistryDocument,\n    telemetry = true,\n  }: CreateApiClientOptions,\n) => {\n  // Add the router\n  const router = createAppRouter(layout)\n  const state = await createAppState({\n    router,\n    customThemes,\n    fallbackThemeSlug,\n    telemetryDefault: telemetry,\n  })\n  const commandPaletteState = useCommandPaletteState()\n\n  // Pass in our initial props at the top level\n  const app = createApp(App, {\n    layout,\n    plugins,\n    getAppState: () => state,\n    getCommandPaletteState: () => commandPaletteState,\n    fetchRegistryDocument,\n  })\n  app.use(router)\n\n  // Mount the vue app\n  if (!el) {\n    console.error(\n      '[@scalar/api-client-modal] Could not create the API client.',\n      'Invalid HTML element provided.',\n      'Read more: https://github.com/scalar/scalar/tree/main/packages/api-client',\n    )\n\n    return\n  }\n  app.mount(el)\n\n  return {\n    app,\n    state,\n  }\n}\n"],"mappings":";;;;;;;;;;AAgDA,IAAa,mBAAmB,WAA6C;AAE3E,KAAI,WAAW,MACb,QAAO,aAAgB;EAAE,SAAS,kBAAkB;EAAE,QAAQ;EAAQ,CAAC;AAIzE,QAAO,aAAgB;EAAE,SAAS,sBAAsB;EAAE,QAAQ;EAAQ,CAAC;;;;;AAM7E,IAAa,qBAAqB,OAChC,IACA,EACE,SAAS,WACT,SACA,cACA,mBACA,uBACA,YAAY,WAEX;CAEH,MAAM,SAAS,gBAAgB,OAAO;CACtC,MAAM,QAAQ,MAAM,eAAe;EACjC;EACA;EACA;EACA,kBAAkB;EACnB,CAAC;CACF,MAAM,sBAAsB,wBAAwB;CAGpD,MAAM,MAAM,UAAU,aAAK;EACzB;EACA;EACA,mBAAmB;EACnB,8BAA8B;EAC9B;EACD,CAAC;AACF,KAAI,IAAI,OAAO;AAGf,KAAI,CAAC,IAAI;AACP,UAAQ,MACN,+DACA,kCACA,4EACD;AAED;;AAEF,KAAI,MAAM,GAAG;AAEb,QAAO;EACL;EACA;EACD"}

package/dist/v2/features/app/helpers/filter-workspaces.js

@@ -0,0 +1,55 @@
+//#region src/v2/features/app/helpers/filter-workspaces.ts
+/**
+* Filters workspaces to show only those accessible to the current team.
+*
+* A workspace is accessible if:
+* - Its teamUid matches the current team, OR
+* - Its teamUid is 'local' (local workspaces are always accessible)
+*
+* @param workspaces - Array of workspaces to filter
+* @param currentTeamUid - The currently active team identifier
+* @returns Filtered array of workspaces accessible to the current team
+*
+* @example
+* ```ts
+* const workspaces = [
+*   { id: '1', teamUid: 'local', name: 'Local' },
+*   { id: '2', teamUid: 'team-a', name: 'Team A' },
+*   { id: '3', teamUid: 'team-b', name: 'Team B' },
+* ]
+*
+* filterWorkspacesByTeam(workspaces, 'team-a')
+* // => [{ id: '1', teamUid: 'local' }, { id: '2', teamUid: 'team-a' }]
+* ```
+*/
+var filterWorkspacesByTeam = (workspaces, currentTeamUid) => {
+	return workspaces.filter((workspace) => canLoadWorkspace(workspace.teamUid, currentTeamUid));
+};
+/**
+* Checks if a workspace can be loaded by the current team.
+*
+* A workspace can be loaded if:
+* - Its teamUid matches the current team, OR
+* - Its teamUid is 'local' (local workspaces are always accessible)
+*
+* This is used during route changes to prevent users from accessing
+* workspaces that do not belong to their active team.
+*
+* @param workspaceTeamUid - The team identifier of the workspace to check
+* @param currentTeamUid - The currently active team identifier
+* @returns true if the workspace can be loaded, false otherwise
+*
+* @example
+* ```ts
+* canLoadWorkspace('team-a', 'team-a') // => true
+* canLoadWorkspace('local', 'team-a')  // => true
+* canLoadWorkspace('team-b', 'team-a') // => false
+* ```
+*/
+var canLoadWorkspace = (workspaceTeamUid, currentTeamUid) => {
+	return workspaceTeamUid === currentTeamUid || workspaceTeamUid === "local";
+};
+//#endregion
+export { canLoadWorkspace, filterWorkspacesByTeam };
+
+//# sourceMappingURL=filter-workspaces.js.map

package/dist/v2/features/app/helpers/filter-workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-workspaces.js","names":[],"sources":["../../../../../src/v2/features/app/helpers/filter-workspaces.ts"],"sourcesContent":["/**\n * Filters workspaces to show only those accessible to the current team.\n *\n * A workspace is accessible if:\n * - Its teamUid matches the current team, OR\n * - Its teamUid is 'local' (local workspaces are always accessible)\n *\n * @param workspaces - Array of workspaces to filter\n * @param currentTeamUid - The currently active team identifier\n * @returns Filtered array of workspaces accessible to the current team\n *\n * @example\n * ```ts\n * const workspaces = [\n *   { id: '1', teamUid: 'local', name: 'Local' },\n *   { id: '2', teamUid: 'team-a', name: 'Team A' },\n *   { id: '3', teamUid: 'team-b', name: 'Team B' },\n * ]\n *\n * filterWorkspacesByTeam(workspaces, 'team-a')\n * // => [{ id: '1', teamUid: 'local' }, { id: '2', teamUid: 'team-a' }]\n * ```\n */\nexport const filterWorkspacesByTeam = <T extends { teamUid: string }>(workspaces: T[], currentTeamUid: string): T[] => {\n  return workspaces.filter((workspace) => canLoadWorkspace(workspace.teamUid, currentTeamUid))\n}\n\n/**\n * Checks if a workspace can be loaded by the current team.\n *\n * A workspace can be loaded if:\n * - Its teamUid matches the current team, OR\n * - Its teamUid is 'local' (local workspaces are always accessible)\n *\n * This is used during route changes to prevent users from accessing\n * workspaces that do not belong to their active team.\n *\n * @param workspaceTeamUid - The team identifier of the workspace to check\n * @param currentTeamUid - The currently active team identifier\n * @returns true if the workspace can be loaded, false otherwise\n *\n * @example\n * ```ts\n * canLoadWorkspace('team-a', 'team-a') // => true\n * canLoadWorkspace('local', 'team-a')  // => true\n * canLoadWorkspace('team-b', 'team-a') // => false\n * ```\n */\nexport const canLoadWorkspace = (workspaceTeamUid: string, currentTeamUid: string): boolean => {\n  return workspaceTeamUid === currentTeamUid || workspaceTeamUid === 'local'\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAa,0BAAyD,YAAiB,mBAAgC;AACrH,QAAO,WAAW,QAAQ,cAAc,iBAAiB,UAAU,SAAS,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;AAwB9F,IAAa,oBAAoB,kBAA0B,mBAAoC;AAC7F,QAAO,qBAAqB,kBAAkB,qBAAqB"}

package/dist/v2/features/app/helpers/get-route-param.d.ts

@@ -1,6 +1,6 @@
 import type { HttpMethod } from '@scalar/helpers/http/http-methods';
 import type { RouteLocationNormalizedGeneric } from 'vue-router';
-import type { ScalarClientAppRouteParams } from '../../../../v2/features/app/helpers/routes';
+import type { ScalarClientAppRouteParams } from '../../../../v2/features/app/helpers/routes.js';
 /** Extracts a string parameter from the route */
 export declare function getRouteParam(paramName: 'method', route: RouteLocationNormalizedGeneric | null): HttpMethod | undefined;
 export declare function getRouteParam(paramName: Exclude<ScalarClientAppRouteParams, 'method'>, route: RouteLocationNormalizedGeneric | null): string | undefined;

package/dist/v2/features/app/helpers/get-route-param.js

@@ -0,0 +1,12 @@
+import { isHttpMethod } from "@scalar/helpers/http/is-http-method";
+//#region src/v2/features/app/helpers/get-route-param.ts
+function getRouteParam(paramName, route) {
+	const param = route?.params[paramName];
+	if (typeof param !== "string") return;
+	if (paramName === "method") return param && isHttpMethod(param) ? param : void 0;
+	return decodeURIComponent(param);
+}
+//#endregion
+export { getRouteParam };
+
+//# sourceMappingURL=get-route-param.js.map

package/dist/v2/features/app/helpers/get-route-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-route-param.js","names":[],"sources":["../../../../../src/v2/features/app/helpers/get-route-param.ts"],"sourcesContent":["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { isHttpMethod } from '@scalar/helpers/http/is-http-method'\nimport type { RouteLocationNormalizedGeneric } from 'vue-router'\n\nimport type { ScalarClientAppRouteParams } from '@/v2/features/app/helpers/routes'\n\n/** Extracts a string parameter from the route */\nexport function getRouteParam(paramName: 'method', route: RouteLocationNormalizedGeneric | null): HttpMethod | undefined\nexport function getRouteParam(\n  paramName: Exclude<ScalarClientAppRouteParams, 'method'>,\n  route: RouteLocationNormalizedGeneric | null,\n): string | undefined\nexport function getRouteParam(\n  paramName: ScalarClientAppRouteParams,\n  route: RouteLocationNormalizedGeneric | null,\n): string | undefined {\n  const param = route?.params[paramName]\n\n  if (typeof param !== 'string') {\n    return undefined\n  }\n\n  if (paramName === 'method') {\n    return param && isHttpMethod(param) ? param : undefined\n  }\n\n  return decodeURIComponent(param)\n}\n"],"mappings":";;AAYA,SAAgB,cACd,WACA,OACoB;CACpB,MAAM,QAAQ,OAAO,OAAO;AAE5B,KAAI,OAAO,UAAU,SACnB;AAGF,KAAI,cAAc,SAChB,QAAO,SAAS,aAAa,MAAM,GAAG,QAAQ,KAAA;AAGhD,QAAO,mBAAmB,MAAM"}

package/dist/v2/features/app/helpers/group-workspaces.js

@@ -0,0 +1,38 @@
+//#region src/v2/features/app/helpers/group-workspaces.ts
+/**
+* Groups workspaces into team and local categories.
+* Team workspaces are listed first (if not viewing local workspaces),
+* followed by local workspaces.
+*
+* @param workspaces - Array of workspaces to group
+* @param currentTeamUid - Current team identifier ('local' for local team)
+* @returns Array of workspace groups with labels and options
+*/
+function groupWorkspacesByTeam(workspaces, currentTeamUid) {
+	const workspacesByTeam = workspaces.reduce((acc, workspace) => {
+		const teamUid = workspace.teamUid;
+		if (!acc[teamUid]) acc[teamUid] = [];
+		acc[teamUid].push({
+			id: workspace.id,
+			label: workspace.label
+		});
+		return acc;
+	}, {});
+	const result = [];
+	if (currentTeamUid !== "local") {
+		const teamWorkspaces = workspacesByTeam[currentTeamUid] ?? [];
+		if (teamWorkspaces.length > 0) result.push({
+			label: "Team Workspaces",
+			options: teamWorkspaces
+		});
+	}
+	result.push({
+		label: "Local Workspaces",
+		options: workspacesByTeam["local"] ?? []
+	});
+	return result;
+}
+//#endregion
+export { groupWorkspacesByTeam };
+
+//# sourceMappingURL=group-workspaces.js.map

package/dist/v2/features/app/helpers/group-workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-workspaces.js","names":[],"sources":["../../../../../src/v2/features/app/helpers/group-workspaces.ts"],"sourcesContent":["import type { ScalarListboxOption, WorkspaceGroup } from '@scalar/components'\n\n/**\n * Represents a workspace with team information.\n * Used to group workspaces by team or local status.\n */\nexport type WorkspaceItem = {\n  /** Unique identifier for the workspace. */\n  id: string\n  /** Display name of the workspace. */\n  label: string\n  /** Team identifier. Use 'local' for local workspaces. */\n  teamUid: string\n}\n\n/**\n * Groups workspaces into team and local categories.\n * Team workspaces are listed first (if not viewing local workspaces),\n * followed by local workspaces.\n *\n * @param workspaces - Array of workspaces to group\n * @param currentTeamUid - Current team identifier ('local' for local team)\n * @returns Array of workspace groups with labels and options\n */\nexport function groupWorkspacesByTeam(workspaces: WorkspaceItem[], currentTeamUid: string): WorkspaceGroup[] {\n  // Group workspaces by teamUid\n  const workspacesByTeam = workspaces.reduce<Record<string, ScalarListboxOption[]>>((acc, workspace) => {\n    const teamUid = workspace.teamUid\n\n    if (!acc[teamUid]) {\n      acc[teamUid] = []\n    }\n\n    acc[teamUid].push({\n      id: workspace.id,\n      label: workspace.label,\n    })\n\n    return acc\n  }, {})\n\n  const result: WorkspaceGroup[] = []\n\n  // Add current team workspaces (if not local)\n  if (currentTeamUid !== 'local') {\n    const teamWorkspaces = workspacesByTeam[currentTeamUid] ?? []\n\n    if (teamWorkspaces.length > 0) {\n      result.push({\n        label: 'Team Workspaces',\n        options: teamWorkspaces,\n      })\n    }\n  }\n\n  // Always add local workspaces section\n  result.push({\n    label: 'Local Workspaces',\n    options: workspacesByTeam['local'] ?? [],\n  })\n\n  return result\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,sBAAsB,YAA6B,gBAA0C;CAE3G,MAAM,mBAAmB,WAAW,QAA+C,KAAK,cAAc;EACpG,MAAM,UAAU,UAAU;AAE1B,MAAI,CAAC,IAAI,SACP,KAAI,WAAW,EAAE;AAGnB,MAAI,SAAS,KAAK;GAChB,IAAI,UAAU;GACd,OAAO,UAAU;GAClB,CAAC;AAEF,SAAO;IACN,EAAE,CAAC;CAEN,MAAM,SAA2B,EAAE;AAGnC,KAAI,mBAAmB,SAAS;EAC9B,MAAM,iBAAiB,iBAAiB,mBAAmB,EAAE;AAE7D,MAAI,eAAe,SAAS,EAC1B,QAAO,KAAK;GACV,OAAO;GACP,SAAS;GACV,CAAC;;AAKN,QAAO,KAAK;EACV,OAAO;EACP,SAAS,iBAAiB,YAAY,EAAE;EACzC,CAAC;AAEF,QAAO"}

package/dist/v2/features/app/helpers/routes.d.ts

@@ -5,7 +5,7 @@ import type { WorkspaceStore } from '@scalar/workspace-store/client';
 import type { WorkspaceEventBus } from '@scalar/workspace-store/events';
 import type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments';
 import type { WorkspaceDocument } from '@scalar/workspace-store/schemas/workspace';
-import type { MergedSecuritySchemes } from '../../../../v2/blocks/scalar-auth-selector-block/helpers/merge-security';
+import type { MergedSecuritySchemes } from '../../../../v2/blocks/scalar-auth-selector-block/helpers/merge-security.js';
 import type { ImportDocumentFromRegistry } from '../../../../v2/types/configuration';
 import type { ClientLayout } from '../../../../v2/types/layout';
 /** These props are provided at the route level */
@@ -48,6 +48,10 @@ export type RouteProps = {
      * over x-scalar-original-source-url when syncing. Returns the document as a plain object.
      */
     fetchRegistryDocument?: ImportDocumentFromRegistry;
+    /** Whether telemetry is enabled */
+    telemetry?: boolean;
+    /** Updates the telemetry enabled state */
+    onUpdateTelemetry?: (value: boolean) => void;
 };
 /** When in the collections pages */
 export type CollectionProps = RouteProps & ({
@@ -69,9 +73,11 @@ export declare const ROUTES: ({
                 name: string;
                 path: string;
                 component: import("vue").DefineComponent<RouteProps & {
-                    options?: import("../../modal/Modal.vue").ModalProps["options"];
+                    options?: import("../../modal/Modal.vue.js").ModalProps["options"];
+                    requestBodyCompositionSelection?: Record<string, number>;
                 }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<RouteProps & {
-                    options?: import("../../modal/Modal.vue").ModalProps["options"];
+                    options?: import("../../modal/Modal.vue.js").ModalProps["options"];
+                    requestBodyCompositionSelection?: Record<string, number>;
                 }> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
                 redirect?: undefined;
                 children?: undefined;

package/dist/v2/features/app/helpers/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/routes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/routes.ts"],"names":[],"mappings":"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"}

package/dist/v2/features/app/helpers/routes.js

@@ -0,0 +1,133 @@
+import Operation_default from "../../operation/Operation.vue.js";
+import { workspaceStorage } from "../../../helpers/storage.js";
+import Authentication_default from "../../collection/components/Authentication.vue.js";
+import Cookies_default from "../../collection/components/Cookies.vue.js";
+import Editor_default from "../../collection/components/Editor/Editor.vue.js";
+import Environment_default from "../../collection/components/Environment.vue.js";
+import Overview_default from "../../collection/components/Overview.vue.js";
+import Servers_default from "../../collection/components/Servers.vue.js";
+import Settings_default from "../../collection/components/Settings.vue.js";
+import DocumentCollection_default from "../../collection/DocumentCollection.vue.js";
+import OperationCollection_default from "../../collection/OperationCollection.vue.js";
+import WorkspaceCollection_default from "../../collection/WorkspaceCollection.vue.js";
+import { mergeSearchParams } from "@scalar/helpers/url/merge-urls";
+//#region src/v2/features/app/helpers/routes.ts
+/** Routes for the API client app and web, the same as modal + workspace routes */
+var ROUTES = [{
+	path: "/@:namespace/:workspaceSlug",
+	children: [{
+		path: "document/:documentSlug",
+		children: [{
+			path: "path/:pathEncoded/method/:method",
+			children: [{
+				name: "example",
+				path: "example/:exampleName",
+				component: Operation_default
+			}, {
+				name: "operation",
+				path: "",
+				component: OperationCollection_default,
+				redirect: { name: "operation.overview" },
+				children: [
+					{
+						name: "operation.overview",
+						path: "overview",
+						component: Overview_default
+					},
+					{
+						name: "operation.servers",
+						path: "servers",
+						component: Servers_default
+					},
+					{
+						name: "operation.authentication",
+						path: "authentication",
+						component: Authentication_default
+					},
+					{
+						name: "operation.editor",
+						path: "editor",
+						component: Editor_default
+					}
+				]
+			}]
+		}, {
+			name: "document",
+			path: "",
+			component: DocumentCollection_default,
+			children: [
+				{
+					name: "document.redirect",
+					path: "",
+					redirect: { name: "document.overview" }
+				},
+				{
+					name: "document.overview",
+					path: "overview",
+					component: Overview_default
+				},
+				{
+					name: "document.servers",
+					path: "servers",
+					component: Servers_default
+				},
+				{
+					name: "document.environment",
+					path: "environment",
+					component: Environment_default
+				},
+				{
+					name: "document.authentication",
+					path: "authentication",
+					component: Authentication_default
+				},
+				{
+					name: "document.cookies",
+					path: "cookies",
+					component: Cookies_default
+				},
+				{
+					name: "document.settings",
+					path: "settings",
+					component: Settings_default
+				}
+			]
+		}]
+	}, {
+		name: "workspace",
+		path: "",
+		component: WorkspaceCollection_default,
+		children: [
+			{
+				name: "workspace.environment",
+				path: "environment",
+				component: Environment_default
+			},
+			{
+				name: "workspace.cookies",
+				path: "cookies",
+				component: Cookies_default
+			},
+			{
+				name: "workspace.settings",
+				path: "settings",
+				component: Settings_default
+			}
+		]
+	}]
+}, {
+	path: "/:pathMatch(.*)*",
+	redirect: () => {
+		const DEFAULT_PATH = "/@local/default/document/drafts/overview";
+		const lastPath = workspaceStorage.getLastPath() ?? DEFAULT_PATH;
+		workspaceStorage.setCurrentPath(DEFAULT_PATH);
+		const url = new URL(lastPath, "http://example.com");
+		const queryParameters = new URLSearchParams(window.location.search);
+		const mergedSearchParams = mergeSearchParams(url.searchParams, queryParameters);
+		return `${url.pathname}?${mergedSearchParams.toString()}`;
+	}
+}];
+//#endregion
+export { ROUTES };
+
+//# sourceMappingURL=routes.js.map

package/dist/v2/features/app/helpers/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","names":[],"sources":["../../../../../src/v2/features/app/helpers/routes.ts"],"sourcesContent":["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { mergeSearchParams } from '@scalar/helpers/url/merge-urls'\nimport type { ClientPlugin } from '@scalar/oas-utils/helpers'\nimport type { Theme } from '@scalar/themes'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\nimport type { WorkspaceEventBus } from '@scalar/workspace-store/events'\nimport type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport type { WorkspaceDocument } from '@scalar/workspace-store/schemas/workspace'\nimport type { RouteRecordRaw } from 'vue-router'\n\nimport type { MergedSecuritySchemes } from '@/v2/blocks/scalar-auth-selector-block/helpers/merge-security'\nimport Authentication from '@/v2/features/collection/components/Authentication.vue'\nimport Cookies from '@/v2/features/collection/components/Cookies.vue'\nimport { Editor } from '@/v2/features/collection/components/Editor'\nimport Environment from '@/v2/features/collection/components/Environment.vue'\nimport Overview from '@/v2/features/collection/components/Overview.vue'\nimport Servers from '@/v2/features/collection/components/Servers.vue'\nimport Settings from '@/v2/features/collection/components/Settings.vue'\nimport DocumentCollection from '@/v2/features/collection/DocumentCollection.vue'\nimport OperationCollection from '@/v2/features/collection/OperationCollection.vue'\nimport WorkspaceCollection from '@/v2/features/collection/WorkspaceCollection.vue'\nimport { Operation } from '@/v2/features/operation'\nimport { workspaceStorage } from '@/v2/helpers/storage'\nimport type { ImportDocumentFromRegistry } from '@/v2/types/configuration'\nimport type { ClientLayout } from '@/v2/types/layout'\n\n/** These props are provided at the route level */\nexport type RouteProps = {\n  /** The slug of the currently selected document in the workspace */\n  documentSlug: string\n  /** The currently active document */\n  document: WorkspaceDocument | null\n  /** The workspace event bus */\n  eventBus: WorkspaceEventBus\n  /** The layout of the client */\n  layout: ClientLayout\n  /** The API path currently selected (e.g. \"/users/{id}\") */\n  path?: string\n  /** The HTTP method for the currently selected API path (e.g. GET, POST) */\n  method?: HttpMethod\n  /** The name of the currently selected example (for examples within an endpoint) */\n  exampleName?: string\n  /** The currently active environment */\n  environment: XScalarEnvironment\n  /** The merged security schemes */\n  securitySchemes: MergedSecuritySchemes\n  /** The workspace store */\n  workspaceStore: WorkspaceStore\n  /** The currently active workspace */\n  activeWorkspace: { id: string; label: string }\n  /** Client plugins */\n  plugins: ClientPlugin[]\n  /** Custom themes available to the team */\n  customThemes?: Theme[]\n  /** The currently selected theme styles string */\n  currentTheme?: string\n  /** Whether the current color mode is dark */\n  isDarkMode?: boolean\n  /**\n   * Fetches the full document from registry by meta. When provided, registry meta takes priority\n   * over x-scalar-original-source-url when syncing. Returns the document as a plain object.\n   */\n  fetchRegistryDocument?: ImportDocumentFromRegistry\n  /** Whether telemetry is enabled */\n  telemetry?: boolean\n  /** Updates the telemetry enabled state */\n  onUpdateTelemetry?: (value: boolean) => void\n}\n\n/** When in the collections pages */\nexport type CollectionProps = RouteProps &\n  (\n    | {\n        collectionType: 'document' | 'operation'\n        document: WorkspaceDocument\n      }\n    | {\n        collectionType: 'workspace'\n        document: null\n      }\n  )\n\nexport type ScalarClientAppRouteParams =\n  | 'namespace'\n  | 'workspaceSlug'\n  | 'documentSlug'\n  | 'pathEncoded'\n  | 'method'\n  | 'exampleName'\n\n/** Routes for the API client app and web, the same as modal + workspace routes */\nexport const ROUTES = [\n  {\n    path: '/@:namespace/:workspaceSlug',\n    children: [\n      {\n        path: 'document/:documentSlug',\n        children: [\n          // Example page\n          {\n            path: 'path/:pathEncoded/method/:method',\n            children: [\n              {\n                name: 'example',\n                path: 'example/:exampleName',\n                component: Operation,\n              },\n              {\n                name: 'operation',\n                path: '',\n                component: OperationCollection,\n                redirect: {\n                  name: 'operation.overview',\n                },\n                children: [\n                  {\n                    name: 'operation.overview',\n                    path: 'overview',\n                    component: Overview,\n                  },\n                  {\n                    name: 'operation.servers',\n                    path: 'servers',\n                    component: Servers,\n                  },\n                  {\n                    name: 'operation.authentication',\n                    path: 'authentication',\n                    component: Authentication,\n                  },\n                  {\n                    name: 'operation.editor',\n                    path: 'editor',\n                    component: Editor,\n                  },\n                ],\n              },\n            ],\n          },\n          // Document Page\n          {\n            name: 'document',\n            path: '',\n            component: DocumentCollection,\n            children: [\n              // Redirect to overview\n              {\n                name: 'document.redirect',\n                path: '',\n                redirect: {\n                  name: 'document.overview',\n                },\n              },\n              // Document overview\n              {\n                name: 'document.overview',\n                path: 'overview',\n                component: Overview,\n              },\n              // Document servers\n              {\n                name: 'document.servers',\n                path: 'servers',\n                component: Servers,\n              },\n              // Document environment\n              {\n                name: 'document.environment',\n                path: 'environment',\n                component: Environment,\n              },\n              // Document authentication\n              {\n                name: 'document.authentication',\n                path: 'authentication',\n                component: Authentication,\n              },\n              // Document cookies\n              {\n                name: 'document.cookies',\n                path: 'cookies',\n                component: Cookies,\n              },\n              // Document settings\n              {\n                name: 'document.settings',\n                path: 'settings',\n                component: Settings,\n              },\n            ],\n          },\n        ],\n      },\n      // Workspace page\n      {\n        name: 'workspace',\n        path: '',\n        component: WorkspaceCollection,\n        children: [\n          // Workspace environment\n          {\n            name: 'workspace.environment',\n            path: 'environment',\n            component: Environment,\n          },\n          // Workspace cookies\n          {\n            name: 'workspace.cookies',\n            path: 'cookies',\n            component: Cookies,\n          },\n          // Workspace settings\n          {\n            name: 'workspace.settings',\n            path: 'settings',\n            component: Settings,\n          },\n        ],\n      },\n    ],\n  },\n  {\n    path: '/:pathMatch(.*)*',\n    redirect: () => {\n      const DEFAULT_PATH = '/@local/default/document/drafts/overview'\n      const lastPath = workspaceStorage.getLastPath() ?? DEFAULT_PATH\n\n      // Set the default path to the last path so we don't go to an inifite loop if the last path is invalid\n      workspaceStorage.setCurrentPath(DEFAULT_PATH)\n\n      const url = new URL(lastPath, 'http://example.com')\n\n      const queryParameters = new URLSearchParams(window.location.search)\n\n      //Merge the query parameters with the last path\n      const mergedSearchParams = mergeSearchParams(url.searchParams, queryParameters)\n\n      // Preserve all query paramters\n      return `${url.pathname}?${mergedSearchParams.toString()}`\n    },\n  },\n] satisfies RouteRecordRaw[]\n"],"mappings":";;;;;;;;;;;;;;;AA2FA,IAAa,SAAS,CACpB;CACE,MAAM;CACN,UAAU,CACR;EACE,MAAM;EACN,UAAU,CAER;GACE,MAAM;GACN,UAAU,CACR;IACE,MAAM;IACN,MAAM;IACN,WAAW;IACZ,EACD;IACE,MAAM;IACN,MAAM;IACN,WAAW;IACX,UAAU,EACR,MAAM,sBACP;IACD,UAAU;KACR;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KACD;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KACD;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KACD;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KACF;IACF,CACF;GACF,EAED;GACE,MAAM;GACN,MAAM;GACN,WAAW;GACX,UAAU;IAER;KACE,MAAM;KACN,MAAM;KACN,UAAU,EACR,MAAM,qBACP;KACF;IAED;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACZ;IAED;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACZ;IAED;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACZ;IAED;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACZ;IAED;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACZ;IAED;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACZ;IACF;GACF,CACF;EACF,EAED;EACE,MAAM;EACN,MAAM;EACN,WAAW;EACX,UAAU;GAER;IACE,MAAM;IACN,MAAM;IACN,WAAW;IACZ;GAED;IACE,MAAM;IACN,MAAM;IACN,WAAW;IACZ;GAED;IACE,MAAM;IACN,MAAM;IACN,WAAW;IACZ;GACF;EACF,CACF;CACF,EACD;CACE,MAAM;CACN,gBAAgB;EACd,MAAM,eAAe;EACrB,MAAM,WAAW,iBAAiB,aAAa,IAAI;AAGnD,mBAAiB,eAAe,aAAa;EAE7C,MAAM,MAAM,IAAI,IAAI,UAAU,qBAAqB;EAEnD,MAAM,kBAAkB,IAAI,gBAAgB,OAAO,SAAS,OAAO;EAGnE,MAAM,qBAAqB,kBAAkB,IAAI,cAAc,gBAAgB;AAG/E,SAAO,GAAG,IAAI,SAAS,GAAG,mBAAmB,UAAU;;CAE1D,CACF"}

package/dist/v2/features/app/hooks/use-document-watcher.js

@@ -0,0 +1,168 @@
+import { computed, onBeforeUnmount, toValue, watch } from "vue";
+//#region src/v2/features/app/hooks/use-document-watcher.ts
+/**
+* Default timeout before the first poll attempt (in milliseconds).
+*/
+var DEFAULT_INITIAL_TIMEOUT = 5 * 1e3;
+/**
+* Maximum timeout cap for exponential backoff (in milliseconds).
+*/
+var MAX_TIMEOUT = 60 * 1e3;
+/**
+* Creates a timer manager for handling polling timeouts.
+*
+* @returns Object with methods to manage the polling timer.
+*/
+var createTimerManager = () => {
+	let timer = null;
+	/**
+	* Clears the current timer if it exists.
+	*/
+	const clear = () => {
+		if (timer) {
+			clearTimeout(timer);
+			timer = null;
+		}
+	};
+	/**
+	* Schedules the next poll after the specified timeout.
+	*
+	* @param callback - The function to call when the timeout expires.
+	* @param timeout - The delay in milliseconds before calling the callback.
+	*/
+	const schedule = (callback, timeout) => {
+		clear();
+		timer = setTimeout(callback, timeout);
+	};
+	return {
+		clear,
+		schedule
+	};
+};
+/**
+* Creates a timeout manager that handles exponential backoff on failures.
+*
+* @param initialTimeout - The initial timeout value in milliseconds.
+* @returns Object with methods to manage timeout values.
+*/
+var createTimeoutManager = (initialTimeout) => {
+	let currentTimeout = initialTimeout;
+	/**
+	* Resets the timeout to its initial value.
+	*/
+	const reset = () => {
+		currentTimeout = initialTimeout;
+	};
+	/**
+	* Doubles the timeout with exponential backoff, capped at MAX_TIMEOUT.
+	*/
+	const backoff = () => {
+		currentTimeout = Math.min(currentTimeout * 2, MAX_TIMEOUT);
+	};
+	/**
+	* Gets the current timeout value.
+	*/
+	const get = () => currentTimeout;
+	return {
+		reset,
+		backoff,
+		get
+	};
+};
+/**
+* Resolves conflicts by preferring remote changes.
+*
+* @param conflicts - Array of conflict tuples from the rebase result.
+* Each tuple contains two arrays: [remote changes, local changes].
+* @returns Array of remote changes to apply.
+*/
+var resolveConflicts = (conflicts) => {
+	return conflicts.flatMap(([remote]) => remote);
+};
+/**
+* Watches the specified document in the workspace store and periodically rebases it with its remote source.
+*
+* This utility sets up a watcher on the given document. If the document specifies an 'x-scalar-original-source-url'
+* and watch mode is enabled, this hook polls the remote source and calls `store.rebaseDocument`.
+* If rebase conflicts are detected, it applies automatic conflict resolution by preferring remote changes.
+* Uses exponential backoff on failures to avoid overwhelming the server.
+*
+* @param params - Configuration object for the document watcher.
+* @param params.documentName - The name/key of the document to watch and rebase.
+* @param params.store - The WorkspaceStore instance.
+* @param params.initialTimeout - Initial delay before the first poll attempt (default: 5000ms).
+*
+* @example
+* ```ts
+* import { useDocumentWatcher } from '@/hooks/use-document-watcher'
+* import { useScalarWorkspaceStore } from '@scalar/workspace-store'
+*
+* const store = useScalarWorkspaceStore()
+* useDocumentWatcher({ documentName: 'myApi', store })
+* ```
+*/
+var useDocumentWatcher = ({ documentName, store, initialTimeout = DEFAULT_INITIAL_TIMEOUT }) => {
+	const document = computed(() => {
+		const storeValue = toValue(store);
+		const documentNameValue = toValue(documentName);
+		if (!storeValue || !documentNameValue) return null;
+		return storeValue.workspace.documents[documentNameValue];
+	});
+	const timerManager = createTimerManager();
+	const timeoutManager = createTimeoutManager(initialTimeout);
+	/**
+	* Handles a successful poll result (with or without changes).
+	*/
+	const handleSuccess = () => {
+		timeoutManager.reset();
+		timerManager.schedule(poll, timeoutManager.get());
+	};
+	/**
+	* Handles a failed poll result with exponential backoff.
+	*/
+	const handleFailure = () => {
+		timeoutManager.backoff();
+		timerManager.schedule(poll, timeoutManager.get());
+	};
+	/**
+	* Polls the remote document source and attempts to rebase.
+	*/
+	const poll = async () => {
+		const storeValue = toValue(store);
+		const documentNameValue = toValue(documentName);
+		const sourceUrl = document.value?.["x-scalar-original-source-url"];
+		if (!storeValue || !documentNameValue || !sourceUrl) return;
+		const result = await storeValue.rebaseDocument({
+			name: documentNameValue,
+			url: sourceUrl
+		});
+		if (result?.ok) {
+			await result.applyChanges({ resolvedConflicts: resolveConflicts(result.conflicts) });
+			handleSuccess();
+		} else if (result?.ok === false && result.type === "NO_CHANGES_DETECTED") handleSuccess();
+		else handleFailure();
+	};
+	/**
+	* Watches for changes to the document's source URL and watch mode.
+	* Starts or stops polling based on these values.
+	*/
+	watch([() => document.value?.["x-scalar-original-source-url"], () => document.value?.["x-scalar-watch-mode"]], ([sourceUrl, watchMode = false]) => {
+		if (!toValue(store)) {
+			timerManager.clear();
+			return;
+		}
+		timerManager.clear();
+		if (!sourceUrl || !watchMode) {
+			timeoutManager.reset();
+			return;
+		}
+		timerManager.schedule(poll, timeoutManager.get());
+	}, { immediate: true });
+	onBeforeUnmount(() => {
+		timerManager.clear();
+	});
+};
+//#endregion
+export { useDocumentWatcher };
+
+//# sourceMappingURL=use-document-watcher.js.map