@pstdio/workbench 0.6.0 → 0.7.1

package/dist/react.d.ts

@@ -2,6 +2,7 @@ import { BoxProps } from '@chakra-ui/react';
 import { ComponentType } from 'react';
 import { Context } from 'react';
 import { FileIconThemePreferenceOption as FileIconThemePreferenceOption_2 } from '@pstdio/ui';
+import { FileUploadValue } from '@pstdio/ui';
 import { IconProps } from '@chakra-ui/react';
 import { JSX } from 'react/jsx-runtime';
 import { JSXElementConstructor } from 'react';
@@ -111,7 +112,13 @@ declare interface Command {
     params?: CommandParamSchema;
 }
 
+export declare interface CommandFilesParamValue {
+    refs: string[];
+    uploads: FileUploadValue[];
+}
+
 declare interface CommandHandler<TArgs = unknown, TResult = unknown> {
+    prepareArgs?(args: TArgs, context?: WorkbenchCommandExecutionContext, onArgsChange?: (args: TArgs) => void): TArgs | Promise<TArgs>;
     execute(args: TArgs, context?: WorkbenchCommandExecutionContext): TResult | Promise<TResult>;
     isEnabled?(args: TArgs): boolean;
     isVisible?(args: TArgs): boolean;
@@ -168,6 +175,8 @@ declare interface CommandParamDescriptor {
     options?: CommandParamOption[];
     templateType?: string;
     resourceType?: string;
+    accept?: string;
+    multiple?: boolean;
     metadata?: Record<string, unknown>;
 }
 
@@ -208,7 +217,7 @@ declare interface CommandParamsRequest {
     context?: WorkbenchCommandExecutionContext;
 }
 
-export declare type CommandParamValue = string | boolean | string[] | undefined;
+export declare type CommandParamValue = string | boolean | string[] | CommandFilesParamValue | undefined;
 
 declare interface CommandRegistry {
     store: WorkbenchStore<CommandRegistryStoreState>;
@@ -218,6 +227,7 @@ declare interface CommandRegistry {
     isCommandEnabled(id: string, args?: unknown): boolean;
     isCommandVisible(id: string, args?: unknown): boolean;
     isCommandToggled(id: string, args?: unknown): boolean;
+    prepareCommandArgs(id: string, args: unknown, context?: WorkbenchCommandExecutionContext, onArgsChange?: (args: unknown) => void): Promise<unknown>;
     executeCommand(id: string, args?: unknown, context?: WorkbenchCommandExecutionContext): Promise<unknown>;
     onDidExecuteError(listener: WorkbenchCommandExecutionErrorListener): Disposable_2;
 }
@@ -341,6 +351,8 @@ declare interface ControlsUpdateValueInput {
     resource?: ResourceRef;
 }
 
+export declare const createCommandFilesParamValue: (input?: Partial<CommandFilesParamValue>) => CommandFilesParamValue;
+
 export declare const createControllerTerminalBridge: (terminal: WorkbenchTerminalController, options?: ControllerTerminalBridgeOptions) => TerminalBridge;
 
 export declare const createTreeContextMenuItems: (input: CreateTreeContextMenuItemsInput) => ListRowActionMenuItem[];
@@ -575,10 +587,21 @@ declare interface FileIconThemeRegistry {
 
 declare interface FileRendererContent {
     fileName?: string;
+    /** Workspace-relative path shown above the file preview. */
+    filePath?: string;
     mimeType?: string;
     content?: string;
     dataUrl?: string;
     placeholder?: string;
+    /** Override contribution-level save support for one loaded file. */
+    editable?: boolean;
+    /** Request Monaco for text that automatic dispatch would open as markdown. */
+    textRenderer?: "automatic" | "monaco";
+    /** Represent a deliberate no-file selection without an editable blank document. */
+    emptyState?: {
+        title: string;
+        description?: string;
+    };
     /** Ordered backing-store revision when one is available. */
     revision?: string;
 }
@@ -658,6 +681,8 @@ declare interface HistoryStoreState {
     hydrating: boolean;
 }
 
+export declare const isCommandFilesParamValue: (value: unknown) => value is CommandFilesParamValue;
+
 export declare const isSettingsScopeVisible: (scope: SettingsScope | undefined, hasProjectScope: boolean) => boolean;
 
 declare interface KanbanRendererContribution<TRow extends KanbanRendererRow = KanbanRendererRow> {
@@ -1113,7 +1138,7 @@ declare interface PreferenceScopeRef {
 declare type PreferenceValue = boolean | number | string | string[] | number[] | boolean[] | Record<string, unknown>;
 
 /** Narrows an editor value back to what a command param can carry. */
-export declare const readCommandParamValue: (value: ParamValue) => CommandParamValue;
+export declare const readCommandParamValue: (value: ParamValue, entry?: CommandParamEntry) => CommandParamValue;
 
 declare interface RegisteredCommand extends RegisteredContributionMetadata {
     command: Command;
@@ -1191,7 +1216,9 @@ declare interface RegisteredWorkbenchNotification extends RegisteredContribution
 
 declare type ResolvedResourceHierarchyProvider = Required<ResourceHierarchyProvider>;
 
-declare type ResolvedResourcePresenter = Required<ResourcePresenter>;
+declare type ResolvedResourcePresenter = Omit<ResourcePresenter, "priority"> & {
+    priority: number;
+};
 
 declare interface ResourceBrowseEntry {
     resource: ResourceRef;
@@ -1253,6 +1280,7 @@ declare interface ResourcePresenter {
     priority?: number;
     canOpen(resource: ResourceRef): boolean;
     open(resource: ResourceRef, input: OpenResourceInput): WorkbenchPanelInstance | Promise<WorkbenchPanelInstance>;
+    afterOpen?(resource: ResourceRef, instance: WorkbenchPanelInstance, input: OpenResourceInput): void;
 }
 
 declare interface ResourceProvider {
@@ -1483,11 +1511,13 @@ declare interface TreeNode {
     target?: NavigationTarget;
     /** Visual row variant for non-data rows such as placeholders. */
     rowVariant?: TreeNodeRowVariant;
+    inlineInput?: TreeNodeInlineInput;
     actions?: TreeAction[];
     contextMenuActions?: TreeAction[];
     contextMenuPath?: MenuPath;
     menuPath?: MenuPath;
     menuPlacement?: "top-start" | "top-end" | "bottom-start" | "bottom-end" | "right-start" | "left-start";
+    showContextMenuTrigger?: boolean;
     collapsible?: boolean;
     disabled?: boolean;
     children?: TreeNode[];
@@ -1498,6 +1528,18 @@ declare interface TreeNode {
     canHide?: boolean;
     /** When false, the node stays fixed within its Sidenav group. */
     canReorder?: boolean;
+    /** Allow this node to be moved to another tree location. */
+    canDrag?: boolean;
+    /** Allow movable nodes to be dropped on this node. */
+    canDrop?: boolean;
+}
+
+declare interface TreeNodeInlineInput {
+    ariaLabel: string;
+    defaultValue?: string;
+    placeholder?: string;
+    onCommit(value: string): Promise<void> | void;
+    onCancel?(): void;
 }
 
 declare type TreeNodeRowVariant = "empty-state";
@@ -1506,6 +1548,8 @@ declare interface TreeRendererContribution {
     id: string;
     title: string;
     icon?: string;
+    searchable?: boolean;
+    searchPlaceholder?: string;
     when?: string;
     defaultExpandedSectionIds?: string[];
     defaultExpandedNodeIds?: string[];
@@ -1513,6 +1557,7 @@ declare interface TreeRendererContribution {
     getHeader?(ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
     getFooter?(ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
     getChildren(node: TreeNode, ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
+    moveNode?(source: TreeNode, target: TreeNode | undefined, ctx: TreeContext): Promise<void> | void;
 }
 
 declare type TreeRendererImplementation = (input: WorkbenchPanelRenderInput & {
@@ -2150,6 +2195,7 @@ export declare interface WorkbenchOverlayWidgetConfig {
     scrollBehavior?: "inside" | "outside";
     closeOnEscape?: boolean;
     closeOnInteractOutside?: boolean;
+    /** Controls dialog semantics. Every workbench overlay blocks background pointer input. */
     modal?: boolean;
     preventScroll?: boolean;
     trapFocus?: boolean;