@streamoid/ui 0.6.54 → 0.6.56

package/dist/docs/AGENTS.md

@@ -1,6 +1,6 @@
 # @streamoid/ui — component router (for AI agents)
 
-127 components. Full docs for each live beside this file as `<ScName>.md`;
+128 components. Full docs for each live beside this file as `<ScName>.md`;
 the same metadata is machine-readable in `components.json`.
 
 **How to use this file:** scan for the job you need below, then open only that
@@ -141,6 +141,8 @@ theme-aware (dark on `:root`, light override) — never hardcode a colour.
 - **`ScInfoPopup`** — use when a label or a table header needs a short explanation, and you want the standard ⓘ affordance next to it.
 - **`ScMenuOptions`** — use when you need a row in a profile flyout, an account/settings menu, or a kebab/overflow menu.
 - **`ScModal`** — use when you need a centered dialog that blocks the page — confirm, create/edit form, image preview, invite flow.
+- **`ScNewVersionNotice`** — use when the app is a long-lived SPA tab and a deploy should not wait for the user to happen to reload.
+  - also documented here: `useNewVersionAvailable`, `parseVersionManifest`, `shouldPromptForNewVersion`
 - **`ScPagination`** — use when you have a server-paged table or list and you already hold `page` + `offset` state and a refetch function.
 - **`ScPopUpMenu`** _(legacy)_ — use when never, in new code.
 - **`ScProgressBar`** — use when you have a known-percentage operation to show — an upload, a batch render, credits consumed.
@@ -181,8 +183,8 @@ theme-aware (dark on `:root`, light override) — never hardcode a colour.
 - **`ScSidebarProfile`** _(legacy)_ — use when never. There is no way to pass a real user through it.
 - **`ScSidebarSwitchMenu`** — use when you're building a "switch to another product" list inside a sidebar and each entry needs a name **and** a subtitle.
 - **`ScVersion`** _(legacy)_ — use when never. `StreamoidSidebar` renders its own version footer inline from `versionText`.
-- **`ScWorkspaceAccountMenu`** — use when building the standard workspace menu opened from the top-left of a Streamoid application sidebar. - Use `ScSidebarWorkspaceTrigger`, `ScSidebarSearchTrigger`, and `ScSidebarAppIdentity` for the matching constant rail controls. - Use the two preference hooks so theme and expanded/collapsed state survive an app switch across Streamoid subdomains. - Use `useStreamoidSidebarPopoverPosition` for a panel that belongs to the whole rail (the upper-right workspace menu) instead of hard-coded host coordinates. - Use `useStreamoidAnchoredPopoverPosition` for a panel that belongs to a BUTTON — the app switcher's grid trigger, a row's overflow menu. Pinning one of those to the sidebar card's edge leaves it floating mid-canvas with nothing connecting it to what was clicked; in Artifax it landed over the chat composer and its Send button.
-  - also documented here: `ScSidebarWorkspaceTrigger`, `ScSidebarSearchTrigger`, `ScSidebarAppIdentity`, `ScPopoverArrow`, `useStreamoidThemePreference`, `useStreamoidSidebarPreference`, `useStreamoidSidebarPopoverPosition`, `useStreamoidAnchoredPopover`, `useStreamoidAnchoredPopoverPosition`, `resolveAnchoredPopoverArrow`, `resolveAnchoredPopoverPosition`
+- **`ScWorkspaceAccountMenu`** — use when building the standard workspace menu opened from the top-left of a Streamoid application sidebar. - Use `ScSidebarWorkspaceTrigger`, `ScSidebarSearchTrigger`, and `ScSidebarAppIdentity` for the matching constant rail controls. - Wire `ScSidebarSearchTrigger`'s `onPrefetch` AND `useStreamoidSearchShortcut` whenever the trigger opens a lazily-loaded dialog — which is every product. Without them the `⌘ K` the trigger draws does nothing, and the first click sits on a blank screen while the chunk downloads. - Use the two preference hooks so theme and expanded/collapsed state survive an app switch across Streamoid subdomains. - Use `useStreamoidSidebarPopoverPosition` for a panel that belongs to the whole rail (the upper-right workspace menu) instead of hard-coded host coordinates. - Use `useStreamoidAnchoredPopoverPosition` for a panel that belongs to a BUTTON — the app switcher's grid trigger, a row's overflow menu. Pinning one of those to the sidebar card's edge leaves it floating mid-canvas with nothing connecting it to what was clicked; in Artifax it landed over the chat composer and its Send button.
+  - also documented here: `ScSidebarWorkspaceTrigger`, `ScSidebarSearchTrigger`, `ScSidebarAppIdentity`, `ScPopoverArrow`, `useStreamoidThemePreference`, `useStreamoidSidebarPreference`, `useStreamoidSidebarPopoverPosition`, `useStreamoidAnchoredPopover`, `useStreamoidAnchoredPopoverPosition`, `useStreamoidSearchShortcut`, `matchesStreamoidSearchShortcut`, `resolveAnchoredPopoverArrow`, `resolveAnchoredPopoverPosition`
 - **`StreamoidSidebar`** — use when you are building (or fixing) a desktop app's primary left navigation and you want the same chrome CXO, Photogenix and Catalogix use.
   - also documented here: `ScSidebarResizeHandle`, `advanceSidebarResizeGesture`, `SIDEBAR_RESIZE_THRESHOLD_PX`
 
@@ -245,6 +247,7 @@ theme-aware (dark on `:root`, light override) — never hardcode a colour.
 | `ScMobileBottomAction` | `ScButton`, `ScMobileTopNav`, `ScFieldButton`, `ScOnlyIcon` |
 | `ScMobileTopNav` | `ScHeader`, `ScTableHeader`, `ScSideBarLogoUnit`, `ScMobileBottomAction`, `ScTabSwitcher` |
 | `ScModal` | `ScDrawer`, `ScInfoPopup`, `ScProfilePopup` |
+| `ScNewVersionNotice` | `ScBadges`, `CreditWarningBanner` |
 | `ScOnlyIcon` | `ScOnlyField`, `ScButton`, `ScFieldButton`, `ScSidebarIcons` |
 | `ScPagination` | `ScCounter`, `ScTabs`, `ScOnlyField` |
 | `ScPairtext` | `ScCheckField`, `ScCheckbox`, `ScRadio`, `ScSelection`, `ScSelectionPill`, `ScMenuOptions` |

package/dist/docs/ScNewVersionNotice.md

@@ -0,0 +1,189 @@
+---
+component: ScNewVersionNotice
+package: "@streamoid/ui"
+category: overlays
+status: stable
+renders: div
+tags: [deploy, version, reload, notice, portal, toast]
+related: [ScSidebarPopover, ScErrorBoundary]
+do_not_confuse_with: [ScBadges, CreditWarningBanner]
+used_by: [artifax, photogenix, tactix, cxo]
+required_props: [buildId]
+also_exports: [useNewVersionAvailable, parseVersionManifest, shouldPromptForNewVersion]
+---
+
+# New-version notice
+
+Tells the user a newer build is deployed and lets them take it. Renders nothing
+until there is something to say, and portals to `<body>` so no host layout has
+to make room for it.
+
+## TL;DR for agents
+
+- **Reach for it when:** the app is a long-lived SPA tab and a deploy should not
+  wait for the user to happen to reload.
+- **You must pass `buildId`.** It comes from a compile-time define, and every app
+  spells it differently (`__BUILD_ID__` in Artifax and Tactix,
+  `__PHOTOGENIX_BUILD_ID__` in Photogenix). A library cannot read another
+  bundle's define, so there is nothing to infer.
+- Pass `enabled={!import.meta.env.DEV}`. In dev there is nothing to compare
+  against: the manifest is emitted by a build-only plugin and the dev server
+  rebuilds in place.
+- Want the boolean without the UI? `useNewVersionAvailable({ buildId })`.
+
+```tsx
+<ScNewVersionNotice
+  buildId={typeof __BUILD_ID__ === 'string' ? __BUILD_ID__ : ''}
+  enabled={!import.meta.env.DEV}
+/>
+```
+
+## 1. How to use it
+
+```tsx
+import { ScNewVersionNotice } from "@streamoid/ui"
+
+<ScNewVersionNotice
+  buildId={typeof __BUILD_ID__ === 'string' ? __BUILD_ID__ : ''}
+  enabled={!import.meta.env.DEV}
+/>
+```
+
+| Prop | Default | Notes |
+| --- | --- | --- |
+| `buildId` | — | The id baked into the bundle that is RUNNING. Required in practice: without it the check is disabled. |
+| `manifestUrl` | `/version.json` | Where the DEPLOYED id is published. |
+| `pollIntervalMs` | `300000` | Backstop only; the focus check is the one that matters. |
+| `enabled` | `true` | Pass `!import.meta.env.DEV`. |
+| `title` | `A new version is available` | |
+| `description` | `Refresh to get the latest updates.` | |
+| `refreshLabel` / `dismissLabel` | `Refresh` / `Later` | |
+| `onRefresh` | `window.location.reload()` | Override only to save work first — then still reload. |
+| `testId` | `new-version-notice` | |
+
+Want the boolean without the UI: `useNewVersionAvailable({ buildId })`.
+
+## 2. Where to use it
+
+Mount it once, high in the tree — beside the router, not inside a route — so it
+survives navigation. It portals to `<body>` and renders `null` until there is
+something to say, so it costs a host nothing to mount early and needs no room
+made for it in any layout.
+
+## 3. When to use it
+
+When the app is a long-lived SPA tab and a deploy should not wait for the user
+to happen to reload. Skip it for short-lived surfaces, embedded widgets, and
+anything already inside a host that prompts for it.
+
+## What the host still owns
+
+
+Two pieces of build plumbing, because they are the host's build:
+
+1. **Emit the manifest.** A Vite plugin writes `version.json` next to the build
+   and bakes the same id in as a define:
+
+   ```ts
+   function buildVersionManifest(buildId: string): Plugin {
+     return {
+       name: 'build-version-manifest',
+       apply: 'build',
+       generateBundle() {
+         this.emitFile({
+           type: 'asset',
+           fileName: 'version.json',
+           source: JSON.stringify({ buildId }, null, 2) + '\n',
+         })
+       },
+     }
+   }
+   const buildId = process.env.VITE_BUILD_ID?.trim() || String(Date.now())
+   ```
+
+2. **Serve it uncached.** This is not a tuning detail — a cached manifest
+   reports the version the tab already has, forever, which is exactly what the
+   check exists to detect:
+
+   ```nginx
+   location = /version.json {
+       add_header Cache-Control "no-store" always;
+       try_files $uri =404;   # not the SPA fallback: index.html is not JSON
+   }
+   ```
+
+## Design decisions worth not relitigating
+
+
+**It asks; it does not reload.** Reloading under someone mid-sentence in a chat,
+mid-upload or mid-form loses their work.
+
+**It is persistent, and dismissible.** A notice that disappears after five
+seconds is a notice nobody reads. Dismissing costs nothing, because the next
+full page load picks the new build up anyway.
+
+**Not knowing is never grounds to prompt.** Offline, mid-redeploy, a dev bundle
+with no define, `/version.json` answered by the SPA catch-all with `index.html`
+— all normal, none evidence of a newer build. `shouldPromptForNewVersion`
+requires two known ids that differ. Getting this wrong shows the notice to
+everyone, forever, which is worse than never showing it.
+
+**It latches.** A build cannot become un-new, and flickering the prompt because
+one poll failed is worse than not showing it.
+
+**Polling is deliberately slow (5 min).** The check that matters is the one on
+focus — someone returning to a tab they left open. The interval is a backstop.
+
+**The refresh button does not use `--alias-text---icons-onfill`.** That token
+looks right for a label on a filled button and is not: it resolves to the same
+ramp step as the fill, so the label matches the background in *both* themes. It
+cost Artifax a white label on a white card. Use
+`--alias-text---icons-inverse`, which is `--alias-fill-base-base`'s actual
+inverse. A test guards this.
+
+## 4. Why to use it
+
+Because this was three copies and a gap. Artifax and Photogenix each shipped a
+`NewVersionNotice` plus a `useNewVersionAvailable`; CXO raises the same message
+on a toast. The three were the same component down to the copy, and differed in
+exactly the ways duplication gets expensive: quote style, the name of the
+build-id global, and whether a `204` was handled — only one of them did. Tactix
+had none at all, so a deployed Tactix tab stayed on its old bundle until someone
+reloaded by chance. Fixing the `onfill` token bug in one app fixed it in one app.
+
+## Gotchas
+
+- **`buildId` is not optional in practice.** Omit it and the hook disables
+  itself — deliberately, because not knowing which build you are is not evidence
+  that a newer one exists. A notice that never appears looks identical to a
+  working one, so check the define reaches the bundle.
+- **`/version.json` must not be cached, and must not fall through to the SPA
+  catch-all.** A cached manifest reports the version the tab already has,
+  forever. `index.html` is not JSON, and the parse failure is swallowed — so
+  both mistakes look like "the notice never shows".
+- **Do not reach for `--alias-text---icons-onfill`** on the refresh button. It
+  resolves to the same ramp step as the fill, so the label matches the
+  background in both themes. Use `--alias-text---icons-inverse`. A test guards
+  this.
+- **It latches.** Once true it stays true for the life of the tab.
+
+## In the wild
+
+The two local copies this component generalises, both mounted once beside the
+router:
+
+```tsx
+// artifax  apps/artifax/src/App.tsx:32
+<NewVersionNotice />
+// photogenix  dashboard/client/src/App.tsx:129
+<NewVersionNotice />
+```
+
+Photogenix's copy (`dashboard/client/src/lib/useNewVersionAvailable.ts`) is the
+only one of the three that handled a `204`; that behaviour is kept here.
+
+## Related
+
+- `ScSidebarPopover` — the other portaled surface in this package; it owns its
+  own card chrome for the same reason this owns its own.
+- `ScErrorBoundary` — the other app-level thing mounted once beside the router.

package/dist/docs/ScWorkspaceAccountMenu.md

@@ -9,7 +9,7 @@ related: [StreamoidSidebar, ScArtifaxSidebar, ScAppSwitchPanel, ScProfilePopup]
 do_not_confuse_with: [ScProfilePopup, ScWorkspaceSwitcher, ScAppSwitchPanel]
 used_by: [cxo, artifax, catalogix, photogenix]
 required_props: [workspaceName, accountName]
-also_exports: [ScSidebarWorkspaceTrigger, ScSidebarSearchTrigger, ScSidebarAppIdentity, ScPopoverArrow, useStreamoidThemePreference, useStreamoidSidebarPreference, useStreamoidSidebarPopoverPosition, useStreamoidAnchoredPopover, useStreamoidAnchoredPopoverPosition, resolveAnchoredPopoverArrow, resolveAnchoredPopoverPosition]
+also_exports: [ScSidebarWorkspaceTrigger, ScSidebarSearchTrigger, ScSidebarAppIdentity, ScPopoverArrow, useStreamoidThemePreference, useStreamoidSidebarPreference, useStreamoidSidebarPopoverPosition, useStreamoidAnchoredPopover, useStreamoidAnchoredPopoverPosition, useStreamoidSearchShortcut, matchesStreamoidSearchShortcut, resolveAnchoredPopoverArrow, resolveAnchoredPopoverPosition]
 ---
 
 # Shared Streamoid sidebar shell
@@ -25,6 +25,10 @@ shared popover-position hook keeps the desktop anchors consistent.
   top-left of a Streamoid application sidebar.
 - Use `ScSidebarWorkspaceTrigger`, `ScSidebarSearchTrigger`, and
   `ScSidebarAppIdentity` for the matching constant rail controls.
+- Wire `ScSidebarSearchTrigger`'s `onPrefetch` AND `useStreamoidSearchShortcut`
+  whenever the trigger opens a lazily-loaded dialog — which is every product.
+  Without them the `⌘ K` the trigger draws does nothing, and the first click
+  sits on a blank screen while the chunk downloads.
 - Use the two preference hooks so theme and expanded/collapsed state survive an
   app switch across Streamoid subdomains.
 - Use `useStreamoidSidebarPopoverPosition` for a panel that belongs to the
@@ -67,6 +71,40 @@ const appSwitcherPosition = useStreamoidAnchoredPopoverPosition(
 );
 ```
 
+### `ScSidebarSearchTrigger` — the two props nobody wired
+
+The trigger renders a `⌘ K` hint and opens a dialog the host owns. Both halves
+of that promise need wiring, and for a long time neither was:
+
+```tsx
+import {
+  ScSidebarSearchTrigger,
+  useStreamoidSearchShortcut,
+} from "@streamoid/ui";
+
+const [searchOpen, setSearchOpen] = useState(false);
+
+// The chord the trigger advertises. A TOGGLE, not an open — every other
+// command palette closes on the same keys that opened it.
+useStreamoidSearchShortcut({ onTrigger: () => setSearchOpen((o) => !o) });
+
+<ScSidebarSearchTrigger
+  expanded={expanded}
+  onClick={() => setSearchOpen(true)}
+  // Hover and focus, before the click. In CXO and Artifax this dialog lives in
+  // `@streamoid/agent` — 5.3MB behind a `Suspense` fallback of `null` — so the
+  // FIRST click looked like it did nothing at all. On intent rather than on
+  // idle: most sessions never open it and should not download it.
+  onPrefetch={() => void import("@streamoid/agent")}
+/>;
+```
+
+`ScArtifaxSidebar` forwards the same thing as `header.onSearchPrefetch`.
+
+`matchesStreamoidSearchShortcut(event, letter?)` is the hook's chord test,
+exported separately so a host with its own key handling can ask the same
+question rather than re-deriving the modifier rules.
+
 ### `useStreamoidAnchoredPopoverPosition(anchorRef, panelRef, options)`
 
 | Option | Type | Default | Purpose |
@@ -146,6 +184,16 @@ copies of the same shell.
 - Legacy sidebar keys describe the collapsed state, while the hook exposes the
   positive `expanded` state. Both hooks continue mirroring supplied legacy keys
   so older code in the same host stays synchronized during migration.
+- `useStreamoidSearchShortcut` calls `preventDefault`. It has to: Chrome and
+  Firefox both send Ctrl+K to the address bar, so without it the rail's own
+  search loses to the browser. It also fires while a text field has focus,
+  which is deliberate — the chord is how you leave the field.
+- `onPrefetch` fires on EVERY hover, so it must be cheap and idempotent. A bare
+  `() => void import("…")` is the intended shape; dynamic imports are cached,
+  so the second hover costs nothing. Do not put a fetch behind it.
+- The shortcut matches on `event.key`, not `event.code`. `code` is physical, so
+  on AZERTY or Dvorak the key labelled K is not `KeyK` and the shortcut would
+  land somewhere other than the `⌘ K` the rail is showing.
 
 ## In the wild
 

package/dist/docs/components.json

@@ -1,6 +1,6 @@
 {
   "package": "@streamoid/ui",
-  "count": 127,
+  "count": 128,
   "components": {
     "ScAccess": {
       "doc": "ScAccess.md",
@@ -1688,6 +1688,46 @@
       "alsoExports": [],
       "exported": true
     },
+    "ScNewVersionNotice": {
+      "doc": "ScNewVersionNotice.md",
+      "source": "src/SC-NewVersionNotice",
+      "category": "overlays",
+      "status": "stable",
+      "renders": "div",
+      "summary": "Reach for it when:",
+      "reachForWhen": "the app is a long-lived SPA tab and a deploy should not wait for the user to happen to reload.",
+      "tags": [
+        "deploy",
+        "version",
+        "reload",
+        "notice",
+        "portal",
+        "toast"
+      ],
+      "related": [
+        "ScSidebarPopover",
+        "ScErrorBoundary"
+      ],
+      "doNotConfuseWith": [
+        "ScBadges",
+        "CreditWarningBanner"
+      ],
+      "requiredProps": [
+        "buildId"
+      ],
+      "usedBy": [
+        "artifax",
+        "photogenix",
+        "tactix",
+        "cxo"
+      ],
+      "alsoExports": [
+        "useNewVersionAvailable",
+        "parseVersionManifest",
+        "shouldPromptForNewVersion"
+      ],
+      "exported": true
+    },
     "ScOnlyIcon": {
       "doc": "ScOnlyIcon.md",
       "source": "src/SC-OnlyIcon",
@@ -2789,7 +2829,7 @@
       "status": "stable",
       "renders": "div",
       "summary": "Reach for it when:",
-      "reachForWhen": "building the standard workspace menu opened from the top-left of a Streamoid application sidebar. - Use `ScSidebarWorkspaceTrigger`, `ScSidebarSearchTrigger`, and `ScSidebarAppIdentity` for the matching constant rail controls. - Use the two preference hooks so theme and expanded/collapsed state survive an app switch across Streamoid subdomains. - Use `useStreamoidSidebarPopoverPosition` for a panel that belongs to the whole rail (the upper-right workspace menu) instead of hard-coded host coordinates. - Use `useStreamoidAnchoredPopoverPosition` for a panel that belongs to a BUTTON — the app switcher's grid trigger, a row's overflow menu. Pinning one of those to the sidebar card's edge leaves it floating mid-canvas with nothing connecting it to what was clicked; in Artifax it landed over the chat composer and its Send button.",
+      "reachForWhen": "building the standard workspace menu opened from the top-left of a Streamoid application sidebar. - Use `ScSidebarWorkspaceTrigger`, `ScSidebarSearchTrigger`, and `ScSidebarAppIdentity` for the matching constant rail controls. - Wire `ScSidebarSearchTrigger`'s `onPrefetch` AND `useStreamoidSearchShortcut` whenever the trigger opens a lazily-loaded dialog — which is every product. Without them the `⌘ K` the trigger draws does nothing, and the first click sits on a blank screen while the chunk downloads. - Use the two preference hooks so theme and expanded/collapsed state survive an app switch across Streamoid subdomains. - Use `useStreamoidSidebarPopoverPosition` for a panel that belongs to the whole rail (the upper-right workspace menu) instead of hard-coded host coordinates. - Use `useStreamoidAnchoredPopoverPosition` for a panel that belongs to a BUTTON — the app switcher's grid trigger, a row's overflow menu. Pinning one of those to the sidebar card's edge leaves it floating mid-canvas with nothing connecting it to what was clicked; in Artifax it landed over the chat composer and its Send button.",
       "tags": [
         "sidebar",
         "workspace",
@@ -2829,6 +2869,8 @@
         "useStreamoidSidebarPopoverPosition",
         "useStreamoidAnchoredPopover",
         "useStreamoidAnchoredPopoverPosition",
+        "useStreamoidSearchShortcut",
+        "matchesStreamoidSearchShortcut",
         "resolveAnchoredPopoverArrow",
         "resolveAnchoredPopoverPosition"
       ],
@@ -5001,6 +5043,18 @@
       "documentedIn": "ScStreamoidWordmark",
       "doc": "ScStreamoidWordmark.md"
     },
+    "useNewVersionAvailable": {
+      "documentedIn": "ScNewVersionNotice",
+      "doc": "ScNewVersionNotice.md"
+    },
+    "parseVersionManifest": {
+      "documentedIn": "ScNewVersionNotice",
+      "doc": "ScNewVersionNotice.md"
+    },
+    "shouldPromptForNewVersion": {
+      "documentedIn": "ScNewVersionNotice",
+      "doc": "ScNewVersionNotice.md"
+    },
     "useStreamoidPanelWidth": {
       "documentedIn": "ScPanelResizeHandle",
       "doc": "ScPanelResizeHandle.md"
@@ -5081,6 +5135,14 @@
       "documentedIn": "ScWorkspaceAccountMenu",
       "doc": "ScWorkspaceAccountMenu.md"
     },
+    "useStreamoidSearchShortcut": {
+      "documentedIn": "ScWorkspaceAccountMenu",
+      "doc": "ScWorkspaceAccountMenu.md"
+    },
+    "matchesStreamoidSearchShortcut": {
+      "documentedIn": "ScWorkspaceAccountMenu",
+      "doc": "ScWorkspaceAccountMenu.md"
+    },
     "resolveAnchoredPopoverArrow": {
       "documentedIn": "ScWorkspaceAccountMenu",
       "doc": "ScWorkspaceAccountMenu.md"

package/dist/index.d.mts

@@ -597,6 +597,80 @@ interface IScMenuOptionsProps extends React.HTMLAttributes<HTMLDivElement> {
 }
 declare const ScMenuOptions: ({ icon, version, hover, variant, className, text, ...props }: IScMenuOptionsProps) => React.JSX.Element;
 
+interface IUseNewVersionAvailableOptions {
+    /** The build id baked into the bundle that is RUNNING.
+     *
+     *  The host has to pass this: it comes from a compile-time define, and every
+     *  app spells it differently (`__BUILD_ID__` in Artifax and Tactix,
+     *  `__PHOTOGENIX_BUILD_ID__` in Photogenix). A library cannot read another
+     *  bundle's define, so there is nothing to guess here.
+     *
+     *  Empty or undefined disables the check rather than prompting: not knowing
+     *  which build you are is not evidence that a newer one exists. */
+    buildId?: string;
+    /** Where the DEPLOYED build id is published. Defaults to `/version.json`,
+     *  which is what every Streamoid app's build emits. */
+    manifestUrl?: string;
+    pollIntervalMs?: number;
+    /** Pass `false` in dev. There is nothing to compare against: the manifest is
+     *  emitted by a build-only plugin, and the dev server rebuilds in place. */
+    enabled?: boolean;
+}
+/** The deployed build id out of a `/version.json` body, or `null`.
+ *
+ *  Exported because it is where the surprises live, and a hook is awkward to
+ *  test: the SPA catch-all can answer this route with `index.html`, a partial
+ *  deploy can serve `{}`, and a hand-edited manifest can put a number there.
+ *  None of those are a newer build. */
+declare function parseVersionManifest(body: unknown): string | null;
+/** Whether `deployed` is grounds to prompt someone to reload.
+ *
+ *  Only a KNOWN id that DIFFERS counts. Not knowing which build is deployed,
+ *  and not knowing which build you are running, are both the normal state —
+ *  offline, mid-redeploy, a dev server — and neither is evidence of a newer
+ *  build. Prompting on either would show the notice to everyone, forever. */
+declare function shouldPromptForNewVersion(current: string | null | undefined, deployed: string | null | undefined): boolean;
+/**
+ * Whether the server is serving a newer build than this tab is running.
+ *
+ * Latches once true: a build cannot become un-new, and flickering the prompt
+ * because one poll failed would be worse than not showing it.
+ *
+ * This was three near-identical copies — Artifax's and Photogenix's hooks of
+ * this name and CXO's toast — differing only in quote style, the name of the
+ * build-id global, and whether they handled a 204. They handle it here.
+ */
+declare function useNewVersionAvailable(options?: IUseNewVersionAvailableOptions): boolean;
+
+interface IScNewVersionNoticeProps extends IUseNewVersionAvailableOptions {
+    title?: ReactNode;
+    description?: ReactNode;
+    refreshLabel?: ReactNode;
+    dismissLabel?: ReactNode;
+    /** Defaults to a plain `window.location.reload()`. Override only to save
+     *  work first — and then still reload. */
+    onRefresh?: () => void;
+    testId?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * Tell the user a newer build is deployed, and let them take it.
+ *
+ * DELIBERATELY NOT AUTOMATIC. Reloading under someone mid-sentence in a chat,
+ * mid-upload, or mid-form loses their work; every app that does this well asks
+ * rather than acts. It is persistent for the same reason — a notice about an
+ * update that disappears after five seconds is a notice nobody reads — and
+ * dismissible, because the next full page load picks the new version up
+ * regardless, so nothing is lost by ignoring it.
+ *
+ * TOP-RIGHT, because CXO raises this on a `Toaster` pinned there and the rest
+ * of the family follows it. Bottom-right puts the same message in a different
+ * corner of the same product family, and tends to land on a composer or a
+ * grid's controls — which is where someone is working.
+ */
+declare function ScNewVersionNotice({ title, description, refreshLabel, dismissLabel, onRefresh, testId, className, style, ...availability }: IScNewVersionNoticeProps): React$1.ReactPortal | null;
+
 interface IScOnlyIconProps extends React.HTMLAttributes<HTMLDivElement> {
     className?: string;
     variant?: "default";
@@ -924,9 +998,26 @@ interface ScSidebarSearchTriggerProps {
     label?: string;
     shortcut?: string;
     onClick?: () => void;
+    /**
+     * Hover or keyboard-focus, BEFORE the click — the host's cue to start
+     * fetching whatever the search dialog needs.
+     *
+     * Every product opens this trigger onto a lazily-loaded dialog, and in CXO
+     * and Artifax that dialog lives in `@streamoid/agent`: 5.3MB, behind a
+     * `Suspense` fallback of `null`. So the FIRST click looked like it did
+     * nothing at all while the chunk downloaded. Hovering is a strong enough
+     * signal to pay for the same bytes the click needs a moment later, and it is
+     * the reason this is on hover rather than on idle — most sessions never open
+     * the dialog and should not download it.
+     *
+     * Must be cheap and idempotent: it fires on EVERY hover. A bare
+     * `() => void import('@streamoid/agent')` is the intended shape — dynamic
+     * imports are cached, so the second call costs nothing.
+     */
+    onPrefetch?: () => void;
     className?: string;
 }
-declare function ScSidebarSearchTrigger({ expanded, label, shortcut, onClick, className, }: ScSidebarSearchTriggerProps): JSX.Element;
+declare function ScSidebarSearchTrigger({ expanded, label, shortcut, onClick, onPrefetch, className, }: ScSidebarSearchTriggerProps): JSX.Element;
 interface ScSidebarAppIdentityProps {
     expanded: boolean;
     product?: AppcardProduct | "streamoid";
@@ -969,6 +1060,58 @@ interface ScWorkspaceAccountMenuProps extends Omit<React.HTMLAttributes<HTMLDivE
 /** Shared workspace/account menu used by every Streamoid application sidebar. */
 declare function ScWorkspaceAccountMenu({ workspaceName, workspaceRole, workspaceImage, credits, onSwitchWorkspace, onInviteMembers, onBilling, organizationName, organizationRole, onOrganizationClick, accountName, accountEmail, accountImage, onAccountClick, themeMode, onThemeModeChange, className, ...props }: ScWorkspaceAccountMenuProps): JSX.Element;
 
+/** The shape `matchesStreamoidSearchShortcut` needs — a subset of
+ *  `KeyboardEvent`, so the predicate is testable without a DOM. */
+interface StreamoidSearchShortcutEvent {
+    key: string;
+    metaKey: boolean;
+    ctrlKey: boolean;
+    altKey: boolean;
+}
+/**
+ * Is this keydown the search chord?
+ *
+ * Pure and exported so the decision can be tested without a DOM, the same way
+ * `resolvePanelResize` is split out of the resize handle.
+ *
+ *  - `metaKey` OR `ctrlKey`, so one binding serves macOS and everything else.
+ *  - `altKey` is excluded, so ⌥⌘K and Ctrl+Alt+K stay with the browser.
+ *  - `event.key` and not `event.code`: `key` carries the CHARACTER, already
+ *    resolved through the keyboard layout. `code` is physical, so on AZERTY or
+ *    Dvorak the key labelled K is not `KeyK` and the shortcut would land under
+ *    a different letter than the `⌘ K` hint promises.
+ */
+declare function matchesStreamoidSearchShortcut(event: StreamoidSearchShortcutEvent, letter?: string): boolean;
+interface StreamoidSearchShortcutOptions {
+    /** Fired on ⌘K / Ctrl+K. Its identity does not matter — it is read through a
+     *  ref, so an inline arrow will not rebind the listener each render. */
+    onTrigger: () => void;
+    /** Bind the key. `false` unbinds — e.g. while a modal owns the keyboard. */
+    enabled?: boolean;
+    /** The letter pressed with the modifier. Case-insensitive. */
+    letter?: string;
+}
+/**
+ * ⌘K / Ctrl+K, for the dialog `ScSidebarSearchTrigger` advertises.
+ *
+ * The trigger has drawn a `⌘ K` hint since it shipped and NO APP EVER BOUND THE
+ * KEY — the one affordance telling people the rail has a command bar did
+ * nothing when used. This lives here so the component that makes the promise
+ * and the hook that keeps it ship together, rather than each product
+ * rediscovering the same eight lines and getting the modifier handling
+ * slightly different.
+ *
+ * The host still owns the dialog's open state, so this reports the chord and
+ * decides nothing. Wire it to a TOGGLE rather than an open: every other command
+ * palette closes on the same chord that opened it.
+ *
+ * It calls `preventDefault`, because Ctrl+K is taken — Chrome and Firefox both
+ * send it to the address bar, and without this the rail's own search loses to
+ * the browser. And it fires even while a text field has focus, which is
+ * deliberate: the chord is how you leave the field.
+ */
+declare function useStreamoidSearchShortcut({ onTrigger, enabled, letter, }: StreamoidSearchShortcutOptions): void;
+
 interface StreamoidThemePreferenceOptions {
     defaultMode?: ScShellThemeMode;
     legacyStorageKeys?: string[];
@@ -1248,6 +1391,11 @@ interface AppSidebarHeader {
     searchLabel?: string;
     searchShortcut?: string;
     onSearchClick?: () => void;
+    /** Hover/focus on the search trigger, so the host can start loading the
+     *  dialog before it is clicked. See `ScSidebarSearchTriggerProps.onPrefetch`
+     *  — the dialog is a 5.3MB lazy chunk in CXO and Artifax, and without this
+     *  the first click looks inert while it downloads. */
+    onSearchPrefetch?: () => void;
     /** Omit the search field entirely — a product that has no search yet. */
     hideSearch?: boolean;
 }
@@ -2617,4 +2765,4 @@ interface IScProfilePopupProps extends React.HTMLAttributes<HTMLDivElement> {
  */
 declare const ScProfilePopup: React$1.ForwardRefExoticComponent<IScProfilePopupProps & React$1.RefAttributes<HTMLDivElement>>;
 
-export { type AppSidebarAppIdentity, type AppSidebarAssistantCta, type AppSidebarCreditWarning, type AppSidebarHeader, type AppSidebarIconContext, type AppSidebarIconMap, type AppSidebarIconRenderer, type AppSidebarMenuItem, type AppSidebarProfile, type AppSidebarSection, type AppcardProduct, type ArtifaxMenuItem, type ArtifaxSection, type ArtifaxSidebarAppIdentity, type ArtifaxSidebarAssistantCta, type ArtifaxSidebarCreditWarning, type ArtifaxSidebarIconContext, type ArtifaxSidebarIconMap, type ArtifaxSidebarIconRenderer, type ArtifaxSidebarProfile, type AssistantCta, type CatalogixNavItem, type CatalogixSidebarCreditWarning, type CatalogixSidebarIconContext, type CatalogixSidebarIconMap, type CatalogixSidebarIconRenderer, type CatalogixSidebarProfile, type CatalogixSwitchApp, CreditWarningBanner, type CreditWarningBannerProps, type DescriptionVisibility, type IInvoiceHistoryMobileProps, type IScAccessProps, type IScAnnotatedError, type IScAppCardForCopilotProps, type IScAppCardProps, type IScAppCardV3Props, type IScAppFieldProps, type IScAppListingCardProps, type IScAppSidebarProps, type IScAppSwitchPanelProps, type IScAppcardLogosProps, type IScArtifaxInviteProps, type IScArtifaxSidebarProps, type IScAskAgentButtonProps, type IScBadgesProps, type IScBeaconProps, type IScBillingHistoryHeaderProps, type IScBillingHistoryTableListProps, type IScBillingLogsTableHeaderProps, type IScBillingLogsTableListProps, type IScBriefCardProps, type IScButtonProps, type IScCalendarDateCompsProps, type IScCalendarProps, type IScCatalogixInviteProps, type IScCatalogixSidebarProps, type IScCatalogixStoreHeaderProps, type IScCatalogixStoreTableListProps, type IScCheckFieldProps, type IScCheckboxProps, type IScCounterProps, type IScCreditsUsageCardMobileProps, type IScCreditsUsageCardProps, type IScCxoCopilotLogoProps, type IScCxoWordmarkProps, type IScDefaultCardProps, type IScDrawerProps, type IScErrorBoundaryProps, type IScErrorReport, type IScErrorReporterClient, type IScFieldButtonProps, type IScFileFieldProps, type IScGoogleSignInProps, type IScGuideProps, type IScHDividerProps, type IScHeaderProps, type IScImageFieldProps, type IScInChatListProps, type IScInChatMessageProps, type IScInfoPopupProps, type IScIntialProfileCoverProps, type IScLogoUnitProps, type IScMappingCardProps, type IScMediaApprovalProps, type IScMediaSelectProps, type IScMenuOptionsProps, type IScMobileBottomActionProps, type IScMobileTopNavProps, type IScModalProps, type IScOnlyFieldProps, type IScOnlyIconProps, type IScPaginationProps, type IScPairtextProps, type IScPanelResizeHandleProps, type IScPendingActionProps, type IScPhtogenixInviteProps, type IScPlanCardProps, type IScPlanComparisonProps, type IScPlanDetailsCardMobileProps, type IScPlanDetailsCardProps, type IScPopUpMenuProps, type IScPopoverArrowProps, type IScProfileImageUpdateProps, type IScProfileOptionsProps, type IScProfilePopupProps, type IScProfileProps, type IScProfileSettingsCompProps, type IScProfileV2MobileProps, type IScProgressBarProps, type IScQuickPromptProps, type IScRadioProps, type IScReferralCardMobileProps, type IScReferralTableHeaderProps, type IScReferralTableListProps, type IScRoleMobileProps, type IScRoleProps, type IScSelectOption, type IScSelectProps, type IScSelectionListProps, type IScSelectionPillGroupProps, type IScSelectionPillOption, type IScSelectionPillProps, type IScSelectionProps, type IScSettingsNavProps, type IScSettingsTabCompProps, type IScSideBarLogoUnitProps, type IScSidebarIconsProps, type IScSidebarMenuProps, type IScSidebarPopoverProps, type IScSidebarProfileProps, type IScSidebarProps, type IScSidebarSwitchMenuProps, type IScSliderProps, type IScStoreCardProps, type IScStrLogoProps, type IScStreamoidMascotProps, type IScStreamoidWordmarkProps, type IScSubAgentProps, type IScTabCompProps, type IScTabFieldProps, type IScTabSwitcherProps, type IScTableHeaderProps, type IScTableListMobileProps, type IScTableListProps, type IScTabsProps, type IScTaxonomyPillProps, type IScTextAreaProps, type IScTextFieldProps, type IScThinkingStepIconProps, type IScTodoItem, type IScTodoListProps, type IScToggleSwitchProps, type IScVDividerProps, type IScValueMappingL1Props, type IScVersionProps, type IScWorkspaceCardProps, type IScWorkspaceSettingsMobileProps, type IScWorkspaceSwitchMobileProps, type IScWorkspaceSwitchMobileV2Props, type IUsageHistoryMobileProps, type IcListIconState, InvoiceHistoryMobile, NscWorkspaceSwitch, PANEL_RESIZE_STEP_PX, type PanelResizeEdge, type PanelResizeGesture, type PanelWidthBounds, type PlanComparisonRow, type PlanComparisonSection, type PlanFeatureSection, ProductCollapsedMark, ProductWordmark, SC_APP_SWITCH_PANEL_WIDTH, SC_WORKSPACE_MENU_WIDTH, SIDEBAR_RESIZE_THRESHOLD_PX, STREAMOID_CHANGELOG_URL, STREAMOID_CHANGELOG_URLS, STREAMOID_STATUS_PAGE_URL, ScAccess, ScAppCard, ScAppCardForCopilot, ScAppCardV3, ScAppField, ScAppListingCard, ScAppSidebar, type ScAppSwitchItem, ScAppSwitchPanel, ScAppSwitchRow, type ScAppSwitchSystemItem, type ScAppSwitchUtilities, ScAppcardLogos, ScArtifaxInvite, ScArtifaxSidebar, ScAskAgentButton, ScAskAgentSlot, ScBadges, ScBeacon, type ScBeaconTone, ScBillingHistoryHeader, ScBillingHistoryTableList, ScBillingLogsTableHeader, ScBillingLogsTableList, ScBriefCard, ScButton, ScCalendar, ScCalendarDateComps, ScCatalogixInvite, ScCatalogixSidebar, ScCatalogixStoreHeader, ScCatalogixStoreTableList, ScCheckField, ScCheckbox, ScCounter, ScCreditsUsageCard, ScCreditsUsageCardMobile, ScCxoCopilotLogo, ScCxoWordmark, ScDefaultCard, ScDp, type ScDpProps, ScDrawer, ScErrorBoundary, type ScErrorReporter, ScFieldButton, ScFileField, ScGoogleSignIn, ScGuide, ScHDivider, ScHeader, ScImageField, ScInChatList, ScInChatMessage, ScInfoPopup, ScIntialProfileCover, ScLogoUnit, ScMappingCard, ScMediaApproval, ScMediaSelect, ScMenuOptions, ScMobileBottomAction, ScMobileTopNav, ScModal, ScOnlyField, ScOnlyIcon, ScPagination, ScPairtext, ScPanelResizeHandle, ScPendingAction, ScPhtogenixInvite, ScPlanCard, ScPlanComparison, ScPlanDetailsCard, ScPlanDetailsCardMobile, ScPopUpMenu, ScPopoverArrow, ScProfile, ScProfileImageUpdate, ScProfileOptions, ScProfilePopup, type ScProfilePopupThemeMode, ScProfileSettingsComp, ScProfileV2Mobile, ScProgressBar, ScQuickPrompt, ScRadio, ScReferralCardMobile, ScReferralTableHeader, ScReferralTableList, ScRole, ScRoleMobile, ScSelect, ScSelection, ScSelectionList, ScSelectionPill, ScSelectionPillGroup, ScSettingsNav, ScSettingsTabComp, type ScShellThemeMode, ScSideBarLogoUnit, ScSidebar, ScSidebarAppIdentity, type ScSidebarAppIdentityProps, ScSidebarIcons, ScSidebarMenu, ScSidebarPopover, ScSidebarProfile, ScSidebarResizeHandle, type ScSidebarResizeHandleProps, ScSidebarSearchTrigger, type ScSidebarSearchTriggerProps, ScSidebarSwitchMenu, ScSidebarWorkspaceTrigger, type ScSidebarWorkspaceTriggerProps, ScSlider, ScStoreCard, ScStrLogo, ScStreamoidMascot, ScStreamoidWordmark, ScSubAgent, type ScTab, ScTabComp, ScTabField, ScTabSwitcher, ScTableHeader, ScTableList, ScTableListMobile, ScTabs, ScTaxonomyPill, ScTextArea, ScTextField, ScThinkingStepIcon, ScTodoList, ScToggleSwitch, ScVDivider, ScValueMappingL1, ScVersion, ScWorkspaceAccountMenu, type ScWorkspaceAccountMenuProps, ScWorkspaceCard, ScWorkspaceSettingsMobile, ScWorkspaceSwitchCard, type ScWorkspaceSwitchCardProps, ScWorkspaceSwitchMobile, ScWorkspaceSwitchMobileV2, type SelectionListState, type SidebarAppIdentityConfig, type SidebarConfig, type SidebarIconContext, type SidebarIconMap, type SidebarIconRenderer, type SidebarMenuItemConfig, type SidebarProduct, type SidebarProfileConfig, type SidebarResizeGestureResult, type SidebarResizeGestureState, type SidebarSectionConfig, type StreamoidAnchorRect, type StreamoidAnchoredPopover, type StreamoidAnchoredPopoverArrow, type StreamoidAnchoredPopoverGeometry, type StreamoidAnchoredPopoverPosition, type StreamoidAnchoredPopoverPositionOptions, type StreamoidAppSwitchGroup, type StreamoidAppSwitchOptions, type StreamoidAppSwitchProduct, type StreamoidPanelWidthOptions, type StreamoidPanelWidthState, StreamoidSidebar, type StreamoidSidebarPopoverPlacement, type StreamoidSidebarPopoverPosition, type StreamoidSidebarPopoverPositionOptions, type StreamoidSidebarPreferenceOptions, type StreamoidSidebarPreferenceState, type StreamoidSidebarProps, type StreamoidThemePreferenceOptions, type StreamoidThemePreferenceState, StreamoidWorkspaceSwitcher, type StreamoidWorkspaceSwitcherProps, UsageHistoryMobile, type WorkspaceSwitcherConfig, type WorkspaceSwitcherItem, advanceSidebarResizeGesture, clampPanelWidth, createStreamoidAppSwitchUtilities, formatStreamoidAppVersion, formatSubAgentLabel, hasCollapsedMark, resolveAnchoredPopoverArrow, resolveAnchoredPopoverPosition, resolvePanelResize, resolvePanelResizeKey, scAppSwitchOrder, scCreatePostHogReporter, scGetErrorRef, streamoidAppSwitchGroups, streamoidAppSwitchTagline, streamoidChangelogUrl, useStreamoidAnchoredPopover, useStreamoidAnchoredPopoverPosition, useStreamoidPanelWidth, useStreamoidSidebarPopoverPosition, useStreamoidSidebarPreference, useStreamoidThemePreference };
+export { type AppSidebarAppIdentity, type AppSidebarAssistantCta, type AppSidebarCreditWarning, type AppSidebarHeader, type AppSidebarIconContext, type AppSidebarIconMap, type AppSidebarIconRenderer, type AppSidebarMenuItem, type AppSidebarProfile, type AppSidebarSection, type AppcardProduct, type ArtifaxMenuItem, type ArtifaxSection, type ArtifaxSidebarAppIdentity, type ArtifaxSidebarAssistantCta, type ArtifaxSidebarCreditWarning, type ArtifaxSidebarIconContext, type ArtifaxSidebarIconMap, type ArtifaxSidebarIconRenderer, type ArtifaxSidebarProfile, type AssistantCta, type CatalogixNavItem, type CatalogixSidebarCreditWarning, type CatalogixSidebarIconContext, type CatalogixSidebarIconMap, type CatalogixSidebarIconRenderer, type CatalogixSidebarProfile, type CatalogixSwitchApp, CreditWarningBanner, type CreditWarningBannerProps, type DescriptionVisibility, type IInvoiceHistoryMobileProps, type IScAccessProps, type IScAnnotatedError, type IScAppCardForCopilotProps, type IScAppCardProps, type IScAppCardV3Props, type IScAppFieldProps, type IScAppListingCardProps, type IScAppSidebarProps, type IScAppSwitchPanelProps, type IScAppcardLogosProps, type IScArtifaxInviteProps, type IScArtifaxSidebarProps, type IScAskAgentButtonProps, type IScBadgesProps, type IScBeaconProps, type IScBillingHistoryHeaderProps, type IScBillingHistoryTableListProps, type IScBillingLogsTableHeaderProps, type IScBillingLogsTableListProps, type IScBriefCardProps, type IScButtonProps, type IScCalendarDateCompsProps, type IScCalendarProps, type IScCatalogixInviteProps, type IScCatalogixSidebarProps, type IScCatalogixStoreHeaderProps, type IScCatalogixStoreTableListProps, type IScCheckFieldProps, type IScCheckboxProps, type IScCounterProps, type IScCreditsUsageCardMobileProps, type IScCreditsUsageCardProps, type IScCxoCopilotLogoProps, type IScCxoWordmarkProps, type IScDefaultCardProps, type IScDrawerProps, type IScErrorBoundaryProps, type IScErrorReport, type IScErrorReporterClient, type IScFieldButtonProps, type IScFileFieldProps, type IScGoogleSignInProps, type IScGuideProps, type IScHDividerProps, type IScHeaderProps, type IScImageFieldProps, type IScInChatListProps, type IScInChatMessageProps, type IScInfoPopupProps, type IScIntialProfileCoverProps, type IScLogoUnitProps, type IScMappingCardProps, type IScMediaApprovalProps, type IScMediaSelectProps, type IScMenuOptionsProps, type IScMobileBottomActionProps, type IScMobileTopNavProps, type IScModalProps, type IScNewVersionNoticeProps, type IScOnlyFieldProps, type IScOnlyIconProps, type IScPaginationProps, type IScPairtextProps, type IScPanelResizeHandleProps, type IScPendingActionProps, type IScPhtogenixInviteProps, type IScPlanCardProps, type IScPlanComparisonProps, type IScPlanDetailsCardMobileProps, type IScPlanDetailsCardProps, type IScPopUpMenuProps, type IScPopoverArrowProps, type IScProfileImageUpdateProps, type IScProfileOptionsProps, type IScProfilePopupProps, type IScProfileProps, type IScProfileSettingsCompProps, type IScProfileV2MobileProps, type IScProgressBarProps, type IScQuickPromptProps, type IScRadioProps, type IScReferralCardMobileProps, type IScReferralTableHeaderProps, type IScReferralTableListProps, type IScRoleMobileProps, type IScRoleProps, type IScSelectOption, type IScSelectProps, type IScSelectionListProps, type IScSelectionPillGroupProps, type IScSelectionPillOption, type IScSelectionPillProps, type IScSelectionProps, type IScSettingsNavProps, type IScSettingsTabCompProps, type IScSideBarLogoUnitProps, type IScSidebarIconsProps, type IScSidebarMenuProps, type IScSidebarPopoverProps, type IScSidebarProfileProps, type IScSidebarProps, type IScSidebarSwitchMenuProps, type IScSliderProps, type IScStoreCardProps, type IScStrLogoProps, type IScStreamoidMascotProps, type IScStreamoidWordmarkProps, type IScSubAgentProps, type IScTabCompProps, type IScTabFieldProps, type IScTabSwitcherProps, type IScTableHeaderProps, type IScTableListMobileProps, type IScTableListProps, type IScTabsProps, type IScTaxonomyPillProps, type IScTextAreaProps, type IScTextFieldProps, type IScThinkingStepIconProps, type IScTodoItem, type IScTodoListProps, type IScToggleSwitchProps, type IScVDividerProps, type IScValueMappingL1Props, type IScVersionProps, type IScWorkspaceCardProps, type IScWorkspaceSettingsMobileProps, type IScWorkspaceSwitchMobileProps, type IScWorkspaceSwitchMobileV2Props, type IUsageHistoryMobileProps, type IUseNewVersionAvailableOptions, type IcListIconState, InvoiceHistoryMobile, NscWorkspaceSwitch, PANEL_RESIZE_STEP_PX, type PanelResizeEdge, type PanelResizeGesture, type PanelWidthBounds, type PlanComparisonRow, type PlanComparisonSection, type PlanFeatureSection, ProductCollapsedMark, ProductWordmark, SC_APP_SWITCH_PANEL_WIDTH, SC_WORKSPACE_MENU_WIDTH, SIDEBAR_RESIZE_THRESHOLD_PX, STREAMOID_CHANGELOG_URL, STREAMOID_CHANGELOG_URLS, STREAMOID_STATUS_PAGE_URL, ScAccess, ScAppCard, ScAppCardForCopilot, ScAppCardV3, ScAppField, ScAppListingCard, ScAppSidebar, type ScAppSwitchItem, ScAppSwitchPanel, ScAppSwitchRow, type ScAppSwitchSystemItem, type ScAppSwitchUtilities, ScAppcardLogos, ScArtifaxInvite, ScArtifaxSidebar, ScAskAgentButton, ScAskAgentSlot, ScBadges, ScBeacon, type ScBeaconTone, ScBillingHistoryHeader, ScBillingHistoryTableList, ScBillingLogsTableHeader, ScBillingLogsTableList, ScBriefCard, ScButton, ScCalendar, ScCalendarDateComps, ScCatalogixInvite, ScCatalogixSidebar, ScCatalogixStoreHeader, ScCatalogixStoreTableList, ScCheckField, ScCheckbox, ScCounter, ScCreditsUsageCard, ScCreditsUsageCardMobile, ScCxoCopilotLogo, ScCxoWordmark, ScDefaultCard, ScDp, type ScDpProps, ScDrawer, ScErrorBoundary, type ScErrorReporter, ScFieldButton, ScFileField, ScGoogleSignIn, ScGuide, ScHDivider, ScHeader, ScImageField, ScInChatList, ScInChatMessage, ScInfoPopup, ScIntialProfileCover, ScLogoUnit, ScMappingCard, ScMediaApproval, ScMediaSelect, ScMenuOptions, ScMobileBottomAction, ScMobileTopNav, ScModal, ScNewVersionNotice, ScOnlyField, ScOnlyIcon, ScPagination, ScPairtext, ScPanelResizeHandle, ScPendingAction, ScPhtogenixInvite, ScPlanCard, ScPlanComparison, ScPlanDetailsCard, ScPlanDetailsCardMobile, ScPopUpMenu, ScPopoverArrow, ScProfile, ScProfileImageUpdate, ScProfileOptions, ScProfilePopup, type ScProfilePopupThemeMode, ScProfileSettingsComp, ScProfileV2Mobile, ScProgressBar, ScQuickPrompt, ScRadio, ScReferralCardMobile, ScReferralTableHeader, ScReferralTableList, ScRole, ScRoleMobile, ScSelect, ScSelection, ScSelectionList, ScSelectionPill, ScSelectionPillGroup, ScSettingsNav, ScSettingsTabComp, type ScShellThemeMode, ScSideBarLogoUnit, ScSidebar, ScSidebarAppIdentity, type ScSidebarAppIdentityProps, ScSidebarIcons, ScSidebarMenu, ScSidebarPopover, ScSidebarProfile, ScSidebarResizeHandle, type ScSidebarResizeHandleProps, ScSidebarSearchTrigger, type ScSidebarSearchTriggerProps, ScSidebarSwitchMenu, ScSidebarWorkspaceTrigger, type ScSidebarWorkspaceTriggerProps, ScSlider, ScStoreCard, ScStrLogo, ScStreamoidMascot, ScStreamoidWordmark, ScSubAgent, type ScTab, ScTabComp, ScTabField, ScTabSwitcher, ScTableHeader, ScTableList, ScTableListMobile, ScTabs, ScTaxonomyPill, ScTextArea, ScTextField, ScThinkingStepIcon, ScTodoList, ScToggleSwitch, ScVDivider, ScValueMappingL1, ScVersion, ScWorkspaceAccountMenu, type ScWorkspaceAccountMenuProps, ScWorkspaceCard, ScWorkspaceSettingsMobile, ScWorkspaceSwitchCard, type ScWorkspaceSwitchCardProps, ScWorkspaceSwitchMobile, ScWorkspaceSwitchMobileV2, type SelectionListState, type SidebarAppIdentityConfig, type SidebarConfig, type SidebarIconContext, type SidebarIconMap, type SidebarIconRenderer, type SidebarMenuItemConfig, type SidebarProduct, type SidebarProfileConfig, type SidebarResizeGestureResult, type SidebarResizeGestureState, type SidebarSectionConfig, type StreamoidAnchorRect, type StreamoidAnchoredPopover, type StreamoidAnchoredPopoverArrow, type StreamoidAnchoredPopoverGeometry, type StreamoidAnchoredPopoverPosition, type StreamoidAnchoredPopoverPositionOptions, type StreamoidAppSwitchGroup, type StreamoidAppSwitchOptions, type StreamoidAppSwitchProduct, type StreamoidPanelWidthOptions, type StreamoidPanelWidthState, type StreamoidSearchShortcutEvent, type StreamoidSearchShortcutOptions, StreamoidSidebar, type StreamoidSidebarPopoverPlacement, type StreamoidSidebarPopoverPosition, type StreamoidSidebarPopoverPositionOptions, type StreamoidSidebarPreferenceOptions, type StreamoidSidebarPreferenceState, type StreamoidSidebarProps, type StreamoidThemePreferenceOptions, type StreamoidThemePreferenceState, StreamoidWorkspaceSwitcher, type StreamoidWorkspaceSwitcherProps, UsageHistoryMobile, type WorkspaceSwitcherConfig, type WorkspaceSwitcherItem, advanceSidebarResizeGesture, clampPanelWidth, createStreamoidAppSwitchUtilities, formatStreamoidAppVersion, formatSubAgentLabel, hasCollapsedMark, matchesStreamoidSearchShortcut, parseVersionManifest, resolveAnchoredPopoverArrow, resolveAnchoredPopoverPosition, resolvePanelResize, resolvePanelResizeKey, scAppSwitchOrder, scCreatePostHogReporter, scGetErrorRef, shouldPromptForNewVersion, streamoidAppSwitchGroups, streamoidAppSwitchTagline, streamoidChangelogUrl, useNewVersionAvailable, useStreamoidAnchoredPopover, useStreamoidAnchoredPopoverPosition, useStreamoidPanelWidth, useStreamoidSearchShortcut, useStreamoidSidebarPopoverPosition, useStreamoidSidebarPreference, useStreamoidThemePreference };