@pstdio/ui 0.9.0 → 0.11.0

package/dist/components/chat-ui/components/chat-panel.d.ts

@@ -1,7 +1,9 @@
 import { ReactNode } from 'react';
 import { ChatInputQuestionPrompt, ChatInputQuestionResponse } from './chat-input-question-prompt';
 import { SessionMessage } from './message-types';
+/** Full conversation shell for agent sessions, including messages, input, attachments, and host-provided slots. */
 interface ChatPanelProps {
+    /** Stable conversation identity used to reset ready state when switching sessions. */
     conversationKey?: string;
     messages: SessionMessage[];
     loading?: boolean;
@@ -15,12 +17,14 @@ interface ChatPanelProps {
     onSubmitMessage?: (text: string, attachments: string[], questionResponse?: ChatInputQuestionResponse) => void;
     onInterrupt?: () => void;
     onChatInputChange?: (text: string) => void;
+    /** Extra controls rendered near the chat input. */
     actions?: ReactNode;
     repoMenu?: ReactNode;
     attachedResources?: string[];
     onClearAttachments?: () => void;
     attachmentList?: ReactNode;
     approvalPrompt?: ReactNode;
+    /** Optional workspace status/control surface rendered above the conversation viewport. */
     workspaceHub?: ReactNode;
     workspaceInitializing?: boolean;
     inputDisabled?: boolean;

package/dist/components/data-renderer/data-renderer-content.d.ts

@@ -0,0 +1,22 @@
+import { ReactNode } from 'react';
+import { DataRendererBoardColumn } from './data-renderer-board';
+import { DataRendererListItem } from './data-renderer-list';
+import { DataRendererSettings } from './types';
+interface DataRendererContentProps {
+    viewMode: DataRendererSettings["viewMode"];
+    boardColumns: DataRendererBoardColumn[];
+    listItems: DataRendererListItem[];
+    listExpandedGroups: Record<string, boolean>;
+    selectedRowId: string | null;
+    emptyState?: ReactNode;
+    emptyTitle: string;
+    emptyDescription?: string;
+    onBoardMoveItem: (rowId: string, targetColumnId: string) => void;
+    onBoardMoveToGroup: (rowId: string, targetGroupKey: string) => void;
+    onCreateRow?: (columnId: string) => void;
+    onColumnAction?: (columnId: string, actionId: string) => Promise<void> | void;
+    onListExpandedGroupChange: (rowId: string, isExpanded: boolean) => void;
+    listKey: string;
+}
+export declare const DataRendererContent: (props: DataRendererContentProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/data-renderer/data-renderer-helpers.d.ts

@@ -20,7 +20,9 @@ export interface AttributeBadge {
     attributeId: string;
     label: string;
     color?: string;
+    icon?: string | null;
 }
+export declare const getAttributeBadgeColorPalette: (_badge: AttributeBadge) => string;
 /**
  * Per-type default cell summary used by the card / list end-content. Returns
  * null when the attribute has no displayable value.

package/dist/components/data-renderer/data-renderer-list.d.ts

@@ -18,11 +18,21 @@ export interface DataRendererListItem {
     draggable?: boolean;
     onDropRow?: (rowId: string) => void;
 }
-interface DataRendererListProps {
+export type DataRendererListExpandedState = Record<string, boolean>;
+export interface DataRendererListProps {
     items: DataRendererListItem[];
     selectedItemId?: string | null;
+    expandedGroups?: DataRendererListExpandedState;
     onItemClick?: (item: DataRendererListItem) => void;
+    onExpandedGroupChange?: (rowId: string, isExpanded: boolean) => void;
+}
+interface FlattenedDataRendererListItem {
+    id: string;
+    item: DataRendererListItem;
+    depth: number;
+    canExpand: boolean;
 }
 export declare const getDataRendererListIndentation: (depth: number) => string | undefined;
+export declare const flattenDataRendererListItems: (items: DataRendererListItem[], expanded: DataRendererListExpandedState, depth?: number) => FlattenedDataRendererListItem[];
 export declare const DataRendererList: (props: DataRendererListProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/data-renderer/data-renderer-story-fixtures.d.ts

@@ -0,0 +1,13 @@
+import { AttributeDescriptor, DataRendererRow } from './types';
+export declare const attributes: AttributeDescriptor[];
+export interface StoryRow extends DataRendererRow {
+    attributes: {
+        status: string;
+        assignee: string;
+        component: string;
+        priority?: string;
+        updated: string;
+        labels?: string[];
+    };
+}
+export declare const initialRows: StoryRow[];

package/dist/components/data-renderer/data-renderer.d.ts

@@ -1,18 +1,26 @@
 import { ReactNode } from 'react';
+import { ResourceContextAction } from '../resource-context-menu';
 import { DataRendererBoardColumnAction } from './data-renderer-board';
 import { AttributeDescriptor, DataRendererFilterState, DataRendererRow, DataRendererSettings } from './types';
+/** Board-column behavior and menu configuration for a resolved column group. */
 export interface BoardColumnConfig {
+    /** Chakra color palette used for the column header and group badges. */
     color?: string;
     canDragIn?: boolean;
     canDragOut?: boolean;
     canCreate?: boolean;
     actions?: DataRendererBoardColumnAction[];
 }
+/** Switchable list/board renderer for rows with typed attributes, filtering, grouping, and ordering. */
 export interface DataRendererProps<TRow extends DataRendererRow = DataRendererRow> {
+    /** Stable rows to render. Each row must have an id, title, and attributes map. */
     rows: TRow[];
+    /** Persistent key used by the renderer store for view, filter, grouping, ordering, and list expansion settings. */
     storageKey: string;
+    /** Attribute descriptors that define display, filtering, grouping, ordering, and board columns. */
     attributes: AttributeDescriptor[];
     selectedRowId?: string | null;
+    emptyState?: ReactNode;
     emptyTitle?: string;
     emptyDescription?: string;
     defaultSettings?: Partial<DataRendererSettings>;
@@ -20,10 +28,13 @@ export interface DataRendererProps<TRow extends DataRendererRow = DataRendererRo
     hideToolbar?: boolean;
     toolbarLeading?: ReactNode;
     onRowClick?: (row: TRow) => void;
+    /** Called when a row attribute changes through drag/drop, board movement, or inline controls. */
     onAttributeChange?: (rowId: string, attributeId: string, value: unknown) => void;
+    /** Called for manual row ordering when a dragged row is dropped before another row. */
     onReorder?: (rowId: string, beforeRowId?: string) => void;
     onCreateRow?: (columnId: string) => void;
     onColumnAction?: (columnId: string, actionId: string) => Promise<void> | void;
     getBoardColumnConfig?: (groupKey: string) => BoardColumnConfig;
+    getRowContextMenuActions?: (row: TRow) => ResourceContextAction[];
 }
 export declare const DataRenderer: <TRow extends DataRendererRow>(props: DataRendererProps<TRow>) => import("react/jsx-runtime").JSX.Element;

package/dist/components/data-renderer/use-data-renderer-store.d.ts

@@ -2,10 +2,12 @@ import { DataRendererFilterState, DataRendererSettings } from './types';
 interface DataRendererSnapshot {
     settings: DataRendererSettings;
     filters: DataRendererFilterState;
+    expandedGroups: Record<string, boolean>;
 }
 interface DataRendererStoreInitialState {
     settings?: Partial<DataRendererSettings>;
     filters?: DataRendererFilterState;
+    expandedGroups?: Record<string, boolean>;
 }
 interface DataRendererState extends DataRendererSnapshot {
     setViewMode: (viewMode: DataRendererSettings["viewMode"]) => void;
@@ -20,6 +22,7 @@ interface DataRendererState extends DataRendererSnapshot {
     toggleFilterValue: (attributeId: string, value: string) => void;
     clearFilter: (attributeId: string) => void;
     clearAllFilters: () => void;
+    setExpandedGroup: (groupId: string, isExpanded: boolean) => void;
     reset: () => void;
 }
 interface CreateDataRendererStoreOptions {

package/dist/components/diff-viewer/diff-drawer-empty-state.d.ts

@@ -0,0 +1 @@
+export declare const DiffDrawerEmptyState: () => import("react/jsx-runtime").JSX.Element;

package/dist/components/diff-viewer/diff-drawer-height.d.ts

@@ -0,0 +1,10 @@
+import { Diff } from './diff-card';
+import { DiffViewMode } from './types';
+interface EstimateDiffCardHeightInput {
+    diff: Diff;
+    isCollapsed: boolean;
+    hasOptedIntoLargeDiff?: boolean;
+    diffViewMode?: DiffViewMode;
+}
+export declare const estimateDiffCardHeight: (input: EstimateDiffCardHeightInput) => number;
+export {};

package/dist/components/diff-viewer/diff-drawer-scroll.d.ts

@@ -0,0 +1,47 @@
+import { Diff } from './diff-card';
+import { DiffViewMode } from './types';
+interface EstimateDiffRangeHeightInput {
+    diffs: Diff[];
+    collapsedPaths: Set<string>;
+    largeDiffOptInPaths: Set<string>;
+    diffViewMode: DiffViewMode;
+    startIndex: number;
+    endIndex: number;
+}
+interface SelectedExpansionCommand {
+    action: string;
+    id: number;
+    path?: string;
+    direction?: "up" | "down";
+}
+interface ResolveSelectedScrollStateInput {
+    diffs: Diff[];
+    selectedDiffPath: string | null;
+    collapsedPaths: Set<string>;
+    expansionCommand: SelectedExpansionCommand | null;
+    completedScrollCommandId: number | null;
+}
+export interface RenderedDiffItem {
+    element: HTMLElement;
+    index: number;
+}
+export declare const estimateDiffRangeHeight: (input: EstimateDiffRangeHeightInput) => number;
+export declare const resolveSelectedScrollState: (input: ResolveSelectedScrollStateInput) => {
+    selectedScrollPath: string | null;
+    selectedScrollKey: string | null;
+    selectedScrollCommandId: number | null;
+    selectedScrollIndex: number;
+    shouldPinSelectedScrollIndex: boolean;
+    hasCompletedSelectedScroll: boolean;
+};
+export declare const includePinnedDiffIndexes: (input: {
+    indexes: number[];
+    selectedScrollIndex: number;
+    shouldPinSelectedScrollIndex: boolean;
+}) => number[];
+export declare const getRenderedDiffItems: (scrollElement: HTMLElement | null) => RenderedDiffItem[];
+export declare const getElementScrollOffset: (input: {
+    element: HTMLElement;
+    scrollElement: HTMLElement | null;
+}) => number;
+export {};

package/dist/components/diff-viewer/diff-drawer.d.ts

@@ -13,19 +13,14 @@ export interface DiffExpansionCommand {
     action: "expand" | "collapse" | "expand-selected";
     id: number;
     path?: string;
+    direction?: "up" | "down";
 }
 export interface DiffDrawerExpansionState {
     allExpanded: boolean;
     allCollapsed: boolean;
 }
+export { estimateDiffCardHeight } from './diff-drawer-height';
 export type { Diff };
-interface EstimateDiffCardHeightInput {
-    diff: Diff;
-    isCollapsed: boolean;
-    hasOptedIntoLargeDiff?: boolean;
-    diffViewMode?: DiffViewMode;
-}
-export declare const estimateDiffCardHeight: (input: EstimateDiffCardHeightInput) => number;
 export declare const buildInitialCollapsedPaths: (diffs: Diff[]) => Set<string>;
 export declare const buildAllCollapsedPaths: (diffs: Diff[]) => Set<string>;
 export declare const toggleCollapsedPath: (collapsedPaths: Set<string>, path: string) => Set<string>;

package/dist/components/diff-viewer/use-selected-diff-scroll.d.ts

@@ -0,0 +1,19 @@
+import { Diff } from './diff-card';
+import { DiffExpansionCommand } from './diff-drawer';
+import { DiffViewMode } from './types';
+interface UseSelectedDiffScrollInput {
+    diffs: Diff[];
+    selectedDiffPath: string | null;
+    collapsedPaths: Set<string>;
+    largeDiffOptInPaths: Set<string>;
+    expansionCommand: DiffExpansionCommand | null;
+    diffViewMode: DiffViewMode;
+    scrollRef: {
+        current: HTMLDivElement | null;
+    };
+}
+export declare const useSelectedDiffScroll: (input: UseSelectedDiffScrollInput) => {
+    selectedScrollIndex: number;
+    shouldPinSelectedScrollIndex: boolean;
+};
+export {};

package/dist/components/empty-state.d.ts

@@ -1,8 +1,12 @@
 import { EmptyState as ChakraEmptyState } from '@chakra-ui/react';
 import * as React from "react";
+/** Centered empty-state message with optional icon, description, and follow-up actions. */
 export interface EmptyStateProps extends ChakraEmptyState.RootProps {
+    /** Primary empty-state message. */
     title: string;
+    /** Supporting explanation shown below the title. */
     description?: string;
+    /** Decorative or semantic icon shown above the message. */
     icon?: React.ReactNode;
 }
 export declare const EmptyState: React.ForwardRefExoticComponent<EmptyStateProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/icon-color-picker.d.ts

@@ -1,9 +1,25 @@
 import { ComponentType } from 'react';
+export interface IconColorPickerIconOption {
+    value: string | null;
+    label: string;
+    icon: ComponentType;
+}
 export declare const optionColors: readonly ["gray", "red", "orange", "yellow", "green", "teal", "blue", "cyan", "purple", "pink"];
-export declare const getIconComponent: (name: string | null | undefined) => ComponentType;
+export declare const optionIcons: ({
+    value: null;
+    label: string;
+    icon: import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
+} | {
+    value: string;
+    label: string;
+    icon: import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
+})[];
+export declare const getIconComponent: (name: string | null | undefined, iconOptions?: readonly IconColorPickerIconOption[]) => ComponentType;
 export interface IconColorPickerProps {
     color: string;
+    colorOptions?: readonly string[];
     icon?: string | null;
+    iconOptions?: readonly IconColorPickerIconOption[];
     onColorChange: (color: string) => void;
     onIconChange?: (icon: string | null) => void;
     disabled?: boolean;

package/dist/components/list-row/list-row.types.d.ts

@@ -4,10 +4,12 @@ export interface ListRowNavigationIntent {
     id?: string;
     payload?: unknown;
 }
+/** Context passed to row-level actions so hosts know which section or node triggered the action. */
 export interface ListRowActionContext {
     sectionId?: string;
     nodeId?: string;
 }
+/** Menu item used by row overflow menus and context menus. */
 export interface ListRowActionMenuItem {
     id: string;
     label: string;
@@ -21,6 +23,7 @@ export interface ListRowActionMenuItem {
     endContent?: ReactNode;
     onAction?: () => void;
 }
+/** Inline action rendered on a row, optionally backed by a menu. */
 export interface ListRowAction {
     id: string;
     label: string;
@@ -35,6 +38,7 @@ export interface ListRowAction {
 export type ListRowVariant = "default" | "compact" | "tree";
 export type ListRowTone = "default" | "danger";
 export type ListRowMenuPlacement = "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "right" | "right-start" | "right-end" | "left" | "left-start" | "left-end";
+/** Data model for one reusable row, including labels, icons, menus, actions, and children. */
 export interface ListRowItem {
     id?: string;
     label: ReactNode;
@@ -65,13 +69,19 @@ export interface ListRowItem {
     children?: ListRowItem[];
 }
 type ListRowRootProps = ComponentPropsWithoutRef<typeof chakra.div>;
+/** Props for the row surface used by lists, trees, menus, and dense navigation UIs. */
 export interface ListRowProps extends ListRowItem, Omit<ListRowRootProps, "as" | "asChild" | "children" | "draggable" | "onClick" | "onDragEnd" | "onDragOver" | "onDragStart" | "onDrop" | "onPointerMove" | keyof ListRowItem> {
     depth?: number;
+    /** Applies selected styling without owning selection state. */
     isSelected?: boolean;
+    /** Controls child expansion styling and chevron state. */
     isExpanded?: boolean;
+    /** Forces the expand affordance when children are lazy-loaded or externally controlled. */
     showExpandToggle?: boolean;
     variant?: ListRowVariant;
     tone?: ListRowTone;
+    selectedBg?: ListRowRootProps["bg"];
+    hoverBg?: ListRowRootProps["bg"];
     /** Wrap content into a single child element. Used for `<Menu.Item asChild><ListRow asChild>…</ListRow></Menu.Item>` and link components. */
     asChild?: boolean;
     onToggleExpand?: () => void;

package/dist/components/palette.d.ts

@@ -41,6 +41,7 @@ export interface PaletteProps<T extends PaletteEntry = PaletteEntry> {
     footerEnd?: ReactNode;
     filterEntries?: (entries: T[], query: string, mode?: string) => T[];
     onActiveEntryChange?: (entry: T | null, index: number) => void;
+    onQueryChange?: (query: string) => void;
     onClose: () => void;
     onEscape?: (ctx: PaletteEscapeContext<T>) => boolean | undefined;
 }

package/dist/components/param-editor/index.d.ts

@@ -0,0 +1,2 @@
+export type { ParamEditorProps } from './param-editor';
+export { ParamEditor } from './param-editor';

package/dist/components/param-editor/param-editor-read-only-value.d.ts

@@ -0,0 +1,8 @@
+import { BoxProps } from '@chakra-ui/react';
+import { ReactNode } from 'react';
+interface ParamEditorReadOnlyValueProps extends Omit<BoxProps, "children"> {
+    children: ReactNode;
+    preserveWhitespace?: boolean;
+}
+export declare const ParamEditorReadOnlyValue: (props: ParamEditorReadOnlyValueProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/resource-context-menu.d.ts

@@ -15,6 +15,8 @@ interface ResourceContextMenuProps {
     contentMinWidth?: string;
     contentBackground?: string;
     positioning?: MenuRootProps["positioning"];
+    /** Keep the menu open after selecting an item — useful for menus that toggle several entries in one pass. */
+    closeOnSelect?: MenuRootProps["closeOnSelect"];
 }
 export declare const ResourceContextMenu: (props: ResourceContextMenuProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/sidebar/sidebar.types.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { ResourceContextAction } from '../resource-context-menu';
 import { TreeListLinkComponent, TreeListNavigateEvent, TreeListSection } from '../tree-list/tree-list.types';
 export interface SidebarProps {
     storageKey: string;
@@ -6,6 +7,8 @@ export interface SidebarProps {
     activeNodeId?: string | string[] | null;
     header?: ReactNode;
     footer?: ReactNode;
+    /** Right-click menu for the empty back area of the tree. Passed straight through to the internal TreeList. */
+    backgroundContextActions?: ResourceContextAction[];
     /** Initial width when resizable. Set explicitly to override the persisted width. */
     width?: string | number;
     emptyLabel?: string;

package/dist/components/tag-editor/index.d.ts

@@ -0,0 +1,4 @@
+export { TagEditor } from './tag-editor';
+export type { TagEditorAction, TagEditorProps, TagEditorValue } from './tag-editor.types';
+export type { SaveTagSettingsInput, TagSettingsPanelProps } from './tag-settings-panel';
+export { TagSettingsPanel } from './tag-settings-panel';

package/dist/components/tag-editor/tag-editor-row.d.ts

@@ -0,0 +1,19 @@
+import { IconColorPickerIconOption } from '../icon-color-picker';
+import { TagEditorAction, TagEditorValue } from './tag-editor.types';
+interface TagEditorRowProps {
+    actionOptions?: TagEditorAction[];
+    colorOptions?: readonly string[];
+    iconOptions?: readonly IconColorPickerIconOption[];
+    value: TagEditorValue;
+    isSaving?: boolean;
+    showDefault?: boolean;
+    showIcons?: boolean;
+    onActionsChange: (actions: string[]) => void;
+    onColorChange: (color: string) => void;
+    onDelete: () => void;
+    onIconChange: (icon: string | null) => void;
+    onNameChange: (name: string) => void;
+    onSetDefault: () => void;
+}
+export declare const TagEditorRow: (props: TagEditorRowProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/tag-editor/tag-editor.d.ts

@@ -0,0 +1,2 @@
+import { TagEditorProps } from './tag-editor.types';
+export declare const TagEditor: (props: TagEditorProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/{status-option-editor/status-option-editor.types.d.ts → tag-editor/tag-editor.types.d.ts}

@@ -1,4 +1,5 @@
-export interface StatusOptionEditorItem {
+import { IconColorPickerIconOption } from '../icon-color-picker';
+export interface TagEditorValue {
     id: string;
     name: string;
     color: string;
@@ -8,32 +9,36 @@ export interface StatusOptionEditorItem {
     isDefault?: boolean;
     isNew?: boolean;
 }
-export interface StatusOptionEditorAction {
+export interface TagEditorAction {
     value: string;
     label: string;
 }
-export interface StatusOptionEditorProps {
+export interface TagEditorProps {
     title: string;
     description?: string;
-    items: StatusOptionEditorItem[];
-    onItemsChange: (items: StatusOptionEditorItem[]) => void;
+    values: TagEditorValue[];
+    onValuesChange: (values: TagEditorValue[]) => void;
     onSave: () => void | Promise<void>;
     onCancel: () => void;
-    onDeleteItem?: (item: StatusOptionEditorItem) => void;
-    onSetDefault?: (item: StatusOptionEditorItem) => void;
+    onDeleteValue?: (value: TagEditorValue) => void;
+    onSetDefault?: (value: TagEditorValue) => void;
     hasChanges?: boolean;
     isSaving?: boolean;
     addLabel?: string;
     addPlaceholder?: string;
-    actionOptions?: StatusOptionEditorAction[];
+    actionOptions?: TagEditorAction[];
     actionsColumnLabel?: string;
     cancelLabel?: string;
     defaultAddColor?: string;
+    defaultAddIcon?: string | null;
     defaultColumnLabel?: string;
     deleteButtonText?: string;
     deleteHeadline?: string;
-    deleteNotificationText?: (item: StatusOptionEditorItem) => string;
+    deleteNotificationText?: (value: TagEditorValue) => string;
+    colorOptions?: readonly string[];
+    iconOptions?: readonly IconColorPickerIconOption[];
     saveLabel?: string;
     showDefault?: boolean;
     showIcons?: boolean;
+    valueColumnLabel?: string;
 }

package/dist/components/tag-editor/tag-settings-panel.d.ts

@@ -0,0 +1,28 @@
+import { TagEditorProps, TagEditorValue } from './tag-editor.types';
+export interface SaveTagSettingsInput<TValue> {
+    deletedIds: Set<string>;
+    drafts: TagEditorValue[];
+    values: TValue[];
+}
+type EditorLabels = Pick<TagEditorProps, "actionOptions" | "actionsColumnLabel" | "addLabel" | "addPlaceholder" | "colorOptions" | "deleteButtonText" | "deleteHeadline" | "deleteNotificationText" | "description" | "iconOptions" | "showIcons" | "title" | "valueColumnLabel">;
+type SortableValue = {
+    id: string;
+    sortOrder: number;
+};
+export interface TagSettingsPanelProps<TValue extends SortableValue> extends EditorLabels {
+    errorTitle: string;
+    loadingText?: string;
+    /** Loaded values; pass undefined while the initial load is pending. */
+    values: TValue[] | undefined;
+    /** Load/save error surfaced by the host's data layer. */
+    loadError?: unknown;
+    /**
+     * Persists the pending edits. The host owns fetching and cache invalidation;
+     * the panel resets its delete tracking once the returned promise resolves.
+     */
+    onSave: (input: SaveTagSettingsInput<TValue>) => Promise<void>;
+    toEditorValue: (value: TValue) => TagEditorValue;
+    valueNeedsUpdate: (original: TValue, draft: TagEditorValue) => boolean;
+}
+export declare const TagSettingsPanel: <TValue extends SortableValue>(props: TagSettingsPanelProps<TValue>) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/tree-list/tree-list.d.ts

@@ -1,25 +1,36 @@
 import { StackProps } from '@chakra-ui/react';
 import { MouseEvent as ReactMouseEvent, RefObject } from 'react';
+import { ResourceContextAction } from '../resource-context-menu';
 import { TreeListLinkComponent, TreeListNavigateEvent, TreeListSection } from './tree-list.types';
 export { buildVirtualRows } from './tree-list-model';
 type TreeListRowVariant = "compact" | "tree";
+/** Sectioned hierarchical list for files, resources, navigation, and customizable sidebars. */
 interface TreeListProps {
+    /** Ordered sections to render, each containing nested tree nodes. */
     sections: TreeListSection[];
+    /** Controlled section ids that are currently expanded. */
     expandedSectionIds?: string[];
+    /** Controlled node ids that are currently expanded. */
     expandedNodeIds?: string[];
+    /** Active node id, or ids, used for selection styling. */
     activeNodeId?: string | string[] | null;
+    /** Compact rows suit app navigation; tree rows suit file/resource hierarchies. */
     rowVariant?: TreeListRowVariant;
     sectionGap?: StackProps["gap"];
     nodeGap?: StackProps["gap"];
+    /** Link renderer used when nodes provide `href`. */
     linkComponent?: TreeListLinkComponent;
+    /** Called when a navigable node is activated. */
     onNavigate?: (event: TreeListNavigateEvent) => void;
     onToggleSection?: (sectionId: string) => void;
     onToggleNode?: (nodeId: string) => void;
     onSectionContextMenu?: (event: ReactMouseEvent<HTMLElement>, sectionId: string) => void;
+    /** Render large trees with virtual rows. Disable when using drag ordering. */
     virtualize?: boolean;
     scrollRef?: RefObject<HTMLDivElement | null>;
     draggable?: boolean;
     onReorderSections?: (nextSectionIds: string[]) => void;
     onReorderNodes?: (sectionId: string, nextNodeIds: string[]) => void;
+    backgroundContextActions?: ResourceContextAction[];
 }
 export declare const TreeList: (props: TreeListProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/tree-list/tree-list.types.d.ts

@@ -4,11 +4,15 @@ export type TreeListNavigationIntent = ListRowNavigationIntent;
 export type TreeListActionContext = ListRowActionContext;
 export type TreeListActionMenuItem = ListRowActionMenuItem;
 export type TreeListAction = ListRowAction;
+/** Tree node data rendered by `TreeList`; extends the row API used by `ListRow`. */
 export type TreeListNode = ListRowItem & {
     id: string;
     children?: TreeListNode[];
     hiddenByDefault?: boolean;
+    /** When false, the node cannot be hidden from a tree-customization menu (rendered as a disabled, checked row). */
+    canHide?: boolean;
 };
+/** Top-level tree section with optional header, actions, empty state, and child nodes. */
 export interface TreeListSection {
     id: string;
     label?: string;
@@ -18,12 +22,14 @@ export interface TreeListSection {
     nodes: TreeListNode[];
     hiddenByDefault?: boolean;
 }
+/** Navigation payload emitted when a navigable tree node is activated. */
 export interface TreeListNavigateEvent {
     sectionId: string;
     nodeId: string;
     node: TreeListNode;
     intent?: TreeListNavigationIntent;
 }
+/** Props passed to the host-provided tree link component. */
 export interface TreeListLinkProps {
     to: string;
     children: ReactNode;

package/dist/index.d.ts

@@ -40,13 +40,12 @@ export { ErrorBoundary } from './components/error-boundary';
 export type { HeaderProps, HeaderVariant } from './components/header';
 export { Header } from './components/header';
 export { HorizontalMenuStack } from './components/horizontal-menu-stack';
-export type { IconColorPickerProps } from './components/icon-color-picker';
-export { getIconComponent, IconColorPicker, optionColors } from './components/icon-color-picker';
+export type { IconColorPickerIconOption, IconColorPickerProps } from './components/icon-color-picker';
+export { getIconComponent, IconColorPicker, optionColors, optionIcons } from './components/icon-color-picker';
 export type { IntegrationCardProps } from './components/integration-card';
 export { IntegrationCard } from './components/integration-card';
 export type { ItemSectionProps } from './components/item-section';
 export { ItemSection } from './components/item-section';
-export { PanelLayout, PanelSectionLayout } from './components/layout';
 export { ListRow } from './components/list-row/list-row';
 export type { ListRowAction, ListRowActionContext, ListRowActionMenuItem, ListRowItem, ListRowNavigationIntent, } from './components/list-row/list-row.types';
 export type { OpenSourceNotice, OpenSourceNoticesScreenProps, } from './components/open-source-notices-screen';
@@ -75,13 +74,13 @@ export type { SidebarProps } from './components/sidebar/sidebar.types';
 export { SidebarProjectMenu } from './components/sidebar/sidebar-project-menu';
 export type { SimpleCardBodyProps, SimpleCardProps } from './components/simple-card';
 export { SimpleCard, SimpleCardBody } from './components/simple-card';
-export type { StatusOptionEditorItem, StatusOptionEditorProps } from './components/status-option-editor';
-export { StatusOptionEditor } from './components/status-option-editor';
 export type { SwitchProps } from './components/switch';
 export { Switch } from './components/switch';
 export { getTabVisibilityStore, useTabVisibilityStore, } from './components/tab-strip/tab-visibility.store';
 export type { TabVisibilityPlacement } from './components/tab-strip/tab-visibility-filter';
 export { buildTabVisibilityMenuActions, filterVisibleTabs, } from './components/tab-strip/tab-visibility-filter';
+export type { SaveTagSettingsInput, TagEditorAction, TagEditorProps, TagEditorValue, TagSettingsPanelProps, } from './components/tag-editor';
+export { TagEditor, TagSettingsPanel } from './components/tag-editor';
 export { Toaster, toaster } from './components/toaster';
 export { Tooltip } from './components/tooltip';
 export { TreeList } from './components/tree-list/tree-list';