@streamoid/ui 0.6.55 → 0.6.56

package/dist/docs/AGENTS.md

@@ -183,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`
 

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

@@ -2829,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",
@@ -2869,6 +2869,8 @@
         "useStreamoidSidebarPopoverPosition",
         "useStreamoidAnchoredPopover",
         "useStreamoidAnchoredPopoverPosition",
+        "useStreamoidSearchShortcut",
+        "matchesStreamoidSearchShortcut",
         "resolveAnchoredPopoverArrow",
         "resolveAnchoredPopoverPosition"
       ],
@@ -5133,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

@@ -998,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";
@@ -1043,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[];
@@ -1322,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;
 }
@@ -2691,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 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, 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, parseVersionManifest, resolveAnchoredPopoverArrow, resolveAnchoredPopoverPosition, resolvePanelResize, resolvePanelResizeKey, scAppSwitchOrder, scCreatePostHogReporter, scGetErrorRef, shouldPromptForNewVersion, streamoidAppSwitchGroups, streamoidAppSwitchTagline, streamoidChangelogUrl, useNewVersionAvailable, 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 };

package/dist/index.d.ts

@@ -998,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";
@@ -1043,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[];
@@ -1322,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;
 }
@@ -2691,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 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, 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, parseVersionManifest, resolveAnchoredPopoverArrow, resolveAnchoredPopoverPosition, resolvePanelResize, resolvePanelResizeKey, scAppSwitchOrder, scCreatePostHogReporter, scGetErrorRef, shouldPromptForNewVersion, streamoidAppSwitchGroups, streamoidAppSwitchTagline, streamoidChangelogUrl, useNewVersionAvailable, 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 };

package/dist/index.js

@@ -173,6 +173,7 @@ __export(index_exports, {
   formatStreamoidAppVersion: () => formatStreamoidAppVersion,
   formatSubAgentLabel: () => formatSubAgentLabel,
   hasCollapsedMark: () => hasCollapsedMark,
+  matchesStreamoidSearchShortcut: () => matchesStreamoidSearchShortcut,
   parseVersionManifest: () => parseVersionManifest,
   resolveAnchoredPopoverArrow: () => resolveAnchoredPopoverArrow,
   resolveAnchoredPopoverPosition: () => resolveAnchoredPopoverPosition,
@@ -189,6 +190,7 @@ __export(index_exports, {
   useStreamoidAnchoredPopover: () => useStreamoidAnchoredPopover,
   useStreamoidAnchoredPopoverPosition: () => useStreamoidAnchoredPopoverPosition,
   useStreamoidPanelWidth: () => useStreamoidPanelWidth,
+  useStreamoidSearchShortcut: () => useStreamoidSearchShortcut,
   useStreamoidSidebarPopoverPosition: () => useStreamoidSidebarPopoverPosition,
   useStreamoidSidebarPreference: () => useStreamoidSidebarPreference,
   useStreamoidThemePreference: () => useStreamoidThemePreference
@@ -5920,6 +5922,7 @@ function ScSidebarSearchTrigger({
   label = "Search or Ask CXO",
   shortcut = "\u2318 K",
   onClick,
+  onPrefetch,
   className
 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime55.jsxs)(
@@ -5928,6 +5931,8 @@ function ScSidebarSearchTrigger({
       type: "button",
       "aria-label": label,
       onClick,
+      onPointerEnter: onPrefetch,
+      onFocus: onPrefetch,
       className: `${ScSidebarShell_default.searchTrigger} ${expanded ? ScSidebarShell_default.searchTriggerExpanded : ScSidebarShell_default.searchTriggerCollapsed}${className ? ` ${className}` : ""}`,
       children: [
         /* @__PURE__ */ (0, import_jsx_runtime55.jsx)(
@@ -6176,8 +6181,34 @@ function ScWorkspaceAccountMenu({
   );
 }
 
-// src/SC-SidebarShell/useStreamoidShellPreferences.ts
+// src/SC-SidebarShell/useStreamoidSearchShortcut.ts
 var import_react19 = require("react");
+function matchesStreamoidSearchShortcut(event, letter = "k") {
+  if (event.altKey) return false;
+  if (!event.metaKey && !event.ctrlKey) return false;
+  return event.key.toLowerCase() === letter.toLowerCase();
+}
+function useStreamoidSearchShortcut({
+  onTrigger,
+  enabled = true,
+  letter = "k"
+}) {
+  const handler = (0, import_react19.useRef)(onTrigger);
+  handler.current = onTrigger;
+  (0, import_react19.useEffect)(() => {
+    if (!enabled) return;
+    const onKeyDown = (event) => {
+      if (!matchesStreamoidSearchShortcut(event, letter)) return;
+      event.preventDefault();
+      handler.current();
+    };
+    document.addEventListener("keydown", onKeyDown);
+    return () => document.removeEventListener("keydown", onKeyDown);
+  }, [enabled, letter]);
+}
+
+// src/SC-SidebarShell/useStreamoidShellPreferences.ts
+var import_react20 = require("react");
 var THEME_COOKIE = "streamoid_theme";
 var SIDEBAR_COOKIE = "streamoid_sidebar";
 var THEME_STORAGE_KEY = "streamoid.shell.theme";
@@ -6259,7 +6290,7 @@ function readExpanded(options) {
 }
 function useStreamoidThemePreference(options = {}) {
   const legacyKeySignature = (options.legacyStorageKeys ?? []).join("\0");
-  const stableOptions = (0, import_react19.useMemo)(
+  const stableOptions = (0, import_react20.useMemo)(
     () => ({
       defaultMode: options.defaultMode,
       legacyStorageKeys: legacyKeySignature ? legacyKeySignature.split("\0") : [],
@@ -6267,31 +6298,31 @@ function useStreamoidThemePreference(options = {}) {
     }),
     [options.defaultMode, options.applyToDocument, legacyKeySignature]
   );
-  const [preference, setPreferenceState] = (0, import_react19.useState)(
+  const [preference, setPreferenceState] = (0, import_react20.useState)(
     () => readTheme(stableOptions)
   );
-  const [systemDark, setSystemDark] = (0, import_react19.useState)(
+  const [systemDark, setSystemDark] = (0, import_react20.useState)(
     () => canUseDom() && window.matchMedia("(prefers-color-scheme: dark)").matches
   );
-  const setPreference = (0, import_react19.useCallback)((mode) => {
+  const setPreference = (0, import_react20.useCallback)((mode) => {
     setPreferenceState(mode);
     writeStorage(THEME_STORAGE_KEY, mode);
     stableOptions.legacyStorageKeys.forEach((key) => writeStorage(key, mode));
     writeCookie(THEME_COOKIE, mode);
   }, [stableOptions]);
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     writeStorage(THEME_STORAGE_KEY, preference);
     stableOptions.legacyStorageKeys.forEach((key) => writeStorage(key, preference));
     writeCookie(THEME_COOKIE, preference);
   }, [preference, stableOptions]);
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (!canUseDom()) return;
     const media = window.matchMedia("(prefers-color-scheme: dark)");
     const onChange = (event) => setSystemDark(event.matches);
     media.addEventListener("change", onChange);
     return () => media.removeEventListener("change", onChange);
   }, []);
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (!canUseDom()) return;
     const sync = () => setPreferenceState(readTheme(stableOptions));
     const onStorage = (event) => {
@@ -6307,7 +6338,7 @@ function useStreamoidThemePreference(options = {}) {
     };
   }, [stableOptions]);
   const resolved = preference === "system" ? systemDark ? "dark" : "light" : preference;
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (!canUseDom() || !stableOptions.applyToDocument) return;
     const root = document.documentElement;
     root.setAttribute("data-theme", resolved === "light" ? "Light" : "Dark");
@@ -6317,15 +6348,15 @@ function useStreamoidThemePreference(options = {}) {
 }
 function useStreamoidSidebarPreference(options = {}) {
   const legacyKeySignature = (options.legacyCollapsedKeys ?? []).join("\0");
-  const stableOptions = (0, import_react19.useMemo)(
+  const stableOptions = (0, import_react20.useMemo)(
     () => ({
       defaultExpanded: options.defaultExpanded,
       legacyCollapsedKeys: legacyKeySignature ? legacyKeySignature.split("\0") : []
     }),
     [options.defaultExpanded, legacyKeySignature]
   );
-  const [expanded, setExpandedState] = (0, import_react19.useState)(() => readExpanded(stableOptions));
-  const setExpanded = (0, import_react19.useCallback)((nextExpanded) => {
+  const [expanded, setExpandedState] = (0, import_react20.useState)(() => readExpanded(stableOptions));
+  const setExpanded = (0, import_react20.useCallback)((nextExpanded) => {
     setExpandedState(nextExpanded);
     const serialized = nextExpanded ? "expanded" : "collapsed";
     writeStorage(SIDEBAR_STORAGE_KEY, serialized);
@@ -6334,7 +6365,7 @@ function useStreamoidSidebarPreference(options = {}) {
     );
     writeCookie(SIDEBAR_COOKIE, serialized);
   }, [stableOptions]);
-  const toggle = (0, import_react19.useCallback)(() => {
+  const toggle = (0, import_react20.useCallback)(() => {
     setExpandedState((current) => {
       const next = !current;
       const serialized = next ? "expanded" : "collapsed";
@@ -6346,7 +6377,7 @@ function useStreamoidSidebarPreference(options = {}) {
       return next;
     });
   }, [stableOptions]);
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     const serialized = expanded ? "expanded" : "collapsed";
     writeStorage(SIDEBAR_STORAGE_KEY, serialized);
     stableOptions.legacyCollapsedKeys.forEach(
@@ -6354,7 +6385,7 @@ function useStreamoidSidebarPreference(options = {}) {
     );
     writeCookie(SIDEBAR_COOKIE, serialized);
   }, [expanded, stableOptions]);
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (!canUseDom()) return;
     const sync = () => setExpandedState(readExpanded(stableOptions));
     const onStorage = (event) => {
@@ -6373,7 +6404,7 @@ function useStreamoidSidebarPreference(options = {}) {
 }
 
 // src/SC-SidebarShell/useStreamoidAnchoredPopoverPosition.ts
-var import_react20 = require("react");
+var import_react21 = require("react");
 var ARROW_EDGE_INSET = 18;
 function resolveAnchoredPopoverArrow({
   anchor,
@@ -6428,7 +6459,7 @@ function useStreamoidAnchoredPopover(anchorRef, panelRef, {
   inset = DEFAULT_INSET,
   alignRef
 }) {
-  const [state, setState] = (0, import_react20.useState)({
+  const [state, setState] = (0, import_react21.useState)({
     style: {
       position: "fixed",
       left: 0,
@@ -6440,7 +6471,7 @@ function useStreamoidAnchoredPopover(anchorRef, panelRef, {
     },
     arrow: null
   });
-  (0, import_react20.useLayoutEffect)(() => {
+  (0, import_react21.useLayoutEffect)(() => {
     const anchor = anchorRef.current;
     if (!anchor || typeof window === "undefined") return;
     const measure = () => {
@@ -6491,7 +6522,7 @@ function useStreamoidAnchoredPopover(anchorRef, panelRef, {
   return state;
 }
 function useStreamoidAnchoredPopoverPosition(anchorRef, panelRef, { width, gap = DEFAULT_GAP, inset = DEFAULT_INSET }) {
-  const [position, setPosition] = (0, import_react20.useState)({
+  const [position, setPosition] = (0, import_react21.useState)({
     position: "fixed",
     left: 0,
     top: 0,
@@ -6500,7 +6531,7 @@ function useStreamoidAnchoredPopoverPosition(anchorRef, panelRef, { width, gap =
     maxHeight: `calc(100dvh - ${inset * 2}px)`,
     visibility: "hidden"
   });
-  (0, import_react20.useLayoutEffect)(() => {
+  (0, import_react21.useLayoutEffect)(() => {
     const anchor = anchorRef.current;
     if (!anchor || typeof window === "undefined") return;
     const measure = () => {
@@ -6544,7 +6575,7 @@ function useStreamoidAnchoredPopoverPosition(anchorRef, panelRef, { width, gap =
 }
 
 // src/SC-SidebarShell/useStreamoidSidebarPopoverPosition.ts
-var import_react21 = require("react");
+var import_react22 = require("react");
 var VIEWPORT_INSET = 16;
 function useStreamoidSidebarPopoverPosition(sidebarRef, {
   placement,
@@ -6552,7 +6583,7 @@ function useStreamoidSidebarPopoverPosition(sidebarRef, {
   gap = 8,
   inset = 0
 }) {
-  const [position, setPosition] = (0, import_react21.useState)({
+  const [position, setPosition] = (0, import_react22.useState)({
     position: "fixed",
     left: 0,
     top: 0,
@@ -6561,7 +6592,7 @@ function useStreamoidSidebarPopoverPosition(sidebarRef, {
     maxHeight: `calc(100dvh - ${VIEWPORT_INSET * 2}px)`,
     visibility: "hidden"
   });
-  (0, import_react21.useLayoutEffect)(() => {
+  (0, import_react22.useLayoutEffect)(() => {
     const sidebar = sidebarRef.current;
     if (!sidebar || typeof window === "undefined") return;
     const findCard = () => (sidebar.matches("[data-streamoid-sidebar-card]") ? sidebar : sidebar.querySelector(
@@ -6622,7 +6653,7 @@ function useStreamoidSidebarPopoverPosition(sidebarRef, {
 }
 
 // src/SC-SidebarShell/ScSidebarPopover.tsx
-var import_react22 = require("react");
+var import_react23 = require("react");
 var import_react_dom2 = require("react-dom");
 var import_jsx_runtime56 = require("react/jsx-runtime");
 var SURFACE = "var(--sc-sidebar-popover-surface, var(--alias-surface-base, #101010))";
@@ -6641,13 +6672,13 @@ function ScSidebarPopover({
   className,
   style
 }) {
-  const panelRef = (0, import_react22.useRef)(null);
+  const panelRef = (0, import_react23.useRef)(null);
   const { style: position, arrow } = useStreamoidAnchoredPopover(
     anchorRef,
     panelRef,
     { width, alignRef }
   );
-  (0, import_react22.useEffect)(() => {
+  (0, import_react23.useEffect)(() => {
     const onKeyDown = (event) => {
       if (event.key === "Escape") onClose();
     };
@@ -6698,7 +6729,7 @@ function ScSidebarPopover({
 }
 
 // src/SC-Artifax-Sidebar/ScArtifaxSidebar.tsx
-var import_react23 = require("react");
+var import_react24 = require("react");
 
 // src/SC-Artifax-Sidebar/ScArtifaxSidebar.module.css
 var ScArtifaxSidebar_default = {
@@ -6805,7 +6836,8 @@ function SidebarHeader({
             expanded,
             label: header.searchLabel,
             shortcut: header.searchShortcut,
-            onClick: header.onSearchClick
+            onClick: header.onSearchClick,
+            onPrefetch: header.onSearchPrefetch
           }
         ),
         /* @__PURE__ */ (0, import_jsx_runtime57.jsx)(ScHDivider, { fullBleed: true, className: ScArtifaxSidebar_default.headerDivider })
@@ -6814,8 +6846,8 @@ function SidebarHeader({
   );
 }
 function useScrolled() {
-  const [scrolled, setScrolled] = (0, import_react23.useState)(false);
-  const onScroll = (0, import_react23.useCallback)((event) => {
+  const [scrolled, setScrolled] = (0, import_react24.useState)(false);
+  const onScroll = (0, import_react24.useCallback)((event) => {
     const next = event.currentTarget.scrollTop > 0;
     setScrolled((prev) => prev === next ? prev : next);
   }, []);
@@ -6856,7 +6888,7 @@ var ScAppSidebar = ({
   };
   const isControlled = !!openSections;
   const { scrolled, onScroll } = useScrolled();
-  const [internalOpen, setInternalOpen] = (0, import_react23.useState)(
+  const [internalOpen, setInternalOpen] = (0, import_react24.useState)(
     () => {
       const init = {};
       sections.forEach((s) => {
@@ -6866,7 +6898,7 @@ var ScAppSidebar = ({
     }
   );
   const isSectionOpen = (id) => isControlled ? !!openSections?.[id] : !!internalOpen[id];
-  const handleSectionToggle = (0, import_react23.useCallback)(
+  const handleSectionToggle = (0, import_react24.useCallback)(
     (id) => {
       const next = !isSectionOpen(id);
       if (isControlled) {
@@ -7100,7 +7132,7 @@ var ScAppSidebar = ({
 var ScArtifaxSidebar = ScAppSidebar;
 
 // src/SC-Catalogix-Sidebar/ScCatalogixSidebar.tsx
-var import_react24 = require("react");
+var import_react25 = require("react");
 
 // src/SC-Sidebar Switch menu/ScSidebarSwitchMenu.module.css
 var ScSidebarSwitchMenu_default = {
@@ -7742,7 +7774,7 @@ var ScCatalogixSidebar = ({
   className,
   style
 }) => {
-  const [appListOpen, setAppListOpen] = (0, import_react24.useState)(false);
+  const [appListOpen, setAppListOpen] = (0, import_react25.useState)(false);
   const handleSwitch = () => {
     setAppListOpen((prev) => !prev);
     onLogoClick?.();
@@ -7985,7 +8017,7 @@ var ScSlider = ({
 };
 
 // src/SC-WorkspaceSwitcher/streamoid-workspace-switcher.tsx
-var import_react25 = require("react");
+var import_react26 = require("react");
 var import_icons42 = require("@streamoid/icons");
 var import_jsx_runtime64 = require("react/jsx-runtime");
 var PRIMARY_ICON = "var(--alias-text---icons-primary)";
@@ -8176,12 +8208,12 @@ function StreamoidWorkspaceSwitcher({
   onSwitchWorkspace,
   config
 }) {
-  const modalRef = (0, import_react25.useRef)(null);
+  const modalRef = (0, import_react26.useRef)(null);
   const title = config?.title || "Switch workspace";
   const loadingText = config?.loadingText || "Loading workspaces\u2026";
   const currentWorkspaceText = config?.currentWorkspaceText || "Current workspace";
   const switchWorkspaceText = config?.switchWorkspaceText || "Switch workspace";
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     if (!open) return;
     function handleKeyDown(e) {
       if (e.key === "Escape") onClose();
@@ -9592,7 +9624,7 @@ var ScWorkspaceCard = ({
 };
 
 // src/SC-WorkspaceSwitchCard/ScWorkspaceSwitchCard.tsx
-var import_react26 = require("react");
+var import_react27 = require("react");
 var import_icons62 = require("@streamoid/icons");
 
 // src/SC-WorkspaceSwitchCard/ScWorkspaceSwitchCard.module.css
@@ -9633,7 +9665,7 @@ function ScWorkspaceSwitchCard({
   onSettings,
   onLeave
 }) {
-  const [internalHover, setInternalHover] = (0, import_react26.useState)(false);
+  const [internalHover, setInternalHover] = (0, import_react27.useState)(false);
   const isHover = hover !== void 0 ? hover : internalHover;
   const isCurrent = type === "currentWS";
   const isOther = type === "otherWS";
@@ -9761,7 +9793,7 @@ function ScWorkspaceSwitchCard({
 var NscWorkspaceSwitch = ScWorkspaceSwitchCard;
 
 // src/SC-Modal/ScModal.tsx
-var import_react27 = require("react");
+var import_react28 = require("react");
 var import_react_dom3 = require("react-dom");
 
 // src/SC-Modal/ScModal.module.css
@@ -9783,7 +9815,7 @@ var ScModal = ({
   closeOnBackdrop = true,
   closeOnEsc = true
 }) => {
-  (0, import_react27.useEffect)(() => {
+  (0, import_react28.useEffect)(() => {
     if (!open || !closeOnEsc) return;
     const onKey = (e) => {
       if (e.key === "Escape") onClose?.();
@@ -9816,7 +9848,7 @@ var ScModal = ({
 };
 
 // src/SC-Drawer/ScDrawer.tsx
-var import_react28 = require("react");
+var import_react29 = require("react");
 var import_react_dom4 = require("react-dom");
 
 // src/SC-Drawer/ScDrawer.module.css
@@ -9844,8 +9876,8 @@ var ScDrawer = ({
   backdrop = false,
   zIndex
 }) => {
-  const panelRef = (0, import_react28.useRef)(null);
-  (0, import_react28.useEffect)(() => {
+  const panelRef = (0, import_react29.useRef)(null);
+  (0, import_react29.useEffect)(() => {
     if (!open) return;
     const onKey = (e) => {
       if (closeOnEsc && e.key === "Escape") onClose?.();
@@ -9943,7 +9975,7 @@ var ScTabs = ({
 };
 
 // src/SC-Counter/ScCounter.tsx
-var import_react29 = require("react");
+var import_react30 = require("react");
 var import_icons63 = require("@streamoid/icons");
 
 // src/SC-Counter/ScCounter.module.css
@@ -9965,7 +9997,7 @@ var ScCounter = ({
   className,
   style
 }) => {
-  const [showInput, setShowInput] = (0, import_react29.useState)(false);
+  const [showInput, setShowInput] = (0, import_react30.useState)(false);
   const set = (n) => {
     let v = n;
     if (min !== void 0) v = Math.max(min, v);
@@ -11054,7 +11086,7 @@ var ScSelectionList = ({
 };
 
 // src/SC-textArea/ScTextArea.tsx
-var import_react30 = require("react");
+var import_react31 = require("react");
 
 // src/SC-textArea/ScTextArea.module.css
 var ScTextArea_default = {
@@ -11084,7 +11116,7 @@ var ScTextArea = ({
   style,
   ...props
 }) => {
-  const [focused, setFocused] = (0, import_react30.useState)(false);
+  const [focused, setFocused] = (0, import_react31.useState)(false);
   const derivedState = state ?? (props.disabled ? "disabled" : focused ? "active" : (props.value !== void 0 ? String(props.value).length > 0 : false) ? "filled" : "default");
   const stateClass = ScTextArea_default["state-" + derivedState];
   const labelGroupClass = ScTextArea_default["label-group-" + (labelGroup || "none")];
@@ -11126,7 +11158,7 @@ var ScTextArea = ({
 };
 
 // src/SC-select/ScSelect.tsx
-var import_react31 = require("react");
+var import_react32 = require("react");
 
 // src/SC-select/ScSelect.module.css
 var ScSelect_default = {
@@ -11163,9 +11195,9 @@ var ScSelect = (props) => {
     disabled = false,
     className
   } = props;
-  const [open, setOpen] = (0, import_react31.useState)(false);
-  const rootRef = (0, import_react31.useRef)(null);
-  (0, import_react31.useEffect)(() => {
+  const [open, setOpen] = (0, import_react32.useState)(false);
+  const rootRef = (0, import_react32.useRef)(null);
+  (0, import_react32.useEffect)(() => {
     if (!open) return;
     const handleClick = (e) => {
       if (rootRef.current && !rootRef.current.contains(e.target)) {
@@ -11256,7 +11288,7 @@ var ScSelect = (props) => {
 };
 
 // src/SC-fileField/ScFileField.tsx
-var import_react32 = require("react");
+var import_react33 = require("react");
 
 // src/SC-fileField/ScFileField.module.css
 var ScFileField_default = {
@@ -11294,7 +11326,7 @@ var ScFileField = (props) => {
     label,
     className
   } = props;
-  const inputRef = (0, import_react32.useRef)(null);
+  const inputRef = (0, import_react33.useRef)(null);
   const hasFile = Boolean(fileName);
   const isUploading = Boolean(uploading);
   const clampedProgress = Math.max(0, Math.min(100, progress));
@@ -11413,7 +11445,7 @@ var ScFileField = (props) => {
 };
 
 // src/SC-mediaApproval/ScMediaApproval.tsx
-var import_react33 = require("react");
+var import_react34 = require("react");
 
 // src/SC-mediaApproval/ScMediaApproval.module.css
 var ScMediaApproval_default = {
@@ -11460,9 +11492,9 @@ var ScMediaApproval = (props) => {
     className
   } = props;
   const total = mediaUrls.length;
-  const [index, setIndex] = (0, import_react33.useState)(activeIndex ?? 0);
-  const [mediaLoading, setMediaLoading] = (0, import_react33.useState)(false);
-  (0, import_react33.useEffect)(() => {
+  const [index, setIndex] = (0, import_react34.useState)(activeIndex ?? 0);
+  const [mediaLoading, setMediaLoading] = (0, import_react34.useState)(false);
+  (0, import_react34.useEffect)(() => {
     if (typeof activeIndex === "number") {
       setIndex(activeIndex);
     }
@@ -11597,7 +11629,7 @@ var ScMediaApproval = (props) => {
 };
 
 // src/SC-mediaSelect/ScMediaSelect.tsx
-var import_react34 = require("react");
+var import_react35 = require("react");
 
 // src/SC-mediaSelect/ScMediaSelect.module.css
 var ScMediaSelect_default = {
@@ -11653,7 +11685,7 @@ var ScMediaSelect = (props) => {
   } = props;
   const total = items.length;
   const resolvedMax = typeof max === "number" ? max : total;
-  const selectedSet = (0, import_react34.useMemo)(() => new Set(selected), [selected]);
+  const selectedSet = (0, import_react35.useMemo)(() => new Set(selected), [selected]);
   const selectedCount = selectedSet.size;
   let countLabel = selectedCount + " of " + total + " selected";
   if (min > 0) countLabel += " (min " + min + ")";
@@ -11722,7 +11754,7 @@ var ScMediaSelect = (props) => {
 };
 
 // src/SC-todoList/ScTodoList.tsx
-var import_react35 = require("react");
+var import_react36 = require("react");
 
 // src/SC-todoList/ScTodoList.module.css
 var ScTodoList_default = {
@@ -11755,9 +11787,9 @@ var ScTodoList = ({
   addPlaceholder = "Add an item",
   className
 }) => {
-  const [editingId, setEditingId] = (0, import_react35.useState)(null);
-  const [editValue, setEditValue] = (0, import_react35.useState)("");
-  const [newValue, setNewValue] = (0, import_react35.useState)("");
+  const [editingId, setEditingId] = (0, import_react36.useState)(null);
+  const [editValue, setEditValue] = (0, import_react36.useState)("");
+  const [newValue, setNewValue] = (0, import_react36.useState)("");
   const total = items.length;
   const completed = items.filter((i) => i.status === "completed").length;
   const startEditing = (item) => {
@@ -12611,7 +12643,7 @@ var ScWorkspaceSwitchMobileV2 = ({
 };
 
 // src/SC-imageField/ScImageField.tsx
-var import_react36 = require("react");
+var import_react37 = require("react");
 
 // src/SC-imageField/ScImageField.module.css
 var ScImageField_default = {
@@ -12638,7 +12670,7 @@ var ScImageField = ({
   onRemove,
   className
 }) => {
-  const inputRef = (0, import_react36.useRef)(null);
+  const inputRef = (0, import_react37.useRef)(null);
   const hasImage = !!imagePreview;
   function handleClick() {
     if (!hasImage) {
@@ -12874,7 +12906,7 @@ var ScPlanDetailsCardMobile = ({
 };
 
 // src/SC-ProfilePopup/ScProfilePopup.tsx
-var import_react37 = require("react");
+var import_react38 = require("react");
 
 // src/SC-ProfilePopup/ScProfilePopup.module.css
 var ScProfilePopup_default = {
@@ -12908,7 +12940,7 @@ var activateOnKey = (handler) => (event) => {
     handler();
   }
 };
-var ScProfilePopup = (0, import_react37.forwardRef)(
+var ScProfilePopup = (0, import_react38.forwardRef)(
   ({
     name = "Chris Hemsworth",
     email = "chris@kepler.com",

package/dist/index.mjs

@@ -5732,6 +5732,7 @@ function ScSidebarSearchTrigger({
   label = "Search or Ask CXO",
   shortcut = "\u2318 K",
   onClick,
+  onPrefetch,
   className
 }) {
   return /* @__PURE__ */ jsxs43(
@@ -5740,6 +5741,8 @@ function ScSidebarSearchTrigger({
       type: "button",
       "aria-label": label,
       onClick,
+      onPointerEnter: onPrefetch,
+      onFocus: onPrefetch,
       className: `${ScSidebarShell_default.searchTrigger} ${expanded ? ScSidebarShell_default.searchTriggerExpanded : ScSidebarShell_default.searchTriggerCollapsed}${className ? ` ${className}` : ""}`,
       children: [
         /* @__PURE__ */ jsx54(
@@ -5988,8 +5991,34 @@ function ScWorkspaceAccountMenu({
   );
 }
 
+// src/SC-SidebarShell/useStreamoidSearchShortcut.ts
+import { useEffect as useEffect5, useRef as useRef6 } from "react";
+function matchesStreamoidSearchShortcut(event, letter = "k") {
+  if (event.altKey) return false;
+  if (!event.metaKey && !event.ctrlKey) return false;
+  return event.key.toLowerCase() === letter.toLowerCase();
+}
+function useStreamoidSearchShortcut({
+  onTrigger,
+  enabled = true,
+  letter = "k"
+}) {
+  const handler = useRef6(onTrigger);
+  handler.current = onTrigger;
+  useEffect5(() => {
+    if (!enabled) return;
+    const onKeyDown = (event) => {
+      if (!matchesStreamoidSearchShortcut(event, letter)) return;
+      event.preventDefault();
+      handler.current();
+    };
+    document.addEventListener("keydown", onKeyDown);
+    return () => document.removeEventListener("keydown", onKeyDown);
+  }, [enabled, letter]);
+}
+
 // src/SC-SidebarShell/useStreamoidShellPreferences.ts
-import { useCallback as useCallback2, useEffect as useEffect5, useMemo, useState as useState14 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect6, useMemo, useState as useState14 } from "react";
 var THEME_COOKIE = "streamoid_theme";
 var SIDEBAR_COOKIE = "streamoid_sidebar";
 var THEME_STORAGE_KEY = "streamoid.shell.theme";
@@ -6091,19 +6120,19 @@ function useStreamoidThemePreference(options = {}) {
     stableOptions.legacyStorageKeys.forEach((key) => writeStorage(key, mode));
     writeCookie(THEME_COOKIE, mode);
   }, [stableOptions]);
-  useEffect5(() => {
+  useEffect6(() => {
     writeStorage(THEME_STORAGE_KEY, preference);
     stableOptions.legacyStorageKeys.forEach((key) => writeStorage(key, preference));
     writeCookie(THEME_COOKIE, preference);
   }, [preference, stableOptions]);
-  useEffect5(() => {
+  useEffect6(() => {
     if (!canUseDom()) return;
     const media = window.matchMedia("(prefers-color-scheme: dark)");
     const onChange = (event) => setSystemDark(event.matches);
     media.addEventListener("change", onChange);
     return () => media.removeEventListener("change", onChange);
   }, []);
-  useEffect5(() => {
+  useEffect6(() => {
     if (!canUseDom()) return;
     const sync = () => setPreferenceState(readTheme(stableOptions));
     const onStorage = (event) => {
@@ -6119,7 +6148,7 @@ function useStreamoidThemePreference(options = {}) {
     };
   }, [stableOptions]);
   const resolved = preference === "system" ? systemDark ? "dark" : "light" : preference;
-  useEffect5(() => {
+  useEffect6(() => {
     if (!canUseDom() || !stableOptions.applyToDocument) return;
     const root = document.documentElement;
     root.setAttribute("data-theme", resolved === "light" ? "Light" : "Dark");
@@ -6158,7 +6187,7 @@ function useStreamoidSidebarPreference(options = {}) {
       return next;
     });
   }, [stableOptions]);
-  useEffect5(() => {
+  useEffect6(() => {
     const serialized = expanded ? "expanded" : "collapsed";
     writeStorage(SIDEBAR_STORAGE_KEY, serialized);
     stableOptions.legacyCollapsedKeys.forEach(
@@ -6166,7 +6195,7 @@ function useStreamoidSidebarPreference(options = {}) {
     );
     writeCookie(SIDEBAR_COOKIE, serialized);
   }, [expanded, stableOptions]);
-  useEffect5(() => {
+  useEffect6(() => {
     if (!canUseDom()) return;
     const sync = () => setExpandedState(readExpanded(stableOptions));
     const onStorage = (event) => {
@@ -6441,8 +6470,8 @@ function useStreamoidSidebarPopoverPosition(sidebarRef, {
 
 // src/SC-SidebarShell/ScSidebarPopover.tsx
 import {
-  useEffect as useEffect6,
-  useRef as useRef6
+  useEffect as useEffect7,
+  useRef as useRef7
 } from "react";
 import { createPortal as createPortal2 } from "react-dom";
 import { jsx as jsx55, jsxs as jsxs44 } from "react/jsx-runtime";
@@ -6462,13 +6491,13 @@ function ScSidebarPopover({
   className,
   style
 }) {
-  const panelRef = useRef6(null);
+  const panelRef = useRef7(null);
   const { style: position, arrow } = useStreamoidAnchoredPopover(
     anchorRef,
     panelRef,
     { width, alignRef }
   );
-  useEffect6(() => {
+  useEffect7(() => {
     const onKeyDown = (event) => {
       if (event.key === "Escape") onClose();
     };
@@ -6629,7 +6658,8 @@ function SidebarHeader({
             expanded,
             label: header.searchLabel,
             shortcut: header.searchShortcut,
-            onClick: header.onSearchClick
+            onClick: header.onSearchClick,
+            onPrefetch: header.onSearchPrefetch
           }
         ),
         /* @__PURE__ */ jsx56(ScHDivider, { fullBleed: true, className: ScArtifaxSidebar_default.headerDivider })
@@ -7815,7 +7845,7 @@ var ScSlider = ({
 };
 
 // src/SC-WorkspaceSwitcher/streamoid-workspace-switcher.tsx
-import { useEffect as useEffect7, useRef as useRef7 } from "react";
+import { useEffect as useEffect8, useRef as useRef8 } from "react";
 import {
   SiconClose as SiconClose3,
   SiconTeam as SiconTeam5,
@@ -8011,12 +8041,12 @@ function StreamoidWorkspaceSwitcher({
   onSwitchWorkspace,
   config
 }) {
-  const modalRef = useRef7(null);
+  const modalRef = useRef8(null);
   const title = config?.title || "Switch workspace";
   const loadingText = config?.loadingText || "Loading workspaces\u2026";
   const currentWorkspaceText = config?.currentWorkspaceText || "Current workspace";
   const switchWorkspaceText = config?.switchWorkspaceText || "Switch workspace";
-  useEffect7(() => {
+  useEffect8(() => {
     if (!open) return;
     function handleKeyDown(e) {
       if (e.key === "Escape") onClose();
@@ -9601,7 +9631,7 @@ function ScWorkspaceSwitchCard({
 var NscWorkspaceSwitch = ScWorkspaceSwitchCard;
 
 // src/SC-Modal/ScModal.tsx
-import { useEffect as useEffect8 } from "react";
+import { useEffect as useEffect9 } from "react";
 import { createPortal as createPortal3 } from "react-dom";
 
 // src/SC-Modal/ScModal.module.css
@@ -9623,7 +9653,7 @@ var ScModal = ({
   closeOnBackdrop = true,
   closeOnEsc = true
 }) => {
-  useEffect8(() => {
+  useEffect9(() => {
     if (!open || !closeOnEsc) return;
     const onKey = (e) => {
       if (e.key === "Escape") onClose?.();
@@ -9656,7 +9686,7 @@ var ScModal = ({
 };
 
 // src/SC-Drawer/ScDrawer.tsx
-import { useEffect as useEffect9, useRef as useRef8 } from "react";
+import { useEffect as useEffect10, useRef as useRef9 } from "react";
 import { createPortal as createPortal4 } from "react-dom";
 
 // src/SC-Drawer/ScDrawer.module.css
@@ -9684,8 +9714,8 @@ var ScDrawer = ({
   backdrop = false,
   zIndex
 }) => {
-  const panelRef = useRef8(null);
-  useEffect9(() => {
+  const panelRef = useRef9(null);
+  useEffect10(() => {
     if (!open) return;
     const onKey = (e) => {
       if (closeOnEsc && e.key === "Escape") onClose?.();
@@ -10972,7 +11002,7 @@ var ScTextArea = ({
 };
 
 // src/SC-select/ScSelect.tsx
-import { useState as useState22, useRef as useRef9, useEffect as useEffect10 } from "react";
+import { useState as useState22, useRef as useRef10, useEffect as useEffect11 } from "react";
 
 // src/SC-select/ScSelect.module.css
 var ScSelect_default = {
@@ -11010,8 +11040,8 @@ var ScSelect = (props) => {
     className
   } = props;
   const [open, setOpen] = useState22(false);
-  const rootRef = useRef9(null);
-  useEffect10(() => {
+  const rootRef = useRef10(null);
+  useEffect11(() => {
     if (!open) return;
     const handleClick = (e) => {
       if (rootRef.current && !rootRef.current.contains(e.target)) {
@@ -11102,7 +11132,7 @@ var ScSelect = (props) => {
 };
 
 // src/SC-fileField/ScFileField.tsx
-import { useRef as useRef10 } from "react";
+import { useRef as useRef11 } from "react";
 
 // src/SC-fileField/ScFileField.module.css
 var ScFileField_default = {
@@ -11140,7 +11170,7 @@ var ScFileField = (props) => {
     label,
     className
   } = props;
-  const inputRef = useRef10(null);
+  const inputRef = useRef11(null);
   const hasFile = Boolean(fileName);
   const isUploading = Boolean(uploading);
   const clampedProgress = Math.max(0, Math.min(100, progress));
@@ -11259,7 +11289,7 @@ var ScFileField = (props) => {
 };
 
 // src/SC-mediaApproval/ScMediaApproval.tsx
-import { useState as useState23, useEffect as useEffect11 } from "react";
+import { useState as useState23, useEffect as useEffect12 } from "react";
 
 // src/SC-mediaApproval/ScMediaApproval.module.css
 var ScMediaApproval_default = {
@@ -11308,7 +11338,7 @@ var ScMediaApproval = (props) => {
   const total = mediaUrls.length;
   const [index, setIndex] = useState23(activeIndex ?? 0);
   const [mediaLoading, setMediaLoading] = useState23(false);
-  useEffect11(() => {
+  useEffect12(() => {
     if (typeof activeIndex === "number") {
       setIndex(activeIndex);
     }
@@ -12457,7 +12487,7 @@ var ScWorkspaceSwitchMobileV2 = ({
 };
 
 // src/SC-imageField/ScImageField.tsx
-import { useRef as useRef11 } from "react";
+import { useRef as useRef12 } from "react";
 
 // src/SC-imageField/ScImageField.module.css
 var ScImageField_default = {
@@ -12484,7 +12514,7 @@ var ScImageField = ({
   onRemove,
   className
 }) => {
-  const inputRef = useRef11(null);
+  const inputRef = useRef12(null);
   const hasImage = !!imagePreview;
   function handleClick() {
     if (!hasImage) {
@@ -13102,6 +13132,7 @@ export {
   formatStreamoidAppVersion,
   formatSubAgentLabel,
   hasCollapsedMark,
+  matchesStreamoidSearchShortcut,
   parseVersionManifest,
   resolveAnchoredPopoverArrow,
   resolveAnchoredPopoverPosition,
@@ -13118,6 +13149,7 @@ export {
   useStreamoidAnchoredPopover,
   useStreamoidAnchoredPopoverPosition,
   useStreamoidPanelWidth,
+  useStreamoidSearchShortcut,
   useStreamoidSidebarPopoverPosition,
   useStreamoidSidebarPreference,
   useStreamoidThemePreference

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamoid/ui",
-  "version": "0.6.55",
+  "version": "0.6.56",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -21,7 +21,8 @@
     "watch:dts": "tsup src/index.ts --dts-only --watch",
     "dev": "sh -c 'npm run watch:js & npm run watch:dts & wait'",
     "lint": "eslint src/",
-    "test:panel-resize": "npm run build:js && node --test tests/panel-resize.test.mjs"
+    "test:panel-resize": "npm run build:js && node --test tests/panel-resize.test.mjs",
+    "test:search-shortcut": "npm run build:js && node --test tests/search-shortcut.test.mjs"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",