@vibecook/ice 0.3.0 → 0.4.0

package/dist/{chunk-5QY7HK6G.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);
@@ -837,6 +848,7 @@ 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", {
@@ -1025,6 +1037,7 @@ 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", {
@@ -1106,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);
@@ -1114,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") {
@@ -1204,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 }),
@@ -1262,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);
@@ -1281,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;
 }
 
@@ -2476,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)]);
@@ -2910,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 });
@@ -3863,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 });
@@ -3956,7 +4015,8 @@ function createL0Systems(world, queue) {
             wheelDx: 0,
             wheelDy: 0,
             wheelPinch: 0,
-            hasWheel: false
+            hasWheel: false,
+            wheelHandled: false
           };
           samples.set(ev.pointerId, s);
         }
@@ -3978,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;
@@ -4002,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;
@@ -4027,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);
@@ -5467,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) => {
@@ -5479,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(".");
@@ -5494,49 +5594,35 @@ 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";
 }
 
@@ -5620,11 +5706,200 @@ function runMigrations(ctx, report) {
 import { LoroDoc } from "loro-crdt";
 import { attachDurable, createDurableStore } from "@vibecook/strata-ecs/durable";
 
-// ../core/src/doc/schema-migrate.ts
+// ../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 defineQuery29 } from "@vibecook/strata-ecs";
 var SCHEMA_PREFIX2 = "engine.schema.";
 var BOARD_ROOT_META = "engine.boardRoot";
-var allDurableQ2 = defineQuery27([PrefabId]);
+var allDurableQ3 = defineQuery29([PrefabId]);
 function ensureBoardRoot(world, store) {
   let recorded;
   store.metaTransaction((meta) => {
@@ -5662,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;
@@ -5736,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 {
@@ -5767,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();
@@ -5835,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";
@@ -5989,8 +6268,8 @@ var p = {
 };
 
 // ../core/src/widget/equip.ts
-import { Not as Not4, defineQuery as defineQuery28, defineSystem as defineSystem17 } from "@vibecook/strata-ecs";
-var unequippedQ = defineQuery28([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,
@@ -6084,8 +6363,8 @@ function createMeasureIngest(world, queue) {
 }
 
 // ../core/src/widget/mount-store.ts
-import { Not as Not5, defineQuery as defineQuery30, defineTickSystem as defineTickSystem13 } from "@vibecook/strata-ecs";
-var widgetQ = defineQuery30([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;
@@ -6168,8 +6447,8 @@ function createWidgetRuntime(world, opts = {}) {
   let snapshot = [];
   let dirty = false;
   const listeners = /* @__PURE__ */ new Set();
-  const visibleWidgetsQ = defineQuery30([Position, Size, WidgetEquipped, Active, Visible]);
-  const culledWidgetsQ = defineQuery30([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) => {
@@ -6645,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;
@@ -6742,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(
@@ -7128,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 };
@@ -7184,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 ?? []) {
@@ -7562,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,
@@ -7663,6 +7942,7 @@ export {
   WentUp,
   WentCancelled,
   HandledByWidget,
+  WheelHandled,
   OverInteractive,
   LocalPointer,
   PointerWorld,
@@ -7723,6 +8003,7 @@ export {
   SnapSource,
   SnapTarget,
   SweepsContained,
+  KeyboardExclusive,
   PresencePeer,
   PresenceInfo,
   PresenceCursor,
@@ -7739,6 +8020,7 @@ export {
   makeVersionGuard,
   WidgetEquipped,
   widgets,
+  renames,
   defineWidget,
   selectedEntities,
   setSelection,
@@ -7827,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,
@@ -7839,4 +8121,4 @@ export {
   Local2 as Local,
   DurableUndoStatus
 };
-//# sourceMappingURL=chunk-5QY7HK6G.js.map
+//# sourceMappingURL=chunk-7LZAXQAO.js.map