@graphysdk/viz-engine 0.0.1-plugins.6 → 0.0.1-plugins.8

package/dist/index.d.ts

@@ -1065,6 +1065,17 @@ export declare interface CommandApplyResult {
     readonly revert: Command;
 }
 
+/**
+ * Descriptor that knows how to deserialize a specific command type.
+ * Each concrete command co-locates its descriptor alongside the command class.
+ *
+ * Serialization is handled uniformly by the registry via `Command.params`.
+ */
+declare interface CommandDescriptor<TParams extends Record<string, unknown> = Record<string, unknown>> {
+    readonly type: string;
+    deserialize: (params: TParams, metadata: CommandMetadata) => Command;
+}
+
 /**
  * Unique identifier for commands.
  */
@@ -1084,6 +1095,33 @@ export declare interface CommandMetadata {
     readonly author: string;
 }
 
+/**
+ * Central registry mapping command types to their serialization descriptors.
+ */
+export declare class CommandRegistry {
+    private readonly descriptors;
+    /**
+     * Register a command descriptor. Throws if the type is already registered.
+     */
+    register<TParams extends Record<string, unknown>>(descriptor: CommandDescriptor<TParams>): void;
+    /**
+     * Serialize a command to its wire format.
+     */
+    serialize(command: Command): SerializedCommand;
+    /**
+     * Deserialize a command from its wire format.
+     */
+    deserialize(data: SerializedCommand): Command;
+    /**
+     * Get all registered command type names.
+     */
+    getRegisteredTypes(): string[];
+    private getDescriptor;
+}
+
+/** Default singleton registry instance. */
+export declare const commandRegistry: CommandRegistry;
+
 /**
  * Event types emitted by CommandStackManager.
  */
@@ -2200,6 +2238,18 @@ export declare const createAlphaValueReader: (data: Dataset, mapping: AesMapping
 
 export declare const createColorValueReader: (data: Dataset, mapping: AesMapping) => (observation: Observation) => DataValue;
 
+/**
+ * Create command metadata with defaults.
+ */
+export declare function createCommandMetadata(options: CreateCommandMetadataOptions): CommandMetadata;
+
+declare interface CreateCommandMetadataOptions {
+    id?: string;
+    timestamp?: number;
+    description: string;
+    author?: string;
+}
+
 /**
  * Builds a compiler instance. Pass `geoms` to register custom (or override built-in) geom
  * definitions per-instance — there is no global registry to mutate, so injected geoms never bleed