Operations

interface BaseOp {
  otype: string;        // Operation type: "dtype.verb"
  key?: string;         // Target node key ("." = root, default)
  path?: string;        // Property path on the node ("." = node root)
  value?: unknown;      // Value to apply (type depends on otype)
  // Additional flat fields per operation type:
  // index, from, to, alpha, separator, toPath, etc.
}

// Set position
{ otype: 'vector3.set', key: 'player-1', path: 'position', value: [1, 2, 3] }

// Blend color with alpha
{ otype: 'color.blend', key: 'sky', path: 'color', value: '#00ff00', alpha: 0.5 }

// Move array item
{ otype: 'array.move', key: 'item', path: 'tags', from: 0, to: 2 }

// Move node to new parent (flat)
{ otype: 'node.move', key: 'cube-1', to: 'group-1', toPath: 'children' }

// Node insert (nested value for node data)
{ otype: 'node.insert', key: '.', path: 'children', value: { key: 'cube-1', tag: 'Mesh' } }

"Hello World" → move [0:5] to index 6  → " WorldHello"
"Hello World" → move [0:5] to index -1 → " WorldHello"

["a", "b", "c", "d"] → move index 0 to index 2  → ["b", "c", "a", "d"]
["a", "b", "c", "d"] → move index 0 to index -2 → ["b", "c", "a", "d"]

interface CRDTMessage {
  id: string;           // Unique message ID
  sessionId: string;    // Client session ID
  clock: VectorClock;   // Vector clock for causality
  lamportTime: number;  // Lamport time for total ordering
  timestamp: number;    // Wall-clock time
  ops: Operation[];     // Batch of operations
}

// Intrinsic YXZ rotation (common for cameras/FPS)
{ otype: 'vector3.applyEuler', key: 'camera', path: 'direction', value: [pitch, yaw, roll], order: 'YXZ' }

// Extrinsic XYZ rotation (fixed-axis)
{ otype: 'vector3.applyEuler', key: 'arm', path: 'direction', value: [x, y, z], intrinsic: false }