@harborclient/sdk 1.1.5 → 1.1.6

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

@@ -0,0 +1,34 @@
+import type { PartialOptions } from 'overlayscrollbars';
+import { type OverlayScrollbarsComponentProps } from 'overlayscrollbars-react';
+import { type JSX, type ReactNode } from 'react';
+/**
+ * Scroll axis configuration for the HarborClient scrollbar wrapper.
+ */
+export type ScrollbarsAxis = 'vertical' | 'horizontal' | 'both';
+interface Props extends Omit<OverlayScrollbarsComponentProps, 'options' | 'children'> {
+    /**
+     * Which axes should scroll when content overflows.
+     */
+    axis?: ScrollbarsAxis;
+    /**
+     * When true, scrollbars fade after scrolling stops. Horizontal scrollbars never auto-hide.
+     */
+    autoHide?: boolean;
+    /**
+     * Content rendered inside the scrollable viewport.
+     */
+    children: ReactNode;
+    /**
+     * Optional OverlayScrollbars overrides merged on top of HarborClient defaults.
+     */
+    options?: PartialOptions | false | null;
+}
+/**
+ * Theme-aware scroll container backed by OverlayScrollbars.
+ *
+ * Uses the `os-theme-harbor` CSS theme so scrollbar colors follow active
+ * `--mac-scrollbar-*` tokens from built-in, custom, and plugin themes.
+ */
+export declare function Scrollbars({ axis, autoHide, children, className, options, ...rest }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Scrollbars/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA8B,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAG1D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;AAEhE,UAAU,KAAM,SAAQ,IAAI,CAAC,+BAA+B,EAAE,SAAS,GAAG,UAAU,CAAC;IACnF;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,GAAG,KAAK,GAAG,IAAI,CAAC;CACzC;AAyCD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAiB,EACjB,QAAe,EACf,QAAQ,EACR,SAAS,EACT,OAAO,EACP,GAAG,IAAI,EACR,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAkCrB"}

package/dist/components/Scrollbars/index.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx } from "@harborclient/sdk/jsx-runtime";
+import { OverlayScrollbarsComponent } from 'overlayscrollbars-react';
+import { useMemo } from 'react';
+import { cn } from '../utils.js';
+/**
+ * Default OverlayScrollbars options shared by HarborClient scroll regions.
+ */
+const HARBOR_SCROLLBARS_OPTIONS = {
+    scrollbars: {
+        theme: 'os-theme-harbor',
+        visibility: 'auto',
+        autoHideDelay: 800
+    }
+};
+/**
+ * Maps the auto-hide preference to OverlayScrollbars behavior.
+ *
+ * @param enabled - When true, handles fade after scrolling stops.
+ * @returns OverlayScrollbars auto-hide mode.
+ */
+function resolveScrollbarAutoHide(enabled) {
+    return enabled ? 'scroll' : 'never';
+}
+/**
+ * Maps a scroll axis hint to OverlayScrollbars overflow behavior.
+ *
+ * @param axis - Requested scroll direction(s).
+ * @returns Overflow options for the OverlayScrollbars instance.
+ */
+function getOverflowOptions(axis) {
+    switch (axis) {
+        case 'horizontal':
+            return { x: 'scroll', y: 'hidden' };
+        case 'vertical':
+            return { x: 'hidden', y: 'scroll' };
+        case 'both':
+        default:
+            return { x: 'scroll', y: 'scroll' };
+    }
+}
+/**
+ * Theme-aware scroll container backed by OverlayScrollbars.
+ *
+ * Uses the `os-theme-harbor` CSS theme so scrollbar colors follow active
+ * `--mac-scrollbar-*` tokens from built-in, custom, and plugin themes.
+ */
+export function Scrollbars({ axis = 'vertical', autoHide = true, children, className, options, ...rest }) {
+    /**
+     * Merges HarborClient defaults with per-instance overflow and caller overrides.
+     */
+    const mergedOptions = useMemo(() => {
+        const baseScrollbars = HARBOR_SCROLLBARS_OPTIONS.scrollbars ?? {};
+        const overrideScrollbars = options && typeof options === 'object' ? (options.scrollbars ?? {}) : {};
+        const axisOverflow = getOverflowOptions(axis);
+        const overrideOverflow = options && typeof options === 'object' ? options.overflow : undefined;
+        const resolvedAutoHide = axis === 'horizontal' ? 'never' : resolveScrollbarAutoHide(autoHide);
+        return {
+            ...HARBOR_SCROLLBARS_OPTIONS,
+            ...options,
+            overflow: overrideOverflow ? { ...axisOverflow, ...overrideOverflow } : axisOverflow,
+            scrollbars: {
+                ...baseScrollbars,
+                autoHide: resolvedAutoHide,
+                ...overrideScrollbars
+            }
+        };
+    }, [axis, autoHide, options]);
+    return (_jsx(OverlayScrollbarsComponent, { className: cn('hc-scrollbars', className), options: mergedOptions, ...rest, children: children }));
+}

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

@@ -0,0 +1,75 @@
+import { type JSX, type ReactNode } from 'react';
+/**
+ * Which edge of the main content the sidebar attaches to.
+ */
+export type SidebarSide = 'left' | 'right';
+interface Props {
+    /**
+     * Which edge of the main content the sidebar attaches to.
+     */
+    side: SidebarSide;
+    /**
+     * Accessible label for the sidebar landmark.
+     */
+    ariaLabel: string;
+    /**
+     * Non-scrolling chrome rendered above the body (search, toolbar, title bar, etc.).
+     */
+    header?: ReactNode;
+    /**
+     * Sidebar body content.
+     */
+    children: ReactNode;
+    /**
+     * When true (default), wraps the body in a scrollable region.
+     */
+    scroll?: boolean;
+    /**
+     * Scroll axis when `scroll` is enabled.
+     */
+    scrollAxis?: 'vertical' | 'horizontal' | 'both';
+    /**
+     * When true, scrollbars fade after scrolling stops.
+     */
+    scrollbarAutoHide?: boolean;
+    /**
+     * Additional classes for the scrollable body wrapper.
+     */
+    bodyClassName?: string;
+    /**
+     * Additional classes for the resizable aside element.
+     */
+    asideClassName?: string;
+    /**
+     * Additional classes for the resize handle.
+     */
+    resizeHandleClassName?: string;
+    /**
+     * Accessible label for the resize handle.
+     */
+    resizeAriaLabel?: string;
+    /**
+     * Initial width when nothing is persisted.
+     */
+    defaultSize: number;
+    /**
+     * Minimum sidebar width in pixels.
+     */
+    minSize: number;
+    /**
+     * Optional dynamic maximum width in pixels.
+     */
+    getMaxSize?: () => number;
+    /**
+     * localStorage key used to persist sidebar width.
+     */
+    storageKey: string;
+}
+/**
+ * Resizable sidebar shell with side-aware handle placement and optional scrolling body.
+ *
+ * Left sidebars render `[aside][handle]`; right sidebars render `[handle][aside]`.
+ */
+export declare function Sidebar({ side, ariaLabel, header, children, scroll, scrollAxis, scrollbarAutoHide, bodyClassName, asideClassName, resizeHandleClassName, resizeAriaLabel, defaultSize, minSize, getMaxSize, storageKey }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Sidebar/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKjD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3C,UAAU,KAAK;IACb;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;IAEhD;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,SAAS,EACT,MAAM,EACN,QAAQ,EACR,MAAa,EACb,UAAuB,EACvB,iBAAwB,EACxB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,OAAO,EACP,UAAU,EACV,UAAU,EACX,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CA4ErB"}

package/dist/components/Sidebar/index.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "@harborclient/sdk/jsx-runtime";
+import { ResizeHandle, useResizable } from '../Resizable/index.js';
+import { Scrollbars } from '../Scrollbars/index.js';
+import { cn } from '../utils.js';
+/**
+ * Resizable sidebar shell with side-aware handle placement and optional scrolling body.
+ *
+ * Left sidebars render `[aside][handle]`; right sidebars render `[handle][aside]`.
+ */
+export function Sidebar({ side, ariaLabel, header, children, scroll = true, scrollAxis = 'vertical', scrollbarAutoHide = true, bodyClassName, asideClassName, resizeHandleClassName, resizeAriaLabel, defaultSize, minSize, getMaxSize, storageKey }) {
+    const resizableOptions = {
+        axis: 'x',
+        direction: side === 'left' ? 1 : -1,
+        defaultSize,
+        minSize,
+        getMaxSize,
+        storageKey
+    };
+    const { size: width, minSize: sidebarMinSize, maxSize: sidebarMaxSize, onResizeStart, onKeyboardResize } = useResizable(resizableOptions);
+    const handle = (_jsx(ResizeHandle, { orientation: "vertical", value: width, min: sidebarMinSize, max: sidebarMaxSize, onResizeStart: onResizeStart, onKeyboardResize: onKeyboardResize, ariaLabel: resizeAriaLabel ?? 'Resize sidebar', className: cn(side === 'right' && 'border-r-0 border-l border-separator', resizeHandleClassName) }));
+    const body = scroll ? (_jsx(Scrollbars, { axis: scrollAxis, autoHide: scrollbarAutoHide, className: cn('min-h-0 flex-1', bodyClassName), children: children })) : (_jsx("div", { className: cn('flex min-h-0 flex-1 flex-col', bodyClassName), children: children }));
+    const aside = (_jsxs("aside", { className: cn('hc-sidebar flex shrink-0 flex-col overflow-x-hidden bg-sidebar', side === 'right' && 'h-full min-h-0', asideClassName), style: { width }, "aria-label": ariaLabel, children: [header, body] }));
+    if (side === 'left') {
+        return (_jsxs(_Fragment, { children: [aside, handle] }));
+    }
+    return (_jsxs(_Fragment, { children: [handle, aside] }));
+}

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

@@ -0,0 +1,22 @@
+import type { JSX } from 'react';
+interface Props {
+    /**
+     * CSS color string to render, or null/undefined to hide the dot.
+     */
+    color: string | null | undefined;
+    /**
+     * When false, suppresses the dot even when a color is assigned.
+     */
+    visible?: boolean;
+    /**
+     * Accessible label when the dot conveys meaning without visible text.
+     */
+    label?: string;
+}
+/**
+ * Renders a small colored circle beside a sidebar row when a color is assigned
+ * and visibility is enabled.
+ */
+export declare function SidebarColorDot({ color, visible, label }: Props): JSX.Element | null;
+export {};
+//# sourceMappingURL=SidebarColorDot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarColorDot.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SidebarColorDot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC,UAAU,KAAK;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,OAAc,EAAE,KAAK,EAAE,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAa3F"}

package/dist/components/SidebarItem/SidebarColorDot.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "@harborclient/sdk/jsx-runtime";
+/**
+ * Renders a small colored circle beside a sidebar row when a color is assigned
+ * and visibility is enabled.
+ */
+export function SidebarColorDot({ color, visible = true, label }) {
+    if (!visible || color == null || color.trim() === '') {
+        return null;
+    }
+    return (_jsx("span", { className: "inline-block h-4 w-4 shrink-0 rounded-full", style: { backgroundColor: color }, "aria-hidden": label == null ? true : undefined, "aria-label": label }));
+}

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

@@ -0,0 +1,31 @@
+import type { IconDefinition } from '@fortawesome/fontawesome-svg-core';
+import type { JSX, MouseEvent } from 'react';
+interface Props {
+    /**
+     * Commit message shown as the primary line.
+     */
+    message: string;
+    /**
+     * Author name shown in the metadata line.
+     */
+    author: string;
+    /**
+     * Formatted timestamp string shown in the metadata line.
+     */
+    timestampLabel: string;
+    /**
+     * Branch icon shown before the commit text.
+     */
+    icon: IconDefinition;
+    /**
+     * Called when the commit row button is clicked.
+     */
+    onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+}
+/**
+ * Renders a recent commit row in the Git sidebar Commits section.
+ * Uses a distinct two-line layout rather than the standard sourceRow shell.
+ */
+export declare function SidebarCommitItem({ message, author, timestampLabel, icon, onClick }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=SidebarCommitItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarCommitItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SidebarCommitItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAG7C,UAAU,KAAK;IACb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CAC1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,MAAM,EACN,cAAc,EACd,IAAI,EACJ,OAAO,EACR,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAgBrB"}

package/dist/components/SidebarItem/SidebarCommitItem.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
+import { FaIcon } from '../FaIcon/index.js';
+/**
+ * Renders a recent commit row in the Git sidebar Commits section.
+ * Uses a distinct two-line layout rather than the standard sourceRow shell.
+ */
+export function SidebarCommitItem({ message, author, timestampLabel, icon, onClick }) {
+    return (_jsxs("button", { type: "button", className: "hc-sidebar-commit-item group app-no-drag flex w-full cursor-pointer rounded-md p-2 text-left hover:bg-selection/60", onClick: onClick, children: [_jsx(FaIcon, { icon: icon, className: "mr-2 h-4 w-4 shrink-0 text-muted", "aria-hidden": true }), _jsxs("div", { className: "-mt-1.5 flex flex-col gap-0.5", children: [_jsx("span", { className: "block min-w-0 truncate font-medium text-text", children: message }), _jsxs("span", { className: "block min-w-0 truncate text-[14px] text-muted", children: [author, " \u00B7 ", timestampLabel] })] })] }));
+}

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

@@ -0,0 +1,70 @@
+import type { JSX, MouseEvent, ReactNode } from 'react';
+import { type SidebarItemSortableConfig } from './SidebarItem.js';
+interface Props {
+    /**
+     * Environment display name.
+     */
+    name: string;
+    /**
+     * Summary text for environment variables (e.g. "3 variables").
+     */
+    variableSummary: string;
+    /**
+     * Optional color dot beside the environment name.
+     */
+    colorDot?: {
+        color: string | null | undefined;
+        visible?: boolean;
+        label?: string;
+    };
+    /**
+     * Whether this row should use selected/highlighted row styling.
+     */
+    selected?: boolean;
+    /**
+     * When true, sets aria-current="true" on the primary button.
+     */
+    ariaCurrent?: boolean;
+    /**
+     * When true, sets aria-selected="true" on the primary button.
+     */
+    ariaSelected?: boolean;
+    /**
+     * dnd-kit sortable configuration for environment reordering.
+     */
+    sortable?: SidebarItemSortableConfig;
+    /**
+     * Called when the user right-clicks the row container.
+     */
+    onContextMenu?: (event: MouseEvent<HTMLElement>) => void;
+    /**
+     * Called when the primary label button is clicked.
+     */
+    onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * Called when the primary label button is double-clicked.
+     */
+    onDoubleClick?: () => void;
+    /**
+     * Called when Enter is pressed on the primary label button.
+     */
+    onEnter?: () => void;
+    /**
+     * Accessible label for the primary button.
+     */
+    ariaLabel?: string;
+    /**
+     * Trailing actions slot, typically a row actions menu.
+     */
+    actions?: ReactNode;
+    /**
+     * Optional data attribute value for keyboard navigation focus targets.
+     */
+    dataSidebarEnvironmentId?: string | number;
+}
+/**
+ * Renders an environment row in the Collections sidebar Environments section.
+ */
+export declare function SidebarEnvironmentItem({ name, variableSummary, colorDot, selected, ariaCurrent, ariaSelected, sortable, onContextMenu, onClick, onDoubleClick, onEnter, ariaLabel, actions, dataSidebarEnvironmentId }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=SidebarEnvironmentItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarEnvironmentItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SidebarEnvironmentItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAiB,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvE,OAAO,EAAe,KAAK,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,UAAU,KAAK;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACjC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;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,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAEzD;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,IAAI,EACJ,eAAe,EACf,QAAQ,EACR,QAAgB,EAChB,WAAmB,EACnB,YAAoB,EACpB,QAAQ,EACR,aAAa,EACb,OAAO,EACP,aAAa,EACb,OAAO,EACP,SAAS,EACT,OAAO,EACP,wBAAwB,EACzB,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CA4CrB"}

package/dist/components/SidebarItem/SidebarEnvironmentItem.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
+import { SidebarColorDot } from './SidebarColorDot.js';
+import { SidebarItem } from './SidebarItem.js';
+import { SIDEBAR_ITEM_BUTTON_CLASS } from './sidebarItemClasses.js';
+/**
+ * Renders an environment row in the Collections sidebar Environments section.
+ */
+export function SidebarEnvironmentItem({ name, variableSummary, colorDot, selected = false, ariaCurrent = false, ariaSelected = false, sortable, onContextMenu, onClick, onDoubleClick, onEnter, ariaLabel, actions, dataSidebarEnvironmentId }) {
+    /**
+     * Opens environment settings when Enter is pressed on the name button.
+     */
+    const handleKeyDown = (event) => {
+        if (event.key !== 'Enter')
+            return;
+        event.preventDefault();
+        onEnter?.();
+    };
+    return (_jsx(SidebarItem, { selected: selected, sortable: sortable, onContextMenu: onContextMenu, actions: actions, children: _jsxs("button", { type: "button", className: SIDEBAR_ITEM_BUTTON_CLASS, ...(dataSidebarEnvironmentId != null
+                ? { 'data-sidebar-environment-id': String(dataSidebarEnvironmentId) }
+                : {}), "aria-current": ariaCurrent ? 'true' : undefined, "aria-selected": ariaSelected ? 'true' : undefined, "aria-label": ariaLabel, onClick: onClick, onDoubleClick: onDoubleClick, onKeyDown: handleKeyDown, children: [_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: variableSummary })] }) }));
+}

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

@@ -0,0 +1,69 @@
+import type { IconDefinition } from '@fortawesome/fontawesome-svg-core';
+import type { JSX, MouseEvent, ReactNode } from 'react';
+import { type SidebarItemSortableConfig } from './SidebarItem.js';
+interface Props {
+    /**
+     * Folder display name.
+     */
+    name: string;
+    /**
+     * Whether the folder tree node is expanded.
+     */
+    expanded: boolean;
+    /**
+     * Optional color dot beside the folder name.
+     */
+    colorDot?: {
+        color: string | null | undefined;
+        visible?: boolean;
+        label?: string;
+    };
+    /**
+     * When true, shows a "Drop here" affordance beside the folder name.
+     */
+    dropHighlighted?: boolean;
+    /**
+     * Whether this row should use selected/highlighted row styling.
+     */
+    selected?: boolean;
+    /**
+     * dnd-kit sortable configuration for folder reordering.
+     */
+    sortable: SidebarItemSortableConfig;
+    /**
+     * Called when the user right-clicks the row container.
+     */
+    onContextMenu?: (event: MouseEvent<HTMLElement>) => void;
+    /**
+     * Toggles folder expand/collapse state.
+     */
+    onToggleExpand: () => void;
+    /**
+     * Called when the folder name button is clicked.
+     */
+    onNameClick: () => void;
+    /**
+     * Called when the folder name button is double-clicked.
+     */
+    onNameDoubleClick?: () => void;
+    /**
+     * Called when Enter is pressed on the folder name button.
+     */
+    onNameEnter?: () => void;
+    /**
+     * Trailing actions slot, typically a row actions menu.
+     */
+    actions?: ReactNode;
+    /**
+     * Icons for expand/collapse chevrons.
+     */
+    expandIcon: IconDefinition;
+    collapseIcon: IconDefinition;
+}
+/**
+ * Renders a collection folder row with expand/collapse control, optional color dot,
+ * and optional drag-drop highlight affordance.
+ */
+export declare function SidebarFolderItem({ name, expanded, colorDot, dropHighlighted, selected, sortable, onContextMenu, onToggleExpand, onNameClick, onNameDoubleClick, onNameEnter, actions, expandIcon, collapseIcon }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=SidebarFolderItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarFolderItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SidebarFolderItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAiB,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvE,OAAO,EAAe,KAAK,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,UAAU,KAAK;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACjC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,yBAAyB,CAAC;IAEpC;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAEzD;;OAEG;IACH,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B;;OAEG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;IAExB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAE/B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B,YAAY,EAAE,cAAc,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,eAAuB,EACvB,QAAgB,EAChB,QAAQ,EACR,aAAa,EACb,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,OAAO,EACP,UAAU,EACV,YAAY,EACb,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAiDrB"}

package/dist/components/SidebarItem/SidebarFolderItem.js

@@ -0,0 +1,21 @@
+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 { stopSortableDragPointerDown } from './stopSortableDragPointerDown.js';
+/**
+ * Renders a collection folder row with expand/collapse control, optional color dot,
+ * and optional drag-drop highlight affordance.
+ */
+export function SidebarFolderItem({ name, expanded, colorDot, dropHighlighted = false, selected = false, sortable, onContextMenu, onToggleExpand, onNameClick, onNameDoubleClick, onNameEnter, actions, expandIcon, collapseIcon }) {
+    /**
+     * Opens folder settings when Enter is pressed on the name button.
+     */
+    const handleNameKeyDown = (event) => {
+        if (event.key !== 'Enter')
+            return;
+        event.preventDefault();
+        onNameEnter?.();
+    };
+    return (_jsxs(SidebarItem, { selected: selected, sortable: sortable, onContextMenu: onContextMenu, actions: actions, children: [_jsx("button", { type: "button", className: "app-no-drag inline-flex h-4 w-4 shrink-0 cursor-pointer items-center justify-center rounded border-none bg-transparent p-0 text-muted hover:text-text", onClick: onToggleExpand, onPointerDown: stopSortableDragPointerDown, "aria-expanded": expanded, "aria-label": expanded ? 'Collapse folder' : 'Expand folder', children: _jsx(FaIcon, { icon: expanded ? collapseIcon : expandIcon, className: "h-2 w-2" }) }), _jsxs("button", { type: "button", className: "app-no-drag ml-0.5 min-w-0 flex-1 cursor-pointer truncate border-none bg-transparent py-0 text-left leading-none font-medium text-inherit", "aria-current": selected ? 'true' : undefined, onClick: onNameClick, onDoubleClick: onNameDoubleClick, onKeyDown: handleNameKeyDown, children: [_jsxs("span", { className: "inline-flex min-w-0 items-center gap-1.5", children: [name, colorDot != null ? (_jsx(SidebarColorDot, { color: colorDot.color, visible: colorDot.visible, label: colorDot.label })) : null] }), dropHighlighted ? _jsx("span", { className: "ml-1.5 font-normal text-info", children: "Drop here" }) : null] })] }));
+}

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

@@ -0,0 +1,58 @@
+import type { IconDefinition } from '@fortawesome/fontawesome-svg-core';
+import type { JSX, MouseEvent, ReactNode } from 'react';
+interface Props {
+    /**
+     * HTTP method shown in the leading badge.
+     */
+    method: string;
+    /**
+     * Primary label text for the history entry.
+     */
+    name: string;
+    /**
+     * When true, shows a run icon instead of HTTP status metadata.
+     */
+    isRun?: boolean;
+    /**
+     * HTTP status code for request history entries.
+     */
+    status?: number;
+    /**
+     * HTTP status text for request history entries.
+     */
+    statusText?: string;
+    /**
+     * Icon shown for run history entries.
+     */
+    runIcon?: IconDefinition;
+    /**
+     * Whether this row is part of a multi-selection.
+     */
+    selected?: boolean;
+    /**
+     * Tooltip title for the primary button.
+     */
+    title?: string;
+    /**
+     * Accessible label for the primary button.
+     */
+    ariaLabel: string;
+    /**
+     * Called when the user right-clicks the row container.
+     */
+    onContextMenu?: (event: MouseEvent<HTMLElement>) => void;
+    /**
+     * Called when the primary row button is clicked.
+     */
+    onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * Trailing actions slot, typically a row actions menu.
+     */
+    actions?: ReactNode;
+}
+/**
+ * Renders a request or run history entry row in the Collections sidebar History section.
+ */
+export declare function SidebarHistoryItem({ method, name, isRun, status, statusText, runIcon, selected, title, ariaLabel, onContextMenu, onClick, actions }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=SidebarHistoryItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarHistoryItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SidebarHistoryItem.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;AAOxD,UAAU,KAAK;IACb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;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,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAEzD;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,IAAI,EACJ,KAAa,EACb,MAAM,EACN,UAAU,EACV,OAAO,EACP,QAAgB,EAChB,KAAK,EACL,SAAS,EACT,aAAa,EACb,OAAO,EACP,OAAO,EACR,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CA8BrB"}

package/dist/components/SidebarItem/SidebarHistoryItem.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
+import { Button } from '../Button/index.js';
+import { FaIcon } from '../FaIcon/index.js';
+import { SidebarItem } from './SidebarItem.js';
+import { SidebarMethodBadge } from './SidebarMethodBadge.js';
+import { statusDotClass } from './sidebarItemClasses.js';
+/**
+ * Renders a request or run history entry row in the Collections sidebar History section.
+ */
+export function SidebarHistoryItem({ method, name, isRun = false, status, statusText, runIcon, selected = false, title, ariaLabel, onContextMenu, onClick, actions }) {
+    return (_jsx(SidebarItem, { selected: selected, onContextMenu: onContextMenu, actions: actions, children: _jsxs(Button, { variant: "toolbar", className: "flex min-w-0 flex-1 items-center gap-2 py-0.5 text-left text-text hover:bg-transparent", title: title, "aria-label": ariaLabel, "aria-selected": selected ? 'true' : undefined, onClick: onClick, children: [_jsx(SidebarMethodBadge, { method: method, uppercase: true }), _jsxs("span", { className: "flex min-w-0 flex-1 items-center gap-1.5", children: [_jsx("span", { className: "min-w-0 truncate text-text", children: name }), isRun && runIcon != null ? (_jsx(FaIcon, { icon: runIcon, className: "h-3.5 w-3.5 shrink-0 text-muted", "aria-hidden": true })) : null] }), !isRun && status != null && statusText != null ? (_jsxs("span", { className: "flex shrink-0 items-center gap-1.5 text-muted tabular-nums", children: [_jsx("span", { className: `inline-block h-2 w-2 shrink-0 rounded-full ${statusDotClass(status)}`, "aria-hidden": "true" }), status, " ", statusText] })) : null] }) }));
+}

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

@@ -0,0 +1,63 @@
+import type { JSX, MouseEvent, ReactNode } from 'react';
+/**
+ * Sortable drag configuration for a sidebar row.
+ */
+export interface SidebarItemSortableConfig {
+    /**
+     * Stable dnd-kit sortable id for this row.
+     */
+    id: string;
+    /**
+     * Accessible name for the drag handle.
+     */
+    dragHandleLabel: string;
+    /**
+     * When true, renders a static row without drag-and-drop behavior.
+     */
+    disabled?: boolean;
+}
+interface Props {
+    /**
+     * Whether this row should use selected/highlighted row styling.
+     */
+    selected?: boolean;
+    /**
+     * When true, uses tighter vertical padding for top-level list rows.
+     */
+    compact?: boolean;
+    /**
+     * Optional dnd-kit sortable configuration.
+     */
+    sortable?: SidebarItemSortableConfig;
+    /**
+     * Called when the user right-clicks the row container.
+     */
+    onContextMenu?: (event: MouseEvent<HTMLElement>) => void;
+    /**
+     * Trailing actions slot, typically a {@link RowActionsMenu}.
+     */
+    actions?: ReactNode;
+    /**
+     * When true, wraps the actions slot with {@link stopSortableDragPointerDown}.
+     */
+    actionsStopDrag?: boolean;
+    /**
+     * HTML element for the row container when not sortable.
+     */
+    as?: 'div' | 'li';
+    /**
+     * Additional class names merged onto the row container.
+     */
+    className?: string;
+    /**
+     * Row contents (label button, icons, metadata, etc.).
+     */
+    children: ReactNode;
+}
+/**
+ * Base shell for sidebar list rows. Applies shared row chrome, optional sortable
+ * drag behavior, and a trailing actions slot suitable for future Sidebar layout reuse.
+ */
+export declare function SidebarItem({ selected, compact, sortable, onContextMenu, actions, actionsStopDrag, as: Container, className, children }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=SidebarItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarItem.d.ts","sourceRoot":"","sources":["../../../src/components/SidebarItem/SidebarItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMxD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,KAAK;IACb;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;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,SAAS,CAAC;IAEpB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAgB,EAChB,OAAc,EACd,QAAQ,EACR,aAAa,EACb,OAAO,EACP,eAAsB,EACtB,EAAE,EAAE,SAAiB,EACrB,SAAS,EACT,QAAQ,EACT,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAoCrB"}