@floegence/redevplugin-ui 3.2.0 → 3.3.0

package/dist/openapi.gen.d.ts

@@ -281,22 +281,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/_redevplugin/api/plugins/surfaces/{surface_instance_id}/assets/read": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post: operations["readPreparedSurfaceAsset"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/_redevplugin/api/plugins/surfaces/{surface_instance_id}/confirmations/reject": {
         parameters: {
             query?: never;
@@ -918,11 +902,6 @@ export interface components {
             ok: true;
             data: components["schemas"]["BridgeTokenResult"];
         };
-        SurfaceAssetSuccessResponse: {
-            /** @constant */
-            ok: true;
-            data: components["schemas"]["SurfaceAssetResult"];
-        };
         SurfaceDisposeSuccessResponse: {
             /** @constant */
             ok: true;
@@ -2191,7 +2170,7 @@ export interface components {
             issued_at: string;
             /** Format: date-time */
             expires_at: string;
-            document: components["schemas"]["OpaqueSurfaceDocumentV3"];
+            document: components["schemas"]["WebSurfaceDocument"];
         };
         TrustedParentBridgeHandshake: {
             /** @constant */
@@ -2222,17 +2201,6 @@ export interface components {
             /** Format: date-time */
             expires_at: string;
         };
-        ReadSurfaceAssetRequest: {
-            asset_session: string;
-            asset_session_id: string;
-            binding_id: string;
-        };
-        SurfaceAssetResult: {
-            path: string;
-            sha256: string;
-            content_type: string;
-            content_base64: string;
-        };
         ListExecutionEventsRequest: {
             after_cursor: number;
             limit?: number;
@@ -2612,6 +2580,10 @@ export interface components {
                 };
                 /** @description Methods required to open this surface. Omitted retains aggregate authorization. An empty array allows opening without method grants; calls remain individually authorized. Requires authorization.scoped.v1. */
                 required_methods?: string[];
+                web: {
+                    root: string;
+                    spa: boolean;
+                };
             }[];
             capability_bindings?: {
                 binding_id: string;
@@ -2831,41 +2803,17 @@ export interface components {
         HostCapabilityPinV1Id: string;
         HostCapabilityPinV1Semver: string;
         HostCapabilityPinV1Sha256: string;
-        OpaqueSurfaceDocumentV3: {
+        WebSurfaceDocument: {
             /** @constant */
-            schema_version: "redevplugin.opaque_surface_document.v3";
-            entry_path: components["schemas"]["OpaqueSurfaceDocumentV3PackagePath"];
-            entry_sha256: components["schemas"]["OpaqueSurfaceDocumentV3Sha256"];
-            language?: string;
-            /** @enum {unknown} */
-            direction?: "ltr" | "rtl" | "auto";
-            body_html: string;
-            styles: components["schemas"]["OpaqueSurfaceDocumentV3Style"][];
-            worker: components["schemas"]["OpaqueSurfaceDocumentV3Worker"];
-            assets: components["schemas"]["OpaqueSurfaceDocumentV3Asset"][];
-            critical_bytes: number;
-        };
-        OpaqueSurfaceDocumentV3Sha256: string;
-        OpaqueSurfaceDocumentV3PackagePath: string;
-        OpaqueSurfaceDocumentV3Style: {
-            path: components["schemas"]["OpaqueSurfaceDocumentV3PackagePath"];
-            sha256: components["schemas"]["OpaqueSurfaceDocumentV3Sha256"];
-            content: string;
-        };
-        OpaqueSurfaceDocumentV3Worker: {
-            path: components["schemas"]["OpaqueSurfaceDocumentV3PackagePath"];
-            sha256: components["schemas"]["OpaqueSurfaceDocumentV3Sha256"];
-            /** @constant */
-            type: "classic";
-            content: string;
-        };
-        OpaqueSurfaceDocumentV3Asset: {
-            binding_id: string;
-            logical_ids: string[];
-            path: components["schemas"]["OpaqueSurfaceDocumentV3PackagePath"];
-            sha256: components["schemas"]["OpaqueSurfaceDocumentV3Sha256"];
-            size: number;
-            content_type: string;
+            schema_version: "redevplugin.web_surface.v1";
+            /** Format: uri */
+            origin: string;
+            /** Format: uri */
+            parent_origin: string;
+            /** Format: uri */
+            bootstrap_url: string;
+            /** Format: uri */
+            entry_url: string;
         };
     };
     responses: {
@@ -2896,7 +2844,7 @@ export interface components {
                 "application/json": components["schemas"]["RPCSuccessResponse"];
             };
         };
-        /** @description Trusted-parent surface bootstrap. Capability-bearing fields are never forwarded into the opaque iframe or plugin worker. */
+        /** @description Trusted-parent surface bootstrap. Capability-bearing fields are never forwarded into the isolated Web application. */
         SurfaceBootstrapResponse: {
             headers: {
                 [name: string]: unknown;
@@ -2905,7 +2853,7 @@ export interface components {
                 "application/json": components["schemas"]["SurfaceBootstrapSuccessResponse"];
             };
         };
-        /** @description Trusted-parent asset-session exchange and validated opaque surface document. */
+        /** @description Trusted-parent asset-session exchange and verified Web surface origin binding. */
         SurfacePreparationResponse: {
             headers: {
                 [name: string]: unknown;
@@ -2923,15 +2871,6 @@ export interface components {
                 "application/json": components["schemas"]["BridgeTokenSuccessResponse"];
             };
         };
-        /** @description Trusted-parent package asset response. The plugin receives only a renderer-created blob URL. */
-        SurfaceAssetResponse: {
-            headers: {
-                [name: string]: unknown;
-            };
-            content: {
-                "application/json": components["schemas"]["SurfaceAssetSuccessResponse"];
-            };
-        };
         /** @description Surface revocation response. */
         SurfaceDisposeResponse: {
             headers: {
@@ -3366,11 +3305,6 @@ export interface components {
                 "application/json": components["schemas"]["TrustedParentBridgeTokenRequest"];
             };
         };
-        ReadSurfaceAssetRequest: {
-            content: {
-                "application/json": components["schemas"]["ReadSurfaceAssetRequest"];
-            };
-        };
         ListExecutionEventsRequest: {
             content: {
                 "application/json": components["schemas"]["ListExecutionEventsRequest"];
@@ -3760,21 +3694,6 @@ export interface operations {
             default: components["responses"]["MutationPlatformErrorResponse"];
         };
     };
-    readPreparedSurfaceAsset: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                surface_instance_id: components["parameters"]["SurfaceInstanceID"];
-            };
-            cookie?: never;
-        };
-        requestBody: components["requestBodies"]["ReadSurfaceAssetRequest"];
-        responses: {
-            200: components["responses"]["SurfaceAssetResponse"];
-            default: components["responses"]["PlatformErrorResponse"];
-        };
-    };
     rejectSurfacePluginConfirmation: {
         parameters: {
             query?: never;

package/dist/platform.d.ts

@@ -1,6 +1,6 @@
 import { type FetchLike } from "./http.js";
 import type { components } from "./openapi.gen.js";
-import { type PluginConfirmationHandler, type PluginSurfaceHost, type PluginSurfaceContext, type PluginSurfaceOpeningProgress, type PluginSurfaceInteractionEvent, type PluginSurfaceFileExportHandler, type PluginSurfaceReloadLimiter, type PluginSurfaceSlot, type PluginMethodResult, type ReDevPluginSurfaceTransport } from "./surface.js";
+import { type PluginConfirmationHandler, type PluginWebOriginPreparationHandler, type PluginSurfaceHost, type PluginSurfaceContext, type PluginSurfaceOpeningProgress, type PluginSurfaceInteractionEvent, type PluginSurfaceFileExportHandler, type PluginSurfaceReloadLimiter, type PluginSurfaceSlot, type PluginMethodResult, type ReDevPluginSurfaceTransport } from "./surface.js";
 import { type PluginSurfaceScope } from "./surface-scope.js";
 export type PluginPlatformClientOptions = {
     fetch?: FetchLike;
@@ -47,9 +47,14 @@ export type PluginOpenSurfaceInSlotOptions = PluginRequestOptions & {
     leaseRenewalLeadMs?: number;
     reloadLimiter?: PluginSurfaceReloadLimiter;
     confirm?: PluginConfirmationHandler;
+    prepareWebOrigin?: PluginWebOriginPreparationHandler;
     onOpeningProgress?: (progress: PluginSurfaceOpeningProgress) => void;
     onInteraction?: (event: PluginSurfaceInteractionEvent) => void;
     onFileExport?: PluginSurfaceFileExportHandler;
+    confirmClose?: (request: {
+        reason: "unsaved" | "unresponsive";
+        signal: AbortSignal;
+    }) => boolean | Promise<boolean>;
     onError?: (error: import("./errors.js").PluginBridgeError) => void;
     surfaceContext?: PluginSurfaceContext;
 };

package/dist/plugin.d.ts

@@ -4,5 +4,5 @@ export { pluginAPIMajor } from "./contracts.gen.js";
 export { createPluginProcessClient } from "./process.js";
 export type { PluginProcessExitResult, PluginProcessMethodContracts, PluginProcessReadResult, PluginProcessResourceLimits, PluginProcessStartRequest, PluginProcessStatus, } from "./process.js";
 export { callCapabilityOperation, callCapabilityStream, callCapabilitySync, isCapabilityBusinessError, } from "./capability-client.js";
-export type { BridgeLifecycleEvent, MessagePortLike, PluginBridgeClientOptions, PluginBridgeRequestOptions, PluginCanvasAccessibilityState, PluginCanvasInputEvent, PluginCanvasKeyEvent, PluginCanvasPointerEvent, PluginCanvasWheelEvent, PluginCanvasResizeEvent, PluginCanvasSurface, PluginFileExportRequest, PluginSurfaceKeyboardBinding, PluginSurfaceKeyboardEvent, PluginSurfaceKeyboardTargetKind, PluginJSONObject, PluginJSONValue, PluginMethodResult, PluginExecutionFailureCode, PluginExecutionSnapshot, PluginExecutionProgress, PluginExecutionEvent, PluginExecutionEventList, PluginSurfaceContext, PluginSurfaceFileExportMediaType, PluginUIActionEvent, PluginUIAttributeValue, PluginUIElementVNode, PluginUIPatchOperation, PluginUIVNode, } from "./surface.js";
+export type { BridgeLifecycleEvent, MessagePortLike, PluginBridgeClientOptions, PluginBridgeClock, PluginBridgeRequestOptions, PluginFileExportRequest, PluginJSONObject, PluginJSONValue, PluginMethodResult, PluginExecutionFailureCode, PluginExecutionSnapshot, PluginExecutionProgress, PluginExecutionEvent, PluginExecutionEventList, PluginSurfaceContext, PluginSurfaceFileExportMediaType, } from "./surface.js";
 export type { PluginCapabilitySchema, PluginCapabilityEffect, PluginCapabilityOperationContract, PluginCapabilityStreamContract, PluginCapabilitySyncContract, PluginCapabilityStreamEvent, PluginCapabilityStreamReadResult, PluginExecution, PluginExecutionTerminalStatus, PluginExecutionWaitOptions, PluginStream, } from "./capability-client.js";

package/dist/surface.d.ts

@@ -1,9 +1,7 @@
 import { PluginBridgeError, type PluginMutationOutcome } from "./errors.js";
 import { type FetchLike } from "./http.js";
 import { type PluginSurfaceScope } from "./surface-scope.js";
-import { type PluginUIVNode } from "./ui-reconciler.js";
-export type { PluginUIAttributeValue, PluginUIElementVNode, PluginUIPatchOperation, PluginUIVNode, } from "./ui-reconciler.js";
-export declare const opaqueSurfaceDocumentSchemaVersion: "redevplugin.opaque_surface_document.v3";
+export declare const webSurfaceDocumentSchemaVersion: "redevplugin.web_surface.v1";
 export declare const pluginRiskPlanSchemaVersion: "redevplugin.capability.risk_plan.v1";
 export type PluginJSONValue = null | boolean | number | string | PluginJSONValue[] | PluginJSONObject;
 export type PluginJSONObject = {
@@ -84,25 +82,7 @@ export type PluginBridgeLifecycleAckMessage = {
     type: "redevplugin.bridge.lifecycle_ack";
     quiesce_id: string;
 };
-export type PluginUIActionEvent = {
-    action: string;
-    event: "click" | "input" | "change" | "submit" | "escape";
-    targetKey: string;
-    editRevision: number;
-    isComposing: boolean;
-    value?: string;
-    checked?: boolean;
-    form_data?: Record<string, string>;
-};
-export type PluginCanvasSurface = {
-    canvas: OffscreenCanvas;
-    canvasId: string;
-    cssWidth: number;
-    cssHeight: number;
-    devicePixelRatio: number;
-};
 export declare const pluginSurfaceFileExportMaxBytes: number;
-export declare const pluginSurfaceFileExportActionWindowMs = 30000;
 export declare const pluginSurfaceFileExportMediaTypes: readonly ["image/png", "image/jpeg", "image/webp", "image/svg+xml", "text/plain"];
 export type PluginSurfaceFileExportMediaType = (typeof pluginSurfaceFileExportMediaTypes)[number];
 export type PluginFileExportRequest = {
@@ -113,83 +93,8 @@ export type PluginFileExportRequest = {
 export type PluginSurfaceFileExport = Readonly<PluginFileExportRequest & {
     signal: AbortSignal;
 }>;
+/** The host must obtain an explicit destination/confirmation before writing exported bytes. */
 export type PluginSurfaceFileExportHandler = (request: PluginSurfaceFileExport) => Promise<void> | void;
-export type PluginCanvasAccessibilityState = {
-    label: string;
-    description: string;
-};
-export type PluginCanvasFocusEvent = {
-    type: "focus" | "blur";
-};
-export type PluginCanvasResizeEvent = {
-    type: "resize";
-    cssWidth: number;
-    cssHeight: number;
-    devicePixelRatio: number;
-};
-export type PluginCanvasKeyEvent = {
-    type: "key";
-    event: "keydown" | "keyup";
-    code: string;
-    key: string;
-    repeat: boolean;
-    altKey: boolean;
-    ctrlKey: boolean;
-    metaKey: boolean;
-    shiftKey: boolean;
-};
-export type PluginCanvasPointerEvent = {
-    type: "pointer";
-    event: "pointerdown" | "pointermove" | "pointerup" | "pointercancel";
-    pointerId: number;
-    pointerType: "mouse" | "pen" | "touch" | "unknown";
-    buttons: number;
-    button: number;
-    x: number;
-    y: number;
-    pressure: number;
-};
-export type PluginCanvasWheelEvent = {
-    type: "wheel";
-    x: number;
-    y: number;
-    deltaX: number;
-    deltaY: number;
-    deltaMode: 0 | 1 | 2;
-    altKey: boolean;
-    ctrlKey: boolean;
-    metaKey: boolean;
-    shiftKey: boolean;
-};
-export type PluginCanvasInputEvent = PluginCanvasFocusEvent | PluginCanvasResizeEvent | PluginCanvasKeyEvent | PluginCanvasPointerEvent | PluginCanvasWheelEvent;
-export type PluginSurfaceKeyboardTargetKind = "canvas" | "editable" | "control" | "surface";
-export type PluginSurfaceKeyboardBinding = {
-    id: string;
-    event: "keydown" | "keyup";
-    code: string;
-    repeat: boolean;
-    altKey: boolean;
-    ctrlKey: boolean;
-    metaKey: boolean;
-    shiftKey: boolean;
-    targetKey: string | null;
-    targetKind: PluginSurfaceKeyboardTargetKind;
-};
-export type PluginSurfaceKeyboardEvent = {
-    event: "keydown" | "keyup";
-    code: string;
-    key: string;
-    repeat: boolean;
-    altKey: boolean;
-    ctrlKey: boolean;
-    metaKey: boolean;
-    shiftKey: boolean;
-    isComposing: boolean;
-    targetKey: string | null;
-    targetKind: PluginSurfaceKeyboardTargetKind;
-    defaultPrevented: boolean;
-    bindingId: string | null;
-};
 export type PluginMethodResult<T = unknown> = {
     data: T;
     execution_id?: string;
@@ -323,8 +228,12 @@ export type MessageChannelLike = {
     port1: MessagePortLike;
     port2: MessagePortLike;
 };
+export type PluginBridgeClock = {
+    schedule(callback: () => void, delayMs: number): () => void;
+};
 export type PluginBridgeClientOptions = {
     timeoutMs?: number;
+    clock?: PluginBridgeClock;
     port?: MessagePortLike;
     surfaceHandle?: string;
 };
@@ -343,15 +252,9 @@ export declare class PluginBridgeClient {
     executionSnapshot(executionID: string, options?: PluginBridgeRequestOptions): Promise<PluginExecutionSnapshot>;
     context(): PluginSurfaceContext | undefined;
     onContext(handler: (context: PluginSurfaceContext) => void): () => void;
-    render(tree: PluginUIVNode): Promise<void>;
-    openCanvas(canvasId: string): Promise<PluginCanvasSurface>;
-    updateCanvasAccessibility(canvasId: string, state: PluginCanvasAccessibilityState): Promise<void>;
-    setKeyboardBindings(bindings: readonly PluginSurfaceKeyboardBinding[]): Promise<void>;
-    onKeyboardInput(handler: (event: PluginSurfaceKeyboardEvent) => void): () => void;
-    loadImageAsset(assetId: string): Promise<ImageBitmap>;
     exportFile(request: PluginFileExportRequest, options?: PluginBridgeRequestOptions): Promise<void>;
-    onAction(action: string, handler: (event: PluginUIActionEvent) => void): () => void;
-    onCanvasInput(canvasId: string, handler: (event: PluginCanvasInputEvent) => void): () => void;
+    /** Return false when saving failed or the application still has unsaved work. */
+    onBeforeClose(handler: () => boolean | Promise<boolean>): () => void;
     onLifecycle(handler: (event: BridgeLifecycleEvent) => Promise<void> | void): () => void;
     dispose(): void;
 }
@@ -394,37 +297,12 @@ export declare class PluginSurfaceReloadLimiter {
 export declare function isPluginRiskPlan(plan: unknown): plan is PluginRiskPlan;
 export declare function decodePluginEventText(event: PluginExecutionEvent): string;
 export declare function trustedParentBridgeHandshakeTranscriptSHA256(handshake: TrustedParentBridgeHandshake, bridgeChannelID: string): Promise<string>;
-export type OpaqueSurfaceStyle = {
-    path: string;
-    sha256: string;
-    content: string;
-};
-export type OpaqueSurfaceWorker = {
-    path: string;
-    sha256: string;
-    type: "classic";
-    content: string;
-};
-export type OpaqueSurfaceAsset = {
-    binding_id: string;
-    logical_ids: string[];
-    path: string;
-    sha256: string;
-    size: number;
-    content_type: string;
-};
-export type OpaqueSurfaceDocument = {
-    schema_version: typeof opaqueSurfaceDocumentSchemaVersion;
-    entry_path: string;
-    entry_sha256: string;
-    title?: string;
-    language?: string;
-    direction?: string;
-    body_html: string;
-    styles: OpaqueSurfaceStyle[];
-    worker: OpaqueSurfaceWorker;
-    assets: OpaqueSurfaceAsset[];
-    critical_bytes: number;
+export type WebSurfaceDocument = {
+    schema_version: typeof webSurfaceDocumentSchemaVersion;
+    origin: string;
+    parent_origin: string;
+    bootstrap_url: string;
+    entry_url: string;
 };
 export type PluginSurfacePreparationResult = {
     asset_session: string;
@@ -436,7 +314,7 @@ export type PluginSurfacePreparationResult = {
     revoke_epoch: number;
     issued_at: string;
     expires_at: string;
-    document: OpaqueSurfaceDocument;
+    document: WebSurfaceDocument;
 };
 export type PluginSurfaceHostBootstrap = {
     pluginId: string;
@@ -455,8 +333,8 @@ export type PluginSurfaceHostBootstrap = {
     runtimeGenerationId: string;
 };
 export type PluginSurfaceHostContext = PluginSurfaceContext;
-export type PluginSurfaceOpeningStage = "preparing" | "connecting" | "authorizing" | "initializing" | "committing";
-export type PluginSurfaceOpeningMilestone = "frame_load" | "prepare" | "port_ack" | "token" | "renderer_ready" | "worker_ready" | "first_commit";
+export type PluginSurfaceOpeningStage = "preparing" | "connecting" | "authorizing" | "initializing";
+export type PluginSurfaceOpeningMilestone = "prepare" | "origin" | "entry_ready" | "port_ack" | "token" | "app_ready";
 export type PluginSurfaceOpeningProgress = {
     phase: "opening";
     elapsedMs: number;
@@ -480,6 +358,7 @@ export type PluginSurfaceHost = {
         type: "ready" | "dispose";
     }>): void;
     updateContext(context: PluginSurfaceContext): void;
+    requestClose(): Promise<PluginSurfaceCloseResult | undefined>;
     close(): Promise<PluginSurfaceCloseResult>;
     dispose(): Promise<void>;
 };
@@ -490,6 +369,16 @@ export type PreparedPluginSurfaceHost = PluginSurfaceHost & {
     readonly surfaceHandle: string;
     open(): Promise<void>;
 };
+/** Trusted host routing preparation. The signal remains active for the surface lifetime. */
+export type PluginWebOriginPreparation = Readonly<{
+    origin: string;
+    parentOrigin: string;
+    pluginInstanceId: string;
+    surfaceInstanceId: string;
+    signal: AbortSignal;
+}>;
+/** Prepare only the allocated route; return no URL, token, or alternate bootstrap. */
+export type PluginWebOriginPreparationHandler = (request: PluginWebOriginPreparation) => void | Promise<void>;
 export type PluginSurfaceHostOptions = {
     bootstrap: PluginSurfaceHostBootstrap;
     hostTransport: ReDevPluginSurfaceTransport;
@@ -500,9 +389,14 @@ export type PluginSurfaceHostOptions = {
     leaseRenewalLeadMs?: number;
     reloadLimiter?: PluginSurfaceReloadLimiter;
     confirm?: PluginConfirmationHandler;
+    prepareWebOrigin?: PluginWebOriginPreparationHandler;
     onOpeningProgress?: (progress: PluginSurfaceOpeningProgress) => void;
     onInteraction?: (event: PluginSurfaceInteractionEvent) => void;
     onFileExport?: PluginSurfaceFileExportHandler;
+    confirmClose?: (request: {
+        reason: "unsaved" | "unresponsive";
+        signal: AbortSignal;
+    }) => boolean | Promise<boolean>;
     onError?: (error: PluginBridgeError) => void;
     surfaceContext?: PluginSurfaceContext;
 };
@@ -522,9 +416,6 @@ export type ReDevPluginSurfaceTransportOptions = {
     apiBaseURL?: string;
 };
 export declare function createReDevPluginSurfaceTransport(options?: ReDevPluginSurfaceTransportOptions): ReDevPluginSurfaceTransport;
-export type OpaquePluginBootstrapHTMLOptions = {
-    scriptNonce?: string;
-};
 export type PluginSurfaceQuiesceResult = {
     outcome: "acknowledged" | "not_ready" | "timed_out";
     durationMs: number;
@@ -541,7 +432,6 @@ export type PluginSurfaceRevocationReconciliation = {
     previous_state: "active" | "closed" | "absent";
     revoked: boolean;
 };
-export declare function createOpaquePluginBootstrapHTML(options?: OpaquePluginBootstrapHTMLOptions): string;
 export declare function createPreparedPluginSurfaceHost(options: PluginSurfaceHostOptions): PreparedPluginSurfaceHost;
 export type PluginSurfaceSlotState = "empty" | "opening" | "ready" | "error" | "disposed";
 export type PluginSurfaceSlotOptions = {
@@ -556,7 +446,11 @@ export declare class PluginSurfaceSlot {
     readonly element: HTMLElement;
     static create(options: PluginSurfaceSlotOptions): PluginSurfaceSlot;
     private constructor();
+    /** Ask before removing a user-owned application; forced scope invalidation bypasses this. */
+    requestClose(): Promise<PluginSurfaceCloseResult | undefined>;
     close(): Promise<PluginSurfaceCloseResult | undefined>;
     dispose(): Promise<void>;
 }
+export declare function isWebSurfaceDocument(value: unknown): value is WebSurfaceDocument;
 export declare function normalizePluginSurfaceContext(value: unknown): PluginSurfaceContext;
+export {};