@jxsuite/studio 2.2.2 → 2.3.0

package/dist/chunks/studio-5ehhackm.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../collab/src/ops.ts"],
-  "sourcesContent": [
-    "/**\n * The canonical Jx document-op vocabulary and its pure applier. A `JxDocOp` is a value-carrying,\n * replayable mutation of a plain-JSON Jx document tree, addressed by `JxPath` (alternating\n * \"children\" / index segments for structure, plus node keys). Studio's transaction pipeline records\n * forward/inverse pairs of these for history replay; the collab bridge mirrors them into a shared\n * Y.Doc.\n *\n * This module is deliberately yjs-free and dependency-light: the slim canvas-iframe bundle imports\n * the applier for its non-reactive shadow doc, and it MUST stay byte-identical in behavior to the\n * parent's history replay — both sides import this one implementation.\n */\n\nimport type { JxMutableNode, JxPath } from \"@jxsuite/schema/types\";\n\n/** Value-carrying document mutation, replayable in either direction. */\nexport type JxDocOp =\n  /** Set (or delete, when value is undefined) a key on the node at path. */\n  | { op: \"set-key\"; path: JxPath; key: string; value?: unknown }\n  /** Insert a node at parentPath.children[index]. */\n  | { op: \"insert-child\"; parentPath: JxPath; index: number; node: unknown }\n  /** Remove parentPath.children[index]. */\n  | { op: \"remove-child\"; parentPath: JxPath; index: number }\n  /** Replace parentPath.children[index] with node. */\n  | { op: \"set-child\"; parentPath: JxPath; index: number; node: unknown }\n  /** Raw two-splice move: remove fromParent.children[fromIndex], insert at toParent[toIndex]. */\n  | {\n      op: \"move-child\";\n      fromParentPath: JxPath;\n      fromIndex: number;\n      toParentPath: JxPath;\n      toIndex: number;\n    };\n\nexport interface JxDocOpPair {\n  forward: JxDocOp;\n  inverse: JxDocOp;\n}\n\n/** JSON round-trip clone — also normalizes away reactive proxies / functions / undefined. */\nfunction jsonClone<T>(value: T): T {\n  // oxlint-disable-next-line unicorn/prefer-structured-clone -- structuredClone throws on reactive proxies; JSON normalization is the point\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\n/** Deep-clone a recorded value (undefined/null pass through; reactive proxies are read through). */\nexport function cloneValue<T>(v: T): T {\n  return v === undefined || v === null ? v : (jsonClone(v as object) as T);\n}\n\n/**\n * Walk a plain document tree by path. Paths address nodes by construction; missing segments and\n * non-node leaves surface as undefined (typed as node for caller ergonomics, matching Studio's\n * historical helper).\n */\nexport function getNodeAtPath(doc: JxMutableNode, path: JxPath): JxMutableNode {\n  let node = doc;\n  for (const key of path) {\n    if (node == null) {\n      return undefined as unknown as JxMutableNode;\n    }\n    node = node[key] as JxMutableNode;\n  }\n  return node;\n}\n\n/** The node's children array, lazily created; throws if `node` is itself a children array or mapped. */\nexport function childArray(node: JxMutableNode): (JxMutableNode | string)[] {\n  // Defense-in-depth: a path that resolves to a children array (rather than a node) would\n  // Otherwise get a bogus `.children` property tacked on here, silently storing the insert where\n  // Nothing renders. Callers must pass a node; fail loudly if they don't.\n  if (Array.isArray(node)) {\n    throw new TypeError(\"Cannot insert into a children array; parentPath must point at a node\");\n  }\n  if (!node.children) {\n    node.children = [];\n  }\n  if (!Array.isArray(node.children)) {\n    throw new TypeError(\"Cannot insert into mapped-array children; edit the map template instead\");\n  }\n  return node.children;\n}\n\n/**\n * Apply a replayable doc op to a bare document tree. Values/nodes are cloned in, so the tree never\n * aliases the op object. Throws (with a machine-readable reason) when a target path is missing.\n */\nexport function applyDocOpToDoc(doc: JxMutableNode, op: JxDocOp): void {\n  switch (op.op) {\n    case \"set-key\": {\n      const node = getNodeAtPath(doc, op.path);\n      if (!node) {\n        throw new Error(`doc-op-node-not-found:${op.path.join(\"/\")}`);\n      }\n      const target = node as Record<string, unknown>;\n      if (op.value === undefined) {\n        delete target[op.key];\n      } else {\n        target[op.key] = cloneValue(op.value);\n      }\n      return;\n    }\n    case \"insert-child\": {\n      const parent = getNodeAtPath(doc, op.parentPath);\n      childArray(parent).splice(op.index, 0, cloneValue(op.node) as JxMutableNode);\n      return;\n    }\n    case \"remove-child\": {\n      const parent = getNodeAtPath(doc, op.parentPath);\n      childArray(parent).splice(op.index, 1);\n      return;\n    }\n    case \"set-child\": {\n      const parent = getNodeAtPath(doc, op.parentPath);\n      childArray(parent).splice(op.index, 1, cloneValue(op.node) as JxMutableNode);\n      return;\n    }\n    case \"move-child\": {\n      const fromParent = getNodeAtPath(doc, op.fromParentPath);\n      const toParent = getNodeAtPath(doc, op.toParentPath);\n      const [node] = childArray(fromParent).splice(op.fromIndex, 1);\n      childArray(toParent).splice(op.toIndex, 0, node!);\n      return;\n    }\n    default: {\n      throw new Error(`unknown-doc-op:${(op as JxDocOp).op}`);\n    }\n  }\n}\n"
-  ],
-  "mappings": ";AAuCA,SAAS,SAAY,CAAC,OAAa;AAAA,EAEjC,OAAO,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AAAA;AAIlC,SAAS,UAAa,CAAC,GAAS;AAAA,EACrC,OAAO,MAAM,aAAa,MAAM,OAAO,IAAK,UAAU,CAAW;AAAA;AAQ5D,SAAS,aAAa,CAAC,KAAoB,MAA6B;AAAA,EAC7E,IAAI,OAAO;AAAA,EACX,WAAW,OAAO,MAAM;AAAA,IACtB,IAAI,QAAQ,MAAM;AAAA,MAChB;AAAA,IACF;AAAA,IACA,OAAO,KAAK;AAAA,EACd;AAAA,EACA,OAAO;AAAA;AAIF,SAAS,UAAU,CAAC,MAAiD;AAAA,EAI1E,IAAI,MAAM,QAAQ,IAAI,GAAG;AAAA,IACvB,MAAM,IAAI,UAAU,sEAAsE;AAAA,EAC5F;AAAA,EACA,IAAI,CAAC,KAAK,UAAU;AAAA,IAClB,KAAK,WAAW,CAAC;AAAA,EACnB;AAAA,EACA,IAAI,CAAC,MAAM,QAAQ,KAAK,QAAQ,GAAG;AAAA,IACjC,MAAM,IAAI,UAAU,yEAAyE;AAAA,EAC/F;AAAA,EACA,OAAO,KAAK;AAAA;AAOP,SAAS,eAAe,CAAC,KAAoB,IAAmB;AAAA,EACrE,QAAQ,GAAG;AAAA,SACJ,WAAW;AAAA,MACd,MAAM,OAAO,cAAc,KAAK,GAAG,IAAI;AAAA,MACvC,IAAI,CAAC,MAAM;AAAA,QACT,MAAM,IAAI,MAAM,yBAAyB,GAAG,KAAK,KAAK,GAAG,GAAG;AAAA,MAC9D;AAAA,MACA,MAAM,SAAS;AAAA,MACf,IAAI,GAAG,UAAU,WAAW;AAAA,QAC1B,OAAO,OAAO,GAAG;AAAA,MACnB,EAAO;AAAA,QACL,OAAO,GAAG,OAAO,WAAW,GAAG,KAAK;AAAA;AAAA,MAEtC;AAAA,IACF;AAAA,SACK,gBAAgB;AAAA,MACnB,MAAM,SAAS,cAAc,KAAK,GAAG,UAAU;AAAA,MAC/C,WAAW,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,IAAI,CAAkB;AAAA,MAC3E;AAAA,IACF;AAAA,SACK,gBAAgB;AAAA,MACnB,MAAM,SAAS,cAAc,KAAK,GAAG,UAAU;AAAA,MAC/C,WAAW,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;AAAA,MACrC;AAAA,IACF;AAAA,SACK,aAAa;AAAA,MAChB,MAAM,SAAS,cAAc,KAAK,GAAG,UAAU;AAAA,MAC/C,WAAW,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,IAAI,CAAkB;AAAA,MAC3E;AAAA,IACF;AAAA,SACK,cAAc;AAAA,MACjB,MAAM,aAAa,cAAc,KAAK,GAAG,cAAc;AAAA,MACvD,MAAM,WAAW,cAAc,KAAK,GAAG,YAAY;AAAA,MACnD,OAAO,QAAQ,WAAW,UAAU,EAAE,OAAO,GAAG,WAAW,CAAC;AAAA,MAC5D,WAAW,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,IAAK;AAAA,MAChD;AAAA,IACF;AAAA,aACS;AAAA,MACP,MAAM,IAAI,MAAM,kBAAmB,GAAe,IAAI;AAAA,IACxD;AAAA;AAAA;",
-  "debugId": "5D133C2831531A7564756E2164756E21",
-  "names": []
-}