@vibecook/ice 0.6.0 → 0.7.0

package/dist/devtools.js

@@ -14,7 +14,7 @@ import {
   WheelPan,
   WheelZoom,
   Wire
-} from "./chunk-JLXETATP.js";
+} from "./chunk-LATXYFMO.js";
 import "./chunk-OR5FNVUE.js";
 
 // ../devtools/src/attach.ts

package/dist/dom.js

@@ -19,8 +19,8 @@ import {
   startRafLoop,
   wheelCede,
   wireMeasurement
-} from "./chunk-ELCBCTKY.js";
-import "./chunk-JLXETATP.js";
+} from "./chunk-55QCOE74.js";
+import "./chunk-LATXYFMO.js";
 import "./chunk-OR5FNVUE.js";
 export {
   CLAIM_OWNS_ESCAPE,

package/dist/ground.js

@@ -23,7 +23,7 @@ import {
   defineQuery,
   portSlots,
   widgets
-} from "./chunk-JLXETATP.js";
+} from "./chunk-LATXYFMO.js";
 import {
   portAnchor,
   tessellateCubic,

package/dist/index.js

@@ -228,6 +228,7 @@ import {
   defineTickSystem,
   defineTool,
   defineWidget,
+  describeBehavior,
   devGuardsEnabled,
   distPointToBox,
   docBehaviorVersion,
@@ -279,7 +280,7 @@ import {
   widgetSpawnInits,
   widgets,
   writeRuntimeResource
-} from "./chunk-JLXETATP.js";
+} from "./chunk-LATXYFMO.js";
 import "./chunk-OR5FNVUE.js";
 export {
   Accepts,
@@ -511,6 +512,7 @@ export {
   defineTickSystem,
   defineTool,
   defineWidget,
+  describeBehavior,
   devGuardsEnabled,
   distPointToBox,
   docBehaviorVersion,

package/dist/r3f.js

@@ -2,8 +2,8 @@ import {
   EngineProvider,
   hasPreviewSnapshot,
   setPreviewSnapshot
-} from "./chunk-BFT7YWS2.js";
-import "./chunk-ELCBCTKY.js";
+} from "./chunk-5OU3OWDH.js";
+import "./chunk-55QCOE74.js";
 import {
   Active,
   Camera,
@@ -26,7 +26,7 @@ import {
   navFlightActive,
   pickTopAt,
   widgets
-} from "./chunk-JLXETATP.js";
+} from "./chunk-LATXYFMO.js";
 import {
   compositeCameraFrustum,
   computeIslandPhase,

package/dist/react.js

@@ -25,9 +25,9 @@ import {
   useWidgetProps,
   useWorld,
   useWorldComponent
-} from "./chunk-BFT7YWS2.js";
-import "./chunk-ELCBCTKY.js";
-import "./chunk-JLXETATP.js";
+} from "./chunk-5OU3OWDH.js";
+import "./chunk-55QCOE74.js";
+import "./chunk-LATXYFMO.js";
 import "./chunk-OR5FNVUE.js";
 export {
   EngineProvider,

package/dist/types/packages/core/src/behavior/define-behavior.d.ts

@@ -15,7 +15,7 @@
  * depends on import order is a check that reports differently on a good day.
  */
 import type { Component } from "@vibecook/strata-ecs";
-import { type AnyBehaviorDef, type BehaviorHandle, type BehaviorRead, type BehaviorSchema, type BehaviorSpec, type BehaviorStore, type DataOf } from "./types";
+import { type AnyBehaviorDef, type BehaviorDescription, type BehaviorHandle, type BehaviorRead, type BehaviorSchema, type BehaviorSpec, type BehaviorStore, type DataOf } from "./types";
 /**
  * The generated component's name. Prefixed so a behavior can never collide
  * with `defineWidget`'s `<type>:<group>` components — and, because this string
@@ -46,6 +46,7 @@ export declare function classifyRead(r: BehaviorRead): {
 } | undefined;
 /** The read component a `reads:` entry contributes, if it contributes one. */
 export declare function readComponentOf(r: BehaviorRead): Component | undefined;
+export declare function describeBehavior(behavior: AnyBehaviorDef): BehaviorDescription;
 export declare function defineBehavior<const S extends BehaviorStore, const Sch extends BehaviorSchema = BehaviorSchema>(name: string, spec: BehaviorSpec<S, Sch>): BehaviorHandle<DataOf<Sch>>;
 /**
  * TEST-ONLY registry wipe (mirrors `__resetPrefabsForTests`; deliberately NOT

package/dist/types/packages/core/src/behavior/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { Component, Entity, World } from "@vibecook/strata-ecs";
-import type { GuestRegistry } from "../engine/guests";
+import type { GuestLedgerRecord, GuestRegistry } from "../engine/guests";
 import type { PhaseGroup } from "../engine/pipeline";
 import type { LiveWriter } from "../guards/live-writer";
 import { type BehaviorMeta } from "./migrate";
@@ -72,10 +72,24 @@ export interface BehaviorStatus {
     readonly failed: number;
     readonly ticking: number;
     readonly suspended: boolean;
+    /**
+     * The EPHEMERAL singleton was quarantined this generation (I17): its facet
+     * is withdrawn and stays withdrawn until a fresh registration. Without this
+     * field a quarantined singleton is indistinguishable from a dormant one —
+     * withdrawal makes the instance depart, so `failed` reads 0. Always false
+     * for durable/runtime behaviors (their quarantine stays visible in `failed`).
+     */
+    readonly quarantined: boolean;
+}
+export interface BehaviorRegistrationOptions {
+    /** Stable host policy key. Explicitly ordered registrations run before unkeyed registrations. */
+    readonly orderKey?: string;
+    /** Prior breaker state, normally persisted by a host across engine generations. */
+    readonly ledger?: GuestLedgerRecord;
 }
 export interface BehaviorRuntime {
     /** Compile + install a behavior. Returns an uninstaller. */
-    register(b: AnyBehaviorDef): () => void;
+    register(b: AnyBehaviorDef, options?: BehaviorRegistrationOptions): () => void;
     registered(): readonly AnyBehaviorDef[];
     /** Runtime/ephemeral attach from OUTSIDE a hook (the facade surface). */
     attach(e: Entity, b: AnyBehaviorDef, data?: Record<string, unknown>): void;

package/dist/types/packages/core/src/behavior/types.d.ts

@@ -15,7 +15,7 @@
  */
 import type { Component, Entity, Relation, Resource, Tag } from "@vibecook/strata-ecs";
 import type { GuardedTx } from "../guards/guarded-tx";
-import type { BooleanSpec, EntityKeySpec, EnumSpec, JsonSpec, NumberSpec, PropSpec, StringSpec } from "../widget/props";
+import type { BooleanSpec, EntityKeySpec, EnumSpec, JsonShape, JsonSpec, NumberSpec, PropSpec, StringSpec } from "../widget/props";
 export type BehaviorStore = "durable" | "runtime" | "ephemeral";
 /**
  * The CURATED phase set (design-009 §4.4, BF-D8) — a deliberate subset of the
@@ -31,6 +31,52 @@ export declare const BEHAVIOR_PHASES: Readonly<Record<BehaviorStore, readonly Be
 export declare const BEHAVIOR_DEFAULT_PHASE: Readonly<Record<BehaviorStore, BehaviorPhase>>;
 /** A behavior's declared data: the SAME `p.*` DSL `defineWidget` uses. */
 export type BehaviorSchema = Readonly<Record<string, PropSpec>>;
+export type BehaviorHookName = "init" | "update" | "changed" | "tick" | "dispose";
+export type BehaviorPropDescription = {
+    readonly kind: "string";
+    readonly default?: string;
+} | {
+    readonly kind: "number";
+    readonly default?: number;
+    readonly min?: number;
+    readonly max?: number;
+} | {
+    readonly kind: "boolean";
+    readonly default?: boolean;
+} | {
+    readonly kind: "enum";
+    readonly options: readonly string[];
+    readonly default?: string;
+} | {
+    readonly kind: "json";
+    readonly inner: JsonShape;
+    readonly default?: string;
+} | {
+    readonly kind: "entityKey";
+    readonly default?: string;
+};
+export interface BehaviorReadDescription {
+    readonly kind: "behavior" | "component" | "tag" | "relation" | "resource";
+    readonly name: string;
+}
+export interface BehaviorDescription {
+    readonly id: string;
+    readonly store: BehaviorStore;
+    readonly derived: boolean;
+    readonly deriveDuringGesture: boolean;
+    readonly version: number;
+    readonly phase: BehaviorPhase;
+    readonly budgetMs?: number;
+    readonly tickWhile: "all" | "visible";
+    readonly schema: readonly {
+        readonly name: string;
+        readonly spec: BehaviorPropDescription;
+    }[];
+    readonly reads: readonly BehaviorReadDescription[];
+    readonly writes: readonly string[];
+    readonly migrationFrom: readonly number[];
+    readonly hooks: readonly BehaviorHookName[];
+}
 type ValueOfSpec<S extends PropSpec> = S extends NumberSpec ? number : S extends BooleanSpec ? boolean : S extends EnumSpec ? string : S extends JsonSpec ? unknown : S extends StringSpec | EntityKeySpec ? string : never;
 /**
  * The hook-facing data view. `p.json` fields arrive PARSED (the cell is a

package/dist/types/packages/core/src/engine/guests.d.ts

@@ -79,8 +79,11 @@ export interface GuestSpec {
     /** Per-invocation budget request; the effective budget is
      *  `min(budgetMs, seamCapMs)` — no single guest may claim the whole seam. */
     readonly budgetMs?: number;
-    /** RESERVED. v1 hosts the publish slot only; pipeline-group values arrive
-     *  with the behavior framework (design-009 M13a), wrapped by this breaker. */
+    /** RESERVED. Hosted guests run in the publish slot only — and that is now the
+     *  settled shape, not a v1 placeholder: M13 reached pipeline cadence through
+     *  `addDriven` (behaviors run as pipeline systems and CHARGE this breaker)
+     *  instead of widening this field. A wider value would mean a second way to
+     *  put foreign code in the tick that `addDriven` already provides. */
     readonly phase?: "publish";
     /** Seed prior breaker state (host-persisted across engine generations). */
     readonly ledger?: GuestLedgerRecord;

package/dist/types/packages/core/src/facade/create-canvas-engine.d.ts

@@ -51,6 +51,16 @@ export interface CanvasEngineOpts {
      * what makes "a plugin declared it" and "this engine runs it" separable.
      */
     readonly behaviors?: readonly AnyBehaviorDef[];
+    /** Generic guest breaker routing for hosts that use the published facade. */
+    readonly onGuestFault?: (id: string, error: unknown) => void;
+    readonly onGuestNotice?: (message: string) => void;
+    /** Behavior-specific routing preserves hook and entity provenance. The two
+     *  pairs are COMPLEMENTARY, not alternatives: a fault that also strikes the
+     *  breaker (a thenable hook; throws spanning instances) reaches BOTH the
+     *  behavior route and the guest route — pass both, or the guest half of
+     *  those events still lands on the console default. */
+    readonly onBehaviorFault?: (behavior: string, hook: string, entity: Entity | undefined, error: unknown) => void;
+    readonly onBehaviorLog?: (behavior: string, message: string, rest: readonly unknown[]) => void;
     readonly budgets?: {
         readonly keepMounted?: number;
         readonly fboBytes?: number;

package/dist/types/packages/core/src/index.d.ts

@@ -3,7 +3,7 @@
  * scene systems · doc kit · publish step · engine facade · reflector registry.
  * Import wall: strata-ecs + @ice/kernel ONLY — never react/dom/three (enforced).
  */
-export declare const CORE_VERSION = "0.6.0";
+export declare const CORE_VERSION = "0.7.0";
 export { defineSchemaOnce, hmrInvalidateOnSchemaChange } from "./boot/hmr";
 export { All, Any, Not, Related, createWorld, defineQuery, defineSystem, defineTickSystem, enumOf, field, Local, } from "@vibecook/strata-ecs";
 export type { Batch, Component, Condition, Entity, OrderPlace, Pipeline, Query, Relation, Resource, System, SystemCtx, Tag, TickSystem, World, } from "@vibecook/strata-ecs";
@@ -16,8 +16,9 @@ export { createReflectorRegistry, type ReflectorDef, type ReflectorObserve, type
 export { createEngine, type Engine, type EngineOpts, type FrameTelemetry, type PublishHook, type SystemRunRecord, } from "./engine/engine";
 export { createFrameControl, SETTLE_CAP, type FrameControl } from "./engine/frame-control";
 export { createGuestRegistry, GUEST_BUDGET, type GuestFactory, type GuestFrame, type GuestGeneration, type GuestInstance, type GuestLedgerRecord, type GuestRegistry, type GuestRegistryOpts, type GuestRun, type GuestSpec, type GuestStatus, } from "./engine/guests";
-export { behaviors, defineBehavior } from "./behavior/define-behavior";
-export { BEHAVIOR_DEFAULT_PHASE, BEHAVIOR_PHASES, type AnyBehaviorAttachSpec, type AnyBehaviorDef, type BehaviorAttachSpec, type BehaviorChanges, type BehaviorCtxBase, type BehaviorCtxFor, type BehaviorFrame, type BehaviorHandle, type BehaviorHooks, type BehaviorPhase, type BehaviorQuery, type BehaviorQuerySpec, type BehaviorRead, type BehaviorSchema, type BehaviorSpec, type BehaviorStore, type BehaviorTx, type BehaviorWorld, type DataOf, type DurableBehaviorCtx, type EphemeralBehaviorCtx, type PeerFacet, type RuntimeBehaviorCtx, } from "./behavior/types";
+export { behaviors, defineBehavior, describeBehavior } from "./behavior/define-behavior";
+export type { BehaviorRegistrationOptions } from "./behavior/runtime";
+export { BEHAVIOR_DEFAULT_PHASE, BEHAVIOR_PHASES, type AnyBehaviorAttachSpec, type AnyBehaviorDef, type BehaviorAttachSpec, type BehaviorChanges, type BehaviorCtxBase, type BehaviorCtxFor, type BehaviorDescription, type BehaviorFrame, type BehaviorHandle, type BehaviorHookName, type BehaviorHooks, type BehaviorPhase, type BehaviorPropDescription, type BehaviorQuery, type BehaviorQuerySpec, type BehaviorRead, type BehaviorReadDescription, type BehaviorSchema, type BehaviorSpec, type BehaviorStore, type BehaviorTx, type BehaviorWorld, type DataOf, type DurableBehaviorCtx, type EphemeralBehaviorCtx, type PeerFacet, type RuntimeBehaviorCtx, } from "./behavior/types";
 export { compileBehavior, isDurableEligible, type CompiledBehavior } from "./behavior/compile";
 export { behaviorMarkerKey, classifyBehaviorVersion, docBehaviorVersion, stampBehaviorMarker, BEHAVIOR_MARKER_PREFIX, type BehaviorMeta, type BehaviorVerdict, } from "./behavior/migrate";
 export { createBehaviorHarness, type BehaviorHarness, type BehaviorHarnessOpts, type HarnessCommit, } from "./behavior/harness";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecook/ice",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "ICE — infinite canvas engine. Figma-grade infinite-canvas UX as a framework: defineWidget turns React/R3F components into canvas citizens — selectable, movable, resizable, wired into node graphs, CRDT-synced, undoable per gesture.",
   "license": "MIT",
   "author": "James Yong <me@jamesyong42.com>",