@scalar/api-client 3.3.1 → 3.4.0

package/dist/v2/features/app/helpers/filter-workspaces.d.ts

@@ -2,40 +2,40 @@
  * 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)
+ * - Its teamSlug matches the current team, OR
+ * - Its teamSlug is 'local' (local workspaces are always accessible)
  *
  * @param workspaces - Array of workspaces to filter
- * @param currentTeamUid - The currently active team identifier
+ * @param currentTeamSlug - 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' },
+ *   { id: '1', teamSlug: 'local', name: 'Local' },
+ *   { id: '2', teamSlug: 'team-a', name: 'Team A' },
+ *   { id: '3', teamSlug: 'team-b', name: 'Team B' },
  * ]
  *
  * filterWorkspacesByTeam(workspaces, 'team-a')
- * // => [{ id: '1', teamUid: 'local' }, { id: '2', teamUid: 'team-a' }]
+ * // => [{ id: '1', teamSlug: 'local' }, { id: '2', teamSlug: 'team-a' }]
  * ```
  */
 export declare const filterWorkspacesByTeam: <T extends {
-    teamUid: string;
-}>(workspaces: T[], currentTeamUid: string) => T[];
+    teamSlug: string;
+}>(workspaces: T[], currentTeamSlug: string) => T[];
 /**
  * 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)
+ * - Its teamSlug matches the current team, OR
+ * - Its teamSlug 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
+ * @param workspaceTeamSlug - The team identifier of the workspace to check
+ * @param currentTeamSlug - The currently active team identifier
  * @returns true if the workspace can be loaded, false otherwise
  *
  * @example
@@ -45,5 +45,5 @@ export declare const filterWorkspacesByTeam: <T extends {
  * canLoadWorkspace('team-b', 'team-a') // => false
  * ```
  */
-export declare const canLoadWorkspace: (workspaceTeamUid: string, currentTeamUid: string) => boolean;
+export declare const canLoadWorkspace: (workspaceTeamSlug: string, currentTeamSlug: string) => boolean;
 //# sourceMappingURL=filter-workspaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"filter-workspaces.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/filter-workspaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,YAAY,CAAC,EAAE,EAAE,gBAAgB,MAAM,KAAG,CAAC,EAEhH,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAAI,kBAAkB,MAAM,EAAE,gBAAgB,MAAM,KAAG,OAEnF,CAAA"}
+{"version":3,"file":"filter-workspaces.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/filter-workspaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EACnE,YAAY,CAAC,EAAE,EACf,iBAAiB,MAAM,KACtB,CAAC,EAEH,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAAI,mBAAmB,MAAM,EAAE,iBAAiB,MAAM,KAAG,OAErF,CAAA"}

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

@@ -3,40 +3,40 @@
 * 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)
+* - Its teamSlug matches the current team, OR
+* - Its teamSlug is 'local' (local workspaces are always accessible)
 *
 * @param workspaces - Array of workspaces to filter
-* @param currentTeamUid - The currently active team identifier
+* @param currentTeamSlug - 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' },
+*   { id: '1', teamSlug: 'local', name: 'Local' },
+*   { id: '2', teamSlug: 'team-a', name: 'Team A' },
+*   { id: '3', teamSlug: 'team-b', name: 'Team B' },
 * ]
 *
 * filterWorkspacesByTeam(workspaces, 'team-a')
-* // => [{ id: '1', teamUid: 'local' }, { id: '2', teamUid: 'team-a' }]
+* // => [{ id: '1', teamSlug: 'local' }, { id: '2', teamSlug: 'team-a' }]
 * ```
 */
-var filterWorkspacesByTeam = (workspaces, currentTeamUid) => {
-	return workspaces.filter((workspace) => canLoadWorkspace(workspace.teamUid, currentTeamUid));
+var filterWorkspacesByTeam = (workspaces, currentTeamSlug) => {
+	return workspaces.filter((workspace) => canLoadWorkspace(workspace.teamSlug, currentTeamSlug));
 };
 /**
 * 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)
+* - Its teamSlug matches the current team, OR
+* - Its teamSlug 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
+* @param workspaceTeamSlug - The team identifier of the workspace to check
+* @param currentTeamSlug - The currently active team identifier
 * @returns true if the workspace can be loaded, false otherwise
 *
 * @example
@@ -46,8 +46,8 @@ var filterWorkspacesByTeam = (workspaces, currentTeamUid) => {
 * canLoadWorkspace('team-b', 'team-a') // => false
 * ```
 */
-var canLoadWorkspace = (workspaceTeamUid, currentTeamUid) => {
-	return workspaceTeamUid === currentTeamUid || workspaceTeamUid === "local";
+var canLoadWorkspace = (workspaceTeamSlug, currentTeamSlug) => {
+	return workspaceTeamSlug === currentTeamSlug || workspaceTeamSlug === "local";
 };
 //#endregion
 export { canLoadWorkspace, filterWorkspacesByTeam };

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

@@ -1 +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"}
+{"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 teamSlug matches the current team, OR\n * - Its teamSlug is 'local' (local workspaces are always accessible)\n *\n * @param workspaces - Array of workspaces to filter\n * @param currentTeamSlug - 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', teamSlug: 'local', name: 'Local' },\n *   { id: '2', teamSlug: 'team-a', name: 'Team A' },\n *   { id: '3', teamSlug: 'team-b', name: 'Team B' },\n * ]\n *\n * filterWorkspacesByTeam(workspaces, 'team-a')\n * // => [{ id: '1', teamSlug: 'local' }, { id: '2', teamSlug: 'team-a' }]\n * ```\n */\nexport const filterWorkspacesByTeam = <T extends { teamSlug: string }>(\n  workspaces: T[],\n  currentTeamSlug: string,\n): T[] => {\n  return workspaces.filter((workspace) => canLoadWorkspace(workspace.teamSlug, currentTeamSlug))\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 teamSlug matches the current team, OR\n * - Its teamSlug 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 workspaceTeamSlug - The team identifier of the workspace to check\n * @param currentTeamSlug - 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 = (workspaceTeamSlug: string, currentTeamSlug: string): boolean => {\n  return workspaceTeamSlug === currentTeamSlug || workspaceTeamSlug === 'local'\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAa,0BACX,YACA,oBACQ;AACR,QAAO,WAAW,QAAQ,cAAc,iBAAiB,UAAU,UAAU,gBAAgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;AAwBhG,IAAa,oBAAoB,mBAA2B,oBAAqC;AAC/F,QAAO,sBAAsB,mBAAmB,sBAAsB"}

package/dist/v2/features/app/helpers/group-workspaces.d.ts

@@ -9,16 +9,36 @@ export type WorkspaceItem = {
     /** Display name of the workspace. */
     label: string;
     /** Team identifier. Use 'local' for local workspaces. */
-    teamUid: string;
+    teamSlug: string;
 };
 /**
  * Groups workspaces into team and local categories.
  * Team workspaces are listed first (if not viewing local workspaces),
  * followed by local workspaces.
  *
+ * When `placeholder` is provided and the current non-local team has no real
+ * workspaces yet, a single "fake" option is added to the team group. The
+ * option uses the same id format as a real workspace (`teamSlug/slug`) so
+ * clicking it routes through the normal navigation flow. The route handler is
+ * responsible for creating the workspace on demand when it does not yet exist.
+ *
  * @param workspaces - Array of workspaces to group
- * @param currentTeamUid - Current team identifier ('local' for local team)
+ * @param currentTeamSlug - Current team identifier ('local' for local team)
+ * @param options - Optional grouping behavior
  * @returns Array of workspace groups with labels and options
  */
-export declare function groupWorkspacesByTeam(workspaces: WorkspaceItem[], currentTeamUid: string): WorkspaceGroup[];
+export declare function groupWorkspacesByTeam(workspaces: WorkspaceItem[], currentTeamSlug: string, options?: {
+    /**
+     * Surfaces a fake default option for the current non-local team when it
+     * has no real workspaces yet. The option's id is
+     * `getWorkspaceId(currentTeamSlug, slug)` so the picker can navigate to it
+     * like any other workspace.
+     */
+    placeholder?: {
+        /** Slug used for the on-demand team workspace (e.g. `'default'`). */
+        slug: string;
+        /** Display label for the placeholder option (e.g. `'Workspace'`). */
+        label: string;
+    };
+}): WorkspaceGroup[];
 //# sourceMappingURL=group-workspaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"group-workspaces.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/group-workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAE7E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAA;IACV,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,EAAE,CAsC3G"}
+{"version":3,"file":"group-workspaces.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/group-workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAG7E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAA;IACV,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,aAAa,EAAE,EAC3B,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;IACR;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QACZ,qEAAqE;QACrE,IAAI,EAAE,MAAM,CAAA;QACZ,qEAAqE;QACrE,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF,GACA,cAAc,EAAE,CAmDlB"}

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

@@ -1,30 +1,45 @@
+import { getWorkspaceId } from "@scalar/workspace-store/persistence";
 //#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.
 *
+* When `placeholder` is provided and the current non-local team has no real
+* workspaces yet, a single "fake" option is added to the team group. The
+* option uses the same id format as a real workspace (`teamSlug/slug`) so
+* clicking it routes through the normal navigation flow. The route handler is
+* responsible for creating the workspace on demand when it does not yet exist.
+*
 * @param workspaces - Array of workspaces to group
-* @param currentTeamUid - Current team identifier ('local' for local team)
+* @param currentTeamSlug - Current team identifier ('local' for local team)
+* @param options - Optional grouping behavior
 * @returns Array of workspace groups with labels and options
 */
-function groupWorkspacesByTeam(workspaces, currentTeamUid) {
+function groupWorkspacesByTeam(workspaces, currentTeamSlug, options) {
 	const workspacesByTeam = workspaces.reduce((acc, workspace) => {
-		const teamUid = workspace.teamUid;
-		if (!acc[teamUid]) acc[teamUid] = [];
-		acc[teamUid].push({
+		const teamSlug = workspace.teamSlug;
+		if (!acc[teamSlug]) acc[teamSlug] = [];
+		acc[teamSlug].push({
 			id: workspace.id,
 			label: workspace.label
 		});
 		return acc;
 	}, {});
 	const result = [];
-	if (currentTeamUid !== "local") {
-		const teamWorkspaces = workspacesByTeam[currentTeamUid] ?? [];
+	if (currentTeamSlug !== "local") {
+		const teamWorkspaces = workspacesByTeam[currentTeamSlug] ?? [];
 		if (teamWorkspaces.length > 0) result.push({
 			label: "Team Workspaces",
 			options: teamWorkspaces
 		});
+		else if (options?.placeholder) result.push({
+			label: "Team Workspaces",
+			options: [{
+				id: getWorkspaceId(currentTeamSlug, options.placeholder.slug),
+				label: options.placeholder.label
+			}]
+		});
 	}
 	result.push({
 		label: "Local Workspaces",

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

@@ -1 +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"}
+{"version":3,"file":"group-workspaces.js","names":[],"sources":["../../../../../src/v2/features/app/helpers/group-workspaces.ts"],"sourcesContent":["import type { ScalarListboxOption, WorkspaceGroup } from '@scalar/components'\nimport { getWorkspaceId } from '@scalar/workspace-store/persistence'\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  teamSlug: 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 * When `placeholder` is provided and the current non-local team has no real\n * workspaces yet, a single \"fake\" option is added to the team group. The\n * option uses the same id format as a real workspace (`teamSlug/slug`) so\n * clicking it routes through the normal navigation flow. The route handler is\n * responsible for creating the workspace on demand when it does not yet exist.\n *\n * @param workspaces - Array of workspaces to group\n * @param currentTeamSlug - Current team identifier ('local' for local team)\n * @param options - Optional grouping behavior\n * @returns Array of workspace groups with labels and options\n */\nexport function groupWorkspacesByTeam(\n  workspaces: WorkspaceItem[],\n  currentTeamSlug: string,\n  options?: {\n    /**\n     * Surfaces a fake default option for the current non-local team when it\n     * has no real workspaces yet. The option's id is\n     * `getWorkspaceId(currentTeamSlug, slug)` so the picker can navigate to it\n     * like any other workspace.\n     */\n    placeholder?: {\n      /** Slug used for the on-demand team workspace (e.g. `'default'`). */\n      slug: string\n      /** Display label for the placeholder option (e.g. `'Workspace'`). */\n      label: string\n    }\n  },\n): WorkspaceGroup[] {\n  // Bucket workspaces by their team slug.\n  const workspacesByTeam = workspaces.reduce<Record<string, ScalarListboxOption[]>>((acc, workspace) => {\n    const teamSlug = workspace.teamSlug\n\n    if (!acc[teamSlug]) {\n      acc[teamSlug] = []\n    }\n\n    acc[teamSlug].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 (currentTeamSlug !== 'local') {\n    const teamWorkspaces = workspacesByTeam[currentTeamSlug] ?? []\n\n    if (teamWorkspaces.length > 0) {\n      result.push({\n        label: 'Team Workspaces',\n        options: teamWorkspaces,\n      })\n    } else if (options?.placeholder) {\n      // No real team workspace yet: surface a fake option using a real\n      // workspace id so the picker can navigate to it normally. The route\n      // handler creates the workspace on demand when it is not yet persisted.\n      result.push({\n        label: 'Team Workspaces',\n        options: [\n          {\n            id: getWorkspaceId(currentTeamSlug, options.placeholder.slug),\n            label: options.placeholder.label,\n          },\n        ],\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":";;;;;;;;;;;;;;;;;;AAgCA,SAAgB,sBACd,YACA,iBACA,SAckB;CAElB,MAAM,mBAAmB,WAAW,QAA+C,KAAK,cAAc;EACpG,MAAM,WAAW,UAAU;AAE3B,MAAI,CAAC,IAAI,UACP,KAAI,YAAY,EAAE;AAGpB,MAAI,UAAU,KAAK;GACjB,IAAI,UAAU;GACd,OAAO,UAAU;GAClB,CAAC;AAEF,SAAO;IACN,EAAE,CAAC;CAEN,MAAM,SAA2B,EAAE;AAGnC,KAAI,oBAAoB,SAAS;EAC/B,MAAM,iBAAiB,iBAAiB,oBAAoB,EAAE;AAE9D,MAAI,eAAe,SAAS,EAC1B,QAAO,KAAK;GACV,OAAO;GACP,SAAS;GACV,CAAC;WACO,SAAS,YAIlB,QAAO,KAAK;GACV,OAAO;GACP,SAAS,CACP;IACE,IAAI,eAAe,iBAAiB,QAAQ,YAAY,KAAK;IAC7D,OAAO,QAAQ,YAAY;IAC5B,CACF;GACF,CAAC;;AAKN,QAAO,KAAK;EACV,OAAO;EACP,SAAS,iBAAiB,YAAY,EAAE;EACzC,CAAC;AAEF,QAAO"}

package/dist/v2/features/app/helpers/load-registry-document.d.ts

@@ -8,11 +8,26 @@ type LoadRegistryDocumentResult = {
     ok: false;
     error: string;
 };
-export declare const loadRegistryDocument: ({ workspaceStore, fetcher, namespace, slug, }: {
+export declare const loadRegistryDocument: ({ workspaceStore, fetcher, namespace, slug, version, commitHash, }: {
     workspaceStore: WorkspaceStore;
     fetcher: ImportDocumentFromRegistry;
     namespace: string;
     slug: string;
+    /**
+     * Specific version to fetch from the registry. When omitted we ask the
+     * registry for `latest`, which is what callers default to when they do
+     * not have a concrete version pinned for the document yet.
+     */
+    version?: string;
+    /**
+     * Commit hash the registry currently advertises for `version`. Callers
+     * already know this from the version listing (sidebar row, breadcrumb
+     * picker, etc.) so we accept it directly rather than parsing it back
+     * out of the fetched document. When provided it is persisted on
+     * `x-scalar-registry-meta.commitHash` so subsequent refreshes can
+     * detect drift and surface upstream changes.
+     */
+    commitHash?: string;
 }) => Promise<LoadRegistryDocumentResult>;
 export {};
 //# sourceMappingURL=load-registry-document.d.ts.map

package/dist/v2/features/app/helpers/load-registry-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-registry-document.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/load-registry-document.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAGpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAA;AAE1E,iFAAiF;AACjF,KAAK,0BAA0B,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnG,eAAO,MAAM,oBAAoB,GAAU,+CAKxC;IACD,cAAc,EAAE,cAAc,CAAA;IAC9B,OAAO,EAAE,0BAA0B,CAAA;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb,KAAG,OAAO,CAAC,0BAA0B,CA2CrC,CAAA"}
+{"version":3,"file":"load-registry-document.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/load-registry-document.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAGpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAA;AAE1E,iFAAiF;AACjF,KAAK,0BAA0B,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnG,eAAO,MAAM,oBAAoB,GAAU,oEAOxC;IACD,cAAc,EAAE,cAAc,CAAA;IAC9B,OAAO,EAAE,0BAA0B,CAAA;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,KAAG,OAAO,CAAC,0BAA0B,CAwDrC,CAAA"}

package/dist/v2/features/app/helpers/load-registry-document.js

@@ -1,11 +1,11 @@
 import { generateUniqueSlug } from "../../command-palette/helpers/generate-unique-slug.js";
 import { coerce, object, string } from "@scalar/validation";
 //#region src/v2/features/app/helpers/load-registry-document.ts
-var loadRegistryDocument = async ({ workspaceStore, fetcher, namespace, slug }) => {
+var loadRegistryDocument = async ({ workspaceStore, fetcher, namespace, slug, version = "latest", commitHash }) => {
 	const documents = workspaceStore.workspace.documents;
 	const existing = Object.entries(documents).find(([, doc]) => {
 		const meta = doc?.["x-scalar-registry-meta"];
-		return meta?.namespace === namespace && meta?.slug === slug;
+		return meta?.namespace === namespace && meta?.slug === slug && meta?.version === version;
 	});
 	if (existing) return {
 		ok: true,
@@ -14,14 +14,13 @@ var loadRegistryDocument = async ({ workspaceStore, fetcher, namespace, slug })
 	const result = await fetcher({
 		namespace,
 		slug,
-		version: "latest"
+		version
 	});
 	if (!result.ok) return {
 		ok: false,
 		error: `Failed to fetch document: ${result.error || "Unknown error"}`
 	};
-	const baseName = coerce(object({ info: object({ title: string() }) }), result.data).info.title;
-	const documentName = await generateUniqueSlug(baseName.trim() || slug, new Set(Object.keys(documents)));
+	const documentName = await generateUniqueSlug(`${coerce(object({ info: object({ title: string() }) }), result.data).info.title.trim() || slug}-${version}`, new Set(Object.keys(documents)));
 	if (!documentName) return {
 		ok: false,
 		error: "Failed to generate a unique name for the document"
@@ -31,7 +30,9 @@ var loadRegistryDocument = async ({ workspaceStore, fetcher, namespace, slug })
 		document: result.data,
 		meta: { "x-scalar-registry-meta": {
 			namespace,
-			slug
+			slug,
+			version,
+			...commitHash ? { commitHash } : {}
 		} }
 	});
 	return {

package/dist/v2/features/app/helpers/load-registry-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-registry-document.js","names":[],"sources":["../../../../../src/v2/features/app/helpers/load-registry-document.ts"],"sourcesContent":["import { coerce, object, string } from '@scalar/validation'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\n\nimport { generateUniqueSlug } from '@/v2/features/command-palette/helpers/generate-unique-slug'\nimport type { ImportDocumentFromRegistry } from '@/v2/types/configuration'\n\n/** Result of attempting to load a registry document into the workspace store. */\ntype LoadRegistryDocumentResult = { ok: true; documentName: string } | { ok: false; error: string }\n\nexport const loadRegistryDocument = async ({\n  workspaceStore,\n  fetcher,\n  namespace,\n  slug,\n}: {\n  workspaceStore: WorkspaceStore\n  fetcher: ImportDocumentFromRegistry\n  namespace: string\n  slug: string\n}): Promise<LoadRegistryDocumentResult> => {\n  const documents = workspaceStore.workspace.documents\n\n  const existing = Object.entries(documents).find(([, doc]) => {\n    const meta = doc?.['x-scalar-registry-meta']\n    return meta?.namespace === namespace && meta?.slug === slug\n  })\n\n  if (existing) {\n    return { ok: true, documentName: existing[0] }\n  }\n\n  const result = await fetcher({ namespace, slug, version: 'latest' })\n  if (!result.ok) {\n    return {\n      ok: false,\n      error: `Failed to fetch document: ${result.error || 'Unknown error'}`,\n    }\n  }\n\n  // Parse the document data into a schema\n  const schema = object({ info: object({ title: string() }) })\n  const baseName = coerce(schema, result.data).info.title\n\n  const documentName = await generateUniqueSlug(baseName.trim() || slug, new Set(Object.keys(documents)))\n\n  if (!documentName) {\n    return {\n      ok: false,\n      error: 'Failed to generate a unique name for the document',\n    }\n  }\n\n  // Add the document to the workspace store\n  await workspaceStore.addDocument({\n    name: documentName,\n    document: result.data,\n    meta: {\n      'x-scalar-registry-meta': { namespace, slug },\n    },\n  })\n\n  return { ok: true, documentName }\n}\n"],"mappings":";;;AASA,IAAa,uBAAuB,OAAO,EACzC,gBACA,SACA,WACA,WAMyC;CACzC,MAAM,YAAY,eAAe,UAAU;CAE3C,MAAM,WAAW,OAAO,QAAQ,UAAU,CAAC,MAAM,GAAG,SAAS;EAC3D,MAAM,OAAO,MAAM;AACnB,SAAO,MAAM,cAAc,aAAa,MAAM,SAAS;GACvD;AAEF,KAAI,SACF,QAAO;EAAE,IAAI;EAAM,cAAc,SAAS;EAAI;CAGhD,MAAM,SAAS,MAAM,QAAQ;EAAE;EAAW;EAAM,SAAS;EAAU,CAAC;AACpE,KAAI,CAAC,OAAO,GACV,QAAO;EACL,IAAI;EACJ,OAAO,6BAA6B,OAAO,SAAS;EACrD;CAKH,MAAM,WAAW,OADF,OAAO,EAAE,MAAM,OAAO,EAAE,OAAO,QAAQ,EAAE,CAAC,EAAE,CAAC,EAC5B,OAAO,KAAK,CAAC,KAAK;CAElD,MAAM,eAAe,MAAM,mBAAmB,SAAS,MAAM,IAAI,MAAM,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC;AAEvG,KAAI,CAAC,aACH,QAAO;EACL,IAAI;EACJ,OAAO;EACR;AAIH,OAAM,eAAe,YAAY;EAC/B,MAAM;EACN,UAAU,OAAO;EACjB,MAAM,EACJ,0BAA0B;GAAE;GAAW;GAAM,EAC9C;EACF,CAAC;AAEF,QAAO;EAAE,IAAI;EAAM;EAAc"}
+{"version":3,"file":"load-registry-document.js","names":[],"sources":["../../../../../src/v2/features/app/helpers/load-registry-document.ts"],"sourcesContent":["import { coerce, object, string } from '@scalar/validation'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\n\nimport { generateUniqueSlug } from '@/v2/features/command-palette/helpers/generate-unique-slug'\nimport type { ImportDocumentFromRegistry } from '@/v2/types/configuration'\n\n/** Result of attempting to load a registry document into the workspace store. */\ntype LoadRegistryDocumentResult = { ok: true; documentName: string } | { ok: false; error: string }\n\nexport const loadRegistryDocument = async ({\n  workspaceStore,\n  fetcher,\n  namespace,\n  slug,\n  version = 'latest',\n  commitHash,\n}: {\n  workspaceStore: WorkspaceStore\n  fetcher: ImportDocumentFromRegistry\n  namespace: string\n  slug: string\n  /**\n   * Specific version to fetch from the registry. When omitted we ask the\n   * registry for `latest`, which is what callers default to when they do\n   * not have a concrete version pinned for the document yet.\n   */\n  version?: string\n  /**\n   * Commit hash the registry currently advertises for `version`. Callers\n   * already know this from the version listing (sidebar row, breadcrumb\n   * picker, etc.) so we accept it directly rather than parsing it back\n   * out of the fetched document. When provided it is persisted on\n   * `x-scalar-registry-meta.commitHash` so subsequent refreshes can\n   * detect drift and surface upstream changes.\n   */\n  commitHash?: string\n}): Promise<LoadRegistryDocumentResult> => {\n  const documents = workspaceStore.workspace.documents\n\n  const existing = Object.entries(documents).find(([, doc]) => {\n    const meta = doc?.['x-scalar-registry-meta']\n    return meta?.namespace === namespace && meta?.slug === slug && meta?.version === version\n  })\n\n  if (existing) {\n    return { ok: true, documentName: existing[0] }\n  }\n\n  const result = await fetcher({ namespace, slug, version })\n  if (!result.ok) {\n    return {\n      ok: false,\n      error: `Failed to fetch document: ${result.error || 'Unknown error'}`,\n    }\n  }\n\n  // Parse the document data into a schema\n  const schema = object({ info: object({ title: string() }) })\n  const baseName = coerce(schema, result.data).info.title\n\n  // Compose the workspace key as `slug(title)-slug(version)`\n  // so the url will be like /workspace/acme/pets-api-1.0.0\n  const title = baseName.trim() || slug\n  const documentName = await generateUniqueSlug(`${title}-${version}`, new Set(Object.keys(documents)))\n\n  if (!documentName) {\n    return {\n      ok: false,\n      error: 'Failed to generate a unique name for the document',\n    }\n  }\n\n  // Add the document to the workspace store. The registry meta records the\n  // exact `version` we requested so subsequent lookups can match the local\n  // document back to the version row in the sidebar. We also persist the\n  // registry's commit hash (when the caller passed one) so later\n  // refreshes can detect when the registry has moved on and surface\n  // upstream changes to the user.\n  await workspaceStore.addDocument({\n    name: documentName,\n    document: result.data,\n    meta: {\n      'x-scalar-registry-meta': {\n        namespace,\n        slug,\n        version,\n        ...(commitHash ? { commitHash } : {}),\n      },\n    },\n  })\n\n  return { ok: true, documentName }\n}\n"],"mappings":";;;AASA,IAAa,uBAAuB,OAAO,EACzC,gBACA,SACA,WACA,MACA,UAAU,UACV,iBAqByC;CACzC,MAAM,YAAY,eAAe,UAAU;CAE3C,MAAM,WAAW,OAAO,QAAQ,UAAU,CAAC,MAAM,GAAG,SAAS;EAC3D,MAAM,OAAO,MAAM;AACnB,SAAO,MAAM,cAAc,aAAa,MAAM,SAAS,QAAQ,MAAM,YAAY;GACjF;AAEF,KAAI,SACF,QAAO;EAAE,IAAI;EAAM,cAAc,SAAS;EAAI;CAGhD,MAAM,SAAS,MAAM,QAAQ;EAAE;EAAW;EAAM;EAAS,CAAC;AAC1D,KAAI,CAAC,OAAO,GACV,QAAO;EACL,IAAI;EACJ,OAAO,6BAA6B,OAAO,SAAS;EACrD;CAUH,MAAM,eAAe,MAAM,mBAAmB,GAL7B,OADF,OAAO,EAAE,MAAM,OAAO,EAAE,OAAO,QAAQ,EAAE,CAAC,EAAE,CAAC,EAC5B,OAAO,KAAK,CAAC,KAAK,MAI3B,MAAM,IAAI,KACsB,GAAG,WAAW,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC;AAErG,KAAI,CAAC,aACH,QAAO;EACL,IAAI;EACJ,OAAO;EACR;AASH,OAAM,eAAe,YAAY;EAC/B,MAAM;EACN,UAAU,OAAO;EACjB,MAAM,EACJ,0BAA0B;GACxB;GACA;GACA;GACA,GAAI,aAAa,EAAE,YAAY,GAAG,EAAE;GACrC,EACF;EACF,CAAC;AAEF,QAAO;EAAE,IAAI;EAAM;EAAc"}

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

@@ -34,6 +34,10 @@ export type RouteProps = {
         id: string;
         label: string;
     };
+    /**
+     * Whether the active workspace is backed by a team (i.e. not the built-in `local` team).
+     */
+    isTeamWorkspace?: boolean;
     /** Client plugins */
     plugins: ClientPlugin[];
     /** Custom themes available to the team */
@@ -62,7 +66,7 @@ export type CollectionProps = RouteProps & ({
     collectionType: 'workspace';
     document: null;
 });
-export type ScalarClientAppRouteParams = 'namespace' | 'workspaceSlug' | 'documentSlug' | 'pathEncoded' | 'method' | 'exampleName';
+export type ScalarClientAppRouteParams = 'teamSlug' | 'workspaceSlug' | 'documentSlug' | 'pathEncoded' | 'method' | 'exampleName';
 /** Routes for the API client app and web, the same as modal + workspace routes */
 export declare const ROUTES: ({
     path: string;

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

@@ -16,7 +16,7 @@ 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",
+	path: "/@:teamSlug/:workspaceSlug",
 	children: [
 		{
 			path: "document/:documentSlug",

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

@@ -1 +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 { MaybeRefOrGetter } from 'vue'\nimport type { RouteRecordRaw } from 'vue-router'\n\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 GetStarted from '@/v2/features/collection/components/GetStarted.vue'\nimport Overview from '@/v2/features/collection/components/Overview.vue'\nimport { Runner } from '@/v2/features/collection/components/Runner'\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'\nimport type { ApiClientOptions } from '@/v2/types/options'\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 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  /** App or modal options forwarded to operation/auth blocks */\n  options?: MaybeRefOrGetter<ApiClientOptions>\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 scripts (pre-request / post-response)\n              {\n                name: 'document.scripts',\n                path: 'scripts',\n                component: () => import('@/v2/features/collection/components/Scripts.vue'),\n              },\n              // Document runner\n              {\n                name: 'document.runner',\n                path: 'runner',\n                component: Runner,\n              },\n              // Document settings\n              {\n                name: 'document.settings',\n                path: 'settings',\n                component: Settings,\n              },\n            ],\n          },\n        ],\n      },\n      // Workspace get started page (standalone, no workspace header or tabs)\n      {\n        name: 'workspace.get-started',\n        path: 'get-started',\n        component: GetStarted,\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":";;;;;;;;;;;;;;;;;AA8FA,IAAa,SAAS,CACpB;CACE,MAAM;CACN,UAAU;EACR;GACE,MAAM;GACN,UAAU,CAER;IACE,MAAM;IACN,UAAU,CACR;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACZ,EACD;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACX,UAAU,EACR,MAAM,sBACP;KACD,UAAU;MACR;OACE,MAAM;OACN,MAAM;OACN,WAAW;OACZ;MACD;OACE,MAAM;OACN,MAAM;OACN,WAAW;OACZ;MACD;OACE,MAAM;OACN,MAAM;OACN,WAAW;OACZ;MACD;OACE,MAAM;OACN,MAAM;OACN,WAAW;OACZ;MACF;KACF,CACF;IACF,EAED;IACE,MAAM;IACN,MAAM;IACN,WAAW;IACX,UAAU;KAER;MACE,MAAM;MACN,MAAM;MACN,UAAU,EACR,MAAM,qBACP;MACF;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,iBAAiB,OAAO;MACzB;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KACF;IACF,CACF;GACF;EAED;GACE,MAAM;GACN,MAAM;GACN,WAAW;GACZ;EAED;GACE,MAAM;GACN,MAAM;GACN,WAAW;GACX,UAAU;IAER;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;EACF;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"}
+{"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 { MaybeRefOrGetter } from 'vue'\nimport type { RouteRecordRaw } from 'vue-router'\n\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 GetStarted from '@/v2/features/collection/components/GetStarted.vue'\nimport Overview from '@/v2/features/collection/components/Overview.vue'\nimport { Runner } from '@/v2/features/collection/components/Runner'\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'\nimport type { ApiClientOptions } from '@/v2/types/options'\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 workspace store */\n  workspaceStore: WorkspaceStore\n  /** The currently active workspace */\n  activeWorkspace: { id: string; label: string }\n  /**\n   * Whether the active workspace is backed by a team (i.e. not the built-in `local` team).\n   */\n  isTeamWorkspace?: boolean\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  /** App or modal options forwarded to operation/auth blocks */\n  options?: MaybeRefOrGetter<ApiClientOptions>\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  | 'teamSlug'\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: '/@:teamSlug/: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 scripts (pre-request / post-response)\n              {\n                name: 'document.scripts',\n                path: 'scripts',\n                component: () => import('@/v2/features/collection/components/Scripts.vue'),\n              },\n              // Document runner\n              {\n                name: 'document.runner',\n                path: 'runner',\n                component: Runner,\n              },\n              // Document settings\n              {\n                name: 'document.settings',\n                path: 'settings',\n                component: Settings,\n              },\n            ],\n          },\n        ],\n      },\n      // Workspace get started page (standalone, no workspace header or tabs)\n      {\n        name: 'workspace.get-started',\n        path: 'get-started',\n        component: GetStarted,\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":";;;;;;;;;;;;;;;;;AAkGA,IAAa,SAAS,CACpB;CACE,MAAM;CACN,UAAU;EACR;GACE,MAAM;GACN,UAAU,CAER;IACE,MAAM;IACN,UAAU,CACR;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACZ,EACD;KACE,MAAM;KACN,MAAM;KACN,WAAW;KACX,UAAU,EACR,MAAM,sBACP;KACD,UAAU;MACR;OACE,MAAM;OACN,MAAM;OACN,WAAW;OACZ;MACD;OACE,MAAM;OACN,MAAM;OACN,WAAW;OACZ;MACD;OACE,MAAM;OACN,MAAM;OACN,WAAW;OACZ;MACD;OACE,MAAM;OACN,MAAM;OACN,WAAW;OACZ;MACF;KACF,CACF;IACF,EAED;IACE,MAAM;IACN,MAAM;IACN,WAAW;IACX,UAAU;KAER;MACE,MAAM;MACN,MAAM;MACN,UAAU,EACR,MAAM,qBACP;MACF;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,iBAAiB,OAAO;MACzB;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KAED;MACE,MAAM;MACN,MAAM;MACN,WAAW;MACZ;KACF;IACF,CACF;GACF;EAED;GACE,MAAM;GACN,MAAM;GACN,WAAW;GACZ;EAED;GACE,MAAM;GACN,MAAM;GACN,WAAW;GACX,UAAU;IAER;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;EACF;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/helpers/version-status-presentation.d.ts

@@ -0,0 +1,24 @@
+import { ScalarIconCloudCheck } from '@scalar/icons';
+import type { VersionStatus } from '../../../../v2/features/app/helpers/compute-version-status.js';
+/** Visual presentation for a single sync state. */
+type VersionStatusPresentation = {
+    /** Cloud-style icon component matching the swatch the design system uses for this state. */
+    icon: typeof ScalarIconCloudCheck;
+    /** Tailwind text colour class applied to the icon. */
+    class: string;
+    /** Human-readable description used as both the tooltip and the accessible label. */
+    label: string;
+};
+/**
+ * Visual mapping for every sync status surfaced by the registry workflow.
+ *
+ * The mapping is intentionally shared across surfaces (version picker rows,
+ * the right-side header indicator, future sync buttons / badges) so the icon
+ * and colour for a given state stay consistent everywhere it is rendered.
+ *
+ * Keep the presentation purely declarative — no behaviour, no event
+ * handlers — so it remains safe to import from any layer.
+ */
+export declare const VERSION_STATUS_PRESENTATION: Record<VersionStatus, VersionStatusPresentation>;
+export {};
+//# sourceMappingURL=version-status-presentation.d.ts.map

package/dist/v2/features/app/helpers/version-status-presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-status-presentation.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/version-status-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,oBAAoB,EAErB,MAAM,eAAe,CAAA;AAEtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kDAAkD,CAAA;AAErF,mDAAmD;AACnD,KAAK,yBAAyB,GAAG;IAC/B,4FAA4F;IAC5F,IAAI,EAAE,OAAO,oBAAoB,CAAA;IACjC,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,aAAa,EAAE,yBAAyB,CA0BxF,CAAA"}

package/dist/v2/features/app/helpers/version-status-presentation.js

@@ -0,0 +1,43 @@
+import { ScalarIconCloudArrowDown, ScalarIconCloudArrowUp, ScalarIconCloudCheck, ScalarIconCloudWarning } from "@scalar/icons";
+//#region src/v2/features/app/helpers/version-status-presentation.ts
+/**
+* Visual mapping for every sync status surfaced by the registry workflow.
+*
+* The mapping is intentionally shared across surfaces (version picker rows,
+* the right-side header indicator, future sync buttons / badges) so the icon
+* and colour for a given state stay consistent everywhere it is rendered.
+*
+* Keep the presentation purely declarative — no behaviour, no event
+* handlers — so it remains safe to import from any layer.
+*/
+var VERSION_STATUS_PRESENTATION = {
+	synced: {
+		icon: ScalarIconCloudCheck,
+		class: "text-green",
+		label: "Synced with the registry"
+	},
+	push: {
+		icon: ScalarIconCloudArrowUp,
+		class: "text-blue",
+		label: "Local changes ready to push"
+	},
+	pull: {
+		icon: ScalarIconCloudArrowDown,
+		class: "text-blue",
+		label: "Upstream changes available to pull"
+	},
+	conflict: {
+		icon: ScalarIconCloudWarning,
+		class: "text-orange",
+		label: "Conflicts detected — resolve before pulling"
+	},
+	unknown: {
+		icon: ScalarIconCloudCheck,
+		class: "text-c-3",
+		label: "Version not loaded"
+	}
+};
+//#endregion
+export { VERSION_STATUS_PRESENTATION };
+
+//# sourceMappingURL=version-status-presentation.js.map

package/dist/v2/features/app/helpers/version-status-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-status-presentation.js","names":[],"sources":["../../../../../src/v2/features/app/helpers/version-status-presentation.ts"],"sourcesContent":["import {\n  ScalarIconCloudArrowDown,\n  ScalarIconCloudArrowUp,\n  ScalarIconCloudCheck,\n  ScalarIconCloudWarning,\n} from '@scalar/icons'\n\nimport type { VersionStatus } from '@/v2/features/app/helpers/compute-version-status'\n\n/** Visual presentation for a single sync state. */\ntype VersionStatusPresentation = {\n  /** Cloud-style icon component matching the swatch the design system uses for this state. */\n  icon: typeof ScalarIconCloudCheck\n  /** Tailwind text colour class applied to the icon. */\n  class: string\n  /** Human-readable description used as both the tooltip and the accessible label. */\n  label: string\n}\n\n/**\n * Visual mapping for every sync status surfaced by the registry workflow.\n *\n * The mapping is intentionally shared across surfaces (version picker rows,\n * the right-side header indicator, future sync buttons / badges) so the icon\n * and colour for a given state stay consistent everywhere it is rendered.\n *\n * Keep the presentation purely declarative — no behaviour, no event\n * handlers — so it remains safe to import from any layer.\n */\nexport const VERSION_STATUS_PRESENTATION: Record<VersionStatus, VersionStatusPresentation> = {\n  synced: {\n    icon: ScalarIconCloudCheck,\n    class: 'text-green',\n    label: 'Synced with the registry',\n  },\n  push: {\n    icon: ScalarIconCloudArrowUp,\n    class: 'text-blue',\n    label: 'Local changes ready to push',\n  },\n  pull: {\n    icon: ScalarIconCloudArrowDown,\n    class: 'text-blue',\n    label: 'Upstream changes available to pull',\n  },\n  conflict: {\n    icon: ScalarIconCloudWarning,\n    class: 'text-orange',\n    label: 'Conflicts detected — resolve before pulling',\n  },\n  unknown: {\n    icon: ScalarIconCloudCheck,\n    class: 'text-c-3',\n    label: 'Version not loaded',\n  },\n}\n"],"mappings":";;;;;;;;;;;;AA6BA,IAAa,8BAAgF;CAC3F,QAAQ;EACN,MAAM;EACN,OAAO;EACP,OAAO;EACR;CACD,MAAM;EACJ,MAAM;EACN,OAAO;EACP,OAAO;EACR;CACD,MAAM;EACJ,MAAM;EACN,OAAO;EACP,OAAO;EACR;CACD,UAAU;EACR,MAAM;EACN,OAAO;EACP,OAAO;EACR;CACD,SAAS;EACP,MAAM;EACN,OAAO;EACP,OAAO;EACR;CACF"}

package/dist/v2/features/app/hooks/use-active-document-version.d.ts

@@ -0,0 +1,41 @@
+import { type ComputedRef } from 'vue';
+import type { AppState } from '../../../../v2/features/app/app-state.js';
+import { type RegistryDocumentsState, type SidebarDocumentItem, type SidebarDocumentVersion } from '../../../../v2/features/app/hooks/use-sidebar-documents.js';
+/**
+ * Resolves everything UI surfaces need to know about the document the user
+ * is currently viewing in a registry-backed workspace.
+ *
+ * The breadcrumb's version picker and the right-side sync indicator both
+ * need the same data:
+ *
+ *  - the sidebar item for the active group (so titles match the registry),
+ *  - the full version list for that group (used to render dropdown rows /
+ *    feed `useVersionConflictCheck`),
+ *  - and the currently active version (used for the picker selection and
+ *    the standalone status icon).
+ *
+ * Pulling this into a composable keeps both surfaces aligned and avoids
+ * duplicating the active-version selection rules — in particular the
+ * fallback to the version declared on `x-scalar-registry-meta` when the
+ * sidebar's notion of the active version has not caught up yet (e.g. during
+ * a pending fetch).
+ */
+export declare const useActiveDocumentVersion: ({ app, registryDocuments, }: {
+    app: AppState;
+    /** Reactive accessor — components pass a getter so the composable stays prop-driven. */
+    registryDocuments: () => RegistryDocumentsState;
+}) => {
+    documents: ComputedRef<SidebarDocumentItem[]>;
+    activeRegistryMeta: ComputedRef<{
+        namespace: string;
+        slug: string;
+        version?: string;
+        commitHash?: string;
+        conflictCheckedAgainstHash?: string;
+        hasConflict?: boolean;
+    } | undefined>;
+    activeItem: ComputedRef<SidebarDocumentItem | undefined>;
+    versions: ComputedRef<SidebarDocumentVersion[]>;
+    activeVersion: ComputedRef<SidebarDocumentVersion | undefined>;
+};
+//# sourceMappingURL=use-active-document-version.d.ts.map

package/dist/v2/features/app/hooks/use-active-document-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-active-document-version.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/hooks/use-active-document-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAY,MAAM,KAAK,CAAA;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAE5B,MAAM,+CAA+C,CAAA;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,wBAAwB,GAAI,6BAGtC;IACD,GAAG,EAAE,QAAQ,CAAA;IACb,wFAAwF;IACxF,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;CAChD,KAAG;IACF,SAAS,EAAE,WAAW,CAAC,mBAAmB,EAAE,CAAC,CAAA;IAC7C,kBAAkB,EAAE,WAAW,CAC3B;QACE,SAAS,EAAE,MAAM,CAAA;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,0BAA0B,CAAC,EAAE,MAAM,CAAA;QACnC,WAAW,CAAC,EAAE,OAAO,CAAA;KACtB,GACD,SAAS,CACZ,CAAA;IACD,UAAU,EAAE,WAAW,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;IACxD,QAAQ,EAAE,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAA;IAC/C,aAAa,EAAE,WAAW,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAA;CAqD/D,CAAA"}