@zylem/behaviors 0.2.0

package/dist/core.js

@@ -0,0 +1,327 @@
+import {
+  createPhysicsBodyComponent,
+  createTransformComponent,
+  useBehavior
+} from "./chunk-UYFOLI2X.js";
+import {
+  StageBodyKind,
+  StageBoundaryDim,
+  StageEventType,
+  StageRicochetDim,
+  StageRicochetReflection,
+  StageTopDownPlane
+} from "./chunk-Y6UJOUE5.js";
+import {
+  VEC2_ONE,
+  VEC2_ZERO,
+  VEC3_ONE,
+  VEC3_ZERO,
+  isVec2Input,
+  isVec3Input,
+  normalizeVec2,
+  normalizeVec3,
+  toRapierVector3,
+  toThreeVector2,
+  toThreeVector3
+} from "./chunk-WWVD5DR5.js";
+import {
+  clearVelocityIntent,
+  setVelocityIntent
+} from "./chunk-RTVRUNYR.js";
+import {
+  SyncStateMachine,
+  t
+} from "./chunk-4URF65BR.js";
+import {
+  defineBehavior
+} from "./chunk-EZNCCO4L.js";
+
+// src/lib/actions/capabilities/transform-store.ts
+import { proxy } from "valtio";
+function createTransformStore(initial) {
+  const defaultState = {
+    position: { x: 0, y: 0, z: 0 },
+    rotation: { x: 0, y: 0, z: 0, w: 1 },
+    velocity: { x: 0, y: 0, z: 0 },
+    angularVelocity: { x: 0, y: 0, z: 0 },
+    velocityChannels: {},
+    dirty: {
+      position: false,
+      rotation: false,
+      velocity: false,
+      velocityX: false,
+      velocityY: false,
+      velocityZ: false,
+      velocityChannels: false,
+      angularVelocity: false
+    }
+  };
+  return proxy({
+    ...defaultState,
+    ...initial,
+    // Ensure dirty flags are properly initialized even if partial initial state
+    dirty: {
+      ...defaultState.dirty,
+      ...initial?.dirty
+    }
+  });
+}
+function resetTransformStore(store) {
+  store.position.x = 0;
+  store.position.y = 0;
+  store.position.z = 0;
+  store.rotation.x = 0;
+  store.rotation.y = 0;
+  store.rotation.z = 0;
+  store.rotation.w = 1;
+  store.velocity.x = 0;
+  store.velocity.y = 0;
+  store.velocity.z = 0;
+  store.angularVelocity.x = 0;
+  store.angularVelocity.y = 0;
+  store.angularVelocity.z = 0;
+  for (const sourceId of Object.keys(store.velocityChannels)) {
+    delete store.velocityChannels[sourceId];
+  }
+  store.dirty.position = false;
+  store.dirty.rotation = false;
+  store.dirty.velocity = false;
+  store.dirty.velocityX = false;
+  store.dirty.velocityY = false;
+  store.dirty.velocityZ = false;
+  store.dirty.velocityChannels = false;
+  store.dirty.angularVelocity = false;
+}
+
+// src/lib/actions/capabilities/moveable.ts
+import { Vector3 } from "three";
+function moveX(entity, delta) {
+  if (!entity.transformStore) return;
+  setVelocityIntent(entity.transformStore, "actions", { x: delta }, { mode: "replace" });
+}
+function moveY(entity, delta) {
+  if (!entity.transformStore) return;
+  setVelocityIntent(entity.transformStore, "actions", { y: delta }, { mode: "replace" });
+}
+function moveZ(entity, delta) {
+  if (!entity.transformStore) return;
+  setVelocityIntent(entity.transformStore, "actions", { z: delta }, { mode: "replace" });
+}
+function moveXY(entity, deltaX, deltaY) {
+  if (!entity.transformStore) return;
+  setVelocityIntent(
+    entity.transformStore,
+    "actions",
+    { x: deltaX, y: deltaY },
+    { mode: "replace" }
+  );
+}
+function moveXZ(entity, deltaX, deltaZ) {
+  if (!entity.transformStore) return;
+  setVelocityIntent(
+    entity.transformStore,
+    "actions",
+    { x: deltaX, z: deltaZ },
+    { mode: "replace" }
+  );
+}
+function move(entity, vector) {
+  if (!entity.transformStore) return;
+  setVelocityIntent(
+    entity.transformStore,
+    "actions",
+    { x: vector.x, y: vector.y, z: vector.z },
+    { mode: "add" }
+  );
+}
+function resetVelocity(entity) {
+  if (!entity.body) return;
+  entity.body.setLinvel(new Vector3(0, 0, 0), true);
+  entity.body.setLinearDamping(5);
+}
+function moveForwardXY(entity, delta, rotation2DAngle) {
+  const deltaX = Math.sin(-rotation2DAngle) * delta;
+  const deltaY = Math.cos(-rotation2DAngle) * delta;
+  moveXY(entity, deltaX, deltaY);
+}
+function getPosition(entity) {
+  if (!entity.body) return null;
+  return entity.body.translation();
+}
+function getVelocity(entity) {
+  if (!entity.body) return null;
+  return entity.body.linvel();
+}
+function setPosition(entity, x, y, z) {
+  if (!entity.body) return;
+  entity.body.setTranslation({ x, y, z }, true);
+}
+function setPositionX(entity, x) {
+  if (!entity.body) return;
+  const { y, z } = entity.body.translation();
+  entity.body.setTranslation({ x, y, z }, true);
+}
+function setPositionY(entity, y) {
+  if (!entity.body) return;
+  const { x, z } = entity.body.translation();
+  entity.body.setTranslation({ x, y, z }, true);
+}
+function setPositionZ(entity, z) {
+  if (!entity.body) return;
+  const { x, y } = entity.body.translation();
+  entity.body.setTranslation({ x, y, z }, true);
+}
+function wrapAroundXY(entity, boundsX, boundsY) {
+  const position = getPosition(entity);
+  if (!position) return;
+  const { x, y } = position;
+  const newX = x > boundsX ? -boundsX : x < -boundsX ? boundsX : x;
+  const newY = y > boundsY ? -boundsY : y < -boundsY ? boundsY : y;
+  if (newX !== x || newY !== y) {
+    setPosition(entity, newX, newY, 0);
+  }
+}
+function wrapAround3D(entity, boundsX, boundsY, boundsZ) {
+  const position = getPosition(entity);
+  if (!position) return;
+  const { x, y, z } = position;
+  const newX = x > boundsX ? -boundsX : x < -boundsX ? boundsX : x;
+  const newY = y > boundsY ? -boundsY : y < -boundsY ? boundsY : y;
+  const newZ = z > boundsZ ? -boundsZ : z < -boundsZ ? boundsZ : z;
+  if (newX !== x || newY !== y || newZ !== z) {
+    setPosition(entity, newX, newY, newZ);
+  }
+}
+function makeMoveable(entity) {
+  const moveable = entity;
+  if (!moveable.transformStore) {
+    moveable.transformStore = createTransformStore();
+  }
+  moveable.moveX = (delta) => moveX(entity, delta);
+  moveable.moveY = (delta) => moveY(entity, delta);
+  moveable.moveZ = (delta) => moveZ(entity, delta);
+  moveable.moveXY = (deltaX, deltaY) => moveXY(entity, deltaX, deltaY);
+  moveable.moveXZ = (deltaX, deltaZ) => moveXZ(entity, deltaX, deltaZ);
+  moveable.move = (vector) => move(entity, vector);
+  moveable.resetVelocity = () => resetVelocity(entity);
+  moveable.moveForwardXY = (delta, rotation2DAngle) => moveForwardXY(entity, delta, rotation2DAngle);
+  moveable.getPosition = () => getPosition(entity);
+  moveable.getVelocity = () => getVelocity(entity);
+  moveable.setPosition = (x, y, z) => setPosition(entity, x, y, z);
+  moveable.setPositionX = (x) => setPositionX(entity, x);
+  moveable.setPositionY = (y) => setPositionY(entity, y);
+  moveable.setPositionZ = (z) => setPositionZ(entity, z);
+  moveable.wrapAroundXY = (boundsX, boundsY) => wrapAroundXY(entity, boundsX, boundsY);
+  moveable.wrapAround3D = (boundsX, boundsY, boundsZ) => wrapAround3D(entity, boundsX, boundsY, boundsZ);
+  return moveable;
+}
+
+// src/lib/entities/entity.ts
+var GameEntity = class {
+  uuid;
+  name;
+  type;
+  options;
+  group = null;
+  mesh;
+  materials;
+  body = null;
+  collider = null;
+  colliderDesc;
+  colliderDescs = [];
+  bodyDesc;
+  physicsAttached = false;
+  runtimeHandle;
+  transformStore;
+  nodeDestroy;
+  isInstanced;
+  __behaviorRefs = [];
+  create() {
+    return this;
+  }
+  onCleanup(callback) {
+    void callback;
+    return this;
+  }
+  setPosition(_x, _y, _z) {
+  }
+  setRotation(_x, _y, _z) {
+  }
+  setRotationZ(_z) {
+  }
+  setScale(_x, _y, _z) {
+  }
+  /**
+   * Attach a behavior to this entity. The real engine entity does substantially
+   * more, but this functional stub stores the merged ref and builds the handle
+   * so descriptor/handle logic (and tests that drive behaviors directly) work
+   * without the full engine.
+   */
+  use(descriptor, options) {
+    const mergedOptions = {
+      ...descriptor.defaultOptions,
+      ...options ?? {}
+    };
+    const ref = { descriptor, options: mergedOptions };
+    this.__behaviorRefs.push(ref);
+    const baseHandle = {
+      getFSM: () => ref.fsm ?? null,
+      getOptions: () => ref.options,
+      ref
+    };
+    const extra = descriptor.createHandle ? descriptor.createHandle(ref) : {};
+    return { ...baseHandle, ...extra };
+  }
+  /** Live behavior refs attached via {@link use}. */
+  getBehaviorRefs() {
+    return this.__behaviorRefs;
+  }
+};
+export {
+  GameEntity,
+  StageBodyKind,
+  StageBoundaryDim,
+  StageEventType,
+  StageRicochetDim,
+  StageRicochetReflection,
+  StageTopDownPlane,
+  SyncStateMachine,
+  VEC2_ONE,
+  VEC2_ZERO,
+  VEC3_ONE,
+  VEC3_ZERO,
+  clearVelocityIntent,
+  createPhysicsBodyComponent,
+  createTransformComponent,
+  createTransformStore,
+  defineBehavior,
+  getPosition,
+  getVelocity,
+  isVec2Input,
+  isVec3Input,
+  makeMoveable,
+  move,
+  moveForwardXY,
+  moveX,
+  moveXY,
+  moveXZ,
+  moveY,
+  moveZ,
+  normalizeVec2,
+  normalizeVec3,
+  resetTransformStore,
+  resetVelocity,
+  setPosition,
+  setPositionX,
+  setPositionY,
+  setPositionZ,
+  setVelocityIntent,
+  t,
+  toRapierVector3,
+  toThreeVector2,
+  toThreeVector3,
+  useBehavior,
+  wrapAround3D,
+  wrapAroundXY
+};
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/actions/capabilities/transform-store.ts","../src/lib/actions/capabilities/moveable.ts","../src/lib/entities/entity.ts"],"sourcesContent":["import { proxy } from 'valtio';\n\nexport type VelocityIntentMode = 'replace' | 'add';\n\nexport interface VelocityIntent {\n\tx?: number;\n\ty?: number;\n\tz?: number;\n\tmode: VelocityIntentMode;\n\tpriority?: number;\n}\n\n/**\n * Transform state managed by Valtio for batched physics updates.\n * \n * This store accumulates transformation intents during the frame,\n * then applies them all at once after onUpdate() callbacks complete.\n * \n * Design decisions:\n * - Position: Accumulated deltas (additive)\n * - Rotation: Last value wins (replacement)\n * - Velocity: Accumulated deltas (additive)\n * - Angular velocity: Accumulated deltas (additive)\n */\nexport interface TransformState {\n\t/** Position deltas to be applied (accumulated) */\n\tposition: { x: number; y: number; z: number };\n\t\n\t/** Rotation quaternion (last value wins) */\n\trotation: { x: number; y: number; z: number; w: number };\n\t\n\t/** Linear velocity (accumulated) */\n\tvelocity: { x: number; y: number; z: number };\n\t\n\t/** Angular velocity (accumulated) */\n\tangularVelocity: { x: number; y: number; z: number };\n\n\t/** Per-source velocity intents composed once per frame */\n\tvelocityChannels: Record<string, VelocityIntent>;\n\t\n\t/** Dirty flags to track what needs to be applied */\n\tdirty: {\n\t\tposition: boolean;\n\t\trotation: boolean;\n\t\t/** @deprecated Use per-axis velocityX/Y/Z flags for new code */\n\t\tvelocity: boolean;\n\t\tvelocityX: boolean;\n\t\tvelocityY: boolean;\n\t\tvelocityZ: boolean;\n\t\tvelocityChannels: boolean;\n\t\tangularVelocity: boolean;\n\t};\n}\n\n/**\n * Create a new transform store with optional initial values.\n * The store is a Valtio proxy, making it reactive for debugging/visualization.\n * \n * @param initial Optional initial state values\n * @returns Reactive transform state\n */\nexport function createTransformStore(initial?: Partial<TransformState>): TransformState {\n\tconst defaultState: TransformState = {\n\t\tposition: { x: 0, y: 0, z: 0 },\n\t\trotation: { x: 0, y: 0, z: 0, w: 1 },\n\t\tvelocity: { x: 0, y: 0, z: 0 },\n\t\tangularVelocity: { x: 0, y: 0, z: 0 },\n\t\tvelocityChannels: {},\n\t\tdirty: {\n\t\t\tposition: false,\n\t\t\trotation: false,\n\t\t\tvelocity: false,\n\t\t\tvelocityX: false,\n\t\t\tvelocityY: false,\n\t\t\tvelocityZ: false,\n\t\t\tvelocityChannels: false,\n\t\t\tangularVelocity: false,\n\t\t},\n\t};\n\n\treturn proxy({\n\t\t...defaultState,\n\t\t...initial,\n\t\t// Ensure dirty flags are properly initialized even if partial initial state\n\t\tdirty: {\n\t\t\t...defaultState.dirty,\n\t\t\t...initial?.dirty,\n\t\t},\n\t});\n}\n\n/**\n * Reset a transform store to its initial clean state.\n * Called after applying changes to prepare for the next frame.\n * \n * @param store The transform store to reset\n */\nexport function resetTransformStore(store: TransformState): void {\n\t// Reset position deltas\n\tstore.position.x = 0;\n\tstore.position.y = 0;\n\tstore.position.z = 0;\n\n\t// Reset rotation to identity quaternion\n\tstore.rotation.x = 0;\n\tstore.rotation.y = 0;\n\tstore.rotation.z = 0;\n\tstore.rotation.w = 1;\n\n\t// Reset velocity\n\tstore.velocity.x = 0;\n\tstore.velocity.y = 0;\n\tstore.velocity.z = 0;\n\n\t// Reset angular velocity\n\tstore.angularVelocity.x = 0;\n\tstore.angularVelocity.y = 0;\n\tstore.angularVelocity.z = 0;\n\n\t// Reset per-source velocity intents\n\tfor (const sourceId of Object.keys(store.velocityChannels)) {\n\t\tdelete store.velocityChannels[sourceId];\n\t}\n\n\t// Clear all dirty flags\n\tstore.dirty.position = false;\n\tstore.dirty.rotation = false;\n\tstore.dirty.velocity = false;\n\tstore.dirty.velocityX = false;\n\tstore.dirty.velocityY = false;\n\tstore.dirty.velocityZ = false;\n\tstore.dirty.velocityChannels = false;\n\tstore.dirty.angularVelocity = false;\n}\n","import { Vector3 } from 'three';\nimport { RigidBody, Vector } from '@dimforge/rapier3d-compat';\nimport type { TransformState } from './transform-store';\nimport { createTransformStore } from './transform-store';\nimport { setVelocityIntent } from './velocity-intents';\n\nexport interface EntityWithBody {\n\tbody: RigidBody | null;\n\ttransformStore?: TransformState;\n}\n\n/**\n * Move an entity along the X axis, preserving other velocities.\n */\nexport function moveX(entity: EntityWithBody, delta: number): void {\n\tif (!entity.transformStore) return;\n\tsetVelocityIntent(entity.transformStore, 'actions', { x: delta }, { mode: 'replace' });\n}\n\n/**\n * Move an entity along the Y axis, preserving other velocities.\n */\nexport function moveY(entity: EntityWithBody, delta: number): void {\n\tif (!entity.transformStore) return;\n\tsetVelocityIntent(entity.transformStore, 'actions', { y: delta }, { mode: 'replace' });\n}\n\n/**\n * Move an entity along the Z axis, preserving other velocities.\n */\nexport function moveZ(entity: EntityWithBody, delta: number): void {\n\tif (!entity.transformStore) return;\n\tsetVelocityIntent(entity.transformStore, 'actions', { z: delta }, { mode: 'replace' });\n}\n\n/**\n * Move an entity along the X and Y axis, preserving Z velocity.\n */\nexport function moveXY(entity: EntityWithBody, deltaX: number, deltaY: number): void {\n\tif (!entity.transformStore) return;\n\tsetVelocityIntent(\n\t\tentity.transformStore,\n\t\t'actions',\n\t\t{ x: deltaX, y: deltaY },\n\t\t{ mode: 'replace' },\n\t);\n}\n\n/**\n * Move an entity along the X and Z axis, preserving Y velocity.\n */\nexport function moveXZ(entity: EntityWithBody, deltaX: number, deltaZ: number): void {\n\tif (!entity.transformStore) return;\n\tsetVelocityIntent(\n\t\tentity.transformStore,\n\t\t'actions',\n\t\t{ x: deltaX, z: deltaZ },\n\t\t{ mode: 'replace' },\n\t);\n}\n\n/**\n * Move entity based on a vector, adding to existing velocities.\n */\nexport function move(entity: EntityWithBody, vector: Vector3): void {\n\tif (!entity.transformStore) return;\n\tsetVelocityIntent(\n\t\tentity.transformStore,\n\t\t'actions',\n\t\t{ x: vector.x, y: vector.y, z: vector.z },\n\t\t{ mode: 'add' },\n\t);\n}\n\n/**\n * Reset entity velocity\n */\nexport function resetVelocity(entity: EntityWithBody): void {\n\tif (!entity.body) return;\n\tentity.body.setLinvel(new Vector3(0, 0, 0), true);\n\tentity.body.setLinearDamping(5);\n}\n\n/**\n * Move entity forward in 2D space, preserving Z velocity\n */\nexport function moveForwardXY(entity: EntityWithBody, delta: number, rotation2DAngle: number): void {\n\tconst deltaX = Math.sin(-rotation2DAngle) * delta;\n\tconst deltaY = Math.cos(-rotation2DAngle) * delta;\n\tmoveXY(entity, deltaX, deltaY);\n}\n\n/**\n * Get entity position\n */\nexport function getPosition(entity: EntityWithBody): Vector | null {\n\tif (!entity.body) return null;\n\treturn entity.body.translation();\n}\n\n/**\n * Get entity velocity\n */\nexport function getVelocity(entity: EntityWithBody): Vector | null {\n\tif (!entity.body) return null;\n\treturn entity.body.linvel();\n}\n\n/**\n * Set entity position\n */\nexport function setPosition(entity: EntityWithBody, x: number, y: number, z: number): void {\n\tif (!entity.body) return;\n\tentity.body.setTranslation({ x, y, z }, true);\n}\n\n/**\n * Set entity X position\n */\nexport function setPositionX(entity: EntityWithBody, x: number): void {\n\tif (!entity.body) return;\n\tconst { y, z } = entity.body.translation();\n\tentity.body.setTranslation({ x, y, z }, true);\n}\n\n/**\n * Set entity Y position\n */\nexport function setPositionY(entity: EntityWithBody, y: number): void {\n\tif (!entity.body) return;\n\tconst { x, z } = entity.body.translation();\n\tentity.body.setTranslation({ x, y, z }, true);\n}\n\n/**\n * Set entity Z position\n */\nexport function setPositionZ(entity: EntityWithBody, z: number): void {\n\tif (!entity.body) return;\n\tconst { x, y } = entity.body.translation();\n\tentity.body.setTranslation({ x, y, z }, true);\n}\n\n/**\n * Wrap entity around 2D bounds\n */\nexport function wrapAroundXY(entity: EntityWithBody, boundsX: number, boundsY: number): void {\n\tconst position = getPosition(entity);\n\tif (!position) return;\n\n\tconst { x, y } = position;\n\tconst newX = x > boundsX ? -boundsX : (x < -boundsX ? boundsX : x);\n\tconst newY = y > boundsY ? -boundsY : (y < -boundsY ? boundsY : y);\n\n\tif (newX !== x || newY !== y) {\n\t\tsetPosition(entity, newX, newY, 0);\n\t}\n}\n\n/**\n * Wrap entity around 3D bounds\n */\nexport function wrapAround3D(entity: EntityWithBody, boundsX: number, boundsY: number, boundsZ: number): void {\n\tconst position = getPosition(entity);\n\tif (!position) return;\n\n\tconst { x, y, z } = position;\n\tconst newX = x > boundsX ? -boundsX : (x < -boundsX ? boundsX : x);\n\tconst newY = y > boundsY ? -boundsY : (y < -boundsY ? boundsY : y);\n\tconst newZ = z > boundsZ ? -boundsZ : (z < -boundsZ ? boundsZ : z);\n\n\tif (newX !== x || newY !== y || newZ !== z) {\n\t\tsetPosition(entity, newX, newY, newZ);\n\t}\n}\n\n/**\n * Enhanced moveable entity with bound methods\n */\nexport interface MoveableEntity extends EntityWithBody {\n\tmoveX(delta: number): void;\n\tmoveY(delta: number): void;\n\tmoveZ(delta: number): void;\n\tmoveXY(deltaX: number, deltaY: number): void;\n\tmoveXZ(deltaX: number, deltaZ: number): void;\n\tmove(vector: Vector3): void;\n\tresetVelocity(): void;\n\tmoveForwardXY(delta: number, rotation2DAngle: number): void;\n\tgetPosition(): Vector | null;\n\tgetVelocity(): Vector | null;\n\tsetPosition(x: number, y: number, z: number): void;\n\tsetPositionX(x: number): void;\n\tsetPositionY(y: number): void;\n\tsetPositionZ(z: number): void;\n\twrapAroundXY(boundsX: number, boundsY: number): void;\n\twrapAround3D(boundsX: number, boundsY: number, boundsZ: number): void;\n}\n\n/**\n * Enhance an entity with additive movement methods.\n * Automatically creates a transform store if one doesn't exist.\n */\nexport function makeMoveable<T extends EntityWithBody>(entity: T): T & MoveableEntity {\n\tconst moveable = entity as T & MoveableEntity;\n\n\t// Create transform store if it doesn't exist\n\tif (!moveable.transformStore) {\n\t\tmoveable.transformStore = createTransformStore();\n\t}\n\n\tmoveable.moveX = (delta: number) => moveX(entity, delta);\n\tmoveable.moveY = (delta: number) => moveY(entity, delta);\n\tmoveable.moveZ = (delta: number) => moveZ(entity, delta);\n\tmoveable.moveXY = (deltaX: number, deltaY: number) => moveXY(entity, deltaX, deltaY);\n\tmoveable.moveXZ = (deltaX: number, deltaZ: number) => moveXZ(entity, deltaX, deltaZ);\n\tmoveable.move = (vector: Vector3) => move(entity, vector);\n\tmoveable.resetVelocity = () => resetVelocity(entity);\n\tmoveable.moveForwardXY = (delta: number, rotation2DAngle: number) => moveForwardXY(entity, delta, rotation2DAngle);\n\tmoveable.getPosition = () => getPosition(entity);\n\tmoveable.getVelocity = () => getVelocity(entity);\n\tmoveable.setPosition = (x: number, y: number, z: number) => setPosition(entity, x, y, z);\n\tmoveable.setPositionX = (x: number) => setPositionX(entity, x);\n\tmoveable.setPositionY = (y: number) => setPositionY(entity, y);\n\tmoveable.setPositionZ = (z: number) => setPositionZ(entity, z);\n\tmoveable.wrapAroundXY = (boundsX: number, boundsY: number) => wrapAroundXY(entity, boundsX, boundsY);\n\tmoveable.wrapAround3D = (boundsX: number, boundsY: number, boundsZ: number) => wrapAround3D(entity, boundsX, boundsY, boundsZ);\n\n\treturn moveable;\n}","import type {\n\tBehaviorDescriptor,\n\tBehaviorHandle,\n\tBehaviorRef,\n} from '../behaviors/behavior-descriptor';\n\n/**\n * Minimal, runtime-agnostic entity options contract.\n *\n * The full engine entity (in `@zylem/game-lib`) provides a richer options type,\n * but behaviors only rely on this loose shape.\n */\nexport interface GameEntityOptions {\n\t[key: string]: any;\n\tname?: string;\n}\n\n/**\n * Structural stand-in for the engine `GameEntity`.\n *\n * Behaviors annotate against this loose contract so that `@zylem/behaviors`\n * (and its `@zylem/behaviors/core` surface) never has to depend on the concrete\n * `@zylem/game-lib` entity implementation. The real engine entity is\n * structurally assignable to this type.\n */\nexport class GameEntity<TOptions = unknown> {\n\t[key: string]: any;\n\n\tuuid!: string;\n\tname!: string;\n\ttype!: string;\n\toptions?: TOptions & Record<string, unknown>;\n\tgroup: any = null;\n\tmesh?: any;\n\tmaterials?: any[];\n\tbody: any = null;\n\tcollider: any = null;\n\tcolliderDesc?: any;\n\tcolliderDescs: any[] = [];\n\tbodyDesc?: any;\n\tphysicsAttached = false;\n\truntimeHandle?: number;\n\ttransformStore?: any;\n\tnodeDestroy?: any;\n\tisInstanced?: boolean;\n\n\tprivate __behaviorRefs: BehaviorRef<any>[] = [];\n\n\tcreate(): this {\n\t\treturn this;\n\t}\n\n\tonCleanup(callback: () => void): this {\n\t\tvoid callback;\n\t\treturn this;\n\t}\n\n\tsetPosition(_x: number, _y: number, _z: number): void {}\n\tsetRotation(_x: number, _y: number, _z: number): void {}\n\tsetRotationZ(_z: number): void {}\n\tsetScale(_x: number, _y: number, _z: number): void {}\n\n\t/**\n\t * Attach a behavior to this entity. The real engine entity does substantially\n\t * more, but this functional stub stores the merged ref and builds the handle\n\t * so descriptor/handle logic (and tests that drive behaviors directly) work\n\t * without the full engine.\n\t */\n\tuse<\n\t\tO extends Record<string, any>,\n\t\tH extends Record<string, any> = Record<string, never>,\n\t>(\n\t\tdescriptor: BehaviorDescriptor<O, H>,\n\t\toptions?: Partial<O>,\n\t): BehaviorHandle<O, H> {\n\t\tconst mergedOptions = {\n\t\t\t...(descriptor.defaultOptions as O),\n\t\t\t...(options ?? {}),\n\t\t} as O;\n\t\tconst ref: BehaviorRef<O> = { descriptor, options: mergedOptions };\n\t\tthis.__behaviorRefs.push(ref as BehaviorRef<any>);\n\n\t\tconst baseHandle = {\n\t\t\tgetFSM: () => ref.fsm ?? null,\n\t\t\tgetOptions: () => ref.options,\n\t\t\tref,\n\t\t};\n\t\tconst extra = descriptor.createHandle\n\t\t\t? descriptor.createHandle(ref)\n\t\t\t: ({} as H);\n\t\treturn { ...baseHandle, ...extra } as BehaviorHandle<O, H>;\n\t}\n\n\t/** Live behavior refs attached via {@link use}. */\n\tgetBehaviorRefs(): BehaviorRef<any>[] {\n\t\treturn this.__behaviorRefs;\n\t}\n}\n\n/**\n * Factory contract injected into behavior systems via\n * {@link BehaviorSystemContext.createEntity}. The host engine supplies the real\n * entity factory at stage-construction time.\n */\nexport type CreateEntityFn = (\n\toptions?: Partial<GameEntityOptions>,\n) => GameEntity<GameEntityOptions>;\n"],"mappings":"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","names":[]}

package/dist/destructible-3d.d.ts

@@ -0,0 +1,42 @@
+import { a as BehaviorDescriptor } from './behavior-system-DYbx-x_-.js';
+import { Material } from 'three';
+import { FractureOptions, DestructibleMesh } from '@dgreenheck/three-pinata';
+export { DestructibleMesh, FractureOptions, VoronoiOptions } from '@dgreenheck/three-pinata';
+export { D as DestructiblePrebakeWorkerAPI, P as PlainBufferGeometryPayload, a as PlainFractureOptions, c as PrebakeWorkerRequest, d as PrebakeWorkerResponse } from './payload-BQzu-oY_.js';
+
+type FractureOptionsInput = NonNullable<ConstructorParameters<typeof FractureOptions>[0]>;
+type Destructible3DFragmentColliderShape = 'convexHull' | 'cuboid' | 'trimesh';
+interface Destructible3DColliderOptions {
+    shape?: Destructible3DFragmentColliderShape;
+    sensor?: boolean;
+    collisionGroups?: number;
+    activeCollisionTypes?: number;
+}
+interface Destructible3DFragmentPhysicsOptions {
+    mode?: 'compound' | 'independent';
+    inheritSourceVelocity?: boolean;
+    outwardVelocity?: number;
+    angularVelocity?: number;
+}
+interface Destructible3DBehaviorOptions {
+    fractureOptions?: FractureOptionsInput | FractureOptions;
+    innerMaterial?: Material | null;
+    collider?: Destructible3DColliderOptions;
+    fragmentPhysics?: Destructible3DFragmentPhysicsOptions;
+    /**
+     * When set, {@link Destructible3DHandle.prebakeAsync} runs Voronoi fracture
+     * in a Web Worker (see `destructible-prebake-worker` bundle).
+     */
+    prebakeWorkerUrl?: URL | string;
+}
+interface Destructible3DHandle {
+    fracture(overrideOptions?: FractureOptionsInput | FractureOptions): readonly DestructibleMesh[];
+    prebake(overrideOptions?: FractureOptionsInput | FractureOptions): void;
+    prebakeAsync(overrideOptions?: FractureOptionsInput | FractureOptions): Promise<void>;
+    repair(): void;
+    isFractured(): boolean;
+    getFragments(): readonly DestructibleMesh[];
+}
+declare const Destructible3DBehavior: BehaviorDescriptor<Destructible3DBehaviorOptions, Destructible3DHandle, unknown>;
+
+export { Destructible3DBehavior, type Destructible3DBehaviorOptions, type Destructible3DColliderOptions, type Destructible3DFragmentColliderShape, type Destructible3DFragmentPhysicsOptions, type Destructible3DHandle, type FractureOptionsInput };

package/dist/destructible-3d.js

@@ -0,0 +1,13 @@
+import {
+  Destructible3DBehavior,
+  DestructibleMesh,
+  FractureOptions
+} from "./chunk-BXP4K7RF.js";
+import "./chunk-HZMY3TT4.js";
+import "./chunk-EZNCCO4L.js";
+export {
+  Destructible3DBehavior,
+  DestructibleMesh,
+  FractureOptions
+};
+//# sourceMappingURL=destructible-3d.js.map

package/dist/destructible-3d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/destructible-prebake.d.ts

@@ -0,0 +1,28 @@
+import { Mesh, Group, BufferGeometry } from 'three';
+import { FractureOptions } from '@dgreenheck/three-pinata';
+export { D as DestructiblePrebakeWorkerAPI, P as PlainBufferGeometryPayload, a as PlainFractureOptions, b as PlainWorkerFragmentPayload, c as PrebakeWorkerRequest, d as PrebakeWorkerResponse, e as bufferGeometryToPlain, f as destructibleFragmentsToPlainResponse, p as pinataFractureOptionsToPlain, g as plainFractureOptionsToPinata, h as plainToBufferGeometry, i as plainWorkerResultToTemplateParts } from './payload-BQzu-oY_.js';
+
+/**
+ * Normalizes source mesh geometry for Voronoi prebake / fracture so runtime and
+ * CLI tooling share one code path (float attributes, non-indexed, root-relative transform).
+ */
+
+/**
+ * Clones geometry with float32 attributes and expands indexed meshes to non-indexed.
+ */
+declare function normalizeFractureSourceGeometry(sourceGeometry: BufferGeometry): BufferGeometry;
+/**
+ * Produces fracture-space geometry: normalized mesh vertices in root-local space.
+ */
+declare function buildNormalizedFractureSourceGeometry(mesh: Mesh, root: Group): BufferGeometry;
+
+/**
+ * Stable JSON key for matching prebaked fragment templates to fracture options.
+ */
+
+/**
+ * Serializes fracture options for prebake cache identity (mesh not included).
+ */
+declare function buildFractureGeometryCacheKey(options: FractureOptions): string;
+
+export { buildFractureGeometryCacheKey, buildNormalizedFractureSourceGeometry, normalizeFractureSourceGeometry };

package/dist/destructible-prebake.js

@@ -0,0 +1,23 @@
+import {
+  bufferGeometryToPlain,
+  buildFractureGeometryCacheKey,
+  buildNormalizedFractureSourceGeometry,
+  destructibleFragmentsToPlainResponse,
+  normalizeFractureSourceGeometry,
+  pinataFractureOptionsToPlain,
+  plainFractureOptionsToPinata,
+  plainToBufferGeometry,
+  plainWorkerResultToTemplateParts
+} from "./chunk-HZMY3TT4.js";
+export {
+  bufferGeometryToPlain,
+  buildFractureGeometryCacheKey,
+  buildNormalizedFractureSourceGeometry,
+  destructibleFragmentsToPlainResponse,
+  normalizeFractureSourceGeometry,
+  pinataFractureOptionsToPlain,
+  plainFractureOptionsToPinata,
+  plainToBufferGeometry,
+  plainWorkerResultToTemplateParts
+};
+//# sourceMappingURL=destructible-prebake.js.map

package/dist/destructible-prebake.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/entity-types-CmtQ-IBp.d.ts

@@ -0,0 +1,15 @@
+import { Group } from 'three';
+import { RigidBody, Collider } from '@dimforge/rapier3d-compat';
+
+/**
+ * Base entity interface - shared across modules to prevent circular dependencies
+ */
+interface BaseEntityInterface {
+    uuid: string;
+    name: string;
+    group: Group | null | undefined;
+    body: RigidBody | null | undefined;
+    collider: Collider | null | undefined;
+}
+
+export type { BaseEntityInterface as B };

package/dist/first-person-perspective-C9Mptl0-.d.ts

@@ -0,0 +1,23 @@
+import { Vector3 } from 'three';
+
+/**
+ * Structural contract for the engine `FirstPersonPerspective`.
+ *
+ * Behaviors drive a perspective (yaw/pitch accumulation + eye position) without
+ * depending on the concrete camera implementation in `@zylem/game-lib`. The real
+ * `FirstPersonPerspective` class is structurally assignable to this interface.
+ */
+interface FirstPersonPerspective {
+    /** Fallback / eye position. Mutated directly by the first-person behavior. */
+    initialPosition?: Vector3;
+    /** Current yaw in radians. */
+    readonly yaw: number;
+    /** Current pitch in radians. */
+    readonly pitch: number;
+    /** Accumulate yaw and pitch deltas. */
+    look(deltaYaw: number, deltaPitch: number): void;
+    /** Set absolute yaw and pitch. */
+    setLook?(yaw: number, pitch: number): void;
+}
+
+export type { FirstPersonPerspective as F };