@vibecook/ice 0.2.0 → 0.4.0

package/dist/{chunk-DXU3RZZS.js → chunk-7LZAXQAO.js}

@@ -43,6 +43,7 @@ import {
   defineTag as strataDefineTag
 } from "@vibecook/strata-ecs";
 var componentMeta = /* @__PURE__ */ new Map();
+var componentsByIceName = /* @__PURE__ */ new Map();
 var tagNames = /* @__PURE__ */ new Map();
 var relationMeta = /* @__PURE__ */ new Map();
 var resourceMeta = /* @__PURE__ */ new Map();
@@ -62,8 +63,18 @@ function defineComponent(name, schema) {
     eidFields: fields.filter(([, f]) => isEidField(f)).map(([k]) => k),
     requiredFields: fields.filter(([, f]) => !hasDefault(f)).map(([k]) => k)
   });
+  componentsByIceName.set(name, c);
   return c;
 }
+function ensureComponent(name, schema) {
+  const existing = componentsByIceName.get(name);
+  if (existing === void 0) return defineComponent(name, schema);
+  const recorded = componentMeta.get(existing);
+  if (recorded === void 0 || JSON.stringify(recorded.schema) !== JSON.stringify(schema)) {
+    throw new Error(`ice: ensureComponent("${name}") \u2014 a component with this name exists with a DIFFERENT shape.`);
+  }
+  return existing;
+}
 function defineTag(name) {
   const t = strataDefineTag(name);
   tagNames.set(t, name);
@@ -396,6 +407,181 @@ function createReflectorRegistry(world, opts) {
   };
 }
 
+// ../core/src/catalog/camera-derived.ts
+import { enumOf, field as field2 } from "@vibecook/strata-ecs";
+var Camera = defineResource("Camera", {
+  x: field2("f64", { default: 0 }),
+  y: field2("f64", { default: 0 }),
+  zoom: field2("f32", { default: 1 }),
+  gesturing: field2("bool", { default: false })
+});
+var Viewport = defineResource("Viewport", {
+  w: field2("f32", { default: 0 }),
+  h: field2("f32", { default: 0 }),
+  dpr: field2("f32", { default: 1 })
+});
+var ActiveTool = defineResource("ActiveTool", { id: field2("string", { default: "select" }) });
+var StageMode = defineResource("StageMode", {
+  backgroundHolds: field2("u32", { default: 0 })
+});
+var FrameMode = defineResource("FrameMode", {
+  freezeHolds: field2("u32", { default: 0 })
+});
+var SnapConfig = defineResource("SnapConfig", {
+  enabled: field2("bool", { default: SNAP_DEFAULTS.enabled }),
+  thresholdPx: field2("f32", { default: SNAP_DEFAULTS.thresholdPx })
+});
+var ContainerCamera = defineComponent("ContainerCamera", {
+  x: field2("f64", { default: 0 }),
+  y: field2("f64", { default: 0 }),
+  zoom: field2("f32", { default: 1 })
+});
+var Active = defineTag("Active");
+var Visible = defineTag("Visible");
+var Culled = defineTag("Culled");
+var WidgetBreakpoint = defineComponent("WidgetBreakpoint", {
+  tier: field2(enumOf(["micro", "compact", "normal", "expanded", "detailed"]), { default: "normal" }),
+  w: field2("u16", { default: 0 }),
+  h: field2("u16", { default: 0 })
+});
+var MeasuredSize = defineComponent("MeasuredSize", {
+  w: field2("f32", { default: 0 }),
+  h: field2("f32", { default: 0 })
+});
+var SelectionBox = defineComponent("SelectionBox", {
+  x: field2("f64", { default: 0 }),
+  y: field2("f64", { default: 0 }),
+  w: field2("f32", { default: 0 }),
+  h: field2("f32", { default: 0 })
+});
+var HandleSpec = defineComponent("HandleSpec", {
+  anchor: enumOf(["nw", "n", "ne", "e", "se", "s", "sw", "w"])
+});
+var GuideLine = defineComponent("GuideLine", {
+  axis: enumOf(["x", "y"]),
+  at: field2("f64", { default: 0 }),
+  from: field2("f64", { default: 0 }),
+  to: field2("f64", { default: 0 })
+});
+var SpacingBar = defineComponent("SpacingBar", {
+  axis: enumOf(["x", "y"]),
+  from: field2("f64", { default: 0 }),
+  to: field2("f64", { default: 0 }),
+  perp: field2("f64", { default: 0 }),
+  gap: field2("f32", { default: 0 })
+});
+var MarqueeBox = defineComponent("MarqueeBox", {
+  x: field2("f64", { default: 0 }),
+  y: field2("f64", { default: 0 }),
+  w: field2("f32", { default: 0 }),
+  h: field2("f32", { default: 0 })
+});
+var CursorVisual = defineComponent("CursorVisual", {
+  kind: enumOf(["local", "remote"]),
+  pressed: field2("bool", { default: false })
+});
+var Follows = defineRelation("Follows", { arity: "one" });
+var VisualOf = defineRelation("VisualOf", { arity: "one" });
+var NavDepth = defineComponent("NavDepth", { d: field2("u8", { default: 0 }) });
+var NavCamera = defineComponent("NavCamera", {
+  x: field2("f64", { default: 0 }),
+  y: field2("f64", { default: 0 }),
+  zoom: field2("f32", { default: 1 })
+});
+var NavFrame = defineRelation("NavFrame", { arity: "one" });
+var CanvasSurface = defineTag("CanvasSurface");
+
+// ../core/src/guards/dev.ts
+var enabled = true;
+function setDevGuards(on) {
+  enabled = on;
+}
+function devGuardsEnabled() {
+  return enabled;
+}
+
+// ../core/src/engine/frame-control.ts
+var SETTLE_CAP = 120;
+function createFrameControl(world) {
+  const freezes = /* @__PURE__ */ new Map();
+  const reporters = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  let settleLeft = 0;
+  let parked = false;
+  const sync = () => {
+    world.setResource(FrameMode, { freezeHolds: freezes.size });
+  };
+  const announce = () => {
+    for (const fn of [...listeners]) fn();
+  };
+  const busyNames = () => {
+    const names = [];
+    for (const r of reporters.values()) if (r.busy()) names.push(r.name);
+    return names;
+  };
+  return {
+    freeze(name) {
+      const token = Symbol(name);
+      const first = freezes.size === 0;
+      freezes.set(token, name);
+      if (first) {
+        settleLeft = SETTLE_CAP;
+        parked = false;
+      }
+      sync();
+      announce();
+      let released = false;
+      return () => {
+        if (released) return;
+        released = true;
+        freezes.delete(token);
+        if (freezes.size === 0) {
+          settleLeft = 0;
+          parked = false;
+        }
+        sync();
+        announce();
+      };
+    },
+    isFrozen: () => freezes.size > 0,
+    isParked: () => parked,
+    holds: () => [...freezes.values()],
+    settleWhile(name, busy) {
+      const token = Symbol(name);
+      reporters.set(token, { name, busy });
+      let released = false;
+      return () => {
+        if (released) return;
+        released = true;
+        reporters.delete(token);
+      };
+    },
+    settling: () => busyNames(),
+    claimStep() {
+      if (freezes.size === 0) return true;
+      if (parked) return false;
+      if (settleLeft <= 0) {
+        parked = true;
+        if (devGuardsEnabled()) {
+          console.warn(
+            `ice: frame.freeze \u2014 settle cap (${SETTLE_CAP} frames) reached with reporters still busy: ${busyNames().join(", ")}. Parking on a possibly unsettled frame.`
+          );
+        }
+        return false;
+      }
+      settleLeft -= 1;
+      if (busyNames().length === 0) parked = true;
+      return true;
+    },
+    onChange(fn) {
+      listeners.add(fn);
+      return () => {
+        listeners.delete(fn);
+      };
+    }
+  };
+}
+
 // ../core/src/engine/engine.ts
 function createEngine(world, opts) {
   const pipeline = createPipelineRegistry();
@@ -404,11 +590,13 @@ function createEngine(world, opts) {
     opts?.onReflectorFault ? { onFault: opts.onReflectorFault } : void 0
   );
   const publishHooks = [];
+  const frame2 = createFrameControl(world);
   let telemetryArmed = false;
   let last;
   let building = null;
   return {
     world,
+    frame: frame2,
     addSystems(group, ...systems) {
       return pipeline.add(group, ...systems);
     },
@@ -467,15 +655,6 @@ function createEngine(world, opts) {
   };
 }
 
-// ../core/src/guards/dev.ts
-var enabled = true;
-function setDevGuards(on) {
-  enabled = on;
-}
-function devGuardsEnabled() {
-  return enabled;
-}
-
 // ../core/src/guards/live-writer.ts
 function createLiveWriter(world, opts) {
   return {
@@ -599,34 +778,34 @@ function writeRuntimeResource(world, res, v) {
 }
 
 // ../core/src/catalog/scene.ts
-import { field as field2 } from "@vibecook/strata-ecs";
+import { field as field3 } from "@vibecook/strata-ecs";
 var Position = defineComponent("Position", { x: "f64", y: "f64" });
 var Size = defineComponent("Size", { w: "f32", h: "f32" });
-var Rotation = defineComponent("Rotation", { r: field2("f32", { default: 0 }) });
-var Opacity = defineComponent("Opacity", { a: field2("f32", { default: 1 }) });
+var Rotation = defineComponent("Rotation", { r: field3("f32", { default: 0 }) });
+var Opacity = defineComponent("Opacity", { a: field3("f32", { default: 1 }) });
 var StackZ = defineComponent("StackZ", { z: "f64" });
 var ChildOf = defineRelation("ChildOf", { arity: "one", ordered: true });
 var BoardRoot = defineResource("BoardRoot", { root: "eid" });
 
 // ../core/src/catalog/graph.ts
-import { enumOf, field as field3 } from "@vibecook/strata-ecs";
+import { enumOf as enumOf2, field as field4 } from "@vibecook/strata-ecs";
 var Wire = defineTag("Wire");
 var WireFrom = defineRelation("WireFrom", { arity: "one" });
 var WireTo = defineRelation("WireTo", { arity: "one" });
 var WirePorts = defineComponent("WirePorts", { from: "string", to: "string" });
 var Port = defineComponent("Port", {
   id: "string",
-  side: enumOf(["n", "e", "s", "w"]),
-  index: field3("u8", { default: 0 })
+  side: enumOf2(["n", "e", "s", "w"]),
+  index: field4("u8", { default: 0 })
 });
 var PortOf = defineRelation("PortOf", { arity: "one" });
 var PortAnchor = defineComponent("PortAnchor", {
-  x: field3("f64", { default: 0 }),
-  y: field3("f64", { default: 0 })
+  x: field4("f64", { default: 0 }),
+  y: field4("f64", { default: 0 })
 });
 var Container = defineTag("Container");
-var Accepts = defineComponent("Accepts", { list: field3("string", { default: "[]" }) });
-var Provides = defineComponent("Provides", { list: field3("string", { default: "[]" }) });
+var Accepts = defineComponent("Accepts", { list: field4("string", { default: "[]" }) });
+var Provides = defineComponent("Provides", { list: field4("string", { default: "[]" }) });
 var WirePrefab = definePrefab("wire", {
   store: "durable",
   version: 1,
@@ -636,54 +815,55 @@ var WirePrefab = definePrefab("wire", {
 });
 
 // ../core/src/catalog/pointer.ts
-import { enumOf as enumOf2, field as field4 } from "@vibecook/strata-ecs";
+import { enumOf as enumOf3, field as field5 } from "@vibecook/strata-ecs";
 var Pointer = defineComponent("Pointer", {
   id: "string",
-  device: enumOf2(["mouse", "touch", "pen"]),
-  owner: field4("string", { default: "" })
+  device: enumOf3(["mouse", "touch", "pen"]),
+  owner: field5("string", { default: "" })
 });
 var PointerScreen = defineComponent("PointerScreen", {
-  x: field4("f32", { default: 0 }),
-  y: field4("f32", { default: 0 })
+  x: field5("f32", { default: 0 }),
+  y: field5("f32", { default: 0 })
 });
 var PointerButtons = defineComponent("PointerButtons", {
-  buttons: field4("u8", { default: 0 }),
-  downX: field4("f32", { default: 0 }),
-  downY: field4("f32", { default: 0 }),
+  buttons: field5("u8", { default: 0 }),
+  downX: field5("f32", { default: 0 }),
+  downY: field5("f32", { default: 0 }),
   /** The down EVENT's timestamp (0 = unknown ⇒ consumers fall back to frame now). */
-  downMs: field4("f64", { default: 0 })
+  downMs: field5("f64", { default: 0 })
 });
 var PointerMods = defineComponent("PointerMods", {
-  shift: field4("bool", { default: false }),
-  ctrl: field4("bool", { default: false }),
-  alt: field4("bool", { default: false }),
-  meta: field4("bool", { default: false })
+  shift: field5("bool", { default: false }),
+  ctrl: field5("bool", { default: false }),
+  alt: field5("bool", { default: false }),
+  meta: field5("bool", { default: false })
 });
 var PointerWheel = defineComponent("PointerWheel", {
-  dx: field4("f32", { default: 0 }),
-  dy: field4("f32", { default: 0 }),
-  pinch: field4("f32", { default: 0 })
+  dx: field5("f32", { default: 0 }),
+  dy: field5("f32", { default: 0 }),
+  pinch: field5("f32", { default: 0 })
 });
-var PointerRadius = defineComponent("PointerRadius", { r: field4("f32", { default: 0 }) });
+var PointerRadius = defineComponent("PointerRadius", { r: field5("f32", { default: 0 }) });
 var WentDown = defineTag("WentDown");
 var WentUp = defineTag("WentUp");
 var WentCancelled = defineTag("WentCancelled");
 var HandledByWidget = defineTag("HandledByWidget");
+var WheelHandled = defineTag("WheelHandled");
 var OverInteractive = defineTag("OverInteractive");
 var LocalPointer = defineTag("LocalPointer");
 var PointerWorld = defineComponent("PointerWorld", {
-  x: field4("f64", { default: 0 }),
-  y: field4("f64", { default: 0 })
+  x: field5("f64", { default: 0 }),
+  y: field5("f64", { default: 0 })
 });
 var Keyboard = defineResource("Keyboard", {
-  shift: field4("bool", { default: false }),
-  ctrl: field4("bool", { default: false }),
-  alt: field4("bool", { default: false }),
-  meta: field4("bool", { default: false }),
-  space: field4("bool", { default: false })
+  shift: field5("bool", { default: false }),
+  ctrl: field5("bool", { default: false }),
+  alt: field5("bool", { default: false }),
+  meta: field5("bool", { default: false }),
+  space: field5("bool", { default: false })
 });
 var CancelRequest = defineResource("CancelRequest", {
-  active: field4("bool", { default: false })
+  active: field5("bool", { default: false })
 });
 var Targets = defineRelation("Targets", { arity: "one" });
 var TouchesExact = defineRelation("TouchesExact", { arity: "one" });
@@ -733,44 +913,44 @@ function definePhaseSet(name, phases) {
 }
 
 // ../core/src/catalog/gesture.ts
-import { field as field5 } from "@vibecook/strata-ecs";
+import { field as field6 } from "@vibecook/strata-ecs";
 var Drag = defineComponent("Drag", {
-  startX: field5("f64", { default: 0 }),
-  startY: field5("f64", { default: 0 }),
-  totalX: field5("f32", { default: 0 }),
-  totalY: field5("f32", { default: 0 }),
-  velX: field5("f32", { default: 0 }),
-  velY: field5("f32", { default: 0 }),
-  zoomAtClaim: field5("f32", { default: 1 })
+  startX: field6("f64", { default: 0 }),
+  startY: field6("f64", { default: 0 }),
+  totalX: field6("f32", { default: 0 }),
+  totalY: field6("f32", { default: 0 }),
+  velX: field6("f32", { default: 0 }),
+  velY: field6("f32", { default: 0 }),
+  zoomAtClaim: field6("f32", { default: 1 })
 });
 var Tap = defineComponent("Tap", {
-  downAt: field5("f64", { default: 0 }),
-  count: field5("u32", { default: 0 })
+  downAt: field6("f64", { default: 0 }),
+  count: field6("u32", { default: 0 })
 });
 var LongPress = defineComponent("LongPress", {
-  downAt: field5("f64", { default: 0 }),
-  startX: field5("f64", { default: 0 }),
-  startY: field5("f64", { default: 0 }),
-  curX: field5("f64", { default: 0 }),
-  curY: field5("f64", { default: 0 })
+  downAt: field6("f64", { default: 0 }),
+  startX: field6("f64", { default: 0 }),
+  startY: field6("f64", { default: 0 }),
+  curX: field6("f64", { default: 0 }),
+  curY: field6("f64", { default: 0 })
 });
 var Pinch = defineComponent("Pinch", {
-  startDist: field5("f32", { default: 0 }),
-  startZoom: field5("f32", { default: 1 }),
-  cx: field5("f64", { default: 0 }),
-  cy: field5("f64", { default: 0 }),
-  zoomAtClaim: field5("f32", { default: 1 })
+  startDist: field6("f32", { default: 0 }),
+  startZoom: field6("f32", { default: 1 }),
+  cx: field6("f64", { default: 0 }),
+  cy: field6("f64", { default: 0 }),
+  zoomAtClaim: field6("f32", { default: 1 })
 });
 var WheelPan = defineComponent("WheelPan", {
-  dx: field5("f32", { default: 0 }),
-  dy: field5("f32", { default: 0 }),
-  anchorX: field5("f32", { default: 0 }),
-  anchorY: field5("f32", { default: 0 })
+  dx: field6("f32", { default: 0 }),
+  dy: field6("f32", { default: 0 }),
+  anchorX: field6("f32", { default: 0 }),
+  anchorY: field6("f32", { default: 0 })
 });
 var WheelZoom = defineComponent("WheelZoom", {
-  pinch: field5("f32", { default: 0 }),
-  anchorX: field5("f32", { default: 0 }),
-  anchorY: field5("f32", { default: 0 })
+  pinch: field6("f32", { default: 0 }),
+  anchorX: field6("f32", { default: 0 }),
+  anchorY: field6("f32", { default: 0 })
 });
 var GesturePhases = definePhaseSet("Gesture", [
   "Possible",
@@ -798,9 +978,9 @@ var RoutedMarquee = defineTag("RoutedMarquee");
 var RoutedPan = defineTag("RoutedPan");
 var RoutedDraw = defineTag("RoutedDraw");
 var MultiTap = defineComponent("MultiTap", {
-  max: field5("u32", { default: 2 }),
-  windowMs: field5("f32", { default: GESTURE_DEFAULTS.multiTapWindowMs }),
-  slopPx: field5("f32", { default: GESTURE_DEFAULTS.multiTapSlopPx })
+  max: field6("u32", { default: 2 }),
+  windowMs: field6("f32", { default: GESTURE_DEFAULTS.multiTapWindowMs }),
+  slopPx: field6("f32", { default: GESTURE_DEFAULTS.multiTapSlopPx })
 });
 var Watches = defineRelation("Watches", { arity: "many" });
 var Sequence = defineRelation("Sequence", { arity: "one" });
@@ -822,8 +1002,8 @@ var Grab = defineComponent("Grab", {
   ord: "f64"
 });
 var SnapState = defineComponent("SnapState", {
-  dx: field5("f32", { default: 0 }),
-  dy: field5("f32", { default: 0 })
+  dx: field6("f32", { default: 0 }),
+  dy: field6("f32", { default: 0 })
 });
 var Down = defineComponent("Down", { x: "f64", y: "f64", ms: "f64" });
 var OverlapCandidate = defineTag("OverlapCandidate");
@@ -834,14 +1014,14 @@ var TransformTween = defineComponent("TransformTween", {
   toX: "f64",
   toY: "f64",
   durationMs: "f32",
-  elapsedMs: field5("f32", { default: 0 })
+  elapsedMs: field6("f32", { default: 0 })
 });
 
 // ../core/src/catalog/insert.ts
-import { field as field6 } from "@vibecook/strata-ecs";
+import { field as field7 } from "@vibecook/strata-ecs";
 var InsertGhost = defineComponent("InsertGhost", {
   type: "string",
-  props: field6("string", { default: "{}" }),
+  props: field7("string", { default: "{}" }),
   screenX: "f32",
   screenY: "f32"
 });
@@ -849,7 +1029,7 @@ var GhostCommitted = defineTag("GhostCommitted");
 var GhostRetiring = defineTag("GhostRetiring");
 
 // ../core/src/catalog/selection-presence.ts
-import { enumOf as enumOf4, field as field7 } from "@vibecook/strata-ecs";
+import { enumOf as enumOf5, field as field8 } from "@vibecook/strata-ecs";
 var Selected = defineTag("Selected");
 var Selectable = defineTag("Selectable");
 var Movable = defineTag("Movable");
@@ -857,102 +1037,22 @@ var Resizable = defineTag("Resizable");
 var SnapSource = defineTag("SnapSource");
 var SnapTarget = defineTag("SnapTarget");
 var SweepsContained = defineTag("SweepsContained");
+var KeyboardExclusive = defineTag("KeyboardExclusive");
 var PresencePeer = defineTag("PresencePeer");
 var PresenceInfo = defineComponent("PresenceInfo", { name: "string", color: "string" });
 var PresenceCursor = defineComponent("PresenceCursor", {
-  x: field7("f64", { default: 0 }),
-  y: field7("f64", { default: 0 }),
-  device: enumOf4(["mouse", "touch", "pen"])
-});
-var SelectionSummary = defineComponent("SelectionSummary", {
-  count: field7("u16", { default: 0 }),
-  x: field7("f64", { default: 0 }),
-  y: field7("f64", { default: 0 }),
-  w: field7("f32", { default: 0 }),
-  h: field7("f32", { default: 0 }),
-  keys: field7("string", { default: "[]" })
-});
-
-// ../core/src/catalog/camera-derived.ts
-import { enumOf as enumOf5, field as field8 } from "@vibecook/strata-ecs";
-var Camera = defineResource("Camera", {
-  x: field8("f64", { default: 0 }),
-  y: field8("f64", { default: 0 }),
-  zoom: field8("f32", { default: 1 }),
-  gesturing: field8("bool", { default: false })
-});
-var Viewport = defineResource("Viewport", {
-  w: field8("f32", { default: 0 }),
-  h: field8("f32", { default: 0 }),
-  dpr: field8("f32", { default: 1 })
-});
-var ActiveTool = defineResource("ActiveTool", { id: field8("string", { default: "select" }) });
-var StageMode = defineResource("StageMode", {
-  backgroundHolds: field8("u32", { default: 0 })
-});
-var SnapConfig = defineResource("SnapConfig", {
-  enabled: field8("bool", { default: SNAP_DEFAULTS.enabled }),
-  thresholdPx: field8("f32", { default: SNAP_DEFAULTS.thresholdPx })
-});
-var ContainerCamera = defineComponent("ContainerCamera", {
-  x: field8("f64", { default: 0 }),
-  y: field8("f64", { default: 0 }),
-  zoom: field8("f32", { default: 1 })
-});
-var Active = defineTag("Active");
-var Visible = defineTag("Visible");
-var Culled = defineTag("Culled");
-var WidgetBreakpoint = defineComponent("WidgetBreakpoint", {
-  tier: field8(enumOf5(["micro", "compact", "normal", "expanded", "detailed"]), { default: "normal" }),
-  w: field8("u16", { default: 0 }),
-  h: field8("u16", { default: 0 })
-});
-var MeasuredSize = defineComponent("MeasuredSize", {
-  w: field8("f32", { default: 0 }),
-  h: field8("f32", { default: 0 })
-});
-var SelectionBox = defineComponent("SelectionBox", {
   x: field8("f64", { default: 0 }),
   y: field8("f64", { default: 0 }),
-  w: field8("f32", { default: 0 }),
-  h: field8("f32", { default: 0 })
-});
-var HandleSpec = defineComponent("HandleSpec", {
-  anchor: enumOf5(["nw", "n", "ne", "e", "se", "s", "sw", "w"])
-});
-var GuideLine = defineComponent("GuideLine", {
-  axis: enumOf5(["x", "y"]),
-  at: field8("f64", { default: 0 }),
-  from: field8("f64", { default: 0 }),
-  to: field8("f64", { default: 0 })
+  device: enumOf5(["mouse", "touch", "pen"])
 });
-var SpacingBar = defineComponent("SpacingBar", {
-  axis: enumOf5(["x", "y"]),
-  from: field8("f64", { default: 0 }),
-  to: field8("f64", { default: 0 }),
-  perp: field8("f64", { default: 0 }),
-  gap: field8("f32", { default: 0 })
-});
-var MarqueeBox = defineComponent("MarqueeBox", {
+var SelectionSummary = defineComponent("SelectionSummary", {
+  count: field8("u16", { default: 0 }),
   x: field8("f64", { default: 0 }),
   y: field8("f64", { default: 0 }),
   w: field8("f32", { default: 0 }),
-  h: field8("f32", { default: 0 })
-});
-var CursorVisual = defineComponent("CursorVisual", {
-  kind: enumOf5(["local", "remote"]),
-  pressed: field8("bool", { default: false })
-});
-var Follows = defineRelation("Follows", { arity: "one" });
-var VisualOf = defineRelation("VisualOf", { arity: "one" });
-var NavDepth = defineComponent("NavDepth", { d: field8("u8", { default: 0 }) });
-var NavCamera = defineComponent("NavCamera", {
-  x: field8("f64", { default: 0 }),
-  y: field8("f64", { default: 0 }),
-  zoom: field8("f32", { default: 1 })
+  h: field8("f32", { default: 0 }),
+  keys: field8("string", { default: "[]" })
 });
-var NavFrame = defineRelation("NavFrame", { arity: "one" });
-var CanvasSurface = defineTag("CanvasSurface");
 
 // ../core/src/catalog/settings-resources.ts
 import { field as field9 } from "@vibecook/strata-ecs";
@@ -1019,6 +1119,7 @@ function makeVersionGuard(world, resources) {
 import { field as field10, enumOf as enumOf6 } from "@vibecook/strata-ecs";
 var WidgetEquipped = defineTag("WidgetEquipped");
 var registry2 = /* @__PURE__ */ new Map();
+var renameRegistry = /* @__PURE__ */ new Map();
 var widgets = {
   get(type) {
     return registry2.get(type);
@@ -1027,6 +1128,14 @@ var widgets = {
     return [...registry2.values()];
   }
 };
+var renames = {
+  get(oldType) {
+    return renameRegistry.get(oldType);
+  },
+  all() {
+    return [...renameRegistry.values()];
+  }
+};
 function normalizeProps(props) {
   if (props === void 0) return {};
   if ("kind" in props && props.kind === "object") {
@@ -1117,11 +1226,35 @@ function defineWidget(def) {
     fields[name] = spec;
   }
   const groups = [];
+  const rawByGroup = /* @__PURE__ */ new Map();
   for (const [g, fields] of byGroup) {
     const raw = {};
     for (const [name, spec] of Object.entries(fields)) raw[name] = strataFieldOf(name, spec);
+    rawByGroup.set(g, raw);
     groups.push({ name: g, component: defineComponent(`${def.type}:${g}`, raw), fields });
   }
+  const renameDecls = def.renamedFrom ?? [];
+  const legacyByOld = /* @__PURE__ */ new Map();
+  for (const decl of renameDecls) {
+    if (decl.type === def.type) {
+      throw new Error(`ice: widget "${def.type}" lists itself in renamedFrom.`);
+    }
+    if (registry2.has(decl.type)) {
+      throw new Error(`ice: widget "${def.type}" renamedFrom "${decl.type}" \u2014 that type is still a registered widget.`);
+    }
+    const holder = renameRegistry.get(decl.type);
+    if (holder !== void 0 && holder.widget.type !== def.type) {
+      throw new Error(`ice: widget "${def.type}" renamedFrom "${decl.type}" \u2014 already claimed by "${holder.widget.type}".`);
+    }
+    if (legacyByOld.has(decl.type)) {
+      throw new Error(`ice: widget "${def.type}" lists renamedFrom "${decl.type}" twice.`);
+    }
+    const legacy = [];
+    for (const g of groups) {
+      legacy.push(ensureComponent(`${decl.type}:${g.name}`, rawByGroup.get(g.name)));
+    }
+    legacyByOld.set(decl.type, legacy);
+  }
   const defaultSize = def.defaultSize ?? { w: 240, h: 160 };
   const essential = [
     init(Position, { x: 0, y: 0 }),
@@ -1175,6 +1308,7 @@ function defineWidget(def) {
   if (interaction.solid === true) capabilityTags.push(Solid);
   if (interaction.dragOn === "longPress") capabilityTags.push(LongPressDrag);
   if (interaction.sweepContained === true) capabilityTags.push(SweepsContained);
+  if (interaction.keyboard === "exclusive") capabilityTags.push(KeyboardExclusive);
   const snap = interaction.snap ?? "target";
   if (snap === "source" || snap === "both") capabilityTags.push(SnapSource);
   if (snap === "target" || snap === "both") capabilityTags.push(SnapTarget);
@@ -1194,11 +1328,21 @@ function defineWidget(def) {
     animated: def.animated === true,
     ports: def.ports ?? [],
     capabilityTags,
+    keyboard: interaction.keyboard ?? "shared",
+    keyboardEscape: interaction.keyboardEscape ?? "release",
     migrate: def.migrate ?? {},
     previewComponent: previewDecl.component,
     ...previewDecl.props !== void 0 ? { previewProps: previewDecl.props } : {}
   };
   registry2.set(def.type, widget);
+  for (const decl of renameDecls) {
+    renameRegistry.set(decl.type, {
+      widget,
+      oldType: decl.type,
+      atVersion: decl.atVersion ?? 1,
+      legacyGroups: legacyByOld.get(decl.type)
+    });
+  }
   return widget;
 }
 
@@ -2389,7 +2533,7 @@ var DEFAULT_SPAWN_PROFILES = {
 var anyKindQ = defineQuery7([Any(Tap, LongPress, Drag, Pinch, WheelPan, WheelZoom)]);
 var downQ = defineQuery7([Pointer, WentDown, Not(HandledByWidget), LocalPointer]);
 var heldTouchQ = defineQuery7([Pointer, PointerButtons, LocalPointer]);
-var wheelSourceQ = defineQuery7([Pointer, PointerWheel, LocalPointer]);
+var wheelSourceQ = defineQuery7([Pointer, PointerWheel, LocalPointer, Not(WheelHandled)]);
 var tapQ = defineQuery7([Tap, Not(GestureSuspended)]);
 var longPressQ = defineQuery7([LongPress, Not(GestureSuspended)]);
 var dragQ = defineQuery7([Drag, Not(GestureSuspended)]);
@@ -2823,7 +2967,8 @@ function createL2Systems({ world, profiles = DEFAULT_SPAWN_PROFILES }) {
         const screen = ctx.read(pointer, PointerScreen);
         const down = ctx.read(e, Down);
         const isZoom = ctx.has(e, WheelZoom);
-        const active = isZoom ? wheel.pinch !== 0 : wheel.dx !== 0 || wheel.dy !== 0;
+        const ceded = ctx.hasTag(pointer, WheelHandled);
+        const active = !ceded && (isZoom ? wheel.pinch !== 0 : wheel.dx !== 0 || wheel.dy !== 0);
         if (active) {
           if (isZoom) {
             ctx.edit(e).set(WheelZoom, { pinch: wheel.pinch, anchorX: screen.x, anchorY: screen.y });
@@ -3776,6 +3921,7 @@ function createCleanupSystems(world) {
         if (ctx.hasTag(e, WentUp)) ctx.removeTag(e, WentUp);
         if (ctx.hasTag(e, WentCancelled)) ctx.removeTag(e, WentCancelled);
         if (ctx.hasTag(e, HandledByWidget)) ctx.removeTag(e, HandledByWidget);
+        if (ctx.hasTag(e, WheelHandled)) ctx.removeTag(e, WheelHandled);
         const w = ctx.read(e, PointerWheel);
         if (w.dx !== 0 || w.dy !== 0 || w.pinch !== 0) {
           ctx.edit(e).set(PointerWheel, { dx: 0, dy: 0, pinch: 0 });
@@ -3869,7 +4015,8 @@ function createL0Systems(world, queue) {
             wheelDx: 0,
             wheelDy: 0,
             wheelPinch: 0,
-            hasWheel: false
+            hasWheel: false,
+            wheelHandled: false
           };
           samples.set(ev.pointerId, s);
         }
@@ -3891,6 +4038,7 @@ function createL0Systems(world, queue) {
           s.wheelDy += ev.wheel.dy;
           s.wheelPinch += ev.wheel.pinch;
           s.hasWheel = true;
+          if (ev.wheelHandled === true) s.wheelHandled = true;
         }
         if (ev.surfaceHandled === true) s.handled = true;
         if (ev.overInteractive !== void 0) s.overInteractive = ev.overInteractive;
@@ -3915,6 +4063,7 @@ function createL0Systems(world, queue) {
           if (s.wentUp) ctx.addTag(spawned, WentUp);
           if (s.wentCancelled) ctx.addTag(spawned, WentCancelled);
           if (s.handled) ctx.addTag(spawned, HandledByWidget);
+          if (s.wheelHandled) ctx.addTag(spawned, WheelHandled);
           if (s.overInteractive === true) ctx.addTag(spawned, OverInteractive);
           byId.set(id, spawned);
           continue;
@@ -3940,6 +4089,7 @@ function createL0Systems(world, queue) {
         if (s.wentUp) ctx.addTag(existing, WentUp);
         if (s.wentCancelled) ctx.addTag(existing, WentCancelled);
         if (s.handled) ctx.addTag(existing, HandledByWidget);
+        if (s.wheelHandled) ctx.addTag(existing, WheelHandled);
         if (s.overInteractive !== void 0 && s.overInteractive !== ctx.hasTag(existing, OverInteractive)) {
           if (s.overInteractive) ctx.addTag(existing, OverInteractive);
           else ctx.removeTag(existing, OverInteractive);
@@ -5300,6 +5450,28 @@ function installInteractionStack(engine, opts = {}) {
   };
 }
 
+// ../core/src/interaction/gesture-status.ts
+import { Any as Any4, defineQuery as defineQuery25 } from "@vibecook/strata-ecs";
+var gestureQ = defineQuery25([Any4(Tap, LongPress, Drag, Pinch, WheelPan, WheelZoom)]);
+var P13 = GesturePhases;
+function anyGestureNonTerminal(world) {
+  let active = false;
+  world.query(gestureQ).each((b) => {
+    for (const r of b) {
+      const e = b.entity(r);
+      const terminal = world.hasTag(e, P13.tags.Failed) || world.hasTag(e, P13.tags.Cancelled) || world.hasTag(e, P13.tags.Ended) || world.hasTag(e, P13.tags.Recognized) && world.has(e, Tap);
+      if (!terminal) {
+        active = true;
+        return;
+      }
+    }
+  });
+  return active;
+}
+function isMidGesture(world) {
+  return world.getResource(Camera)?.gesturing === true || anyGestureNonTerminal(world);
+}
+
 // ../core/src/doc/envelope.ts
 var ENVELOPE_MAGIC = "ICE1";
 var ENVELOPE_VERSION = 1;
@@ -5358,6 +5530,7 @@ function decodeEnvelope(bytes) {
 // ../core/src/doc/version-gate.ts
 var SCHEMA_PREFIX = "engine.schema.";
 var PACK_PREFIX = "engine.pack.";
+var RENAMED_PREFIX = "engine.renamed.";
 function stampEngineMeta(store) {
   store.metaTransaction((meta) => {
     const stamp = (key) => {
@@ -5370,14 +5543,50 @@ function stampEngineMeta(store) {
     }
   });
 }
+function foldRenames(rawPacks, tombstoned) {
+  const docPacks = {};
+  const renamedInDoc = {};
+  for (const [id, v] of Object.entries(rawPacks)) {
+    if (tombstoned.has(id)) continue;
+    const rename = renames.get(id);
+    if (rename !== void 0) {
+      renamedInDoc[id] = Math.max(renamedInDoc[id] ?? 0, v);
+      const target = rename.widget.type;
+      docPacks[target] = Math.max(docPacks[target] ?? 0, v);
+      continue;
+    }
+    docPacks[id] = Math.max(docPacks[id] ?? 0, v);
+  }
+  return { docPacks, renamedInDoc };
+}
+function compare(docPacks, localPacks) {
+  const newerInDoc = [];
+  const olderInDoc = [];
+  for (const [id, v] of Object.entries(docPacks)) {
+    const local = localPacks[id];
+    if (local === void 0 || v > local) newerInDoc.push(id);
+    else if (v < local) olderInDoc.push(id);
+  }
+  return { newerInDoc, olderInDoc };
+}
+function localPackVersions() {
+  const localPacks = {};
+  for (const p2 of prefabs.all()) {
+    if (p2.store === "durable") localPacks[p2.id] = p2.version ?? 1;
+  }
+  return localPacks;
+}
 function readDocVersionReport(doc) {
   const meta = doc.getMap("meta");
   let docSchema = 0;
-  const docPacks = {};
+  const rawPacks = {};
+  const tombstoned = /* @__PURE__ */ new Set();
   for (const key of meta.keys()) {
     if (key.startsWith(SCHEMA_PREFIX)) {
       const n = Number(key.slice(SCHEMA_PREFIX.length));
       if (Number.isInteger(n) && n > docSchema) docSchema = n;
+    } else if (key.startsWith(RENAMED_PREFIX)) {
+      tombstoned.add(key.slice(RENAMED_PREFIX.length));
     } else if (key.startsWith(PACK_PREFIX)) {
       const rest = key.slice(PACK_PREFIX.length);
       const dot = rest.lastIndexOf(".");
@@ -5385,56 +5594,42 @@ function readDocVersionReport(doc) {
       const id = rest.slice(0, dot);
       const v = Number(rest.slice(dot + 1));
       if (!Number.isInteger(v)) continue;
-      if ((docPacks[id] ?? 0) < v) docPacks[id] = v;
+      if ((rawPacks[id] ?? 0) < v) rawPacks[id] = v;
     }
   }
-  const localPacks = {};
-  for (const p2 of prefabs.all()) {
-    if (p2.store === "durable") localPacks[p2.id] = p2.version ?? 1;
-  }
-  const newerInDoc = [];
-  const olderInDoc = [];
-  for (const [id, v] of Object.entries(docPacks)) {
-    const local = localPacks[id];
-    if (local === void 0 || v > local) newerInDoc.push(id);
-    else if (v < local) olderInDoc.push(id);
-  }
-  return { docSchema, localSchema: ENGINE_SCHEMA_VERSION, docPacks, localPacks, newerInDoc, olderInDoc };
+  const localPacks = localPackVersions();
+  const { docPacks, renamedInDoc } = foldRenames(rawPacks, tombstoned);
+  const { newerInDoc, olderInDoc } = compare(docPacks, localPacks);
+  return { docSchema, localSchema: ENGINE_SCHEMA_VERSION, docPacks, localPacks, newerInDoc, olderInDoc, renamedInDoc };
 }
 function readEnvelopeVersionReport(header) {
-  const localPacks = {};
-  for (const p2 of prefabs.all()) {
-    if (p2.store === "durable") localPacks[p2.id] = p2.version ?? 1;
-  }
-  const docPacks = { ...header.prefabVersions };
-  const newerInDoc = [];
-  const olderInDoc = [];
-  for (const [id, version] of Object.entries(docPacks)) {
-    const local = localPacks[id];
-    if (local === void 0 || version > local) newerInDoc.push(id);
-    else if (version < local) olderInDoc.push(id);
-  }
+  const localPacks = localPackVersions();
+  const { docPacks, renamedInDoc } = foldRenames(header.prefabVersions, /* @__PURE__ */ new Set());
+  const { newerInDoc, olderInDoc } = compare(docPacks, localPacks);
   return {
     docSchema: header.engineSchema,
     localSchema: ENGINE_SCHEMA_VERSION,
     docPacks,
     localPacks,
     newerInDoc,
-    olderInDoc
+    olderInDoc,
+    renamedInDoc
   };
 }
 function gateVerdict(report) {
   if (report.docSchema === 0) return "reject";
   if (report.docSchema > report.localSchema) return "readOnly";
   if (report.newerInDoc.length > 0) return "readOnly";
-  if (report.docSchema < report.localSchema || report.olderInDoc.length > 0) return "migrate";
+  if (report.docSchema < report.localSchema || report.olderInDoc.length > 0 || Object.keys(report.renamedInDoc).length > 0) {
+    return "migrate";
+  }
   return "ok";
 }
 
 // ../core/src/doc/migrate.ts
-import { defineQuery as defineQuery25 } from "@vibecook/strata-ecs";
+import { defineQuery as defineQuery26 } from "@vibecook/strata-ecs";
 var PACK_PREFIX2 = "engine.pack.";
-var allDurableQ = defineQuery25([PrefabId]);
+var allDurableQ = defineQuery26([PrefabId]);
 function runMigrations(ctx, report) {
   const { store, world } = ctx;
   const migrated = [];
@@ -5511,11 +5706,200 @@ function runMigrations(ctx, report) {
 import { LoroDoc } from "loro-crdt";
 import { attachDurable, createDurableStore } from "@vibecook/strata-ecs/durable";
 
+// ../core/src/doc/rename.ts
+import { defineQuery as defineQuery27 } from "@vibecook/strata-ecs";
+var PACK_PREFIX3 = "engine.pack.";
+var RENAMED_PREFIX2 = "engine.renamed.";
+var allDurableQ2 = defineQuery27([PrefabId]);
+function runRenames(ctx, report) {
+  const { store, world } = ctx;
+  const renamed = [];
+  for (const [oldId, docOldV] of Object.entries(report.renamedInDoc)) {
+    const entry = renames.get(oldId);
+    if (entry === void 0) continue;
+    const { widget, legacyGroups } = entry;
+    const plans = [];
+    world.query(allDurableQ2).each((batch) => {
+      for (const row of batch) {
+        const e = batch.entity(row);
+        if (world.read(e, PrefabId).id !== oldId) continue;
+        const legacyValues = [];
+        const newPresent = [];
+        for (let i = 0; i < widget.groups.length; i++) {
+          const legacy = world.get(e, legacyGroups[i]);
+          legacyValues.push(legacy);
+          newPresent.push(world.get(e, widget.groups[i].component) !== void 0);
+        }
+        plans.push({ e, legacyValues, newPresent });
+      }
+    });
+    if (plans.length > 0) {
+      store.transaction(
+        (tx) => {
+          for (const { e, legacyValues, newPresent } of plans) {
+            tx.edit(e).set(PrefabId, { id: widget.type });
+            for (let i = 0; i < widget.groups.length; i++) {
+              const value = legacyValues[i];
+              if (value === void 0) continue;
+              if (!newPresent[i]) {
+                tx.addComponent(e, widget.groups[i].component, value);
+              }
+              tx.removeComponent(e, legacyGroups[i]);
+            }
+          }
+        },
+        { undoable: false }
+      );
+    }
+    store.metaTransaction((meta) => {
+      const tomb = `${RENAMED_PREFIX2}${oldId}`;
+      if (meta.get(tomb) === void 0) meta.set(tomb, widget.type);
+      const pack = `${PACK_PREFIX3}${widget.type}.${docOldV}`;
+      if (meta.get(pack) === void 0) meta.set(pack, true);
+    });
+    renamed.push(oldId);
+  }
+  return { renamed };
+}
+
+// ../core/src/doc/rename-sweep.ts
+import { Any as Any5, defineQuery as defineQuery28 } from "@vibecook/strata-ecs";
+var RENAMED_PREFIX3 = "engine.renamed.";
+var prefabQ = defineQuery28([PrefabId]);
+var legacyQByEntry = /* @__PURE__ */ new WeakMap();
+function legacyQueryOf(entry) {
+  if (entry.legacyGroups.length === 0) return void 0;
+  let q = legacyQByEntry.get(entry);
+  if (q === void 0) {
+    q = entry.legacyGroups.length === 1 ? defineQuery28([entry.legacyGroups[0]]) : defineQuery28([Any5(...entry.legacyGroups)]);
+    legacyQByEntry.set(entry, q);
+  }
+  return q;
+}
+function chainCovered(entry) {
+  for (let v = entry.atVersion; v < entry.widget.version; v++) {
+    if (typeof entry.widget.migrate[v] !== "function") return false;
+  }
+  return true;
+}
+function armRenameSweep(world, store) {
+  const entries = renames.all();
+  if (entries.length === 0) return () => {
+  };
+  let pending = false;
+  let disposed = false;
+  const warnedGap = /* @__PURE__ */ new Set();
+  const sweep = () => {
+    for (const entry of entries) {
+      const { widget, legacyGroups, oldType } = entry;
+      const covered = chainCovered(entry);
+      const seen = /* @__PURE__ */ new Set();
+      const plans = [];
+      const consider = (e) => {
+        if (seen.has(e)) return;
+        seen.add(e);
+        const id = world.get(e, PrefabId)?.id;
+        const rewriteId = id === oldType;
+        let anyLegacy = false;
+        const flat = {};
+        const removeLegacy = [];
+        for (let i = 0; i < widget.groups.length; i++) {
+          const legacy = world.get(e, legacyGroups[i]);
+          if (legacy === void 0) continue;
+          anyLegacy = true;
+          Object.assign(flat, legacy);
+          removeLegacy.push(legacyGroups[i]);
+        }
+        if (!rewriteId && !anyLegacy) return;
+        if (!rewriteId && anyLegacy && id !== widget.type) return;
+        if (anyLegacy && !covered) {
+          if (!warnedGap.has(oldType)) {
+            warnedGap.add(oldType);
+            console.warn(
+              `ice: rename sweep \u2014 "${oldType}" values are at pack v${entry.atVersion} but "${widget.type}"'s migrate chain has a gap; leaving legacy cells in place (design-008 \xA76.3).`
+            );
+          }
+          return;
+        }
+        let folded = flat;
+        for (let v = entry.atVersion; v < widget.version; v++) {
+          const step = widget.migrate[v];
+          if (typeof step === "function") folded = step(folded);
+        }
+        const writeGroups = [];
+        if (anyLegacy) {
+          for (let i = 0; i < widget.groups.length; i++) {
+            const present = world.get(e, widget.groups[i].component) !== void 0;
+            if (!present) writeGroups.push(i);
+          }
+        }
+        plans.push({ e, rewriteId, folded, writeGroups, removeLegacy });
+      };
+      if (legacyGroups.length === 0) {
+        world.query(prefabQ).each((batch) => {
+          for (const row of batch) {
+            const e = batch.entity(row);
+            if (world.read(e, PrefabId).id === oldType) consider(e);
+          }
+        });
+      }
+      const legacyQ = legacyQueryOf(entry);
+      if (legacyQ !== void 0) {
+        world.query(legacyQ).each((batch) => {
+          for (const row of batch) consider(batch.entity(row));
+        });
+      }
+      if (plans.length === 0) continue;
+      store.transaction(
+        (tx) => {
+          for (const plan of plans) {
+            if (plan.rewriteId) tx.edit(plan.e).set(PrefabId, { id: widget.type });
+            for (const i of plan.writeGroups) {
+              tx.addComponent(plan.e, widget.groups[i].component, plan.folded);
+            }
+            for (const legacy of plan.removeLegacy) tx.removeComponent(plan.e, legacy);
+          }
+        },
+        { undoable: false }
+      );
+      store.metaTransaction((meta) => {
+        const tomb = `${RENAMED_PREFIX3}${oldType}`;
+        if (meta.get(tomb) === void 0) meta.set(tomb, widget.type);
+      });
+    }
+  };
+  const schedule = () => {
+    if (pending || disposed) return;
+    pending = true;
+    queueMicrotask(() => {
+      pending = false;
+      if (!disposed) sweep();
+    });
+  };
+  const watchers = [];
+  let anyZeroProp = false;
+  for (const entry of entries) {
+    const q = legacyQueryOf(entry);
+    if (q !== void 0) {
+      watchers.push(world.reactive.observeQuery(q, schedule, { cols: [...entry.legacyGroups] }));
+    } else {
+      anyZeroProp = true;
+    }
+  }
+  if (anyZeroProp) {
+    watchers.push(world.reactive.observeQuery(prefabQ, schedule, { cols: [PrefabId] }));
+  }
+  return () => {
+    disposed = true;
+    for (const u of watchers) u();
+  };
+}
+
 // ../core/src/doc/schema-migrate.ts
-import { defineQuery as defineQuery26 } from "@vibecook/strata-ecs";
+import { defineQuery as defineQuery29 } from "@vibecook/strata-ecs";
 var SCHEMA_PREFIX2 = "engine.schema.";
 var BOARD_ROOT_META = "engine.boardRoot";
-var allDurableQ2 = defineQuery26([PrefabId]);
+var allDurableQ3 = defineQuery29([PrefabId]);
 function ensureBoardRoot(world, store) {
   let recorded;
   store.metaTransaction((meta) => {
@@ -5553,7 +5937,7 @@ function migrateToOrderedRelations(ctx) {
   const { store, world } = ctx;
   const root = ensureBoardRoot(world, store);
   const groups = /* @__PURE__ */ new Map();
-  world.query(allDurableQ2).each((batch) => {
+  world.query(allDurableQ3).each((batch) => {
     for (const row of batch) {
       const e = batch.entity(row);
       if (e === root) continue;
@@ -5627,6 +6011,7 @@ function makeSession(world, doc, store, attachment, readOnly, report) {
     mayDiverge: makeDefaultMayDiverge(world),
     cellInDoc: (e, c) => store.getComponent(e, c) !== void 0
   });
+  const disarmRenameSweep = readOnly ? void 0 : armRenameSweep(world, store);
   let closed = false;
   const remoteSubs = /* @__PURE__ */ new Set();
   return {
@@ -5658,6 +6043,7 @@ function makeSession(world, doc, store, attachment, readOnly, report) {
     close() {
       if (closed) return;
       closed = true;
+      disarmRenameSweep?.();
       cancelActiveGestures(world);
       store.setHistoryHooks(null);
       remoteSubs.clear();
@@ -5726,6 +6112,8 @@ function openDocSession(world, bytes, opts = {}) {
     if (verdict === "migrate" && (opts.migrate ?? true)) {
       try {
         runSchemaMigrations({ store, world }, report);
+        const renamed = runRenames({ store, world }, report);
+        if (renamed.renamed.length > 0) world.sync();
         runMigrations({ store, world }, readDocVersionReport(doc));
         effectiveReport = readDocVersionReport(doc);
         readOnly = gateVerdict(effectiveReport) !== "ok";
@@ -5880,8 +6268,8 @@ var p = {
 };
 
 // ../core/src/widget/equip.ts
-import { Not as Not4, defineQuery as defineQuery27, defineSystem as defineSystem17 } from "@vibecook/strata-ecs";
-var unequippedQ = defineQuery27([PrefabId, Not4(WidgetEquipped)]);
+import { Not as Not4, defineQuery as defineQuery30, defineSystem as defineSystem17 } from "@vibecook/strata-ecs";
+var unequippedQ = defineQuery30([PrefabId, Not4(WidgetEquipped)]);
 function createWidgetEquipSystem() {
   return defineSystem17(
     unequippedQ,
@@ -5975,8 +6363,8 @@ function createMeasureIngest(world, queue) {
 }
 
 // ../core/src/widget/mount-store.ts
-import { Not as Not5, defineQuery as defineQuery29, defineTickSystem as defineTickSystem13 } from "@vibecook/strata-ecs";
-var widgetQ = defineQuery29([Position, Size, WidgetEquipped, Active]);
+import { Not as Not5, defineQuery as defineQuery32, defineTickSystem as defineTickSystem13 } from "@vibecook/strata-ecs";
+var widgetQ = defineQuery32([Position, Size, WidgetEquipped, Active]);
 function createWidgetRuntime(world, opts = {}) {
   const budget = opts.keepMounted ?? RUNTIME_BUDGETS.keepMountedWidgets;
   let lastWin = null;
@@ -6059,8 +6447,8 @@ function createWidgetRuntime(world, opts = {}) {
   let snapshot = [];
   let dirty = false;
   const listeners = /* @__PURE__ */ new Set();
-  const visibleWidgetsQ = defineQuery29([Position, Size, WidgetEquipped, Active, Visible]);
-  const culledWidgetsQ = defineQuery29([Position, Size, WidgetEquipped, Not5(Visible)]);
+  const visibleWidgetsQ = defineQuery32([Position, Size, WidgetEquipped, Active, Visible]);
+  const culledWidgetsQ = defineQuery32([Position, Size, WidgetEquipped, Not5(Visible)]);
   const mountGuard = makeChurnGuard(world, { tags: [Visible, Culled], coarse: false });
   const mountSystem = defineTickSystem13(
     (ctx) => {
@@ -6204,23 +6592,6 @@ var DEFAULT_SNAP_GUIDES_CONFIG = {
 };
 
 // ../core/src/doc/autosave.ts
-import { Any as Any4, defineQuery as defineQuery30 } from "@vibecook/strata-ecs";
-var gestureQ = defineQuery30([Any4(Tap, LongPress, Drag, Pinch, WheelPan, WheelZoom)]);
-var P13 = GesturePhases;
-function anyGestureNonTerminal(world) {
-  let active = false;
-  world.query(gestureQ).each((b) => {
-    for (const r of b) {
-      const e = b.entity(r);
-      const terminal = world.hasTag(e, P13.tags.Failed) || world.hasTag(e, P13.tags.Cancelled) || world.hasTag(e, P13.tags.Ended) || world.hasTag(e, P13.tags.Recognized) && world.has(e, Tap);
-      if (!terminal) {
-        active = true;
-        return;
-      }
-    }
-  });
-  return active;
-}
 function defaultSchedule(fn, ms) {
   const id = setTimeout(fn, ms);
   return () => clearTimeout(id);
@@ -6251,7 +6622,7 @@ function startAutosave(session, opts) {
   let pendingUpdates = [];
   let writing = false;
   let writeInFlight = Promise.resolve();
-  const deferred = () => world.getResource(Camera)?.gesturing === true || anyGestureNonTerminal(world);
+  const deferred = () => isMidGesture(world);
   const clearTimer = () => {
     if (cancelTimer !== void 0) {
       cancelTimer();
@@ -6553,10 +6924,10 @@ function attachPresence(world, opts) {
 }
 
 // ../core/src/presence/publish.ts
-import { defineQuery as defineQuery31 } from "@vibecook/strata-ecs";
+import { defineQuery as defineQuery33 } from "@vibecook/strata-ecs";
 var SELECTION_KEY_CAP = 32;
 var COUNT_MAX = 65535;
-var localMouseQ = defineQuery31([Pointer, LocalPointer, PointerWorld]);
+var localMouseQ = defineQuery33([Pointer, LocalPointer, PointerWorld]);
 function createPresencePublish(world, session, opts = {}) {
   const { eph } = session;
   const keyOf = opts.keyOf;
@@ -6650,9 +7021,9 @@ function summaryEquals(a, b) {
 }
 
 // ../core/src/presence/remote-cursors.ts
-import { Not as Not6, defineQuery as defineQuery32, defineTickSystem as defineTickSystem14 } from "@vibecook/strata-ecs";
+import { Not as Not6, defineQuery as defineQuery34, defineTickSystem as defineTickSystem14 } from "@vibecook/strata-ecs";
 import { Local } from "@vibecook/strata-ecs";
-var remotePeerCursorsQ = defineQuery32([PresenceCursor, PresencePeer, Not6(Local)]);
+var remotePeerCursorsQ = defineQuery34([PresenceCursor, PresencePeer, Not6(Local)]);
 function createRemoteCursorsSystem(_world) {
   const pool = /* @__PURE__ */ new Map();
   return defineTickSystem14(
@@ -7036,7 +7407,7 @@ function webSocketByteChannel(ws) {
 }
 
 // ../core/src/facade/create-canvas-engine.ts
-import { createWorld, defineQuery as defineQuery33 } from "@vibecook/strata-ecs";
+import { createWorld, defineQuery as defineQuery35 } from "@vibecook/strata-ecs";
 
 // ../core/src/ops/insert.ts
 var IDENTITY_CAM5 = { x: 0, y: 0, zoom: 1 };
@@ -7092,7 +7463,7 @@ function createForwardingSink() {
     }
   };
 }
-var selectableWidgetsQ = defineQuery33([Position, Size, Selectable, Active, WidgetEquipped]);
+var selectableWidgetsQ = defineQuery35([Position, Size, Selectable, Active, WidgetEquipped]);
 function createCanvasEngine(opts = {}) {
   registerBuiltinTools();
   for (const w of opts.widgets ?? []) {
@@ -7439,6 +7810,14 @@ function createCanvasEngine(opts = {}) {
     isBackgrounded: () => stageHolds.size > 0,
     holds: () => [...stageHolds.values()]
   };
+  engine.frame.settleWhile("gestures", () => isMidGesture(world));
+  engine.frame.onChange(() => {
+    if (engine.frame.isFrozen()) {
+      cancelActiveGestures(world);
+      return;
+    }
+    stack.queue.drain();
+  });
   return {
     world,
     engine,
@@ -7448,6 +7827,7 @@ function createCanvasEngine(opts = {}) {
     ops,
     docs,
     stage,
+    frame: engine.frame,
     budgets,
     step: (now) => engine.step(now),
     dispose() {
@@ -7461,11 +7841,11 @@ function createCanvasEngine(opts = {}) {
 // ../core/src/index.ts
 import {
   All,
-  Any as Any5,
+  Any as Any6,
   Not as Not7,
   Related as Related2,
   createWorld as createWorld2,
-  defineQuery as defineQuery34,
+  defineQuery as defineQuery36,
   defineSystem as defineSystem19,
   defineTickSystem as defineTickSystem15,
   enumOf as enumOf8,
@@ -7502,9 +7882,35 @@ export {
   PHASE_GROUPS,
   createPipelineRegistry,
   createReflectorRegistry,
-  createEngine,
+  Camera,
+  Viewport,
+  ActiveTool,
+  StageMode,
+  FrameMode,
+  SnapConfig,
+  ContainerCamera,
+  Active,
+  Visible,
+  Culled,
+  WidgetBreakpoint,
+  MeasuredSize,
+  SelectionBox,
+  HandleSpec,
+  GuideLine,
+  SpacingBar,
+  MarqueeBox,
+  CursorVisual,
+  Follows,
+  VisualOf,
+  NavDepth,
+  NavCamera,
+  NavFrame,
+  CanvasSurface,
   setDevGuards,
   devGuardsEnabled,
+  SETTLE_CAP,
+  createFrameControl,
+  createEngine,
   createLiveWriter,
   guardedTransaction,
   writeRuntimeResource,
@@ -7536,6 +7942,7 @@ export {
   WentUp,
   WentCancelled,
   HandledByWidget,
+  WheelHandled,
   OverInteractive,
   LocalPointer,
   PointerWorld,
@@ -7596,33 +8003,11 @@ export {
   SnapSource,
   SnapTarget,
   SweepsContained,
+  KeyboardExclusive,
   PresencePeer,
   PresenceInfo,
   PresenceCursor,
   SelectionSummary,
-  Camera,
-  Viewport,
-  ActiveTool,
-  StageMode,
-  SnapConfig,
-  ContainerCamera,
-  Active,
-  Visible,
-  Culled,
-  WidgetBreakpoint,
-  MeasuredSize,
-  SelectionBox,
-  HandleSpec,
-  GuideLine,
-  SpacingBar,
-  MarqueeBox,
-  CursorVisual,
-  Follows,
-  VisualOf,
-  NavDepth,
-  NavCamera,
-  NavFrame,
-  CanvasSurface,
   ChromeSettings,
   GestureSettings,
   PointerSettings,
@@ -7635,6 +8020,7 @@ export {
   makeVersionGuard,
   WidgetEquipped,
   widgets,
+  renames,
   defineWidget,
   selectedEntities,
   setSelection,
@@ -7684,6 +8070,8 @@ export {
   ensureCanvasSurface,
   installInteractionCore,
   installInteractionStack,
+  anyGestureNonTerminal,
+  isMidGesture,
   ENVELOPE_MAGIC,
   ENVELOPE_VERSION,
   ENGINE_SCHEMA_VERSION,
@@ -7721,11 +8109,11 @@ export {
   createCanvasEngine,
   CORE_VERSION,
   All,
-  Any5 as Any,
+  Any6 as Any,
   Not7 as Not,
   Related2 as Related,
   createWorld2 as createWorld,
-  defineQuery34 as defineQuery,
+  defineQuery36 as defineQuery,
   defineSystem19 as defineSystem,
   defineTickSystem15 as defineTickSystem,
   enumOf8 as enumOf,
@@ -7733,4 +8121,4 @@ export {
   Local2 as Local,
   DurableUndoStatus
 };
-//# sourceMappingURL=chunk-DXU3RZZS.js.map
+//# sourceMappingURL=chunk-7LZAXQAO.js.map