@pstdio/ui 0.16.0 → 0.18.0

package/dist/components/param-editor/inputs/selection-menu.d.ts

@@ -0,0 +1,33 @@
+import { ReactNode } from 'react';
+export interface SelectionMenuOption {
+    id: string;
+    name: string;
+    icon?: string;
+    /** Palette key (e.g. "blue") applied to the option's icon. */
+    color?: string;
+    description?: string;
+    disabled?: boolean;
+}
+export interface SelectionMenuProps {
+    triggerLabel: ReactNode;
+    options: SelectionMenuOption[];
+    selectedIds: string[];
+    multiSelect: boolean;
+    disabled?: boolean;
+    fullWidth?: boolean;
+    triggerVariant?: "button" | "icon";
+    triggerAriaLabel?: string;
+    size?: "xs" | "sm";
+    onToggle: (optionId: string) => void;
+}
+export declare const selectionIndicator: (multiSelect: boolean, selected: boolean) => import("react/jsx-runtime").JSX.Element | null;
+export declare const selectionOptionIcon: (option: SelectionMenuOption | undefined, boxSize: string) => import("react/jsx-runtime").JSX.Element | null;
+/**
+ * The single dropdown behind every option picker in the editor — selection
+ * params and editable resource params alike. Sharing it is what keeps a
+ * resource attribute and a command param from drifting into two looks.
+ *
+ * Single-selects clear by re-picking the selected option; a dedicated "none"
+ * row would read as just another value to choose.
+ */
+export declare const SelectionMenu: (props: SelectionMenuProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/param-editor/inputs/text-input.d.ts

@@ -8,6 +8,7 @@ interface TextInputProps {
     singleLine?: boolean;
     hideLabel?: boolean;
     fullWidth?: boolean;
+    size?: "xs" | "sm";
 }
 export declare const TextInput: (props: TextInputProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/param-editor/param-editor-advanced-field.d.ts

@@ -0,0 +1,14 @@
+import { Param, ParamValue, ParamValueMap } from './param-editor.types';
+type AdvancedParam = Extract<Param, {
+    type: "range" | "segmented" | "actions" | "anchorGrid" | "vector" | "fileUpload";
+}>;
+interface ParamEditorAdvancedFieldProps {
+    param: AdvancedParam;
+    defaultValues: ParamValueMap;
+    onChange: (id: string, value: ParamValue) => void;
+    readOnly?: boolean;
+    fullWidth?: boolean;
+    presentation: "stacked" | "horizontal";
+}
+export declare const ParamEditorAdvancedField: (props: ParamEditorAdvancedFieldProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/param-editor/param-editor-control-fixtures.d.ts

@@ -0,0 +1,24 @@
+import { Param, ParamValueMap } from './param-editor.types';
+export interface ParamEditorInputFixture {
+    param: Param;
+    defaultValues: ParamValueMap;
+}
+export declare const paramEditorInputFixtures: {
+    boolean: ParamEditorInputFixture;
+    number: ParamEditorInputFixture;
+    text: ParamEditorInputFixture;
+    markdown: ParamEditorInputFixture;
+    selection: ParamEditorInputFixture;
+    date: ParamEditorInputFixture;
+    color: ParamEditorInputFixture;
+    property: ParamEditorInputFixture;
+    readOnly: ParamEditorInputFixture;
+    resource: ParamEditorInputFixture;
+    reference: ParamEditorInputFixture;
+    range: ParamEditorInputFixture;
+    segmented: ParamEditorInputFixture;
+    actions: ParamEditorInputFixture;
+    anchorGrid: ParamEditorInputFixture;
+    vector: ParamEditorInputFixture;
+    fileUpload: ParamEditorInputFixture;
+};

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

@@ -6,6 +6,8 @@ interface ParamEditorFieldProps {
     onOpenResource?: (ref: ResourceRefValue) => void;
     readOnly?: boolean;
     fullWidth?: boolean;
+    presentation?: "stacked" | "horizontal";
+    size?: "xs" | "sm";
 }
 export declare const ParamEditorField: (props: ParamEditorFieldProps) => import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -1,10 +1,11 @@
-import { InputGroup, Param, ParamValue, ParamValueMap } from './param-editor.types';
+import { InputGroup, Param, ParamValue, ParamValueMap, ResourceRefValue } from './param-editor.types';
 export interface ParamEditorHorizontalProps {
     params?: Param[];
     groups?: InputGroup[];
     defaultValues: ParamValueMap;
     onChange: (id: string, value: ParamValue) => void;
+    onOpenResource?: (ref: ResourceRefValue) => void;
     readOnly?: boolean;
-    fullWidth?: boolean;
+    variant?: "default" | "small";
 }
 export declare const ParamEditorHorizontal: (props: ParamEditorHorizontalProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,6 +1,7 @@
 interface ParamEditorLabelProps {
     name: string;
     description?: string;
+    compact?: boolean;
 }
 export declare const ParamEditorLabel: (props: ParamEditorLabelProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,3 @@
+import { Param } from './param-editor.types';
+export declare const isParamEditorRichControl: (param: Param) => param is import('./param-editor.types').FileUploadParam;
+export declare const isParamEditorHorizontalControl: (param: Param) => param is import('./param-editor.types').NumberParam | import('./param-editor.types').BooleanParam | import('./param-editor.types').TextParam | import('./param-editor.types').MarkdownParam | import('./param-editor.types').SelectionParam | import('./param-editor.types').DateParam | import('./param-editor.types').ColorParam | import('./param-editor.types').PropertyParam | import('./param-editor.types').ReadOnlyParam | import('./param-editor.types').ResourceParam | import('./param-editor.types').RangeParam | import('./param-editor.types').SegmentedParam | import('./param-editor.types').ActionsParam | import('./param-editor.types').VectorParam | import('./param-editor.types').FileUploadParam;

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

@@ -0,0 +1,9 @@
+import { Param } from './param-editor.types';
+interface ParamEditorReadOnlyFieldProps {
+    param: Extract<Param, {
+        type: "readOnly";
+    }>;
+    fullWidth?: boolean;
+}
+export declare const ParamEditorReadOnlyField: (props: ParamEditorReadOnlyFieldProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -11,6 +11,7 @@ interface ParamEditorSectionProps {
     collapsible?: boolean;
     defaultCollapsed?: boolean;
     isFirst?: boolean;
+    variant?: "default" | "small";
 }
 export declare const ParamEditorSection: (props: ParamEditorSectionProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -7,5 +7,6 @@ export interface ParamEditorProps {
     onOpenResource?: (ref: ResourceRefValue) => void;
     readOnly?: boolean;
     fullWidth?: boolean;
+    variant?: "default" | "small";
 }
 export declare const ParamEditor: (props: ParamEditorProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -3,6 +3,8 @@ export interface BaseParam {
     id: string;
     name: string;
     description?: string;
+    /** Locks this one param while the rest of the editor stays editable. */
+    readOnly?: boolean;
 }
 export interface NumberParam extends BaseParam {
     type: "number";
@@ -11,21 +13,40 @@ export interface NumberParam extends BaseParam {
     max?: number;
     step?: number;
 }
+export interface BooleanParam extends BaseParam {
+    type: "boolean";
+    defaultValue: boolean;
+}
 export interface TextParam extends BaseParam {
     type: "text";
     defaultValue: string;
     singleLine?: boolean;
 }
+export interface MarkdownParam extends BaseParam {
+    type: "markdown";
+    defaultValue: string;
+    placeholder?: string;
+}
+export interface SelectionOption {
+    id: string;
+    name: string;
+    icon?: string;
+    /** Palette key (e.g. "blue") applied to the option's icon. */
+    color?: string;
+}
 export interface SelectionParam extends BaseParam {
     type: "selection";
     defaultValue: string | string[];
-    options: {
-        id: string;
-        name: string;
-        icon?: string;
-    }[];
+    options: SelectionOption[];
     multiSelect?: boolean;
     placeholder?: string;
+    /** Adds a "clear" row so a single-select can be returned to unset. */
+    clearable?: boolean;
+    /**
+     * Renders the control inert but still as a control — unlike `readOnly`, which
+     * collapses it to plain text and drops the option's icon.
+     */
+    disabled?: boolean;
 }
 export interface DateParam extends BaseParam {
     type: "date";
@@ -41,6 +62,23 @@ export interface PropertyParam extends BaseParam {
     type: "property";
     value: ReactNode;
 }
+export interface ParamEditorReadOnlyImage {
+    src: string;
+    alt: string;
+}
+export type ParamEditorReadOnlyContent = string | number | boolean | null | Array<string | number | boolean | null> | {
+    type: "image";
+    src: string;
+    alt: string;
+} | {
+    type: "image-gallery";
+    images: ParamEditorReadOnlyImage[];
+};
+/** Serializable display-only value rendered by the read-only Param Editor. */
+export interface ReadOnlyParam extends BaseParam {
+    type: "readOnly";
+    value: ParamEditorReadOnlyContent;
+}
 /** A reference the host can open (e.g. another resource tab). */
 export interface ResourceRefValue {
     type: string;
@@ -132,18 +170,21 @@ export interface VectorParam extends BaseParam {
     max?: number;
     step?: number;
 }
-/** File selection metadata. Not a live `File` object — hosts own persistence. */
-export interface FileDropValue {
-    name: string;
-    mimeType?: string;
-    size?: number;
-    dataUrl?: string;
-}
-export interface FileDropParam extends BaseParam {
-    type: "fileDrop";
-    defaultValue: FileDropValue | null;
+export type FileUploadStatus = "queued" | "uploading" | "complete" | "error";
+/** A selected file and the host-controlled state of its upload. */
+export interface FileUploadValue {
+    id: string;
+    file: File;
+    status: FileUploadStatus;
+    progress?: number;
+    error?: string;
+}
+export interface FileUploadParam extends BaseParam {
+    type: "fileUpload";
+    defaultValue: FileUploadValue[];
     accept?: string;
-    assetKind?: "file" | "image";
+    multiple?: boolean;
+    uploadLabel?: string;
 }
 export interface InputGroup {
     id: string;
@@ -153,6 +194,6 @@ export interface InputGroup {
     collapsible?: boolean;
     defaultCollapsed?: boolean;
 }
-export type ParamValue = number | string | null | string[] | RangeValue | VectorValue | FileDropValue;
-export type Param = NumberParam | TextParam | SelectionParam | DateParam | ColorParam | PropertyParam | ResourceParam | RangeParam | SegmentedParam | ActionsParam | AnchorGridParam | VectorParam | FileDropParam;
+export type ParamValue = number | string | boolean | null | string[] | RangeValue | VectorValue | FileUploadValue[];
+export type Param = NumberParam | BooleanParam | TextParam | MarkdownParam | SelectionParam | DateParam | ColorParam | PropertyParam | ReadOnlyParam | ResourceParam | RangeParam | SegmentedParam | ActionsParam | AnchorGridParam | VectorParam | FileUploadParam;
 export type ParamValueMap = Record<string, ParamValue>;

package/dist/components/param-editor/resolve-param-value.d.ts

@@ -0,0 +1,2 @@
+import { ParamValueMap } from './param-editor.types';
+export declare const resolveParamValue: <T>(defaultValues: ParamValueMap, paramId: string, fallback: T) => T;

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

@@ -0,0 +1,4 @@
+import { BadgeProps } from '@chakra-ui/react';
+export interface ChipProps extends Omit<BadgeProps, "size" | "variant"> {
+}
+export declare const Chip: (props: ChipProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -4,6 +4,8 @@ export type { BreadcrumbItem } from './breadcrumb';
 export { Breadcrumb } from './breadcrumb';
 export type { CheckboxProps } from './checkbox';
 export { Checkbox } from './checkbox';
+export type { ChipProps } from './chip';
+export { Chip } from './chip';
 export { ContentPlaceholder, Label as ContentPlaceholderLabel } from './content-placeholder';
 export type { EmptyStateProps } from './empty-state';
 export { EmptyState } from './empty-state';

package/dist/components/primitives/resource-badge.d.ts

@@ -3,38 +3,40 @@ import { ReactNode } from 'react';
 declare const SIZE_STYLES: {
     readonly sm: {
         readonly container: {
-            readonly height: "20px";
+            readonly height: "5";
             readonly lineHeight: {
-                readonly base: "20px";
+                readonly base: "5";
             };
-            readonly px: "2xs";
+            readonly px: "xs";
         };
         readonly iconSize: 12;
-        readonly textStyle: "xs";
+        readonly textStyle: "label/XS";
     };
     readonly md: {
         readonly container: {
-            readonly height: "24px";
+            readonly height: "6";
             readonly lineHeight: {
-                readonly base: "24px";
+                readonly base: "6";
             };
             readonly px: "xs";
         };
         readonly iconSize: 14;
-        readonly textStyle: "sm";
+        readonly textStyle: "label/S/regular";
     };
 };
 declare const TONE_STYLES: {
     readonly neutral: {
-        readonly color: "color.primary";
-        readonly bg: "bg.muted";
+        readonly color: "fg";
+        readonly bg: "bg.subtle";
+        readonly borderColor: "border";
         readonly _hover: {
-            readonly bg: "bg.emphasized";
+            readonly bg: "bg.hover";
         };
     };
     readonly accent: {
         readonly color: "var(--schub-foreground-accent)";
         readonly bg: "var(--schub-accent-subtle)";
+        readonly borderColor: "var(--schub-accent-subtle)";
         readonly _hover: {
             readonly bg: "var(--schub-accent-subtle)";
         };

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

@@ -1,5 +1,6 @@
 export type { CollaborativeMarkdownEditorProps } from './collaborative-markdown-editor/collaborative-markdown-editor';
 export { CollaborativeMarkdownEditor } from './collaborative-markdown-editor/collaborative-markdown-editor';
+export { LazyMarkdownEditor } from './lazy-markdown-editor';
 export type { MarkdownEditorProps } from './markdown-editor/markdown-editor';
 export { MarkdownEditor } from './markdown-editor/markdown-editor';
 export type { PromptEditorProps, PromptEditorRef, ReferenceItem } from './prompt-input/prompt-input';

package/dist/components/rich-text/lazy-markdown-editor.d.ts

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

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/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/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" | "pdf" | "markdown";
+export declare function inferResourceTypeFromMediaType(mediaType: string): "text" | "table" | "image" | "markdown" | "json" | "pdf";

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 '../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

@@ -4,6 +4,7 @@ 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/terminal/terminal.d.ts

@@ -3,6 +3,15 @@ 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 {
@@ -25,6 +34,8 @@ export interface TerminalProps {
     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;

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

@@ -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

@@ -4,7 +4,7 @@ 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[];

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

@@ -14,6 +14,8 @@ export type TreeListNode = ListRowItem & {
     hiddenByDefault?: boolean;
     /** Opt in to the tree-customization (hide/show) menu. Items are non-hideable unless this is true. */
     canHide?: boolean;
+    /** Opt out of reordering while keeping the node visible in its group. */
+    canReorder?: boolean;
 };
 /** Top-level tree section with optional header, actions, empty state, and child nodes. */
 export interface TreeListSection {
@@ -26,6 +28,8 @@ export interface TreeListSection {
     hiddenByDefault?: boolean;
     /** Opt in to the tree-customization (hide/show) menu. Sections are non-hideable unless this is true. */
     canHide?: boolean;
+    /** Opt out of reordering while keeping the section visible in its group. */
+    canReorder?: boolean;
 }
 /** Navigation payload emitted when a navigable tree node is activated. */
 export interface TreeListNavigateEvent {