@harborclient/sdk 1.6.2 → 1.6.4

package/dist/components/SidebarItem/SortableSidebarItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SortableSidebarItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SortableSidebarItem.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAItF,UAAU,KAAK;IACb;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAE5D;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACnD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACzD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,EAAE,EACF,EAAE,EAAE,SAAiB,EACrB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,QAAgB,EAChB,gBAAgB,EAChB,IAAI,EACJ,eAAe,EAAE,YAAY,EAC7B,YAAY,EAAE,SAAS,EACvB,eAAe,EAAE,YAAY,EAC7B,eAAe,EAAE,YAAY,EAC7B,YAAY,EAAE,SAAS,EACvB,cAAc,EAAE,WAAW,EAC3B,eAAe,EAAE,YAAY,EAC7B,QAAQ,EACR,OAAO,EACP,aAAa,EACb,SAAS,EACV,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAkErB"}
+{"version":3,"file":"SortableSidebarItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SortableSidebarItem.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAItF,UAAU,KAAK;IACb;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAE5D;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACnD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACzD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,EAAE,EACF,EAAE,EAAE,SAAiB,EACrB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,IAAI,EACJ,eAAe,EAAE,YAAY,EAC7B,YAAY,EAAE,SAAS,EACvB,eAAe,EAAE,YAAY,EAC7B,eAAe,EAAE,YAAY,EAC7B,YAAY,EAAE,SAAS,EACvB,cAAc,EAAE,WAAW,EAC3B,eAAe,EAAE,YAAY,EAC7B,QAAQ,EACR,OAAO,EACP,aAAa,EACb,SAAS,EACV,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CA2ErB"}

package/dist/components/SidebarItem/SortableSidebarItem.js

@@ -6,12 +6,13 @@ import { FaIcon } from '../FaIcon/index.js';
 import { SIDEBAR_DRAG_HANDLE_CLASS } from './sidebarItemClasses.js';
 /**
  * Wraps a sidebar row with dnd-kit sortable drag behavior. Reordering is activated
- * from a dedicated trailing grip handle so keyboard users can focus it and use the
- * keyboard sensor; listbox option interaction and nested row controls stay on the
- * row container. Keeping the handle after the label keeps leading content flush with
- * non-sortable sections such as Runs and History.
+ * from a dedicated trailing grip handle (mouse / programmatic focus). The handle is
+ * removed from Tab order so listbox/tree composites keep a single Tab stop per row;
+ * keyboard users reorder via Move up/down in the row actions menu. Keeping the handle
+ * after the label keeps leading content flush with non-sortable sections such as Runs
+ * and History.
  */
-export function SortableSidebarItem({ id, as: Container = 'div', className, dragHandleLabel, children, trailing, disabled = false, onRowContextMenu, role, 'aria-selected': ariaSelected, 'aria-label': ariaLabel, 'aria-expanded': ariaExpanded, 'aria-controls': ariaControls, 'aria-level': ariaLevel, 'aria-setsize': ariaSetSize, 'aria-posinset': ariaPosInSet, tabIndex, onClick, onDoubleClick, onKeyDown }) {
+export function SortableSidebarItem({ id, as: Container = 'div', className, dragHandleLabel, children, trailing, subtree, disabled = false, dataAttributes, onRowContextMenu, role, 'aria-selected': ariaSelected, 'aria-label': ariaLabel, 'aria-expanded': ariaExpanded, 'aria-controls': ariaControls, 'aria-level': ariaLevel, 'aria-setsize': ariaSetSize, 'aria-posinset': ariaPosInSet, tabIndex, onClick, onDoubleClick, onKeyDown }) {
     const { attributes, listeners, setNodeRef, setActivatorNodeRef, transform, transition, isDragging } = useSortable({ id, disabled });
     const isInteractiveRow = role === 'option' || role === 'treeitem';
     const interactiveProps = isInteractiveRow
@@ -31,12 +32,12 @@ export function SortableSidebarItem({ id, as: Container = 'div', className, drag
         }
         : {};
     if (disabled) {
-        return (_jsxs(Container, { className: className, onContextMenu: onRowContextMenu, ...interactiveProps, children: [children, trailing] }));
+        return (_jsxs(Container, { className: className, onContextMenu: onRowContextMenu, ...dataAttributes, ...interactiveProps, children: [children, trailing, subtree] }));
     }
     const style = {
         transform: CSS.Transform.toString(transform),
         transition: isDragging ? transition : undefined,
         opacity: isDragging ? 0.45 : undefined
     };
-    return (_jsxs(Container, { ref: setNodeRef, style: style, className: className, onContextMenu: onRowContextMenu, ...interactiveProps, children: [children, _jsx("button", { type: "button", ref: setActivatorNodeRef, className: SIDEBAR_DRAG_HANDLE_CLASS, "aria-label": dragHandleLabel, ...attributes, ...listeners, children: _jsx(FaIcon, { icon: faGripVertical, className: "h-2.5 w-2.5", "aria-hidden": true }) }), trailing] }));
+    return (_jsxs(Container, { ref: setNodeRef, style: style, className: className, onContextMenu: onRowContextMenu, ...dataAttributes, ...interactiveProps, children: [children, _jsx("button", { type: "button", ref: setActivatorNodeRef, className: SIDEBAR_DRAG_HANDLE_CLASS, "aria-label": dragHandleLabel, ...attributes, ...listeners, tabIndex: -1, children: _jsx(FaIcon, { icon: faGripVertical, className: "h-2.5 w-2.5", "aria-hidden": true }) }), trailing, subtree] }));
 }

package/dist/components/SidebarItem/index.d.ts

@@ -4,6 +4,7 @@ export { SidebarList } from './SidebarList.js';
 export { SidebarTree } from './SidebarTree.js';
 export { SidebarTreeGroup } from './SidebarTreeGroup.js';
 export { handleSidebarOptionKeyDown } from './sidebarListOption.js';
+export { focusSidebarCompositeItem, handleSidebarCompositeContainerKeyDown, handleSidebarCompositeFocusIn, isSidebarRowActionsMenuKey, openSidebarRowActionsMenu, querySidebarCompositeItems, resolveSidebarCompositeFocusIndex, setSidebarCompositeRovingTabIndex } from './sidebarCompositeNavigation.js';
 export { SortableSidebarItem } from './SortableSidebarItem.js';
 export { stopSortableDragPointerDown } from './stopSortableDragPointerDown.js';
 export { SidebarMarkerDot } from './SidebarMarkerDot.js';

package/dist/components/SidebarItem/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,kCAAkC,EACnC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EACL,yBAAyB,EACzB,sCAAsC,EACtC,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,iCAAiC,EACjC,iCAAiC,EAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,kCAAkC,EACnC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/components/SidebarItem/index.js

@@ -4,6 +4,7 @@ export { SidebarList } from './SidebarList.js';
 export { SidebarTree } from './SidebarTree.js';
 export { SidebarTreeGroup } from './SidebarTreeGroup.js';
 export { handleSidebarOptionKeyDown } from './sidebarListOption.js';
+export { focusSidebarCompositeItem, handleSidebarCompositeContainerKeyDown, handleSidebarCompositeFocusIn, isSidebarRowActionsMenuKey, openSidebarRowActionsMenu, querySidebarCompositeItems, resolveSidebarCompositeFocusIndex, setSidebarCompositeRovingTabIndex } from './sidebarCompositeNavigation.js';
 export { SortableSidebarItem } from './SortableSidebarItem.js';
 export { stopSortableDragPointerDown } from './stopSortableDragPointerDown.js';
 export { SidebarMarkerDot } from './SidebarMarkerDot.js';

package/dist/components/SidebarItem/sidebarCompositeNavigation.d.ts

@@ -0,0 +1,100 @@
+import type { FocusEvent, KeyboardEvent as ReactKeyboardEvent } from 'react';
+/**
+ * Role used by flat sidebar item lists.
+ */
+export declare const SIDEBAR_LISTBOX_ITEM_ROLE = "option";
+/**
+ * Role used by nested sidebar item trees.
+ */
+export declare const SIDEBAR_TREE_ITEM_ROLE = "treeitem";
+/**
+ * Collects composite items under a listbox or tree root in DOM order.
+ *
+ * @param root - Listbox or tree element.
+ * @param role - Item role to collect (`option` or `treeitem`).
+ * @returns Focusable item elements in document order.
+ */
+export declare function querySidebarCompositeItems(root: ParentNode, role: typeof SIDEBAR_LISTBOX_ITEM_ROLE | typeof SIDEBAR_TREE_ITEM_ROLE): HTMLElement[];
+/**
+ * Updates roving tabindex so exactly one composite item is a Tab stop.
+ *
+ * @param items - Composite items in order.
+ * @param focusIndex - Index that should receive `tabIndex={0}`.
+ */
+export declare function setSidebarCompositeRovingTabIndex(items: readonly HTMLElement[], focusIndex: number): void;
+/**
+ * Resolves the index of the focused item, falling back to the current Tab stop.
+ *
+ * @param items - Composite items in order.
+ * @param activeElement - Document active element, if any.
+ * @returns Index into `items`, or `-1` when empty.
+ */
+export declare function resolveSidebarCompositeFocusIndex(items: readonly HTMLElement[], activeElement: Element | null): number;
+/**
+ * Focuses a composite item and makes it the sole Tab stop.
+ *
+ * @param items - Composite items in order.
+ * @param index - Target index.
+ */
+export declare function focusSidebarCompositeItem(items: readonly HTMLElement[], index: number): void;
+/**
+ * Finds the expand/collapse control inside a treeitem, if present.
+ *
+ * @param item - Treeitem element.
+ * @returns Chevron button, or null when the item is a leaf.
+ */
+export declare function findSidebarTreeExpandButton(item: HTMLElement): HTMLButtonElement | null;
+/**
+ * Whether the key event should open the focused row's actions menu.
+ *
+ * @param event - Keyboard event from a composite item or container.
+ * @returns True for Shift+F10 or the ContextMenu key.
+ */
+export declare function isSidebarRowActionsMenuKey(event: Pick<KeyboardEvent | ReactKeyboardEvent, 'key' | 'shiftKey'>): boolean;
+/**
+ * Opens the row actions menu trigger inside a sidebar row, if present.
+ *
+ * @param row - Focused option or treeitem element.
+ * @returns True when a trigger was found and activated.
+ */
+export declare function openSidebarRowActionsMenu(row: HTMLElement): boolean;
+/**
+ * Handles ArrowLeft / ArrowRight expand/collapse for a focused treeitem.
+ *
+ * @param event - Keydown event.
+ * @param item - Focused treeitem.
+ * @param items - All visible treeitems under the tree.
+ * @param focusIndex - Index of `item` in `items`.
+ * @returns True when the key was handled.
+ */
+export declare function handleSidebarTreeHorizontalKey(event: KeyboardEvent | ReactKeyboardEvent, item: HTMLElement, items: readonly HTMLElement[], focusIndex: number): boolean;
+type CompositeRole = typeof SIDEBAR_LISTBOX_ITEM_ROLE | typeof SIDEBAR_TREE_ITEM_ROLE;
+/**
+ * Handles vertical arrow / Home / End navigation inside a sidebar composite.
+ *
+ * @param event - Keydown from the composite container or an item.
+ * @param root - Listbox or tree element.
+ * @param role - Item role under `root`.
+ * @returns True when focus moved.
+ */
+export declare function handleSidebarCompositeVerticalKey(event: KeyboardEvent | ReactKeyboardEvent, root: HTMLElement, role: CompositeRole): boolean;
+/**
+ * Container keydown handler for {@link SidebarListbox} / {@link SidebarTree}.
+ *
+ * Moves focus among items with arrows, opens row actions with Shift+F10 /
+ * ContextMenu, and leaves Enter/Space activation to the focused item.
+ *
+ * @param event - React keydown from the composite root.
+ * @param role - Item role managed by this composite.
+ */
+export declare function handleSidebarCompositeContainerKeyDown(event: ReactKeyboardEvent<HTMLElement>, role: CompositeRole): void;
+/**
+ * Keeps roving tabindex aligned when focus moves inside the composite via pointer
+ * or programmatic focus.
+ *
+ * @param event - Focusin from the composite root.
+ * @param role - Item role managed by this composite.
+ */
+export declare function handleSidebarCompositeFocusIn(event: FocusEvent<HTMLElement>, role: CompositeRole): void;
+export {};
+//# sourceMappingURL=sidebarCompositeNavigation.d.ts.map

package/dist/components/SidebarItem/sidebarCompositeNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebarCompositeNavigation.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/sidebarCompositeNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAG7E;;GAEG;AACH,eAAO,MAAM,yBAAyB,WAAW,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,sBAAsB,aAAa,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,OAAO,yBAAyB,GAAG,OAAO,sBAAsB,GACrE,WAAW,EAAE,CASf;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,UAAU,EAAE,MAAM,GACjB,IAAI,CAIN;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,aAAa,EAAE,OAAO,GAAG,IAAI,GAC5B,MAAM,CAkBR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAW5F;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,WAAW,GAAG,iBAAiB,GAAG,IAAI,CAIvF;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,CAAC,aAAa,GAAG,kBAAkB,EAAE,KAAK,GAAG,UAAU,CAAC,GAClE,OAAO,CAMT;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAWnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,aAAa,GAAG,kBAAkB,EACzC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,UAAU,EAAE,MAAM,GACjB,OAAO,CAsDT;AAED,KAAK,aAAa,GAAG,OAAO,yBAAyB,GAAG,OAAO,sBAAsB,CAAC;AAEtF;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,aAAa,GAAG,kBAAkB,EACzC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CA2BT;AAED;;;;;;;;GAQG;AACH,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC,EACtC,IAAI,EAAE,aAAa,GAClB,IAAI,CAuBN;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAC9B,IAAI,EAAE,aAAa,GAClB,IAAI,CAaN"}

package/dist/components/SidebarItem/sidebarCompositeNavigation.js

@@ -0,0 +1,246 @@
+import { resolveTabListKeyAction } from '../utils.js';
+/**
+ * Role used by flat sidebar item lists.
+ */
+export const SIDEBAR_LISTBOX_ITEM_ROLE = 'option';
+/**
+ * Role used by nested sidebar item trees.
+ */
+export const SIDEBAR_TREE_ITEM_ROLE = 'treeitem';
+/**
+ * Collects composite items under a listbox or tree root in DOM order.
+ *
+ * @param root - Listbox or tree element.
+ * @param role - Item role to collect (`option` or `treeitem`).
+ * @returns Focusable item elements in document order.
+ */
+export function querySidebarCompositeItems(root, role) {
+    return Array.from(root.querySelectorAll(`[role="${role}"]`)).filter((element) => {
+        // Nested listboxes/trees can appear in plugin hosts; keep items local to this root.
+        const owner = role === SIDEBAR_LISTBOX_ITEM_ROLE
+            ? element.closest('[role="listbox"]')
+            : element.closest('[role="tree"]');
+        return owner === root || (owner == null && root.contains(element));
+    });
+}
+/**
+ * Updates roving tabindex so exactly one composite item is a Tab stop.
+ *
+ * @param items - Composite items in order.
+ * @param focusIndex - Index that should receive `tabIndex={0}`.
+ */
+export function setSidebarCompositeRovingTabIndex(items, focusIndex) {
+    items.forEach((item, index) => {
+        item.tabIndex = index === focusIndex ? 0 : -1;
+    });
+}
+/**
+ * Resolves the index of the focused item, falling back to the current Tab stop.
+ *
+ * @param items - Composite items in order.
+ * @param activeElement - Document active element, if any.
+ * @returns Index into `items`, or `-1` when empty.
+ */
+export function resolveSidebarCompositeFocusIndex(items, activeElement) {
+    if (items.length === 0) {
+        return -1;
+    }
+    const focusedIndex = items.findIndex((item) => item === activeElement || item.contains(activeElement));
+    if (focusedIndex >= 0) {
+        return focusedIndex;
+    }
+    const tabStopIndex = items.findIndex((item) => item.tabIndex === 0);
+    if (tabStopIndex >= 0) {
+        return tabStopIndex;
+    }
+    return 0;
+}
+/**
+ * Focuses a composite item and makes it the sole Tab stop.
+ *
+ * @param items - Composite items in order.
+ * @param index - Target index.
+ */
+export function focusSidebarCompositeItem(items, index) {
+    const target = items[index];
+    if (target == null) {
+        return;
+    }
+    setSidebarCompositeRovingTabIndex(items, index);
+    target.focus();
+    if (typeof target.scrollIntoView === 'function') {
+        target.scrollIntoView({ block: 'nearest' });
+    }
+}
+/**
+ * Finds the expand/collapse control inside a treeitem, if present.
+ *
+ * @param item - Treeitem element.
+ * @returns Chevron button, or null when the item is a leaf.
+ */
+export function findSidebarTreeExpandButton(item) {
+    return item.querySelector('button[aria-expanded], button[aria-label^="Expand"], button[aria-label^="Collapse"]');
+}
+/**
+ * Whether the key event should open the focused row's actions menu.
+ *
+ * @param event - Keyboard event from a composite item or container.
+ * @returns True for Shift+F10 or the ContextMenu key.
+ */
+export function isSidebarRowActionsMenuKey(event) {
+    if (event.key === 'ContextMenu') {
+        return true;
+    }
+    return event.key === 'F10' && event.shiftKey;
+}
+/**
+ * Opens the row actions menu trigger inside a sidebar row, if present.
+ *
+ * @param row - Focused option or treeitem element.
+ * @returns True when a trigger was found and activated.
+ */
+export function openSidebarRowActionsMenu(row) {
+    const trigger = row.querySelector('.hc-row-actions-menu-trigger') ??
+        row.querySelector('[data-sidebar-actions] button');
+    if (trigger == null || trigger.disabled) {
+        return false;
+    }
+    trigger.click();
+    return true;
+}
+/**
+ * Handles ArrowLeft / ArrowRight expand/collapse for a focused treeitem.
+ *
+ * @param event - Keydown event.
+ * @param item - Focused treeitem.
+ * @param items - All visible treeitems under the tree.
+ * @param focusIndex - Index of `item` in `items`.
+ * @returns True when the key was handled.
+ */
+export function handleSidebarTreeHorizontalKey(event, item, items, focusIndex) {
+    const expanded = item.getAttribute('aria-expanded');
+    if (event.key === 'ArrowRight') {
+        if (expanded === 'false') {
+            const expandButton = findSidebarTreeExpandButton(item);
+            if (expandButton != null) {
+                event.preventDefault();
+                expandButton.click();
+                return true;
+            }
+        }
+        if (expanded === 'true') {
+            const next = items[focusIndex + 1];
+            if (next != null) {
+                event.preventDefault();
+                focusSidebarCompositeItem(items, focusIndex + 1);
+                return true;
+            }
+        }
+        return false;
+    }
+    if (event.key === 'ArrowLeft') {
+        if (expanded === 'true') {
+            const collapseButton = findSidebarTreeExpandButton(item);
+            if (collapseButton != null) {
+                event.preventDefault();
+                collapseButton.click();
+                return true;
+            }
+        }
+        const level = Number(item.getAttribute('aria-level') ?? '1');
+        for (let index = focusIndex - 1; index >= 0; index -= 1) {
+            const candidate = items[index];
+            if (candidate == null) {
+                continue;
+            }
+            const candidateLevel = Number(candidate.getAttribute('aria-level') ?? '1');
+            if (candidateLevel < level) {
+                event.preventDefault();
+                focusSidebarCompositeItem(items, index);
+                return true;
+            }
+        }
+        return false;
+    }
+    return false;
+}
+/**
+ * Handles vertical arrow / Home / End navigation inside a sidebar composite.
+ *
+ * @param event - Keydown from the composite container or an item.
+ * @param root - Listbox or tree element.
+ * @param role - Item role under `root`.
+ * @returns True when focus moved.
+ */
+export function handleSidebarCompositeVerticalKey(event, root, role) {
+    const key = event.key;
+    // Listbox and tree both navigate vertically with Up/Down/Home/End.
+    if (key !== 'ArrowUp' && key !== 'ArrowDown' && key !== 'Home' && key !== 'End') {
+        return false;
+    }
+    const items = querySidebarCompositeItems(root, role);
+    if (items.length === 0) {
+        return false;
+    }
+    const currentIndex = resolveSidebarCompositeFocusIndex(items, document.activeElement);
+    if (currentIndex < 0) {
+        return false;
+    }
+    // Map Home/End/Up/Down through the shared tablist helper (Left/Right also map there,
+    // but listbox never reaches this with those keys).
+    const nextIndex = resolveTabListKeyAction(key, currentIndex, items.length);
+    if (nextIndex == null || nextIndex === currentIndex) {
+        return false;
+    }
+    event.preventDefault();
+    focusSidebarCompositeItem(items, nextIndex);
+    return true;
+}
+/**
+ * Container keydown handler for {@link SidebarListbox} / {@link SidebarTree}.
+ *
+ * Moves focus among items with arrows, opens row actions with Shift+F10 /
+ * ContextMenu, and leaves Enter/Space activation to the focused item.
+ *
+ * @param event - React keydown from the composite root.
+ * @param role - Item role managed by this composite.
+ */
+export function handleSidebarCompositeContainerKeyDown(event, role) {
+    if (event.defaultPrevented) {
+        return;
+    }
+    const root = event.currentTarget;
+    const items = querySidebarCompositeItems(root, role);
+    const focusIndex = resolveSidebarCompositeFocusIndex(items, document.activeElement);
+    const focusedItem = focusIndex >= 0 ? items[focusIndex] : null;
+    if (focusedItem != null && isSidebarRowActionsMenuKey(event)) {
+        event.preventDefault();
+        openSidebarRowActionsMenu(focusedItem);
+        return;
+    }
+    if (role === SIDEBAR_TREE_ITEM_ROLE && focusedItem != null) {
+        if (handleSidebarTreeHorizontalKey(event, focusedItem, items, focusIndex)) {
+            return;
+        }
+    }
+    handleSidebarCompositeVerticalKey(event, root, role);
+}
+/**
+ * Keeps roving tabindex aligned when focus moves inside the composite via pointer
+ * or programmatic focus.
+ *
+ * @param event - Focusin from the composite root.
+ * @param role - Item role managed by this composite.
+ */
+export function handleSidebarCompositeFocusIn(event, role) {
+    const root = event.currentTarget;
+    const items = querySidebarCompositeItems(root, role);
+    if (items.length === 0) {
+        return;
+    }
+    const focusIndex = resolveSidebarCompositeFocusIndex(items, event.target);
+    if (focusIndex < 0) {
+        return;
+    }
+    setSidebarCompositeRovingTabIndex(items, focusIndex);
+}

package/dist/components/SidebarItem/sidebarListOption.d.ts

@@ -1,6 +1,10 @@
 import type { KeyboardEvent } from 'react';
 /**
  * Activates a listbox option on Enter or Space, matching native button behavior.
+ * Opens the row actions menu on Shift+F10 / ContextMenu when a trigger is present.
+ *
+ * @param event - Keydown from the option or treeitem.
+ * @param onActivate - Called for Enter / Space activation.
  */
 export declare function handleSidebarOptionKeyDown(event: KeyboardEvent<HTMLElement>, onActivate?: (event: KeyboardEvent<HTMLElement>) => void): void;
 //# sourceMappingURL=sidebarListOption.d.ts.map

package/dist/components/SidebarItem/sidebarListOption.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidebarListOption.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/sidebarListOption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,EACjC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,GACvD,IAAI,CAON"}
+{"version":3,"file":"sidebarListOption.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/sidebarListOption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAM3C;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,EACjC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,GACvD,IAAI,CAcN"}

package/dist/components/SidebarItem/sidebarListOption.js

@@ -1,7 +1,18 @@
+import { isSidebarRowActionsMenuKey, openSidebarRowActionsMenu } from './sidebarCompositeNavigation.js';
 /**
  * Activates a listbox option on Enter or Space, matching native button behavior.
+ * Opens the row actions menu on Shift+F10 / ContextMenu when a trigger is present.
+ *
+ * @param event - Keydown from the option or treeitem.
+ * @param onActivate - Called for Enter / Space activation.
  */
 export function handleSidebarOptionKeyDown(event, onActivate) {
+    if (isSidebarRowActionsMenuKey(event)) {
+        if (openSidebarRowActionsMenu(event.currentTarget)) {
+            event.preventDefault();
+        }
+        return;
+    }
     if (event.key !== 'Enter' && event.key !== ' ') {
         return;
     }

package/dist/components/SidebarRail/SidebarRailItem.d.ts

@@ -52,7 +52,7 @@ interface Props {
      */
     onSelect: () => void;
     /**
-     * Keyboard handler for tablist arrow-key navigation.
+     * Keyboard handler for tablist arrow-key navigation and panel entry.
      */
     onKeyDown: (event: KeyboardEvent<HTMLButtonElement>) => void;
     /**

package/dist/components/SidebarRail/SidebarRailItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SidebarRailItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarRail/SidebarRailItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAUrD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACrC;AAED,UAAU,KAAK;IACb;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC;IAE1B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAE7D;;OAEG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;CACpC;AA0ED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACV,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAoDrB"}
+{"version":3,"file":"SidebarRailItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarRail/SidebarRailItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAWrD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACrC;AAED,UAAU,KAAK;IACb;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC;IAE1B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAE7D;;OAEG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;CACpC;AA0ED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACV,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAqDrB"}

package/dist/components/SidebarRail/SidebarRailItem.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
 import { FaIcon } from '../FaIcon/index.js';
 import { cn } from '../utils.js';
+import { sidebarRailTabId } from './focusSidebarRailPanel.js';
 /**
  * Shared focus-visible outline for rail tabs (matches TabBar / segment chrome).
  */
@@ -75,5 +76,5 @@ export function SidebarRailItem({ item, active, expanded, tabIndex, panelId, onS
      * left with a color-only cue and is not announced twice via aria-label.
      */
     const ariaLabel = expanded ? undefined : accessibleName;
-    return (_jsx("div", { className: railItemSectionClasses(active), children: _jsxs("button", { type: "button", role: "tab", ref: buttonRef, className: railItemButtonClasses(active, expanded), title: item.label, tabIndex: tabIndex, "aria-label": ariaLabel, "aria-selected": active, "aria-controls": panelId, onClick: onSelect, onKeyDown: onKeyDown, children: [_jsxs("span", { className: "relative inline-flex shrink-0 items-center justify-center", children: [_jsx(FaIcon, { icon: item.icon, className: "hc-sidebar-rail-item-icon h-[22.5px]! w-[22.5px]!", "aria-hidden": true }), item.badge ? (_jsx("span", { className: cn('hc-sidebar-rail-item-badge absolute -top-0.5 -right-0.5 h-2 w-2 rounded-full', railItemBadgeBackgroundClass(item.badgeVariant)), "aria-hidden": true })) : null] }), expanded ? (_jsx("span", { className: "hc-sidebar-rail-item-label min-w-0 truncate text-left", children: item.label })) : null, expanded && item.badge === true ? (_jsxs("span", { className: "sr-only", children: [", ", badgeStatusLabel] })) : null] }) }));
+    return (_jsx("div", { className: railItemSectionClasses(active), children: _jsxs("button", { type: "button", role: "tab", id: sidebarRailTabId(item.id), ref: buttonRef, className: railItemButtonClasses(active, expanded), title: item.label, tabIndex: tabIndex, "aria-label": ariaLabel, "aria-selected": active, "aria-controls": panelId, onClick: onSelect, onKeyDown: onKeyDown, children: [_jsxs("span", { className: "relative inline-flex shrink-0 items-center justify-center", children: [_jsx(FaIcon, { icon: item.icon, className: "hc-sidebar-rail-item-icon h-[22.5px]! w-[22.5px]!", "aria-hidden": true }), item.badge ? (_jsx("span", { className: cn('hc-sidebar-rail-item-badge absolute -top-0.5 -right-0.5 h-2 w-2 rounded-full', railItemBadgeBackgroundClass(item.badgeVariant)), "aria-hidden": true })) : null] }), expanded ? (_jsx("span", { className: "hc-sidebar-rail-item-label min-w-0 truncate text-left", children: item.label })) : null, expanded && item.badge === true ? (_jsxs("span", { className: "sr-only", children: [", ", badgeStatusLabel] })) : null] }) }));
 }

package/dist/components/SidebarRail/focusSidebarRailPanel.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Builds the stable DOM id for a sidebar rail tab button.
+ *
+ * Used for `id` on the tab and `aria-labelledby` on the associated tabpanel.
+ *
+ * @param itemId - Rail item id from {@link SidebarRailItemData.id}.
+ * @returns Stable element id string.
+ */
+export declare function sidebarRailTabId(itemId: string): string;
+/**
+ * Moves focus to the first visible focusable element inside a rail tab panel.
+ *
+ * Falls back to focusing the panel itself (making it programmatically focusable)
+ * when the panel has no interactive descendants yet — for example empty states
+ * or content still mounting after a mode change.
+ *
+ * @param panel - Tab panel element, or null when missing from the DOM.
+ * @returns True when focus moved into the panel or onto a descendant.
+ */
+export declare function focusSidebarRailPanel(panel: HTMLElement | null): boolean;
+/**
+ * Returns focus from a rail tab panel to the tab that labels it.
+ *
+ * Skips CodeMirror editors so Arrow keys keep editing text. Used when the
+ * directional key opposite the panel-entry key is pressed inside the panel.
+ *
+ * @param panel - Tab panel that currently contains focus.
+ * @returns True when focus moved back to the owning tab.
+ */
+export declare function focusSidebarRailTabFromPanel(panel: HTMLElement): boolean;
+//# sourceMappingURL=focusSidebarRailPanel.d.ts.map

package/dist/components/SidebarRail/focusSidebarRailPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusSidebarRailPanel.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarRail/focusSidebarRailPanel.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CA+BxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAsBxE"}

package/dist/components/SidebarRail/focusSidebarRailPanel.js

@@ -0,0 +1,73 @@
+import { getFocusableElements } from '../useDialogFocus.js';
+/**
+ * Builds the stable DOM id for a sidebar rail tab button.
+ *
+ * Used for `id` on the tab and `aria-labelledby` on the associated tabpanel.
+ *
+ * @param itemId - Rail item id from {@link SidebarRailItemData.id}.
+ * @returns Stable element id string.
+ */
+export function sidebarRailTabId(itemId) {
+    return `hc-sidebar-rail-tab-${itemId}`;
+}
+/**
+ * Moves focus to the first visible focusable element inside a rail tab panel.
+ *
+ * Falls back to focusing the panel itself (making it programmatically focusable)
+ * when the panel has no interactive descendants yet — for example empty states
+ * or content still mounting after a mode change.
+ *
+ * @param panel - Tab panel element, or null when missing from the DOM.
+ * @returns True when focus moved into the panel or onto a descendant.
+ */
+export function focusSidebarRailPanel(panel) {
+    if (panel == null) {
+        return false;
+    }
+    let firstFocusable = getFocusableElements(panel)[0];
+    if (firstFocusable == null) {
+        const selector = 'button:not([disabled]), a[href], input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
+        firstFocusable =
+            Array.from(panel.querySelectorAll(selector)).find((element) => !element.closest('[aria-hidden="true"]')) ?? undefined;
+    }
+    if (firstFocusable != null && typeof firstFocusable.focus === 'function') {
+        firstFocusable.focus();
+        return true;
+    }
+    if (typeof panel.focus !== 'function') {
+        return false;
+    }
+    if (!panel.hasAttribute('tabindex')) {
+        panel.tabIndex = -1;
+    }
+    panel.focus();
+    return document.activeElement === panel;
+}
+/**
+ * Returns focus from a rail tab panel to the tab that labels it.
+ *
+ * Skips CodeMirror editors so Arrow keys keep editing text. Used when the
+ * directional key opposite the panel-entry key is pressed inside the panel.
+ *
+ * @param panel - Tab panel that currently contains focus.
+ * @returns True when focus moved back to the owning tab.
+ */
+export function focusSidebarRailTabFromPanel(panel) {
+    const active = document.activeElement;
+    if (!(active instanceof HTMLElement) || !panel.contains(active)) {
+        return false;
+    }
+    if (active.closest('.cm-editor') != null) {
+        return false;
+    }
+    const labelledBy = panel.getAttribute('aria-labelledby');
+    if (labelledBy == null || labelledBy === '') {
+        return false;
+    }
+    const tab = document.getElementById(labelledBy);
+    if (!(tab instanceof HTMLElement) || typeof tab.focus !== 'function') {
+        return false;
+    }
+    tab.focus();
+    return document.activeElement === tab;
+}