@pstdio/workbench 0.45.0-nightly.20261021030241 → 0.45.0

package/dist/extensions.d.ts

@@ -1,19 +1,14 @@
-import { Aa as PageParamValue$1, Ba as WebviewNotificationResolveParams, Bt as WorkbenchOwnedPlacementItem, Ca as WorkbenchExtensionControlsRendererRecord, Da as CommandNotice, Ea as WebviewHostProps, Et as PreferenceValue, Fa as WebviewFilesListParams, Gr as MenuItem, Ha as WebviewPreferencesGetParams, Ia as WebviewFilesUploadParams, Ki as WorkbenchPanelInstance, Kr as MenuPath, La as WebviewHostCapabilityParams, Li as NavigationTarget$2, Lr as TreeNode, Ma as WebviewCommandsExecuteParams, Na as WebviewExtensionSettingSetParams, Oa as NavigationTarget$1, P as WorkbenchModuleContext, Pa as WebviewFilesDeleteParams, Pr as TreeContext, Ra as WebviewHostCapabilityResults, Ri as NavigationTargetCommand, Rn as FileRendererRefreshEnvelope, Sa as WorkbenchExtensionDataTableRendererRecord, Tt as PreferenceScopeRef, Ua as WebviewPreferencesSetParams, Va as WebviewPageParamsUpdateParams, Wa as MaybePromise, Wr as WorkbenchPanelRenderInput, Xt as WorkbenchTerminalController, _a as WorkbenchExtensionFileRendererRecord, ba as WorkbenchExtensionCommandPaletteResourceRecord$1, ei as Command, fa as Disposable, ga as ExtensionSettingsSectionRecord, ha as ExtensionSettingDefinitionRecord, hr as KanbanRendererCreateSubmission, j as WorkbenchCore, ja as WebviewArtifactsReadParams, ka as PageLocation$1, mi as ResourceRef$1, oi as WorkbenchCommandExecutionContext, sa as WorkbenchPanelRegion, sr as CollectionViewsProvider, va as WorkbenchExtensionTreeRendererRecord, vn as WorkbenchPageContribution, vr as KanbanRendererViewsProvider, wa as ExtensionMenuContribution$1, xa as WorkbenchExtensionKanbanRendererRecord, ya as ExtensionKeybindingRecord, yn as WorkbenchPlacementPresentation, za as WebviewNotificationActionParams } from "./index-CEjUGkgB.js";
-import { i as ReactKanbanRendererContribution, t as ReactAttributeDescriptor } from "./kanban-presentation-CQNhh7IY.js";
+import { Aa as PageParamValue$1, Ba as WebviewNotificationResolveParams, Bt as WorkbenchOwnedPlacementItem, Ca as WorkbenchExtensionControlsRendererRecord, Da as CommandNotice, Ea as WebviewHostProps, Et as PreferenceValue, Fa as WebviewFilesListParams, Ga as WebviewEditingSnapshot, Gr as MenuItem, Ha as WebviewPreferencesGetParams, Ia as WebviewFilesUploadParams, Ja as ExtensionAccountApi, Ka as JsonObject, Ki as WorkbenchPanelInstance, Kr as MenuPath, La as WebviewHostCapabilityParams, Li as NavigationTarget$2, Lr as TreeNode, Ma as WebviewCommandsExecuteParams, Na as WebviewExtensionSettingSetParams, Oa as NavigationTarget$1, P as WorkbenchModuleContext, Pa as WebviewFilesDeleteParams, Pr as TreeContext, Ra as WebviewHostCapabilityResults, Ri as NavigationTargetCommand, Rn as FileRendererRefreshEnvelope, Sa as WorkbenchExtensionDataTableRendererRecord, Tt as PreferenceScopeRef, Ua as WebviewPreferencesSetParams, Va as WebviewPageParamsUpdateParams, Wa as WebviewEditingSessionParams, Wr as WorkbenchPanelRenderInput, Xt as WorkbenchTerminalController, _a as WorkbenchExtensionFileRendererRecord, ba as WorkbenchExtensionCommandPaletteResourceRecord$1, ei as Command, fa as Disposable, ga as ExtensionSettingsSectionRecord, ha as ExtensionSettingDefinitionRecord, hr as KanbanRendererCreateSubmission, j as WorkbenchCore, ja as WebviewArtifactsReadParams, ka as PageLocation$1, mi as ResourceRef$1, oi as WorkbenchCommandExecutionContext, qa as MaybePromise, sa as WorkbenchPanelRegion, sr as CollectionViewsProvider, va as WorkbenchExtensionTreeRendererRecord, vn as WorkbenchPageContribution, vr as KanbanRendererViewsProvider, wa as ExtensionMenuContribution$1, xa as WorkbenchExtensionKanbanRendererRecord, ya as ExtensionKeybindingRecord, yn as WorkbenchPlacementPresentation, za as WebviewNotificationActionParams } from "./index-DL-0XKr0.js";
+import { i as ReactKanbanRendererContribution, t as ReactAttributeDescriptor } from "./kanban-presentation-CdHu43iH.js";
 import { DataTableRendererSettings, Localizable, NavigationTarget, ResourceRef } from "@pstdio/sdk/extensions";
 import { CommandExecuteRequest, CommandExecutionResult, ExtensionCommandPaletteContribution, ExtensionMenuContribution, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionMetadata, WorkbenchExtensionMetadata as WorkbenchExtensionMetadata$1 } from "@pstdio/sdk/api";
 import { CommandStreamClientEvent } from "@pstdio/sdk/client";
-//#region ../pstdio-extensions/src/bridge/contract/capabilities.d.ts
 type HostCapability<TParams = unknown, TResult = unknown> = (params: TParams) => Promise<TResult> | TResult;
-//#endregion
-//#region ../pstdio-extensions/src/bridge/contract/index.d.ts
 type ThemePreference = "dark" | "light";
 type HostEventMessage = {
   scope: string;
   payload: unknown;
 };
-//#endregion
-//#region ../pstdio-extensions/src/bridge/host/host-event-publisher.d.ts
 /**
  * Host-side fan-in for events pushed into one guest webview. Capability
  * implementations `emit` while the frame owns the transport: events emitted
@@ -26,8 +21,6 @@ interface HostEventPublisher {
   /** Drop the current sink and return to buffering until the next bind. */
   unbind(): void;
 }
-//#endregion
-//#region src/extensions/bridge/extension-webview-host-adapters.d.ts
 interface ExtensionWebviewSettingsAdapter {
   all(): MaybePromise<Record<string, unknown>>;
   get(key: string): MaybePromise<unknown>;
@@ -62,6 +55,9 @@ interface ExtensionWebviewHostAdapters {
   streamCommand?(input: WebviewCommandsExecuteParams, signal: AbortSignal): AsyncIterable<CommandStreamClientEvent>;
   commandCompleted?(response: CommandExecutionResult): void;
   hostEvents?: HostEventPublisher;
+  editing?: {
+    request(input: WebviewEditingSessionParams, execute: (input: WebviewCommandsExecuteParams) => Promise<unknown>): Promise<WebviewEditingSnapshot | undefined>;
+  };
   navigation?: {
     open(target: NavigationTarget$1): MaybePromise<unknown>;
   };
@@ -78,10 +74,10 @@ interface ExtensionWebviewHostAdapters {
   artifacts?: {
     read(input: WebviewArtifactsReadParams): MaybePromise<WebviewHostCapabilityResults["artifacts.read"]>;
   };
+  /** The host's Cloud account. Methods without a project id use the webview's project. */
+  account?: ExtensionAccountApi;
   terminal?: WorkbenchTerminalController;
 }
-//#endregion
-//#region src/extensions/bridge/bridge-webview-renderer.d.ts
 interface BridgeWebviewRenderContext {
   workbench: WorkbenchCore;
   webviewId: string;
@@ -111,13 +107,12 @@ export declare const renderBridgeWebviewFrame: (input: {
   title: string;
   webview: BridgeWebviewConfig;
 }) => import("react/jsx-runtime").JSX.Element;
-//#endregion
-//#region src/extensions/bridge/extension-webview-host-capabilities.d.ts
 export declare const createExtensionWebviewHostCapabilities: (adapters: ExtensionWebviewHostAdapters) => {
   "harnesses.read": (input: unknown) => unknown;
   "resources.actions": (input: unknown) => unknown;
   "commands.execute": (input: unknown) => unknown;
   "commands.stream": (input: unknown) => unknown;
+  "editing.session": (input: unknown) => unknown;
   "navigation.open": (input: unknown) => unknown;
   "page.params.update": (input: unknown) => unknown;
   "placement.close": (input: unknown) => unknown;
@@ -136,9 +131,9 @@ export declare const createExtensionWebviewHostCapabilities: (adapters: Extensio
   "files.list": (input: unknown) => unknown;
   "files.delete": (input: unknown) => unknown;
   "artifacts.read": (input: unknown) => unknown;
+  "account.read": (input: unknown) => unknown;
+  "account.manage": (input: unknown) => unknown;
 };
-//#endregion
-//#region src/extensions/bridge/terminal-session-capability.d.ts
 interface CreateTerminalSessionCapabilityInput {
   terminal: WorkbenchTerminalController;
   hostEvents: HostEventPublisher;
@@ -150,32 +145,22 @@ interface CreateTerminalSessionCapabilityInput {
  * publisher under the `terminal.session` scope.
  */
 export declare const createTerminalSessionCapability: (input: CreateTerminalSessionCapabilityInput) => HostCapability;
-//#endregion
-//#region src/extensions/bridge/webview-capability-params.d.ts
 export declare class WebviewHostCapabilityError extends Error {
   code: string;
   data: Record<string, unknown>;
   constructor(code: string, message: string, data: Record<string, unknown>);
 }
-//#endregion
-//#region src/extensions/bridge/webview-command-capabilities.d.ts
 type ExtensionWebviewFileCapabilities = ExtensionWebviewFilesAdapter;
 interface ExtensionWebviewArtifactCapabilities {
   read(params: WebviewArtifactsReadParams, context: {
     webviewId: string;
   }): Promise<WebviewHostCapabilityResults["artifacts.read"]> | WebviewHostCapabilityResults["artifacts.read"];
 }
-//#endregion
-//#region src/extensions/bridge/webview-command-streams.d.ts
 export declare const withFrameSignal: <T>(hostEvents: HostEventPublisher, run: (signal: AbortSignal) => Promise<T>) => Promise<T>;
-//#endregion
-//#region src/extensions/bridge/webview-preferences-capability.d.ts
 interface WebviewOwnedPreferences {
   get(name: string, scope?: PreferenceScopeRef): Promise<PreferenceValue | undefined> | PreferenceValue | undefined;
   set(name: string, value: PreferenceValue, scope: PreferenceScopeRef): Promise<void> | void;
 }
-//#endregion
-//#region src/extensions/bridge/webview-host-capabilities.d.ts
 interface CreateWorkbenchWebviewHostAdaptersInput {
   workbench: WorkbenchCore;
   placement?: WorkbenchPanelInstance;
@@ -201,6 +186,14 @@ export declare const createWorkbenchWebviewHostAdapters: (input: CreateWorkbench
     } | undefined;
   }[]>;
   hostEvents: HostEventPublisher | undefined;
+  editing: {
+    request(input: WebviewEditingSessionParams, execute: (input: WebviewCommandsExecuteParams) => Promise<unknown>): Promise<{
+      value: JsonObject;
+      version: number;
+      revision: number;
+      savedRevision: number;
+    } | undefined>;
+  } | undefined;
   executeCommand: (request: WebviewCommandsExecuteParams, signal: AbortSignal | undefined) => Promise<{
     outcome: {
       ok: boolean;
@@ -231,6 +224,7 @@ export declare const createWorkbenchWebviewHostCapabilities: (input: CreateWorkb
   "resources.actions": (input: unknown) => unknown;
   "commands.execute": (input: unknown) => unknown;
   "commands.stream": (input: unknown) => unknown;
+  "editing.session": (input: unknown) => unknown;
   "navigation.open": (input: unknown) => unknown;
   "page.params.update": (input: unknown) => unknown;
   "placement.close": (input: unknown) => unknown;
@@ -249,9 +243,9 @@ export declare const createWorkbenchWebviewHostCapabilities: (input: CreateWorkb
   "files.list": (input: unknown) => unknown;
   "files.delete": (input: unknown) => unknown;
   "artifacts.read": (input: unknown) => unknown;
+  "account.read": (input: unknown) => unknown;
+  "account.manage": (input: unknown) => unknown;
 };
-//#endregion
-//#region src/extensions/host/workbench-extension-command.d.ts
 interface WorkbenchExtensionCommandContext {
   metadata?: Pick<WorkbenchExtensionMetadata$1, "commands">;
   executeCommand(commandId: string, body: CommandExecuteRequest, signal?: AbortSignal): Promise<unknown> | unknown;
@@ -283,20 +277,14 @@ export declare const createExtensionSlot: (input: {
 export declare const executeWorkbenchExtensionCommandResponse: (context: Pick<WorkbenchExtensionCommandContext, "executeCommand" | "projectId"> & {
   workbench: Pick<WorkbenchModuleContext, "navigation" | "notifications">;
 }, commandId: string, input?: ExecuteWorkbenchExtensionCommandInput) => Promise<unknown>;
-//#endregion
-//#region src/extensions/contributions/command-palette-resource-contributions.d.ts
 export declare const registerWorkbenchExtensionCommandPaletteResources: (context: WorkbenchExtensionCommandContext, records: readonly WorkbenchExtensionCommandPaletteResourceRecord[]) => {
   dispose(): void;
 };
-//#endregion
-//#region src/extensions/contributions/controls-renderer-contributions.d.ts
 interface WorkbenchExtensionControlsAdapter {
   /** Supply a fallback resource when the widget placement carries none. */
   resolveResource?: (record: WorkbenchExtensionControlsRendererRecord) => ResourceRef$1 | undefined;
 }
 export declare const registerWorkbenchExtensionControlsRenderers: (context: WorkbenchExtensionCommandContext, records: WorkbenchExtensionControlsRendererRecord[], adapter?: WorkbenchExtensionControlsAdapter) => Disposable;
-//#endregion
-//#region src/extensions/contributions/data-table-renderer-contributions.d.ts
 interface WorkbenchExtensionDataTableRendererAdapter {
   resolveRowResource?: (record: WorkbenchExtensionDataTableRendererRecord, row: {
     id: string;
@@ -307,8 +295,6 @@ interface WorkbenchExtensionDataTableRendererAdapter {
   createViewsProvider?: (record: WorkbenchExtensionDataTableRendererRecord) => CollectionViewsProvider<DataTableRendererSettings>;
 }
 export declare const registerWorkbenchExtensionDataTableRenderers: (context: WorkbenchExtensionCommandContext, records: WorkbenchExtensionDataTableRendererRecord[], adapter?: WorkbenchExtensionDataTableRendererAdapter) => Disposable;
-//#endregion
-//#region src/extensions/contributions/extension-contributions.d.ts
 interface WorkbenchExtensionMenuSlotConfig {
   menuPath: MenuPath;
   group?: string;
@@ -372,8 +358,6 @@ export declare const buildWorkbenchExtensionCommandPaletteRegistrations: (input:
   createCommandId?: (contribution: ExtensionCommandPaletteContribution) => string;
   resolveString?: WorkbenchExtensionStringResolver;
 }) => WorkbenchExtensionCommandPaletteRegistration[];
-//#endregion
-//#region src/extensions/host/internal-workbench-extension-metadata.d.ts
 type MetadataView = WorkbenchExtensionMetadata$1["views"][number];
 type MetadataWebview = Extract<MetadataView["body"], {
   kind: "webview";
@@ -492,8 +476,6 @@ interface InternalWorkbenchExtensionMetadata {
   }>;
   diagnostics: WorkbenchExtensionMetadata$1["diagnostics"];
 }
-//#endregion
-//#region src/extensions/contributions/file-renderer-contributions.d.ts
 interface RegisterWorkbenchExtensionFileRenderersInput {
   executeCommand(commandId: string, body: CommandExecuteRequest, signal?: AbortSignal): Promise<unknown> | unknown;
   metadata: InternalWorkbenchExtensionMetadata;
@@ -504,13 +486,9 @@ export declare const fileRendererRefreshEnvelopeFromCommand: (body: CommandExecu
 export declare const registerWorkbenchExtensionFileRenderers: (input: RegisterWorkbenchExtensionFileRenderersInput) => {
   dispose(): void;
 };
-//#endregion
-//#region src/extensions/contributions/kanban-renderer-contribution-helpers.d.ts
 type KanbanRendererRow = Awaited<ReturnType<ReactKanbanRendererContribution["executeQuery"]>>[number];
 type RowAction = NonNullable<WorkbenchExtensionKanbanRendererRecord["rowActions"]>[number];
 type Localizer = (value: unknown, fallback?: string) => string;
-//#endregion
-//#region src/extensions/contributions/kanban-renderer-adapter.d.ts
 /** How a host changes the way extension boards load views, resolve resources, and react to changes. */
 interface WorkbenchExtensionKanbanRendererAdapter {
   createViewsProvider?: (record: WorkbenchExtensionKanbanRendererRecord) => KanbanRendererViewsProvider;
@@ -564,26 +542,18 @@ interface WorkbenchExtensionKanbanRendererAdapter {
    */
   onAfterMutation?: (record: WorkbenchExtensionKanbanRendererRecord) => void;
 }
-//#endregion
-//#region src/extensions/contributions/kanban-renderer-contributions.d.ts
 export declare const registerWorkbenchExtensionKanbanRenderers: (context: WorkbenchExtensionCommandContext, records: readonly WorkbenchExtensionKanbanRendererRecord[], adapter?: WorkbenchExtensionKanbanRendererAdapter) => {
   dispose(): void;
 };
-//#endregion
-//#region src/extensions/contributions/tree-renderer-contribution-types.d.ts
 type ExtensionTreeRendererRecord = NonNullable<InternalWorkbenchExtensionMetadata["treeRenderers"]>[number];
 type ExtensionTreeViewRecord = InternalWorkbenchExtensionMetadata["panels"][number] | NonNullable<InternalWorkbenchExtensionMetadata["panels"][number]["panelMenus"]>[number];
 type ExtensionTreeResource = ResourceRef;
-//#endregion
-//#region src/extensions/contributions/tree-renderer-host-defaults.d.ts
 interface HostTreeDefaultNodesInput {
   ctx: TreeContext;
   record: ExtensionTreeRendererRecord;
   panel: ExtensionTreeViewRecord;
 }
 type HostTreeDefaultNodesResolver = (input: HostTreeDefaultNodesInput) => Promise<TreeNode[]> | TreeNode[];
-//#endregion
-//#region src/extensions/contributions/tree-renderer-contributions.d.ts
 interface RegisterWorkbenchExtensionTreeRenderersInput {
   executeCommand(commandId: string, body: CommandExecuteRequest): Promise<unknown> | unknown;
   getHostTreeFooterNodes?: HostTreeDefaultNodesResolver;
@@ -602,8 +572,6 @@ interface RegisterWorkbenchExtensionTreeRenderersInput {
 export declare const registerWorkbenchExtensionTreeRenderers: (input: RegisterWorkbenchExtensionTreeRenderersInput) => {
   dispose(): void;
 };
-//#endregion
-//#region src/extensions/host/extension-navigation-target.d.ts
 interface ToWorkbenchNavigationTargetInput {
   commandIdOf?(command: Extract<NavigationTarget, {
     kind: "command";
@@ -620,8 +588,6 @@ type NavigationOperation = Extract<NavigationTarget, {
 }>;
 export declare function toWorkbenchNavigationTarget(target: NavigationOperation, input?: ToWorkbenchNavigationTargetInput): NavigationOperation;
 export declare function toWorkbenchNavigationTarget(target: NavigationTarget, input?: ToWorkbenchNavigationTargetInput): NavigationTarget$2;
-//#endregion
-//#region src/extensions/host/workbench-extension-refresh.d.ts
 type WorkbenchExtensionRendererKind = "tree" | "file" | "controls" | "dataTable" | "kanban";
 interface RendererRefreshTarget {
   id: string;
@@ -638,8 +604,6 @@ interface RegisterWorkbenchExtensionRendererRefreshEventsInput {
 export declare const refreshWorkbenchExtensionRenderer: (workbench: WorkbenchModuleContext, target: RendererRefreshTarget, envelope?: FileRendererRefreshEnvelope) => void;
 export declare const registerWorkbenchExtensionRendererRefreshEvents: (input: RegisterWorkbenchExtensionRendererRefreshEventsInput) => Disposable;
 export declare const refreshOpenWorkbenchExtensionWebviews: (workbench: WorkbenchModuleContext, metadata: WorkbenchExtensionMetadata$1) => void;
-//#endregion
-//#region src/extensions/host/workbench-extension-host-types.d.ts
 interface WorkbenchExtensionHostMenuRegistration extends Omit<WorkbenchExtensionMenuRegistration, "menuItem" | "menuPath"> {
   menuItems: Array<{
     menuItem: MenuItem;
@@ -672,13 +636,9 @@ interface RegisterWorkbenchExtensionContributionsInput {
   webviewFiles?: ExtensionWebviewFileCapabilities;
   workbench: WorkbenchModuleContext;
 }
-//#endregion
-//#region src/extensions/host/workbench-extension-host.d.ts
 export declare const registerWorkbenchExtensionContributions: (sourceInput: RegisterWorkbenchExtensionContributionsInput) => {
   dispose(): void;
 };
-//#endregion
-//#region src/extensions/host/workbench-extension-metadata-ref.d.ts
 export declare const toWorkbenchWhenExpression: (when: WorkbenchExtensionMetadata$1["navigationItems"][number]["when"] | WorkbenchExtensionMetadata$1["statusBarItems"][number]["when"]) => {
   mode: string | string[] | undefined;
   source: ("api" | "automation" | "cli" | "command-panel" | "dashboard" | "event" | "schedule")[] | undefined;
@@ -686,6 +646,5 @@ export declare const toWorkbenchWhenExpression: (when: WorkbenchExtensionMetadat
   resourceType: string[] | undefined;
   metadata: Record<string, unknown> | undefined;
 } | undefined;
-//#endregion
 export type { BridgeWebviewConfig, BridgeWebviewRenderContext, CreateBridgeWebviewHostAdapters, CreateBridgeWebviewProps, CreateBridgeWebviewTheme, ExtensionWebviewArtifactCapabilities, ExtensionWebviewFileCapabilities, ExtensionWebviewFilesAdapter, ExtensionWebviewHostAdapters, ExtensionWebviewNotificationsAdapter, ExtensionWebviewPreferencesAdapter, ExtensionWebviewSettingsAdapter, RegisterWorkbenchExtensionContributionsInput, RegisterWorkbenchExtensionFileRenderersInput, RegisterWorkbenchExtensionRendererRefreshEventsInput, RegisterWorkbenchExtensionTreeRenderersInput, ToWorkbenchNavigationTargetInput, WorkbenchExtensionCommandContext, WorkbenchExtensionCommandPaletteRegistration, WorkbenchExtensionControlsAdapter, WorkbenchExtensionDataTableRendererAdapter, WorkbenchExtensionHostMenuRegistration, WorkbenchExtensionKanbanRendererAdapter, WorkbenchExtensionMenuRegistration, WorkbenchExtensionMenuSlotConfig, WorkbenchExtensionMenuWhenBuilder, WorkbenchExtensionMetadata, WorkbenchExtensionRendererKind };
 export {};