@arbidocs/blocks 0.4.141 → 0.4.142

package/dist/shell/index.cjs

@@ -1,14 +1,15 @@
 "use client";
 'use strict';
 
-var chunkGFRQG36Y_cjs = require('../chunk-GFRQG36Y.cjs');
+var chunkYFY3TQ6Q_cjs = require('../chunk-YFY3TQ6Q.cjs');
 var chunkV46W7YLI_cjs = require('../chunk-V46W7YLI.cjs');
+require('../chunk-AHDJXIUB.cjs');
 require('../chunk-R26BK7YL.cjs');
 var chunk2EI7NCUA_cjs = require('../chunk-2EI7NCUA.cjs');
+var chunk7RGLTF76_cjs = require('../chunk-7RGLTF76.cjs');
 var chunk5UHAWSEX_cjs = require('../chunk-5UHAWSEX.cjs');
 var chunkB6MVQCXW_cjs = require('../chunk-B6MVQCXW.cjs');
 var chunkFX3K6LNZ_cjs = require('../chunk-FX3K6LNZ.cjs');
-var chunk7RGLTF76_cjs = require('../chunk-7RGLTF76.cjs');
 require('../chunk-PPCATBOY.cjs');
 require('../chunk-MHVNT4J3.cjs');
 require('../chunk-C4WSHRR6.cjs');
@@ -19,155 +20,167 @@ require('../chunk-DES3K4SD.cjs');
 
 Object.defineProperty(exports, "ActionCluster", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.ActionCluster; }
+  get: function () { return chunkYFY3TQ6Q_cjs.ActionCluster; }
 });
 Object.defineProperty(exports, "AskField", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.AskField; }
+  get: function () { return chunkYFY3TQ6Q_cjs.AskField; }
 });
 Object.defineProperty(exports, "AskRow", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.AskRow; }
+  get: function () { return chunkYFY3TQ6Q_cjs.AskRow; }
 });
 Object.defineProperty(exports, "AskTrigger", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.AskTrigger; }
+  get: function () { return chunkYFY3TQ6Q_cjs.AskTrigger; }
 });
 Object.defineProperty(exports, "DEFAULT_ASK_FIELD_LABELS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.DEFAULT_ASK_FIELD_LABELS; }
+  get: function () { return chunkYFY3TQ6Q_cjs.DEFAULT_ASK_FIELD_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_INSTALL_PROMPT_LABELS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.DEFAULT_INSTALL_PROMPT_LABELS; }
+  get: function () { return chunkYFY3TQ6Q_cjs.DEFAULT_INSTALL_PROMPT_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_MOBILE_BARS_LABELS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.DEFAULT_MOBILE_BARS_LABELS; }
+  get: function () { return chunkYFY3TQ6Q_cjs.DEFAULT_MOBILE_BARS_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_OFFLINE_PILL_LABELS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.DEFAULT_OFFLINE_PILL_LABELS; }
+  get: function () { return chunkYFY3TQ6Q_cjs.DEFAULT_OFFLINE_PILL_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_REMOTE_CONTROL_PILL_LABELS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.DEFAULT_REMOTE_CONTROL_PILL_LABELS; }
+  get: function () { return chunkYFY3TQ6Q_cjs.DEFAULT_REMOTE_CONTROL_PILL_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_SIDEBAR_LABELS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.DEFAULT_SIDEBAR_LABELS; }
+  get: function () { return chunkYFY3TQ6Q_cjs.DEFAULT_SIDEBAR_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_TIP_CARD_LABELS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.DEFAULT_TIP_CARD_LABELS; }
+  get: function () { return chunkYFY3TQ6Q_cjs.DEFAULT_TIP_CARD_LABELS; }
 });
 Object.defineProperty(exports, "INSTALL_PROMPT_DISMISSED_KEY", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.INSTALL_PROMPT_DISMISSED_KEY; }
+  get: function () { return chunkYFY3TQ6Q_cjs.INSTALL_PROMPT_DISMISSED_KEY; }
 });
 Object.defineProperty(exports, "InfoBar", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.InfoBar; }
+  get: function () { return chunkYFY3TQ6Q_cjs.InfoBar; }
 });
 Object.defineProperty(exports, "InstallPrompt", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.InstallPrompt; }
+  get: function () { return chunkYFY3TQ6Q_cjs.InstallPrompt; }
 });
 Object.defineProperty(exports, "MobileAppBar", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.MobileAppBar; }
+  get: function () { return chunkYFY3TQ6Q_cjs.MobileAppBar; }
 });
 Object.defineProperty(exports, "MobileTabBar", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.MobileTabBar; }
+  get: function () { return chunkYFY3TQ6Q_cjs.MobileTabBar; }
 });
 Object.defineProperty(exports, "NotificationBell", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.NotificationBell; }
+  get: function () { return chunkYFY3TQ6Q_cjs.NotificationBell; }
 });
 Object.defineProperty(exports, "OfflinePill", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.OfflinePill; }
+  get: function () { return chunkYFY3TQ6Q_cjs.OfflinePill; }
 });
 Object.defineProperty(exports, "RemoteControlPill", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.RemoteControlPill; }
+  get: function () { return chunkYFY3TQ6Q_cjs.RemoteControlPill; }
 });
 Object.defineProperty(exports, "STATUS_ROW_BASE_CLASS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.STATUS_ROW_BASE_CLASS; }
+  get: function () { return chunkYFY3TQ6Q_cjs.STATUS_ROW_BASE_CLASS; }
 });
 Object.defineProperty(exports, "STATUS_ROW_TONES", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.STATUS_ROW_TONES; }
+  get: function () { return chunkYFY3TQ6Q_cjs.STATUS_ROW_TONES; }
+});
+Object.defineProperty(exports, "ShellSidebar", {
+  enumerable: true,
+  get: function () { return chunkYFY3TQ6Q_cjs.ShellSidebar; }
 });
 Object.defineProperty(exports, "Sidebar", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.Sidebar; }
+  get: function () { return chunkYFY3TQ6Q_cjs.Sidebar; }
 });
 Object.defineProperty(exports, "SidebarBadgeRow", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.SidebarBadgeRow; }
+  get: function () { return chunkYFY3TQ6Q_cjs.SidebarBadgeRow; }
 });
 Object.defineProperty(exports, "SidebarRowAction", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.SidebarRowAction; }
+  get: function () { return chunkYFY3TQ6Q_cjs.SidebarRowAction; }
 });
 Object.defineProperty(exports, "SidebarRowHoverContext", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.SidebarRowHoverContext; }
+  get: function () { return chunkYFY3TQ6Q_cjs.SidebarRowHoverContext; }
 });
 Object.defineProperty(exports, "SplitLayout", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.SplitLayout; }
+  get: function () { return chunkYFY3TQ6Q_cjs.SplitLayout; }
 });
 Object.defineProperty(exports, "StatusBadge", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.StatusBadge; }
+  get: function () { return chunkYFY3TQ6Q_cjs.StatusBadge; }
 });
 Object.defineProperty(exports, "StatusRow", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.StatusRow; }
+  get: function () { return chunkYFY3TQ6Q_cjs.StatusRow; }
 });
 Object.defineProperty(exports, "TipCard", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.TipCard; }
+  get: function () { return chunkYFY3TQ6Q_cjs.TipCard; }
 });
 Object.defineProperty(exports, "UserMenu", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.UserMenu; }
+  get: function () { return chunkYFY3TQ6Q_cjs.UserMenu; }
 });
 Object.defineProperty(exports, "getInstallInstructions", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.getInstallInstructions; }
+  get: function () { return chunkYFY3TQ6Q_cjs.getInstallInstructions; }
 });
 Object.defineProperty(exports, "initInstallPrompt", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.initInstallPrompt; }
+  get: function () { return chunkYFY3TQ6Q_cjs.initInstallPrompt; }
 });
 Object.defineProperty(exports, "isIosDevice", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.isIosDevice; }
+  get: function () { return chunkYFY3TQ6Q_cjs.isIosDevice; }
 });
 Object.defineProperty(exports, "promptAppInstall", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.promptAppInstall; }
+  get: function () { return chunkYFY3TQ6Q_cjs.promptAppInstall; }
 });
 Object.defineProperty(exports, "resolveSidebarLayout", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.resolveSidebarLayout; }
+  get: function () { return chunkYFY3TQ6Q_cjs.resolveSidebarLayout; }
+});
+Object.defineProperty(exports, "useCloseOnEscape", {
+  enumerable: true,
+  get: function () { return chunkYFY3TQ6Q_cjs.useCloseOnEscape; }
 });
 Object.defineProperty(exports, "useInstallPrompt", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.useInstallPrompt; }
+  get: function () { return chunkYFY3TQ6Q_cjs.useInstallPrompt; }
 });
 Object.defineProperty(exports, "useSidebarContext", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.useSidebarContext; }
+  get: function () { return chunkYFY3TQ6Q_cjs.useSidebarContext; }
+});
+Object.defineProperty(exports, "useSidebarController", {
+  enumerable: true,
+  get: function () { return chunkYFY3TQ6Q_cjs.useSidebarController; }
 });
 Object.defineProperty(exports, "useSidebarSettle", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.useSidebarSettle; }
+  get: function () { return chunkYFY3TQ6Q_cjs.useSidebarSettle; }
 });
 Object.defineProperty(exports, "DEFAULT_WORKSPACE_KIND_LABELS", {
   enumerable: true,
@@ -205,6 +218,14 @@ Object.defineProperty(exports, "FilterInput", {
   enumerable: true,
   get: function () { return chunk2EI7NCUA_cjs.FilterInput; }
 });
+Object.defineProperty(exports, "DEFAULT_TAB_HEADER_LABELS", {
+  enumerable: true,
+  get: function () { return chunk7RGLTF76_cjs.DEFAULT_TAB_HEADER_LABELS; }
+});
+Object.defineProperty(exports, "TabHeader", {
+  enumerable: true,
+  get: function () { return chunk7RGLTF76_cjs.TabHeader; }
+});
 Object.defineProperty(exports, "DEFAULT_DOCK_WIDTH", {
   enumerable: true,
   get: function () { return chunk5UHAWSEX_cjs.DEFAULT_DOCK_WIDTH; }
@@ -277,13 +298,5 @@ Object.defineProperty(exports, "useMediaQuery", {
   enumerable: true,
   get: function () { return chunkFX3K6LNZ_cjs.useMediaQuery; }
 });
-Object.defineProperty(exports, "DEFAULT_TAB_HEADER_LABELS", {
-  enumerable: true,
-  get: function () { return chunk7RGLTF76_cjs.DEFAULT_TAB_HEADER_LABELS; }
-});
-Object.defineProperty(exports, "TabHeader", {
-  enumerable: true,
-  get: function () { return chunk7RGLTF76_cjs.TabHeader; }
-});
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/shell/index.d.ts

@@ -1,6 +1,8 @@
 export { Shell, PageContainer, SidebarToggleButton, DEFAULT_SIDEBAR_TOGGLE_BUTTON_LABELS, DEFAULT_OVERLAY_ZONE_ID, DEFAULT_PAGE_CONTAINER_PADDING, useOverlayZoneId, type ShellRootProps, type ShellContentProps, type ShellTopbarProps, type ShellDockProps, type PageContainerProps, type SidebarToggleButtonProps, type SidebarToggleButtonLabels, } from './Shell';
 export { Sidebar, SidebarRowHoverContext, DEFAULT_SIDEBAR_LABELS, useSidebarContext, type SidebarRootProps, type SidebarNavProps, type SidebarNavItemProps, type SidebarSectionProps, type SidebarGroupProps, type SidebarPinToggleProps, type SidebarDrawerHeaderProps, type SidebarLabels, } from './Sidebar';
 export { SidebarBadgeRow, type SidebarBadgeRowProps } from './SidebarBadgeRow';
+export { ShellSidebar, type ShellSidebarProps } from './ShellSidebar';
+export { useSidebarController, type SidebarController, type SidebarControllerRootProps, type UseSidebarControllerOptions, } from './use-sidebar-controller';
 export { SidebarRowAction, type SidebarRowActionProps, type SidebarRowActionPulse, } from './SidebarRowAction';
 export { WorkspaceSwitcher, WorkspaceIdentity, workspaceKindMeta, workspaceKindColor, DEFAULT_WORKSPACE_KIND_LABELS, DEFAULT_WORKSPACE_SWITCHER_LABELS, type WorkspaceSwitcherProps, type WorkspaceIdentityProps, type WorkspaceKindLabels, type WorkspaceSwitcherLabels, } from './Workspace';
 export { AskField, AskTrigger, AskRow, DEFAULT_ASK_FIELD_LABELS, type AskFieldLabels, type AskFieldProps, type AskTriggerProps, type AskRowProps, } from './AskField';
@@ -16,8 +18,9 @@ export { OfflinePill, DEFAULT_OFFLINE_PILL_LABELS, type OfflinePillLabels, type
 export { RemoteControlPill, DEFAULT_REMOTE_CONTROL_PILL_LABELS, type RemoteControlPillLabels, type RemoteControlPillProps, } from './RemoteControlPill';
 export { TipCard, DEFAULT_TIP_CARD_LABELS, type TipCardLabels, type TipCardProps } from './TipCard';
 export { TabHeader, DEFAULT_TAB_HEADER_LABELS, type Tab, type TabHeaderLabels, type TabHeaderProps, } from './TabHeader';
-export type { NavItem, ShellActionLayout, ShellRecentWorkspace, ShellWorkspace, ShellWorkspaceKind, } from './types';
+export type { NavItem, NavItemIndicator, NavSection, ShellActionLayout, ShellRecentWorkspace, ShellWorkspace, ShellWorkspaceKind, } from './types';
 export { useDrawerBehavior } from '../lib/use-drawer';
+export { useCloseOnEscape } from '../lib/use-close-on-escape';
 export { BREAKPOINT_QUERIES, useMediaQuery, useIsPhone, useIsNarrow, useIsTouchScreen, } from '../lib/use-media-query';
 export { resolveSidebarLayout, useSidebarSettle, type SidebarLayout, type SidebarMode, type SidebarModeInput, } from '../lib/sidebar-mode';
 export { InfoBar, type InfoBarProps, type InfoBarVariant } from './InfoBar';

package/dist/shell/index.js

@@ -1,12 +1,13 @@
 "use client";
-export { ActionCluster, AskField, AskRow, AskTrigger, DEFAULT_ASK_FIELD_LABELS, DEFAULT_INSTALL_PROMPT_LABELS, DEFAULT_MOBILE_BARS_LABELS, DEFAULT_OFFLINE_PILL_LABELS, DEFAULT_REMOTE_CONTROL_PILL_LABELS, DEFAULT_SIDEBAR_LABELS, DEFAULT_TIP_CARD_LABELS, INSTALL_PROMPT_DISMISSED_KEY, InfoBar, InstallPrompt, MobileAppBar, MobileTabBar, NotificationBell, OfflinePill, RemoteControlPill, STATUS_ROW_BASE_CLASS, STATUS_ROW_TONES, Sidebar, SidebarBadgeRow, SidebarRowAction, SidebarRowHoverContext, SplitLayout, StatusBadge, StatusRow, TipCard, UserMenu, getInstallInstructions, initInstallPrompt, isIosDevice, promptAppInstall, resolveSidebarLayout, useInstallPrompt, useSidebarContext, useSidebarSettle } from '../chunk-O6W6RW3B.js';
+export { ActionCluster, AskField, AskRow, AskTrigger, DEFAULT_ASK_FIELD_LABELS, DEFAULT_INSTALL_PROMPT_LABELS, DEFAULT_MOBILE_BARS_LABELS, DEFAULT_OFFLINE_PILL_LABELS, DEFAULT_REMOTE_CONTROL_PILL_LABELS, DEFAULT_SIDEBAR_LABELS, DEFAULT_TIP_CARD_LABELS, INSTALL_PROMPT_DISMISSED_KEY, InfoBar, InstallPrompt, MobileAppBar, MobileTabBar, NotificationBell, OfflinePill, RemoteControlPill, STATUS_ROW_BASE_CLASS, STATUS_ROW_TONES, ShellSidebar, Sidebar, SidebarBadgeRow, SidebarRowAction, SidebarRowHoverContext, SplitLayout, StatusBadge, StatusRow, TipCard, UserMenu, getInstallInstructions, initInstallPrompt, isIosDevice, promptAppInstall, resolveSidebarLayout, useCloseOnEscape, useInstallPrompt, useSidebarContext, useSidebarController, useSidebarSettle } from '../chunk-I7WG3JRD.js';
 export { DEFAULT_WORKSPACE_KIND_LABELS, DEFAULT_WORKSPACE_SWITCHER_LABELS, WorkspaceIdentity, WorkspaceSwitcher, workspaceKindColor, workspaceKindMeta } from '../chunk-A3XPS2EU.js';
+import '../chunk-RLWIUUQ5.js';
 import '../chunk-444XKG46.js';
 export { DEFAULT_FILTER_FIELDS, DEFAULT_FILTER_INPUT_LABELS, FilterInput } from '../chunk-YU2KUMGE.js';
+export { DEFAULT_TAB_HEADER_LABELS, TabHeader } from '../chunk-4WWM3GQ5.js';
 export { DEFAULT_DOCK_WIDTH, Toaster } from '../chunk-OKERRHLH.js';
 export { DEFAULT_OVERLAY_ZONE_ID, DEFAULT_PAGE_CONTAINER_PADDING, DEFAULT_SIDEBAR_TOGGLE_BUTTON_LABELS, PageContainer, SHELL_BOTTOM_INSET_VAR, Shell, SidebarToggleButton, ToolButton, useDrawerBehavior, useOverlayZoneId, useShellBottomInset } from '../chunk-7XF5SFJ2.js';
 export { BREAKPOINT_QUERIES, useIsNarrow, useIsPhone, useIsTouchScreen, useMediaQuery } from '../chunk-SLSBJRWW.js';
-export { DEFAULT_TAB_HEADER_LABELS, TabHeader } from '../chunk-4WWM3GQ5.js';
 import '../chunk-NPLYHR2E.js';
 import '../chunk-7F6CBP3Z.js';
 import '../chunk-YNIBUKV5.js';

package/dist/shell/types.d.ts

@@ -32,6 +32,24 @@ export interface NavItem {
     disabled?: boolean;
     /** Inline control after the count; may be interactive (the row is not a native button). */
     trailing?: ReactNode;
+    /**
+     * Status dot on the icon of the icon-only rail, where `trailing` has no room (work in
+     * progress, a failure, something waiting). The expanded row shows `trailing` instead.
+     */
+    indicator?: NavItemIndicator;
+}
+export type NavItemIndicator = 'progress' | 'error' | 'attention';
+/** A labelled group of sidebar rows (`Sidebar.Nav` `sections`). */
+export interface NavSection {
+    /** Stable key. */
+    id: string;
+    /** Heading shown when expanded; a divider stands in on the rail. Omit for an unlabelled run. */
+    label?: ReactNode;
+    /** Accessible name when `label` is not plain text. */
+    ariaLabel?: string;
+    items: NavItem[];
+    /** `data-testid` of the group. */
+    testId?: string;
 }
 export type ShellActionLayout = 'bar' | 'sidebar' | 'rail' | 'drawer';
 /** Workspace visibility: drives the initial-badge tone and the small type glyph. */

package/dist/shell/use-sidebar-controller.d.ts

@@ -0,0 +1,59 @@
+import { type SidebarLayout } from '../lib/sidebar-mode';
+import type { SidebarRootProps } from './Sidebar';
+export interface UseSidebarControllerOptions {
+    /** Pinned open (desktop). Controlled when set; otherwise kept here, seeded by `defaultPinned`. */
+    isPinned?: boolean;
+    /** Default `true`. */
+    defaultPinned?: boolean;
+    onPinnedChange?: (isPinned: boolean) => void;
+    /** The rail is floated open (hover, or its toggle at a narrow width). Controlled when set. */
+    isHovering?: boolean;
+    onHoveringChange?: (isHovering: boolean) => void;
+    /** The phone drawer is open. Controlled when set (the app bar's menu button opens it). */
+    isDrawerOpen?: boolean;
+    onDrawerOpenChange?: (isDrawerOpen: boolean) => void;
+    /**
+     * Keep the sidebar a rail even when pinned, on top of the tablet width (for example while a
+     * docked panel squeezes the content). The stored pin is left untouched.
+     */
+    forceRail?: boolean;
+}
+/** The `Sidebar.Root` props the controller resolves. */
+export type SidebarControllerRootProps = Pick<SidebarRootProps, 'mode' | 'expanded' | 'isHovering' | 'onBackdropClick' | 'hasRailBackdrop' | 'onMouseEnter' | 'onMouseLeave'>;
+export interface SidebarController {
+    layout: SidebarLayout;
+    /** Labels shown (settled: they stay on until the closing transition ends). */
+    expanded: boolean;
+    /** Width-bound content (tips, notices) may show: on once fully open, off as closing starts. */
+    tipsVisible: boolean;
+    /** The phone drawer is showing. */
+    isDrawer: boolean;
+    isSmallScreen: boolean;
+    /** Tablet width (or `forceRail`): pinning is ignored and the sidebar stays a rail. */
+    isNarrow: boolean;
+    /** The pin as it applies (always off while narrow). */
+    isPinned: boolean;
+    /** Spread onto `Sidebar.Root` (or pass the controller to `ShellSidebar`). */
+    rootProps: SidebarControllerRootProps;
+    openDrawer: () => void;
+    closeDrawer: () => void;
+    /** The pin toggle: pins/unpins, or floats the rail open/closed while narrow. */
+    togglePin: () => void;
+    /** Open from the rail (its ask button): pins, or floats the rail open while narrow. */
+    expand: () => void;
+    /** After a nav row is chosen: closes the drawer, and a floated rail the pointer has left. */
+    afterNavigate: () => void;
+}
+/**
+ * Sidebar behaviour as one hook, shared by every shell: resolves the layout (drawer / pinned /
+ * rail) for the viewport, settles labels and tips around the width transition, and owns the hover,
+ * pin and drawer rules:
+ *  - touch: the rail opens only through its toggle, never by the emulated mouseenter of a tap;
+ *  - narrow: a pointer drifting over the rail does not float the labels over the content;
+ *  - Escape closes a floated rail; the drawer closes itself when the viewport grows past a phone;
+ *  - choosing a row closes the drawer, and a floated rail unless the pointer is still over it.
+ *
+ * State is controlled per field (`isPinned`, `isHovering`, `isDrawerOpen`) so an app can keep it
+ * in its own store, or uncontrolled for a shell that does not care.
+ */
+export declare function useSidebarController(options?: UseSidebarControllerOptions): SidebarController;

package/dist/workflow-canvas/index.cjs

@@ -3,9 +3,10 @@
 
 var chunkJZNXRMLH_cjs = require('../chunk-JZNXRMLH.cjs');
 var chunkGFNELPDP_cjs = require('../chunk-GFNELPDP.cjs');
-var chunkCQ4MFKFC_cjs = require('../chunk-CQ4MFKFC.cjs');
-var chunk2UUNSHDI_cjs = require('../chunk-2UUNSHDI.cjs');
+var chunkHIJUXAWS_cjs = require('../chunk-HIJUXAWS.cjs');
+var chunkDPGFEMVT_cjs = require('../chunk-DPGFEMVT.cjs');
 require('../chunk-WS5EX7DN.cjs');
+require('../chunk-AHDJXIUB.cjs');
 require('../chunk-MIDXCYZB.cjs');
 require('../chunk-ZW6FPIFC.cjs');
 require('../chunk-3AFWGEDJ.cjs');
@@ -15,11 +16,11 @@ require('../chunk-R26BK7YL.cjs');
 require('../chunk-V4ISCZJ7.cjs');
 require('../chunk-2EI7NCUA.cjs');
 require('../chunk-C2CWWEHO.cjs');
+require('../chunk-7RGLTF76.cjs');
 var chunkOWCEQKAR_cjs = require('../chunk-OWCEQKAR.cjs');
 require('../chunk-7UTB4PHM.cjs');
 var chunk32HW2Q33_cjs = require('../chunk-32HW2Q33.cjs');
 require('../chunk-FX3K6LNZ.cjs');
-require('../chunk-7RGLTF76.cjs');
 require('../chunk-PPCATBOY.cjs');
 require('../chunk-MHVNT4J3.cjs');
 var chunkC4WSHRR6_cjs = require('../chunk-C4WSHRR6.cjs');
@@ -316,9 +317,9 @@ function SignalsEditor({
           {
             className: ui.cn(
               "space-y-1.5 rounded-md border p-2",
-              chunk2UUNSHDI_cjs.isIncompleteSignal(signal) ? "border-destructive/50" : "border-border"
+              chunkDPGFEMVT_cjs.isIncompleteSignal(signal) ? "border-destructive/50" : "border-border"
             ),
-            "data-incomplete": chunk2UUNSHDI_cjs.isIncompleteSignal(signal) || void 0,
+            "data-incomplete": chunkDPGFEMVT_cjs.isIncompleteSignal(signal) || void 0,
             "data-testid": `${testId}-${i}`,
             children: [
               /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
@@ -1604,7 +1605,7 @@ function triggerFields(trigger, clearOthers) {
   return {
     timezone: trigger.timezone,
     rrule: trigger.start === "repeat" ? trigger.rrule.trim() : none,
-    run_at: trigger.start === "once" ? chunkCQ4MFKFC_cjs.localInputToIso(trigger.runAt) : none,
+    run_at: trigger.start === "once" ? chunkHIJUXAWS_cjs.localInputToIso(trigger.runAt) : none,
     event_kind: trigger.start === "event" ? trigger.eventKind.trim() : none,
     // A step signal is `workflow_signal` narrowed to one signal name.
     event_filter: filter ?? none,
@@ -1620,7 +1621,7 @@ function plan(value, options) {
     criteria: [],
     max_passes: 3,
     documents: [],
-    steps: chunk2UUNSHDI_cjs.toPlanSteps(value.workflow, options)
+    steps: chunkDPGFEMVT_cjs.toPlanSteps(value.workflow, options)
   };
 }
 function builderToWorkflowRequest(value, workspaceId, options = {}) {
@@ -1655,7 +1656,7 @@ function builderToWorkflowUpdate(value, options = {}) {
 }
 function workflowRecordToBuilder(record) {
   const planned = record.plan?.steps ?? [];
-  const steps = planned.length ? chunk2UUNSHDI_cjs.fromPlanSteps(planned) : record.prompt || record.skill_ref ? [
+  const steps = planned.length ? chunkDPGFEMVT_cjs.fromPlanSteps(planned) : record.prompt || record.skill_ref ? [
     {
       id: "work",
       kind: "agent",
@@ -1663,7 +1664,7 @@ function workflowRecordToBuilder(record) {
       ...record.skill_ref ? { workflow: record.skill_ref } : { run: { kind: "prompt", promptTemplate: record.prompt } }
     }
   ] : [];
-  const when = chunkCQ4MFKFC_cjs.workflowWhen(record);
+  const when = chunkHIJUXAWS_cjs.workflowWhen(record);
   return {
     workflow: {
       id: record.external_id,
@@ -1672,12 +1673,12 @@ function workflowRecordToBuilder(record) {
       inputs: [],
       landing: "chat",
       schedulable: false,
-      run: { kind: "steps", steps, layout: chunk2UUNSHDI_cjs.layoutFromPlanSteps(planned ?? []) }
+      run: { kind: "steps", steps, layout: chunkDPGFEMVT_cjs.layoutFromPlanSteps(planned ?? []) }
     },
     trigger: {
       ...DEFAULT_WORKFLOW_TRIGGER,
       start: when === "now" ? "manual" : when,
-      runAt: chunkCQ4MFKFC_cjs.isoToLocalInput(record.run_at),
+      runAt: chunkHIJUXAWS_cjs.isoToLocalInput(record.run_at),
       rrule: record.rrule ?? "",
       timezone: record.timezone || DEFAULT_WORKFLOW_TRIGGER.timezone,
       eventKind: record.event_kind ?? "",
@@ -1733,7 +1734,7 @@ function triggerSummary(trigger, options = {}) {
     case "once":
       return trigger.runAt ? new Date(trigger.runAt).toLocaleString() : l.starts.once;
     case "repeat":
-      return trigger.rrule ? chunkCQ4MFKFC_cjs.describeRRule(trigger.rrule) : l.starts.repeat;
+      return trigger.rrule ? chunkHIJUXAWS_cjs.describeRRule(trigger.rrule) : l.starts.repeat;
     case "event":
       if (isSignalTrigger(trigger))
         return trigger.signal ? l.signalSummary.replace("{signal}", trigger.signal) : l.stepSignals;
@@ -1792,7 +1793,7 @@ function TriggerInspector({
         }
       )
     ] }),
-    trigger.start === "repeat" && /* @__PURE__ */ jsxRuntime.jsx(chunkCQ4MFKFC_cjs.RecurrenceBuilder, { rrule: trigger.rrule, onChange: (rrule) => set({ rrule }) }),
+    trigger.start === "repeat" && /* @__PURE__ */ jsxRuntime.jsx(chunkHIJUXAWS_cjs.RecurrenceBuilder, { rrule: trigger.rrule, onChange: (rrule) => set({ rrule }) }),
     trigger.start === "event" && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
       /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", children: l.event }),
       /* @__PURE__ */ jsxRuntime.jsxs(
@@ -1844,7 +1845,7 @@ function TriggerInspector({
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
       /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", children: l.agent }),
       /* @__PURE__ */ jsxRuntime.jsx(
-        chunk2UUNSHDI_cjs.AgentSelect,
+        chunkDPGFEMVT_cjs.AgentSelect,
         {
           agents,
           value: trigger.agentId,
@@ -2681,13 +2682,13 @@ function WorkflowPreview({
   renderIcon,
   testId
 }) {
-  const run = chunkCQ4MFKFC_cjs.useWorkflowPreview(workflow, {
+  const run = chunkHIJUXAWS_cjs.useWorkflowPreview(workflow, {
     resolveWorkflow: (id) => workflows.find((w) => w.id === id),
     compose,
     answer
   });
   return /* @__PURE__ */ jsxRuntime.jsx(
-    chunk2UUNSHDI_cjs.WorkflowRunner,
+    chunkDPGFEMVT_cjs.WorkflowRunner,
     {
       workflow,
       run,