@pstdio/ui 0.15.0 → 0.17.0

package/dist/components/{breadcrumb.d.ts → primitives/breadcrumb.d.ts}

@@ -1,5 +1,5 @@
 import { Breadcrumb as ChakraBreadcrumb, SystemStyleObject } from '@chakra-ui/react';
-import { ResourceContextAction } from './resource-context-menu';
+import { ResourceContextAction } from '../overlays/resource-context-menu';
 import * as React from "react";
 export interface BreadcrumbItem {
     title: React.ReactNode;

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

@@ -0,0 +1,28 @@
+export type { AlertProps } from './alert';
+export { AlertMessage } from './alert';
+export type { BreadcrumbItem } from './breadcrumb';
+export { Breadcrumb } from './breadcrumb';
+export type { CheckboxProps } from './checkbox';
+export { Checkbox } from './checkbox';
+export { ContentPlaceholder, Label as ContentPlaceholderLabel } from './content-placeholder';
+export type { EmptyStateProps } from './empty-state';
+export { EmptyState } from './empty-state';
+export { ErrorBoundary } from './error-boundary';
+export type { IconColorPickerIconOption, IconColorPickerProps } from './icon-color-picker';
+export { getIconComponent, IconColorPicker, optionColors, optionIcons } from './icon-color-picker';
+export type { IntegrationCardProps } from './integration-card';
+export { IntegrationCard } from './integration-card';
+export type { RadioProps } from './radio';
+export { Radio, RadioGroup } from './radio';
+export { ResourceBadge } from './resource-badge';
+export { ScrollArea } from './scroll-area';
+export type { SessionCompletionStatus } from './session-indicator';
+export { resolveSessionIndicatorColor, resolveSessionIndicatorIcon, SessionIndicator } from './session-indicator';
+export type { SimpleCardBodyProps, SimpleCardProps } from './simple-card';
+export { SimpleCard, SimpleCardBody } from './simple-card';
+export type { SwitchProps } from './switch';
+export { Switch } from './switch';
+export { Toaster, toaster } from './toaster';
+export { Tooltip } from './tooltip';
+export type { WorkspaceBadgeProps } from './workspace-badge';
+export { WorkspaceBadge } from './workspace-badge';

package/dist/components/{number-input.d.ts → primitives/number-input.d.ts}

@@ -4,5 +4,3 @@ export interface NumberInputProps extends ChakraNumberInput.RootProps {
 }
 export declare const NumberInputRoot: React.ForwardRefExoticComponent<NumberInputProps & React.RefAttributes<HTMLDivElement>>;
 export declare const NumberInputField: React.ForwardRefExoticComponent<ChakraNumberInput.InputProps & React.RefAttributes<HTMLInputElement>>;
-export declare const NumberInputScrubber: React.ForwardRefExoticComponent<ChakraNumberInput.ScrubberProps & React.RefAttributes<HTMLDivElement>>;
-export declare const NumberInputLabel: React.ForwardRefExoticComponent<ChakraNumberInput.LabelProps & React.RefAttributes<HTMLLabelElement>>;

package/dist/components/{session-indicator.d.ts → primitives/session-indicator.d.ts}

@@ -1,6 +1,7 @@
 import { Icon } from '@chakra-ui/react';
 import { ComponentProps } from 'react';
-export type SessionCompletionStatus = "in_progress" | "awaiting_input" | "queued" | "completed" | "failed" | "cancelled" | "disconnected";
+export declare const sessionCompletionStatuses: readonly ["in_progress", "awaiting_input", "queued", "completed", "failed", "cancelled", "disconnected"];
+export type SessionCompletionStatus = (typeof sessionCompletionStatuses)[number];
 export declare const resolveSessionIndicatorIcon: (status: SessionCompletionStatus | undefined) => import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
 export declare const resolveSessionIndicatorColor: (status: SessionCompletionStatus | undefined) => "fg.muted" | "fg.error" | "fg.warning" | "fg.success" | "fg.info";
 interface SessionIndicatorProps {

package/dist/components/{tooltip.d.ts → primitives/tooltip.d.ts}

@@ -2,7 +2,6 @@ import { Tooltip as ChakraTooltip } from '@chakra-ui/react';
 import * as React from "react";
 export interface TooltipProps extends ChakraTooltip.RootProps {
     children?: React.ReactElement;
-    showArrow?: boolean;
     portalled?: boolean;
     portalRef?: React.RefObject<HTMLElement>;
     content: React.ReactNode;

package/dist/components/rich-text/prompt-input/commands.d.ts

@@ -1,19 +1,2 @@
-export declare const UPLOAD_FILE_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const OPEN_CONTEXT_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const RUN_PROMPT_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const UPDATE_FORMAT_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const UPDATE_BEHAVIOR_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const INSERT_PROMPT_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const RENAME_PROMPT_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const DUPLICATE_PROMPT_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const DELETE_PROMPT_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const DELETE_REFERENCES_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const RENAME_REFERENCES_COMMAND: import('lexical').LexicalCommand<unknown>;
 export declare const INSERT_REFERENCE_COMMAND: import('lexical').LexicalCommand<unknown>;
 export declare const INSERT_BLOCK_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const INSERT_NEW_FILE_PLACEHOLDER = "INSERT_NEW_FILE_PLACEHOLDER";
-export declare const INSERT_NEW_TEXT_PLACEHOLDER = "INSERT_NEW_TEXT_PLACEHOLDER";
-export declare const INSERT_PLACEHOLDER_REFERENCE = "INSERT_PLACEHOLDER_REFERENCE";
-export declare const INSERT_NEW_FILE_PLACEHOLDER_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const INSERT_NEW_TEXT_PLACEHOLDER_COMMAND: import('lexical').LexicalCommand<unknown>;
-export declare const INSERT_PLACEHOLDER_REFERENCE_COMMAND: import('lexical').LexicalCommand<unknown>;

package/dist/components/rich-text/prompt-input/events.d.ts

@@ -1,15 +1,2 @@
-export declare const FOCUS_EDITOR = "FOCUS_EDITOR";
-export declare const UPLOAD_FILE = "UPLOAD_FILE";
-export declare const OPEN_CONTEXT = "OPEN_CONTEXT";
-export declare const DROP_EVENT = "DROP_EVENT";
-export declare const RUN_PROMPT = "RUN_PROMPT";
-export declare const UPDATE_FORMAT = "UPDATE_FORMAT";
-export declare const UPDATE_BEHAVIOR = "UPDATE_BEHAVIOR";
-export declare const INSERT_PROMPT = "INSERT_PROMPT";
-export declare const RENAME_PROMPT = "RENAME_PROMPT";
-export declare const DUPLICATE_PROMPT = "DUPLICATE_PROMPT";
-export declare const DELETE_PROMPT = "DELETE_PROMPT";
-export declare const DELETE_REFERENCES = "DELETE_REFERENCES";
-export declare const RENAME_REFERENCES = "RENAME_REFERENCES";
 export declare const INSERT_REFERENCE = "INSERT_REFERENCE";
 export declare const INSERT_BLOCK = "INSERT_BLOCK";

package/dist/components/rich-text/prompt-input/plugins/CommentPlugin/nodes/CommentNode/CommentNode.d.ts

@@ -1,4 +1,4 @@
-import { DOMConversionMap, DOMExportOutput, EditorConfig, ElementNode, LexicalEditor, LexicalNode, ParagraphNode, RangeSelection, SerializedElementNode } from 'lexical';
+import { DOMConversionMap, DOMExportOutput, EditorConfig, ElementNode, LexicalEditor, ParagraphNode, RangeSelection, SerializedElementNode } from 'lexical';
 export type SerializedCommentNode = SerializedElementNode;
 export declare class CommentNode extends ElementNode {
     static getType(): string;
@@ -14,4 +14,3 @@ export declare class CommentNode extends ElementNode {
     collapseAtStart(): true;
 }
 export declare function $createCommentNode(): CommentNode;
-export declare function $isCommentNode(node: LexicalNode | null | undefined): node is CommentNode;

package/dist/components/rich-text/prompt-input/plugins/ReferenceMenuPlugin/ReferenceMenuPlugin.d.ts

@@ -1,7 +1,8 @@
+import { ReferenceResourceType } from '../../prompt-input';
 type Props = {
     items?: Array<{
         resourceId: string;
-        resourceType: "table" | "connector";
+        resourceType: ReferenceResourceType;
         name: string;
         description?: string;
     }>;

package/dist/components/rich-text/prompt-input/plugins/ReferenceMenuPlugin/hooks/useContextLookup.d.ts

@@ -1,3 +1,4 @@
+import { ReferenceResourceType } from '../../../prompt-input';
 import { ReferenceMenuOption } from '../ReferenceMenuOption';
 /**
  * Search across all resources and menu options
@@ -7,7 +8,7 @@ import { ReferenceMenuOption } from '../ReferenceMenuOption';
  */
 export declare function useContextLookup(queryString: string | null, items?: {
     resourceId: string;
-    resourceType: "table" | "connector";
+    resourceType: ReferenceResourceType;
     name: string;
     description?: string;
 }[]): ReferenceMenuOption[];

package/dist/components/rich-text/prompt-input/plugins/ReferencePlugin/ReferencePlugin.d.ts

@@ -1,6 +1,7 @@
 import { LexicalNode } from 'lexical';
 import { PropsWithChildren } from 'react';
+import { ReferenceResourceType } from '../../prompt-input';
 export declare const $insertExistingReference: (nodeToReplace: LexicalNode, resourceId: string, name: string) => void;
 export declare function ReferencePlugin(props: PropsWithChildren<{
-    onAddReference?: (resourceId: string, resourceType: "table" | "connector") => void;
+    onAddReference?: (resourceId: string, resourceType: ReferenceResourceType) => void;
 }>): null;

package/dist/components/rich-text/prompt-input/plugins/ReferencePlugin/nodes/ReferenceNode/ReferenceNode.d.ts

@@ -1,4 +1,4 @@
-import { DOMConversionMap, DOMExportOutput, EditorConfig, LexicalEditor, LexicalNode, NodeKey, SerializedTextNode, Spread, TextNode } from 'lexical';
+import { DOMConversionMap, DOMExportOutput, EditorConfig, LexicalEditor, NodeKey, SerializedTextNode, Spread, TextNode } from 'lexical';
 type SerializedReferenceNode = Spread<{
     referenceId: string;
     name: string;
@@ -22,5 +22,4 @@ export declare class ReferenceNode extends TextNode {
     getTextContent(): string;
 }
 export declare function $createReferenceNode(referenceId: string, name: string): ReferenceNode;
-export declare function $isReferenceNode(node: LexicalNode | null | undefined): node is ReferenceNode;
 export {};

package/dist/components/rich-text/prompt-input/prompt-input.d.ts

@@ -1,8 +1,9 @@
 import { ReactElement, ForwardRefRenderFunction } from 'react';
 import { PromptEditorRef } from './plugins/ImperativeAPIPlugin';
+export type ReferenceResourceType = "table" | "connector" | "file";
 export type ReferenceItem = {
     resourceId: string;
-    resourceType: "table" | "connector";
+    resourceType: ReferenceResourceType;
     name: string;
     description?: string;
 };
@@ -17,7 +18,7 @@ export interface PromptEditorProps {
     /** Dynamic list of references (tables, connectors) shown when typing # */
     references?: ReferenceItem[];
     /** Optional app callback when a reference is inserted */
-    onAddReference?: (resourceId: string, resourceType: "table" | "connector") => void;
+    onAddReference?: (resourceId: string, resourceType: ReferenceResourceType) => void;
 }
 export declare const BasePromptEditor: ForwardRefRenderFunction<PromptEditorRef, PromptEditorProps>;
 export declare const PromptEditor: import('react').ForwardRefExoticComponent<PromptEditorProps & import('react').RefAttributes<PromptEditorRef>>;

package/dist/components/rich-text/prompt-input/utils.d.ts

@@ -1,5 +1,4 @@
-import { Klass, LexicalNode, RootNode } from 'lexical';
-export declare function $getAllNodesOfType<T extends LexicalNode>(nodeType: Klass<T>): T[];
+import { RootNode } from 'lexical';
 export declare const $getTextContent: (root: RootNode) => string;
 export declare const getTextFromSerializedEditorState: (state: string) => string;
 export declare const emptyEditorState: {

package/dist/components/rich-text/shared/plugins/MermaidPlugin/MermaidNode.d.ts

@@ -19,5 +19,4 @@ export declare class MermaidNode extends DecoratorNode<ReactNode> {
     setCode(code: string): void;
     decorate(): import("react/jsx-runtime").JSX.Element;
 }
-export declare function $createMermaidNode(code?: string): MermaidNode;
 export declare function $isMermaidNode(node: LexicalNode | null | undefined): node is MermaidNode;

package/dist/components/rich-text/types.d.ts

@@ -1,4 +1,4 @@
-export type ResourceType = "table" | "connector" | "text" | "image" | "pdf" | "markdown" | "csv" | "json" | "code";
+export type ResourceType = "table" | "connector" | "file" | "text" | "image" | "pdf" | "markdown" | "csv" | "json" | "code";
 export interface Resource {
     resourceId: string;
     resourceType: ResourceType;

package/dist/components/rich-text/utils/inferResourceType.d.ts

@@ -1 +1 @@
-export declare function inferResourceTypeFromMediaType(mediaType: string): "text" | "table" | "image" | "json" | "markdown" | "pdf";
+export declare function inferResourceTypeFromMediaType(mediaType: string): "text" | "table" | "image" | "json" | "pdf" | "markdown";

package/dist/components/{sidebar/sidebar-footer.d.ts → sidenav/sidenav-footer.d.ts}

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
-interface SidebarFooterProps {
+interface SidenavFooterProps {
     children?: ReactNode;
 }
-export declare const SidebarFooter: (props: SidebarFooterProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const SidenavFooter: (props: SidenavFooterProps) => import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/components/{sidebar/sidebar-header.d.ts → sidenav/sidenav-header.d.ts}

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
-interface SidebarHeaderProps {
+interface SidenavHeaderProps {
     children?: ReactNode;
 }
-export declare const SidebarHeader: (props: SidebarHeaderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SidenavHeader: (props: SidenavHeaderProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/sidenav/sidenav.d.ts

@@ -0,0 +1,2 @@
+import { SidenavProps } from './sidenav.types';
+export declare const Sidenav: (props: SidenavProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/components/sidenav/sidenav.store.d.ts

@@ -0,0 +1,49 @@
+interface SidenavSnapshot {
+    open: boolean;
+    expandedSections: string[];
+    expandedNodes: string[];
+    width: number | null;
+}
+interface SidenavState extends SidenavSnapshot {
+    openSidenav: () => void;
+    closeSidenav: () => void;
+    toggleSidenav: () => void;
+    toggleSection: (sectionId: string) => void;
+    toggleNode: (nodeId: string) => void;
+    setSectionExpanded: (sectionId: string, expanded: boolean) => void;
+    setNodeExpanded: (nodeId: string, expanded: boolean) => void;
+    setWidth: (width: number) => void;
+    reset: () => void;
+}
+interface CreateSidenavStoreOptions {
+    storageKey: string;
+    initialState?: Partial<SidenavSnapshot>;
+}
+export declare const createSidenavStore: (options: CreateSidenavStoreOptions) => Omit<import('zustand').StoreApi<SidenavState>, "setState" | "persist"> & {
+    setState(partial: SidenavState | Partial<SidenavState> | ((state: SidenavState) => SidenavState | Partial<SidenavState>), replace?: false | undefined): unknown;
+    setState(state: SidenavState | ((state: SidenavState) => SidenavState), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<import('zustand/middleware').PersistOptions<SidenavState, unknown, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: SidenavState) => void) => () => void;
+        onFinishHydration: (fn: (state: SidenavState) => void) => () => void;
+        getOptions: () => Partial<import('zustand/middleware').PersistOptions<SidenavState, unknown, unknown>>;
+    };
+};
+export declare const getSidenavStore: (storageKey: string, initialState?: Partial<SidenavSnapshot>) => Omit<import('zustand').StoreApi<SidenavState>, "setState" | "persist"> & {
+    setState(partial: SidenavState | Partial<SidenavState> | ((state: SidenavState) => SidenavState | Partial<SidenavState>), replace?: false | undefined): unknown;
+    setState(state: SidenavState | ((state: SidenavState) => SidenavState), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<import('zustand/middleware').PersistOptions<SidenavState, unknown, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: SidenavState) => void) => () => void;
+        onFinishHydration: (fn: (state: SidenavState) => void) => () => void;
+        getOptions: () => Partial<import('zustand/middleware').PersistOptions<SidenavState, unknown, unknown>>;
+    };
+};
+export declare const useSidenavStore: <T>(storageKey: string, selector: (state: SidenavState) => T, initialState?: Partial<SidenavSnapshot>) => T;
+export {};

package/dist/components/{sidebar/sidebar.types.d.ts → sidenav/sidenav.types.d.ts}

@@ -1,14 +1,14 @@
 import { ReactNode } from 'react';
-import { ResourceContextAction } from '../resource-context-menu';
+import { ResourceContextAction } from '../overlays/resource-context-menu';
 import { TreeListLinkComponent, TreeListNavigateEvent, TreeListSection } from '../tree-list/tree-list.types';
-export interface SidebarProps {
+export interface SidenavProps {
     storageKey: string;
     sections: TreeListSection[];
     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[];
+    /** Right-click menu available from every point in the Sidenav. */
+    contextActions?: ResourceContextAction[];
     /** Initial width when resizable. Set explicitly to override the persisted width. */
     width?: string | number;
     emptyLabel?: string;
@@ -17,14 +17,14 @@ export interface SidebarProps {
     onNavigate?: (event: TreeListNavigateEvent) => void;
     closable?: boolean;
     onOpenChange?: (open: boolean) => void;
-    /** Allow split layouts to resize the sidebar. Defaults to `true`. */
+    /** Allow split layouts to resize the sidenav. Defaults to `true`. */
     resizable?: boolean;
     defaultWidth?: number;
     minWidth?: number;
     maxWidth?: number;
     /**
      * When enabled, the scroll content is virtualized — only nodes near the viewport
-     * are mounted. Use for sidebars that may contain hundreds of entries. Requires
+     * are mounted. Use for sidenavs that may contain hundreds of entries. Requires
      * sections with flat nodes (no expandable children).
      */
     virtualize?: boolean;

package/dist/components/tab-strip/tab-visibility-filter.d.ts

@@ -1,9 +1,10 @@
 import { ReactNode } from 'react';
-import { ResourceContextAction } from '../resource-context-menu';
+import { ResourceContextAction } from '../overlays/resource-context-menu';
 import { VisibilityOverride } from '../tree-list/tree-list-visibility.store';
 export interface TabVisibilityPlacement {
     closable?: boolean;
     hiddenByDefault?: boolean;
+    pinned?: boolean;
     title?: string;
     contributionId: string;
 }

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

@@ -1,4 +1,4 @@
-import { IconColorPickerIconOption } from '../icon-color-picker';
+import { IconColorPickerIconOption } from '../primitives/icon-color-picker';
 import { TagEditorAction, TagEditorValue } from './tag-editor.types';
 interface TagEditorRowProps {
     actionOptions?: TagEditorAction[];

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

@@ -1,4 +1,4 @@
-import { IconColorPickerIconOption } from '../icon-color-picker';
+import { IconColorPickerIconOption } from '../primitives/icon-color-picker';
 export interface TagEditorValue {
     id: string;
     name: string;

package/dist/components/terminal/bind-session.d.ts

@@ -0,0 +1,33 @@
+import { TerminalSessionAdapter } from './types';
+/**
+ * Minimal subset of xterm.js that the binding needs. Tests substitute a fake
+ * sink so the wire-up logic can be exercised without a DOM.
+ */
+export interface TerminalSink {
+    write(data: string | Uint8Array): void;
+    onInput(handler: (data: string) => void): () => void;
+    onResize(handler: (size: {
+        cols: number;
+        rows: number;
+    }) => void): () => void;
+}
+export interface BindSessionOptions {
+    /** Forwarded to the session when the user types in the sink. */
+    onInput?: (data: string) => void;
+    /** Called once the session exits; useful for surfacing status. */
+    onExit?: (exit: {
+        code: number | null;
+        signal: string | null;
+    }) => void;
+    /** Called on transport errors. */
+    onError?: (error: {
+        message: string;
+    }) => void;
+}
+/**
+ * Wires a {@link TerminalSink} (typically xterm.js) to a
+ * {@link TerminalSessionAdapter}. Returns a disposer that detaches every
+ * subscription it created. The session itself is *not* killed — owning the
+ * session lifecycle is the caller's responsibility.
+ */
+export declare const bindSessionToSink: (sink: TerminalSink, session: TerminalSessionAdapter, options?: BindSessionOptions) => () => void;

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

@@ -0,0 +1,6 @@
+export { type BindSessionOptions, bindSessionToSink, type TerminalSink } from './bind-session';
+export { createScriptedTerminalBridge, type ScriptedBridgeOptions, type ScriptedTerminalStep, } from './scripted-bridge';
+export { Terminal, type TerminalProps } from './terminal';
+export { darkTerminalTheme, lightTerminalTheme, resolveTerminalTheme, type TerminalThemeName, terminalThemes, } from './terminal-theme';
+export type { TerminalBridge, TerminalSessionAdapter, TerminalSessionError, TerminalSessionExit, TerminalSessionRequest, } from './types';
+export { type TerminalSessionStatus, type UseTerminalSessionOptions, type UseTerminalSessionResult, useTerminalSession, } from './use-terminal-session';

package/dist/components/terminal/scripted-bridge.d.ts

@@ -0,0 +1,35 @@
+import { TerminalBridge } from './types';
+export interface ScriptedTerminalStep {
+    /** Bytes the host pushes back to the renderer (utf-8 string is encoded for you). */
+    data?: string | Uint8Array;
+    /** Milliseconds to wait before delivering this step. */
+    delayMs?: number;
+    /** Marks the session as exited after this step. */
+    exit?: {
+        code: number | null;
+        signal?: string | null;
+    };
+    /** Delivers a transport error after this step. */
+    error?: string;
+}
+export interface ScriptedBridgeOptions {
+    /** Initial script delivered after the first data subscriber attaches. */
+    initial?: ScriptedTerminalStep[];
+    /**
+     * Responds to user input. Return additional steps to play, or `undefined`
+     * to ignore. Defaults to echoing the input followed by a newline.
+     */
+    onInput?: (input: string) => ScriptedTerminalStep[] | undefined;
+    /** Called whenever the renderer requests a resize. */
+    onResize?: (size: {
+        cols: number;
+        rows: number;
+    }) => void;
+    /** Called once when the renderer kills the session. */
+    onKill?: (signal?: string) => void;
+}
+/**
+ * Deterministic in-memory bridge. Used by stories and tests to exercise the
+ * terminal UI without a real PTY supervisor.
+ */
+export declare const createScriptedTerminalBridge: (options?: ScriptedBridgeOptions) => TerminalBridge;

package/dist/components/terminal/terminal-contract.d.ts

@@ -0,0 +1,22 @@
+export interface TerminalSessionRequest {
+    /** Command + args to run; defaults to the user's login shell when omitted. */
+    command?: string[];
+    /** Working directory; falls back to the extension's workspace root. */
+    cwd?: string;
+    /** Extra env vars merged over the inherited environment. */
+    env?: Record<string, string>;
+    /** Initial column count; the renderer can resize later. */
+    cols: number;
+    /** Initial row count; the renderer can resize later. */
+    rows: number;
+}
+export type TerminalHostEvent = {
+    sessionId: string;
+    kind: "data";
+    chunk: Uint8Array;
+} | {
+    sessionId: string;
+    kind: "exit";
+    code: number | null;
+    signal: string | null;
+};

package/dist/components/terminal/terminal-theme.d.ts

@@ -0,0 +1,12 @@
+import { ITheme } from '@xterm/xterm';
+/**
+ * xterm theme presets aligned with the workbench `bg.inverted` / `fg.inverted`
+ * pairings so the terminal blends with the surrounding chrome without the
+ * consuming extension touching xterm directly. Consumers can still pass any
+ * `ITheme` they like via the `theme` prop.
+ */
+export type TerminalThemeName = "light" | "dark";
+export declare const lightTerminalTheme: ITheme;
+export declare const darkTerminalTheme: ITheme;
+export declare const terminalThemes: Record<TerminalThemeName, ITheme>;
+export declare const resolveTerminalTheme: (theme: TerminalThemeName | ITheme | undefined) => ITheme;

package/dist/components/terminal/terminal.d.ts

@@ -0,0 +1,56 @@
+import { ITheme, Terminal as Xterm } from '@xterm/xterm';
+import { TerminalSink } from './bind-session';
+import { TerminalThemeName } from './terminal-theme';
+import { TerminalBridge, TerminalSessionAdapter, TerminalSessionRequest } from './types';
+export declare const createInitialTerminalSessionRequest: (request?: Partial<TerminalSessionRequest>) => TerminalSessionRequest;
+export declare const createTerminalSink: (xterm: Pick<Xterm, "write" | "onData" | "onResize">) => {
+    write(data: string | Uint8Array): void;
+    onInput(handler: (data: string) => void): () => boolean;
+    onResize(handler: (size: {
+        cols: number;
+        rows: number;
+    }) => void): () => void;
+    dispose(): void;
+};
+export declare const resizeSessionToTerminalGeometry: (terminal: Pick<Xterm, "cols" | "rows">, session: Pick<TerminalSessionAdapter, "resize">) => void;
+export declare const bindTerminalSession: (terminal: Pick<Xterm, "cols" | "rows">, sink: TerminalSink, session: TerminalSessionAdapter, options: Pick<TerminalProps, "onSessionOpen" | "onSessionExit">) => () => void;
+export interface TerminalSessionCallbackRefs {
+    onSessionOpen: React.RefObject<TerminalProps["onSessionOpen"]>;
+    onSessionExit: React.RefObject<TerminalProps["onSessionExit"]>;
+}
+export declare const bindTerminalSessionWithCallbackRefs: (terminal: Pick<Xterm, "cols" | "rows">, sink: TerminalSink, session: TerminalSessionAdapter, callbackRefs: TerminalSessionCallbackRefs) => () => void;
+export interface TerminalProps {
+    /** Bridge adapter the component opens its session through. */
+    bridge: TerminalBridge;
+    /**
+     * Optional initial session request overrides. `cols`/`rows` default to
+     * 80x24; container resizes are forwarded after the session opens.
+     */
+    request?: Partial<TerminalSessionRequest>;
+    /** Theme preset name or full xterm theme. */
+    theme?: TerminalThemeName | ITheme;
+    /** Monospace font family. */
+    fontFamily?: string;
+    fontSize?: number;
+    /** Whether to kill the session when the component unmounts. Defaults to true. */
+    killOnUnmount?: boolean;
+    /** Focus the terminal while it is the active surface. Defaults to true. */
+    autoFocus?: boolean;
+    /** Forwarded to the container element. */
+    className?: string;
+    style?: React.CSSProperties;
+    /** Called once the session is open; useful for imperative refs. */
+    onSessionOpen?: (sessionId: string) => void;
+    /** Called once the session exits. */
+    onSessionExit?: (exit: {
+        code: number | null;
+        signal: string | null;
+    }) => void;
+}
+/**
+ * High-level terminal component. Mounts xterm.js inside a `<div>` and binds it
+ * to the session opened from `bridge.openSession(...)`. Resize is driven by
+ * `ResizeObserver` so the terminal fills its container and the host PTY
+ * geometry stays in sync.
+ */
+export declare const Terminal: (props: TerminalProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,35 @@
+import { TerminalHostEvent, TerminalSessionRequest } from './terminal-contract';
+export type { TerminalSessionRequest } from './terminal-contract';
+/**
+ * Renderer-side projection of a single terminal session over the
+ * `terminal.session` bridge.
+ *
+ * The host-side `TerminalSessionHandle` exposes a single-consumer async
+ * iterable; that contract is impractical inside React, so the renderer side
+ * uses observable subscriptions instead. Implementations (real bridge,
+ * scripted stub, etc.) are responsible for translating their own transport
+ * into these callbacks.
+ */
+export interface TerminalSessionAdapter {
+    readonly id: string;
+    write(data: string | Uint8Array): void;
+    resize(cols: number, rows: number): void;
+    kill(signal?: string): Promise<void> | void;
+    onData(handler: (chunk: Uint8Array) => void): () => void;
+    onExit(handler: (exit: TerminalSessionExit) => void): () => void;
+    onError(handler: (error: TerminalSessionError) => void): () => void;
+}
+export type TerminalSessionExit = Omit<Extract<TerminalHostEvent, {
+    kind: "exit";
+}>, "kind" | "sessionId">;
+export interface TerminalSessionError {
+    message: string;
+}
+/**
+ * Renderer-side projection of the `terminal.session` capability. A bridge
+ * adapter typically wraps the webview transport, but stubs that drive
+ * scripted output (storybook, tests) implement the same shape.
+ */
+export interface TerminalBridge {
+    openSession(request: TerminalSessionRequest): Promise<TerminalSessionAdapter>;
+}

package/dist/components/terminal/use-terminal-session.d.ts

@@ -0,0 +1,21 @@
+import { TerminalBridge, TerminalSessionAdapter, TerminalSessionError, TerminalSessionExit, TerminalSessionRequest } from './types';
+export type TerminalSessionStatus = "idle" | "opening" | "open" | "exited" | "error";
+export interface UseTerminalSessionResult {
+    session: TerminalSessionAdapter | null;
+    status: TerminalSessionStatus;
+    exit: TerminalSessionExit | null;
+    error: TerminalSessionError | null;
+}
+export interface UseTerminalSessionOptions {
+    bridge: TerminalBridge | null;
+    request: TerminalSessionRequest;
+    /** Set to false to keep the session alive when the hook unmounts. */
+    killOnUnmount?: boolean;
+}
+export declare const createTerminalSessionRequestKey: (request: TerminalSessionRequest) => string;
+/**
+ * Opens a terminal session via the provided bridge and surfaces its lifecycle
+ * for the renderer. The session is killed on unmount unless explicitly opted
+ * out; switching bridges or request contents triggers a fresh open.
+ */
+export declare const useTerminalSession: ({ bridge, request, killOnUnmount }: UseTerminalSessionOptions) => UseTerminalSessionResult;

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

@@ -1,3 +1,2 @@
-import { TreeListNode, TreeListSection } from './tree-list.types';
+import { TreeListSection } from './tree-list.types';
 export declare const applyTreeListOrder: (sections: TreeListSection[], sectionOrder: string[], nodeOrderBySection: Record<string, string[]>) => TreeListSection[];
-export declare const reorderNodesById: (nodes: TreeListNode[], order: string[]) => TreeListNode[];

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

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { ResourceContextAction } from '../resource-context-menu';
+import { ResourceContextAction } from '../overlays/resource-context-menu';
 import { TreeListNode, TreeListSection } from './tree-list.types';
 import { VisibilityOverride } from './tree-list-visibility.store';
 export declare const resolveVisibility: (override: VisibilityOverride | undefined, hiddenByDefault: boolean | undefined) => VisibilityOverride;
@@ -9,7 +9,6 @@ export interface TreeVisibilityMenuActions {
     onToggleSection: (id: string, hiddenByDefault: boolean) => void;
     onToggleNode: (id: string, hiddenByDefault: boolean) => void;
     onResetAll: () => void;
-    onResetOrder?: () => void;
 }
 interface BuildMenuOptions {
     visibleIcon: ReactNode;

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

@@ -1,10 +1,10 @@
 import { StackProps } from '@chakra-ui/react';
 import { MouseEvent as ReactMouseEvent, RefObject } from 'react';
-import { ResourceContextAction } from '../resource-context-menu';
+import { ResourceContextAction } from '../overlays/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. */
+/** Sectioned hierarchical list for files, resources, navigation, and customizable sidenavs. */
 interface TreeListProps {
     /** Ordered sections to render, each containing nested tree nodes. */
     sections: TreeListSection[];