@scalar/api-client 3.4.0 → 3.5.1

package/dist/v2/features/app/app-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-state.js","names":[],"sources":["../../../../src/v2/features/app/app-state.ts"],"sourcesContent":["import type { ScalarListboxOption, WorkspaceGroup } from '@scalar/components'\nimport { isDefined } from '@scalar/helpers/array/is-defined'\nimport { sortByOrder } from '@scalar/helpers/array/sort-by-order'\nimport type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport type { LoaderPlugin } from '@scalar/json-magic/bundle'\nimport { migrateLocalStorageToIndexDb } from '@scalar/oas-utils/migrations'\nimport { createSidebarState, generateReverseIndex } from '@scalar/sidebar'\nimport type { Theme } from '@scalar/themes'\nimport { type WorkspaceStore, createWorkspaceStore } from '@scalar/workspace-store/client'\nimport {\n  type OperationExampleMeta,\n  type WorkspaceEventBus,\n  createWorkspaceEventBus,\n} from '@scalar/workspace-store/events'\nimport { generateUniqueValue } from '@scalar/workspace-store/helpers/generate-unique-value'\nimport { getParentEntry } from '@scalar/workspace-store/navigation'\nimport { createWorkspaceStorePersistence, getWorkspaceId } from '@scalar/workspace-store/persistence'\nimport { persistencePlugin } from '@scalar/workspace-store/plugins/client'\nimport { getActiveEnvironment } from '@scalar/workspace-store/request-example'\nimport type { Workspace, WorkspaceDocument } from '@scalar/workspace-store/schemas'\nimport { extensions } from '@scalar/workspace-store/schemas/extensions'\nimport type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport type { Tab } from '@scalar/workspace-store/schemas/extensions/workspace/x-scalar-tabs'\nimport type { TraversedEntry } from '@scalar/workspace-store/schemas/navigation'\nimport {\n  type ComputedRef,\n  type MaybeRefOrGetter,\n  type Ref,\n  type ShallowRef,\n  computed,\n  readonly,\n  ref,\n  shallowRef,\n  watch,\n} from 'vue'\nimport type { RouteLocationNormalizedGeneric, RouteLocationRaw, Router } from 'vue-router'\n\nimport type { ApiClientAppOptions } from '@/v2/features/app/helpers/create-api-client-app'\nimport { getRouteParam } from '@/v2/features/app/helpers/get-route-param'\nimport { groupWorkspacesByTeam } from '@/v2/features/app/helpers/group-workspaces'\nimport { useTheme } from '@/v2/features/app/hooks/use-theme'\nimport { getTabDetails } from '@/v2/helpers/get-tab-details'\nimport { slugify } from '@/v2/helpers/slugify'\nimport { workspaceStorage } from '@/v2/helpers/storage'\n\nimport { initializeAppEventHandlers } from './app-events'\nimport { canLoadWorkspace, filterWorkspacesByTeam } from './helpers/filter-workspaces'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\nexport type GetEntryByLocation = (location: {\n  document: string\n  path?: string\n  method?: HttpMethod\n  example?: string\n}) =>\n  | (TraversedEntry & {\n      parent?: TraversedEntry | undefined\n    })\n  | undefined\n\ntype WorkspaceOption = ScalarListboxOption & { teamSlug: string; slug: string }\n\n/** Defines the overall application state structure and its main feature modules */\nexport type AppState = {\n  /** The workspace store */\n  store: ShallowRef<WorkspaceStore | null>\n  /** The sidebar management */\n  sidebar: {\n    /** The sidebar state */\n    state: ReturnType<typeof createSidebarState<TraversedEntry>>\n    /** The width of the sidebar */\n    width: ComputedRef<number>\n    /** Whether the sidebar is open */\n    isOpen: Ref<boolean>\n    /** Handles the selection of an item in the sidebar */\n    handleSelectItem: (id: string) => void\n    /** Handles the width update of the sidebar */\n    handleSidebarWidthUpdate: (width: number) => void\n    /** Gets the entry by location */\n    getEntryByLocation: GetEntryByLocation\n  }\n  /** The tabs management */\n  tabs: {\n    /** The tabs state */\n    state: Ref<Tab[]>\n    /** The active tab index */\n    activeTabIndex: Ref<number>\n    /** Copies the URL of the tab at the given index to the clipboard */\n    copyTabUrl: (index: number) => Promise<void>\n  }\n  /** The workspace management */\n  workspace: {\n    /** Creates a new workspace and navigates to it */\n    create: (payload: {\n      teamSlug?: string\n      slug?: string\n      name: string\n    }) => Promise<{ name: string; slug: string; teamSlug: string } | undefined>\n    /** All workspace list */\n    workspaceList: Ref<WorkspaceOption[]>\n    /** Filtered workspace list, based on the current teamSlug */\n    filteredWorkspaceList: ComputedRef<WorkspaceOption[]>\n    /**\n     * Groups workspaces into team and local categories for display in the workspace picker.\n     * Team workspaces are shown first (when not on local team), followed by local workspaces.\n     */\n    workspaceGroups: ComputedRef<WorkspaceGroup[]>\n    /** The currently active workspace */\n    activeWorkspace: ShallowRef<{ id: string; label: string } | null>\n    /** Navigates to the specified workspace */\n    navigateToWorkspace: (teamSlug?: string, slug?: string) => Promise<void>\n    /** Whether the workspace page is open */\n    isOpen: ComputedRef<boolean>\n    /**\n     * Whether the currently active workspace is a team workspace (i.e. has a\n     * `teamUid` other than `'local'`). Useful for gating team-only UI such as\n     * the registry-backed document list and its loading state.\n     */\n    isTeamWorkspace: ComputedRef<boolean>\n  }\n  /** The workspace event bus for handling workspace-level events */\n  eventBus: WorkspaceEventBus\n  /** The router instance */\n  router: Router\n  /** The current route derived from the router */\n  currentRoute: Ref<RouteLocationNormalizedGeneric | null>\n  /** Whether the workspace is currently syncing */\n  loading: Ref<boolean>\n  /** Runtime behaviour overrides */\n  options?: ApiClientAppOptions\n  /** The currently active entities */\n  activeEntities: {\n    /** The slug identifying the current workspace */\n    workspaceSlug: Ref<string | undefined>\n    /** The slug of the currently selected document in the workspace */\n    documentSlug: Ref<string | undefined>\n    /** The API path currently selected (e.g. \"/users/{id}\") */\n    path: Ref<string | undefined>\n    /** The HTTP method for the currently selected API path (e.g. GET, POST) */\n    method: Ref<HttpMethod | undefined>\n    /** The name of the currently selected example (for examples within an endpoint) */\n    exampleName: Ref<string | undefined>\n    /** The slug of the selected team context (read-only; use setTeamSlug to change) */\n    teamSlug: Readonly<Ref<string>>\n    /** Sets the current team context by team slug */\n    setTeamSlug: (value: string) => void\n  }\n  /** The currently active environment */\n  environment: ComputedRef<XScalarEnvironment>\n  /** The currently active document */\n  document: ComputedRef<WorkspaceDocument | null>\n  /** Whether the current color mode is dark */\n  isDarkMode: ComputedRef<boolean>\n  /** The currently active theme */\n  theme: {\n    /** The computed CSS styles for the current theme, as a string */\n    styles: ComputedRef<{ themeStyles: string; themeSlug: string }>\n    /** The computed value for the <style> tag containing the current theme styles */\n    themeStyleTag: ComputedRef<string>\n    /** The custom themes to use */\n    customThemes: MaybeRefOrGetter<Theme[]>\n  }\n  telemetry: Ref<boolean>\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n/** Default debounce delay in milliseconds for workspace store persistence. */\nconst DEFAULT_DEBOUNCE_DELAY = 1000\n/** Default sidebar width in pixels. */\nconst DEFAULT_SIDEBAR_WIDTH = 288\n/** Default slug used when auto-creating a team workspace on demand. */\nexport const DEFAULT_TEAM_WORKSPACE_SLUG = 'default'\n/** Default display name used when auto-creating a team workspace on demand. */\nconst DEFAULT_TEAM_WORKSPACE_NAME = 'Workspace'\n/**\n * Temporary kill switch for team workspace functionality.\n *\n * While the team workspace experience is still being polished we hide the\n * \"Team Workspaces\" group from the picker and refuse to create new team\n * workspaces. Existing team workspaces remain in storage and can be restored\n * by flipping this flag back to `true`.\n */\nexport const TEAM_WORKSPACES_ENABLED = false\n\n// ---------------------------------------------------------------------------\n// App State\n// ---------------------------------------------------------------------------\nexport const createAppState = async ({\n  router,\n  fileLoader,\n  fallbackThemeSlug = () => 'default',\n  customThemes = () => [],\n  telemetryDefault,\n  options,\n}: {\n  router: Router\n  fileLoader?: LoaderPlugin\n  customThemes?: MaybeRefOrGetter<Theme[]>\n  fallbackThemeSlug?: MaybeRefOrGetter<string>\n  telemetryDefault?: boolean\n  /** Runtime behaviour overrides */\n  options?: ApiClientAppOptions\n}): Promise<AppState> => {\n  /** Workspace event bus for handling workspace-level events. */\n  const eventBus = createWorkspaceEventBus({\n    debug: import.meta.env.DEV,\n  })\n\n  const { workspace: persistence } = await createWorkspaceStorePersistence()\n\n  /**\n   * Run migration from localStorage to IndexedDB if needed\n   * This happens once per user and transforms old data structure to new workspace format\n   */\n  await migrateLocalStorageToIndexDb()\n\n  // ---------------------------------------------------------------------------\n  // Active entities\n  // ---------------------------------------------------------------------------\n  // Currently selected team context. Drives workspace filtering and team switching.\n  const teamSlug = ref<string>('local')\n  // Team slug parsed from the current URL (the `@teamSlug` segment). Stays in sync with the route.\n  const routeTeamSlug = ref<string | undefined>(undefined)\n  const workspaceSlug = ref<string | undefined>(undefined)\n  const documentSlug = ref<string | undefined>(undefined)\n  const method = ref<HttpMethod | undefined>(undefined)\n  const path = ref<string | undefined>(undefined)\n  const exampleName = ref<string | undefined>(undefined)\n\n  // ---------------------------------------------------------------------------\n  // Loading states\n  const isSyncingWorkspace = ref(false)\n\n  // ---------------------------------------------------------------------------\n  // Router state\n  router.afterEach((to) => handleRouteChange(to))\n  const currentRoute = computed(() => router.currentRoute.value ?? null)\n\n  // ---------------------------------------------------------------------------\n  // Workspace persistence state management\n  const activeWorkspace = shallowRef<{ id: string; label: string } | null>(null)\n  const workspaces = ref<WorkspaceOption[]>([])\n  const filteredWorkspaces = computed(() => filterWorkspacesByTeam(workspaces.value, teamSlug.value))\n  const workspaceGroups = computed(() => {\n    // While team workspaces are disabled we render the picker as if the user\n    // were always on the local team. This hides the \"Team Workspaces\" section\n    // (and any placeholder option) without removing the underlying data, so\n    // re-enabling the feature is a one-line change.\n    if (!TEAM_WORKSPACES_ENABLED) {\n      return groupWorkspacesByTeam(filteredWorkspaces.value, 'local')\n    }\n\n    return groupWorkspacesByTeam(filteredWorkspaces.value, teamSlug.value, {\n      // Surface a fake default workspace for non-local teams so logged-in\n      // users always see a team workspace entry in the picker. Clicking it\n      // navigates to a normal workspace route; the route handler creates the\n      // workspace on demand when it does not yet exist.\n      placeholder: {\n        slug: DEFAULT_TEAM_WORKSPACE_SLUG,\n        label: DEFAULT_TEAM_WORKSPACE_NAME,\n      },\n    })\n  })\n  /**\n   * `true` when the active workspace is backed by a team (i.e. not the\n   * built-in `'local'` team). We look the workspace up in the full\n   * `workspaces` list because `activeWorkspace` only stores `{ id, label }`,\n   * whereas `WorkspaceOption` carries the `teamUid` we need. Consumers can\n   * read this via `app.workspace.isTeamWorkspace` to gate team-only UI.\n   */\n  const isTeamWorkspace = computed(() => {\n    const id = activeWorkspace.value?.id\n    if (!id) {\n      return false\n    }\n    const workspace = workspaces.value.find((w) => w.id === id)\n    return Boolean(workspace && workspace.teamSlug !== 'local')\n  })\n  const store = shallowRef<WorkspaceStore | null>(null)\n\n  // Load persisted telemetry preference, falling back to the provided default\n  const persistedTelemetry = workspaceStorage.getTelemetry()\n  const telemetry = ref(persistedTelemetry !== null ? persistedTelemetry : Boolean(telemetryDefault))\n  watch(telemetry, (value) => workspaceStorage.setTelemetry(value))\n\n  const activeDocument = computed(() => {\n    return store.value?.workspace.documents[documentSlug.value ?? ''] || null\n  })\n\n  /**\n   * Merged environment variables from workspace and document levels.\n   * Variables from both sources are combined, with document variables\n   * taking precedence in case of naming conflicts.\n   */\n  const environment = computed<XScalarEnvironment>(\n    () => getActiveEnvironment(store.value, activeDocument.value).environment,\n  )\n\n  /** Update the workspace list when the component is mounted */\n  workspaces.value = await persistence.getAll().then((w) =>\n    w.map(({ teamSlug, slug, name }) => ({\n      id: getWorkspaceId(teamSlug, slug),\n      teamSlug,\n      slug,\n      label: name,\n    })),\n  )\n\n  /**\n   * Renames the currently active workspace.\n   * Updates the workspace name in persistence and updates activeWorkspace if successful.\n   * Returns early if team slug or workspaceSlug is not set, or if update fails.\n   */\n  const renameWorkspace = async (name: string) => {\n    const teamSlugValue = routeTeamSlug.value\n    const slugValue = workspaceSlug.value\n    if (!teamSlugValue || !slugValue) {\n      return\n    }\n    const workspaceId = getWorkspaceId(teamSlugValue, slugValue)\n    const updateResult = await persistence.updateName({ teamSlug: teamSlugValue, slug: slugValue }, name)\n\n    // If `the update fails, return early\n    if (updateResult === undefined) {\n      return\n    }\n\n    // Update the workspace list\n    workspaces.value = workspaces.value.map((workspace) => {\n      // If the workspace is the currently active workspace, update the label\n      if (workspace.id === workspaceId) {\n        return { ...workspace, label: name }\n      }\n      return workspace\n    })\n    activeWorkspace.value = { id: workspaceId, label: name }\n  }\n\n  /**\n   * Creates a client-side workspace store with persistence enabled for the given workspace id.\n   */\n  const createClientStore = async ({ teamSlug, slug }: { teamSlug: string; slug: string }): Promise<WorkspaceStore> => {\n    return createWorkspaceStore({\n      plugins: [\n        await persistencePlugin({\n          workspaceId: getWorkspaceId(teamSlug, slug),\n          debounceDelay: DEFAULT_DEBOUNCE_DELAY,\n        }),\n      ],\n      fileLoader,\n      fetch: options?.customFetch,\n    })\n  }\n\n  /**\n   * Attempts to load and activate a workspace by id.\n   * Returns true when the workspace was found and activated.\n   */\n  const loadWorkspace = async (\n    teamSlug: string,\n    slug: string,\n  ): Promise<{ success: true; workspace: Workspace } | { success: false }> => {\n    const workspace = await persistence.getItem({ teamSlug, slug })\n\n    if (!workspace) {\n      return {\n        success: false,\n      }\n    }\n\n    const client = await createClientStore({ teamSlug, slug })\n    client.loadWorkspace(workspace.workspace)\n    activeWorkspace.value = { id: getWorkspaceId(workspace.teamSlug, workspace.slug), label: workspace.name }\n    store.value = client\n\n    return {\n      success: true,\n      workspace: client.workspace,\n    }\n  }\n\n  /**\n   * Creates and persists the default workspace with a blank draft document.\n   * Used when no workspaces exist yet.\n   */\n  const createAndPersistWorkspace = async ({\n    name,\n    teamSlug,\n    slug,\n  }: {\n    name: string\n    teamSlug?: string\n    slug: string\n  }) => {\n    const draftStore = createWorkspaceStore()\n    await draftStore.addDocument({\n      name: 'drafts',\n      document: {\n        openapi: '3.1.0',\n        info: {\n          title: 'Drafts',\n          version: '1.0.0',\n        },\n        paths: {\n          '/': {\n            get: {\n              summary: 'First Request',\n            },\n          },\n        },\n        'x-scalar-original-document-hash': 'drafts',\n        'x-scalar-icon': 'interface-edit-tool-pencil',\n      },\n    })\n\n    // Persist the workspace\n    const workspace = await persistence.setItem(\n      { teamSlug, slug },\n      {\n        name: name,\n        workspace: draftStore.exportWorkspace(),\n      },\n    )\n\n    // Update the workspace list\n    workspaces.value.push({\n      id: getWorkspaceId(workspace.teamSlug, workspace.slug),\n      teamSlug: workspace.teamSlug,\n      slug: workspace.slug,\n      label: workspace.name,\n    })\n    return workspace\n  }\n\n  /**\n   * Navigates to the overview page of the specified workspace.\n   *\n   * @param teamSlug - The slug of the team that owns the workspace (used as the URL `@teamSlug` segment).\n   * @param slug - The unique workspace slug (identifier).\n   */\n  const navigateToWorkspace = async (teamSlug?: string, slug?: string): Promise<void> => {\n    if (!teamSlug || !slug) {\n      await router.push('/')\n      return\n    }\n\n    // We should always have this drafts document available in a new workspace\n    await router.push({\n      name: 'example',\n      params: {\n        teamSlug,\n        workspaceSlug: slug,\n        documentSlug: 'drafts',\n        pathEncoded: encodeURIComponent('/'),\n        method: 'get',\n        exampleName: 'default',\n      },\n    })\n  }\n\n  /**\n   * Creates a new workspace with the provided name.\n   * - Generates a unique slug for the workspace (uses the provided slug if it is unique, otherwise generates a unique slug).\n   * - Adds a default blank document (\"drafts\") to the workspace.\n   * - Persists the workspace and navigates to it.\n   *\n   * Example usage:\n   *   await createWorkspace({ name: 'My Awesome API' })\n   *   // -> Navigates to /workspace/my-awesome-api (if available)\n   */\n  const createWorkspace = async ({ teamSlug, slug, name }: { teamSlug?: string; slug?: string; name: string }) => {\n    // Block team workspace creation while the feature is disabled. If a team\n    // workspace already exists we silently navigate to it (e.g. when the route\n    // handler tries to auto-create on demand); otherwise we fall back to the\n    // local default so the user lands somewhere usable.\n    if (!TEAM_WORKSPACES_ENABLED && teamSlug && teamSlug !== 'local') {\n      const existing = workspaces.value.find((w) => w.teamSlug === teamSlug)\n      if (existing) {\n        await navigateToWorkspace(existing.teamSlug, existing.slug)\n        return { teamSlug: existing.teamSlug, slug: existing.slug, name: existing.label }\n      }\n      console.warn('Team workspace creation is currently disabled. Falling back to the local default workspace.')\n      await navigateToWorkspace('local', 'default')\n      return undefined\n    }\n\n    // Restrict users to a single workspace per team. Local workspaces remain\n    // unrestricted. This guard is temporary while multi-workspace support for\n    // teams is being designed. When a team workspace already exists, navigate\n    // to it instead of creating a duplicate.\n    if (teamSlug && teamSlug !== 'local') {\n      const existing = workspaces.value.find((w) => w.teamSlug === teamSlug)\n      if (existing) {\n        console.warn(`A workspace already exists for team \"${teamSlug}\". Navigating to the existing workspace instead.`)\n        await navigateToWorkspace(existing.teamSlug, existing.slug)\n        return { teamSlug: existing.teamSlug, slug: existing.slug, name: existing.label }\n      }\n    }\n\n    // Clear up the current store, in order to show the loading state\n    store.value = null\n\n    // Generate a unique slug/id for the workspace, based on the name.\n    const newWorkspaceSlug = await generateUniqueValue({\n      defaultValue: slug ?? name, // Use the provided id if it exists, otherwise use the name\n      validation: async (value) => !(await persistence.has({ teamSlug: teamSlug ?? 'local', slug: value })),\n      maxRetries: 100,\n      transformation: slugify,\n    })\n\n    // Failed to generate a unique workspace id, so we can't create the workspace.\n    if (!newWorkspaceSlug) {\n      return undefined\n    }\n\n    const newWorkspaceDetails = {\n      teamSlug,\n      slug: newWorkspaceSlug,\n      name,\n    }\n\n    // Create a new client store with the workspace ID and add a default document.\n    const createdWorkspace = await createAndPersistWorkspace(newWorkspaceDetails)\n\n    // Navigate to the newly created workspace.\n    await navigateToWorkspace(createdWorkspace.teamSlug, createdWorkspace.slug)\n    return createdWorkspace\n  }\n\n  /**\n   * Handles changing the active workspace when the workspace slug changes in the route.\n   * This function:\n   *  - Clears the current workspace store and sets loading state.\n   *  - Attempts to load the workspace by slug.\n   *    - If found, navigates to the active tab path (if available).\n   *    - If not found, creates the default workspace and navigates to it.\n   */\n  const changeWorkspace = async (teamSlug: string, slug: string, to?: RouteLocationNormalizedGeneric) => {\n    /** For initial load we want to fall through to our router default behaviour */\n    const isInitialLoad = activeWorkspace.value === null\n\n    // Clear the current store and set loading to true before loading new workspace.\n    store.value = null\n    isSyncingWorkspace.value = true\n\n    // Try to load the workspace\n    const result = await loadWorkspace(teamSlug, slug)\n\n    if (result.success) {\n      // Navigate to the correct tab if the workspace has a tab already\n      const index = result.workspace['x-scalar-active-tab'] ?? 0\n      const tabs = result.workspace['x-scalar-tabs']\n      const tab = tabs?.[index]\n\n      // On initial load let the URL-based routing (catch-all → getLastPath) take precedence\n      if (tab && !isInitialLoad) {\n        // Preserve query parameters when navigating to the active tab\n        await router.replace({\n          path: tab.path,\n          query: currentRoute.value?.query ?? {},\n        })\n      }\n\n      // Heal the active tab index if it is out of bounds\n      if (tabs && index >= tabs.length) {\n        eventBus.emit('tabs:update:tabs', {\n          'x-scalar-active-tab': 0,\n        })\n      }\n\n      // Initialize the tabs if they does not exist\n      if (!tabs) {\n        eventBus.emit('tabs:update:tabs', {\n          'x-scalar-tabs': [createTabFromRoute(currentRoute.value)],\n          'x-scalar-active-tab': 0,\n        })\n      }\n\n      // On initial load the router.replace above is skipped, so syncTabs/syncSidebar\n      // are never reached via handleRouteChange's normal flow. Call them here to\n      // align the tab bar and sidebar with the URL-based route.\n      if (isInitialLoad && to) {\n        syncTabs(to)\n        syncSidebar(to)\n      }\n\n      isSyncingWorkspace.value = false\n      return\n    }\n\n    // Navigate to the default workspace, or fall back to the first available workspace\n    const targetWorkspace =\n      filteredWorkspaces.value.find((workspace) => workspace.teamSlug === 'local' && workspace.slug === 'default') ??\n      filteredWorkspaces.value[0]\n\n    if (targetWorkspace) {\n      return navigateToWorkspace(targetWorkspace.teamSlug, targetWorkspace.slug)\n    }\n\n    // If loading failed (workspace does not exist), create the default workspace and navigate to it.\n    const createResult = await createWorkspace({\n      name: 'Default Workspace',\n      slug: 'default',\n    })\n\n    isSyncingWorkspace.value = false\n\n    if (!createResult) {\n      return console.error('Failed to create the default workspace, something went wrong, can not load the workspace')\n    }\n\n    // Must reset the sidebar state when the workspace changes\n    sidebarState.reset()\n  }\n\n  /**\n   * Sets the current team context. If the active workspace is not accessible\n   * with the new team, navigates to the default workspace for that team.\n   */\n  const setTeamSlug = (value: string) => {\n    // Update the active team slug.\n    teamSlug.value = value\n\n    // Find the workspace that matches the current route.\n    const workspace = filteredWorkspaces.value.find(\n      (w) => w.teamSlug === routeTeamSlug.value && w.slug === workspaceSlug.value,\n    )\n\n    // Check if the new team slug is accessible to the current workspace.\n    if (workspace && canLoadWorkspace(workspace.teamSlug, value)) {\n      return\n    }\n\n    // When the user is on a workspace on another team or the workspace is not accessible, redirect to the default workspace.\n    return navigateToWorkspace('local', 'default')\n  }\n\n  // ---------------------------------------------------------------------------\n  // Sidebar state management\n\n  const entries = computed(() => {\n    const activeStore = store.value\n    if (!activeStore) {\n      return []\n    }\n\n    const order = activeStore.workspace['x-scalar-order'] ?? Object.keys(activeStore.workspace.documents)\n\n    return sortByOrder(Object.keys(activeStore.workspace.documents), order, (item) => item)\n      .map((doc) => activeStore.workspace.documents[doc]?.['x-scalar-navigation'])\n      .filter(isDefined) as TraversedEntry[]\n  })\n\n  const sidebarState = createSidebarState(entries)\n\n  /**\n   * Generates a unique string ID for an API location, based on the document, path, method, and example.\n   * Filters out undefined values and serializes the composite array into a stable string.\n   *\n   * @param params - An object containing document, path, method, and optional example name.\n   * @returns A stringified array representing the unique location identifier.\n   *\n   * Example:\n   *   generateId({ document: 'mydoc', path: '/users', method: 'get', example: 'default' })\n   *   // => '[\"mydoc\",\"/users\",\"get\",\"default\"]'\n   */\n  const generateId = ({\n    document,\n    path,\n    method,\n    example,\n  }: {\n    document: string\n    path?: string\n    method?: HttpMethod\n    example?: string\n  }) => {\n    return JSON.stringify([document, path, method, example].filter(isDefined))\n  }\n\n  /**\n   * Computed index for fast lookup of sidebar nodes by their unique API location.\n   *\n   * - Only indexes nodes of type 'document', 'operation', or 'example'.\n   * - The lookup key is a serialized array of: [documentName, operationPath, operationMethod, exampleName?].\n   * - Supports precise resolution of sidebar entries given an API \"location\".\n   */\n  const locationIndex = computed(() =>\n    generateReverseIndex({\n      items: entries.value,\n      nestedKey: 'children',\n      filter: (node) => node.type === 'document' || node.type === 'operation' || node.type === 'example',\n      getId: (node) => {\n        const document = getParentEntry('document', node)\n        const operation = getParentEntry('operation', node)\n        return generateId({\n          document: document?.name ?? '',\n          path: operation?.path,\n          method: operation?.method,\n          example: node.type === 'example' ? node.name : undefined,\n        })\n      },\n    }),\n  )\n\n  /**\n   * Looks up a sidebar entry by its unique API location.\n   * - First tries to find an entry matching all provided properties (including example).\n   * - If not found, falls back to matching only the operation (ignores example field).\n   * This allows resolving either examples, operations, or documents as appropriate.\n   *\n   * @param location - Object specifying the document name, path, method, and optional example name.\n   * @returns The matching sidebar entry, or undefined if none found.\n   *\n   * Example:\n   *   const entry = getEntryByLocation({\n   *     document: 'pets',\n   *     path: '/pets',\n   *     method: 'get',\n   *     example: 'default',\n   *   })\n   */\n  const getEntryByLocation: GetEntryByLocation = (location) => {\n    // Try to find an entry with the most-specific location (including example)\n    const entryWithExample = locationIndex.value.get(generateId(location))\n\n    if (entryWithExample) {\n      return entryWithExample\n    }\n\n    // Fallback to the operation (ignoring example) if an example wasn't found or specified\n    return locationIndex.value.get(\n      generateId({\n        document: location.document,\n        path: location.path,\n        method: location.method,\n      }),\n    )\n  }\n\n  /**\n   * Handles item selection from the sidebar and routes navigation accordingly.\n   *\n   * Example:\n   *   handleSelectItem('id-of-entry')\n   */\n  const handleSelectItem = (id: string) => {\n    const entry = sidebarState.getEntryById(id)\n\n    if (!entry) {\n      console.warn(`Could not find sidebar entry with id ${id} to select`)\n      return\n    }\n\n    /** Close sidebar and navigate. Used for every branch that performs navigation. */\n    const navigate = (route: RouteLocationRaw) => {\n      isSidebarOpen.value = false\n      return router.push(route)\n    }\n\n    // Navigate to the document overview page\n    if (entry.type === 'document') {\n      // If we are already in the document, just toggle expansion\n      if (sidebarState.selectedItem.value === id) {\n        sidebarState.setExpanded(id, !sidebarState.isExpanded(id))\n        return\n      }\n\n      // Otherwise, select it\n      sidebarState.setSelected(id)\n      sidebarState.setExpanded(id, true)\n      return navigate({\n        name: 'document.overview',\n        params: { documentSlug: entry.name },\n      })\n    }\n\n    // Navigate to the example page\n    if (entry.type === 'operation') {\n      // If we are already in an operation child we just want to toggle the explanstion\n      if (sidebarState.isSelected(id) && sidebarState.selectedItem.value !== id) {\n        sidebarState.setExpanded(id, !sidebarState.isExpanded(id))\n        return\n      }\n\n      // Otherwise, select the first example\n      const firstExample = entry.children?.find((child) => child.type === 'example')\n\n      if (firstExample) {\n        sidebarState.setSelected(firstExample.id)\n        sidebarState.setExpanded(firstExample.id, true)\n      } else {\n        sidebarState.setSelected(id)\n      }\n\n      return navigate({\n        name: 'example',\n        params: {\n          documentSlug: getParentEntry('document', entry)?.name,\n          pathEncoded: encodeURIComponent(entry.path),\n          method: entry.method,\n          exampleName: firstExample?.name ?? 'default',\n        },\n      })\n    }\n\n    // Navigate to the example page\n    if (entry.type === 'example') {\n      sidebarState.setSelected(id)\n      const operation = getParentEntry('operation', entry)\n      return navigate({\n        name: 'example',\n        params: {\n          documentSlug: getParentEntry('document', entry)?.name,\n          pathEncoded: encodeURIComponent(operation?.path ?? ''),\n          method: operation?.method,\n          exampleName: entry.name,\n        },\n      })\n    }\n\n    if (entry.type === 'text') {\n      return navigate({\n        name: 'document.overview',\n        params: {\n          documentSlug: getParentEntry('document', entry)?.name,\n        },\n      })\n    }\n\n    sidebarState.setExpanded(id, !sidebarState.isExpanded(id))\n    return\n  }\n\n  /**\n   * Navigates to the currently active tab's path using the router.\n   * Returns early if the workspace store or active tab is unavailable.\n   */\n  const navigateToCurrentTab = async (): Promise<void> => {\n    if (!store.value) {\n      return\n    }\n\n    const activeTabIndex = store.value.workspace['x-scalar-active-tab'] ?? 0\n    const activeTab = store.value.workspace['x-scalar-tabs']?.[activeTabIndex]\n    if (!activeTab) {\n      return\n    }\n\n    await router.replace(activeTab.path)\n  }\n\n  /**\n   * Rebuilds the sidebar for the given document.\n   * This is used to refresh the sidebar state after structural changes (e.g. after adding or removing items).\n   *\n   * @param documentName - The name (id) of the document for which to rebuild the sidebar\n   */\n  const rebuildSidebar = (documentName: string | undefined) => {\n    if (documentName) {\n      store.value?.buildSidebar(documentName)\n    }\n  }\n\n  /**\n   * Ensures the sidebar is refreshed after a new example is created.\n   *\n   * If the sidebar entry for the new example does not exist or is of a different type,\n   * this will rebuild the sidebar for the current document. This helps keep the sidebar state\n   * consistent (e.g., after adding a new example via the UI).\n   */\n  const refreshSidebarAfterExampleCreation = (payload: OperationExampleMeta & { documentName?: string }) => {\n    const documentName = payload.documentName ?? activeDocument.value?.['x-scalar-navigation']?.name\n    if (!documentName) {\n      return\n    }\n\n    const entry = getEntryByLocation({\n      document: documentName,\n      path: payload.path,\n      method: payload.method,\n      example: payload.exampleKey,\n    })\n\n    if (!entry || entry.type !== 'example') {\n      // Sidebar entry for this example doesn't exist, so rebuild sidebar for consistency.\n      rebuildSidebar(documentName)\n      if (currentRoute.value) {\n        syncSidebar(currentRoute.value)\n      }\n    }\n    return\n  }\n\n  /** Width of the sidebar, with fallback to default. */\n  const sidebarWidth = computed(() => store.value?.workspace?.['x-scalar-sidebar-width'] ?? DEFAULT_SIDEBAR_WIDTH)\n\n  /** Handler for sidebar width changes. */\n  const handleSidebarWidthUpdate = (width: number) => store.value?.update('x-scalar-sidebar-width', width)\n\n  /** Controls the visibility of the sidebar. */\n  const isSidebarOpen = ref(false)\n  // ---------------------------------------------------------------------------\n  // Tab Management\n\n  /** Constants for workspace store keys */\n  const TABS_KEY = 'x-scalar-tabs' as const\n  const ACTIVE_TAB_KEY = 'x-scalar-active-tab' as const\n\n  /**\n   * Creates a tab object based on the current route and workspace state.\n   * Used as a fallback when no tabs exist or when creating new tabs.\n   */\n  const createTabFromRoute = (to: RouteLocationNormalizedGeneric | null): Tab => {\n    const method = getRouteParam('method', to)\n    const path = getRouteParam('pathEncoded', to)\n    const document = getRouteParam('documentSlug', to)\n    const workspace = getRouteParam('workspaceSlug', to)\n    return {\n      ...getTabDetails({\n        workspace,\n        document,\n        path,\n        method,\n        getEntryByLocation,\n      }),\n      path: currentRoute.value?.path ?? '',\n    }\n  }\n\n  const tabs = computed(() => {\n    return store.value?.workspace[TABS_KEY] ?? [createTabFromRoute(currentRoute.value)]\n  })\n\n  const activeTabIndex = computed(() => {\n    return store.value?.workspace[ACTIVE_TAB_KEY] ?? 0\n  })\n\n  /**\n   * Copies the URL of the tab at the given index to the clipboard.\n   * Constructs the full URL using the current origin and the tab path.\n   *\n   * Note: Will silently fail if clipboard API is unavailable or the tab does not exist.\n   */\n  const copyTabUrl = async (index: number): Promise<void> => {\n    const tab = tabs.value[index]\n\n    if (!tab) {\n      console.warn(`Cannot copy URL: tab at index ${index} does not exist`)\n      return\n    }\n\n    const url = `${window.location.origin}${tab.path}`\n\n    try {\n      await navigator.clipboard.writeText(url)\n    } catch (error) {\n      console.error('Failed to copy URL to clipboard:', error)\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Path syncing\n\n  /** When the route changes we need to update the active entities in the store */\n  const handleRouteChange = (to: RouteLocationNormalizedGeneric) => {\n    const slug = getRouteParam('workspaceSlug', to)\n    const document = getRouteParam('documentSlug', to)\n    const nextTeamSlug = getRouteParam('teamSlug', to)\n\n    // Must have an active workspace to syncs\n    if (!nextTeamSlug || !slug) {\n      return\n    }\n\n    // Try to see if the user can load this workspace based on the team slug.\n    const workspace = workspaces.value.find(\n      (workspace) => workspace.slug === slug && workspace.teamSlug === nextTeamSlug,\n    )\n\n    // If the workspace exists but is not accessible by the current team, redirect to the default workspace.\n    if (workspace && !canLoadWorkspace(workspace.teamSlug, teamSlug.value)) {\n      return navigateToWorkspace('local', 'default')\n    }\n\n    routeTeamSlug.value = nextTeamSlug\n    workspaceSlug.value = slug\n    documentSlug.value = document\n    method.value = getRouteParam('method', to)\n    path.value = getRouteParam('pathEncoded', to)\n    exampleName.value = getRouteParam('exampleName', to)\n\n    // Save the current path to the persistence storage\n    if (to.path !== '') {\n      workspaceStorage.setCurrentPath(to.path)\n    }\n\n    if (getWorkspaceId(nextTeamSlug, slug) !== activeWorkspace.value?.id) {\n      // If the user is navigating into their team context but the team\n      // workspace does not exist yet (e.g. they clicked the picker placeholder\n      // or are being redirected on login), create it on demand before letting\n      // the workspace switcher take over. Otherwise `changeWorkspace` would\n      // fall back to the local default and silently swallow the navigation.\n      const isUnknownTeamWorkspace = nextTeamSlug !== 'local' && nextTeamSlug === teamSlug.value && !workspace\n      if (isUnknownTeamWorkspace) {\n        return createWorkspace({\n          teamSlug: nextTeamSlug,\n          slug,\n          name: DEFAULT_TEAM_WORKSPACE_NAME,\n        })\n      }\n      return changeWorkspace(nextTeamSlug, slug, to)\n    }\n\n    // Update the active document if the document slug has changes\n    if (document && document !== store.value?.workspace[extensions.workspace.activeDocument]) {\n      store?.value?.update('x-scalar-active-document', document)\n    }\n\n    syncTabs(to)\n    syncSidebar(to)\n    return\n  }\n\n  /** Aligns the tabs with any potential slug changes */\n  const syncTabs = (to: RouteLocationNormalizedGeneric) => {\n    const tabs = store.value?.workspace['x-scalar-tabs'] ?? []\n    const index = store.value?.workspace['x-scalar-active-tab'] ?? 0\n\n    const tab = tabs[index]\n\n    // If there is no tab or the tab path is the same we leave the tab state alone\n    if (!tab || tab.path === to.path) {\n      // Already on the correct path, do nothing\n      return\n    }\n\n    // Otherwise we replace the tab content with the new route\n    tabs[index] = createTabFromRoute(to)\n  }\n\n  /** Aligns the sidebar state with any potential slug changes */\n  const syncSidebar = (to: RouteLocationNormalizedGeneric) => {\n    const document = getRouteParam('documentSlug', to)\n\n    if (!document) {\n      // Reset selection if no document is selected\n      sidebarState.setSelected(null)\n      return\n    }\n\n    const entry = getEntryByLocation({\n      document,\n      path: getRouteParam('pathEncoded', to),\n      method: getRouteParam('method', to),\n      example: getRouteParam('exampleName', to),\n    })\n\n    if (entry) {\n      sidebarState.setSelected(entry.id)\n      sidebarState.setExpanded(entry.id, true)\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Events handling\n\n  initializeAppEventHandlers({\n    eventBus,\n    router,\n    store,\n    navigateToCurrentTab,\n    rebuildSidebar,\n    onAfterExampleCreation: refreshSidebarAfterExampleCreation,\n    onSelectSidebarItem: handleSelectItem,\n    onCopyTabUrl: (index) => copyTabUrl(index),\n    onToggleSidebar: () => (isSidebarOpen.value = !isSidebarOpen.value),\n    closeSidebar: () => (isSidebarOpen.value = false),\n    renameWorkspace,\n  })\n\n  const theme = useTheme({\n    fallbackThemeSlug,\n    customThemes,\n    store: store,\n  })\n\n  const isDarkMode = computed(() => {\n    const colorMode = store.value?.workspace['x-scalar-color-mode'] ?? 'system'\n    if (colorMode === 'system') {\n      return window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ?? false\n    }\n    return colorMode === 'dark'\n  })\n\n  return {\n    /** Active workspace store */\n    store,\n    sidebar: {\n      state: sidebarState,\n      width: sidebarWidth,\n      isOpen: isSidebarOpen,\n      handleSelectItem,\n      handleSidebarWidthUpdate,\n      getEntryByLocation,\n    },\n    tabs: {\n      state: tabs,\n      activeTabIndex,\n      copyTabUrl,\n    },\n    workspace: {\n      create: createWorkspace,\n      workspaceList: workspaces,\n      filteredWorkspaceList: filteredWorkspaces,\n      workspaceGroups,\n      activeWorkspace,\n      navigateToWorkspace,\n      isOpen: computed(() => Boolean(workspaceSlug.value && !documentSlug.value)),\n      isTeamWorkspace,\n    },\n    eventBus,\n    router,\n    currentRoute,\n    loading: isSyncingWorkspace,\n    activeEntities: {\n      workspaceSlug,\n      documentSlug,\n      path,\n      method,\n      exampleName,\n      teamSlug: readonly(teamSlug),\n      setTeamSlug,\n    },\n    environment,\n    document: activeDocument,\n    isDarkMode,\n    theme: {\n      styles: theme.themeStyles,\n      themeStyleTag: theme.themeStyleTag,\n      customThemes,\n    },\n    telemetry,\n    options,\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-state.js","names":[],"sources":["../../../../src/v2/features/app/app-state.ts"],"sourcesContent":["import type { ScalarListboxOption, WorkspaceGroup } from '@scalar/components'\nimport { isDefined } from '@scalar/helpers/array/is-defined'\nimport { sortByOrder } from '@scalar/helpers/array/sort-by-order'\nimport type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { slugify } from '@scalar/helpers/string/slugify'\nimport type { LoaderPlugin } from '@scalar/json-magic/bundle'\nimport { migrateLocalStorageToIndexDb } from '@scalar/oas-utils/migrations'\nimport { createSidebarState, generateReverseIndex } from '@scalar/sidebar'\nimport type { Theme } from '@scalar/themes'\nimport { type WorkspaceStore, createWorkspaceStore } from '@scalar/workspace-store/client'\nimport {\n  type OperationExampleMeta,\n  type WorkspaceEventBus,\n  createWorkspaceEventBus,\n} from '@scalar/workspace-store/events'\nimport { generateUniqueValue } from '@scalar/workspace-store/helpers/generate-unique-value'\nimport { getParentEntry } from '@scalar/workspace-store/navigation'\nimport { createWorkspaceStorePersistence, getWorkspaceId } from '@scalar/workspace-store/persistence'\nimport { persistencePlugin } from '@scalar/workspace-store/plugins/client'\nimport { getActiveEnvironment } from '@scalar/workspace-store/request-example'\nimport type { Workspace, WorkspaceDocument } from '@scalar/workspace-store/schemas'\nimport { extensions } from '@scalar/workspace-store/schemas/extensions'\nimport type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport type { Tab } from '@scalar/workspace-store/schemas/extensions/workspace/x-scalar-tabs'\nimport type { TraversedEntry } from '@scalar/workspace-store/schemas/navigation'\nimport {\n  type ComputedRef,\n  type MaybeRefOrGetter,\n  type Ref,\n  type ShallowRef,\n  computed,\n  readonly,\n  ref,\n  shallowRef,\n  watch,\n} from 'vue'\nimport type { RouteLocationNormalizedGeneric, RouteLocationRaw, Router } from 'vue-router'\n\nimport type { ApiClientAppOptions } from '@/v2/features/app/helpers/create-api-client-app'\nimport { getRouteParam } from '@/v2/features/app/helpers/get-route-param'\nimport { groupWorkspacesByTeam } from '@/v2/features/app/helpers/group-workspaces'\nimport { useTheme } from '@/v2/features/app/hooks/use-theme'\nimport { getTabDetails } from '@/v2/helpers/get-tab-details'\nimport { workspaceStorage } from '@/v2/helpers/storage'\n\nimport { initializeAppEventHandlers } from './app-events'\nimport { canLoadWorkspace, filterWorkspacesByTeam } from './helpers/filter-workspaces'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\nexport type GetEntryByLocation = (location: {\n  document: string\n  path?: string\n  method?: HttpMethod\n  example?: string\n}) =>\n  | (TraversedEntry & {\n      parent?: TraversedEntry | undefined\n    })\n  | undefined\n\ntype WorkspaceOption = ScalarListboxOption & { teamSlug: string; slug: string }\n\n/** Defines the overall application state structure and its main feature modules */\nexport type AppState = {\n  /** The workspace store */\n  store: ShallowRef<WorkspaceStore | null>\n  /** The sidebar management */\n  sidebar: {\n    /** The sidebar state */\n    state: ReturnType<typeof createSidebarState<TraversedEntry>>\n    /** The width of the sidebar */\n    width: ComputedRef<number>\n    /** Whether the sidebar is open */\n    isOpen: Ref<boolean>\n    /** Handles the selection of an item in the sidebar */\n    handleSelectItem: (id: string) => void\n    /** Handles the width update of the sidebar */\n    handleSidebarWidthUpdate: (width: number) => void\n    /** Gets the entry by location */\n    getEntryByLocation: GetEntryByLocation\n  }\n  /** The tabs management */\n  tabs: {\n    /** The tabs state */\n    state: Ref<Tab[]>\n    /** The active tab index */\n    activeTabIndex: Ref<number>\n    /** Copies the URL of the tab at the given index to the clipboard */\n    copyTabUrl: (index: number) => Promise<void>\n  }\n  /** The workspace management */\n  workspace: {\n    /** Creates a new workspace and navigates to it */\n    create: (payload: {\n      teamSlug?: string\n      slug?: string\n      name: string\n    }) => Promise<{ name: string; slug: string; teamSlug: string } | undefined>\n    /** All workspace list */\n    workspaceList: Ref<WorkspaceOption[]>\n    /** Filtered workspace list, based on the current teamSlug */\n    filteredWorkspaceList: ComputedRef<WorkspaceOption[]>\n    /**\n     * Groups workspaces into team and local categories for display in the workspace picker.\n     * Team workspaces are shown first (when not on local team), followed by local workspaces.\n     */\n    workspaceGroups: ComputedRef<WorkspaceGroup[]>\n    /** The currently active workspace */\n    activeWorkspace: ShallowRef<{ id: string; label: string } | null>\n    /** Navigates to the specified workspace */\n    navigateToWorkspace: (teamSlug?: string, slug?: string) => Promise<void>\n    /** Whether the workspace page is open */\n    isOpen: ComputedRef<boolean>\n    /**\n     * Whether the currently active workspace is a team workspace (i.e. has a\n     * `teamUid` other than `'local'`). Useful for gating team-only UI such as\n     * the registry-backed document list and its loading state.\n     */\n    isTeamWorkspace: ComputedRef<boolean>\n  }\n  /** The workspace event bus for handling workspace-level events */\n  eventBus: WorkspaceEventBus\n  /** The router instance */\n  router: Router\n  /** The current route derived from the router */\n  currentRoute: Ref<RouteLocationNormalizedGeneric | null>\n  /** Whether the workspace is currently syncing */\n  loading: Ref<boolean>\n  /** Runtime behaviour overrides */\n  options?: ApiClientAppOptions\n  /** The currently active entities */\n  activeEntities: {\n    /** The slug identifying the current workspace */\n    workspaceSlug: Ref<string | undefined>\n    /** The slug of the currently selected document in the workspace */\n    documentSlug: Ref<string | undefined>\n    /** The API path currently selected (e.g. \"/users/{id}\") */\n    path: Ref<string | undefined>\n    /** The HTTP method for the currently selected API path (e.g. GET, POST) */\n    method: Ref<HttpMethod | undefined>\n    /** The name of the currently selected example (for examples within an endpoint) */\n    exampleName: Ref<string | undefined>\n    /** The slug of the selected team context (read-only; use setTeamSlug to change) */\n    teamSlug: Readonly<Ref<string>>\n    /** Sets the current team context by team slug */\n    setTeamSlug: (value: string) => void\n  }\n  /** The currently active environment */\n  environment: ComputedRef<XScalarEnvironment>\n  /** The currently active document */\n  document: ComputedRef<WorkspaceDocument | null>\n  /** Whether the current color mode is dark */\n  isDarkMode: ComputedRef<boolean>\n  /** The currently active theme */\n  theme: {\n    /** The computed CSS styles for the current theme, as a string */\n    styles: ComputedRef<{ themeStyles: string; themeSlug: string }>\n    /** The computed value for the <style> tag containing the current theme styles */\n    themeStyleTag: ComputedRef<string>\n    /** The custom themes to use */\n    customThemes: MaybeRefOrGetter<Theme[]>\n  }\n  telemetry: Ref<boolean>\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n/** Default debounce delay in milliseconds for workspace store persistence. */\nconst DEFAULT_DEBOUNCE_DELAY = 1000\n/** Default sidebar width in pixels. */\nconst DEFAULT_SIDEBAR_WIDTH = 288\n/** Default slug used when auto-creating a team workspace on demand. */\nexport const DEFAULT_TEAM_WORKSPACE_SLUG = 'default'\n/** Default display name used when auto-creating a team workspace on demand. */\nconst DEFAULT_TEAM_WORKSPACE_NAME = 'Workspace'\n/**\n * Temporary kill switch for team workspace functionality.\n *\n * While the team workspace experience is still being polished we hide the\n * \"Team Workspaces\" group from the picker and refuse to create new team\n * workspaces. Existing team workspaces remain in storage and can be restored\n * by flipping this flag back to `true`.\n */\nexport const TEAM_WORKSPACES_ENABLED = false\n\n// ---------------------------------------------------------------------------\n// App State\n// ---------------------------------------------------------------------------\nexport const createAppState = async ({\n  router,\n  fileLoader,\n  fallbackThemeSlug = () => 'default',\n  customThemes = () => [],\n  telemetryDefault,\n  options,\n}: {\n  router: Router\n  fileLoader?: LoaderPlugin\n  customThemes?: MaybeRefOrGetter<Theme[]>\n  fallbackThemeSlug?: MaybeRefOrGetter<string>\n  telemetryDefault?: boolean\n  /** Runtime behaviour overrides */\n  options?: ApiClientAppOptions\n}): Promise<AppState> => {\n  /** Workspace event bus for handling workspace-level events. */\n  const eventBus = createWorkspaceEventBus({\n    debug: import.meta.env.DEV,\n  })\n\n  const { workspace: persistence } = await createWorkspaceStorePersistence()\n\n  /**\n   * Run migration from localStorage to IndexedDB if needed\n   * This happens once per user and transforms old data structure to new workspace format\n   */\n  await migrateLocalStorageToIndexDb()\n\n  // ---------------------------------------------------------------------------\n  // Active entities\n  // ---------------------------------------------------------------------------\n  // Currently selected team context. Drives workspace filtering and team switching.\n  const teamSlug = ref<string>('local')\n  // Team slug parsed from the current URL (the `@teamSlug` segment). Stays in sync with the route.\n  const routeTeamSlug = ref<string | undefined>(undefined)\n  const workspaceSlug = ref<string | undefined>(undefined)\n  const documentSlug = ref<string | undefined>(undefined)\n  const method = ref<HttpMethod | undefined>(undefined)\n  const path = ref<string | undefined>(undefined)\n  const exampleName = ref<string | undefined>(undefined)\n\n  // ---------------------------------------------------------------------------\n  // Loading states\n  const isSyncingWorkspace = ref(false)\n\n  // ---------------------------------------------------------------------------\n  // Router state\n  router.afterEach((to) => handleRouteChange(to))\n  const currentRoute = computed(() => router.currentRoute.value ?? null)\n\n  // ---------------------------------------------------------------------------\n  // Workspace persistence state management\n  const activeWorkspace = shallowRef<{ id: string; label: string } | null>(null)\n  const workspaces = ref<WorkspaceOption[]>([])\n  const filteredWorkspaces = computed(() => filterWorkspacesByTeam(workspaces.value, teamSlug.value))\n  const workspaceGroups = computed(() => {\n    // While team workspaces are disabled we render the picker as if the user\n    // were always on the local team. This hides the \"Team Workspaces\" section\n    // (and any placeholder option) without removing the underlying data, so\n    // re-enabling the feature is a one-line change.\n    if (!TEAM_WORKSPACES_ENABLED) {\n      return groupWorkspacesByTeam(filteredWorkspaces.value, 'local')\n    }\n\n    return groupWorkspacesByTeam(filteredWorkspaces.value, teamSlug.value, {\n      // Surface a fake default workspace for non-local teams so logged-in\n      // users always see a team workspace entry in the picker. Clicking it\n      // navigates to a normal workspace route; the route handler creates the\n      // workspace on demand when it does not yet exist.\n      placeholder: {\n        slug: DEFAULT_TEAM_WORKSPACE_SLUG,\n        label: DEFAULT_TEAM_WORKSPACE_NAME,\n      },\n    })\n  })\n  /**\n   * `true` when the active workspace is backed by a team (i.e. not the\n   * built-in `'local'` team). We look the workspace up in the full\n   * `workspaces` list because `activeWorkspace` only stores `{ id, label }`,\n   * whereas `WorkspaceOption` carries the `teamUid` we need. Consumers can\n   * read this via `app.workspace.isTeamWorkspace` to gate team-only UI.\n   */\n  const isTeamWorkspace = computed(() => {\n    const id = activeWorkspace.value?.id\n    if (!id) {\n      return false\n    }\n    const workspace = workspaces.value.find((w) => w.id === id)\n    return Boolean(workspace && workspace.teamSlug !== 'local')\n  })\n  const store = shallowRef<WorkspaceStore | null>(null)\n\n  // Load persisted telemetry preference, falling back to the provided default\n  const persistedTelemetry = workspaceStorage.getTelemetry()\n  const telemetry = ref(persistedTelemetry !== null ? persistedTelemetry : Boolean(telemetryDefault))\n  watch(telemetry, (value) => workspaceStorage.setTelemetry(value))\n\n  const activeDocument = computed(() => {\n    return store.value?.workspace.documents[documentSlug.value ?? ''] || null\n  })\n\n  /**\n   * Merged environment variables from workspace and document levels.\n   * Variables from both sources are combined, with document variables\n   * taking precedence in case of naming conflicts.\n   */\n  const environment = computed<XScalarEnvironment>(\n    () => getActiveEnvironment(store.value, activeDocument.value).environment,\n  )\n\n  /** Update the workspace list when the component is mounted */\n  workspaces.value = await persistence.getAll().then((w) =>\n    w.map(({ teamSlug, slug, name }) => ({\n      id: getWorkspaceId(teamSlug, slug),\n      teamSlug,\n      slug,\n      label: name,\n    })),\n  )\n\n  /**\n   * Renames the currently active workspace.\n   * Updates the workspace name in persistence and updates activeWorkspace if successful.\n   * Returns early if team slug or workspaceSlug is not set, or if update fails.\n   */\n  const renameWorkspace = async (name: string) => {\n    const teamSlugValue = routeTeamSlug.value\n    const slugValue = workspaceSlug.value\n    if (!teamSlugValue || !slugValue) {\n      return\n    }\n    const workspaceId = getWorkspaceId(teamSlugValue, slugValue)\n    const updateResult = await persistence.updateName({ teamSlug: teamSlugValue, slug: slugValue }, name)\n\n    // If `the update fails, return early\n    if (updateResult === undefined) {\n      return\n    }\n\n    // Update the workspace list\n    workspaces.value = workspaces.value.map((workspace) => {\n      // If the workspace is the currently active workspace, update the label\n      if (workspace.id === workspaceId) {\n        return { ...workspace, label: name }\n      }\n      return workspace\n    })\n    activeWorkspace.value = { id: workspaceId, label: name }\n  }\n\n  /**\n   * Creates a client-side workspace store with persistence enabled for the given workspace id.\n   */\n  const createClientStore = async ({ teamSlug, slug }: { teamSlug: string; slug: string }): Promise<WorkspaceStore> => {\n    return createWorkspaceStore({\n      plugins: [\n        await persistencePlugin({\n          workspaceId: getWorkspaceId(teamSlug, slug),\n          debounceDelay: DEFAULT_DEBOUNCE_DELAY,\n        }),\n      ],\n      fileLoader,\n      fetch: options?.customFetch,\n    })\n  }\n\n  /**\n   * Attempts to load and activate a workspace by id.\n   * Returns true when the workspace was found and activated.\n   */\n  const loadWorkspace = async (\n    teamSlug: string,\n    slug: string,\n  ): Promise<{ success: true; workspace: Workspace } | { success: false }> => {\n    const workspace = await persistence.getItem({ teamSlug, slug })\n\n    if (!workspace) {\n      return {\n        success: false,\n      }\n    }\n\n    const client = await createClientStore({ teamSlug, slug })\n    client.loadWorkspace(workspace.workspace)\n    activeWorkspace.value = { id: getWorkspaceId(workspace.teamSlug, workspace.slug), label: workspace.name }\n    store.value = client\n\n    return {\n      success: true,\n      workspace: client.workspace,\n    }\n  }\n\n  /**\n   * Creates and persists the default workspace with a blank draft document.\n   * Used when no workspaces exist yet.\n   */\n  const createAndPersistWorkspace = async ({\n    name,\n    teamSlug,\n    slug,\n  }: {\n    name: string\n    teamSlug?: string\n    slug: string\n  }) => {\n    const draftStore = createWorkspaceStore()\n    await draftStore.addDocument({\n      name: 'drafts',\n      document: {\n        openapi: '3.1.0',\n        info: {\n          title: 'Drafts',\n          version: '1.0.0',\n        },\n        paths: {\n          '/': {\n            get: {\n              summary: 'First Request',\n            },\n          },\n        },\n        'x-scalar-original-document-hash': 'drafts',\n        'x-scalar-icon': 'interface-edit-tool-pencil',\n      },\n    })\n\n    // Persist the workspace\n    const workspace = await persistence.setItem(\n      { teamSlug, slug },\n      {\n        name: name,\n        workspace: draftStore.exportWorkspace(),\n      },\n    )\n\n    // Update the workspace list\n    workspaces.value.push({\n      id: getWorkspaceId(workspace.teamSlug, workspace.slug),\n      teamSlug: workspace.teamSlug,\n      slug: workspace.slug,\n      label: workspace.name,\n    })\n    return workspace\n  }\n\n  /**\n   * Navigates to the overview page of the specified workspace.\n   *\n   * @param teamSlug - The slug of the team that owns the workspace (used as the URL `@teamSlug` segment).\n   * @param slug - The unique workspace slug (identifier).\n   */\n  const navigateToWorkspace = async (teamSlug?: string, slug?: string): Promise<void> => {\n    if (!teamSlug || !slug) {\n      await router.push('/')\n      return\n    }\n\n    // We should always have this drafts document available in a new workspace\n    await router.push({\n      name: 'example',\n      params: {\n        teamSlug,\n        workspaceSlug: slug,\n        documentSlug: 'drafts',\n        pathEncoded: encodeURIComponent('/'),\n        method: 'get',\n        exampleName: 'default',\n      },\n    })\n  }\n\n  /**\n   * Creates a new workspace with the provided name.\n   * - Generates a unique slug for the workspace (uses the provided slug if it is unique, otherwise generates a unique slug).\n   * - Adds a default blank document (\"drafts\") to the workspace.\n   * - Persists the workspace and navigates to it.\n   *\n   * Example usage:\n   *   await createWorkspace({ name: 'My Awesome API' })\n   *   // -> Navigates to /workspace/my-awesome-api (if available)\n   */\n  const createWorkspace = async ({ teamSlug, slug, name }: { teamSlug?: string; slug?: string; name: string }) => {\n    // Block team workspace creation while the feature is disabled. If a team\n    // workspace already exists we silently navigate to it (e.g. when the route\n    // handler tries to auto-create on demand); otherwise we fall back to the\n    // local default so the user lands somewhere usable.\n    if (!TEAM_WORKSPACES_ENABLED && teamSlug && teamSlug !== 'local') {\n      const existing = workspaces.value.find((w) => w.teamSlug === teamSlug)\n      if (existing) {\n        await navigateToWorkspace(existing.teamSlug, existing.slug)\n        return { teamSlug: existing.teamSlug, slug: existing.slug, name: existing.label }\n      }\n      console.warn('Team workspace creation is currently disabled. Falling back to the local default workspace.')\n      await navigateToWorkspace('local', 'default')\n      return undefined\n    }\n\n    // Restrict users to a single workspace per team. Local workspaces remain\n    // unrestricted. This guard is temporary while multi-workspace support for\n    // teams is being designed. When a team workspace already exists, navigate\n    // to it instead of creating a duplicate.\n    if (teamSlug && teamSlug !== 'local') {\n      const existing = workspaces.value.find((w) => w.teamSlug === teamSlug)\n      if (existing) {\n        console.warn(`A workspace already exists for team \"${teamSlug}\". Navigating to the existing workspace instead.`)\n        await navigateToWorkspace(existing.teamSlug, existing.slug)\n        return { teamSlug: existing.teamSlug, slug: existing.slug, name: existing.label }\n      }\n    }\n\n    // Clear up the current store, in order to show the loading state\n    store.value = null\n\n    // Generate a unique slug/id for the workspace, based on the name.\n    const newWorkspaceSlug = await generateUniqueValue({\n      defaultValue: slug ?? name, // Use the provided id if it exists, otherwise use the name\n      validation: async (value) => !(await persistence.has({ teamSlug: teamSlug ?? 'local', slug: value })),\n      maxRetries: 100,\n      transformation: slugify,\n    })\n\n    // Failed to generate a unique workspace id, so we can't create the workspace.\n    if (!newWorkspaceSlug) {\n      return undefined\n    }\n\n    const newWorkspaceDetails = {\n      teamSlug,\n      slug: newWorkspaceSlug,\n      name,\n    }\n\n    // Create a new client store with the workspace ID and add a default document.\n    const createdWorkspace = await createAndPersistWorkspace(newWorkspaceDetails)\n\n    // Navigate to the newly created workspace.\n    await navigateToWorkspace(createdWorkspace.teamSlug, createdWorkspace.slug)\n    return createdWorkspace\n  }\n\n  /**\n   * Handles changing the active workspace when the workspace slug changes in the route.\n   * This function:\n   *  - Clears the current workspace store and sets loading state.\n   *  - Attempts to load the workspace by slug.\n   *    - If found, navigates to the active tab path (if available).\n   *    - If not found, creates the default workspace and navigates to it.\n   */\n  const changeWorkspace = async (teamSlug: string, slug: string, to?: RouteLocationNormalizedGeneric) => {\n    /** For initial load we want to fall through to our router default behaviour */\n    const isInitialLoad = activeWorkspace.value === null\n\n    // Clear the current store and set loading to true before loading new workspace.\n    store.value = null\n    isSyncingWorkspace.value = true\n\n    // Try to load the workspace\n    const result = await loadWorkspace(teamSlug, slug)\n\n    if (result.success) {\n      // Navigate to the correct tab if the workspace has a tab already\n      const index = result.workspace['x-scalar-active-tab'] ?? 0\n      const tabs = result.workspace['x-scalar-tabs']\n      const tab = tabs?.[index]\n\n      // On initial load let the URL-based routing (catch-all → getLastPath) take precedence\n      if (tab && !isInitialLoad) {\n        // Preserve query parameters when navigating to the active tab\n        await router.replace({\n          path: tab.path,\n          query: currentRoute.value?.query ?? {},\n        })\n      }\n\n      // Heal the active tab index if it is out of bounds\n      if (tabs && index >= tabs.length) {\n        eventBus.emit('tabs:update:tabs', {\n          'x-scalar-active-tab': 0,\n        })\n      }\n\n      // Initialize the tabs if they does not exist\n      if (!tabs) {\n        eventBus.emit('tabs:update:tabs', {\n          'x-scalar-tabs': [createTabFromRoute(currentRoute.value)],\n          'x-scalar-active-tab': 0,\n        })\n      }\n\n      // On initial load the router.replace above is skipped, so syncTabs/syncSidebar\n      // are never reached via handleRouteChange's normal flow. Call them here to\n      // align the tab bar and sidebar with the URL-based route.\n      if (isInitialLoad && to) {\n        syncTabs(to)\n        syncSidebar(to)\n      }\n\n      isSyncingWorkspace.value = false\n      return\n    }\n\n    // Navigate to the default workspace, or fall back to the first available workspace\n    const targetWorkspace =\n      filteredWorkspaces.value.find((workspace) => workspace.teamSlug === 'local' && workspace.slug === 'default') ??\n      filteredWorkspaces.value[0]\n\n    if (targetWorkspace) {\n      return navigateToWorkspace(targetWorkspace.teamSlug, targetWorkspace.slug)\n    }\n\n    // If loading failed (workspace does not exist), create the default workspace and navigate to it.\n    const createResult = await createWorkspace({\n      name: 'Default Workspace',\n      slug: 'default',\n    })\n\n    isSyncingWorkspace.value = false\n\n    if (!createResult) {\n      return console.error('Failed to create the default workspace, something went wrong, can not load the workspace')\n    }\n\n    // Must reset the sidebar state when the workspace changes\n    sidebarState.reset()\n  }\n\n  /**\n   * Sets the current team context. If the active workspace is not accessible\n   * with the new team, navigates to the default workspace for that team.\n   */\n  const setTeamSlug = (value: string) => {\n    // Update the active team slug.\n    teamSlug.value = value\n\n    // Find the workspace that matches the current route.\n    const workspace = filteredWorkspaces.value.find(\n      (w) => w.teamSlug === routeTeamSlug.value && w.slug === workspaceSlug.value,\n    )\n\n    // Check if the new team slug is accessible to the current workspace.\n    if (workspace && canLoadWorkspace(workspace.teamSlug, value)) {\n      return\n    }\n\n    // When the user is on a workspace on another team or the workspace is not accessible, redirect to the default workspace.\n    return navigateToWorkspace('local', 'default')\n  }\n\n  // ---------------------------------------------------------------------------\n  // Sidebar state management\n\n  const entries = computed(() => {\n    const activeStore = store.value\n    if (!activeStore) {\n      return []\n    }\n\n    const order = activeStore.workspace['x-scalar-order'] ?? Object.keys(activeStore.workspace.documents)\n\n    return sortByOrder(Object.keys(activeStore.workspace.documents), order, (item) => item)\n      .map((doc) => activeStore.workspace.documents[doc]?.['x-scalar-navigation'])\n      .filter(isDefined) as TraversedEntry[]\n  })\n\n  const sidebarState = createSidebarState(entries)\n\n  /**\n   * Generates a unique string ID for an API location, based on the document, path, method, and example.\n   * Filters out undefined values and serializes the composite array into a stable string.\n   *\n   * @param params - An object containing document, path, method, and optional example name.\n   * @returns A stringified array representing the unique location identifier.\n   *\n   * Example:\n   *   generateId({ document: 'mydoc', path: '/users', method: 'get', example: 'default' })\n   *   // => '[\"mydoc\",\"/users\",\"get\",\"default\"]'\n   */\n  const generateId = ({\n    document,\n    path,\n    method,\n    example,\n  }: {\n    document: string\n    path?: string\n    method?: HttpMethod\n    example?: string\n  }) => {\n    return JSON.stringify([document, path, method, example].filter(isDefined))\n  }\n\n  /**\n   * Computed index for fast lookup of sidebar nodes by their unique API location.\n   *\n   * - Only indexes nodes of type 'document', 'operation', or 'example'.\n   * - The lookup key is a serialized array of: [documentName, operationPath, operationMethod, exampleName?].\n   * - Supports precise resolution of sidebar entries given an API \"location\".\n   */\n  const locationIndex = computed(() =>\n    generateReverseIndex({\n      items: entries.value,\n      nestedKey: 'children',\n      filter: (node) => node.type === 'document' || node.type === 'operation' || node.type === 'example',\n      getId: (node) => {\n        const document = getParentEntry('document', node)\n        const operation = getParentEntry('operation', node)\n        return generateId({\n          document: document?.name ?? '',\n          path: operation?.path,\n          method: operation?.method,\n          example: node.type === 'example' ? node.name : undefined,\n        })\n      },\n    }),\n  )\n\n  /**\n   * Looks up a sidebar entry by its unique API location.\n   * - First tries to find an entry matching all provided properties (including example).\n   * - If not found, falls back to matching only the operation (ignores example field).\n   * This allows resolving either examples, operations, or documents as appropriate.\n   *\n   * @param location - Object specifying the document name, path, method, and optional example name.\n   * @returns The matching sidebar entry, or undefined if none found.\n   *\n   * Example:\n   *   const entry = getEntryByLocation({\n   *     document: 'pets',\n   *     path: '/pets',\n   *     method: 'get',\n   *     example: 'default',\n   *   })\n   */\n  const getEntryByLocation: GetEntryByLocation = (location) => {\n    // Try to find an entry with the most-specific location (including example)\n    const entryWithExample = locationIndex.value.get(generateId(location))\n\n    if (entryWithExample) {\n      return entryWithExample\n    }\n\n    // Fallback to the operation (ignoring example) if an example wasn't found or specified\n    return locationIndex.value.get(\n      generateId({\n        document: location.document,\n        path: location.path,\n        method: location.method,\n      }),\n    )\n  }\n\n  /**\n   * Handles item selection from the sidebar and routes navigation accordingly.\n   *\n   * Example:\n   *   handleSelectItem('id-of-entry')\n   */\n  const handleSelectItem = (id: string) => {\n    const entry = sidebarState.getEntryById(id)\n\n    if (!entry) {\n      console.warn(`Could not find sidebar entry with id ${id} to select`)\n      return\n    }\n\n    /** Close sidebar and navigate. Used for every branch that performs navigation. */\n    const navigate = (route: RouteLocationRaw) => {\n      isSidebarOpen.value = false\n      return router.push(route)\n    }\n\n    // Navigate to the document overview page\n    if (entry.type === 'document') {\n      // If we are already in the document, just toggle expansion\n      if (sidebarState.selectedItem.value === id) {\n        sidebarState.setExpanded(id, !sidebarState.isExpanded(id))\n        return\n      }\n\n      // Otherwise, select it\n      sidebarState.setSelected(id)\n      sidebarState.setExpanded(id, true)\n      return navigate({\n        name: 'document.overview',\n        params: { documentSlug: entry.name },\n      })\n    }\n\n    // Navigate to the example page\n    if (entry.type === 'operation') {\n      // If we are already in an operation child we just want to toggle the explanstion\n      if (sidebarState.isSelected(id) && sidebarState.selectedItem.value !== id) {\n        sidebarState.setExpanded(id, !sidebarState.isExpanded(id))\n        return\n      }\n\n      // Otherwise, select the first example\n      const firstExample = entry.children?.find((child) => child.type === 'example')\n\n      if (firstExample) {\n        sidebarState.setSelected(firstExample.id)\n        sidebarState.setExpanded(firstExample.id, true)\n      } else {\n        sidebarState.setSelected(id)\n      }\n\n      return navigate({\n        name: 'example',\n        params: {\n          documentSlug: getParentEntry('document', entry)?.name,\n          pathEncoded: encodeURIComponent(entry.path),\n          method: entry.method,\n          exampleName: firstExample?.name ?? 'default',\n        },\n      })\n    }\n\n    // Navigate to the example page\n    if (entry.type === 'example') {\n      sidebarState.setSelected(id)\n      const operation = getParentEntry('operation', entry)\n      return navigate({\n        name: 'example',\n        params: {\n          documentSlug: getParentEntry('document', entry)?.name,\n          pathEncoded: encodeURIComponent(operation?.path ?? ''),\n          method: operation?.method,\n          exampleName: entry.name,\n        },\n      })\n    }\n\n    if (entry.type === 'text') {\n      return navigate({\n        name: 'document.overview',\n        params: {\n          documentSlug: getParentEntry('document', entry)?.name,\n        },\n      })\n    }\n\n    sidebarState.setExpanded(id, !sidebarState.isExpanded(id))\n    return\n  }\n\n  /**\n   * Navigates to the currently active tab's path using the router.\n   * Returns early if the workspace store or active tab is unavailable.\n   */\n  const navigateToCurrentTab = async (): Promise<void> => {\n    if (!store.value) {\n      return\n    }\n\n    const activeTabIndex = store.value.workspace['x-scalar-active-tab'] ?? 0\n    const activeTab = store.value.workspace['x-scalar-tabs']?.[activeTabIndex]\n    if (!activeTab) {\n      return\n    }\n\n    await router.replace(activeTab.path)\n  }\n\n  /**\n   * Rebuilds the sidebar for the given document.\n   * This is used to refresh the sidebar state after structural changes (e.g. after adding or removing items).\n   *\n   * @param documentName - The name (id) of the document for which to rebuild the sidebar\n   */\n  const rebuildSidebar = (documentName: string | undefined) => {\n    if (documentName) {\n      store.value?.buildSidebar(documentName)\n    }\n  }\n\n  /**\n   * Ensures the sidebar is refreshed after a new example is created.\n   *\n   * If the sidebar entry for the new example does not exist or is of a different type,\n   * this will rebuild the sidebar for the current document. This helps keep the sidebar state\n   * consistent (e.g., after adding a new example via the UI).\n   */\n  const refreshSidebarAfterExampleCreation = (payload: OperationExampleMeta & { documentName?: string }) => {\n    const documentName = payload.documentName ?? activeDocument.value?.['x-scalar-navigation']?.name\n    if (!documentName) {\n      return\n    }\n\n    const entry = getEntryByLocation({\n      document: documentName,\n      path: payload.path,\n      method: payload.method,\n      example: payload.exampleKey,\n    })\n\n    if (!entry || entry.type !== 'example') {\n      // Sidebar entry for this example doesn't exist, so rebuild sidebar for consistency.\n      rebuildSidebar(documentName)\n      if (currentRoute.value) {\n        syncSidebar(currentRoute.value)\n      }\n    }\n    return\n  }\n\n  /** Width of the sidebar, with fallback to default. */\n  const sidebarWidth = computed(() => store.value?.workspace?.['x-scalar-sidebar-width'] ?? DEFAULT_SIDEBAR_WIDTH)\n\n  /** Handler for sidebar width changes. */\n  const handleSidebarWidthUpdate = (width: number) => store.value?.update('x-scalar-sidebar-width', width)\n\n  /** Controls the visibility of the sidebar. */\n  const isSidebarOpen = ref(false)\n  // ---------------------------------------------------------------------------\n  // Tab Management\n\n  /** Constants for workspace store keys */\n  const TABS_KEY = 'x-scalar-tabs' as const\n  const ACTIVE_TAB_KEY = 'x-scalar-active-tab' as const\n\n  /**\n   * Creates a tab object based on the current route and workspace state.\n   * Used as a fallback when no tabs exist or when creating new tabs.\n   */\n  const createTabFromRoute = (to: RouteLocationNormalizedGeneric | null): Tab => {\n    const method = getRouteParam('method', to)\n    const path = getRouteParam('pathEncoded', to)\n    const document = getRouteParam('documentSlug', to)\n    const workspace = getRouteParam('workspaceSlug', to)\n    return {\n      ...getTabDetails({\n        workspace,\n        document,\n        path,\n        method,\n        getEntryByLocation,\n      }),\n      path: currentRoute.value?.path ?? '',\n    }\n  }\n\n  const tabs = computed(() => {\n    return store.value?.workspace[TABS_KEY] ?? [createTabFromRoute(currentRoute.value)]\n  })\n\n  const activeTabIndex = computed(() => {\n    return store.value?.workspace[ACTIVE_TAB_KEY] ?? 0\n  })\n\n  /**\n   * Copies the URL of the tab at the given index to the clipboard.\n   * Constructs the full URL using the current origin and the tab path.\n   *\n   * Note: Will silently fail if clipboard API is unavailable or the tab does not exist.\n   */\n  const copyTabUrl = async (index: number): Promise<void> => {\n    const tab = tabs.value[index]\n\n    if (!tab) {\n      console.warn(`Cannot copy URL: tab at index ${index} does not exist`)\n      return\n    }\n\n    const url = `${window.location.origin}${tab.path}`\n\n    try {\n      await navigator.clipboard.writeText(url)\n    } catch (error) {\n      console.error('Failed to copy URL to clipboard:', error)\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Path syncing\n\n  /** When the route changes we need to update the active entities in the store */\n  const handleRouteChange = (to: RouteLocationNormalizedGeneric) => {\n    const slug = getRouteParam('workspaceSlug', to)\n    const document = getRouteParam('documentSlug', to)\n    const nextTeamSlug = getRouteParam('teamSlug', to)\n\n    // Must have an active workspace to syncs\n    if (!nextTeamSlug || !slug) {\n      return\n    }\n\n    // Try to see if the user can load this workspace based on the team slug.\n    const workspace = workspaces.value.find(\n      (workspace) => workspace.slug === slug && workspace.teamSlug === nextTeamSlug,\n    )\n\n    // If the workspace exists but is not accessible by the current team, redirect to the default workspace.\n    if (workspace && !canLoadWorkspace(workspace.teamSlug, teamSlug.value)) {\n      return navigateToWorkspace('local', 'default')\n    }\n\n    routeTeamSlug.value = nextTeamSlug\n    workspaceSlug.value = slug\n    documentSlug.value = document\n    method.value = getRouteParam('method', to)\n    path.value = getRouteParam('pathEncoded', to)\n    exampleName.value = getRouteParam('exampleName', to)\n\n    // Save the current path to the persistence storage\n    if (to.path !== '') {\n      workspaceStorage.setCurrentPath(to.path)\n    }\n\n    if (getWorkspaceId(nextTeamSlug, slug) !== activeWorkspace.value?.id) {\n      // If the user is navigating into their team context but the team\n      // workspace does not exist yet (e.g. they clicked the picker placeholder\n      // or are being redirected on login), create it on demand before letting\n      // the workspace switcher take over. Otherwise `changeWorkspace` would\n      // fall back to the local default and silently swallow the navigation.\n      const isUnknownTeamWorkspace = nextTeamSlug !== 'local' && nextTeamSlug === teamSlug.value && !workspace\n      if (isUnknownTeamWorkspace) {\n        return createWorkspace({\n          teamSlug: nextTeamSlug,\n          slug,\n          name: DEFAULT_TEAM_WORKSPACE_NAME,\n        })\n      }\n      return changeWorkspace(nextTeamSlug, slug, to)\n    }\n\n    // Update the active document if the document slug has changes\n    if (document && document !== store.value?.workspace[extensions.workspace.activeDocument]) {\n      store?.value?.update('x-scalar-active-document', document)\n    }\n\n    syncTabs(to)\n    syncSidebar(to)\n    return\n  }\n\n  /** Aligns the tabs with any potential slug changes */\n  const syncTabs = (to: RouteLocationNormalizedGeneric) => {\n    const tabs = store.value?.workspace['x-scalar-tabs'] ?? []\n    const index = store.value?.workspace['x-scalar-active-tab'] ?? 0\n\n    const tab = tabs[index]\n\n    // If there is no tab or the tab path is the same we leave the tab state alone\n    if (!tab || tab.path === to.path) {\n      // Already on the correct path, do nothing\n      return\n    }\n\n    // Otherwise we replace the tab content with the new route\n    tabs[index] = createTabFromRoute(to)\n  }\n\n  /** Aligns the sidebar state with any potential slug changes */\n  const syncSidebar = (to: RouteLocationNormalizedGeneric) => {\n    const document = getRouteParam('documentSlug', to)\n\n    if (!document) {\n      // Reset selection if no document is selected\n      sidebarState.setSelected(null)\n      return\n    }\n\n    const entry = getEntryByLocation({\n      document,\n      path: getRouteParam('pathEncoded', to),\n      method: getRouteParam('method', to),\n      example: getRouteParam('exampleName', to),\n    })\n\n    if (entry) {\n      sidebarState.setSelected(entry.id)\n      sidebarState.setExpanded(entry.id, true)\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Events handling\n\n  initializeAppEventHandlers({\n    eventBus,\n    router,\n    store,\n    navigateToCurrentTab,\n    rebuildSidebar,\n    onAfterExampleCreation: refreshSidebarAfterExampleCreation,\n    onSelectSidebarItem: handleSelectItem,\n    onCopyTabUrl: (index) => copyTabUrl(index),\n    onToggleSidebar: () => (isSidebarOpen.value = !isSidebarOpen.value),\n    closeSidebar: () => (isSidebarOpen.value = false),\n    renameWorkspace,\n  })\n\n  const theme = useTheme({\n    fallbackThemeSlug,\n    customThemes,\n    store: store,\n  })\n\n  const isDarkMode = computed(() => {\n    const colorMode = store.value?.workspace['x-scalar-color-mode'] ?? 'system'\n    if (colorMode === 'system') {\n      return window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ?? false\n    }\n    return colorMode === 'dark'\n  })\n\n  return {\n    /** Active workspace store */\n    store,\n    sidebar: {\n      state: sidebarState,\n      width: sidebarWidth,\n      isOpen: isSidebarOpen,\n      handleSelectItem,\n      handleSidebarWidthUpdate,\n      getEntryByLocation,\n    },\n    tabs: {\n      state: tabs,\n      activeTabIndex,\n      copyTabUrl,\n    },\n    workspace: {\n      create: createWorkspace,\n      workspaceList: workspaces,\n      filteredWorkspaceList: filteredWorkspaces,\n      workspaceGroups,\n      activeWorkspace,\n      navigateToWorkspace,\n      isOpen: computed(() => Boolean(workspaceSlug.value && !documentSlug.value)),\n      isTeamWorkspace,\n    },\n    eventBus,\n    router,\n    currentRoute,\n    loading: isSyncingWorkspace,\n    activeEntities: {\n      workspaceSlug,\n      documentSlug,\n      path,\n      method,\n      exampleName,\n      teamSlug: readonly(teamSlug),\n      setTeamSlug,\n    },\n    environment,\n    document: activeDocument,\n    isDarkMode,\n    theme: {\n      styles: theme.themeStyles,\n      themeStyleTag: theme.themeStyleTag,\n      customThemes,\n    },\n    telemetry,\n    options,\n  }\n}\n"],"mappings":"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"}

package/dist/v2/features/command-palette/helpers/generate-unique-slug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-unique-slug.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/command-palette/helpers/generate-unique-slug.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,GAAU,cAAc,MAAM,GAAG,SAAS,EAAE,kBAAkB,GAAG,CAAC,MAAM,CAAC,gCASvG,CAAA"}
+{"version":3,"file":"generate-unique-slug.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/command-palette/helpers/generate-unique-slug.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,GAAU,cAAc,MAAM,GAAG,SAAS,EAAE,kBAAkB,GAAG,CAAC,MAAM,CAAC,gCASvG,CAAA"}

package/dist/v2/features/command-palette/helpers/generate-unique-slug.js

@@ -1,4 +1,4 @@
-import { slugify } from "../../../helpers/slugify.js";
+import { slugify } from "@scalar/helpers/string/slugify";
 import { generateUniqueValue } from "@scalar/workspace-store/helpers/generate-unique-value";
 //#region src/v2/features/command-palette/helpers/generate-unique-slug.ts
 /**
@@ -24,7 +24,7 @@ var generateUniqueSlug = async (defaultValue, currentDocuments) => {
 		defaultValue: defaultValue?.trim() || "default",
 		validation: (value) => !currentDocuments.has(value),
 		maxRetries: 100,
-		transformation: slugify
+		transformation: (value) => slugify(value, { allowedSpecialChars: "." })
 	});
 };
 //#endregion

package/dist/v2/features/command-palette/helpers/generate-unique-slug.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-unique-slug.js","names":[],"sources":["../../../../../src/v2/features/command-palette/helpers/generate-unique-slug.ts"],"sourcesContent":["import { generateUniqueValue } from '@scalar/workspace-store/helpers/generate-unique-value'\n\nimport { slugify } from '@/v2/helpers/slugify'\n\n/**\n * Generates a unique slug for an imported document based on its title.\n *\n * This ensures the imported document does not conflict with existing documents\n * by appending a number suffix if necessary (e.g., \"my-api\", \"my-api-1\", \"my-api-2\").\n *\n * The function will retry up to 100 times to find a unique slug. If all attempts fail,\n * it returns null, which should be handled as an import error.\n *\n * When the input is missing or contains only whitespace, it falls back to\n * `'default'` so the workspace store never ends up with a document keyed by an\n * empty string (for example, when a registry document has no `info.title`).\n *\n * @param defaultValue - The original document title to base the slug on\n * @param currentDocuments - Set of existing document slugs to check against\n *\n * @returns Promise resolving to a unique slug, or null if unable to generate one\n */\nexport const generateUniqueSlug = async (defaultValue: string | undefined, currentDocuments: Set<string>) => {\n  const base = defaultValue?.trim() || 'default'\n\n  return await generateUniqueValue({\n    defaultValue: base,\n    validation: (value) => !currentDocuments.has(value),\n    maxRetries: 100,\n    transformation: slugify,\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,qBAAqB,OAAO,cAAkC,qBAAkC;AAG3G,QAAO,MAAM,oBAAoB;EAC/B,cAHW,cAAc,MAAM,IAAI;EAInC,aAAa,UAAU,CAAC,iBAAiB,IAAI,MAAM;EACnD,YAAY;EACZ,gBAAgB;EACjB,CAAC"}
+{"version":3,"file":"generate-unique-slug.js","names":[],"sources":["../../../../../src/v2/features/command-palette/helpers/generate-unique-slug.ts"],"sourcesContent":["import { slugify } from '@scalar/helpers/string/slugify'\nimport { generateUniqueValue } from '@scalar/workspace-store/helpers/generate-unique-value'\n\n/**\n * Generates a unique slug for an imported document based on its title.\n *\n * This ensures the imported document does not conflict with existing documents\n * by appending a number suffix if necessary (e.g., \"my-api\", \"my-api-1\", \"my-api-2\").\n *\n * The function will retry up to 100 times to find a unique slug. If all attempts fail,\n * it returns null, which should be handled as an import error.\n *\n * When the input is missing or contains only whitespace, it falls back to\n * `'default'` so the workspace store never ends up with a document keyed by an\n * empty string (for example, when a registry document has no `info.title`).\n *\n * @param defaultValue - The original document title to base the slug on\n * @param currentDocuments - Set of existing document slugs to check against\n *\n * @returns Promise resolving to a unique slug, or null if unable to generate one\n */\nexport const generateUniqueSlug = async (defaultValue: string | undefined, currentDocuments: Set<string>) => {\n  const base = defaultValue?.trim() || 'default'\n\n  return await generateUniqueValue({\n    defaultValue: base,\n    validation: (value) => !currentDocuments.has(value),\n    maxRetries: 100,\n    transformation: (value) => slugify(value, { allowedSpecialChars: '.' }),\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,IAAa,qBAAqB,OAAO,cAAkC,qBAAkC;AAG3G,QAAO,MAAM,oBAAoB;EAC/B,cAHW,cAAc,MAAM,IAAI;EAInC,aAAa,UAAU,CAAC,iBAAiB,IAAI,MAAM;EACnD,YAAY;EACZ,iBAAiB,UAAU,QAAQ,OAAO,EAAE,qBAAqB,KAAK,CAAC;EACxE,CAAC"}

package/package.json

@@ -18,7 +18,7 @@
     "rest",
     "testing"
   ],
-  "version": "3.4.0",
+  "version": "3.5.1",
   "engines": {
     "node": ">=22"
   },
@@ -332,22 +332,22 @@
     "vue-router": "5.0.4",
     "yaml": "^2.8.3",
     "zod": "^4.3.5",
-    "@scalar/components": "0.23.0",
-    "@scalar/helpers": "0.5.3",
-    "@scalar/oas-utils": "0.14.0",
-    "@scalar/postman-to-openapi": "0.7.2",
-    "@scalar/json-magic": "0.12.9",
-    "@scalar/openapi-types": "0.8.0",
-    "@scalar/snippetz": "0.9.3",
+    "@scalar/components": "0.24.1",
+    "@scalar/helpers": "0.5.5",
     "@scalar/icons": "0.7.2",
-    "@scalar/sidebar": "0.9.7",
+    "@scalar/json-magic": "0.12.11",
+    "@scalar/oas-utils": "0.15.1",
+    "@scalar/openapi-types": "0.8.0",
+    "@scalar/postman-to-openapi": "0.7.4",
+    "@scalar/sidebar": "0.9.9",
+    "@scalar/snippetz": "0.9.5",
     "@scalar/themes": "0.15.3",
-    "@scalar/types": "0.9.3",
+    "@scalar/types": "0.9.5",
     "@scalar/use-codemirror": "0.14.11",
     "@scalar/use-hooks": "0.4.3",
     "@scalar/use-toasts": "0.10.2",
-    "@scalar/validation": "0.3.1",
-    "@scalar/workspace-store": "0.48.0"
+    "@scalar/workspace-store": "0.49.1",
+    "@scalar/validation": "0.3.2"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.2.0",
@@ -362,7 +362,7 @@
     "vite": "8.0.0",
     "vite-svg-loader": "5.1.1",
     "vitest": "4.1.0",
-    "@scalar/pre-post-request-scripts": "0.4.8"
+    "@scalar/pre-post-request-scripts": "0.4.10"
   },
   "scripts": {
     "build": "vite build && vue-tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
@@ -373,6 +373,7 @@
     "playground:web": "vite ./playground/web -c ./vite.config.ts",
     "preview": "vite preview",
     "test": "vitest --run",
+    "test:watch": "vitest",
     "test:benchmark": "vitest bench",
     "test:benchmark:compare": "vitest bench --compare test-results/test-benchmark.json",
     "test:benchmark:save": "vitest bench --outputJson test-results/test-benchmark.json",

package/dist/v2/helpers/slugify.d.ts

@@ -1,9 +0,0 @@
-/**
- * Converts a string into a URL-friendly "slug" by
- * lowercasing and replacing whitespace with hyphens.
- *
- * Example:
- *   slugify('Hello World Example')  // returns 'hello-world-example'
- */
-export declare const slugify: (value: string) => string;
-//# sourceMappingURL=slugify.d.ts.map

package/dist/v2/helpers/slugify.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,WAEpC,CAAA"}

package/dist/v2/helpers/slugify.js

@@ -1,15 +0,0 @@
-//#region src/v2/helpers/slugify.ts
-/**
-* Converts a string into a URL-friendly "slug" by
-* lowercasing and replacing whitespace with hyphens.
-*
-* Example:
-*   slugify('Hello World Example')  // returns 'hello-world-example'
-*/
-var slugify = (value) => {
-	return value.toLowerCase().replace(/\s+/g, "-");
-};
-//#endregion
-export { slugify };
-
-//# sourceMappingURL=slugify.js.map

package/dist/v2/helpers/slugify.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"slugify.js","names":[],"sources":["../../../src/v2/helpers/slugify.ts"],"sourcesContent":["/**\n * Converts a string into a URL-friendly \"slug\" by\n * lowercasing and replacing whitespace with hyphens.\n *\n * Example:\n *   slugify('Hello World Example')  // returns 'hello-world-example'\n */\nexport const slugify = (value: string) => {\n  return value.toLowerCase().replace(/\\s+/g, '-')\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,WAAW,UAAkB;AACxC,QAAO,MAAM,aAAa,CAAC,QAAQ,QAAQ,IAAI"}