@fps-games/editor 0.2.1-beta.3 → 0.2.1-beta.4

package/node_modules/@fps-games/editor-browser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fps-games/editor-browser",
-  "version": "0.2.1-beta.3",
+  "version": "0.2.1-beta.4",
   "private": true,
   "type": "module",
   "description": "Browser host adapters for fps-game-editor.",
@@ -22,11 +22,11 @@
     }
   },
   "dependencies": {
-    "@fps-games/editor-core": "0.2.1-beta.3",
-    "@fps-games/editor-playable-sdk": "0.2.1-beta.3",
-    "@fps-games/editor-protocol": "0.2.1-beta.3",
-    "@fps-games/editor-ui": "0.2.1-beta.3",
-    "@fps-games/plugin-api": "0.2.1-beta.3",
-    "@fps-games/plugin-hierarchy": "0.2.1-beta.3"
+    "@fps-games/editor-core": "0.2.1-beta.4",
+    "@fps-games/editor-playable-sdk": "0.2.1-beta.4",
+    "@fps-games/editor-protocol": "0.2.1-beta.4",
+    "@fps-games/editor-ui": "0.2.1-beta.4",
+    "@fps-games/plugin-api": "0.2.1-beta.4",
+    "@fps-games/plugin-hierarchy": "0.2.1-beta.4"
   }
 }

package/node_modules/@fps-games/editor-core/dist/editor-authoring-host.d.ts

@@ -0,0 +1,107 @@
+import { type EditorAuthoringEventReadResult, type EditorAuthoringSnapshot, type EditorCommandExecutionResult, type EditorCommandInvocation } from '@fps-games/editor-protocol';
+import { type CreateEditorCommandSystemOptions, type EditorCommandHandlerContext, type EditorCommandHandlerOutcome, type EditorCommandClient, type EditorCommandInvocationHandle, type EditorCommandRegistration, type EditorCommandSystem } from './editor-command-system.js';
+import type { AuthoringSourceDescriptor } from './authoring-source.js';
+import type { DocumentCommand, EditorSession, EditorSessionDispatchOptions, EditorSessionState } from './editor-session.js';
+export interface EditorAuthoringHostCommandContext<TDocument, TPatch> extends EditorCommandHandlerContext {
+    readonly session: EditorSession<TDocument, TPatch>;
+    dispatch(command: DocumentCommand<TDocument, TPatch>, options?: EditorSessionDispatchOptions): EditorSessionState<TDocument>;
+}
+export interface EditorAuthoringHostCommandRegistration<TDocument, TPatch, TInput = unknown, TOutput = unknown> extends Omit<EditorCommandRegistration<TInput, TOutput>, 'handler' | 'authorityTransaction'> {
+    /**
+     * Defaults to the active document revision. Transaction commands may bind
+     * expectedRevision.document to their own stored transaction checkpoint.
+     */
+    readonly expectedRevisionPolicy?: 'current-document' | 'handler-validated';
+    readonly handler: (input: TInput, context: EditorAuthoringHostCommandContext<TDocument, TPatch>) => EditorCommandHandlerOutcome<TOutput> | Promise<EditorCommandHandlerOutcome<TOutput>>;
+}
+export interface CreateEditorAuthoringHostOptions<TDocument, TPatch> {
+    readonly serviceInstanceId: string;
+    readonly session: EditorSession<TDocument, TPatch>;
+    readonly commandSystem?: EditorCommandSystem;
+    readonly commandSystemOptions?: CreateEditorCommandSystemOptions;
+    readonly eventLimit?: number;
+    readonly now?: () => number;
+    /** Defaults to true. Product hosts may reuse an injected Command System across document sessions. */
+    readonly disposeCommandSystem?: boolean;
+}
+/** Opaque, operation-scoped access issued only to a command handler already holding the Host FIFO. */
+export interface EditorAuthoringHostSerializedAccess {
+    readonly serviceInstanceId: string;
+}
+/** @internal Adapter used by command handlers that already own the Host FIFO. */
+export declare function callWithEditorAuthoringSerializedAccess<TResult>(access: unknown, handler: () => TResult): TResult;
+/** @internal Operation-scoped Session façade for a handler that already owns serialized Host access. */
+export declare function createEditorAuthoringSerializedSessionView<TDocument, TPatch>(session: EditorSession<TDocument, TPatch>, serializedAccess: unknown): EditorSession<TDocument, TPatch>;
+export interface EditorAuthoringHost<TDocument, TPatch> {
+    readonly serviceInstanceId: string;
+    readonly commandSystem: EditorCommandClient;
+    registerCommand<TInput = unknown, TOutput = unknown>(registration: EditorAuthoringHostCommandRegistration<TDocument, TPatch, TInput, TOutput>): () => void;
+    invoke<TOutput = unknown>(invocation: EditorCommandInvocation): EditorCommandInvocationHandle<TOutput>;
+    execute<TOutput = unknown>(invocation: EditorCommandInvocation): Promise<EditorCommandExecutionResult<TOutput>>;
+    getSnapshot(): EditorAuthoringSnapshot<TDocument>;
+    readEvents(afterCursor?: number, expectedServiceInstanceId?: string): EditorAuthoringEventReadResult<TDocument>;
+    markSaved(document: TDocument, options: {
+        expectedDocumentRevision: number;
+        source?: AuthoringSourceDescriptor;
+        serializedAccess?: EditorAuthoringHostSerializedAccess;
+    }): Promise<EditorAuthoringSnapshot<TDocument>>;
+    /** Atomically checkpoints the active scope and applies a related Session mutation in the same Host FIFO. */
+    markSavedWithRelatedSession(document: TDocument, options: {
+        expectedDocumentRevision: number;
+        source?: AuthoringSourceDescriptor;
+        resetHistory?: boolean;
+        relatedSession: EditorSession<TDocument, TPatch>;
+        expectedRelatedDocumentRevision: number;
+        mutateRelatedSession(session: EditorSession<TDocument, TPatch>): unknown;
+        serializedAccess?: EditorAuthoringHostSerializedAccess;
+    }): Promise<EditorAuthoringSnapshot<TDocument>>;
+    reset(document: TDocument, source: AuthoringSourceDescriptor | undefined, options: {
+        expectedDocumentRevision: number;
+        serializedAccess?: EditorAuthoringHostSerializedAccess;
+    }): Promise<EditorAuthoringSnapshot<TDocument>>;
+    /** Atomically resets the active scope and a related Session in the same Host FIFO. */
+    resetWithRelatedSession(document: TDocument, source: AuthoringSourceDescriptor | undefined, options: {
+        expectedDocumentRevision: number;
+        relatedSession: EditorSession<TDocument, TPatch>;
+        expectedRelatedDocumentRevision: number;
+        mutateRelatedSession(session: EditorSession<TDocument, TPatch>): unknown;
+        serializedAccess?: EditorAuthoringHostSerializedAccess;
+    }): Promise<EditorAuthoringSnapshot<TDocument>>;
+    /** Switches the active document scope after all earlier admitted writes settle. */
+    switchSession(session: EditorSession<TDocument, TPatch>, options: {
+        expectedDocumentRevision: number;
+        serializedAccess?: EditorAuthoringHostSerializedAccess;
+    }): Promise<EditorAuthoringSnapshot<TDocument>>;
+    /** Adapter for Browser command writes that must join the Host FIFO. */
+    runExternalCommandMutation<TResult>(request: {
+        commandId: string;
+        requestId: string;
+        idempotencyKey: string;
+        expectedDocumentRevision: number;
+        fingerprint: string;
+    }, handler: (session: EditorSession<TDocument, TPatch>) => TResult | Promise<TResult>): Promise<TResult>;
+    /** Synchronous Browser command adapter. Fails closed while the FIFO is busy. */
+    tryRunExternalCommandMutationImmediately<TResult>(request: {
+        commandId: string;
+        requestId: string;
+        idempotencyKey: string;
+        expectedDocumentRevision: number;
+        fingerprint: string;
+    }, handler: (session: EditorSession<TDocument, TPatch>) => TResult): {
+        ok: true;
+        value: TResult;
+        reused: boolean;
+    } | {
+        ok: false;
+        reason: 'busy';
+    };
+    /** Runs a synchronous external-command mutation under an active Host-issued serialized access. */
+    runSerializedExternalMutation<TResult>(serializedAccess: EditorAuthoringHostSerializedAccess, expectedDocumentRevision: number, handler: (session: EditorSession<TDocument, TPatch>) => TResult): TResult;
+    dispose(): void;
+    /** Resolves after every started external operation has settled and authority is released. */
+    drain(): Promise<void>;
+}
+/** @internal Registration path bound to the Host that owns authoring authority. */
+export declare function registerEditorAuthoringHostExternalCommand<TDocument, TPatch, TInput = unknown, TOutput = unknown>(host: EditorAuthoringHost<TDocument, TPatch>, registration: EditorCommandRegistration<TInput, TOutput>): () => void;
+export declare function createEditorAuthoringHost<TDocument, TPatch = unknown>(options: CreateEditorAuthoringHostOptions<TDocument, TPatch>): EditorAuthoringHost<TDocument, TPatch>;
+//# sourceMappingURL=editor-authoring-host.d.ts.map

package/node_modules/@fps-games/editor-core/dist/editor-authoring-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-authoring-host.d.ts","sourceRoot":"","sources":["../src/editor-authoring-host.ts"],"names":[],"mappings":"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"}