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

package/node_modules/@fps-games/editor-core/dist/editor-command-composed-authority.d.ts

@@ -0,0 +1,9 @@
+import type { EditorCommandRegistration } from './editor-command-system.js';
+declare const COMMAND_COMPOSED_AUTHORITY_REGISTRATION: unique symbol;
+type AuthorizedCommandComposedRegistration<TInput, TOutput> = EditorCommandRegistration<TInput, TOutput> & {
+    readonly [COMMAND_COMPOSED_AUTHORITY_REGISTRATION]: true;
+};
+export declare function authorizeCommandComposedRegistration<TInput, TOutput>(registration: EditorCommandRegistration<TInput, TOutput>): AuthorizedCommandComposedRegistration<TInput, TOutput>;
+export declare function isAuthorizedCommandComposedRegistration(registration: EditorCommandRegistration<unknown, unknown>): boolean;
+export {};
+//# sourceMappingURL=editor-command-composed-authority.d.ts.map

package/node_modules/@fps-games/editor-core/dist/editor-command-composed-authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-command-composed-authority.d.ts","sourceRoot":"","sources":["../src/editor-command-composed-authority.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAE5E,QAAA,MAAM,uCAAuC,eAA+D,CAAC;AAE7G,KAAK,qCAAqC,CAAC,MAAM,EAAE,OAAO,IAAI,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACzG,QAAQ,CAAC,CAAC,uCAAuC,CAAC,EAAE,IAAI,CAAC;CAC1D,CAAC;AAEF,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,OAAO,EAClE,YAAY,EAAE,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,GACvD,qCAAqC,CAAC,MAAM,EAAE,OAAO,CAAC,CAQxD;AAED,wBAAgB,uCAAuC,CACrD,YAAY,EAAE,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,GACxD,OAAO,CAGT"}

package/node_modules/@fps-games/editor-core/dist/editor-command-composed-authority.js

@@ -0,0 +1,14 @@
+const COMMAND_COMPOSED_AUTHORITY_REGISTRATION = Symbol('fps.editor.command-composed-authority-registration');
+export function authorizeCommandComposedRegistration(registration) {
+    Object.defineProperty(registration, COMMAND_COMPOSED_AUTHORITY_REGISTRATION, {
+        value: true,
+        enumerable: false,
+        configurable: false,
+        writable: false,
+    });
+    return registration;
+}
+export function isAuthorizedCommandComposedRegistration(registration) {
+    return registration[COMMAND_COMPOSED_AUTHORITY_REGISTRATION] === true;
+}
+//# sourceMappingURL=editor-command-composed-authority.js.map

package/node_modules/@fps-games/editor-core/dist/editor-command-composed-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-command-composed-authority.js","sourceRoot":"","sources":["../src/editor-command-composed-authority.ts"],"names":[],"mappings":"AAEA,MAAM,uCAAuC,GAAG,MAAM,CAAC,oDAAoD,CAAC,CAAC;AAM7G,MAAM,UAAU,oCAAoC,CAClD,YAAwD;IAExD,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,uCAAuC,EAAE;QAC3E,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,KAAK;QACnB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,YAAsE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,YAAyD;IAEzD,OAAQ,YAAiF,CACtF,uCAAuC,CAAC,KAAK,IAAI,CAAC;AACvD,CAAC","sourcesContent":["import type { EditorCommandRegistration } from './editor-command-system.js';\n\nconst COMMAND_COMPOSED_AUTHORITY_REGISTRATION = Symbol('fps.editor.command-composed-authority-registration');\n\ntype AuthorizedCommandComposedRegistration<TInput, TOutput> = EditorCommandRegistration<TInput, TOutput> & {\n  readonly [COMMAND_COMPOSED_AUTHORITY_REGISTRATION]: true;\n};\n\nexport function authorizeCommandComposedRegistration<TInput, TOutput>(\n  registration: EditorCommandRegistration<TInput, TOutput>,\n): AuthorizedCommandComposedRegistration<TInput, TOutput> {\n  Object.defineProperty(registration, COMMAND_COMPOSED_AUTHORITY_REGISTRATION, {\n    value: true,\n    enumerable: false,\n    configurable: false,\n    writable: false,\n  });\n  return registration as AuthorizedCommandComposedRegistration<TInput, TOutput>;\n}\n\nexport function isAuthorizedCommandComposedRegistration(\n  registration: EditorCommandRegistration<unknown, unknown>,\n): boolean {\n  return (registration as Partial<AuthorizedCommandComposedRegistration<unknown, unknown>>)\n    [COMMAND_COMPOSED_AUTHORITY_REGISTRATION] === true;\n}\n"]}

package/node_modules/@fps-games/editor-core/dist/editor-command-observability.d.ts

@@ -0,0 +1,18 @@
+import { type EditorCommandTrace, type EditorServiceTracePage } from '@fps-games/editor-protocol';
+import type { EditorCommandOperationSettledEvent } from './editor-command-system.js';
+export interface EditorCommandObservabilityStoreOptions {
+    readonly maxTraces?: number;
+    readonly maxStepsPerTrace?: number;
+    readonly maxSummaryCharacters?: number;
+}
+export interface EditorCommandObservabilityStore {
+    recordOperation(event: EditorCommandOperationSettledEvent): void;
+    read(input: {
+        traceId?: string;
+        cursor?: string;
+        limit: number;
+    }): EditorServiceTracePage<EditorCommandTrace>;
+    clear(): void;
+}
+export declare function createEditorCommandObservabilityStore(options?: EditorCommandObservabilityStoreOptions): EditorCommandObservabilityStore;
+//# sourceMappingURL=editor-command-observability.d.ts.map

package/node_modules/@fps-games/editor-core/dist/editor-command-observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-command-observability.d.ts","sourceRoot":"","sources":["../src/editor-command-observability.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,kBAAkB,EAEvB,KAAK,sBAAsB,EAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,4BAA4B,CAAC;AAErF,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,+BAA+B;IAC9C,eAAe,CAAC,KAAK,EAAE,kCAAkC,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IAC9G,KAAK,IAAI,IAAI,CAAC;CACf;AAMD,wBAAgB,qCAAqC,CACnD,OAAO,GAAE,sCAA2C,GACnD,+BAA+B,CAyEjC"}

package/node_modules/@fps-games/editor-core/dist/editor-command-observability.js

@@ -0,0 +1,113 @@
+import { EDITOR_COMMAND_TRACE_SCHEMA_VERSION, } from '@fps-games/editor-protocol';
+const DEFAULT_MAX_TRACES = 200;
+const DEFAULT_MAX_STEPS = 100;
+const DEFAULT_MAX_SUMMARY_CHARACTERS = 2000;
+export function createEditorCommandObservabilityStore(options = {}) {
+    const maxTraces = normalizePositiveInteger(options.maxTraces, DEFAULT_MAX_TRACES);
+    const maxSteps = normalizePositiveInteger(options.maxStepsPerTrace, DEFAULT_MAX_STEPS);
+    const maxSummaryCharacters = normalizePositiveInteger(options.maxSummaryCharacters, DEFAULT_MAX_SUMMARY_CHARACTERS);
+    const traces = new Map();
+    return Object.freeze({
+        recordOperation(event) {
+            const operation = event.operation;
+            const traceId = event.invocation.traceId ?? `operation:${operation.operationId}`;
+            const createdAt = toTimestamp(operation.createdAt);
+            const updatedAt = toTimestamp(operation.completedAt ?? operation.startedAt ?? operation.createdAt);
+            const existing = traces.get(traceId);
+            const diagnostics = cloneDiagnostics(operation.diagnostics ?? []);
+            const actionCommandId = operation.intentCommandId ?? operation.commandId;
+            const step = {
+                id: event.invocation.traceStepId ?? operation.operationId,
+                traceId,
+                source: toTraceSource(event.invocation.source),
+                layer: event.manifest?.target === 'renderer' ? 'L1' : 'L2',
+                action: actionCommandId,
+                status: operation.status === 'completed' ? 'ok' : 'failed',
+                startedAt: toTimestamp(operation.startedAt ?? operation.createdAt),
+                endedAt: updatedAt,
+                durationMs: Math.max(0, (operation.completedAt ?? operation.createdAt) - (operation.startedAt ?? operation.createdAt)),
+                commandId: operation.commandId,
+                ...(operation.intentCommandId ? { intentCommandId: operation.intentCommandId } : {}),
+                requestId: operation.requestId,
+                inputSummary: summarize(event.invocation.input, maxSummaryCharacters),
+                ...(operation.output !== undefined
+                    ? { outputSummary: summarize(operation.output, maxSummaryCharacters) }
+                    : {}),
+                ...(diagnostics.length ? { diagnostics } : {}),
+            };
+            const steps = [...(existing?.steps ?? []), step].slice(-maxSteps);
+            const traceDiagnostics = steps.reduce((count, item) => count + (item.diagnostics?.length ?? 0), 0);
+            const trace = {
+                schemaVersion: EDITOR_COMMAND_TRACE_SCHEMA_VERSION,
+                traceId,
+                status: steps.some(item => item.status === 'failed') ? 'failed' : 'ok',
+                createdAt: existing?.createdAt ?? createdAt,
+                updatedAt,
+                stepCount: steps.length,
+                diagnosticCount: traceDiagnostics,
+                artifactCount: 0,
+                lastAction: actionCommandId,
+                ...(diagnostics[0]?.message ? { lastMessage: diagnostics[0].message } : {}),
+                steps,
+            };
+            traces.delete(traceId);
+            traces.set(traceId, trace);
+            while (traces.size > maxTraces)
+                traces.delete(traces.keys().next().value);
+        },
+        read(input) {
+            const values = input.traceId
+                ? traces.has(input.traceId) ? [traces.get(input.traceId)] : []
+                : [...traces.values()].reverse();
+            const offset = decodeCursor(input.cursor);
+            const limit = normalizePositiveInteger(input.limit, 100);
+            const page = values.slice(offset, offset + limit).map(cloneTrace);
+            const nextOffset = offset + page.length;
+            return {
+                traces: page,
+                ...(nextOffset < values.length ? { nextCursor: String(nextOffset) } : {}),
+            };
+        },
+        clear() {
+            traces.clear();
+        },
+    });
+}
+function summarize(value, maxCharacters) {
+    let text;
+    try {
+        text = JSON.stringify(value === undefined ? null : value);
+    }
+    catch {
+        text = '"[unserializable]"';
+    }
+    return {
+        preview: text.length > maxCharacters ? `${text.slice(0, maxCharacters)}…` : text,
+        characters: text.length,
+        truncated: text.length > maxCharacters,
+    };
+}
+function cloneDiagnostics(diagnostics) {
+    return diagnostics.map(diagnostic => structuredClone(diagnostic));
+}
+function cloneTrace(trace) {
+    return structuredClone(trace);
+}
+function toTraceSource(source) {
+    return source === 'agent-cli' ? 'agent' : 'editor';
+}
+function toTimestamp(value) {
+    return new Date(Number.isFinite(value) ? value : 0).toISOString();
+}
+function decodeCursor(cursor) {
+    if (cursor === undefined)
+        return 0;
+    const value = Number(cursor);
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error('Trace cursor is invalid.');
+    return value;
+}
+function normalizePositiveInteger(value, fallback) {
+    return Number.isSafeInteger(value) && Number(value) > 0 ? Number(value) : fallback;
+}
+//# sourceMappingURL=editor-command-observability.js.map

package/node_modules/@fps-games/editor-core/dist/editor-command-observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-command-observability.js","sourceRoot":"","sources":["../src/editor-command-observability.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  EDITOR_COMMAND_TRACE_SCHEMA_VERSION,\n  type EditorCommandDiagnostic,\n  type EditorCommandJsonObject,\n  type EditorCommandOperationSnapshot,\n  type EditorCommandTrace,\n  type EditorCommandTraceSource,\n  type EditorServiceTracePage,\n} from '@fps-games/editor-protocol';\nimport type { EditorCommandOperationSettledEvent } from './editor-command-system.js';\n\nexport interface EditorCommandObservabilityStoreOptions {\n  readonly maxTraces?: number;\n  readonly maxStepsPerTrace?: number;\n  readonly maxSummaryCharacters?: number;\n}\n\nexport interface EditorCommandObservabilityStore {\n  recordOperation(event: EditorCommandOperationSettledEvent): void;\n  read(input: { traceId?: string; cursor?: string; limit: number }): EditorServiceTracePage<EditorCommandTrace>;\n  clear(): void;\n}\n\nconst DEFAULT_MAX_TRACES = 200;\nconst DEFAULT_MAX_STEPS = 100;\nconst DEFAULT_MAX_SUMMARY_CHARACTERS = 2_000;\n\nexport function createEditorCommandObservabilityStore(\n  options: EditorCommandObservabilityStoreOptions = {},\n): EditorCommandObservabilityStore {\n  const maxTraces = normalizePositiveInteger(options.maxTraces, DEFAULT_MAX_TRACES);\n  const maxSteps = normalizePositiveInteger(options.maxStepsPerTrace, DEFAULT_MAX_STEPS);\n  const maxSummaryCharacters = normalizePositiveInteger(\n    options.maxSummaryCharacters,\n    DEFAULT_MAX_SUMMARY_CHARACTERS,\n  );\n  const traces = new Map<string, EditorCommandTrace>();\n\n  return Object.freeze({\n    recordOperation(event: EditorCommandOperationSettledEvent) {\n      const operation = event.operation;\n      const traceId = event.invocation.traceId ?? `operation:${operation.operationId}`;\n      const createdAt = toTimestamp(operation.createdAt);\n      const updatedAt = toTimestamp(operation.completedAt ?? operation.startedAt ?? operation.createdAt);\n      const existing = traces.get(traceId);\n      const diagnostics = cloneDiagnostics(operation.diagnostics ?? []);\n      const actionCommandId = operation.intentCommandId ?? operation.commandId;\n      const step = {\n        id: event.invocation.traceStepId ?? operation.operationId,\n        traceId,\n        source: toTraceSource(event.invocation.source),\n        layer: event.manifest?.target === 'renderer' ? 'L1' as const : 'L2' as const,\n        action: actionCommandId,\n        status: operation.status === 'completed' ? 'ok' as const : 'failed' as const,\n        startedAt: toTimestamp(operation.startedAt ?? operation.createdAt),\n        endedAt: updatedAt,\n        durationMs: Math.max(0, (operation.completedAt ?? operation.createdAt) - (operation.startedAt ?? operation.createdAt)),\n        commandId: operation.commandId,\n        ...(operation.intentCommandId ? { intentCommandId: operation.intentCommandId } : {}),\n        requestId: operation.requestId,\n        inputSummary: summarize(event.invocation.input, maxSummaryCharacters),\n        ...(operation.output !== undefined\n          ? { outputSummary: summarize(operation.output, maxSummaryCharacters) }\n          : {}),\n        ...(diagnostics.length ? { diagnostics } : {}),\n      };\n      const steps = [...(existing?.steps ?? []), step].slice(-maxSteps);\n      const traceDiagnostics = steps.reduce((count, item) => count + (item.diagnostics?.length ?? 0), 0);\n      const trace: EditorCommandTrace = {\n        schemaVersion: EDITOR_COMMAND_TRACE_SCHEMA_VERSION,\n        traceId,\n        status: steps.some(item => item.status === 'failed') ? 'failed' : 'ok',\n        createdAt: existing?.createdAt ?? createdAt,\n        updatedAt,\n        stepCount: steps.length,\n        diagnosticCount: traceDiagnostics,\n        artifactCount: 0,\n        lastAction: actionCommandId,\n        ...(diagnostics[0]?.message ? { lastMessage: diagnostics[0].message } : {}),\n        steps,\n      };\n      traces.delete(traceId);\n      traces.set(traceId, trace);\n      while (traces.size > maxTraces) traces.delete(traces.keys().next().value as string);\n    },\n    read(input: { traceId?: string; cursor?: string; limit: number }) {\n      const values = input.traceId\n        ? traces.has(input.traceId) ? [traces.get(input.traceId)!] : []\n        : [...traces.values()].reverse();\n      const offset = decodeCursor(input.cursor);\n      const limit = normalizePositiveInteger(input.limit, 100);\n      const page = values.slice(offset, offset + limit).map(cloneTrace);\n      const nextOffset = offset + page.length;\n      return {\n        traces: page,\n        ...(nextOffset < values.length ? { nextCursor: String(nextOffset) } : {}),\n      };\n    },\n    clear() {\n      traces.clear();\n    },\n  });\n}\n\nfunction summarize(value: unknown, maxCharacters: number): EditorCommandJsonObject {\n  let text: string;\n  try {\n    text = JSON.stringify(value === undefined ? null : value);\n  } catch {\n    text = '\"[unserializable]\"';\n  }\n  return {\n    preview: text.length > maxCharacters ? `${text.slice(0, maxCharacters)}…` : text,\n    characters: text.length,\n    truncated: text.length > maxCharacters,\n  };\n}\n\nfunction cloneDiagnostics(diagnostics: readonly EditorCommandDiagnostic[]): EditorCommandDiagnostic[] {\n  return diagnostics.map(diagnostic => structuredClone(diagnostic));\n}\n\nfunction cloneTrace(trace: EditorCommandTrace): EditorCommandTrace {\n  return structuredClone(trace);\n}\n\nfunction toTraceSource(source: string): EditorCommandTraceSource {\n  return source === 'agent-cli' ? 'agent' : 'editor';\n}\n\nfunction toTimestamp(value: number): string {\n  return new Date(Number.isFinite(value) ? value : 0).toISOString();\n}\n\nfunction decodeCursor(cursor: string | undefined): number {\n  if (cursor === undefined) return 0;\n  const value = Number(cursor);\n  if (!Number.isSafeInteger(value) || value < 0) throw new Error('Trace cursor is invalid.');\n  return value;\n}\n\nfunction normalizePositiveInteger(value: number | undefined, fallback: number): number {\n  return Number.isSafeInteger(value) && Number(value) > 0 ? Number(value) : fallback;\n}\n"]}

package/node_modules/@fps-games/editor-core/dist/editor-command-system.d.ts

@@ -0,0 +1,82 @@
+import { type EditorCommandAvailability, type EditorCommandCatalogSnapshot, type EditorCommandDiagnostic, type EditorCommandExecutionResult, type EditorCommandInvocation, type EditorCommandManifest, type EditorCommandOperationSnapshot } from '@fps-games/editor-protocol';
+export type EditorCommandMaybePromise<T> = T | Promise<T>;
+export interface EditorCommandHandlerContext extends EditorCommandInvocation {
+    readonly operationId: string;
+    readonly manifest: EditorCommandManifest;
+    readonly signal: AbortSignal;
+    /** Host-owned composed handlers use an already-admitted authoring transaction. */
+    readonly authorityTransaction?: 'isolated' | 'composed';
+    /** Opaque Host-issued access for the currently serialized external command handler. */
+    readonly authorityContext?: unknown;
+}
+export type EditorCommandHandlerOutcome<TOutput = unknown> = {
+    ok: true;
+    output: TOutput;
+    diagnostics?: readonly EditorCommandDiagnostic[];
+} | {
+    ok: false;
+    diagnostics: readonly EditorCommandDiagnostic[];
+};
+export interface EditorCommandRegistration<TInput = unknown, TOutput = unknown> {
+    readonly manifest: EditorCommandManifest;
+    readonly available?: () => EditorCommandMaybePromise<boolean | string | EditorCommandAvailability>;
+    readonly handler: (input: TInput, context: EditorCommandHandlerContext) => EditorCommandMaybePromise<EditorCommandHandlerOutcome<TOutput>>;
+    /** Command capability adapters may defer validation to their existing handler. */
+    readonly validateInput?: boolean;
+    /** Command capability adapters may return an capability result envelope. */
+    readonly validateOutput?: boolean;
+    /** External command adapter for handlers that still own their Session mutation path. */
+    readonly authorityTransaction?: 'isolated' | 'composed';
+}
+export interface EditorCommandExecutionInterceptorContext extends EditorCommandHandlerContext {
+}
+export type EditorCommandExecutionInterceptor = (context: EditorCommandExecutionInterceptorContext, execute: (authorityContext?: unknown) => Promise<EditorCommandHandlerOutcome<unknown>>) => Promise<EditorCommandHandlerOutcome<unknown>>;
+export interface EditorCommandCatalogQuery {
+    readonly text?: string;
+    readonly limit?: number;
+    readonly target?: EditorCommandManifest['target'];
+    readonly access?: EditorCommandManifest['access'];
+}
+export interface EditorCommandInvocationHandle<TOutput = unknown> {
+    readonly operationId: string;
+    readonly requestId: string;
+    readonly reused: boolean;
+    readonly completion: Promise<EditorCommandExecutionResult<TOutput>>;
+}
+export interface EditorCommandSystem {
+    readonly catalogRevision: number;
+    readonly executionAuthorityInstalled: boolean;
+    registerCommand<TInput = unknown, TOutput = unknown>(registration: EditorCommandRegistration<TInput, TOutput>): () => void;
+    /** Installs the process-local execution authority. Only one owner may be active. */
+    installExecutionInterceptor(interceptor: EditorCommandExecutionInterceptor, options?: {
+        scopeId?: string;
+    }): () => void;
+    listManifests(): EditorCommandManifest[];
+    getCatalog(query?: EditorCommandCatalogQuery): Promise<EditorCommandCatalogSnapshot>;
+    describeCommand(commandId: string): Promise<EditorCommandCatalogSnapshot['commands'][number] | null>;
+    invoke<TOutput = unknown>(invocation: EditorCommandInvocation): EditorCommandInvocationHandle<TOutput>;
+    execute<TOutput = unknown>(invocation: EditorCommandInvocation): Promise<EditorCommandExecutionResult<TOutput>>;
+    getOperation<TOutput = unknown>(operationId: string): EditorCommandOperationSnapshot<TOutput> | null;
+    cancelOperation(operationId: string): boolean;
+    dispose(): void;
+}
+/**
+ * Invocation/catalog surface exposed by an authoring Host. Registration and
+ * execution-authority ownership stay private to the Host.
+ */
+export type EditorCommandClient = Pick<EditorCommandSystem, 'catalogRevision' | 'executionAuthorityInstalled' | 'listManifests' | 'getCatalog' | 'describeCommand' | 'invoke' | 'execute' | 'getOperation' | 'cancelOperation'>;
+export interface CreateEditorCommandSystemOptions {
+    readonly now?: () => number;
+    readonly createOperationId?: () => string;
+    readonly maxRetainedOperations?: number;
+    readonly maxResultBytes?: number;
+    readonly onOperationSettled?: (event: EditorCommandOperationSettledEvent) => void;
+}
+export interface EditorCommandOperationSettledEvent {
+    readonly invocation: EditorCommandInvocation;
+    readonly manifest?: EditorCommandManifest;
+    readonly operation: EditorCommandExecutionResult<unknown>;
+}
+export declare function createEditorCommandSystem(options?: CreateEditorCommandSystemOptions): EditorCommandSystem;
+export declare function snapshotEditorCommandManifest(manifest: EditorCommandManifest): EditorCommandManifest;
+//# sourceMappingURL=editor-command-system.d.ts.map

package/node_modules/@fps-games/editor-core/dist/editor-command-system.d.ts.map

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