@harborclient/sdk 1.3.2 → 1.3.4

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

@@ -4,6 +4,10 @@ interface Props {
      * Tailwind background color class for the dot (e.g. from {@link statusDotClass}).
      */
     className: string;
+    /**
+     * When false, suppresses the indicator even when status data is available.
+     */
+    visible?: boolean;
     /**
      * Screen-reader text describing the status when a visible label is not shown.
      */
@@ -15,7 +19,13 @@ interface Props {
 }
 /**
  * Renders a small circular status indicator with optional screen-reader text.
+ *
+ * @param className - Tailwind background color class for the dot.
+ * @param visible - When false, returns null instead of rendering the indicator.
+ * @param srOnlyLabel - Screen-reader text describing the status.
+ * @param title - Native tooltip shown on hover.
+ * @returns The status indicator, or null when visibility is disabled.
  */
-export declare function SidebarStatusDot({ className, srOnlyLabel, title }: Props): JSX.Element;
+export declare function SidebarStatusDot({ className, visible, srOnlyLabel, title }: Props): JSX.Element | null;
 export {};
 //# sourceMappingURL=SidebarStatusDot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SidebarStatusDot.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SidebarStatusDot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGjC,UAAU,KAAK;IACb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAUtF"}
+{"version":3,"file":"SidebarStatusDot.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SidebarStatusDot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGjC,UAAU,KAAK;IACb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,OAAc,EACd,WAAW,EACX,KAAK,EACN,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAc5B"}

package/dist/components/SidebarItem/SidebarStatusDot.js

@@ -2,7 +2,16 @@ import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
 import { cn } from '../utils.js';
 /**
  * Renders a small circular status indicator with optional screen-reader text.
+ *
+ * @param className - Tailwind background color class for the dot.
+ * @param visible - When false, returns null instead of rendering the indicator.
+ * @param srOnlyLabel - Screen-reader text describing the status.
+ * @param title - Native tooltip shown on hover.
+ * @returns The status indicator, or null when visibility is disabled.
  */
-export function SidebarStatusDot({ className, srOnlyLabel, title }) {
+export function SidebarStatusDot({ className, visible = true, srOnlyLabel, title }) {
+    if (!visible) {
+        return null;
+    }
     return (_jsxs("span", { className: "flex shrink-0 items-center gap-1.5", title: title, children: [_jsx("span", { className: cn('inline-block h-2 w-2 shrink-0 rounded-full', className), "aria-hidden": "true" }), srOnlyLabel != null ? _jsx("span", { className: "sr-only", children: srOnlyLabel }) : null] }));
 }

package/dist/components/SidebarItem/{SidebarTabGroupItem.d.ts → SidebarWorkspaceItem.d.ts}

@@ -3,7 +3,7 @@ import type { JSX, MouseEvent, ReactNode } from 'react';
 import { type SidebarItemSortableConfig } from './SidebarItem.js';
 interface Props {
     /**
-     * Tab group display name.
+     * Workspace display name.
      */
     name: string;
     /**
@@ -11,14 +11,14 @@ interface Props {
      */
     summary: string;
     /**
-     * Icon shown before the tab group name.
+     * Icon shown before the workspace name.
      */
     icon: IconDefinition;
     /**
-     * Optional color dot beside the tab group name.
+     * Optional marker dot beside the workspace name.
      */
-    colorDot?: {
-        color: string | null | undefined;
+    markerDot?: {
+        marker: string | null | undefined;
         visible?: boolean;
         label?: string;
     };
@@ -27,7 +27,7 @@ interface Props {
      */
     selected?: boolean;
     /**
-     * dnd-kit sortable configuration for tab group reordering.
+     * dnd-kit sortable configuration for workspace reordering.
      */
     sortable?: SidebarItemSortableConfig;
     /**
@@ -48,8 +48,8 @@ interface Props {
     as?: 'div' | 'li';
 }
 /**
- * Renders a tab group row in the Collections sidebar Tab Groups section.
+ * Renders a workspace row in the Collections sidebar Workspaces section.
  */
-export declare function SidebarTabGroupItem({ name, summary, icon, colorDot, selected, sortable, onContextMenu, onClick, actions, as }: Props): JSX.Element;
+export declare function SidebarWorkspaceItem({ name, summary, icon, markerDot, selected, sortable, onContextMenu, onClick, actions, as }: Props): JSX.Element;
 export {};
-//# sourceMappingURL=SidebarTabGroupItem.d.ts.map
+//# sourceMappingURL=SidebarWorkspaceItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarWorkspaceItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SidebarWorkspaceItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAExD,OAAO,EAAe,KAAK,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAI/E,UAAU,KAAK;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QAClC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAErC;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAEzD;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAEnD;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,SAAS,EACT,QAAgB,EAChB,QAAQ,EACR,aAAa,EACb,OAAO,EACP,OAAO,EACP,EAAS,EACV,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAkCrB"}

package/dist/components/SidebarItem/{SidebarTabGroupItem.js → SidebarWorkspaceItem.js}

@@ -1,16 +1,16 @@
 import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
 import { FaIcon } from '../FaIcon/index.js';
-import { SidebarColorDot } from './SidebarColorDot.js';
 import { SidebarItem } from './SidebarItem.js';
+import { SidebarMarkerDot } from './SidebarMarkerDot.js';
 import { SIDEBAR_ITEM_BUTTON_CLASS } from './sidebarItemClasses.js';
 /**
- * Renders a tab group row in the Collections sidebar Tab Groups section.
+ * Renders a workspace row in the Collections sidebar Workspaces section.
  */
-export function SidebarTabGroupItem({ name, summary, icon, colorDot, selected = false, sortable, onContextMenu, onClick, actions, as = 'li' }) {
+export function SidebarWorkspaceItem({ name, summary, icon, markerDot, selected = false, sortable, onContextMenu, onClick, actions, as = 'li' }) {
     const useListboxOption = as === 'li';
     return (_jsx(SidebarItem, { selected: selected, sortable: sortable, onContextMenu: onContextMenu, actions: actions, as: as, listboxOption: useListboxOption
             ? {
                 onClick
             }
-            : undefined, children: _jsxs("span", { className: `${SIDEBAR_ITEM_BUTTON_CLASS} gap-2 rounded-md px-2 py-1`, children: [_jsx(FaIcon, { icon: icon, className: "h-3.5 w-3.5 shrink-0 text-muted", "aria-hidden": true }), _jsxs("span", { className: "inline-flex min-w-0 flex-1 items-center gap-1.5", children: [_jsx("span", { className: "min-w-0 truncate", children: name }), colorDot != null ? (_jsx(SidebarColorDot, { color: colorDot.color, visible: colorDot.visible, label: colorDot.label })) : null] }), _jsx("span", { className: "shrink-0 text-muted", children: summary })] }) }));
+            : undefined, children: _jsxs("span", { className: `${SIDEBAR_ITEM_BUTTON_CLASS} gap-2 rounded-md px-2 py-1`, children: [_jsx(FaIcon, { icon: icon, className: "h-3.5 w-3.5 shrink-0 text-muted", "aria-hidden": true }), _jsxs("span", { className: "inline-flex min-w-0 flex-1 items-center gap-1.5", children: [_jsx("span", { className: "min-w-0 truncate", children: name }), markerDot != null ? (_jsx(SidebarMarkerDot, { marker: markerDot.marker, visible: markerDot.visible, label: markerDot.label })) : null] }), _jsx("span", { className: "shrink-0 text-muted", children: summary })] }) }));
 }

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

@@ -6,9 +6,9 @@ export { SidebarTreeGroup } from './SidebarTreeGroup.js';
 export { handleSidebarOptionKeyDown } from './sidebarListOption.js';
 export { SortableSidebarItem } from './SortableSidebarItem.js';
 export { stopSortableDragPointerDown } from './stopSortableDragPointerDown.js';
-export { SidebarColorDot } from './SidebarColorDot.js';
+export { SidebarMarkerDot } from './SidebarMarkerDot.js';
 export { SidebarBadge, type SidebarBadgeVariant } from './SidebarBadge.js';
-export { sourceRow, METHOD_CLASSES, statusDotVariant, statusDotClass, SIDEBAR_ITEM_BUTTON_CLASS, SIDEBAR_CHEVRON_BUTTON_CLASS, SIDEBAR_CHEVRON_ICON_CLASS, SIDEBAR_CHEVRON_SLOT_CLASS, SIDEBAR_CHEVRON_LABEL_OFFSET_CLASS } from './sidebarItemClasses.js';
+export { sourceRow, METHOD_CLASSES, methodBadgeClass, documentIconClass, statusDotVariant, statusDotClass, SIDEBAR_ITEM_BUTTON_CLASS, SIDEBAR_CHEVRON_BUTTON_CLASS, SIDEBAR_CHEVRON_ICON_CLASS, SIDEBAR_CHEVRON_SLOT_CLASS, SIDEBAR_CHEVRON_LABEL_OFFSET_CLASS } from './sidebarItemClasses.js';
 export { SidebarMethodBadge } from './SidebarMethodBadge.js';
 export { SidebarStatusDot } from './SidebarStatusDot.js';
 export { SidebarStatusMarker } from './SidebarStatusMarker.js';
@@ -18,6 +18,6 @@ export { SidebarFolderItem } from './SidebarFolderItem.js';
 export { SidebarRunItem } from './SidebarRunItem.js';
 export { SidebarHistoryItem } from './SidebarHistoryItem.js';
 export { SidebarEnvironmentItem } from './SidebarEnvironmentItem.js';
-export { SidebarTabGroupItem } from './SidebarTabGroupItem.js';
+export { SidebarWorkspaceItem } from './SidebarWorkspaceItem.js';
 export { SidebarCommitItem, type SidebarCommitPushStatus } from './SidebarCommitItem.js';
 //# sourceMappingURL=index.d.ts.map

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,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,SAAS,EACT,cAAc,EACd,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,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,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,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,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/components/SidebarItem/index.js

@@ -6,9 +6,9 @@ export { SidebarTreeGroup } from './SidebarTreeGroup.js';
 export { handleSidebarOptionKeyDown } from './sidebarListOption.js';
 export { SortableSidebarItem } from './SortableSidebarItem.js';
 export { stopSortableDragPointerDown } from './stopSortableDragPointerDown.js';
-export { SidebarColorDot } from './SidebarColorDot.js';
+export { SidebarMarkerDot } from './SidebarMarkerDot.js';
 export { SidebarBadge } from './SidebarBadge.js';
-export { sourceRow, METHOD_CLASSES, statusDotVariant, statusDotClass, SIDEBAR_ITEM_BUTTON_CLASS, SIDEBAR_CHEVRON_BUTTON_CLASS, SIDEBAR_CHEVRON_ICON_CLASS, SIDEBAR_CHEVRON_SLOT_CLASS, SIDEBAR_CHEVRON_LABEL_OFFSET_CLASS } from './sidebarItemClasses.js';
+export { sourceRow, METHOD_CLASSES, methodBadgeClass, documentIconClass, statusDotVariant, statusDotClass, SIDEBAR_ITEM_BUTTON_CLASS, SIDEBAR_CHEVRON_BUTTON_CLASS, SIDEBAR_CHEVRON_ICON_CLASS, SIDEBAR_CHEVRON_SLOT_CLASS, SIDEBAR_CHEVRON_LABEL_OFFSET_CLASS } from './sidebarItemClasses.js';
 export { SidebarMethodBadge } from './SidebarMethodBadge.js';
 export { SidebarStatusDot } from './SidebarStatusDot.js';
 export { SidebarStatusMarker } from './SidebarStatusMarker.js';
@@ -18,5 +18,5 @@ export { SidebarFolderItem } from './SidebarFolderItem.js';
 export { SidebarRunItem } from './SidebarRunItem.js';
 export { SidebarHistoryItem } from './SidebarHistoryItem.js';
 export { SidebarEnvironmentItem } from './SidebarEnvironmentItem.js';
-export { SidebarTabGroupItem } from './SidebarTabGroupItem.js';
+export { SidebarWorkspaceItem } from './SidebarWorkspaceItem.js';
 export { SidebarCommitItem } from './SidebarCommitItem.js';

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

@@ -4,6 +4,8 @@ import type { StatusDotVariant } from '../StatusDot/index.js';
  */
 /**
  * Tailwind classes for a sidebar source row (collection, folder, request, etc.).
+ * Uses left padding only so trailing hamburger menus align with section header
+ * Add/Erase actions (which sit at the sidebar body's `pr-2` inset).
  *
  * @param selected - Whether this row is the active selection.
  * @param compact - When true, uses tighter vertical padding for top-level list rows.
@@ -14,6 +16,21 @@ export declare function sourceRow(selected: boolean, compact?: boolean): string;
  * HTTP method color classes keyed by lowercase method name.
  */
 export declare const METHOD_CLASSES: Record<string, string>;
+/**
+ * Returns Tailwind classes for an HTTP method badge in the sidebar.
+ *
+ * @param method - HTTP method string.
+ * @param methodColors - When false, uses neutral theme text instead of per-method colors.
+ * @returns Combined Tailwind class string for the method badge.
+ */
+export declare function methodBadgeClass(method: string, methodColors?: boolean): string;
+/**
+ * Returns Tailwind classes for a collection markdown document icon in the sidebar.
+ *
+ * @param methodColors - When false, uses neutral theme text instead of the doc-markdown accent.
+ * @returns Tailwind text color class for the document icon.
+ */
+export declare function documentIconClass(methodColors?: boolean): string;
 /**
  * Status dot variant for an HTTP response code.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"sidebarItemClasses.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/sidebarItemClasses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,UAAQ,GAAG,MAAM,CAKpE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQjD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAMjE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,+HACwF,CAAC;AAE/H;;GAEG;AACH,eAAO,MAAM,yBAAyB,oVAC6S,CAAC;AAEpV;;;GAGG;AACH,eAAO,MAAM,4BAA4B,0JACgH,CAAC;AAE1J;;;GAGG;AACH,eAAO,MAAM,0BAA0B,cAAc,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,kEAC0B,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,kCAAkC,WAAW,CAAC"}
+{"version":3,"file":"sidebarItemClasses.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/sidebarItemClasses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D;;GAEG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,UAAQ,GAAG,MAAM,CAKpE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQjD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,MAAM,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,UAAO,GAAG,MAAM,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAMjE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,+HACwF,CAAC;AAE/H;;GAEG;AACH,eAAO,MAAM,yBAAyB,oVAC6S,CAAC;AAEpV;;;GAGG;AACH,eAAO,MAAM,4BAA4B,0JACgH,CAAC;AAE1J;;;GAGG;AACH,eAAO,MAAM,0BAA0B,cAAc,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,kEAC0B,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,kCAAkC,WAAW,CAAC"}

package/dist/components/SidebarItem/sidebarItemClasses.js

@@ -4,6 +4,8 @@ import { statusDotVariantClass } from '../StatusDot/index.js';
  */
 /**
  * Tailwind classes for a sidebar source row (collection, folder, request, etc.).
+ * Uses left padding only so trailing hamburger menus align with section header
+ * Add/Erase actions (which sit at the sidebar body's `pr-2` inset).
  *
  * @param selected - Whether this row is the active selection.
  * @param compact - When true, uses tighter vertical padding for top-level list rows.
@@ -12,8 +14,8 @@ import { statusDotVariantClass } from '../StatusDot/index.js';
 export function sourceRow(selected, compact = false) {
     const py = compact ? 'py-0' : 'py-0.5';
     return selected
-        ? `group flex items-center gap-1 rounded-md bg-selection px-1.5 ${py} app-no-drag`
-        : `group flex items-center gap-1 rounded-md px-1.5 ${py} hover:bg-selection/60 app-no-drag`;
+        ? `group flex items-center gap-1 rounded-md bg-selection pl-1.5 pr-0 ${py} app-no-drag`
+        : `group flex items-center gap-1 rounded-md pl-1.5 pr-0 ${py} hover:bg-selection/60 app-no-drag`;
 }
 /**
  * HTTP method color classes keyed by lowercase method name.
@@ -27,6 +29,28 @@ export const METHOD_CLASSES = {
     head: 'hc-method-badge text-method-head',
     options: 'hc-method-badge text-method-options'
 };
+/**
+ * Returns Tailwind classes for an HTTP method badge in the sidebar.
+ *
+ * @param method - HTTP method string.
+ * @param methodColors - When false, uses neutral theme text instead of per-method colors.
+ * @returns Combined Tailwind class string for the method badge.
+ */
+export function methodBadgeClass(method, methodColors = true) {
+    if (!methodColors) {
+        return 'hc-method-badge text-text';
+    }
+    return METHOD_CLASSES[method.toLowerCase()] ?? 'hc-method-badge text-text';
+}
+/**
+ * Returns Tailwind classes for a collection markdown document icon in the sidebar.
+ *
+ * @param methodColors - When false, uses neutral theme text instead of the doc-markdown accent.
+ * @returns Tailwind text color class for the document icon.
+ */
+export function documentIconClass(methodColors = true) {
+    return methodColors ? 'text-doc-markdown' : 'text-text';
+}
 /**
  * Status dot variant for an HTTP response code.
  *

package/dist/components/SidebarSection/SectionItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarSection/SectionItem.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,GAAG,EAA4B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AAO3F,UAAU,mBAAmB;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,KAAM,SAAQ,mBAAmB;IAChD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AA+ED,eAAO,MAAM,gBAAgB,EAIb,CAAC,KAAK,EAAE,KAAK,KAAK,GAAG,CAAC,OAAO,CAAC"}
+{"version":3,"file":"SectionItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarSection/SectionItem.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,GAAG,EAA4B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AAO3F,UAAU,mBAAmB;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,KAAM,SAAQ,mBAAmB;IAChD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAiFD,eAAO,MAAM,gBAAgB,EAIb,CAAC,KAAK,EAAE,KAAK,KAAK,GAAG,CAAC,OAAO,CAAC"}

package/dist/components/SidebarSection/SectionItem.js

@@ -7,13 +7,15 @@ import { SIDEBAR_CHEVRON_ICON_CLASS, SIDEBAR_CHEVRON_SLOT_CLASS } from '../Sideb
 /**
  * Renders the sidebar section header row and animated body panel.
  * Header chevron inset and title gap follow shared `SIDEBAR_CHEVRON_*` spacing.
+ * Right-side controls use `hc-sidebar-section-header-actions` so host CSS can
+ * apply a shared fixed square size across filter, clear, and add buttons.
  */
 const SectionItem = memo(function SectionItem({ forwardedRef, itemRef, state, toggle, title, children, onAdd, addLabel, headerActions, flushBody = false }) {
     const { buttonProps, panelProps } = useAccordionItem({ state, toggle });
     const [transitionStyle, panelRef] = useHeightTransition(state);
     const itemElementRef = useMergeRef(forwardedRef, itemRef);
     const { status, isMounted, isEnter } = state;
-    return (_jsxs("div", { ref: itemElementRef, className: "-mr-2 mb-1", children: [_jsxs("div", { className: `hc-sidebar-section-header flex min-h-8 items-center justify-between gap-2 bg-sidebar-section py-0.5 pr-2 ${flushBody ? 'mb-0' : 'mb-1'}`, children: [_jsxs("button", { ...buttonProps, type: "button", className: "app-no-drag inline-flex min-w-0 flex-1 cursor-pointer items-center gap-2.5 border-none bg-transparent p-0 text-left", children: [_jsx("span", { className: SIDEBAR_CHEVRON_SLOT_CLASS, children: _jsx(FaIcon, { icon: isEnter ? faChevronDown : faChevronRight, className: `${SIDEBAR_CHEVRON_ICON_CLASS} text-sidebar-section-text` }) }), _jsx("h2", { className: "m-0 text-[15px] leading-none font-medium tracking-wide text-sidebar-section-text uppercase", children: title })] }), (headerActions || onAdd) && (_jsxs("div", { className: "flex shrink-0 items-center gap-1", children: [headerActions, onAdd ? (_jsx("button", { type: "button", className: "hc-sidebar-add-button app-no-drag inline-flex shrink-0 cursor-pointer items-center justify-center border-none bg-transparent text-muted hover:bg-selection hover:text-text focus-visible:bg-selection focus-visible:text-text", title: addLabel ?? 'Add', "aria-label": addLabel ?? 'Add', onClick: onAdd, children: _jsx(FaIcon, { icon: faPlus, className: "h-4 w-4" }) })) : null] }))] }), isMounted ? (_jsx("div", { style: {
+    return (_jsxs("div", { ref: itemElementRef, className: "-mr-2 mb-1", children: [_jsxs("div", { className: `hc-sidebar-section-header flex min-h-8 items-center justify-between gap-2 bg-sidebar-section py-0.5 pr-2 ${flushBody ? 'mb-0' : 'mb-1'}`, children: [_jsxs("button", { ...buttonProps, type: "button", className: "app-no-drag inline-flex min-w-0 flex-1 cursor-pointer items-center gap-2.5 border-none bg-transparent p-0 text-left", children: [_jsx("span", { className: SIDEBAR_CHEVRON_SLOT_CLASS, children: _jsx(FaIcon, { icon: isEnter ? faChevronDown : faChevronRight, className: `${SIDEBAR_CHEVRON_ICON_CLASS} text-sidebar-section-text` }) }), _jsx("h2", { className: "m-0 text-[15px] leading-none font-medium tracking-wide text-sidebar-section-text uppercase", children: title })] }), (headerActions || onAdd) && (_jsxs("div", { className: "hc-sidebar-section-header-actions flex shrink-0 items-center gap-1", children: [headerActions, onAdd ? (_jsx("button", { type: "button", className: "hc-sidebar-add-button app-no-drag inline-flex shrink-0 cursor-pointer items-center justify-center border-none bg-transparent text-muted hover:bg-selection hover:text-text focus-visible:bg-selection focus-visible:text-text", title: addLabel ?? 'Add', "aria-label": addLabel ?? 'Add', onClick: onAdd, children: _jsx(FaIcon, { icon: faPlus, className: "h-3.5 w-3.5" }) })) : null] }))] }), isMounted ? (_jsx("div", { style: {
                     display: status === 'exited' ? 'none' : undefined,
                     ...transitionStyle
                 }, className: "transition-[height] duration-200 ease-out motion-reduce:transition-none", children: _jsx("div", { ...panelProps, ref: panelRef, children: children }) })) : null] }));

package/dist/components/SortButton/SortButtonIcon.d.ts

@@ -0,0 +1,29 @@
+import type { IconDefinition } from '@fortawesome/fontawesome-svg-core';
+import type { JSX } from 'react';
+interface Props {
+    /**
+     * When true, shows a SegmentedTabs-matching accent dot on the icon corner.
+     */
+    active?: boolean;
+    /**
+     * Font Awesome icon to render. Defaults to the sort bars icon.
+     */
+    icon?: IconDefinition;
+    /**
+     * Additional classes merged onto the icon wrapper.
+     */
+    className?: string;
+}
+/**
+ * Sort bars icon with an optional accent corner indicator when a non-default
+ * sort is applied. Shared by {@link SortButton} so the active affordance stays
+ * consistent with {@link FilterButton}.
+ *
+ * @param active - When true, shows the accent status dot.
+ * @param icon - Icon to render; defaults to `faArrowDownShortWide`.
+ * @param className - Extra classes for the wrapper.
+ * @returns Relative icon wrapper with optional active indicator.
+ */
+export declare function SortButtonIcon({ active, icon, className }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=SortButtonIcon.d.ts.map

package/dist/components/SortButton/SortButtonIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SortButtonIcon.d.ts","sourceRoot":"","sources":["../../../src/components/SortButton/SortButtonIcon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAKjC,UAAU,KAAK;IACb;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAc,EACd,IAA2B,EAC3B,SAAS,EACV,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAcrB"}

package/dist/components/SortButton/SortButtonIcon.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
+import { faArrowDownShortWide } from '@fortawesome/free-solid-svg-icons';
+import { FaIcon } from '../FaIcon/index.js';
+import { StatusDot } from '../StatusDot/index.js';
+import { cn } from '../utils.js';
+/**
+ * Sort bars icon with an optional accent corner indicator when a non-default
+ * sort is applied. Shared by {@link SortButton} so the active affordance stays
+ * consistent with {@link FilterButton}.
+ *
+ * @param active - When true, shows the accent status dot.
+ * @param icon - Icon to render; defaults to `faArrowDownShortWide`.
+ * @param className - Extra classes for the wrapper.
+ * @returns Relative icon wrapper with optional active indicator.
+ */
+export function SortButtonIcon({ active = false, icon = faArrowDownShortWide, className }) {
+    return (_jsxs("span", { className: cn('hc-sort-button-icon relative inline-flex shrink-0', className), children: [_jsx(FaIcon, { icon: icon, className: "h-3.5 w-3.5", "aria-hidden": true }), active ? (_jsx(StatusDot, { variant: "accent", size: "sm", label: "Custom sort applied", className: "absolute -top-0.5 -right-0.5" })) : null] }));
+}

package/dist/components/SortButton/SortMenu.d.ts

@@ -0,0 +1,42 @@
+import { type ReactPortal, type RefObject } from 'react';
+import type { SortOption } from './sortOptions.js';
+interface Props {
+    /**
+     * Sort toolbar button used to anchor the portaled listbox.
+     */
+    anchorRef: RefObject<HTMLElement | null>;
+    /**
+     * Selectable sort options to render.
+     */
+    options: readonly SortOption[];
+    /**
+     * Currently selected option id.
+     */
+    value: string;
+    /**
+     * Accessible name for the listbox.
+     */
+    ariaLabel?: string;
+    /**
+     * Applies a sort selection and should close the menu.
+     */
+    onSelect: (id: string) => void;
+    /**
+     * Closes the menu without changing the sort.
+     */
+    onClose: () => void;
+}
+/**
+ * Portaled single-select listbox of sort options. Selecting an option applies
+ * immediately and closes the menu (filter-menu style).
+ *
+ * @param anchorRef - Sort toolbar button used for positioning.
+ * @param options - Sort options to render.
+ * @param value - Currently selected option id.
+ * @param ariaLabel - Accessible name for the listbox.
+ * @param onSelect - Called when the user picks an option.
+ * @param onClose - Called when the menu should dismiss.
+ */
+export declare function SortMenu({ anchorRef, options, value, ariaLabel, onSelect, onClose }: Props): ReactPortal | null;
+export {};
+//# sourceMappingURL=SortMenu.d.ts.map

package/dist/components/SortButton/SortMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SortMenu.d.ts","sourceRoot":"","sources":["../../../src/components/SortButton/SortMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AASf,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,UAAU,KAAK;IACb;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAEzC;;OAEG;IACH,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/B;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,EACvB,SAAS,EACT,OAAO,EACP,KAAK,EACL,SAAkB,EAClB,QAAQ,EACR,OAAO,EACR,EAAE,KAAK,GAAG,WAAW,GAAG,IAAI,CA0J5B"}

package/dist/components/SortButton/SortMenu.js

@@ -0,0 +1,137 @@
+import { jsx as _jsx } from "@harborclient/sdk/jsx-runtime";
+import { useCallback, useEffect, useId, useLayoutEffect, useRef, useState } from 'react';
+import { clampMenuPosition, getTriggerAnchoredMenuPosition } from '../menuPosition.js';
+import { portalToBody } from '../portalToBody.js';
+import { resolveTabListKeyAction } from '../utils.js';
+import { SortMenuOption } from './SortMenuOption.js';
+/** Estimated width of the sort option listbox. */
+const LISTBOX_WIDTH_PX = 240;
+/** Estimated height before the listbox is measured. */
+const LISTBOX_HEIGHT_PX = 220;
+/**
+ * Portaled single-select listbox of sort options. Selecting an option applies
+ * immediately and closes the menu (filter-menu style).
+ *
+ * @param anchorRef - Sort toolbar button used for positioning.
+ * @param options - Sort options to render.
+ * @param value - Currently selected option id.
+ * @param ariaLabel - Accessible name for the listbox.
+ * @param onSelect - Called when the user picks an option.
+ * @param onClose - Called when the menu should dismiss.
+ */
+export function SortMenu({ anchorRef, options, value, ariaLabel = 'Sort', onSelect, onClose }) {
+    const listboxId = useId();
+    const listboxRef = useRef(null);
+    const optionRefs = useRef([]);
+    const [position, setPosition] = useState(null);
+    const [focusedIndex, setFocusedIndex] = useState(() => Math.max(0, options.findIndex((option) => option.id === value)));
+    /**
+     * Repositions the listbox under the trigger button.
+     */
+    const updatePosition = useCallback(() => {
+        const trigger = anchorRef.current;
+        if (!trigger) {
+            setPosition(null);
+            return;
+        }
+        const triggerRect = trigger.getBoundingClientRect();
+        const menuSize = {
+            width: LISTBOX_WIDTH_PX,
+            height: listboxRef.current?.offsetHeight ?? LISTBOX_HEIGHT_PX
+        };
+        const requested = getTriggerAnchoredMenuPosition(triggerRect, menuSize, 'down');
+        setPosition(clampMenuPosition(requested, menuSize));
+    }, [anchorRef]);
+    /**
+     * Anchors the listbox when it mounts and when its option count changes.
+     */
+    useLayoutEffect(() => {
+        updatePosition();
+    }, [updatePosition, options.length]);
+    /**
+     * Keeps the listbox aligned when the sidebar or viewport moves.
+     */
+    useEffect(() => {
+        window.addEventListener('scroll', updatePosition, true);
+        window.addEventListener('resize', updatePosition);
+        return () => {
+            window.removeEventListener('scroll', updatePosition, true);
+            window.removeEventListener('resize', updatePosition);
+        };
+    }, [updatePosition]);
+    /**
+     * Focuses the active option when the listbox mounts or the focused index changes.
+     */
+    useEffect(() => {
+        requestAnimationFrame(() => {
+            optionRefs.current[focusedIndex]?.focus();
+        });
+    }, [focusedIndex]);
+    /**
+     * Closes on outside pointer interaction or Escape.
+     */
+    useEffect(() => {
+        /**
+         * Closes when the user activates outside the trigger and listbox.
+         */
+        const handlePointerDown = (event) => {
+            const target = event.target;
+            if (!(target instanceof Node)) {
+                return;
+            }
+            if (anchorRef.current?.contains(target) || listboxRef.current?.contains(target)) {
+                return;
+            }
+            onClose();
+        };
+        /**
+         * Closes the listbox when the user presses Escape.
+         */
+        const handleKeyDown = (event) => {
+            if (event.key === 'Escape') {
+                event.preventDefault();
+                event.stopPropagation();
+                onClose();
+            }
+        };
+        document.addEventListener('pointerdown', handlePointerDown);
+        document.addEventListener('keydown', handleKeyDown, true);
+        return () => {
+            document.removeEventListener('pointerdown', handlePointerDown);
+            document.removeEventListener('keydown', handleKeyDown, true);
+        };
+    }, [anchorRef, onClose]);
+    /**
+     * Focuses a listbox option by index for roving tabindex navigation.
+     *
+     * @param index - Option index to focus.
+     */
+    const focusOption = useCallback((index) => {
+        setFocusedIndex(index);
+        requestAnimationFrame(() => {
+            optionRefs.current[index]?.focus();
+        });
+    }, []);
+    /**
+     * Handles arrow-key navigation and Tab-to-close inside the open listbox.
+     *
+     * @param event - Keyboard event from the listbox panel.
+     */
+    const handleListboxKeyDown = (event) => {
+        if (event.key === 'Tab') {
+            onClose();
+            return;
+        }
+        const arrowIndex = resolveTabListKeyAction(event.key, focusedIndex, options.length);
+        if (arrowIndex !== null) {
+            event.preventDefault();
+            focusOption(arrowIndex);
+        }
+    };
+    if (position == null) {
+        return null;
+    }
+    return portalToBody(_jsx("div", { ref: listboxRef, id: listboxId, role: "listbox", "aria-label": ariaLabel, className: "hc-sort-menu-listbox app-no-drag fixed z-50 max-h-[280px] overflow-y-auto rounded-md border border-separator bg-surface py-1 shadow-md", style: { top: position.y, left: position.x, width: LISTBOX_WIDTH_PX }, onKeyDown: handleListboxKeyDown, children: options.map((option, index) => (_jsx(SortMenuOption, { label: option.label, selected: option.id === value, focused: index === focusedIndex, optionRef: (element) => {
+                optionRefs.current[index] = element;
+            }, onSelect: () => onSelect(option.id) }, option.id))) }));
+}

package/dist/components/SortButton/SortMenuOption.d.ts

@@ -0,0 +1,35 @@
+import type { JSX, Ref } from 'react';
+interface Props {
+    /**
+     * Visible option label.
+     */
+    label: string;
+    /**
+     * Whether this option is the current sort selection.
+     */
+    selected: boolean;
+    /**
+     * Whether this option currently holds keyboard focus (roving tabindex).
+     */
+    focused: boolean;
+    /**
+     * Ref callback so the listbox can focus this option.
+     */
+    optionRef: Ref<HTMLButtonElement>;
+    /**
+     * Called when the user activates this option.
+     */
+    onSelect: () => void;
+}
+/**
+ * Single checkable row inside a {@link SortMenu} listbox.
+ *
+ * @param label - Visible option text.
+ * @param selected - Whether this option is the active sort mode.
+ * @param focused - Whether this option has the roving tabindex.
+ * @param optionRef - Ref callback for focus management.
+ * @param onSelect - Called when the option is activated.
+ */
+export declare function SortMenuOption({ label, selected, focused, optionRef, onSelect }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=SortMenuOption.d.ts.map

package/dist/components/SortButton/SortMenuOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SortMenuOption.d.ts","sourceRoot":"","sources":["../../../src/components/SortButton/SortMenuOption.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGtC,UAAU,KAAK;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAElC;;OAEG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,SAAS,EACT,QAAQ,EACT,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAoBrB"}

package/dist/components/SortButton/SortMenuOption.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
+import { faCheck } from '@fortawesome/free-solid-svg-icons';
+import { FaIcon } from '../FaIcon/index.js';
+/**
+ * Single checkable row inside a {@link SortMenu} listbox.
+ *
+ * @param label - Visible option text.
+ * @param selected - Whether this option is the active sort mode.
+ * @param focused - Whether this option has the roving tabindex.
+ * @param optionRef - Ref callback for focus management.
+ * @param onSelect - Called when the option is activated.
+ */
+export function SortMenuOption({ label, selected, focused, optionRef, onSelect }) {
+    return (_jsxs("button", { ref: optionRef, type: "button", role: "option", "aria-selected": selected, tabIndex: focused ? 0 : -1, className: "app-no-drag flex w-full cursor-pointer items-center gap-2 border-none bg-transparent px-3.5 py-1.5 text-left text-[14px] text-text hover:bg-selection", onClick: (event) => {
+            event.stopPropagation();
+            onSelect();
+        }, children: [_jsx("span", { className: "inline-flex w-4 shrink-0 justify-center", "aria-hidden": true, children: selected ? _jsx(FaIcon, { icon: faCheck, className: "h-3 w-3" }) : null }), _jsx("span", { className: "min-w-0 truncate", children: label })] }));
+}

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

@@ -0,0 +1,32 @@
+import type { IconDefinition } from '@fortawesome/fontawesome-svg-core';
+import type { ComponentPropsWithoutRef, JSX, RefObject } from 'react';
+interface Props extends Omit<ComponentPropsWithoutRef<'button'>, 'children' | 'aria-label'> {
+    /**
+     * When true, shows the accent sort-active indicator and full-contrast icon
+     * color. When false, the icon uses muted text until hover.
+     */
+    active?: boolean;
+    /**
+     * Font Awesome icon to render. Defaults to `faArrowDownShortWide`.
+     */
+    icon?: IconDefinition;
+    /**
+     * Accessible name for the icon-only control.
+     */
+    'aria-label': string;
+    /**
+     * Ref forwarded to the underlying native button for popover anchoring.
+     */
+    innerRef?: RefObject<HTMLButtonElement | null>;
+}
+/**
+ * Toolbar sort trigger with an optional accent corner indicator when a
+ * non-default sort is in effect. Matches the SegmentedTabs indicator color
+ * (`bg-accent`) and mirrors {@link FilterButton}.
+ *
+ * Defaults to `type="button"`. Pass `title` for a native tooltip; when omitted,
+ * the tooltip falls back to `aria-label`.
+ */
+export declare function SortButton({ active, icon, className, title, innerRef, type, 'aria-label': ariaLabel, ...props }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/SortButton/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,wBAAwB,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKtE,UAAU,KAAM,SAAQ,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACzF;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAc,EACd,IAAI,EACJ,SAAS,EACT,KAAK,EACL,QAAQ,EACR,IAAe,EACf,YAAY,EAAE,SAAS,EACvB,GAAG,KAAK,EACT,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAkBrB"}