@aigne/afs-ui 1.11.0-beta.12

package/dist/aup-protocol.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aup-protocol.mjs","names":[],"sources":["../src/aup-protocol.ts"],"sourcesContent":["/**\n * AUP Protocol — Server-side node store and patch engine.\n *\n * Maintains the current AUP node tree for a session.\n * Validates and applies patches atomically.\n */\n\nimport type { AUPNode, AUPPatchOp } from \"./aup-types.js\";\nimport { validateNode, validatePatchOp } from \"./aup-types.js\";\n\nexport interface AUPRenderOptions {\n  fullPage?: boolean;\n  chrome?: boolean;\n  theme?: string;\n  style?: string;\n  locale?: string;\n}\n\nexport class AUPNodeStore {\n  private root: AUPNode | null = null;\n  /** Flat index: id → node + parent reference for O(1) lookup */\n  private index = new Map<string, { node: AUPNode; parent: AUPNode | null }>();\n  /** Monotonic version counter — increments on every render or patch. */\n  private _version = 0;\n  /** Render options from the last aup_render call. */\n  private _renderOptions: AUPRenderOptions = {};\n\n  /** Current tree version (monotonically increasing). */\n  get version(): number {\n    return this._version;\n  }\n\n  /** Last render options (fullPage, style, chrome, etc.). */\n  get renderOptions(): AUPRenderOptions {\n    return this._renderOptions;\n  }\n\n  /** Save render options alongside the tree. */\n  setRenderOptions(opts: AUPRenderOptions): void {\n    this._renderOptions = opts;\n  }\n\n  /** Get the current root node (or null if no graph is active). */\n  getRoot(): AUPNode | null {\n    return this.root;\n  }\n\n  /** Find a node by id. */\n  findNode(id: string): AUPNode | undefined {\n    return this.index.get(id)?.node;\n  }\n\n  /** Set the full node tree (replaces any existing graph). */\n  setRoot(root: AUPNode): void {\n    const err = validateNode(root);\n    if (err) throw new Error(`Invalid AUP node: ${err}`);\n    this.root = root;\n    this._version++;\n    this.rebuildIndex();\n  }\n\n  /** Clear the graph. */\n  clear(): void {\n    this.root = null;\n    this.index.clear();\n    this._version++;\n  }\n\n  /**\n   * Apply a batch of patch operations atomically.\n   * If any op fails validation, the entire batch is rejected.\n   */\n  applyPatch(ops: AUPPatchOp[]): void {\n    if (!this.root) throw new Error(\"No active AUP graph — call aup_render first\");\n\n    // Validate all ops first\n    for (const op of ops) {\n      const err = validatePatchOp(op);\n      if (err) throw new Error(`Invalid patch op: ${err}`);\n    }\n\n    // Snapshot for rollback\n    const snapshot = JSON.parse(JSON.stringify(this.root)) as AUPNode;\n    const snapshotIndex = new Map(this.index);\n\n    try {\n      for (const op of ops) {\n        this.applyOneOp(op);\n      }\n      this._version++;\n    } catch (e) {\n      // Rollback\n      this.root = snapshot;\n      this.index = snapshotIndex;\n      this.rebuildIndex();\n      throw e;\n    }\n  }\n\n  // ── Internal ──\n\n  private applyOneOp(op: AUPPatchOp): void {\n    switch (op.op) {\n      case \"create\":\n        this.opCreate(op);\n        break;\n      case \"update\":\n        this.opUpdate(op);\n        break;\n      case \"remove\":\n        this.opRemove(op);\n        break;\n      case \"reorder\":\n        this.opReorder(op);\n        break;\n    }\n  }\n\n  private opCreate(op: { id: string; parentId: string; node: AUPNode; index?: number }): void {\n    if (this.index.has(op.id)) throw new Error(`Node already exists: ${op.id}`);\n\n    const parentEntry = this.index.get(op.parentId);\n    if (!parentEntry) throw new Error(`Parent node not found: ${op.parentId}`);\n    const parent = parentEntry.node;\n\n    if (!parent.children) parent.children = [];\n\n    const node = { ...op.node, id: op.id };\n    const err = validateNode(node);\n    if (err) throw new Error(`Invalid node in create: ${err}`);\n\n    if (op.index !== undefined) {\n      if (op.index < 0 || op.index > parent.children.length) {\n        throw new Error(`Index out of bounds: ${op.index}`);\n      }\n      parent.children.splice(op.index, 0, node);\n    } else {\n      parent.children.push(node);\n    }\n\n    this.indexNode(node, parent);\n  }\n\n  private opUpdate(op: {\n    id: string;\n    props?: Record<string, unknown>;\n    state?: Record<string, unknown>;\n    events?: Record<string, unknown>;\n  }): void {\n    const entry = this.index.get(op.id);\n    if (!entry) throw new Error(`Node not found: ${op.id}`);\n    const node = entry.node;\n\n    if (op.props && Object.keys(op.props).length > 0) {\n      node.props = { ...(node.props ?? {}), ...op.props };\n    }\n    if (op.state && Object.keys(op.state).length > 0) {\n      node.state = { ...(node.state ?? {}), ...op.state };\n    }\n    if (op.events !== undefined) {\n      node.events = op.events as AUPNode[\"events\"];\n    }\n  }\n\n  private opRemove(op: { id: string }): void {\n    // Removing root clears the entire graph\n    if (this.root && op.id === this.root.id) {\n      this.clear();\n      return;\n    }\n\n    const entry = this.index.get(op.id);\n    if (!entry) throw new Error(`Node not found: ${op.id}`);\n    const parent = entry.parent;\n    if (!parent || !parent.children) throw new Error(`Cannot remove node: no parent`);\n\n    const idx = parent.children.findIndex((c) => c.id === op.id);\n    if (idx < 0) throw new Error(`Node not found in parent's children: ${op.id}`);\n\n    // Remove from parent\n    const [removed] = parent.children.splice(idx, 1);\n\n    // Unindex the removed subtree\n    this.unindexNode(removed!);\n  }\n\n  private opReorder(op: { id: string; parentId: string; index: number }): void {\n    const entry = this.index.get(op.id);\n    if (!entry) throw new Error(`Node not found: ${op.id}`);\n\n    const parentEntry = this.index.get(op.parentId);\n    if (!parentEntry) throw new Error(`Parent node not found: ${op.parentId}`);\n    const parent = parentEntry.node;\n\n    if (!parent.children) throw new Error(`Parent has no children`);\n\n    const currentIdx = parent.children.findIndex((c) => c.id === op.id);\n    if (currentIdx < 0) throw new Error(`Node not in specified parent: ${op.id}`);\n\n    if (op.index < 0 || op.index >= parent.children.length) {\n      throw new Error(`Reorder index out of bounds: ${op.index}`);\n    }\n\n    // Remove and re-insert\n    const [node] = parent.children.splice(currentIdx, 1);\n    parent.children.splice(op.index, 0, node!);\n  }\n\n  private rebuildIndex(): void {\n    this.index.clear();\n    if (this.root) {\n      this.indexNode(this.root, null);\n    }\n  }\n\n  private indexNode(node: AUPNode, parent: AUPNode | null): void {\n    this.index.set(node.id, { node, parent });\n    if (node.children) {\n      for (const child of node.children) {\n        this.indexNode(child, node);\n      }\n    }\n  }\n\n  private unindexNode(node: AUPNode): void {\n    this.index.delete(node.id);\n    if (node.children) {\n      for (const child of node.children) {\n        this.unindexNode(child);\n      }\n    }\n  }\n}\n\n// ── Scene Manager (Preview/Program dual buffer) ──\n\nexport class AUPSceneManager {\n  private scenes = new Map<string, AUPNodeStore>();\n  private accessOrder: string[] = []; // LRU tracking (oldest first)\n  private _activeSceneId: string | null = null;\n  private maxScenes: number;\n\n  constructor(opts?: { maxScenes?: number }) {\n    this.maxScenes = opts?.maxScenes ?? 3;\n  }\n\n  get activeSceneId(): string | null {\n    return this._activeSceneId;\n  }\n\n  /** Stage a scene (pre-render). Creates or updates the scene's store. */\n  stage(sceneId: string, root: AUPNode, opts?: AUPRenderOptions): AUPNodeStore {\n    let store = this.scenes.get(sceneId);\n    if (!store) {\n      store = new AUPNodeStore();\n      this.scenes.set(sceneId, store);\n    }\n    store.setRoot(root);\n    if (opts) store.setRenderOptions(opts);\n    this.touch(sceneId);\n    this.evictIfNeeded();\n    return store;\n  }\n\n  /** Take a staged scene live. */\n  take(sceneId: string): AUPNodeStore {\n    const store = this.scenes.get(sceneId);\n    if (!store) throw new Error(`Scene not found/not staged: ${sceneId}`);\n    this._activeSceneId = sceneId;\n    this.touch(sceneId);\n    return store;\n  }\n\n  /** Release a scene's resources. Cannot release the active scene. */\n  release(sceneId: string): void {\n    if (this._activeSceneId === sceneId) {\n      throw new Error(`Cannot release active/live scene: ${sceneId}`);\n    }\n    this.scenes.delete(sceneId);\n    this.accessOrder = this.accessOrder.filter((id) => id !== sceneId);\n  }\n\n  /** Get a scene's store by ID. */\n  getScene(sceneId: string): AUPNodeStore | undefined {\n    return this.scenes.get(sceneId);\n  }\n\n  /** Get the active (live) scene. */\n  getActiveScene(): { sceneId: string; store: AUPNodeStore } | null {\n    if (!this._activeSceneId) return null;\n    const store = this.scenes.get(this._activeSceneId);\n    if (!store) return null;\n    return { sceneId: this._activeSceneId, store };\n  }\n\n  /** Apply patches to a staged scene. */\n  applyPatch(sceneId: string, ops: AUPPatchOp[]): void {\n    const store = this.scenes.get(sceneId);\n    if (!store) throw new Error(`Scene not found: ${sceneId}`);\n    store.applyPatch(ops);\n    this.touch(sceneId);\n  }\n\n  /** Touch LRU — move sceneId to end (most recent). */\n  private touch(sceneId: string): void {\n    this.accessOrder = this.accessOrder.filter((id) => id !== sceneId);\n    this.accessOrder.push(sceneId);\n  }\n\n  /** Evict oldest non-active scenes if over limit. */\n  private evictIfNeeded(): void {\n    while (this.scenes.size > this.maxScenes) {\n      const victim = this.accessOrder.find(\n        (id) => id !== this._activeSceneId && this.scenes.has(id),\n      );\n      if (!victim) break; // all remaining are active — can't evict\n      this.scenes.delete(victim);\n      this.accessOrder = this.accessOrder.filter((id) => id !== victim);\n    }\n  }\n}\n"],"mappings":";;;AAkBA,IAAa,eAAb,MAA0B;CACxB,AAAQ,OAAuB;;CAE/B,AAAQ,wBAAQ,IAAI,KAAwD;;CAE5E,AAAQ,WAAW;;CAEnB,AAAQ,iBAAmC,EAAE;;CAG7C,IAAI,UAAkB;AACpB,SAAO,KAAK;;;CAId,IAAI,gBAAkC;AACpC,SAAO,KAAK;;;CAId,iBAAiB,MAA8B;AAC7C,OAAK,iBAAiB;;;CAIxB,UAA0B;AACxB,SAAO,KAAK;;;CAId,SAAS,IAAiC;AACxC,SAAO,KAAK,MAAM,IAAI,GAAG,EAAE;;;CAI7B,QAAQ,MAAqB;EAC3B,MAAM,MAAM,aAAa,KAAK;AAC9B,MAAI,IAAK,OAAM,IAAI,MAAM,qBAAqB,MAAM;AACpD,OAAK,OAAO;AACZ,OAAK;AACL,OAAK,cAAc;;;CAIrB,QAAc;AACZ,OAAK,OAAO;AACZ,OAAK,MAAM,OAAO;AAClB,OAAK;;;;;;CAOP,WAAW,KAAyB;AAClC,MAAI,CAAC,KAAK,KAAM,OAAM,IAAI,MAAM,8CAA8C;AAG9E,OAAK,MAAM,MAAM,KAAK;GACpB,MAAM,MAAM,gBAAgB,GAAG;AAC/B,OAAI,IAAK,OAAM,IAAI,MAAM,qBAAqB,MAAM;;EAItD,MAAM,WAAW,KAAK,MAAM,KAAK,UAAU,KAAK,KAAK,CAAC;EACtD,MAAM,gBAAgB,IAAI,IAAI,KAAK,MAAM;AAEzC,MAAI;AACF,QAAK,MAAM,MAAM,IACf,MAAK,WAAW,GAAG;AAErB,QAAK;WACE,GAAG;AAEV,QAAK,OAAO;AACZ,QAAK,QAAQ;AACb,QAAK,cAAc;AACnB,SAAM;;;CAMV,AAAQ,WAAW,IAAsB;AACvC,UAAQ,GAAG,IAAX;GACE,KAAK;AACH,SAAK,SAAS,GAAG;AACjB;GACF,KAAK;AACH,SAAK,SAAS,GAAG;AACjB;GACF,KAAK;AACH,SAAK,SAAS,GAAG;AACjB;GACF,KAAK;AACH,SAAK,UAAU,GAAG;AAClB;;;CAIN,AAAQ,SAAS,IAA2E;AAC1F,MAAI,KAAK,MAAM,IAAI,GAAG,GAAG,CAAE,OAAM,IAAI,MAAM,wBAAwB,GAAG,KAAK;EAE3E,MAAM,cAAc,KAAK,MAAM,IAAI,GAAG,SAAS;AAC/C,MAAI,CAAC,YAAa,OAAM,IAAI,MAAM,0BAA0B,GAAG,WAAW;EAC1E,MAAM,SAAS,YAAY;AAE3B,MAAI,CAAC,OAAO,SAAU,QAAO,WAAW,EAAE;EAE1C,MAAM,OAAO;GAAE,GAAG,GAAG;GAAM,IAAI,GAAG;GAAI;EACtC,MAAM,MAAM,aAAa,KAAK;AAC9B,MAAI,IAAK,OAAM,IAAI,MAAM,2BAA2B,MAAM;AAE1D,MAAI,GAAG,UAAU,QAAW;AAC1B,OAAI,GAAG,QAAQ,KAAK,GAAG,QAAQ,OAAO,SAAS,OAC7C,OAAM,IAAI,MAAM,wBAAwB,GAAG,QAAQ;AAErD,UAAO,SAAS,OAAO,GAAG,OAAO,GAAG,KAAK;QAEzC,QAAO,SAAS,KAAK,KAAK;AAG5B,OAAK,UAAU,MAAM,OAAO;;CAG9B,AAAQ,SAAS,IAKR;EACP,MAAM,QAAQ,KAAK,MAAM,IAAI,GAAG,GAAG;AACnC,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,mBAAmB,GAAG,KAAK;EACvD,MAAM,OAAO,MAAM;AAEnB,MAAI,GAAG,SAAS,OAAO,KAAK,GAAG,MAAM,CAAC,SAAS,EAC7C,MAAK,QAAQ;GAAE,GAAI,KAAK,SAAS,EAAE;GAAG,GAAG,GAAG;GAAO;AAErD,MAAI,GAAG,SAAS,OAAO,KAAK,GAAG,MAAM,CAAC,SAAS,EAC7C,MAAK,QAAQ;GAAE,GAAI,KAAK,SAAS,EAAE;GAAG,GAAG,GAAG;GAAO;AAErD,MAAI,GAAG,WAAW,OAChB,MAAK,SAAS,GAAG;;CAIrB,AAAQ,SAAS,IAA0B;AAEzC,MAAI,KAAK,QAAQ,GAAG,OAAO,KAAK,KAAK,IAAI;AACvC,QAAK,OAAO;AACZ;;EAGF,MAAM,QAAQ,KAAK,MAAM,IAAI,GAAG,GAAG;AACnC,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,mBAAmB,GAAG,KAAK;EACvD,MAAM,SAAS,MAAM;AACrB,MAAI,CAAC,UAAU,CAAC,OAAO,SAAU,OAAM,IAAI,MAAM,gCAAgC;EAEjF,MAAM,MAAM,OAAO,SAAS,WAAW,MAAM,EAAE,OAAO,GAAG,GAAG;AAC5D,MAAI,MAAM,EAAG,OAAM,IAAI,MAAM,wCAAwC,GAAG,KAAK;EAG7E,MAAM,CAAC,WAAW,OAAO,SAAS,OAAO,KAAK,EAAE;AAGhD,OAAK,YAAY,QAAS;;CAG5B,AAAQ,UAAU,IAA2D;AAE3E,MAAI,CADU,KAAK,MAAM,IAAI,GAAG,GAAG,CACvB,OAAM,IAAI,MAAM,mBAAmB,GAAG,KAAK;EAEvD,MAAM,cAAc,KAAK,MAAM,IAAI,GAAG,SAAS;AAC/C,MAAI,CAAC,YAAa,OAAM,IAAI,MAAM,0BAA0B,GAAG,WAAW;EAC1E,MAAM,SAAS,YAAY;AAE3B,MAAI,CAAC,OAAO,SAAU,OAAM,IAAI,MAAM,yBAAyB;EAE/D,MAAM,aAAa,OAAO,SAAS,WAAW,MAAM,EAAE,OAAO,GAAG,GAAG;AACnE,MAAI,aAAa,EAAG,OAAM,IAAI,MAAM,iCAAiC,GAAG,KAAK;AAE7E,MAAI,GAAG,QAAQ,KAAK,GAAG,SAAS,OAAO,SAAS,OAC9C,OAAM,IAAI,MAAM,gCAAgC,GAAG,QAAQ;EAI7D,MAAM,CAAC,QAAQ,OAAO,SAAS,OAAO,YAAY,EAAE;AACpD,SAAO,SAAS,OAAO,GAAG,OAAO,GAAG,KAAM;;CAG5C,AAAQ,eAAqB;AAC3B,OAAK,MAAM,OAAO;AAClB,MAAI,KAAK,KACP,MAAK,UAAU,KAAK,MAAM,KAAK;;CAInC,AAAQ,UAAU,MAAe,QAA8B;AAC7D,OAAK,MAAM,IAAI,KAAK,IAAI;GAAE;GAAM;GAAQ,CAAC;AACzC,MAAI,KAAK,SACP,MAAK,MAAM,SAAS,KAAK,SACvB,MAAK,UAAU,OAAO,KAAK;;CAKjC,AAAQ,YAAY,MAAqB;AACvC,OAAK,MAAM,OAAO,KAAK,GAAG;AAC1B,MAAI,KAAK,SACP,MAAK,MAAM,SAAS,KAAK,SACvB,MAAK,YAAY,MAAM;;;AAQ/B,IAAa,kBAAb,MAA6B;CAC3B,AAAQ,yBAAS,IAAI,KAA2B;CAChD,AAAQ,cAAwB,EAAE;CAClC,AAAQ,iBAAgC;CACxC,AAAQ;CAER,YAAY,MAA+B;AACzC,OAAK,YAAY,MAAM,aAAa;;CAGtC,IAAI,gBAA+B;AACjC,SAAO,KAAK;;;CAId,MAAM,SAAiB,MAAe,MAAuC;EAC3E,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ;AACpC,MAAI,CAAC,OAAO;AACV,WAAQ,IAAI,cAAc;AAC1B,QAAK,OAAO,IAAI,SAAS,MAAM;;AAEjC,QAAM,QAAQ,KAAK;AACnB,MAAI,KAAM,OAAM,iBAAiB,KAAK;AACtC,OAAK,MAAM,QAAQ;AACnB,OAAK,eAAe;AACpB,SAAO;;;CAIT,KAAK,SAA+B;EAClC,MAAM,QAAQ,KAAK,OAAO,IAAI,QAAQ;AACtC,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,+BAA+B,UAAU;AACrE,OAAK,iBAAiB;AACtB,OAAK,MAAM,QAAQ;AACnB,SAAO;;;CAIT,QAAQ,SAAuB;AAC7B,MAAI,KAAK,mBAAmB,QAC1B,OAAM,IAAI,MAAM,qCAAqC,UAAU;AAEjE,OAAK,OAAO,OAAO,QAAQ;AAC3B,OAAK,cAAc,KAAK,YAAY,QAAQ,OAAO,OAAO,QAAQ;;;CAIpE,SAAS,SAA2C;AAClD,SAAO,KAAK,OAAO,IAAI,QAAQ;;;CAIjC,iBAAkE;AAChE,MAAI,CAAC,KAAK,eAAgB,QAAO;EACjC,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,eAAe;AAClD,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO;GAAE,SAAS,KAAK;GAAgB;GAAO;;;CAIhD,WAAW,SAAiB,KAAyB;EACnD,MAAM,QAAQ,KAAK,OAAO,IAAI,QAAQ;AACtC,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,oBAAoB,UAAU;AAC1D,QAAM,WAAW,IAAI;AACrB,OAAK,MAAM,QAAQ;;;CAIrB,AAAQ,MAAM,SAAuB;AACnC,OAAK,cAAc,KAAK,YAAY,QAAQ,OAAO,OAAO,QAAQ;AAClE,OAAK,YAAY,KAAK,QAAQ;;;CAIhC,AAAQ,gBAAsB;AAC5B,SAAO,KAAK,OAAO,OAAO,KAAK,WAAW;GACxC,MAAM,SAAS,KAAK,YAAY,MAC7B,OAAO,OAAO,KAAK,kBAAkB,KAAK,OAAO,IAAI,GAAG,CAC1D;AACD,OAAI,CAAC,OAAQ;AACb,QAAK,OAAO,OAAO,OAAO;AAC1B,QAAK,cAAc,KAAK,YAAY,QAAQ,OAAO,OAAO,OAAO"}