@nvidia-elements/core 2.23.5 → 2.23.6

package/dist/custom-elements.json

@@ -55988,10 +55988,60 @@
                 "values": []
               }
             },
+            {
+              "kind": "field",
+              "name": "#tabStripIdentities",
+              "privacy": "private",
+              "type": {
+                "text": "{\n    root: WorkspaceNode | null;\n    resolve: ReturnType<typeof createTabStripIdentityResolver>;\n  } | undefined",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "{\n    root: WorkspaceNode",
+                    "description": ""
+                  },
+                  {
+                    "value": "null;\n    resolve: ReturnType<typeof createTabStripIdentityResolver>;\n  }",
+                    "description": ""
+                  }
+                ]
+              }
+            },
+            {
+              "kind": "field",
+              "name": "#contentObserver",
+              "privacy": "private",
+              "type": {
+                "text": "MutationObserver | undefined",
+                "_sourceAliases": [],
+                "values": []
+              }
+            },
             {
               "kind": "method",
               "name": "hostDisconnected"
             },
+            {
+              "kind": "method",
+              "name": "startObserving"
+            },
+            {
+              "kind": "method",
+              "name": "stopObserving"
+            },
+            {
+              "kind": "method",
+              "name": "#observeContent",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "records",
+                  "type": {
+                    "text": "MutationRecord[]"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "captureFocus"
@@ -56660,10 +56710,10 @@
             },
             {
               "kind": "field",
-              "name": "#planner",
+              "name": "#placementSession",
               "privacy": "private",
               "type": {
-                "text": "WorkspacePlacementPlanner | undefined",
+                "text": "WorkspacePlacementSession | undefined",
                 "_sourceAliases": [],
                 "values": []
               }
@@ -58429,10 +58479,159 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "/src/workspace/utils/comparison.utils.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "sameArrayItems",
+          "parameters": [
+            {
+              "name": "left",
+              "type": {
+                "text": "readonly T[]",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "right",
+              "type": {
+                "text": "readonly T[]",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "sameRect",
+          "parameters": [
+            {
+              "name": "left",
+              "type": {
+                "text": "Rect",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "right",
+              "type": {
+                "text": "Rect",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "sameArrayItems",
+          "declaration": {
+            "name": "sameArrayItems",
+            "module": "/src/workspace/utils/comparison.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "sameRect",
+          "declaration": {
+            "name": "sameRect",
+            "module": "/src/workspace/utils/comparison.utils.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "/src/workspace/utils/evaluation.utils.js",
       "declarations": [
+        {
+          "kind": "class",
+          "description": "Owns retained geometry and catalog data and the current synchronous evaluation for one Workspace.",
+          "name": "WorkspaceEvaluationCache",
+          "members": [
+            {
+              "kind": "field",
+              "name": "#host",
+              "privacy": "private",
+              "type": {
+                "text": "HTMLElement",
+                "_sourceAliases": [],
+                "values": []
+              },
+              "readonly": true,
+              "default": "host"
+            },
+            {
+              "kind": "field",
+              "name": "#current",
+              "privacy": "private",
+              "type": {
+                "text": "WorkspaceEvaluation | undefined",
+                "_sourceAliases": [],
+                "values": []
+              }
+            },
+            {
+              "kind": "field",
+              "name": "geometry",
+              "type": {
+                "text": "CachedWorkspaceGeometry | undefined",
+                "_sourceAliases": [],
+                "values": []
+              }
+            },
+            {
+              "kind": "field",
+              "name": "catalog",
+              "type": {
+                "text": "CachedPlacementCatalog | undefined",
+                "_sourceAliases": [],
+                "values": []
+              }
+            },
+            {
+              "kind": "field",
+              "name": "current",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "run",
+              "return": {
+                "type": {
+                  "text": "T"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "inputs",
+                  "type": {
+                    "text": "WorkspaceEvaluationInputs"
+                  }
+                },
+                {
+                  "name": "delegate",
+                  "type": {
+                    "text": "WorkspaceEvaluationDelegate | undefined"
+                  }
+                },
+                {
+                  "name": "work",
+                  "type": {
+                    "text": "(evaluation: WorkspaceEvaluation) => T"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "clear"
+            }
+          ]
+        },
         {
           "kind": "class",
           "description": "Shares layout inputs and browser reads within one synchronous evaluation.",
@@ -58480,7 +58679,7 @@
             },
             {
               "kind": "field",
-              "name": "contextRect",
+              "name": "resolveScopeRect",
               "readonly": true
             },
             {
@@ -58519,6 +58718,18 @@
               "readonly": true,
               "default": "delegate"
             },
+            {
+              "kind": "field",
+              "name": "#cacheOwner",
+              "privacy": "private",
+              "type": {
+                "text": "WorkspaceEvaluationCache | undefined",
+                "_sourceAliases": [],
+                "values": []
+              },
+              "readonly": true,
+              "default": "cacheOwner"
+            },
             {
               "kind": "field",
               "name": "#scroll",
@@ -58547,6 +58758,16 @@
               "readonly": true,
               "default": "new WeakMap<string[], WorkspaceGeometry>()"
             },
+            {
+              "kind": "field",
+              "name": "#validatedGeometry",
+              "privacy": "private",
+              "type": {
+                "text": "CachedWorkspaceGeometry | undefined",
+                "_sourceAliases": [],
+                "values": []
+              }
+            },
             {
               "kind": "field",
               "name": "#origin",
@@ -58702,6 +58923,93 @@
               "kind": "method",
               "name": "presentationGeometry"
             },
+            {
+              "kind": "method",
+              "name": "#retainedMinimum",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "node",
+                  "type": {
+                    "text": "WorkspaceNode | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#canReuseGeometry",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "source",
+                  "optional": true,
+                  "type": {
+                    "text": "string[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#canReuseCatalog",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "preview is DetachedPreview"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "preview",
+                  "type": {
+                    "text": "WorkspaceDragPreview | undefined"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#canReuseCurrentInputs",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "#invalidateGeometry",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "#hasCurrentPanelIds",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "#matchesGeometry",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "snapshot",
+                  "type": {
+                    "text": "GeometryInputSnapshot"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#getGeometryCache",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "source",
+                  "optional": true,
+                  "type": {
+                    "text": "string[]"
+                  }
+                }
+              ]
+            },
             {
               "kind": "field",
               "name": "#currentLayout",
@@ -58739,9 +59047,29 @@
               ]
             }
           ]
-        }
+        },
+        {
+          "kind": "variable",
+          "name": "preview"
+        },
+        {
+          "kind": "variable",
+          "name": "currentLayout"
+        },
+        {
+          "kind": "variable",
+          "name": "measurements"
+        }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "WorkspaceEvaluationCache",
+          "declaration": {
+            "name": "WorkspaceEvaluationCache",
+            "module": "/src/workspace/utils/evaluation.utils.js"
+          }
+        },
         {
           "kind": "js",
           "name": "WorkspaceEvaluation",
@@ -58876,6 +59204,44 @@
       "kind": "javascript-module",
       "path": "/src/workspace/utils/geometry/sizing.utils.js",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "sameWorkspaceRequirements",
+          "parameters": [
+            {
+              "name": "left",
+              "type": {
+                "text": "WorkspaceRequirements",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "right",
+              "type": {
+                "text": "WorkspaceRequirements",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "snapshotWorkspaceRequirements",
+          "return": {
+            "type": {
+              "text": "WorkspaceRequirements"
+            }
+          },
+          "parameters": [
+            {
+              "name": "requirements",
+              "type": {
+                "text": "WorkspaceRequirements",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
         {
           "kind": "function",
           "name": "getMinimumWorkspaceDimensions",
@@ -58939,6 +59305,22 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "sameWorkspaceRequirements",
+          "declaration": {
+            "name": "sameWorkspaceRequirements",
+            "module": "/src/workspace/utils/geometry/sizing.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "snapshotWorkspaceRequirements",
+          "declaration": {
+            "name": "snapshotWorkspaceRequirements",
+            "module": "/src/workspace/utils/geometry/sizing.utils.js"
+          }
+        },
         {
           "kind": "js",
           "name": "getMinimumWorkspaceDimensions",
@@ -59292,12 +59674,12 @@
             {
               "name": "input",
               "type": {
-                "text": "{\n  currentLayout: WorkspaceLayout;\n  root: WorkspaceNode | null;\n  source: string[];\n  available: string[];\n  projectLayout?: WorkspaceLayoutProjector;\n  planPlacement?: WorkspacePlacementPlanner;\n  contextRect?: WorkspaceContextRectResolver;\n  regions: WorkspacePlacedRegion[];\n  explorationRegions?: WorkspacePlacedRegion[];\n  existing: WorkspaceInsertionOffer[];\n  gap: number;\n}",
+                "text": "{\n  currentLayout: WorkspaceLayout;\n  root: WorkspaceNode | null;\n  source: string[];\n  available: string[];\n  projectLayout?: WorkspaceLayoutProjector;\n  planPlacement?: WorkspacePlacementPlanner;\n  placementSession?: WorkspacePlacementSession;\n  resolveScopeRect?: WorkspaceScopeRectResolver;\n  regions: WorkspacePlacedRegion[];\n  explorationRegions?: WorkspacePlacedRegion[];\n  existing: WorkspaceInsertionOffer[];\n  gap: number;\n}",
                 "_sourceAliases": []
               }
             }
           ],
-          "description": "Aliases of the same planned insertion share one descriptor."
+          "description": "Aliases of the same planned insertion share one offer."
         },
         {
           "kind": "variable",
@@ -59315,6 +59697,10 @@
           "kind": "variable",
           "name": "plan"
         },
+        {
+          "kind": "variable",
+          "name": "insertion"
+        },
         {
           "kind": "function",
           "name": "getPlacementOfferIntent",
@@ -59332,7 +59718,7 @@
               }
             }
           ],
-          "description": "Shares the painted descriptor's exact operation with input resolution."
+          "description": "Shares the painted offer's exact operation with input resolution."
         },
         {
           "kind": "function",
@@ -59346,7 +59732,7 @@
             {
               "name": "input",
               "type": {
-                "text": "{\n  owner: Rect;\n  recipient: Rect;\n  previous?: Rect;\n  axis: 'horizontal' | 'vertical';\n  after: boolean;\n  sourceSlot?: Rect;\n  boundary?: 'start' | 'end';\n}",
+                "text": "{\n  owner: Rect;\n  recipient: Rect;\n  previous?: Rect;\n  axis: 'horizontal' | 'vertical';\n  after: boolean;\n  sourceReservation?: Rect;\n  boundary?: 'start' | 'end';\n}",
                 "_sourceAliases": []
               }
             }
@@ -59370,7 +59756,7 @@
               }
             }
           ],
-          "description": "Orders overlapping scope offers into lanes from outermost to innermost."
+          "description": "Orders overlapping insertion offers into lanes from outermost to innermost."
         },
         {
           "kind": "function",
@@ -59391,7 +59777,7 @@
             {
               "name": "geometry",
               "type": {
-                "text": "{\n    regions: WorkspacePlacedRegion[];\n    source: string[];\n    gap: number;\n    contextRect?: WorkspaceContextRectResolver;\n  }",
+                "text": "{\n    regions: WorkspacePlacedRegion[];\n    source: string[];\n    gap: number;\n    resolveScopeRect?: WorkspaceScopeRectResolver;\n  }",
                 "_sourceAliases": []
               }
             }
@@ -59624,7 +60010,7 @@
         },
         {
           "kind": "function",
-          "name": "normalizeOwnedLayout",
+          "name": "normalizeLayoutWithSharing",
           "return": {
             "type": {
               "text": "WorkspaceNode"
@@ -59640,7 +60026,8 @@
                 ]
               }
             }
-          ]
+          ],
+          "description": "Reuses unchanged nodes in canonical split graphs produced by mapGroups."
         }
       ],
       "exports": [
@@ -59670,9 +60057,9 @@
         },
         {
           "kind": "js",
-          "name": "normalizeOwnedLayout",
+          "name": "normalizeLayoutWithSharing",
           "declaration": {
-            "name": "normalizeOwnedLayout",
+            "name": "normalizeLayoutWithSharing",
             "module": "/src/workspace/utils/model/layout.utils.js"
           }
         }
@@ -59682,6 +60069,51 @@
       "kind": "javascript-module",
       "path": "/src/workspace/utils/model/membership.utils.js",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "getPanelMembershipKey",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "members",
+              "type": {
+                "text": "readonly string[]",
+                "_sourceAliases": []
+              }
+            }
+          ],
+          "description": "Identifies panel membership independently of its order."
+        },
+        {
+          "kind": "function",
+          "name": "samePanelMembership",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "left",
+              "type": {
+                "text": "readonly string[]",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "right",
+              "type": {
+                "text": "readonly string[]",
+                "_sourceAliases": []
+              }
+            }
+          ],
+          "description": "Compares unique panel IDs independently of their order."
+        },
         {
           "kind": "function",
           "name": "preservesGroupMembership",
@@ -59746,6 +60178,22 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "getPanelMembershipKey",
+          "declaration": {
+            "name": "getPanelMembershipKey",
+            "module": "/src/workspace/utils/model/membership.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "samePanelMembership",
+          "declaration": {
+            "name": "samePanelMembership",
+            "module": "/src/workspace/utils/model/membership.utils.js"
+          }
+        },
         {
           "kind": "js",
           "name": "preservesGroupMembership",
@@ -59776,6 +60224,26 @@
       "kind": "javascript-module",
       "path": "/src/workspace/utils/model/operations.utils.js",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "sameDestination",
+          "parameters": [
+            {
+              "name": "left",
+              "type": {
+                "text": "WorkspaceDestination",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "right",
+              "type": {
+                "text": "WorkspaceDestination",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
         {
           "kind": "function",
           "name": "findGroup",
@@ -60041,6 +60509,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "sameDestination",
+          "declaration": {
+            "name": "sameDestination",
+            "module": "/src/workspace/utils/model/operations.utils.js"
+          }
+        },
         {
           "kind": "js",
           "name": "findGroup",
@@ -60138,15 +60614,37 @@
         },
         {
           "kind": "function",
-          "name": "getProjectionSignature",
+          "name": "canReuseLayoutProjection",
+          "parameters": [
+            {
+              "name": "projector",
+              "type": {
+                "text": "WorkspaceLayoutProjector | undefined",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "sameProjectionShape",
           "return": {
             "type": {
-              "text": "string"
+              "text": "boolean"
             }
           },
           "parameters": [
             {
-              "name": "node",
+              "name": "left",
+              "type": {
+                "text": "WorkspaceGroup | WorkspaceSplit | null",
+                "_sourceAliases": [
+                  "WorkspaceNode"
+                ]
+              }
+            },
+            {
+              "name": "right",
               "type": {
                 "text": "WorkspaceGroup | WorkspaceSplit | null",
                 "_sourceAliases": [
@@ -60154,7 +60652,8 @@
                 ]
               }
             }
-          ]
+          ],
+          "description": "Compares visible topology and panel order, independently of weights and active selection."
         },
         {
           "kind": "function",
@@ -60177,8 +60676,10 @@
             {
               "name": "expected",
               "type": {
-                "text": "string",
-                "_sourceAliases": []
+                "text": "WorkspaceGroup | WorkspaceSplit | null",
+                "_sourceAliases": [
+                  "WorkspaceNode"
+                ]
               }
             },
             {
@@ -60250,9 +60751,17 @@
         },
         {
           "kind": "js",
-          "name": "getProjectionSignature",
+          "name": "canReuseLayoutProjection",
           "declaration": {
-            "name": "getProjectionSignature",
+            "name": "canReuseLayoutProjection",
+            "module": "/src/workspace/utils/model/projection.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "sameProjectionShape",
+          "declaration": {
+            "name": "sameProjectionShape",
             "module": "/src/workspace/utils/model/projection.utils.js"
           }
         },
@@ -60316,7 +60825,7 @@
         },
         {
           "kind": "function",
-          "name": "sameSerializedWorkspaceLayout",
+          "name": "sameWorkspaceLayout",
           "return": {
             "type": {
               "text": "boolean"
@@ -60338,7 +60847,36 @@
               }
             }
           ],
-          "description": "Compares serialized layout representations, including property order and supplied group fields."
+          "description": "Compares known arrangement fields; object property insertion order is irrelevant."
+        },
+        {
+          "kind": "function",
+          "name": "sameWorkspaceNode",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "left",
+              "type": {
+                "text": "WorkspaceGroup | WorkspaceSplit | null",
+                "_sourceAliases": [
+                  "WorkspaceNode"
+                ]
+              }
+            },
+            {
+              "name": "right",
+              "type": {
+                "text": "WorkspaceGroup | WorkspaceSplit | null",
+                "_sourceAliases": [
+                  "WorkspaceNode"
+                ]
+              }
+            }
+          ]
         }
       ],
       "exports": [
@@ -60360,9 +60898,17 @@
         },
         {
           "kind": "js",
-          "name": "sameSerializedWorkspaceLayout",
+          "name": "sameWorkspaceLayout",
+          "declaration": {
+            "name": "sameWorkspaceLayout",
+            "module": "/src/workspace/utils/model/value.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "sameWorkspaceNode",
           "declaration": {
-            "name": "sameSerializedWorkspaceLayout",
+            "name": "sameWorkspaceNode",
             "module": "/src/workspace/utils/model/value.utils.js"
           }
         }
@@ -60432,56 +60978,39 @@
     },
     {
       "kind": "javascript-module",
-      "path": "/src/workspace/utils/placement/context.utils.js",
+      "path": "/src/workspace/utils/placement/group-insertion.utils.js",
       "declarations": [
         {
           "kind": "function",
-          "name": "getContextKey",
+          "name": "getGroupInsertion",
           "return": {
             "type": {
-              "text": "string"
+              "text": "GroupInsertion | undefined"
             }
           },
           "parameters": [
             {
-              "name": "members",
+              "name": "input",
               "type": {
-                "text": "string[]",
+                "text": "GroupInsertionInputs",
                 "_sourceAliases": []
               }
             }
-          ],
-          "description": "Identifies an operating region independently of path changes or sibling order."
+          ]
         },
         {
           "kind": "function",
-          "name": "createPlacementContext",
+          "name": "planGroupInsertion",
           "return": {
             "type": {
-              "text": "WorkspacePlacementContext"
+              "text": "WorkspacePlacementPlan | undefined"
             }
           },
           "parameters": [
             {
-              "name": "kind",
-              "type": {
-                "text": "WorkspacePlacementContext['kind']",
-                "_sourceAliases": []
-              }
-            },
-            {
-              "name": "node",
-              "type": {
-                "text": "WorkspaceGroup | WorkspaceSplit | null",
-                "_sourceAliases": [
-                  "WorkspaceNode"
-                ]
-              }
-            },
-            {
-              "name": "source",
+              "name": "input",
               "type": {
-                "text": "string[]",
+                "text": "InsertionInput",
                 "_sourceAliases": []
               }
             }
@@ -60489,158 +61018,32 @@
         },
         {
           "kind": "function",
-          "name": "getAffectedSplitContext",
+          "name": "computeGroupInsertion",
           "return": {
             "type": {
-              "text": "WorkspacePlacementContext"
+              "text": "GroupInsertion | undefined"
             }
           },
           "parameters": [
             {
               "name": "input",
               "type": {
-                "text": "{\n  baseline: WorkspacePlacedRegion[];\n  achieved: WorkspacePlacedRegion[];\n  source: string[];\n  recipient: string[];\n}",
+                "text": "GroupInsertionInputs",
                 "_sourceAliases": []
               }
             }
-          ],
-          "description": "Includes surviving peers whose computed allocation changes under split constraints."
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getGroupInsertion",
+          "declaration": {
+            "name": "getGroupInsertion",
+            "module": "/src/workspace/utils/placement/group-insertion.utils.js"
+          }
         },
-        {
-          "kind": "function",
-          "name": "allocateContextProxies",
-          "return": {
-            "type": {
-              "text": "WorkspaceContextProxy[]"
-            }
-          },
-          "parameters": [
-            {
-              "name": "input",
-              "type": {
-                "text": "{\n  catalog: WorkspacePlacedRegion[];\n  allocation: WorkspacePlacedRegion[];\n  source: string[];\n}",
-                "_sourceAliases": []
-              }
-            }
-          ],
-          "description": "Seeds operating-region proxies before their selection can change during animation."
-        },
-        {
-          "kind": "function",
-          "name": "getAllocatedContextRect",
-          "return": {
-            "type": {
-              "text": "Rect | undefined"
-            }
-          },
-          "parameters": [
-            {
-              "name": "input",
-              "type": {
-                "text": "ContextRectInput",
-                "_sourceAliases": []
-              }
-            }
-          ]
-        },
-        {
-          "kind": "function",
-          "name": "createContextRectResolver",
-          "return": {
-            "type": {
-              "text": "WorkspaceContextRectResolver"
-            }
-          }
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "getContextKey",
-          "declaration": {
-            "name": "getContextKey",
-            "module": "/src/workspace/utils/placement/context.utils.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "createPlacementContext",
-          "declaration": {
-            "name": "createPlacementContext",
-            "module": "/src/workspace/utils/placement/context.utils.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getAffectedSplitContext",
-          "declaration": {
-            "name": "getAffectedSplitContext",
-            "module": "/src/workspace/utils/placement/context.utils.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "allocateContextProxies",
-          "declaration": {
-            "name": "allocateContextProxies",
-            "module": "/src/workspace/utils/placement/context.utils.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getAllocatedContextRect",
-          "declaration": {
-            "name": "getAllocatedContextRect",
-            "module": "/src/workspace/utils/placement/context.utils.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "createContextRectResolver",
-          "declaration": {
-            "name": "createContextRectResolver",
-            "module": "/src/workspace/utils/placement/context.utils.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "/src/workspace/utils/placement/group-insertion.utils.js",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "planGroupInsertion",
-          "return": {
-            "type": {
-              "text": "WorkspacePlacementPlan | undefined"
-            }
-          },
-          "parameters": [
-            {
-              "name": "input",
-              "type": {
-                "text": "InsertionInput",
-                "_sourceAliases": []
-              }
-            }
-          ]
-        },
-        {
-          "kind": "function",
-          "name": "describePlacementSlot",
-          "parameters": [
-            {
-              "name": "input",
-              "type": {
-                "text": "{\n  plan: Pick<WorkspacePlacementPlan, 'layout'>;\n  source: string[];\n  available: string[];\n  projectLayout?: WorkspaceLayoutProjector;\n}",
-                "_sourceAliases": []
-              }
-            }
-          ]
-        }
-      ],
-      "exports": [
         {
           "kind": "js",
           "name": "planGroupInsertion",
@@ -60651,9 +61054,9 @@
         },
         {
           "kind": "js",
-          "name": "describePlacementSlot",
+          "name": "computeGroupInsertion",
           "declaration": {
-            "name": "describePlacementSlot",
+            "name": "computeGroupInsertion",
             "module": "/src/workspace/utils/placement/group-insertion.utils.js"
           }
         }
@@ -60703,6 +61106,39 @@
           },
           "description": "Requires an immutable current layout; projection callbacks are never retained."
         },
+        {
+          "kind": "function",
+          "name": "resolvePlacementPlan",
+          "return": {
+            "type": {
+              "text": "WorkspacePlacementPlan | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "context",
+              "type": {
+                "text": "WorkspacePlanningContext",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "destination",
+              "type": {
+                "text": "WorkspaceDestination",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "operation",
+              "type": {
+                "text": "PlacementInput['operation']",
+                "_sourceAliases": []
+              }
+            }
+          ],
+          "description": "Supplied planners keep their ordinary path; component gestures use their explicit session."
+        },
         {
           "kind": "function",
           "name": "planWorkspacePlacement",
@@ -60731,6 +61167,14 @@
             "module": "/src/workspace/utils/placement/planner.utils.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "resolvePlacementPlan",
+          "declaration": {
+            "name": "resolvePlacementPlan",
+            "module": "/src/workspace/utils/placement/planner.utils.js"
+          }
+        },
         {
           "kind": "js",
           "name": "planWorkspacePlacement",
@@ -60775,7 +61219,25 @@
             {
               "name": "input",
               "type": {
-                "text": "OfferInput",
+                "text": "WorkspacePlacementOfferInputs",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "computePlacementOffer",
+          "return": {
+            "type": {
+              "text": "WorkspaceDragOffer | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "input",
+              "type": {
+                "text": "WorkspacePlacementOfferInputs",
                 "_sourceAliases": []
               }
             }
@@ -60798,6 +61260,14 @@
             "name": "evaluatePlacementOffer",
             "module": "/src/workspace/utils/placement/preparation.utils.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "computePlacementOffer",
+          "declaration": {
+            "name": "computePlacementOffer",
+            "module": "/src/workspace/utils/placement/preparation.utils.js"
+          }
         }
       ]
     },
@@ -60871,6 +61341,265 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "/src/workspace/utils/placement/scope.utils.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "createPlacementScope",
+          "return": {
+            "type": {
+              "text": "WorkspacePlacementScope"
+            }
+          },
+          "parameters": [
+            {
+              "name": "kind",
+              "type": {
+                "text": "WorkspacePlacementScope['kind']",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "node",
+              "type": {
+                "text": "WorkspaceGroup | WorkspaceSplit | null",
+                "_sourceAliases": [
+                  "WorkspaceNode"
+                ]
+              }
+            },
+            {
+              "name": "source",
+              "type": {
+                "text": "string[]",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getAffectedSplitScope",
+          "return": {
+            "type": {
+              "text": "WorkspacePlacementScope"
+            }
+          },
+          "parameters": [
+            {
+              "name": "input",
+              "type": {
+                "text": "{\n  baseline: WorkspacePlacedRegion[];\n  achieved: WorkspacePlacedRegion[];\n  source: string[];\n  recipient: string[];\n}",
+                "_sourceAliases": []
+              }
+            }
+          ],
+          "description": "Includes surviving peers whose computed allocation changes under split constraints."
+        },
+        {
+          "kind": "function",
+          "name": "getAllocatedScopes",
+          "return": {
+            "type": {
+              "text": "WorkspaceScopeBounds[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "input",
+              "type": {
+                "text": "{\n  catalog: WorkspacePlacedRegion[];\n  allocation: WorkspacePlacedRegion[];\n  source: string[];\n}",
+                "_sourceAliases": []
+              }
+            }
+          ],
+          "description": "Seeds scope bounds before animation can change selection."
+        },
+        {
+          "kind": "function",
+          "name": "getAllocatedScopeRect",
+          "return": {
+            "type": {
+              "text": "Rect | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "input",
+              "type": {
+                "text": "ScopeRectInput",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "createScopeRectResolver",
+          "return": {
+            "type": {
+              "text": "WorkspaceScopeRectResolver"
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "createPlacementScope",
+          "declaration": {
+            "name": "createPlacementScope",
+            "module": "/src/workspace/utils/placement/scope.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getAffectedSplitScope",
+          "declaration": {
+            "name": "getAffectedSplitScope",
+            "module": "/src/workspace/utils/placement/scope.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getAllocatedScopes",
+          "declaration": {
+            "name": "getAllocatedScopes",
+            "module": "/src/workspace/utils/placement/scope.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getAllocatedScopeRect",
+          "declaration": {
+            "name": "getAllocatedScopeRect",
+            "module": "/src/workspace/utils/placement/scope.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createScopeRectResolver",
+          "declaration": {
+            "name": "createScopeRectResolver",
+            "module": "/src/workspace/utils/placement/scope.utils.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "/src/workspace/utils/placement/session.utils.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Owns reusable planning work until the component finishes its current drag.",
+          "name": "WorkspacePlacementSession",
+          "members": [
+            {
+              "kind": "field",
+              "name": "#planner",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "#producedLayouts",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new WeakSet<WorkspaceLayout>()"
+            },
+            {
+              "kind": "field",
+              "name": "#insertions",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new WeakMap<WorkspaceLayout, CachedInsertion>()"
+            },
+            {
+              "kind": "field",
+              "name": "#splitOffer",
+              "privacy": "private",
+              "type": {
+                "text": "CachedSplitOffer | undefined",
+                "_sourceAliases": [],
+                "values": []
+              }
+            },
+            {
+              "kind": "method",
+              "name": "plan",
+              "parameters": [
+                {
+                  "name": "input",
+                  "type": {
+                    "text": "Parameters<WorkspacePlacementPlanner>[0]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getInsertion",
+              "return": {
+                "type": {
+                  "text": "GroupInsertion | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "input",
+                  "type": {
+                    "text": "GroupInsertionInputs"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "prepareOffer",
+              "return": {
+                "type": {
+                  "text": "WorkspaceDragOffer | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "input",
+                  "type": {
+                    "text": "WorkspacePlacementOfferInputs"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#computeOffer",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "input",
+                  "type": {
+                    "text": "WorkspacePlacementOfferInputs"
+                  }
+                }
+              ]
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "WorkspacePlacementSession",
+          "declaration": {
+            "name": "WorkspacePlacementSession",
+            "module": "/src/workspace/utils/placement/session.utils.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "/src/workspace/utils/placement/split-sizing.utils.js",
@@ -60915,16 +61644,9 @@
           "name": "getPanelLabel",
           "parameters": [
             {
-              "name": "panels",
+              "name": "panel",
               "type": {
-                "text": "WorkspacePanel[]",
-                "_sourceAliases": []
-              }
-            },
-            {
-              "name": "id",
-              "type": {
-                "text": "string",
+                "text": "WorkspacePanel",
                 "_sourceAliases": []
               }
             }
@@ -61178,12 +61900,7 @@
         },
         {
           "kind": "function",
-          "name": "getTabStripIdentity",
-          "return": {
-            "type": {
-              "text": "string"
-            }
-          },
+          "name": "createTabStripIdentityResolver",
           "parameters": [
             {
               "name": "root",
@@ -61193,23 +61910,9 @@
                   "WorkspaceNode"
                 ]
               }
-            },
-            {
-              "name": "members",
-              "type": {
-                "text": "string[]",
-                "_sourceAliases": []
-              }
-            },
-            {
-              "name": "source",
-              "type": {
-                "text": "string[]",
-                "_sourceAliases": []
-              }
             }
           ],
-          "description": "Keeps a recipient strip stable while carried members enter or leave its preview."
+          "description": "Indexes strip ownership for one committed root."
         },
         {
           "kind": "function",
@@ -61261,7 +61964,7 @@
               }
             }
           ],
-          "description": "The computed carried tab slot owns exactly the same visible rectangle as its landing cue."
+          "description": "The computed carried tab reservation owns exactly the same visible rectangle as its landing cue."
         },
         {
           "kind": "function",
@@ -61312,9 +62015,9 @@
         },
         {
           "kind": "js",
-          "name": "getTabStripIdentity",
+          "name": "createTabStripIdentityResolver",
           "declaration": {
-            "name": "getTabStripIdentity",
+            "name": "createTabStripIdentityResolver",
             "module": "/src/workspace/utils/presentation/groups.utils.js"
           }
         },
@@ -61411,6 +62114,26 @@
               }
             }
           ]
+        },
+        {
+          "kind": "function",
+          "name": "sameWorkspaceMeasurementScalars",
+          "parameters": [
+            {
+              "name": "previous",
+              "type": {
+                "text": "WorkspaceMeasurements",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "current",
+              "type": {
+                "text": "WorkspaceMeasurements",
+                "_sourceAliases": []
+              }
+            }
+          ]
         }
       ],
       "exports": [
@@ -61421,6 +62144,14 @@
             "name": "sameWorkspaceMeasurements",
             "module": "/src/workspace/utils/presentation/measurements.utils.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "sameWorkspaceMeasurementScalars",
+          "declaration": {
+            "name": "sameWorkspaceMeasurementScalars",
+            "module": "/src/workspace/utils/presentation/measurements.utils.js"
+          }
         }
       ]
     },
@@ -61492,6 +62223,38 @@
       "kind": "javascript-module",
       "path": "/src/workspace/utils/presentation/preview.utils.js",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "preparePreviewBoundaries",
+          "return": {
+            "type": {
+              "text": "PreviewBoundary[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "catalogRegions",
+              "type": {
+                "text": "WorkspacePlacedRegion[]",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "placedRegions",
+              "type": {
+                "text": "WorkspacePlacedRegion[]",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "sourcePanelIds",
+              "type": {
+                "text": "string[]",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
         {
           "kind": "function",
           "name": "shouldEmphasizeReservedDestination",
@@ -61535,6 +62298,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "preparePreviewBoundaries",
+          "declaration": {
+            "name": "preparePreviewBoundaries",
+            "module": "/src/workspace/utils/presentation/preview.utils.js"
+          }
+        },
         {
           "kind": "js",
           "name": "shouldEmphasizeReservedDestination",