@pstdio/ui 0.10.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

@@ -6,6 +6,7 @@ interface DataRendererContentProps {
     viewMode: DataRendererSettings["viewMode"];
     boardColumns: DataRendererBoardColumn[];
     listItems: DataRendererListItem[];
+    listExpandedGroups: Record<string, boolean>;
     selectedRowId: string | null;
     emptyState?: ReactNode;
     emptyTitle: string;
@@ -14,6 +15,7 @@ interface DataRendererContentProps {
     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;

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,12 +18,14 @@ 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;
 }
-type DataRendererListExpandedState = true | Record<string, boolean>;
 interface FlattenedDataRendererListItem {
     id: string;
     item: DataRendererListItem;

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

@@ -2,16 +2,22 @@ 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;
@@ -22,7 +28,9 @@ 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;

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/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/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,10 +69,14 @@ 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;

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/tag-settings-panel.d.ts

@@ -1,4 +1,3 @@
-import { QueryKey } from '@tanstack/react-query';
 import { TagEditorProps, TagEditorValue } from './tag-editor.types';
 export interface SaveTagSettingsInput<TValue> {
     deletedIds: Set<string>;
@@ -10,15 +9,20 @@ type SortableValue = {
     id: string;
     sortOrder: number;
 };
-export interface TagSettingsPanelProps<TValue extends SortableValue, TSource> extends EditorLabels {
+export interface TagSettingsPanelProps<TValue extends SortableValue> extends EditorLabels {
     errorTitle: string;
     loadingText?: string;
-    queryKey: QueryKey;
-    readValues: (source: TSource) => Promise<TValue[]>;
-    saveValues: (source: TSource, input: SaveTagSettingsInput<TValue>) => Promise<void>;
-    source: TSource;
+    /** 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, TSource>(props: TagSettingsPanelProps<TValue, TSource>) => import("react/jsx-runtime").JSX.Element;
+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

@@ -46,7 +46,6 @@ 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';