@vuer-ai/vuer-rtc 0.0.1

package/dist/operations/apply/vector3.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Vector3 operations: set, add, multiply
+ */
+import type { SceneGraph, Vector3SetOp, Vector3AddOp, Vector3MultiplyOp } from '../OperationTypes.js';
+import type { OpMeta } from './types.js';
+/**
+ * vector3.set - Last-Write-Wins
+ */
+export declare function Vector3Set(draft: SceneGraph, op: Vector3SetOp, meta: OpMeta): void;
+/**
+ * vector3.add - Component-wise addition (additive deltas)
+ */
+export declare function Vector3Add(draft: SceneGraph, op: Vector3AddOp, meta: OpMeta): void;
+/**
+ * vector3.multiply - Component-wise multiplication (scale)
+ */
+export declare function Vector3Multiply(draft: SceneGraph, op: Vector3MultiplyOp, meta: OpMeta): void;
+//# sourceMappingURL=vector3.d.ts.map

package/dist/operations/apply/vector3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.d.ts","sourceRoot":"","sources":["../../../src/operations/apply/vector3.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAKzC;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,MAAM,GACX,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,MAAM,GACX,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,iBAAiB,EACrB,IAAI,EAAE,MAAM,GACX,IAAI,CAUN"}

package/dist/operations/apply/vector3.js

@@ -0,0 +1,44 @@
+/**
+ * Vector3 operations: set, add, multiply
+ */
+import { getNodeProperty, setNodeProperty, setNodePropertyLWW } from './types.js';
+/**
+ * vector3.set - Last-Write-Wins
+ */
+export function Vector3Set(draft, op, meta) {
+    const node = draft.nodes[op.key];
+    if (!node || node.deletedAt)
+        return;
+    setNodePropertyLWW(node, op.path, [...op.value], meta);
+}
+/**
+ * vector3.add - Component-wise addition (additive deltas)
+ */
+export function Vector3Add(draft, op, meta) {
+    const node = draft.nodes[op.key];
+    if (!node || node.deletedAt)
+        return;
+    const current = getNodeProperty(node, op.path, [0, 0, 0]);
+    const result = [
+        current[0] + op.value[0],
+        current[1] + op.value[1],
+        current[2] + op.value[2],
+    ];
+    setNodeProperty(node, op.path, result, meta);
+}
+/**
+ * vector3.multiply - Component-wise multiplication (scale)
+ */
+export function Vector3Multiply(draft, op, meta) {
+    const node = draft.nodes[op.key];
+    if (!node || node.deletedAt)
+        return;
+    const current = getNodeProperty(node, op.path, [1, 1, 1]);
+    const result = [
+        current[0] * op.value[0],
+        current[1] * op.value[1],
+        current[2] * op.value[2],
+    ];
+    setNodeProperty(node, op.path, result, meta);
+}
+//# sourceMappingURL=vector3.js.map

package/dist/operations/apply/vector3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.js","sourceRoot":"","sources":["../../../src/operations/apply/vector3.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIlF;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,KAAiB,EACjB,EAAgB,EAChB,IAAY;IAEZ,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO;IACpC,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAY,EAAE,IAAI,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,KAAiB,EACjB,EAAgB,EAChB,IAAY;IAEZ,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO;IACpC,MAAM,OAAO,GAAG,eAAe,CAAU,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAY;QACtB,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACxB,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACxB,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;KACzB,CAAC;IACF,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAiB,EACjB,EAAqB,EACrB,IAAY;IAEZ,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO;IACpC,MAAM,OAAO,GAAG,eAAe,CAAU,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAY;QACtB,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACxB,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACxB,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;KACzB,CAAC;IACF,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/operations/dispatcher.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Operation Dispatcher
+ *
+ * Applies CRDTMessage operations to a SceneGraph using immer.
+ * Each operation is dispatched to its corresponding "apply" function.
+ */
+import type { SceneGraph, CRDTMessage, Operation } from './OperationTypes.js';
+import type { OpMeta } from './apply/types.js';
+/**
+ * Apply a single operation to a SceneGraph draft
+ */
+export declare function applyOperation(draft: SceneGraph, op: Operation, meta: OpMeta): void;
+/**
+ * Apply a CRDTMessage to a SceneGraph (immutable)
+ *
+ * Uses immer to produce a new state without mutating the original.
+ *
+ * @param graph - Current scene graph state
+ * @param msg - CRDT message containing operations
+ * @returns New scene graph state with operations applied
+ */
+export declare function applyMessage(graph: SceneGraph, msg: CRDTMessage): SceneGraph;
+/**
+ * Apply multiple CRDTMessages to a SceneGraph (immutable)
+ *
+ * @param graph - Current scene graph state
+ * @param messages - Array of CRDT messages to apply
+ * @returns New scene graph state with all operations applied
+ */
+export declare function applyMessages(graph: SceneGraph, messages: CRDTMessage[]): SceneGraph;
+/**
+ * Create an empty scene graph
+ */
+export declare function createEmptyGraph(): SceneGraph;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/operations/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/operations/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAsD/C;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,MAAM,GACX,IAAI,CAON;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,UAAU,CAa5E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,CAMpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAK7C"}

package/dist/operations/dispatcher.js

@@ -0,0 +1,107 @@
+/**
+ * Operation Dispatcher
+ *
+ * Applies CRDTMessage operations to a SceneGraph using immer.
+ * Each operation is dispatched to its corresponding "apply" function.
+ */
+import { produce, enableMapSet } from 'immer';
+import * as registry from './apply/index.js';
+// Enable immer support for Map and Set
+enableMapSet();
+/**
+ * Handler map: otype -> apply function
+ */
+const handlers = {
+    // Number operations
+    'number.set': registry.NumberSet,
+    'number.add': registry.NumberAdd,
+    'number.multiply': registry.NumberMultiply,
+    'number.min': registry.NumberMin,
+    'number.max': registry.NumberMax,
+    // String operations
+    'string.set': registry.StringSet,
+    'string.concat': registry.StringConcat,
+    // Boolean operations
+    'boolean.set': registry.BooleanSet,
+    'boolean.or': registry.BooleanOr,
+    'boolean.and': registry.BooleanAnd,
+    // Vector3 operations
+    'vector3.set': registry.Vector3Set,
+    'vector3.add': registry.Vector3Add,
+    'vector3.multiply': registry.Vector3Multiply,
+    // Quaternion operations
+    'quaternion.set': registry.QuaternionSet,
+    'quaternion.multiply': registry.QuaternionMultiply,
+    // Color operations
+    'color.set': registry.ColorSet,
+    'color.blend': registry.ColorBlend,
+    // Array operations
+    'array.set': registry.ArraySet,
+    'array.push': registry.ArrayPush,
+    'array.remove': registry.ArrayRemove,
+    'array.union': registry.ArrayUnion,
+    // Object operations
+    'object.set': registry.ObjectSet,
+    'object.merge': registry.ObjectMerge,
+    // Node operations
+    'node.insert': registry.NodeInsert,
+    'node.remove': registry.NodeRemove,
+};
+/**
+ * Apply a single operation to a SceneGraph draft
+ */
+export function applyOperation(draft, op, meta) {
+    const handler = handlers[op.otype];
+    if (handler) {
+        handler(draft, op, meta);
+    }
+    else {
+        console.warn(`Unknown otype: ${op.otype}`);
+    }
+}
+/**
+ * Apply a CRDTMessage to a SceneGraph (immutable)
+ *
+ * Uses immer to produce a new state without mutating the original.
+ *
+ * @param graph - Current scene graph state
+ * @param msg - CRDT message containing operations
+ * @returns New scene graph state with operations applied
+ */
+export function applyMessage(graph, msg) {
+    return produce(graph, (draft) => {
+        const meta = {
+            sessionId: msg.sessionId,
+            clock: msg.clock,
+            lamportTime: msg.lamportTime,
+            timestamp: msg.timestamp,
+        };
+        for (const op of msg.ops) {
+            applyOperation(draft, op, meta);
+        }
+    });
+}
+/**
+ * Apply multiple CRDTMessages to a SceneGraph (immutable)
+ *
+ * @param graph - Current scene graph state
+ * @param messages - Array of CRDT messages to apply
+ * @returns New scene graph state with all operations applied
+ */
+export function applyMessages(graph, messages) {
+    let current = graph;
+    for (const msg of messages) {
+        current = applyMessage(current, msg);
+    }
+    return current;
+}
+/**
+ * Create an empty scene graph
+ */
+export function createEmptyGraph() {
+    return {
+        nodes: {},
+        rootKey: '',
+    };
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/operations/dispatcher.js.map

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

package/dist/operations/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Operations module exports
+ */
+export type { CRDTMessage, BaseOp, NumberSetOp, NumberAddOp, NumberMultiplyOp, NumberMinOp, NumberMaxOp, StringSetOp, StringConcatOp, BooleanSetOp, BooleanOrOp, BooleanAndOp, Vector3SetOp, Vector3AddOp, Vector3MultiplyOp, QuaternionSetOp, QuaternionMultiplyOp, ColorSetOp, ColorBlendOp, ArraySetOp, ArrayPushOp, ArrayUnionOp, ArrayRemoveOp, ObjectSetOp, ObjectMergeOp, NodeInsertOp, NodeRemoveOp, MetaUndoOp, MetaRedoOp, Operation, SceneNode, SceneGraph, } from './OperationTypes.js';
+export { OperationValidator, type ValidationResult } from './OperationValidator.js';
+import * as registry from './apply/index.js';
+export { registry };
+export type { OpMeta, ApplyFn } from './apply/types.js';
+export { applyMessage, applyMessages, applyOperation, createEmptyGraph, } from './dispatcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,YAAY,EACV,WAAW,EACX,MAAM,EAEN,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,WAAW,EAEX,WAAW,EACX,cAAc,EAEd,YAAY,EACZ,WAAW,EACX,YAAY,EAEZ,YAAY,EACZ,YAAY,EACZ,iBAAiB,EAEjB,eAAe,EACf,oBAAoB,EAEpB,UAAU,EACV,YAAY,EAEZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EAEb,WAAW,EACX,aAAa,EAEb,YAAY,EACZ,YAAY,EAEZ,UAAU,EACV,UAAU,EAEV,SAAS,EAET,SAAS,EACT,UAAU,GACX,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAMpF,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAMxD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/operations/index.js

@@ -0,0 +1,17 @@
+/**
+ * Operations module exports
+ */
+// ============================================
+// Validation
+// ============================================
+export { OperationValidator } from './OperationValidator.js';
+// ============================================
+// Apply Registry (individual apply functions)
+// ============================================
+import * as registry from './apply/index.js';
+export { registry };
+// ============================================
+// Dispatcher (high-level API)
+// ============================================
+export { applyMessage, applyMessages, applyOperation, createEmptyGraph, } from './dispatcher.js';
+//# sourceMappingURL=index.js.map

package/dist/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqDH,+CAA+C;AAC/C,aAAa;AACb,+CAA+C;AAE/C,OAAO,EAAE,kBAAkB,EAAyB,MAAM,yBAAyB,CAAC;AAEpF,+CAA+C;AAC/C,8CAA8C;AAC9C,+CAA+C;AAE/C,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,CAAC;AAIpB,+CAA+C;AAC/C,8BAA8B;AAC9B,+CAA+C;AAE/C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/state/ConflictResolver.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ConflictResolver - Schema-based property conflict resolution
+ *
+ * Merges concurrent property updates based on:
+ * - Property schema (dtype + operation)
+ * - DType merge functions
+ */
+import { type ValueWithMeta } from './DType.js';
+export declare class ConflictResolver {
+    /**
+     * Merge a single property from multiple concurrent updates
+     *
+     * @param propertyName - Name of the property being merged
+     * @param values - Array of values with metadata
+     * @param operationHint - Optional operation override from UPDATE operation
+     * @returns Merged value
+     */
+    mergeProperty<T = any>(propertyName: string, values: ValueWithMeta<T>[], operationHint?: string): T;
+    /**
+     * Merge multiple properties from concurrent updates
+     *
+     * @param updates - Array of property updates with metadata and operation hints
+     * @returns Merged properties
+     */
+    mergeProperties(updates: Array<{
+        properties: Record<string, any>;
+        operations?: Record<string, string>;
+        lamportTime: number;
+        sessionId: string;
+    }>): Record<string, any>;
+    /**
+     * Get merge function for dtype and operation
+     */
+    private getMergeFunction;
+}
+//# sourceMappingURL=ConflictResolver.d.ts.map

package/dist/state/ConflictResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictResolver.d.ts","sourceRoot":"","sources":["../../src/state/ConflictResolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAS,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAGvD,qBAAa,gBAAgB;IAC3B;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,GAAG,GAAG,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,EAC1B,aAAa,CAAC,EAAE,MAAM,GACrB,CAAC;IAkCJ;;;;;OAKG;IACH,eAAe,CACb,OAAO,EAAE,KAAK,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,GACD,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAqCtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA6FzB"}

package/dist/state/ConflictResolver.js

@@ -0,0 +1,167 @@
+/**
+ * ConflictResolver - Schema-based property conflict resolution
+ *
+ * Merges concurrent property updates based on:
+ * - Property schema (dtype + operation)
+ * - DType merge functions
+ */
+import { DType } from './DType.js';
+import { getPropertySchema, isImmutable } from './Schema.js';
+export class ConflictResolver {
+    /**
+     * Merge a single property from multiple concurrent updates
+     *
+     * @param propertyName - Name of the property being merged
+     * @param values - Array of values with metadata
+     * @param operationHint - Optional operation override from UPDATE operation
+     * @returns Merged value
+     */
+    mergeProperty(propertyName, values, operationHint) {
+        if (values.length === 0) {
+            throw new Error(`Cannot merge empty values for property: ${propertyName}`);
+        }
+        if (values.length === 1) {
+            return values[0].value;
+        }
+        // Get schema for this property
+        const schema = getPropertySchema(propertyName);
+        // Immutable properties: return earliest value
+        if (isImmutable(propertyName)) {
+            const sorted = [...values].sort((a, b) => a.lamportTime - b.lamportTime);
+            return sorted[0].value;
+        }
+        // Use operation hint if provided, otherwise use schema
+        const operation = operationHint || schema.operation;
+        // Get merge function based on dtype and operation
+        const mergeFn = this.getMergeFunction(schema.dtype, operation);
+        if (!mergeFn) {
+            console.warn(`No merge function for dtype=${schema.dtype} operation=${operation}, defaulting to LWW`);
+            return DType.string.set(values);
+        }
+        return mergeFn(values);
+    }
+    /**
+     * Merge multiple properties from concurrent updates
+     *
+     * @param updates - Array of property updates with metadata and operation hints
+     * @returns Merged properties
+     */
+    mergeProperties(updates) {
+        // Group values by property name
+        const valuesByProperty = new Map();
+        const operationHints = new Map();
+        for (const update of updates) {
+            for (const [key, value] of Object.entries(update.properties)) {
+                if (key === 'operations')
+                    continue; // Skip operations field
+                if (!valuesByProperty.has(key)) {
+                    valuesByProperty.set(key, []);
+                }
+                valuesByProperty.get(key).push({
+                    value,
+                    lamportTime: update.lamportTime,
+                    sessionId: update.sessionId,
+                });
+                // Store operation hint if provided
+                if (update.operations?.[key]) {
+                    operationHints.set(key, update.operations[key]);
+                }
+            }
+        }
+        // Merge each property
+        const result = {};
+        for (const [propertyName, values] of valuesByProperty.entries()) {
+            const operationHint = operationHints.get(propertyName);
+            result[propertyName] = this.mergeProperty(propertyName, values, operationHint);
+        }
+        return result;
+    }
+    /**
+     * Get merge function for dtype and operation
+     */
+    getMergeFunction(dtype, operation) {
+        switch (dtype) {
+            case 'number':
+                switch (operation) {
+                    case 'set':
+                        return DType.number.set;
+                    case 'add':
+                        return DType.number.add;
+                    case 'multiply':
+                        return DType.number.multiply;
+                    case 'min':
+                        return DType.number.min;
+                    case 'max':
+                        return DType.number.max;
+                }
+                break;
+            case 'string':
+                switch (operation) {
+                    case 'set':
+                        return DType.string.set;
+                    case 'concat':
+                        return DType.string.concat;
+                }
+                break;
+            case 'boolean':
+                switch (operation) {
+                    case 'set':
+                        return DType.boolean.set;
+                    case 'or':
+                        return DType.boolean.or;
+                    case 'and':
+                        return DType.boolean.and;
+                }
+                break;
+            case 'vector3':
+                switch (operation) {
+                    case 'set':
+                        return DType.vector3.set;
+                    case 'add':
+                        return DType.vector3.add;
+                    case 'multiply':
+                        return DType.vector3.multiply;
+                }
+                break;
+            case 'quaternion':
+                switch (operation) {
+                    case 'set':
+                        return DType.quaternion.set;
+                    case 'multiply':
+                        return DType.quaternion.multiply;
+                }
+                break;
+            case 'color':
+                switch (operation) {
+                    case 'set':
+                        return DType.color.set;
+                    case 'blend':
+                        return DType.color.blend;
+                }
+                break;
+            case 'array':
+                switch (operation) {
+                    case 'set':
+                        return DType.array.set;
+                    case 'union':
+                        return DType.array.union;
+                    case 'append':
+                        return DType.array.append;
+                }
+                break;
+            case 'object':
+                switch (operation) {
+                    case 'set':
+                        return DType.object.set;
+                    case 'lww-per-key':
+                        return DType.object.lwwPerKey;
+                }
+                break;
+            case 'any':
+                // Default to LWW for 'any' type
+                return DType.string.set;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=ConflictResolver.js.map

package/dist/state/ConflictResolver.js.map

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

package/dist/state/DType.d.ts

@@ -0,0 +1,160 @@
+/**
+ * DType - Data type system with merge operations
+ *
+ * Based on test-data/datatypes.ts
+ *
+ * Each dtype has supported operations that define merge behavior
+ * for concurrent updates.
+ */
+/**
+ * PropertyValue with metadata
+ */
+export interface ValueWithMeta<T = any> {
+    value: T;
+    lamportTime: number;
+    sessionId?: string;
+}
+/**
+ * Merge function signature
+ */
+export type MergeFn<T = any> = (values: ValueWithMeta<T>[]) => T;
+/**
+ * DType definitions
+ */
+export declare const DType: {
+    /**
+     * Number operations
+     */
+    number: {
+        /**
+         * SET - Last-Write-Wins
+         */
+        set: MergeFn<number>;
+        /**
+         * ADD - Sum all values
+         */
+        add: MergeFn<number>;
+        /**
+         * MULTIPLY - Multiply all values
+         */
+        multiply: MergeFn<number>;
+        /**
+         * MIN - Take minimum
+         */
+        min: MergeFn<number>;
+        /**
+         * MAX - Take maximum
+         */
+        max: MergeFn<number>;
+    };
+    /**
+     * String operations
+     */
+    string: {
+        /**
+         * SET - Last-Write-Wins
+         */
+        set: MergeFn<string>;
+        /**
+         * CONCAT - Concatenate (ordered by lamport)
+         */
+        concat: MergeFn<string>;
+    };
+    /**
+     * Boolean operations
+     */
+    boolean: {
+        /**
+         * SET - Last-Write-Wins
+         */
+        set: MergeFn<boolean>;
+        /**
+         * OR - Logical OR (enable wins)
+         */
+        or: MergeFn<boolean>;
+        /**
+         * AND - Logical AND (disable wins)
+         */
+        and: MergeFn<boolean>;
+    };
+    /**
+     * Vector3 operations - [x, y, z]
+     */
+    vector3: {
+        /**
+         * SET - Replace entire vector (preserves user intent)
+         */
+        set: MergeFn<[number, number, number]>;
+        /**
+         * ADD - Component-wise addition
+         */
+        add: MergeFn<[number, number, number]>;
+        /**
+         * MULTIPLY - Component-wise multiplication
+         */
+        multiply: MergeFn<[number, number, number]>;
+    };
+    /**
+     * Quaternion operations - [x, y, z, w]
+     */
+    quaternion: {
+        /**
+         * SET - Replace entire quaternion
+         */
+        set: MergeFn<[number, number, number, number]>;
+        /**
+         * MULTIPLY - Quaternion multiplication (composition)
+         */
+        multiply: MergeFn<[number, number, number, number]>;
+    };
+    /**
+     * Color operations
+     */
+    color: {
+        /**
+         * SET - Replace color
+         */
+        set: MergeFn<string>;
+        /**
+         * BLEND - Average colors
+         */
+        blend: MergeFn<string>;
+    };
+    /**
+     * Array operations
+     */
+    array: {
+        /**
+         * SET - Replace entire array
+         */
+        set: MergeFn<any[]>;
+        /**
+         * UNION - Merge unique elements
+         */
+        union: MergeFn<any[]>;
+        /**
+         * APPEND - Append all (ordered by lamport)
+         */
+        append: MergeFn<any[]>;
+    };
+    /**
+     * Object operations
+     */
+    object: {
+        /**
+         * SET - Replace entire object
+         */
+        set: MergeFn<Record<string, any>>;
+        /**
+         * LWW_PER_KEY - Last-Write-Wins per key
+         */
+        lwwPerKey: MergeFn<Record<string, any>>;
+    };
+    /**
+     * Immutable - Cannot be changed
+     */
+    immutable: {
+        set: MergeFn;
+    };
+};
+//# sourceMappingURL=DType.d.ts.map

package/dist/state/DType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DType.d.ts","sourceRoot":"","sources":["../../src/state/DType.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,KAAK;IAKhB;;OAEG;;QAED;;WAEG;aAIG,OAAO,CAAC,MAAM,CAAC;QAErB;;WAEG;aAGG,OAAO,CAAC,MAAM,CAAC;QAErB;;WAEG;kBAGG,OAAO,CAAC,MAAM,CAAC;QAErB;;WAEG;aAGG,OAAO,CAAC,MAAM,CAAC;QAErB;;WAEG;aAGG,OAAO,CAAC,MAAM,CAAC;;IAGvB;;OAEG;;QAED;;WAEG;aAIG,OAAO,CAAC,MAAM,CAAC;QAErB;;WAEG;gBAIG,OAAO,CAAC,MAAM,CAAC;;IAGvB;;OAEG;;QAED;;WAEG;aAIG,OAAO,CAAC,OAAO,CAAC;QAEtB;;WAEG;YAGG,OAAO,CAAC,OAAO,CAAC;QAEtB;;WAEG;aAGG,OAAO,CAAC,OAAO,CAAC;;IAOxB;;OAEG;;QAED;;WAEG;aAIG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAEvC;;WAEG;aASG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAEvC;;WAEG;kBASG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;;IAGzC;;OAEG;;QAED;;WAEG;aAIG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAE/C;;WAEG;kBAUG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;;IAGjD;;OAEG;;QAED;;WAEG;aAIG,OAAO,CAAC,MAAM,CAAC;QAErB;;WAEG;eAOG,OAAO,CAAC,MAAM,CAAC;;IAOvB;;OAEG;;QAED;;WAEG;aAIG,OAAO,CAAC,GAAG,EAAE,CAAC;QAEpB;;WAEG;eAIG,OAAO,CAAC,GAAG,EAAE,CAAC;QAEpB;;WAEG;gBAIG,OAAO,CAAC,GAAG,EAAE,CAAC;;IAGtB;;OAEG;;QAED;;WAEG;aAIG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAElC;;WAEG;mBAeG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;;IAOpC;;OAEG;;aAMK,OAAO;;CAEhB,CAAC"}