@arbidocs/blocks 0.4.140 → 0.4.142

package/dist/settings/index.cjs

@@ -1,18 +1,18 @@
 "use client";
 'use strict';
 
-var chunkUMG5S6H5_cjs = require('../chunk-UMG5S6H5.cjs');
+var chunkQIMVTGKS_cjs = require('../chunk-QIMVTGKS.cjs');
 var chunk223D4727_cjs = require('../chunk-223D4727.cjs');
 var chunkQZTNTP75_cjs = require('../chunk-QZTNTP75.cjs');
-require('../chunk-ADOKTJHV.cjs');
 var chunkMIDXCYZB_cjs = require('../chunk-MIDXCYZB.cjs');
 var chunkDVUZTGVL_cjs = require('../chunk-DVUZTGVL.cjs');
-var chunkZAVEMQ37_cjs = require('../chunk-ZAVEMQ37.cjs');
+require('../chunk-ADOKTJHV.cjs');
+var chunkDWZXSPMB_cjs = require('../chunk-DWZXSPMB.cjs');
 var chunk7RGLTF76_cjs = require('../chunk-7RGLTF76.cjs');
-var chunkULWRNGGE_cjs = require('../chunk-ULWRNGGE.cjs');
 var chunk32HW2Q33_cjs = require('../chunk-32HW2Q33.cjs');
 require('../chunk-PPCATBOY.cjs');
 var chunkMHVNT4J3_cjs = require('../chunk-MHVNT4J3.cjs');
+var chunkULWRNGGE_cjs = require('../chunk-ULWRNGGE.cjs');
 var chunkKDG6FER6_cjs = require('../chunk-KDG6FER6.cjs');
 require('../chunk-DES3K4SD.cjs');
 var RadioGroupPrimitive = require('@radix-ui/react-radio-group');
@@ -3665,139 +3665,139 @@ function ErrorDialogView({
 
 Object.defineProperty(exports, "ActiveSessionsDialog", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.ActiveSessionsDialog; }
+  get: function () { return chunkQIMVTGKS_cjs.ActiveSessionsDialog; }
 });
 Object.defineProperty(exports, "AvatarPicker", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.AvatarPicker; }
+  get: function () { return chunkQIMVTGKS_cjs.AvatarPicker; }
 });
 Object.defineProperty(exports, "DEFAULT_ACTIVE_SESSIONS_DIALOG_LABELS", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DEFAULT_ACTIVE_SESSIONS_DIALOG_LABELS; }
+  get: function () { return chunkQIMVTGKS_cjs.DEFAULT_ACTIVE_SESSIONS_DIALOG_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_AVATAR_PICKER_LABELS", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DEFAULT_AVATAR_PICKER_LABELS; }
+  get: function () { return chunkQIMVTGKS_cjs.DEFAULT_AVATAR_PICKER_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_DELETE_ACCOUNT_DIALOG_LABELS", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DEFAULT_DELETE_ACCOUNT_DIALOG_LABELS; }
+  get: function () { return chunkQIMVTGKS_cjs.DEFAULT_DELETE_ACCOUNT_DIALOG_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_IDENTITY_VERIFICATION_LABELS", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DEFAULT_IDENTITY_VERIFICATION_LABELS; }
+  get: function () { return chunkQIMVTGKS_cjs.DEFAULT_IDENTITY_VERIFICATION_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_LOGOUT_DIALOG_LABELS", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DEFAULT_LOGOUT_DIALOG_LABELS; }
+  get: function () { return chunkQIMVTGKS_cjs.DEFAULT_LOGOUT_DIALOG_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_PASSWORD_CHANGE_DIALOG_LABELS", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DEFAULT_PASSWORD_CHANGE_DIALOG_LABELS; }
+  get: function () { return chunkQIMVTGKS_cjs.DEFAULT_PASSWORD_CHANGE_DIALOG_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_PROFILE_CARD_LABELS", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DEFAULT_PROFILE_CARD_LABELS; }
+  get: function () { return chunkQIMVTGKS_cjs.DEFAULT_PROFILE_CARD_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_SETTINGS_DANGER_ZONE_LABELS", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DEFAULT_SETTINGS_DANGER_ZONE_LABELS; }
+  get: function () { return chunkQIMVTGKS_cjs.DEFAULT_SETTINGS_DANGER_ZONE_LABELS; }
 });
 Object.defineProperty(exports, "DeleteAccountDialog", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DeleteAccountDialog; }
+  get: function () { return chunkQIMVTGKS_cjs.DeleteAccountDialog; }
 });
 Object.defineProperty(exports, "DraggableHeader", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.DraggableHeader; }
+  get: function () { return chunkQIMVTGKS_cjs.DraggableHeader; }
 });
 Object.defineProperty(exports, "EMAIL_NOTIFICATION_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.EMAIL_NOTIFICATION_CATEGORIES; }
+  get: function () { return chunkQIMVTGKS_cjs.EMAIL_NOTIFICATION_CATEGORIES; }
 });
 Object.defineProperty(exports, "EMAIL_NOTIFICATION_KEYS", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.EMAIL_NOTIFICATION_KEYS; }
+  get: function () { return chunkQIMVTGKS_cjs.EMAIL_NOTIFICATION_KEYS; }
 });
 Object.defineProperty(exports, "IdentityVerificationCard", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.IdentityVerificationCard; }
+  get: function () { return chunkQIMVTGKS_cjs.IdentityVerificationCard; }
 });
 Object.defineProperty(exports, "IdentityVerificationDialog", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.IdentityVerificationDialog; }
+  get: function () { return chunkQIMVTGKS_cjs.IdentityVerificationDialog; }
 });
 Object.defineProperty(exports, "LogoutDialog", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.LogoutDialog; }
+  get: function () { return chunkQIMVTGKS_cjs.LogoutDialog; }
 });
 Object.defineProperty(exports, "NotificationCategoryList", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.NotificationCategoryList; }
+  get: function () { return chunkQIMVTGKS_cjs.NotificationCategoryList; }
 });
 Object.defineProperty(exports, "PasswordChangeDialog", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.PasswordChangeDialog; }
+  get: function () { return chunkQIMVTGKS_cjs.PasswordChangeDialog; }
 });
 Object.defineProperty(exports, "ProfileCard", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.ProfileCard; }
+  get: function () { return chunkQIMVTGKS_cjs.ProfileCard; }
 });
 Object.defineProperty(exports, "RequireVerified", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.RequireVerified; }
+  get: function () { return chunkQIMVTGKS_cjs.RequireVerified; }
 });
 Object.defineProperty(exports, "SettingsActionRow", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.SettingsActionRow; }
+  get: function () { return chunkQIMVTGKS_cjs.SettingsActionRow; }
 });
 Object.defineProperty(exports, "SettingsCard", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.SettingsCard; }
+  get: function () { return chunkQIMVTGKS_cjs.SettingsCard; }
 });
 Object.defineProperty(exports, "SettingsDangerZone", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.SettingsDangerZone; }
+  get: function () { return chunkQIMVTGKS_cjs.SettingsDangerZone; }
 });
 Object.defineProperty(exports, "SettingsPanel", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.SettingsPanel; }
+  get: function () { return chunkQIMVTGKS_cjs.SettingsPanel; }
 });
 Object.defineProperty(exports, "SettingsRow", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.SettingsRow; }
+  get: function () { return chunkQIMVTGKS_cjs.SettingsRow; }
 });
 Object.defineProperty(exports, "SettingsSection", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.SettingsSection; }
+  get: function () { return chunkQIMVTGKS_cjs.SettingsSection; }
 });
 Object.defineProperty(exports, "SettingsSwitchGroup", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.SettingsSwitchGroup; }
+  get: function () { return chunkQIMVTGKS_cjs.SettingsSwitchGroup; }
 });
 Object.defineProperty(exports, "SettingsSwitchRow", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.SettingsSwitchRow; }
+  get: function () { return chunkQIMVTGKS_cjs.SettingsSwitchRow; }
 });
 Object.defineProperty(exports, "formatSessionTtl", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.formatSessionTtl; }
+  get: function () { return chunkQIMVTGKS_cjs.formatSessionTtl; }
 });
 Object.defineProperty(exports, "toActiveSessionViews", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.toActiveSessionViews; }
+  get: function () { return chunkQIMVTGKS_cjs.toActiveSessionViews; }
 });
 Object.defineProperty(exports, "toDeleteBlockerViews", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.toDeleteBlockerViews; }
+  get: function () { return chunkQIMVTGKS_cjs.toDeleteBlockerViews; }
 });
 Object.defineProperty(exports, "toLogoutSessionViews", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.toLogoutSessionViews; }
+  get: function () { return chunkQIMVTGKS_cjs.toLogoutSessionViews; }
 });
 Object.defineProperty(exports, "toNotificationCategories", {
   enumerable: true,
-  get: function () { return chunkUMG5S6H5_cjs.toNotificationCategories; }
+  get: function () { return chunkQIMVTGKS_cjs.toNotificationCategories; }
 });
 Object.defineProperty(exports, "ModalBreadcrumbHeader", {
   enumerable: true,
@@ -3829,11 +3829,11 @@ Object.defineProperty(exports, "TriStateFilterMenu", {
 });
 Object.defineProperty(exports, "ConfirmDialog", {
   enumerable: true,
-  get: function () { return chunkZAVEMQ37_cjs.ConfirmDialog; }
+  get: function () { return chunkDWZXSPMB_cjs.ConfirmDialog; }
 });
 Object.defineProperty(exports, "DEFAULT_CONFIRM_DIALOG_LABELS", {
   enumerable: true,
-  get: function () { return chunkZAVEMQ37_cjs.DEFAULT_CONFIRM_DIALOG_LABELS; }
+  get: function () { return chunkDWZXSPMB_cjs.DEFAULT_CONFIRM_DIALOG_LABELS; }
 });
 Object.defineProperty(exports, "MODAL_SECTION_TITLE_CLASS", {
   enumerable: true,

package/dist/settings/index.js

@@ -1,17 +1,17 @@
 "use client";
-export { ActiveSessionsDialog, AvatarPicker, DEFAULT_ACTIVE_SESSIONS_DIALOG_LABELS, DEFAULT_AVATAR_PICKER_LABELS, DEFAULT_DELETE_ACCOUNT_DIALOG_LABELS, DEFAULT_IDENTITY_VERIFICATION_LABELS, DEFAULT_LOGOUT_DIALOG_LABELS, DEFAULT_PASSWORD_CHANGE_DIALOG_LABELS, DEFAULT_PROFILE_CARD_LABELS, DEFAULT_SETTINGS_DANGER_ZONE_LABELS, DeleteAccountDialog, DraggableHeader, EMAIL_NOTIFICATION_CATEGORIES, EMAIL_NOTIFICATION_KEYS, IdentityVerificationCard, IdentityVerificationDialog, LogoutDialog, NotificationCategoryList, PasswordChangeDialog, ProfileCard, RequireVerified, SettingsActionRow, SettingsCard, SettingsDangerZone, SettingsPanel, SettingsRow, SettingsSection, SettingsSwitchGroup, SettingsSwitchRow, formatSessionTtl, toActiveSessionViews, toDeleteBlockerViews, toLogoutSessionViews, toNotificationCategories } from '../chunk-OCDDWDH2.js';
+export { ActiveSessionsDialog, AvatarPicker, DEFAULT_ACTIVE_SESSIONS_DIALOG_LABELS, DEFAULT_AVATAR_PICKER_LABELS, DEFAULT_DELETE_ACCOUNT_DIALOG_LABELS, DEFAULT_IDENTITY_VERIFICATION_LABELS, DEFAULT_LOGOUT_DIALOG_LABELS, DEFAULT_PASSWORD_CHANGE_DIALOG_LABELS, DEFAULT_PROFILE_CARD_LABELS, DEFAULT_SETTINGS_DANGER_ZONE_LABELS, DeleteAccountDialog, DraggableHeader, EMAIL_NOTIFICATION_CATEGORIES, EMAIL_NOTIFICATION_KEYS, IdentityVerificationCard, IdentityVerificationDialog, LogoutDialog, NotificationCategoryList, PasswordChangeDialog, ProfileCard, RequireVerified, SettingsActionRow, SettingsCard, SettingsDangerZone, SettingsPanel, SettingsRow, SettingsSection, SettingsSwitchGroup, SettingsSwitchRow, formatSessionTtl, toActiveSessionViews, toDeleteBlockerViews, toLogoutSessionViews, toNotificationCategories } from '../chunk-ON3TKY5Y.js';
 export { ModalBreadcrumbHeader, ModalCrumbs } from '../chunk-RC6VTY2H.js';
 import { UsageMeter } from '../chunk-66TA5IBN.js';
-import '../chunk-VILAPTCB.js';
 export { DEFAULT_DOCUMENT_PICKER_LABELS, DEFAULT_TRI_STATE_FILTER_MENU_LABELS, DocumentPicker, MultiSelect, TriStateFilterMenu } from '../chunk-CKCBBYTA.js';
 import { ToneBadge } from '../chunk-5LXQPP2K.js';
-export { ConfirmDialog, DEFAULT_CONFIRM_DIALOG_LABELS } from '../chunk-ECERC6TI.js';
+import '../chunk-VILAPTCB.js';
+export { ConfirmDialog, DEFAULT_CONFIRM_DIALOG_LABELS } from '../chunk-VHJHY7TT.js';
 import { TabHeader } from '../chunk-4WWM3GQ5.js';
-import { ModalSection, ModalSectionTitle, ModalHeader, ModalScaffold } from '../chunk-TX2ZICS7.js';
-export { MODAL_SECTION_TITLE_CLASS, ModalHeader, ModalScaffold, ModalSection, ModalSectionTitle } from '../chunk-TX2ZICS7.js';
 import { TONE_BORDER, TONE_SURFACE } from '../chunk-AUS3KBHJ.js';
 import '../chunk-NPLYHR2E.js';
 import { testIdOr, prefixedTestId } from '../chunk-7F6CBP3Z.js';
+import { ModalSection, ModalSectionTitle, ModalHeader, ModalScaffold } from '../chunk-TX2ZICS7.js';
+export { MODAL_SECTION_TITLE_CLASS, ModalHeader, ModalScaffold, ModalSection, ModalSectionTitle } from '../chunk-TX2ZICS7.js';
 import { formatCount } from '../chunk-OXF2IFXG.js';
 import '../chunk-VUNV25KB.js';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';

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,173 +1,186 @@
 "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');
-var chunk2EI7NCUA_cjs = require('../chunk-2EI7NCUA.cjs');
+require('../chunk-AHDJXIUB.cjs');
 require('../chunk-R26BK7YL.cjs');
+var chunk2EI7NCUA_cjs = require('../chunk-2EI7NCUA.cjs');
 var chunk7RGLTF76_cjs = require('../chunk-7RGLTF76.cjs');
-require('../chunk-C4WSHRR6.cjs');
-require('../chunk-ULWRNGGE.cjs');
 var chunk5UHAWSEX_cjs = require('../chunk-5UHAWSEX.cjs');
 var chunkB6MVQCXW_cjs = require('../chunk-B6MVQCXW.cjs');
 var chunkFX3K6LNZ_cjs = require('../chunk-FX3K6LNZ.cjs');
 require('../chunk-PPCATBOY.cjs');
 require('../chunk-MHVNT4J3.cjs');
+require('../chunk-C4WSHRR6.cjs');
+require('../chunk-ULWRNGGE.cjs');
 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,

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,16 +1,17 @@
 "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';
-export { DEFAULT_FILTER_FIELDS, DEFAULT_FILTER_INPUT_LABELS, FilterInput } from '../chunk-YU2KUMGE.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';
-import '../chunk-YNIBUKV5.js';
-import '../chunk-TX2ZICS7.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';
 import '../chunk-NPLYHR2E.js';
 import '../chunk-7F6CBP3Z.js';
+import '../chunk-YNIBUKV5.js';
+import '../chunk-TX2ZICS7.js';
 import '../chunk-VUNV25KB.js';
 //# sourceMappingURL=index.js.map
 //# 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. */