@arbidocs/blocks 0.4.141 → 0.4.143

package/dist/shell/ShellSidebar.d.ts

@@ -0,0 +1,37 @@
+import type { ReactNode } from 'react';
+import { type SidebarRootProps } from './Sidebar';
+import type { SidebarController } from './use-sidebar-controller';
+import type { NavItem, NavSection } from './types';
+export interface ShellSidebarProps extends Pick<SidebarRootProps, 'className' | 'aria-label' | 'labels' | 'backdropTestId'> {
+    /** From `useSidebarController`: layout, hover/pin/drawer behaviour. */
+    controller: SidebarController;
+    /** Brand mark of the phone drawer's header (logo + close). Omit for no drawer header. */
+    drawerLogo?: ReactNode;
+    /** `data-testid` of the drawer's close button. */
+    drawerCloseTestId?: string;
+    /** Top block (workspace switcher, ask field, pin toggle). Read `controller.expanded` for the rail. */
+    header?: ReactNode;
+    /** Rows as data. */
+    items?: NavItem[];
+    /** Labelled groups of rows as data, after `items`. */
+    sections?: NavSection[];
+    navClassName?: string;
+    /**
+     * Width-bound cards at the top of the footer (smart tips, notices): shown only once the panel
+     * has settled open, and gone the instant it starts to close.
+     */
+    tips?: ReactNode;
+    /** The rest of the footer (status rows, account rows). */
+    footer?: ReactNode;
+    /** Root `data-testid` (default `sidebar`). */
+    'data-testid'?: string;
+}
+/**
+ * The whole sidebar from a controller and data: `Sidebar.Root` in the resolved mode, the phone
+ * drawer header, the header slot, the nav rows/groups and the footer. Renders nothing while the
+ * layout is hidden (a phone with the drawer closed), so no clipped rows carry duplicate test ids.
+ *
+ *   const sidebar = useSidebarController({ isPinned, onPinnedChange: setPinned })
+ *   <ShellSidebar controller={sidebar} header={…} items={nav} footer={…} />
+ */
+export declare function ShellSidebar({ controller, drawerLogo, drawerCloseTestId, header, items, sections, navClassName, tips, footer, ...rootProps }: ShellSidebarProps): import("react").JSX.Element | null;

package/dist/shell/Sidebar.d.ts

@@ -1,15 +1,13 @@
 import { type ReactNode } from 'react';
 import { DEFAULT_SIDEBAR_LABELS, SidebarRowHoverContext, useSidebarContext, type SidebarLabels } from './sidebar-context';
 import type { SidebarMode } from '../lib/sidebar-mode';
-import type { NavItem } from './types';
+import type { NavItem, NavSection } from './types';
 export interface SidebarRootProps {
     mode: SidebarMode;
     /** Labels visible. Provided to every part through context. */
     expanded: boolean;
     /** `rail` mode: floats open to full width. */
     isHovering?: boolean;
-    /** `collapsed` mode: revealed (peek) at full width. */
-    isPeeking?: boolean;
     onBackdropClick?: () => void;
     /** `rail` mode on touch: the floated-open rail dims the content behind it; tapping it closes. */
     hasRailBackdrop?: boolean;
@@ -24,7 +22,7 @@ export interface SidebarRootProps {
     /** Drawer backdrop id (default `sidebar-backdrop`). */
     backdropTestId?: string;
 }
-declare function SidebarRoot({ mode, expanded, isHovering, isPeeking, onBackdropClick, hasRailBackdrop, onMouseEnter, onMouseLeave, children, className, 'aria-label': ariaLabelProp, labels, 'data-testid': testId, backdropTestId, }: SidebarRootProps): import("react").JSX.Element;
+declare function SidebarRoot({ mode, expanded, isHovering, onBackdropClick, hasRailBackdrop, onMouseEnter, onMouseLeave, children, className, 'aria-label': ariaLabelProp, labels, 'data-testid': testId, backdropTestId, }: SidebarRootProps): import("react").JSX.Element;
 export interface SidebarSectionProps {
     children: ReactNode;
     className?: string;
@@ -35,8 +33,10 @@ export interface SidebarNavProps extends Omit<SidebarSectionProps, 'children'> {
     children?: ReactNode;
     /** Rows as data. Children render after them. */
     items?: NavItem[];
+    /** Labelled groups of rows as data (each a `Sidebar.Group`), after `items`. */
+    sections?: NavSection[];
 }
-declare function SidebarNav({ items, children, className, 'data-testid': testId }: SidebarNavProps): import("react").JSX.Element;
+declare function SidebarNav({ items, sections, children, className, 'data-testid': testId, }: SidebarNavProps): import("react").JSX.Element;
 export interface SidebarGroupProps extends SidebarSectionProps {
     /** Group heading. Shown above the rows when expanded; a thin divider stands in on the rail. */
     label?: ReactNode;
@@ -64,7 +64,7 @@ export type SidebarNavItemProps = Omit<NavItem, 'id'> & {
  * The expanded row is a div with role="button" (not a native <button>) so an interactive
  * `trailing` control can be nested without producing button-in-button markup.
  */
-declare function SidebarNavItem({ label, icon, active, onSelect, href, count, countIcon, testId, disabled, trailing, className, tooltip, }: SidebarNavItemProps): import("react").JSX.Element;
+declare function SidebarNavItem({ label, icon, active, onSelect, href, count, countIcon, testId, disabled, trailing, indicator, className, tooltip, }: SidebarNavItemProps): import("react").JSX.Element;
 export interface SidebarPinToggleProps {
     isPinned: boolean;
     onToggle: () => void;

package/dist/shell/index.cjs

@@ -1,17 +1,18 @@
 "use client";
 'use strict';
 
-var chunkGFRQG36Y_cjs = require('../chunk-GFRQG36Y.cjs');
+var chunkCOCGRJLA_cjs = require('../chunk-COCGRJLA.cjs');
 var chunkV46W7YLI_cjs = require('../chunk-V46W7YLI.cjs');
-require('../chunk-R26BK7YL.cjs');
+require('../chunk-AHDJXIUB.cjs');
+require('../chunk-DTROMMDX.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');
+require('../chunk-KPZZ5FHE.cjs');
 require('../chunk-ULWRNGGE.cjs');
 require('../chunk-DES3K4SD.cjs');
 
@@ -19,155 +20,167 @@ require('../chunk-DES3K4SD.cjs');
 
 Object.defineProperty(exports, "ActionCluster", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.ActionCluster; }
+  get: function () { return chunkCOCGRJLA_cjs.ActionCluster; }
 });
 Object.defineProperty(exports, "AskField", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.AskField; }
+  get: function () { return chunkCOCGRJLA_cjs.AskField; }
 });
 Object.defineProperty(exports, "AskRow", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.AskRow; }
+  get: function () { return chunkCOCGRJLA_cjs.AskRow; }
 });
 Object.defineProperty(exports, "AskTrigger", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.AskTrigger; }
+  get: function () { return chunkCOCGRJLA_cjs.AskTrigger; }
 });
 Object.defineProperty(exports, "DEFAULT_ASK_FIELD_LABELS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.DEFAULT_ASK_FIELD_LABELS; }
+  get: function () { return chunkCOCGRJLA_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 chunkCOCGRJLA_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 chunkCOCGRJLA_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 chunkCOCGRJLA_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 chunkCOCGRJLA_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 chunkCOCGRJLA_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 chunkCOCGRJLA_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 chunkCOCGRJLA_cjs.INSTALL_PROMPT_DISMISSED_KEY; }
 });
 Object.defineProperty(exports, "InfoBar", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.InfoBar; }
+  get: function () { return chunkCOCGRJLA_cjs.InfoBar; }
 });
 Object.defineProperty(exports, "InstallPrompt", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.InstallPrompt; }
+  get: function () { return chunkCOCGRJLA_cjs.InstallPrompt; }
 });
 Object.defineProperty(exports, "MobileAppBar", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.MobileAppBar; }
+  get: function () { return chunkCOCGRJLA_cjs.MobileAppBar; }
 });
 Object.defineProperty(exports, "MobileTabBar", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.MobileTabBar; }
+  get: function () { return chunkCOCGRJLA_cjs.MobileTabBar; }
 });
 Object.defineProperty(exports, "NotificationBell", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.NotificationBell; }
+  get: function () { return chunkCOCGRJLA_cjs.NotificationBell; }
 });
 Object.defineProperty(exports, "OfflinePill", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.OfflinePill; }
+  get: function () { return chunkCOCGRJLA_cjs.OfflinePill; }
 });
 Object.defineProperty(exports, "RemoteControlPill", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.RemoteControlPill; }
+  get: function () { return chunkCOCGRJLA_cjs.RemoteControlPill; }
 });
 Object.defineProperty(exports, "STATUS_ROW_BASE_CLASS", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.STATUS_ROW_BASE_CLASS; }
+  get: function () { return chunkCOCGRJLA_cjs.STATUS_ROW_BASE_CLASS; }
 });
 Object.defineProperty(exports, "STATUS_ROW_TONES", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.STATUS_ROW_TONES; }
+  get: function () { return chunkCOCGRJLA_cjs.STATUS_ROW_TONES; }
+});
+Object.defineProperty(exports, "ShellSidebar", {
+  enumerable: true,
+  get: function () { return chunkCOCGRJLA_cjs.ShellSidebar; }
 });
 Object.defineProperty(exports, "Sidebar", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.Sidebar; }
+  get: function () { return chunkCOCGRJLA_cjs.Sidebar; }
 });
 Object.defineProperty(exports, "SidebarBadgeRow", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.SidebarBadgeRow; }
+  get: function () { return chunkCOCGRJLA_cjs.SidebarBadgeRow; }
 });
 Object.defineProperty(exports, "SidebarRowAction", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.SidebarRowAction; }
+  get: function () { return chunkCOCGRJLA_cjs.SidebarRowAction; }
 });
 Object.defineProperty(exports, "SidebarRowHoverContext", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.SidebarRowHoverContext; }
+  get: function () { return chunkCOCGRJLA_cjs.SidebarRowHoverContext; }
 });
 Object.defineProperty(exports, "SplitLayout", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.SplitLayout; }
+  get: function () { return chunkCOCGRJLA_cjs.SplitLayout; }
 });
 Object.defineProperty(exports, "StatusBadge", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.StatusBadge; }
+  get: function () { return chunkCOCGRJLA_cjs.StatusBadge; }
 });
 Object.defineProperty(exports, "StatusRow", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.StatusRow; }
+  get: function () { return chunkCOCGRJLA_cjs.StatusRow; }
 });
 Object.defineProperty(exports, "TipCard", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.TipCard; }
+  get: function () { return chunkCOCGRJLA_cjs.TipCard; }
 });
 Object.defineProperty(exports, "UserMenu", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.UserMenu; }
+  get: function () { return chunkCOCGRJLA_cjs.UserMenu; }
 });
 Object.defineProperty(exports, "getInstallInstructions", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.getInstallInstructions; }
+  get: function () { return chunkCOCGRJLA_cjs.getInstallInstructions; }
 });
 Object.defineProperty(exports, "initInstallPrompt", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.initInstallPrompt; }
+  get: function () { return chunkCOCGRJLA_cjs.initInstallPrompt; }
 });
 Object.defineProperty(exports, "isIosDevice", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.isIosDevice; }
+  get: function () { return chunkCOCGRJLA_cjs.isIosDevice; }
 });
 Object.defineProperty(exports, "promptAppInstall", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.promptAppInstall; }
+  get: function () { return chunkCOCGRJLA_cjs.promptAppInstall; }
 });
 Object.defineProperty(exports, "resolveSidebarLayout", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.resolveSidebarLayout; }
+  get: function () { return chunkCOCGRJLA_cjs.resolveSidebarLayout; }
+});
+Object.defineProperty(exports, "useCloseOnEscape", {
+  enumerable: true,
+  get: function () { return chunkCOCGRJLA_cjs.useCloseOnEscape; }
 });
 Object.defineProperty(exports, "useInstallPrompt", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.useInstallPrompt; }
+  get: function () { return chunkCOCGRJLA_cjs.useInstallPrompt; }
 });
 Object.defineProperty(exports, "useSidebarContext", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.useSidebarContext; }
+  get: function () { return chunkCOCGRJLA_cjs.useSidebarContext; }
+});
+Object.defineProperty(exports, "useSidebarController", {
+  enumerable: true,
+  get: function () { return chunkCOCGRJLA_cjs.useSidebarController; }
 });
 Object.defineProperty(exports, "useSidebarSettle", {
   enumerable: true,
-  get: function () { return chunkGFRQG36Y_cjs.useSidebarSettle; }
+  get: function () { return chunkCOCGRJLA_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,15 +1,16 @@
 "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-H4D7WKDY.js';
 export { DEFAULT_WORKSPACE_KIND_LABELS, DEFAULT_WORKSPACE_SWITCHER_LABELS, WorkspaceIdentity, WorkspaceSwitcher, workspaceKindColor, workspaceKindMeta } from '../chunk-A3XPS2EU.js';
-import '../chunk-444XKG46.js';
+import '../chunk-RLWIUUQ5.js';
+import '../chunk-YKQ2DPIP.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';
+import '../chunk-TBEVGWY3.js';
 import '../chunk-TX2ZICS7.js';
 import '../chunk-VUNV25KB.js';
 //# sourceMappingURL=index.js.map

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;