@zylem/behaviors 0.4.1 → 0.5.2

package/dist/chunk-2PAHQZZD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/behaviors/screen-wrap/screen-wrap-fsm.ts","../src/lib/behaviors/screen-wrap/screen-wrap.descriptor.ts"],"sourcesContent":["/**\n * ScreenWrapFSM\n * \n * State machine for screen wrap behavior.\n * Reports position relative to bounds edges.\n */\n\nimport { SyncStateMachine, t } from '../../core/utility/sync-state-machine';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// FSM State Model\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport enum ScreenWrapState {\n\tCenter = 'center',\n\tNearEdgeLeft = 'near-edge-left',\n\tNearEdgeRight = 'near-edge-right',\n\tNearEdgeTop = 'near-edge-top',\n\tNearEdgeBottom = 'near-edge-bottom',\n\tWrapped = 'wrapped',\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// FSM Events\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport enum ScreenWrapEvent {\n\tEnterCenter = 'enter-center',\n\tApproachLeft = 'approach-left',\n\tApproachRight = 'approach-right',\n\tApproachTop = 'approach-top',\n\tApproachBottom = 'approach-bottom',\n\tWrap = 'wrap',\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ScreenWrapFSM\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport class ScreenWrapFSM {\n\tmachine: SyncStateMachine<ScreenWrapState, ScreenWrapEvent, never>;\n\n\tconstructor() {\n\t\tthis.machine = new SyncStateMachine<ScreenWrapState, ScreenWrapEvent, never>(\n\t\t\tScreenWrapState.Center,\n\t\t\t[\n\t\t\t\t// From Center\n\t\t\t\tt(ScreenWrapState.Center, ScreenWrapEvent.ApproachLeft, ScreenWrapState.NearEdgeLeft),\n\t\t\t\tt(ScreenWrapState.Center, ScreenWrapEvent.ApproachRight, ScreenWrapState.NearEdgeRight),\n\t\t\t\tt(ScreenWrapState.Center, ScreenWrapEvent.ApproachTop, ScreenWrapState.NearEdgeTop),\n\t\t\t\tt(ScreenWrapState.Center, ScreenWrapEvent.ApproachBottom, ScreenWrapState.NearEdgeBottom),\n\t\t\t\t\n\t\t\t\t// From NearEdge to Wrapped\n\t\t\t\tt(ScreenWrapState.NearEdgeLeft, ScreenWrapEvent.Wrap, ScreenWrapState.Wrapped),\n\t\t\t\tt(ScreenWrapState.NearEdgeRight, ScreenWrapEvent.Wrap, ScreenWrapState.Wrapped),\n\t\t\t\tt(ScreenWrapState.NearEdgeTop, ScreenWrapEvent.Wrap, ScreenWrapState.Wrapped),\n\t\t\t\tt(ScreenWrapState.NearEdgeBottom, ScreenWrapEvent.Wrap, ScreenWrapState.Wrapped),\n\n\t\t\t\t// From NearEdge back to Center\n\t\t\t\tt(ScreenWrapState.NearEdgeLeft, ScreenWrapEvent.EnterCenter, ScreenWrapState.Center),\n\t\t\t\tt(ScreenWrapState.NearEdgeRight, ScreenWrapEvent.EnterCenter, ScreenWrapState.Center),\n\t\t\t\tt(ScreenWrapState.NearEdgeTop, ScreenWrapEvent.EnterCenter, ScreenWrapState.Center),\n\t\t\t\tt(ScreenWrapState.NearEdgeBottom, ScreenWrapEvent.EnterCenter, ScreenWrapState.Center),\n\n\t\t\t\t// From Wrapped back to Center\n\t\t\t\tt(ScreenWrapState.Wrapped, ScreenWrapEvent.EnterCenter, ScreenWrapState.Center),\n\n\t\t\t\t// From Wrapped to NearEdge (landed near opposite edge)\n\t\t\t\tt(ScreenWrapState.Wrapped, ScreenWrapEvent.ApproachLeft, ScreenWrapState.NearEdgeLeft),\n\t\t\t\tt(ScreenWrapState.Wrapped, ScreenWrapEvent.ApproachRight, ScreenWrapState.NearEdgeRight),\n\t\t\t\tt(ScreenWrapState.Wrapped, ScreenWrapEvent.ApproachTop, ScreenWrapState.NearEdgeTop),\n\t\t\t\tt(ScreenWrapState.Wrapped, ScreenWrapEvent.ApproachBottom, ScreenWrapState.NearEdgeBottom),\n\n\t\t\t\t// Self-transitions (no-ops for redundant events)\n\t\t\t\tt(ScreenWrapState.Center, ScreenWrapEvent.EnterCenter, ScreenWrapState.Center),\n\t\t\t\tt(ScreenWrapState.NearEdgeLeft, ScreenWrapEvent.ApproachLeft, ScreenWrapState.NearEdgeLeft),\n\t\t\t\tt(ScreenWrapState.NearEdgeRight, ScreenWrapEvent.ApproachRight, ScreenWrapState.NearEdgeRight),\n\t\t\t\tt(ScreenWrapState.NearEdgeTop, ScreenWrapEvent.ApproachTop, ScreenWrapState.NearEdgeTop),\n\t\t\t\tt(ScreenWrapState.NearEdgeBottom, ScreenWrapEvent.ApproachBottom, ScreenWrapState.NearEdgeBottom),\n\t\t\t]\n\t\t);\n\t}\n\n\tgetState(): ScreenWrapState {\n\t\treturn this.machine.getState();\n\t}\n\n\tdispatch(event: ScreenWrapEvent): void {\n\t\tif (this.machine.can(event)) {\n\t\t\tthis.machine.syncDispatch(event);\n\t\t}\n\t}\n\n\t/**\n\t * Update FSM based on entity position relative to bounds\n\t */\n\tupdate(position: { x: number; y: number }, bounds: {\n\t\tminX: number; maxX: number; minY: number; maxY: number;\n\t\tedgeThreshold: number;\n\t}, wrapped: boolean): void {\n\t\tconst { x, y } = position;\n\t\tconst { minX, maxX, minY, maxY, edgeThreshold } = bounds;\n\n\t\tif (wrapped) {\n\t\t\tthis.dispatch(ScreenWrapEvent.Wrap);\n\t\t\treturn;\n\t\t}\n\n\t\t// Check if near edges\n\t\tconst nearLeft = x < minX + edgeThreshold;\n\t\tconst nearRight = x > maxX - edgeThreshold;\n\t\tconst nearBottom = y < minY + edgeThreshold;\n\t\tconst nearTop = y > maxY - edgeThreshold;\n\n\t\tif (nearLeft) {\n\t\t\tthis.dispatch(ScreenWrapEvent.ApproachLeft);\n\t\t} else if (nearRight) {\n\t\t\tthis.dispatch(ScreenWrapEvent.ApproachRight);\n\t\t} else if (nearTop) {\n\t\t\tthis.dispatch(ScreenWrapEvent.ApproachTop);\n\t\t} else if (nearBottom) {\n\t\t\tthis.dispatch(ScreenWrapEvent.ApproachBottom);\n\t\t} else {\n\t\t\tthis.dispatch(ScreenWrapEvent.EnterCenter);\n\t\t}\n\t}\n}\n","/**\n * ScreenWrapBehavior\n * \n * When an entity exits the defined 2D bounds, it wraps around to the opposite edge.\n * Asteroids-style screen wrapping with FSM for edge detection.\n */\n\nimport { defineBehavior } from '../behavior-descriptor';\nimport type { BehaviorEntityLink, BehaviorSystem } from '../behavior-system';\nimport { ScreenWrapFSM } from './screen-wrap-fsm';\nimport { createBounds2DRect } from '../shared/bounds-2d';\nimport type { BehaviorRuntime } from '../../runtime/wasm-stage-runtime';\n\n/**\n * Screen wrap options (typed for entity.use() autocomplete)\n */\nexport interface ScreenWrapOptions {\n\t/** Width of the wrapping area (default: 20) */\n\twidth: number;\n\t/** Height of the wrapping area (default: 15) */\n\theight: number;\n\t/** Center X position (default: 0) */\n\tcenterX: number;\n\t/** Center Y position (default: 0) */\n\tcenterY: number;\n\t/** Distance from edge to trigger NearEdge state (default: 2) */\n\tedgeThreshold: number;\n}\n\nconst defaultOptions: ScreenWrapOptions = {\n\twidth: 20,\n\theight: 15,\n\tcenterX: 0,\n\tcenterY: 0,\n\tedgeThreshold: 2,\n};\n\nconst SCREEN_WRAP_BEHAVIOR_KEY = Symbol.for('zylem:behavior:screen-wrap');\n\n/**\n * ScreenWrapSystem - Wraps entities around 2D bounds\n *\n * The Rust `screen_wrap` Stage behavior owns the wrap; this system attaches\n * it and mirrors the queried state into the local FSM so handles can observe\n * edge/wrap states.\n */\nclass ScreenWrapSystem implements BehaviorSystem {\n\tprivate attachedRuntimeSlots = new Set<number>();\n\n\tconstructor(\n\t\tprivate wasmStage: BehaviorRuntime | null,\n\t\tprivate getBehaviorLinks?: (key: symbol) => Iterable<BehaviorEntityLink>,\n\t) {}\n\n\tupdate(_ecs: unknown, _delta: number): void {\n\t\tconst links = this.getBehaviorLinks?.(SCREEN_WRAP_BEHAVIOR_KEY);\n\t\tif (!links) return;\n\n\t\tfor (const link of links) {\n\t\t\tconst gameEntity = link.entity as any;\n\t\t\tconst wrapRef = link.ref as any;\n\t\t\tconst options = wrapRef.options as ScreenWrapOptions;\n\n\t\t\tif (!wrapRef.fsm) {\n\t\t\t\twrapRef.fsm = new ScreenWrapFSM();\n\t\t\t}\n\n\t\t\tconst handle = (gameEntity.runtimeHandle ?? -1) as number;\n\t\t\tif (!this.wasmStage || handle < 0) continue;\n\n\t\t\tthis.ensureWasmAttached(handle, options);\n\t\t\tconst pose = this.wasmStage.getPose(handle);\n\t\t\tconst query = this.wasmStage.queryScreenWrap(handle);\n\t\t\tif (pose && query) {\n\t\t\t\tconst bounds = createBounds2DRect(options);\n\t\t\t\twrapRef.fsm.update(\n\t\t\t\t\t{ x: pose.position[0], y: pose.position[1] },\n\t\t\t\t\t{\n\t\t\t\t\t\tminX: bounds.minX,\n\t\t\t\t\t\tmaxX: bounds.maxX,\n\t\t\t\t\t\tminY: bounds.minY,\n\t\t\t\t\t\tmaxY: bounds.maxY,\n\t\t\t\t\t\tedgeThreshold: options.edgeThreshold,\n\t\t\t\t\t},\n\t\t\t\t\tquery.lastWrappedAxes !== 0,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate ensureWasmAttached(handle: number, options: ScreenWrapOptions): void {\n\t\tif (!this.wasmStage || this.attachedRuntimeSlots.has(handle)) return;\n\t\tthis.wasmStage.attachScreenWrap(handle, {\n\t\t\twidth: options.width,\n\t\t\theight: options.height,\n\t\t\tcenterX: options.centerX,\n\t\t\tcenterY: options.centerY,\n\t\t\tedgeThreshold: options.edgeThreshold,\n\t\t});\n\t\tthis.attachedRuntimeSlots.add(handle);\n\t}\n\n\tdestroy(_ecs: unknown): void {\n\t\tthis.attachedRuntimeSlots.clear();\n\t}\n}\n\n/**\n * ScreenWrapBehavior - Wraps entities around 2D bounds\n * \n * @example\n * ```typescript\n * import { ScreenWrapBehavior } from \"@zylem/game-lib/behavior\";\n * \n * const ship = createSprite({ ... });\n * const wrapRef = ship.use(ScreenWrapBehavior, { width: 20, height: 15 });\n * \n * // Access FSM to observe edge state\n * const fsm = wrapRef.getFSM();\n * console.log(fsm?.getState()); // 'center', 'near-edge-left', 'wrapped', etc.\n * ```\n */\nexport const ScreenWrapBehavior = defineBehavior({\n\tname: 'screen-wrap',\n\tdefaultOptions,\n\tsystemFactory: (ctx) =>\n\t\tnew ScreenWrapSystem(ctx.wasmStage ?? null, ctx.getBehaviorLinks),\n});\n"],"mappings":"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","names":["ScreenWrapState","ScreenWrapEvent"]}

package/dist/chunk-4CEW64HO.js

@@ -0,0 +1,210 @@
+import {
+  SyncStateMachine,
+  import_typescript_fsm
+} from "./chunk-AS3HR7AS.js";
+import {
+  STAGE_INPUT_BUTTON_JUMP,
+  readBehaviorSnapshot
+} from "./chunk-DZ4LLQON.js";
+import {
+  defineBehavior
+} from "./chunk-EZNCCO4L.js";
+
+// src/lib/behaviors/jumper-2d/components.ts
+function createJumpConfig2D(options = {}) {
+  return {
+    jumpHeight: options.jumpHeight ?? 2.5,
+    gravity: options.gravity ?? 20,
+    maxFallSpeed: options.maxFallSpeed,
+    maxJumps: options.maxJumps ?? 1,
+    resetJumpsOnGround: options.resetJumpsOnGround ?? true,
+    coyoteTimeMs: options.coyoteTimeMs ?? 100,
+    jumpBufferMs: options.jumpBufferMs ?? 80,
+    minTimeBetweenJumpsMs: options.minTimeBetweenJumpsMs,
+    variableJump: options.variableJump
+  };
+}
+function createJumpInput2D() {
+  return {
+    jumpPressed: false,
+    jumpHeld: false,
+    jumpReleased: false,
+    fastFall: false
+  };
+}
+function createJumpState2D() {
+  return {
+    jumpsUsed: 0,
+    lastJumpTimeMs: 0,
+    bufferedJumpMs: 0,
+    coyoteMs: 0,
+    isJumping: false,
+    jumpHoldMs: 0,
+    jumpCutApplied: false
+  };
+}
+
+// src/lib/behaviors/jumper-2d/jumper-2d-fsm.ts
+var Jumper2DState = /* @__PURE__ */ ((Jumper2DState2) => {
+  Jumper2DState2["Grounded"] = "grounded";
+  Jumper2DState2["Jumping"] = "jumping";
+  Jumper2DState2["Falling"] = "falling";
+  return Jumper2DState2;
+})(Jumper2DState || {});
+var Jumper2DEvent = /* @__PURE__ */ ((Jumper2DEvent2) => {
+  Jumper2DEvent2["Jump"] = "jump";
+  Jumper2DEvent2["Fall"] = "fall";
+  Jumper2DEvent2["Land"] = "land";
+  return Jumper2DEvent2;
+})(Jumper2DEvent || {});
+var Jumper2DFSM = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+    this.machine = new SyncStateMachine(
+      "grounded" /* Grounded */,
+      [
+        (0, import_typescript_fsm.t)("grounded" /* Grounded */, "jump" /* Jump */, "jumping" /* Jumping */),
+        (0, import_typescript_fsm.t)("grounded" /* Grounded */, "fall" /* Fall */, "falling" /* Falling */),
+        (0, import_typescript_fsm.t)("grounded" /* Grounded */, "land" /* Land */, "grounded" /* Grounded */),
+        (0, import_typescript_fsm.t)("jumping" /* Jumping */, "fall" /* Fall */, "falling" /* Falling */),
+        (0, import_typescript_fsm.t)("jumping" /* Jumping */, "land" /* Land */, "grounded" /* Grounded */),
+        (0, import_typescript_fsm.t)("jumping" /* Jumping */, "jump" /* Jump */, "jumping" /* Jumping */),
+        (0, import_typescript_fsm.t)("falling" /* Falling */, "land" /* Land */, "grounded" /* Grounded */),
+        (0, import_typescript_fsm.t)("falling" /* Falling */, "jump" /* Jump */, "jumping" /* Jumping */),
+        (0, import_typescript_fsm.t)("falling" /* Falling */, "fall" /* Fall */, "falling" /* Falling */)
+      ]
+    );
+  }
+  ctx;
+  machine;
+  getState() {
+    return this.machine.getState();
+  }
+  dispatch(event) {
+    if (this.machine.can(event)) {
+      this.machine.syncDispatch(event);
+    }
+  }
+  isJumping() {
+    return this.getState() === "jumping" /* Jumping */;
+  }
+  isGrounded() {
+    return this.getState() === "grounded" /* Grounded */;
+  }
+  getJumpsUsed() {
+    return this.ctx.state.jumpsUsed;
+  }
+  applyTickEvent(tickEvent, isGrounded) {
+    switch (tickEvent) {
+      case "jump":
+        this.dispatch("jump" /* Jump */);
+        break;
+      case "fall":
+        this.dispatch("fall" /* Fall */);
+        break;
+      case "land":
+        this.dispatch("land" /* Land */);
+        break;
+      default:
+        if (!isGrounded && this.getState() === "grounded" /* Grounded */) {
+          this.dispatch("fall" /* Fall */);
+        }
+        if (isGrounded && this.getState() !== "grounded" /* Grounded */) {
+          this.dispatch("land" /* Land */);
+        }
+        break;
+    }
+  }
+};
+
+// src/lib/behaviors/jumper-2d/jumper-2d.descriptor.ts
+var defaultOptions = {
+  jumpHeight: 2.5,
+  gravity: 20,
+  maxJumps: 1,
+  resetJumpsOnGround: true,
+  coyoteTimeMs: 100,
+  jumpBufferMs: 80,
+  groundRayLength: 1,
+  debugGroundProbe: false
+};
+var JUMPER_2D_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for("zylem:behavior:jumper-2d");
+var Jumper2DBehaviorSystem = class {
+  constructor(wasmStage, getBehaviorLinks) {
+    this.wasmStage = wasmStage;
+    this.getBehaviorLinks = getBehaviorLinks;
+  }
+  wasmStage;
+  getBehaviorLinks;
+  attachedRuntimeSlots = /* @__PURE__ */ new Set();
+  update(_ecs, _delta) {
+    const links = this.getBehaviorLinks?.(JUMPER_2D_BEHAVIOR_KEY);
+    if (!links) return;
+    for (const link of links) {
+      const gameEntity = link.entity;
+      const jumperRef = link.ref;
+      const options = jumperRef.options;
+      const handle = gameEntity.runtimeHandle ?? -1;
+      if (!this.wasmStage || handle < 0) continue;
+      if (!gameEntity.$jumper2d) {
+        gameEntity.$jumper2d = createJumpInput2D();
+      }
+      this.ensureWasmAttached(handle, options);
+      jumperRef.__wasmStage = this.wasmStage;
+      jumperRef.__entity = gameEntity;
+      const input = gameEntity.$jumper2d;
+      const jumpPressed = !!(input.jumpPressed || input.jumpHeld);
+      this.wasmStage.writeInputButton(handle, STAGE_INPUT_BUTTON_JUMP, jumpPressed);
+    }
+  }
+  ensureWasmAttached(handle, options) {
+    if (!this.wasmStage || this.attachedRuntimeSlots.has(handle)) return;
+    const jumpForce = Math.sqrt(2 * (options.gravity ?? 20) * (options.jumpHeight ?? 2.5));
+    this.wasmStage.attachJumper2D(handle, {
+      jumpForce,
+      maxJumps: options.maxJumps ?? 1,
+      jumpBufferTime: (options.jumpBufferMs ?? 80) / 1e3,
+      coyoteTime: (options.coyoteTimeMs ?? 100) / 1e3,
+      gravity: options.gravity ?? 20
+    });
+    this.attachedRuntimeSlots.add(handle);
+  }
+  destroy(_ecs) {
+    this.attachedRuntimeSlots.clear();
+  }
+};
+var Jumper2DBehavior = defineBehavior({
+  name: "jumper-2d",
+  defaultOptions,
+  systemFactory: (ctx) => new Jumper2DBehaviorSystem(ctx.wasmStage ?? null, ctx.getBehaviorLinks),
+  // Handles read the runtime snapshot buffer (previous-step values). The
+  // Rust behavior is the single source of truth.
+  createHandle: (ref) => {
+    const jumpsUsed = () => readBehaviorSnapshot(ref)?.jumpCount ?? 0;
+    return {
+      getState: () => {
+        const snapshot = readBehaviorSnapshot(ref);
+        if (!snapshot) return "grounded" /* Grounded */;
+        if (snapshot.grounded) return "grounded" /* Grounded */;
+        return snapshot.verticalVelocity > 0 ? "jumping" /* Jumping */ : "falling" /* Falling */;
+      },
+      isJumping: () => {
+        const snapshot = readBehaviorSnapshot(ref);
+        return snapshot ? !snapshot.grounded && snapshot.verticalVelocity > 0 : false;
+      },
+      getJumpsUsed: jumpsUsed,
+      getJumpsRemaining: () => (ref.options.maxJumps ?? 1) - jumpsUsed()
+    };
+  }
+});
+
+export {
+  createJumpConfig2D,
+  createJumpInput2D,
+  createJumpState2D,
+  Jumper2DState,
+  Jumper2DEvent,
+  Jumper2DFSM,
+  Jumper2DBehavior
+};
+//# sourceMappingURL=chunk-4CEW64HO.js.map

package/dist/chunk-4CEW64HO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/behaviors/jumper-2d/components.ts","../src/lib/behaviors/jumper-2d/jumper-2d-fsm.ts","../src/lib/behaviors/jumper-2d/jumper-2d.descriptor.ts"],"sourcesContent":["export interface JumpConfig2D {\n\tjumpHeight: number;\n\tgravity: number;\n\tmaxFallSpeed?: number;\n\tmaxJumps: number;\n\tresetJumpsOnGround: boolean;\n\tcoyoteTimeMs: number;\n\tjumpBufferMs: number;\n\tminTimeBetweenJumpsMs?: number;\n\tvariableJump?: {\n\t\tenabled: boolean;\n\t\tcutGravityMultiplier: number;\n\t\tmaxHoldMs?: number;\n\t};\n}\n\nexport function createJumpConfig2D(\n\toptions: Partial<JumpConfig2D> = {},\n): JumpConfig2D {\n\treturn {\n\t\tjumpHeight: options.jumpHeight ?? 2.5,\n\t\tgravity: options.gravity ?? 20,\n\t\tmaxFallSpeed: options.maxFallSpeed,\n\t\tmaxJumps: options.maxJumps ?? 1,\n\t\tresetJumpsOnGround: options.resetJumpsOnGround ?? true,\n\t\tcoyoteTimeMs: options.coyoteTimeMs ?? 100,\n\t\tjumpBufferMs: options.jumpBufferMs ?? 80,\n\t\tminTimeBetweenJumpsMs: options.minTimeBetweenJumpsMs,\n\t\tvariableJump: options.variableJump,\n\t};\n}\n\nexport interface JumpInput2D {\n\tjumpPressed: boolean;\n\tjumpHeld: boolean;\n\tjumpReleased: boolean;\n\tfastFall?: boolean;\n}\n\nexport function createJumpInput2D(): JumpInput2D {\n\treturn {\n\t\tjumpPressed: false,\n\t\tjumpHeld: false,\n\t\tjumpReleased: false,\n\t\tfastFall: false,\n\t};\n}\n\nexport interface JumpContext2D {\n\tdt: number;\n\tvelocityY: number;\n\tisGrounded: boolean;\n\ttimeSinceGroundedMs: number;\n\tsetVerticalVelocity(y: number): void;\n}\n\nexport interface JumpState2D {\n\tjumpsUsed: number;\n\tlastJumpTimeMs: number;\n\tbufferedJumpMs: number;\n\tcoyoteMs: number;\n\tisJumping: boolean;\n\tjumpHoldMs: number;\n\tjumpCutApplied: boolean;\n}\n\nexport function createJumpState2D(): JumpState2D {\n\treturn {\n\t\tjumpsUsed: 0,\n\t\tlastJumpTimeMs: 0,\n\t\tbufferedJumpMs: 0,\n\t\tcoyoteMs: 0,\n\t\tisJumping: false,\n\t\tjumpHoldMs: 0,\n\t\tjumpCutApplied: false,\n\t};\n}\n","import { SyncStateMachine, t } from '../../core/utility/sync-state-machine';\nimport type { JumpState2D } from './components';\n\nexport enum Jumper2DState {\n\tGrounded = 'grounded',\n\tJumping = 'jumping',\n\tFalling = 'falling',\n}\n\nexport enum Jumper2DEvent {\n\tJump = 'jump',\n\tFall = 'fall',\n\tLand = 'land',\n}\n\nexport interface Jumper2DFSMContext {\n\tstate: JumpState2D;\n}\n\nexport class Jumper2DFSM {\n\tmachine: SyncStateMachine<Jumper2DState, Jumper2DEvent, never>;\n\n\tconstructor(private ctx: Jumper2DFSMContext) {\n\t\tthis.machine = new SyncStateMachine<Jumper2DState, Jumper2DEvent, never>(\n\t\t\tJumper2DState.Grounded,\n\t\t\t[\n\t\t\t\tt(Jumper2DState.Grounded, Jumper2DEvent.Jump, Jumper2DState.Jumping),\n\t\t\t\tt(Jumper2DState.Grounded, Jumper2DEvent.Fall, Jumper2DState.Falling),\n\t\t\t\tt(Jumper2DState.Grounded, Jumper2DEvent.Land, Jumper2DState.Grounded),\n\t\t\t\tt(Jumper2DState.Jumping, Jumper2DEvent.Fall, Jumper2DState.Falling),\n\t\t\t\tt(Jumper2DState.Jumping, Jumper2DEvent.Land, Jumper2DState.Grounded),\n\t\t\t\tt(Jumper2DState.Jumping, Jumper2DEvent.Jump, Jumper2DState.Jumping),\n\t\t\t\tt(Jumper2DState.Falling, Jumper2DEvent.Land, Jumper2DState.Grounded),\n\t\t\t\tt(Jumper2DState.Falling, Jumper2DEvent.Jump, Jumper2DState.Jumping),\n\t\t\t\tt(Jumper2DState.Falling, Jumper2DEvent.Fall, Jumper2DState.Falling),\n\t\t\t],\n\t\t);\n\t}\n\n\tgetState(): Jumper2DState {\n\t\treturn this.machine.getState();\n\t}\n\n\tdispatch(event: Jumper2DEvent): void {\n\t\tif (this.machine.can(event)) {\n\t\t\tthis.machine.syncDispatch(event);\n\t\t}\n\t}\n\n\tisJumping(): boolean {\n\t\treturn this.getState() === Jumper2DState.Jumping;\n\t}\n\n\tisGrounded(): boolean {\n\t\treturn this.getState() === Jumper2DState.Grounded;\n\t}\n\n\tgetJumpsUsed(): number {\n\t\treturn this.ctx.state.jumpsUsed;\n\t}\n\n\tapplyTickEvent(tickEvent: string, isGrounded: boolean): void {\n\t\tswitch (tickEvent) {\n\t\t\tcase 'jump':\n\t\t\t\tthis.dispatch(Jumper2DEvent.Jump);\n\t\t\t\tbreak;\n\t\t\tcase 'fall':\n\t\t\t\tthis.dispatch(Jumper2DEvent.Fall);\n\t\t\t\tbreak;\n\t\t\tcase 'land':\n\t\t\t\tthis.dispatch(Jumper2DEvent.Land);\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tif (!isGrounded && this.getState() === Jumper2DState.Grounded) {\n\t\t\t\t\tthis.dispatch(Jumper2DEvent.Fall);\n\t\t\t\t}\n\t\t\t\tif (isGrounded && this.getState() !== Jumper2DState.Grounded) {\n\t\t\t\t\tthis.dispatch(Jumper2DEvent.Land);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t}\n\t}\n}\n","import { defineBehavior } from '../behavior-descriptor';\nimport type { BehaviorEntityLink, BehaviorSystem } from '../behavior-system';\nimport {\n\tcreateJumpInput2D,\n\ttype JumpConfig2D,\n\ttype JumpInput2D,\n\ttype JumpState2D,\n} from './components';\nimport { Jumper2DState } from './jumper-2d-fsm';\nimport {\n\tSTAGE_INPUT_BUTTON_JUMP,\n\treadBehaviorSnapshot,\n\ttype BehaviorRuntime,\n} from '../../runtime/wasm-stage-runtime';\n\nexport interface Jumper2DBehaviorOptions {\n\tjumpHeight?: number;\n\tgravity?: number;\n\tmaxFallSpeed?: number;\n\tmaxJumps?: number;\n\tresetJumpsOnGround?: boolean;\n\tcoyoteTimeMs?: number;\n\tjumpBufferMs?: number;\n\tminTimeBetweenJumpsMs?: number;\n\tvariableJump?: JumpConfig2D['variableJump'];\n\tgroundRayLength?: number;\n\tsnapToGroundDistance?: number;\n\tdebugGroundProbe?: boolean;\n}\n\nconst defaultOptions: Jumper2DBehaviorOptions = {\n\tjumpHeight: 2.5,\n\tgravity: 20,\n\tmaxJumps: 1,\n\tresetJumpsOnGround: true,\n\tcoyoteTimeMs: 100,\n\tjumpBufferMs: 80,\n\tgroundRayLength: 1,\n\tdebugGroundProbe: false,\n};\n\nconst JUMPER_2D_BEHAVIOR_KEY = Symbol.for('zylem:behavior:jumper-2d');\n\nexport function isJumper2DGrounded(params: {\n\tnearGround?: boolean;\n\tvelocityY: number;\n\tsupportToi?: number | null;\n\tsnapToGroundDistance?: number;\n}): boolean {\n\tif (params.velocityY > 0) {\n\t\treturn false;\n\t}\n\n\tif (params.snapToGroundDistance != null) {\n\t\treturn (\n\t\t\tparams.supportToi != null &&\n\t\t\tparams.supportToi <= params.snapToGroundDistance\n\t\t);\n\t}\n\n\treturn params.nearGround === true;\n}\n\nexport interface Jumper2DEntity {\n\tuuid: string;\n\ttransformStore: import('../../capabilities/transform-store').TransformState;\n\tjumper2d: JumpConfig2D;\n\t$jumper2d: JumpInput2D;\n\tjumper2dState: JumpState2D;\n}\n\n/**\n * Forwards jump input into the wasm runtime. The Rust `jumper_2d` Stage\n * behavior (ground probe + jump core) is the single simulation path; handles\n * read its state back via the snapshot buffer.\n */\nclass Jumper2DBehaviorSystem implements BehaviorSystem {\n\tprivate attachedRuntimeSlots = new Set<number>();\n\n\tconstructor(\n\t\tprivate wasmStage: BehaviorRuntime | null,\n\t\tprivate getBehaviorLinks?: (key: symbol) => Iterable<BehaviorEntityLink>,\n\t) {}\n\n\tupdate(_ecs: unknown, _delta: number): void {\n\t\tconst links = this.getBehaviorLinks?.(JUMPER_2D_BEHAVIOR_KEY);\n\t\tif (!links) return;\n\n\t\tfor (const link of links) {\n\t\t\tconst gameEntity = link.entity as any;\n\t\t\tconst jumperRef = link.ref as any;\n\n\t\t\tconst options = jumperRef.options as Jumper2DBehaviorOptions;\n\t\t\tconst handle = (gameEntity.runtimeHandle ?? -1) as number;\n\t\t\tif (!this.wasmStage || handle < 0) continue;\n\n\t\t\tif (!gameEntity.$jumper2d) {\n\t\t\t\tgameEntity.$jumper2d = createJumpInput2D();\n\t\t\t}\n\n\t\t\tthis.ensureWasmAttached(handle, options);\n\t\t\tjumperRef.__wasmStage = this.wasmStage;\n\t\t\tjumperRef.__entity = gameEntity;\n\t\t\tconst input = gameEntity.$jumper2d as JumpInput2D;\n\t\t\tconst jumpPressed = !!(input.jumpPressed || input.jumpHeld);\n\t\t\tthis.wasmStage.writeInputButton(handle, STAGE_INPUT_BUTTON_JUMP, jumpPressed);\n\t\t}\n\t}\n\n\tprivate ensureWasmAttached(handle: number, options: Jumper2DBehaviorOptions): void {\n\t\tif (!this.wasmStage || this.attachedRuntimeSlots.has(handle)) return;\n\t\tconst jumpForce = Math.sqrt(2 * (options.gravity ?? 20) * (options.jumpHeight ?? 2.5));\n\t\tthis.wasmStage.attachJumper2D(handle, {\n\t\t\tjumpForce,\n\t\t\tmaxJumps: options.maxJumps ?? 1,\n\t\t\tjumpBufferTime: (options.jumpBufferMs ?? 80) / 1000,\n\t\t\tcoyoteTime: (options.coyoteTimeMs ?? 100) / 1000,\n\t\t\tgravity: options.gravity ?? 20,\n\t\t});\n\t\tthis.attachedRuntimeSlots.add(handle);\n\t}\n\n\tdestroy(_ecs: unknown): void {\n\t\tthis.attachedRuntimeSlots.clear();\n\t}\n}\n\nexport const Jumper2DBehavior = defineBehavior<\n\tJumper2DBehaviorOptions,\n\t{\n\t\tgetState: () => Jumper2DState;\n\t\tisJumping: () => boolean;\n\t\tgetJumpsUsed: () => number;\n\t\tgetJumpsRemaining: () => number;\n\t},\n\tJumper2DEntity\n>({\n\tname: 'jumper-2d',\n\tdefaultOptions,\n\tsystemFactory: (ctx) =>\n\t\tnew Jumper2DBehaviorSystem(ctx.wasmStage ?? null, ctx.getBehaviorLinks),\n\t// Handles read the runtime snapshot buffer (previous-step values). The\n\t// Rust behavior is the single source of truth.\n\tcreateHandle: (ref) => {\n\t\tconst jumpsUsed = () => readBehaviorSnapshot(ref)?.jumpCount ?? 0;\n\t\treturn {\n\t\t\tgetState: () => {\n\t\t\t\tconst snapshot = readBehaviorSnapshot(ref);\n\t\t\t\tif (!snapshot) return Jumper2DState.Grounded;\n\t\t\t\tif (snapshot.grounded) return Jumper2DState.Grounded;\n\t\t\t\treturn snapshot.verticalVelocity > 0\n\t\t\t\t\t? Jumper2DState.Jumping\n\t\t\t\t\t: Jumper2DState.Falling;\n\t\t\t},\n\t\t\tisJumping: () => {\n\t\t\t\tconst snapshot = readBehaviorSnapshot(ref);\n\t\t\t\treturn snapshot ? !snapshot.grounded && snapshot.verticalVelocity > 0 : false;\n\t\t\t},\n\t\t\tgetJumpsUsed: jumpsUsed,\n\t\t\tgetJumpsRemaining: () => (ref.options.maxJumps ?? 1) - jumpsUsed(),\n\t\t};\n\t},\n});\n"],"mappings":"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","names":["Jumper2DState","Jumper2DEvent"]}

package/dist/chunk-4LLK2FJI.js

@@ -0,0 +1,344 @@
+import {
+  SyncStateMachine,
+  import_typescript_fsm
+} from "./chunk-AS3HR7AS.js";
+import {
+  STAGE_INPUT_BUTTON_JUMP,
+  STAGE_INPUT_BUTTON_RUN,
+  StagePlatformerShapeSource,
+  readBehaviorSnapshot
+} from "./chunk-DZ4LLQON.js";
+import {
+  defineBehavior
+} from "./chunk-EZNCCO4L.js";
+
+// src/lib/behaviors/platformer-3d/components.ts
+function createPlatformer3DMovementComponent(options = {}) {
+  return {
+    walkSpeed: options.walkSpeed ?? 12,
+    runSpeed: options.runSpeed ?? 24,
+    jumpForce: options.jumpForce ?? 12,
+    maxJumps: options.maxJumps ?? 1,
+    gravity: options.gravity ?? 9.82,
+    coyoteTime: options.coyoteTime ?? 0.1,
+    jumpBufferTime: options.jumpBufferTime ?? 0.1,
+    jumpCutMultiplier: options.jumpCutMultiplier ?? 0.5,
+    multiJumpWindowTime: options.multiJumpWindowTime ?? 0.15,
+    // 150ms default
+    slopeClimbAngle: options.slopeClimbAngle ?? 50,
+    slopeSlideAngle: options.slopeSlideAngle ?? 40,
+    autostep: options.autostep ?? { maxHeight: 0.3, minWidth: 0.1 },
+    snapToGroundDistance: options.snapToGroundDistance ?? 0.3,
+    characterOffset: options.characterOffset ?? 0.05
+  };
+}
+function createPlatformer3DInputComponent() {
+  return {
+    moveX: 0,
+    moveZ: 0,
+    jump: false,
+    run: false
+  };
+}
+function createPlatformer3DStateComponent() {
+  return {
+    grounded: false,
+    jumping: false,
+    falling: false,
+    jumpCount: 0,
+    jumpStartHeight: 0,
+    currentSpeed: 0,
+    lastGroundedY: 0,
+    jumpPressedLastFrame: false,
+    collisionGrounded: false,
+    groundedCollisionTime: 0,
+    timeSinceGrounded: 0,
+    jumpBuffered: false,
+    jumpBufferTimer: 0,
+    jumpHeld: false,
+    jumpCutApplied: false,
+    jumpReleasedSinceLastJump: true,
+    timeSinceJump: 0,
+    jumpedThisFrame: false,
+    jumpCutRampTimer: 0,
+    verticalVelocity: 0
+  };
+}
+
+// src/lib/behaviors/platformer-3d/platformer-3d-fsm.ts
+var Platformer3DState = /* @__PURE__ */ ((Platformer3DState2) => {
+  Platformer3DState2["Idle"] = "idle";
+  Platformer3DState2["Walking"] = "walking";
+  Platformer3DState2["Running"] = "running";
+  Platformer3DState2["Jumping"] = "jumping";
+  Platformer3DState2["Falling"] = "falling";
+  Platformer3DState2["Landing"] = "landing";
+  return Platformer3DState2;
+})(Platformer3DState || {});
+var Platformer3DEvent = /* @__PURE__ */ ((Platformer3DEvent2) => {
+  Platformer3DEvent2["Walk"] = "walk";
+  Platformer3DEvent2["Run"] = "run";
+  Platformer3DEvent2["Jump"] = "jump";
+  Platformer3DEvent2["Fall"] = "fall";
+  Platformer3DEvent2["Land"] = "land";
+  Platformer3DEvent2["Stop"] = "stop";
+  return Platformer3DEvent2;
+})(Platformer3DEvent || {});
+var Platformer3DFSM = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+    this.machine = new SyncStateMachine(
+      "idle" /* Idle */,
+      [
+        // Idle transitions
+        (0, import_typescript_fsm.t)("idle" /* Idle */, "walk" /* Walk */, "walking" /* Walking */),
+        (0, import_typescript_fsm.t)("idle" /* Idle */, "run" /* Run */, "running" /* Running */),
+        (0, import_typescript_fsm.t)("idle" /* Idle */, "jump" /* Jump */, "jumping" /* Jumping */),
+        (0, import_typescript_fsm.t)("idle" /* Idle */, "fall" /* Fall */, "falling" /* Falling */),
+        // Walking transitions
+        (0, import_typescript_fsm.t)("walking" /* Walking */, "run" /* Run */, "running" /* Running */),
+        (0, import_typescript_fsm.t)("walking" /* Walking */, "jump" /* Jump */, "jumping" /* Jumping */),
+        (0, import_typescript_fsm.t)("walking" /* Walking */, "stop" /* Stop */, "idle" /* Idle */),
+        (0, import_typescript_fsm.t)("walking" /* Walking */, "fall" /* Fall */, "falling" /* Falling */),
+        // Running transitions
+        (0, import_typescript_fsm.t)("running" /* Running */, "walk" /* Walk */, "walking" /* Walking */),
+        (0, import_typescript_fsm.t)("running" /* Running */, "jump" /* Jump */, "jumping" /* Jumping */),
+        (0, import_typescript_fsm.t)("running" /* Running */, "stop" /* Stop */, "idle" /* Idle */),
+        (0, import_typescript_fsm.t)("running" /* Running */, "fall" /* Fall */, "falling" /* Falling */),
+        // Jumping transitions
+        (0, import_typescript_fsm.t)("jumping" /* Jumping */, "fall" /* Fall */, "falling" /* Falling */),
+        (0, import_typescript_fsm.t)("jumping" /* Jumping */, "land" /* Land */, "landing" /* Landing */),
+        (0, import_typescript_fsm.t)("jumping" /* Jumping */, "jump" /* Jump */, "jumping" /* Jumping */),
+        // Multi-jump
+        // Falling transitions
+        (0, import_typescript_fsm.t)("falling" /* Falling */, "land" /* Land */, "landing" /* Landing */),
+        // Landing transitions
+        (0, import_typescript_fsm.t)("landing" /* Landing */, "walk" /* Walk */, "walking" /* Walking */),
+        (0, import_typescript_fsm.t)("landing" /* Landing */, "run" /* Run */, "running" /* Running */),
+        (0, import_typescript_fsm.t)("landing" /* Landing */, "stop" /* Stop */, "idle" /* Idle */),
+        // Self-transitions (no-ops)
+        (0, import_typescript_fsm.t)("idle" /* Idle */, "stop" /* Stop */, "idle" /* Idle */)
+      ]
+    );
+  }
+  ctx;
+  machine;
+  /**
+   * Get the current state
+   */
+  getState() {
+    return this.machine.getState();
+  }
+  /**
+   * Dispatch an event to the FSM
+   */
+  dispatch(event) {
+    if (this.machine.can(event)) {
+      this.machine.syncDispatch(event);
+    }
+  }
+  /**
+   * Check if grounded
+   */
+  isGrounded() {
+    const state = this.getState();
+    return state === "idle" /* Idle */ || state === "walking" /* Walking */ || state === "running" /* Running */ || state === "landing" /* Landing */;
+  }
+  /**
+   * Get current jump count from context
+   */
+  getJumpCount() {
+    return this.ctx.state.jumpCount;
+  }
+  /**
+   * Handle collision event to update ground state
+   */
+  handleCollision(ctx) {
+    if (ctx.contact.normal.y > 0.5) {
+      this.ctx.state.collisionGrounded = true;
+      this.ctx.state.groundedCollisionTime = performance.now();
+    }
+  }
+  /**
+   * Update FSM based on current state
+   */
+  update(input, state) {
+    this.ctx.input = input;
+    this.ctx.state = state;
+    const currentState = this.getState();
+    const hasInput = Math.abs(input.moveX) > 0.1 || Math.abs(input.moveZ) > 0.1;
+    const isRunning = input.run;
+    if (currentState === "falling" /* Falling */ && state.grounded) {
+      this.dispatch("land" /* Land */);
+    }
+    if (state.grounded) {
+      if (hasInput) {
+        if (isRunning) {
+          this.dispatch("run" /* Run */);
+        } else {
+          this.dispatch("walk" /* Walk */);
+        }
+      } else {
+        this.dispatch("stop" /* Stop */);
+      }
+    } else {
+      if (state.falling) {
+        this.dispatch("fall" /* Fall */);
+      }
+    }
+    if (input.jump && !state.jumpPressedLastFrame) {
+      this.dispatch("jump" /* Jump */);
+    }
+  }
+};
+
+// src/lib/behaviors/platformer-3d/platformer-3d.descriptor.ts
+var FSM_STATE_BY_INDEX = [
+  "idle" /* Idle */,
+  "walking" /* Walking */,
+  "running" /* Running */,
+  "jumping" /* Jumping */,
+  "falling" /* Falling */,
+  "landing" /* Landing */
+];
+var defaultOptions = {
+  walkSpeed: 12,
+  runSpeed: 24,
+  jumpForce: 12,
+  maxJumps: 1,
+  gravity: 9.82,
+  slopeClimbAngle: 50,
+  slopeSlideAngle: 40,
+  autostep: { maxHeight: 0.3, minWidth: 0.1 },
+  snapToGroundDistance: 0.3,
+  characterOffset: 0.05
+};
+var PLATFORMER_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for("zylem:behavior:platformer-3d");
+function resolvePlatformerAttachShape(options, gameEntity) {
+  const fallback = {
+    halfHeight: 0.9,
+    radius: 0.4,
+    offsetX: 0,
+    offsetY: 0,
+    offsetZ: 0,
+    shapeSource: StagePlatformerShapeSource.Auto
+  };
+  if (options.useAttachedCollider === false && options.shape) {
+    const offset = options.shape.offset ?? [0, 0, 0];
+    return {
+      halfHeight: options.shape.halfHeight,
+      radius: options.shape.radius,
+      offsetX: offset[0],
+      offsetY: offset[1],
+      offsetZ: offset[2],
+      shapeSource: StagePlatformerShapeSource.Override
+    };
+  }
+  const collider = gameEntity?.colliderDesc;
+  if (collider?.shape?.type === "capsule") {
+    const offset = collider.offset ?? [0, 0, 0];
+    return {
+      halfHeight: collider.shape.halfHeight ?? fallback.halfHeight,
+      radius: collider.shape.radius ?? fallback.radius,
+      offsetX: offset[0],
+      offsetY: offset[1],
+      offsetZ: offset[2],
+      shapeSource: StagePlatformerShapeSource.Auto
+    };
+  }
+  return fallback;
+}
+var Platformer3DBehaviorSystem = class {
+  constructor(wasmStage, getBehaviorLinks) {
+    this.wasmStage = wasmStage;
+    this.getBehaviorLinks = getBehaviorLinks;
+  }
+  wasmStage;
+  getBehaviorLinks;
+  attachedRuntimeSlots = /* @__PURE__ */ new Set();
+  update(_ecs, _delta) {
+    const links = this.getBehaviorLinks?.(PLATFORMER_BEHAVIOR_KEY);
+    if (!links) return;
+    for (const link of links) {
+      const gameEntity = link.entity;
+      const platformerRef = link.ref;
+      const options = platformerRef.options;
+      if (!gameEntity.platformer) {
+        gameEntity.platformer = createPlatformer3DMovementComponent(options);
+      }
+      if (!gameEntity.$platformer) {
+        gameEntity.$platformer = createPlatformer3DInputComponent();
+      }
+      if (!gameEntity.platformerState) {
+        gameEntity.platformerState = createPlatformer3DStateComponent();
+      }
+      const handle = gameEntity.runtimeHandle ?? -1;
+      if (!this.wasmStage || handle < 0) continue;
+      this.ensureWasmAttached(handle, options, gameEntity);
+      platformerRef.__wasmStage = this.wasmStage;
+      platformerRef.__entity = gameEntity;
+      const input = gameEntity.$platformer;
+      if (input) {
+        this.wasmStage.writeInputAxes(handle, input.moveX ?? 0, input.moveZ ?? 0);
+        this.wasmStage.writeInputButton(handle, STAGE_INPUT_BUTTON_JUMP, !!input.jump);
+        this.wasmStage.writeInputButton(handle, STAGE_INPUT_BUTTON_RUN, !!input.run);
+      }
+    }
+  }
+  ensureWasmAttached(handle, options, gameEntity) {
+    if (!this.wasmStage || this.attachedRuntimeSlots.has(handle)) return;
+    const autostep = options.autostep ?? defaultOptions.autostep;
+    const shape = resolvePlatformerAttachShape(options, gameEntity);
+    this.wasmStage.attachPlatformer3D(handle, {
+      ...shape,
+      walkSpeed: options.walkSpeed ?? defaultOptions.walkSpeed,
+      runSpeed: options.runSpeed ?? defaultOptions.runSpeed,
+      jumpForce: options.jumpForce ?? defaultOptions.jumpForce,
+      maxJumps: options.maxJumps ?? defaultOptions.maxJumps,
+      gravity: options.gravity ?? defaultOptions.gravity,
+      slopeClimbAngle: options.slopeClimbAngle ?? defaultOptions.slopeClimbAngle,
+      slopeSlideAngle: options.slopeSlideAngle ?? defaultOptions.slopeSlideAngle,
+      autostepHeight: autostep ? autostep.maxHeight : 0,
+      autostepMinWidth: autostep ? autostep.minWidth : 0.1,
+      snapToGroundDistance: options.snapToGroundDistance ?? defaultOptions.snapToGroundDistance,
+      characterOffset: options.characterOffset ?? defaultOptions.characterOffset
+    });
+    this.attachedRuntimeSlots.add(handle);
+  }
+  destroy(_ecs) {
+    this.attachedRuntimeSlots.clear();
+  }
+};
+var Platformer3DBehavior = defineBehavior({
+  name: "platformer-3d",
+  defaultOptions,
+  systemFactory: (ctx) => new Platformer3DBehaviorSystem(
+    ctx.wasmStage ?? null,
+    ctx.getBehaviorLinks
+  ),
+  // Handles read the runtime snapshot buffer (values are from the end of
+  // the previous step — one-frame lag). The Rust FSM is the single source
+  // of truth.
+  createHandle: (ref) => ({
+    getState: () => {
+      const snapshot = readBehaviorSnapshot(ref);
+      if (snapshot) return FSM_STATE_BY_INDEX[snapshot.fsmState] ?? "idle" /* Idle */;
+      return "idle" /* Idle */;
+    },
+    isGrounded: () => readBehaviorSnapshot(ref)?.grounded ?? false,
+    getJumpCount: () => readBehaviorSnapshot(ref)?.jumpCount ?? 0,
+    onPlatformCollision: (_ctx) => {
+    }
+  })
+});
+
+export {
+  createPlatformer3DMovementComponent,
+  createPlatformer3DInputComponent,
+  createPlatformer3DStateComponent,
+  Platformer3DState,
+  Platformer3DEvent,
+  Platformer3DFSM,
+  Platformer3DBehavior
+};
+//# sourceMappingURL=chunk-4LLK2FJI.js.map