@vibecook/ice 0.8.0 → 0.9.0

package/dist/{chunk-CBCSIEXW.js → chunk-E33I7R2Z.js}

@@ -16,7 +16,7 @@ import {
   createSiblingOrderIndex,
   defineQuery,
   widgets
-} from "./chunk-BE4F4X3Q.js";
+} from "./chunk-LBRHND4G.js";
 import {
   planeCssTransform,
   worldToScreen
@@ -1160,4 +1160,4 @@ export {
   wireMeasurement,
   DOM_VERSION
 };
-//# sourceMappingURL=chunk-CBCSIEXW.js.map
+//# sourceMappingURL=chunk-E33I7R2Z.js.map

package/dist/{chunk-3SUDKHUF.js → chunk-HM25ULBP.js}

@@ -12,7 +12,7 @@ import {
   keyboardClaimOf,
   startRafLoop,
   wireMeasurement
-} from "./chunk-CBCSIEXW.js";
+} from "./chunk-E33I7R2Z.js";
 import {
   ActiveTool,
   DurableUndoStatus,
@@ -33,7 +33,7 @@ import {
   tools,
   widgets,
   writeRuntimeResource
-} from "./chunk-BE4F4X3Q.js";
+} from "./chunk-LBRHND4G.js";
 
 // ../react/src/hooks.ts
 import { createContext, useCallback, useContext, useMemo, useRef, useSyncExternalStore } from "react";
@@ -673,4 +673,4 @@ export {
   InfiniteCanvas,
   REACT_VERSION
 };
-//# sourceMappingURL=chunk-3SUDKHUF.js.map
+//# sourceMappingURL=chunk-HM25ULBP.js.map

package/dist/{chunk-BE4F4X3Q.js → chunk-LBRHND4G.js}

@@ -1623,6 +1623,10 @@ function defaultsOf(schema) {
   for (const [name, spec] of Object.entries(schema)) out[name] = defaultValueOf(spec);
   return out;
 }
+var utf8 = new TextEncoder();
+function facetBytesOf(cell) {
+  return utf8.encode(JSON.stringify(cell)).length;
+}
 function signatureOf(spec, phase2) {
   const schema = spec.schema ?? {};
   return JSON.stringify({
@@ -1632,6 +1636,11 @@ function signatureOf(spec, phase2) {
     version: spec.version ?? 1,
     phase: phase2,
     tickWhile: spec.tick?.while ?? "all",
+    // The I19 byte claim is IDENTITY-BEARING: a redefinition that changes only
+    // the claim is a different declaration (hosts compare descriptors; the
+    // ensure-cache must agree). `?? null` because JSON.stringify drops
+    // undefined-valued keys, which would alias "no claim" with "absent field".
+    maxFacetBytes: spec.maxFacetBytes ?? null,
     // Field ORDER is part of the shape: it is the generated component's column
     // order, which the durable cell layout depends on.
     schema: Object.entries(schema).map(([k, s]) => [k, s.kind, defaultValueOf(s)]),
@@ -1679,6 +1688,17 @@ function validate(name, spec, phase2) {
   if (spec.budgetMs !== void 0 && (!Number.isFinite(spec.budgetMs) || spec.budgetMs <= 0)) {
     fail2(name, `budgetMs must be a positive number (got ${String(spec.budgetMs)}).`);
   }
+  if (spec.maxFacetBytes !== void 0) {
+    if (spec.store !== "ephemeral") {
+      fail2(
+        name,
+        `"maxFacetBytes" is ephemeral-only \u2014 it bounds the published presence facet, and only ephemeral behaviors publish one (petition I19).`
+      );
+    }
+    if (!Number.isSafeInteger(spec.maxFacetBytes) || spec.maxFacetBytes <= 0) {
+      fail2(name, `maxFacetBytes must be a positive integer byte count (got ${String(spec.maxFacetBytes)}).`);
+    }
+  }
   for (const [fieldName, s] of Object.entries(spec.schema ?? {})) {
     if (fieldName.length === 0) fail2(name, "schema field names must be non-empty.");
     if (typeof s !== "object" || s === null || typeof s.kind !== "string") {
@@ -1817,6 +1837,7 @@ function describeBehavior(behavior) {
     version: behavior.version,
     phase: behavior.phase,
     ...behavior.budgetMs === void 0 ? {} : { budgetMs: behavior.budgetMs },
+    ...behavior.maxFacetBytes === void 0 ? {} : { maxFacetBytes: behavior.maxFacetBytes },
     tickWhile: behavior.tickWhile,
     schema: Object.entries(behavior.schema).map(([name, spec]) => ({
       name,
@@ -1845,6 +1866,15 @@ function defineBehavior(name, spec) {
     return existing;
   }
   const schema = spec.schema ?? {};
+  const defaults = defaultsOf(schema);
+  if (spec.maxFacetBytes !== void 0 && spec.store === "ephemeral") {
+    const bytes = facetBytesOf(defaults);
+    if (bytes > spec.maxFacetBytes) {
+      throw new Error(
+        `ice: defineBehavior("${name}") \u2014 the default facet is ${bytes} bytes, over the behavior's own maxFacetBytes=${spec.maxFacetBytes} claim. Nothing was registered.`
+      );
+    }
+  }
   const raw = {};
   for (const [fieldName, s] of Object.entries(schema)) raw[fieldName] = strataFieldOf(name, fieldName, s);
   const component = ensureComponent(behaviorComponentName(name), raw);
@@ -1857,9 +1887,10 @@ function defineBehavior(name, spec) {
     version: spec.version ?? 1,
     phase: phase2,
     budgetMs: spec.budgetMs,
+    maxFacetBytes: spec.maxFacetBytes,
     schema,
     component,
-    defaults: defaultsOf(schema),
+    defaults,
     reads: spec.reads ?? [],
     writes: spec.writes ?? [],
     migrate: spec.migrate ?? {},
@@ -7920,7 +7951,7 @@ function createBehaviorRuntime(opts) {
       if (presence === void 0) return;
       const peer = presence.localPeer;
       if (!(world.isAlive(peer) && world.has(peer, this.own))) return;
-      const midTick = world.inImmediateProjectionUnsafeContext ?? false;
+      const midTick = world.inImmediateProjectionUnsafeContext;
       if (midTick) {
         const behaviorName = this.b.name;
         const own = this.own;
@@ -8486,6 +8517,15 @@ function createBehaviorRuntime(opts) {
       if (!world.isAlive(peer)) return;
       if (this.hookEntity !== void 0 && this.hookEntity !== peer) return;
       const cell = cellForBehavior(world, this.b, peer, patch);
+      const bound = this.b.maxFacetBytes;
+      if (bound !== void 0) {
+        const bytes = facetBytesOf(cell);
+        if (bytes > bound) {
+          throw new Error(
+            `ice: behavior "${this.b.name}" ctx.write produced a ${bytes}-byte facet, over its declared maxFacetBytes=${bound} \u2014 the write was refused and the prior facet left intact.`
+          );
+        }
+      }
       if (world.has(peer, this.own)) presence.eph.edit(peer).set(this.own, cell);
       else presence.eph.addComponent(peer, this.own, cell);
     }
@@ -8627,6 +8667,11 @@ function createBehaviorRuntime(opts) {
         },
         attach(e, behavior, data) {
           const other = behavior;
+          if (other.store === "ephemeral") {
+            throw new Error(
+              `ice: behavior "${node.b.name}" called tx.attach("${other.name}") \u2014 an ephemeral behavior's facet is presence data and cannot be attached into the document.`
+            );
+          }
           const cell = cellForBehavior(world, other, e, data ?? {});
           if (world.has(e, other.component)) {
             tx.edit(e).set(other.component, cell);
@@ -8635,6 +8680,11 @@ function createBehaviorRuntime(opts) {
           }
         },
         detach(e, behavior) {
+          if (behavior.store === "ephemeral") {
+            throw new Error(
+              `ice: behavior "${node.b.name}" called tx.detach("${behavior.name}") \u2014 ephemeral facets are withdrawn by the runtime (I17) or the presence layer's tombstones, never through the document.`
+            );
+          }
           tx.removeComponent(e, behavior.component);
         }
       };
@@ -8710,6 +8760,11 @@ function createBehaviorRuntime(opts) {
           `ice: engine.behaviors.attach("${b.name}") \u2014 durable attachment is a DOCUMENT op: use tx.attach inside a transaction so it syncs and undoes.`
         );
       }
+      if (b.store === "ephemeral") {
+        throw new Error(
+          `ice: engine.behaviors.attach("${b.name}") \u2014 an ephemeral behavior's facet is minted by the runtime on the local peer; it cannot be attached to an entity.`
+        );
+      }
       const cell = cellForBehavior(world, b, e, data ?? {});
       if (world.has(e, b.component)) world.edit(e).set(b.component, cell);
       else world.addComponent(e, b.component, cell);
@@ -8720,6 +8775,11 @@ function createBehaviorRuntime(opts) {
           `ice: engine.behaviors.detach("${b.name}") \u2014 durable detachment is a DOCUMENT op: use tx.detach inside a transaction.`
         );
       }
+      if (b.store === "ephemeral") {
+        throw new Error(
+          `ice: engine.behaviors.detach("${b.name}") \u2014 ephemeral facets are withdrawn by the runtime (I17) or the presence layer's tombstones, never detached through the world.`
+        );
+      }
       if (world.has(e, b.component)) world.removeComponent(e, b.component);
     },
     has: (e, b) => world.isAlive(e) && world.has(e, b.component),
@@ -9986,7 +10046,7 @@ var K_SNAPSHOT_OFFER = 2;
 var K_SNAPSHOT = 3;
 var K_UPDATE = 4;
 var K_PRESENCE = 5;
-var utf8 = new TextEncoder();
+var utf82 = new TextEncoder();
 var fromUtf8 = new TextDecoder();
 var defaultClock = {
   setTimeout: (fn, ms) => setTimeout(fn, ms),
@@ -10000,7 +10060,7 @@ function frame(kind, payload) {
   return out;
 }
 function frameSnapshot(targetId, snapshot) {
-  const id = utf8.encode(targetId);
+  const id = utf82.encode(targetId);
   const out = new Uint8Array(1 + 2 + id.length + snapshot.length);
   out[0] = K_SNAPSHOT;
   out[1] = id.length & 255;
@@ -10174,7 +10234,7 @@ function joinDoc(world, channel, opts = {}) {
       active = false;
       buffered.length = 0;
       opts.onSession?.(void 0);
-      send(frame(K_HELLO, utf8.encode(joinerId)));
+      send(frame(K_HELLO, utf82.encode(joinerId)));
       armTimeout();
     };
     const onFrame = (bytes) => {
@@ -10222,7 +10282,7 @@ function joinDoc(world, channel, opts = {}) {
     if (unsubPresence !== void 0) roomSubs.push(unsubPresence);
     const begin = () => {
       if (left) return;
-      send(frame(K_HELLO, utf8.encode(joinerId)));
+      send(frame(K_HELLO, utf82.encode(joinerId)));
       if (left) return;
       armTimeout();
     };
@@ -10844,7 +10904,7 @@ import {
   Local as Local3
 } from "@vibecook/strata-ecs";
 import { DurableUndoStatus } from "@vibecook/strata-ecs/durable";
-var CORE_VERSION = "0.8.0";
+var CORE_VERSION = "0.9.0";
 
 export {
   defineSchemaOnce,
@@ -11129,4 +11189,4 @@ export {
   Local3 as Local,
   DurableUndoStatus
 };
-//# sourceMappingURL=chunk-BE4F4X3Q.js.map
+//# sourceMappingURL=chunk-LBRHND4G.js.map