@zylem/behaviors 0.2.0

package/dist/chunk-WOMHL23C.js

@@ -0,0 +1,369 @@
+import {
+  defineBehavior
+} from "./chunk-EZNCCO4L.js";
+
+// src/lib/behaviors/screen-visibility/screen-visibility.descriptor.ts
+import {
+  Box3,
+  Frustum,
+  Matrix4,
+  Quaternion,
+  Vector3
+} from "three";
+
+// src/lib/behaviors/screen-visibility/screen-visibility-fsm.ts
+var ScreenVisibilityFSM = class {
+  initialized = false;
+  visible = false;
+  justEntered = false;
+  justExited = false;
+  visibleCameraNames = [];
+  update(visible, visibleCameraNames) {
+    const wasVisible = this.visible;
+    this.justEntered = !wasVisible && visible;
+    this.justExited = wasVisible && !visible;
+    if (!this.initialized) {
+      this.justEntered = visible;
+      this.justExited = false;
+    }
+    this.initialized = true;
+    this.visible = visible;
+    this.visibleCameraNames = [...visibleCameraNames];
+  }
+  isInitialized() {
+    return this.initialized;
+  }
+  isVisible() {
+    return this.visible;
+  }
+  wasJustEntered() {
+    return this.justEntered;
+  }
+  wasJustExited() {
+    return this.justExited;
+  }
+  getVisibleCameraNames() {
+    return [...this.visibleCameraNames];
+  }
+  getState() {
+    return {
+      initialized: this.initialized,
+      visible: this.visible,
+      justEntered: this.justEntered,
+      justExited: this.justExited,
+      visibleCameraNames: this.getVisibleCameraNames()
+    };
+  }
+};
+
+// src/lib/behaviors/screen-visibility/screen-visibility.descriptor.ts
+var defaultOptions = {
+  cameraName: null,
+  requireFullyVisible: false,
+  padding: 0,
+  fallbackSize: null,
+  onChange: void 0,
+  onEnter: void 0,
+  onExit: void 0
+};
+var SCREEN_VISIBILITY_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for(
+  "zylem:behavior:screen-visibility"
+);
+var ScreenVisibilitySystem = class {
+  constructor(scene, getBehaviorLinks) {
+    this.scene = scene;
+    this.getBehaviorLinks = getBehaviorLinks;
+  }
+  scene;
+  getBehaviorLinks;
+  worldBounds = new Box3();
+  projectionMatrix = new Matrix4();
+  frustum = new Frustum();
+  savedPosition = new Vector3();
+  savedQuaternion = new Quaternion();
+  worldPosition = new Vector3();
+  fallbackMin = new Vector3();
+  fallbackMax = new Vector3();
+  corners = Array.from({ length: 8 }, () => new Vector3());
+  boundsCache = /* @__PURE__ */ new Map();
+  update(_ecs, _delta) {
+    const links = this.getBehaviorLinks?.(SCREEN_VISIBILITY_BEHAVIOR_KEY);
+    if (!links) return;
+    for (const link of links) {
+      const entity = link.entity;
+      const visibilityRef = link.ref;
+      const options = visibilityRef.options;
+      if (!visibilityRef.fsm) {
+        visibilityRef.fsm = new ScreenVisibilityFSM();
+      }
+      const fsm = visibilityRef.fsm;
+      const previousState = fsm.getState();
+      const cameras = this.resolveActiveCameras(options.cameraName);
+      const visibleCameraNames = [];
+      const bounds = this.computeWorldBounds(entity, visibilityRef, options);
+      if (bounds) {
+        for (let index = 0; index < cameras.length; index++) {
+          const cameraRef = cameras[index];
+          if (this.isBoundsVisible(bounds, cameraRef, options.requireFullyVisible)) {
+            visibleCameraNames.push(this.getCameraLabel(cameraRef, index));
+          }
+        }
+      }
+      fsm.update(visibleCameraNames.length > 0, visibleCameraNames);
+      this.notifyVisibilityChange(entity, options, previousState, fsm.getState());
+    }
+  }
+  resolveActiveCameras(cameraName) {
+    const activeCameras = this.scene?.cameraManager?.activeCameras?.length ? [...this.scene.cameraManager.activeCameras] : this.scene?.zylemCamera ? [this.scene.zylemCamera] : [];
+    if (!cameraName) {
+      return activeCameras;
+    }
+    return activeCameras.filter((camera) => camera.name === cameraName);
+  }
+  computeWorldBounds(entity, ref, options) {
+    const cacheKey = this.getBoundsCacheKey(entity, options);
+    const cached = this.boundsCache.get(entity.uuid);
+    if (cached && cached.key === cacheKey) {
+      return cached.bounds;
+    }
+    const target = entity.group ?? entity.mesh;
+    this.worldBounds.makeEmpty();
+    if (target) {
+      const wasmPose = entity.getPose?.();
+      const useWasm = wasmPose && entity.runtimeHandle >= 0;
+      const body = useWasm ? null : entity.body;
+      if (useWasm || body) {
+        this.savedPosition.copy(target.position);
+        this.savedQuaternion.copy(target.quaternion);
+        if (useWasm) {
+          target.position.set(wasmPose.position.x, wasmPose.position.y, wasmPose.position.z);
+          if (!entity.controlledRotation) {
+            target.quaternion.set(
+              wasmPose.rotation.x,
+              wasmPose.rotation.y,
+              wasmPose.rotation.z,
+              wasmPose.rotation.w
+            );
+          }
+        } else {
+          const translation = body.translation();
+          target.position.set(translation.x, translation.y, translation.z);
+          if (!entity.controlledRotation) {
+            const rotation = body.rotation();
+            target.quaternion.set(rotation.x, rotation.y, rotation.z, rotation.w);
+          }
+        }
+        target.updateWorldMatrix(true, true);
+        this.worldBounds.setFromObject(target);
+        target.position.copy(this.savedPosition);
+        target.quaternion.copy(this.savedQuaternion);
+        target.updateWorldMatrix(true, true);
+      } else {
+        target.updateWorldMatrix(true, true);
+        this.worldBounds.setFromObject(target);
+      }
+    }
+    if (this.worldBounds.isEmpty()) {
+      const fallbackSize = options.fallbackSize ?? (entity.options?.size ?? null);
+      this.resolveFallbackCenter(entity, target);
+      const halfX = (fallbackSize?.x ?? 0) / 2;
+      const halfY = (fallbackSize?.y ?? 0) / 2;
+      const halfZ = (fallbackSize?.z ?? 0) / 2;
+      this.fallbackMin.set(
+        this.worldPosition.x - halfX,
+        this.worldPosition.y - halfY,
+        this.worldPosition.z - halfZ
+      );
+      this.fallbackMax.set(
+        this.worldPosition.x + halfX,
+        this.worldPosition.y + halfY,
+        this.worldPosition.z + halfZ
+      );
+      this.worldBounds.set(this.fallbackMin, this.fallbackMax);
+    }
+    if (options.padding !== 0) {
+      this.worldBounds.expandByScalar(options.padding);
+    }
+    if (this.worldBounds.isEmpty()) {
+      this.boundsCache.delete(entity.uuid);
+      return null;
+    }
+    const cachedBounds = cached?.bounds ?? new Box3();
+    cachedBounds.copy(this.worldBounds);
+    this.boundsCache.set(entity.uuid, {
+      bounds: cachedBounds,
+      key: cacheKey
+    });
+    ref.__screenVisibilityBoundsKey = cacheKey;
+    return cachedBounds;
+  }
+  getBoundsCacheKey(entity, options) {
+    const body = entity.body;
+    if (body) {
+      const translation = body.translation();
+      const rotation = body.rotation();
+      return [
+        "b",
+        translation.x.toFixed(3),
+        translation.y.toFixed(3),
+        translation.z.toFixed(3),
+        rotation.x.toFixed(3),
+        rotation.y.toFixed(3),
+        rotation.z.toFixed(3),
+        rotation.w.toFixed(3),
+        options.padding,
+        options.requireFullyVisible,
+        options.fallbackSize?.x ?? "",
+        options.fallbackSize?.y ?? "",
+        options.fallbackSize?.z ?? ""
+      ].join("|");
+    }
+    const target = entity.group ?? entity.mesh;
+    if (target) {
+      const position2 = target.position;
+      const quaternion = target.quaternion;
+      const scale = target.scale;
+      return [
+        "o",
+        position2.x.toFixed(3),
+        position2.y.toFixed(3),
+        position2.z.toFixed(3),
+        quaternion.x.toFixed(3),
+        quaternion.y.toFixed(3),
+        quaternion.z.toFixed(3),
+        quaternion.w.toFixed(3),
+        scale.x.toFixed(3),
+        scale.y.toFixed(3),
+        scale.z.toFixed(3),
+        options.padding,
+        options.requireFullyVisible,
+        options.fallbackSize?.x ?? "",
+        options.fallbackSize?.y ?? "",
+        options.fallbackSize?.z ?? ""
+      ].join("|");
+    }
+    const position = entity.options?.position ?? { x: 0, y: 0, z: 0 };
+    const size = entity.options?.size ?? { x: 0, y: 0, z: 0 };
+    return [
+      "s",
+      position.x,
+      position.y,
+      position.z,
+      size.x,
+      size.y,
+      size.z,
+      options.padding,
+      options.requireFullyVisible,
+      options.fallbackSize?.x ?? "",
+      options.fallbackSize?.y ?? "",
+      options.fallbackSize?.z ?? ""
+    ].join("|");
+  }
+  resolveFallbackCenter(entity, target) {
+    const body = entity.body;
+    if (body) {
+      const translation = body.translation();
+      this.worldPosition.set(translation.x, translation.y, translation.z);
+      return;
+    }
+    if (target) {
+      target.updateWorldMatrix(true, false);
+      target.getWorldPosition(this.worldPosition);
+      return;
+    }
+    const position = entity.options?.position ?? { x: 0, y: 0, z: 0 };
+    this.worldPosition.set(position.x, position.y, position.z);
+  }
+  isBoundsVisible(bounds, cameraRef, requireFullyVisible) {
+    const camera = cameraRef.camera;
+    camera.updateMatrixWorld(true);
+    this.projectionMatrix.multiplyMatrices(
+      camera.projectionMatrix,
+      camera.matrixWorldInverse
+    );
+    this.frustum.setFromProjectionMatrix(this.projectionMatrix);
+    if (!requireFullyVisible) {
+      return this.frustum.intersectsBox(bounds);
+    }
+    return this.getCorners(bounds).every((corner) => this.frustum.containsPoint(corner));
+  }
+  getCorners(bounds) {
+    const { min, max } = bounds;
+    this.corners[0].set(min.x, min.y, min.z);
+    this.corners[1].set(min.x, min.y, max.z);
+    this.corners[2].set(min.x, max.y, min.z);
+    this.corners[3].set(min.x, max.y, max.z);
+    this.corners[4].set(max.x, min.y, min.z);
+    this.corners[5].set(max.x, min.y, max.z);
+    this.corners[6].set(max.x, max.y, min.z);
+    this.corners[7].set(max.x, max.y, max.z);
+    return this.corners;
+  }
+  getCameraLabel(camera, index) {
+    return camera.name || (index === 0 ? "primary" : `camera-${index}`);
+  }
+  notifyVisibilityChange(entity, options, previousState, nextState) {
+    if (!nextState.justEntered && !nextState.justExited) {
+      return;
+    }
+    const context = {
+      entity,
+      visible: nextState.visible,
+      wasVisible: previousState.visible,
+      justEntered: nextState.justEntered,
+      justExited: nextState.justExited,
+      visibleCameraNames: [...nextState.visibleCameraNames],
+      cameraName: options.cameraName
+    };
+    if (nextState.justEntered) {
+      options.onEnter?.(context);
+    }
+    if (nextState.justExited) {
+      options.onExit?.(context);
+    }
+    options.onChange?.(context);
+  }
+  destroy(_ecs) {
+    this.boundsCache.clear();
+  }
+};
+function createScreenVisibilityHandle(ref) {
+  return {
+    isVisible: () => {
+      const fsm = ref.fsm;
+      return fsm?.isVisible() ?? false;
+    },
+    isOffscreen: () => {
+      const fsm = ref.fsm;
+      return !(fsm?.isVisible() ?? false);
+    },
+    wasJustEntered: () => {
+      const fsm = ref.fsm;
+      return fsm?.wasJustEntered() ?? false;
+    },
+    wasJustExited: () => {
+      const fsm = ref.fsm;
+      return fsm?.wasJustExited() ?? false;
+    },
+    getVisibleCameraNames: () => {
+      const fsm = ref.fsm;
+      return fsm?.getVisibleCameraNames() ?? [];
+    },
+    getState: () => {
+      const fsm = ref.fsm;
+      return fsm?.getState() ?? null;
+    }
+  };
+}
+var ScreenVisibilityBehavior = defineBehavior({
+  name: "screen-visibility",
+  defaultOptions,
+  systemFactory: (ctx) => new ScreenVisibilitySystem(ctx.scene, ctx.getBehaviorLinks),
+  createHandle: createScreenVisibilityHandle
+});
+
+export {
+  ScreenVisibilityFSM,
+  ScreenVisibilityBehavior
+};
+//# sourceMappingURL=chunk-WOMHL23C.js.map

package/dist/chunk-WOMHL23C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/behaviors/screen-visibility/screen-visibility.descriptor.ts","../src/lib/behaviors/screen-visibility/screen-visibility-fsm.ts"],"sourcesContent":["import {\n\tBox3,\n\tFrustum,\n\tMatrix4,\n\tQuaternion,\n\tVector3,\n\ttype Object3D,\n} from 'three';\n\nimport { defineBehavior, type BehaviorRef } from '../behavior-descriptor';\nimport type { BehaviorEntityLink, BehaviorSystem } from '../behavior-system';\nimport { ScreenVisibilityFSM, type ScreenVisibilitySnapshot } from './screen-visibility-fsm';\nimport type { GameEntity } from '../../entities/entity';\nimport type { ZylemCamera } from '../../camera/zylem-camera';\n\nexport interface ScreenVisibilitySize {\n\tx: number;\n\ty: number;\n\tz: number;\n}\n\nexport interface ScreenVisibilityChangeContext {\n\tentity: GameEntity<any>;\n\tvisible: boolean;\n\twasVisible: boolean;\n\tjustEntered: boolean;\n\tjustExited: boolean;\n\tvisibleCameraNames: string[];\n\tcameraName: string | null;\n}\n\nexport interface ScreenVisibilityOptions {\n\t/**\n\t * Restrict visibility checks to one active camera by name.\n\t * When omitted, any active camera can make the entity visible.\n\t */\n\tcameraName: string | null;\n\t/**\n\t * Require the full entity bounds to remain inside the camera frustum.\n\t * Defaults to partial visibility (any intersection counts).\n\t */\n\trequireFullyVisible: boolean;\n\t/**\n\t * Expand or shrink the computed bounds in world units.\n\t * Positive values make visibility checks more generous.\n\t */\n\tpadding: number;\n\t/**\n\t * Optional bounds to use when the entity has no renderable mesh/group.\n\t * Falls back to the entity's configured size when available.\n\t */\n\tfallbackSize: ScreenVisibilitySize | null;\n\tonChange?: (context: ScreenVisibilityChangeContext) => void;\n\tonEnter?: (context: ScreenVisibilityChangeContext) => void;\n\tonExit?: (context: ScreenVisibilityChangeContext) => void;\n}\n\nexport interface ScreenVisibilityHandle {\n\tisVisible(): boolean;\n\tisOffscreen(): boolean;\n\twasJustEntered(): boolean;\n\twasJustExited(): boolean;\n\tgetVisibleCameraNames(): string[];\n\tgetState(): ScreenVisibilitySnapshot | null;\n}\n\nconst defaultOptions: ScreenVisibilityOptions = {\n\tcameraName: null,\n\trequireFullyVisible: false,\n\tpadding: 0,\n\tfallbackSize: null,\n\tonChange: undefined,\n\tonEnter: undefined,\n\tonExit: undefined,\n};\n\nconst SCREEN_VISIBILITY_BEHAVIOR_KEY = Symbol.for(\n\t'zylem:behavior:screen-visibility',\n);\n\nclass ScreenVisibilitySystem implements BehaviorSystem {\n\tprivate readonly worldBounds = new Box3();\n\tprivate readonly projectionMatrix = new Matrix4();\n\tprivate readonly frustum = new Frustum();\n\tprivate readonly savedPosition = new Vector3();\n\tprivate readonly savedQuaternion = new Quaternion();\n\tprivate readonly worldPosition = new Vector3();\n\tprivate readonly fallbackMin = new Vector3();\n\tprivate readonly fallbackMax = new Vector3();\n\tprivate readonly corners = Array.from({ length: 8 }, () => new Vector3());\n\tprivate readonly boundsCache = new Map<string, {\n\t\tbounds: Box3;\n\t\tkey: string;\n\t}>();\n\n\tconstructor(\n\t\tprivate scene: any,\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_VISIBILITY_BEHAVIOR_KEY);\n\t\tif (!links) return;\n\n\t\tfor (const link of links) {\n\t\t\tconst entity = link.entity as GameEntity<any>;\n\t\t\tconst visibilityRef = link.ref as BehaviorRef<ScreenVisibilityOptions>;\n\t\t\tconst options = visibilityRef.options;\n\n\t\t\tif (!visibilityRef.fsm) {\n\t\t\t\tvisibilityRef.fsm = new ScreenVisibilityFSM();\n\t\t\t}\n\n\t\t\tconst fsm = visibilityRef.fsm as ScreenVisibilityFSM;\n\t\t\tconst previousState = fsm.getState();\n\t\t\tconst cameras = this.resolveActiveCameras(options.cameraName);\n\t\t\tconst visibleCameraNames: string[] = [];\n\n\t\t\tconst bounds = this.computeWorldBounds(entity, visibilityRef, options);\n\t\t\tif (bounds) {\n\t\t\t\tfor (let index = 0; index < cameras.length; index++) {\n\t\t\t\t\tconst cameraRef = cameras[index];\n\t\t\t\t\tif (this.isBoundsVisible(bounds, cameraRef, options.requireFullyVisible)) {\n\t\t\t\t\t\tvisibleCameraNames.push(this.getCameraLabel(cameraRef, index));\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tfsm.update(visibleCameraNames.length > 0, visibleCameraNames);\n\t\t\tthis.notifyVisibilityChange(entity, options, previousState, fsm.getState());\n\t\t}\n\t}\n\n\tprivate resolveActiveCameras(cameraName: string | null): ZylemCamera[] {\n\t\tconst activeCameras = this.scene?.cameraManager?.activeCameras?.length\n\t\t\t? [...this.scene.cameraManager.activeCameras]\n\t\t\t: this.scene?.zylemCamera\n\t\t\t\t? [this.scene.zylemCamera]\n\t\t\t\t: [];\n\n\t\tif (!cameraName) {\n\t\t\treturn activeCameras;\n\t\t}\n\n\t\treturn activeCameras.filter((camera: ZylemCamera) => camera.name === cameraName);\n\t}\n\n\tprivate computeWorldBounds(\n\t\tentity: GameEntity<any>,\n\t\tref: BehaviorRef<ScreenVisibilityOptions>,\n\t\toptions: ScreenVisibilityOptions,\n\t): Box3 | null {\n\t\tconst cacheKey = this.getBoundsCacheKey(entity, options);\n\t\tconst cached = this.boundsCache.get(entity.uuid);\n\t\tif (cached && cached.key === cacheKey) {\n\t\t\treturn cached.bounds;\n\t\t}\n\n\t\tconst target = (entity.group ?? entity.mesh) as Object3D | undefined;\n\t\tthis.worldBounds.makeEmpty();\n\n\t\tif (target) {\n\t\t\tconst wasmPose = (entity as any).getPose?.();\n\t\t\tconst useWasm = wasmPose && (entity as any).runtimeHandle >= 0;\n\t\t\tconst body = useWasm ? null : (entity as any).body;\n\n\t\t\tif (useWasm || body) {\n\t\t\t\tthis.savedPosition.copy(target.position);\n\t\t\t\tthis.savedQuaternion.copy(target.quaternion);\n\n\t\t\t\tif (useWasm) {\n\t\t\t\t\ttarget.position.set(wasmPose.position.x, wasmPose.position.y, wasmPose.position.z);\n\t\t\t\t\tif (!(entity as any).controlledRotation) {\n\t\t\t\t\t\ttarget.quaternion.set(\n\t\t\t\t\t\t\twasmPose.rotation.x,\n\t\t\t\t\t\t\twasmPose.rotation.y,\n\t\t\t\t\t\t\twasmPose.rotation.z,\n\t\t\t\t\t\t\twasmPose.rotation.w,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tconst translation = body.translation();\n\t\t\t\t\ttarget.position.set(translation.x, translation.y, translation.z);\n\t\t\t\t\tif (!(entity as any).controlledRotation) {\n\t\t\t\t\t\tconst rotation = body.rotation();\n\t\t\t\t\t\ttarget.quaternion.set(rotation.x, rotation.y, rotation.z, rotation.w);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\ttarget.updateWorldMatrix(true, true);\n\t\t\t\tthis.worldBounds.setFromObject(target);\n\n\t\t\t\ttarget.position.copy(this.savedPosition);\n\t\t\t\ttarget.quaternion.copy(this.savedQuaternion);\n\t\t\t\ttarget.updateWorldMatrix(true, true);\n\t\t\t} else {\n\t\t\t\ttarget.updateWorldMatrix(true, true);\n\t\t\t\tthis.worldBounds.setFromObject(target);\n\t\t\t}\n\t\t}\n\n\t\tif (this.worldBounds.isEmpty()) {\n\t\t\tconst fallbackSize = options.fallbackSize\n\t\t\t\t?? ((entity.options?.size as ScreenVisibilitySize | undefined) ?? null);\n\t\t\tthis.resolveFallbackCenter(entity, target);\n\n\t\t\tconst halfX = (fallbackSize?.x ?? 0) / 2;\n\t\t\tconst halfY = (fallbackSize?.y ?? 0) / 2;\n\t\t\tconst halfZ = (fallbackSize?.z ?? 0) / 2;\n\n\t\t\tthis.fallbackMin.set(\n\t\t\t\tthis.worldPosition.x - halfX,\n\t\t\t\tthis.worldPosition.y - halfY,\n\t\t\t\tthis.worldPosition.z - halfZ,\n\t\t\t);\n\t\t\tthis.fallbackMax.set(\n\t\t\t\tthis.worldPosition.x + halfX,\n\t\t\t\tthis.worldPosition.y + halfY,\n\t\t\t\tthis.worldPosition.z + halfZ,\n\t\t\t);\n\t\t\tthis.worldBounds.set(this.fallbackMin, this.fallbackMax);\n\t\t}\n\n\t\tif (options.padding !== 0) {\n\t\t\tthis.worldBounds.expandByScalar(options.padding);\n\t\t}\n\n\t\tif (this.worldBounds.isEmpty()) {\n\t\t\tthis.boundsCache.delete(entity.uuid);\n\t\t\treturn null;\n\t\t}\n\n\t\tconst cachedBounds = cached?.bounds ?? new Box3();\n\t\tcachedBounds.copy(this.worldBounds);\n\t\tthis.boundsCache.set(entity.uuid, {\n\t\t\tbounds: cachedBounds,\n\t\t\tkey: cacheKey,\n\t\t});\n\t\t(ref as any).__screenVisibilityBoundsKey = cacheKey;\n\t\treturn cachedBounds;\n\t}\n\n\tprivate getBoundsCacheKey(\n\t\tentity: GameEntity<any>,\n\t\toptions: ScreenVisibilityOptions,\n\t): string {\n\t\tconst body = (entity as any).body;\n\t\tif (body) {\n\t\t\tconst translation = body.translation();\n\t\t\tconst rotation = body.rotation();\n\t\t\treturn [\n\t\t\t\t'b',\n\t\t\t\ttranslation.x.toFixed(3),\n\t\t\t\ttranslation.y.toFixed(3),\n\t\t\t\ttranslation.z.toFixed(3),\n\t\t\t\trotation.x.toFixed(3),\n\t\t\t\trotation.y.toFixed(3),\n\t\t\t\trotation.z.toFixed(3),\n\t\t\t\trotation.w.toFixed(3),\n\t\t\t\toptions.padding,\n\t\t\t\toptions.requireFullyVisible,\n\t\t\t\toptions.fallbackSize?.x ?? '',\n\t\t\t\toptions.fallbackSize?.y ?? '',\n\t\t\t\toptions.fallbackSize?.z ?? '',\n\t\t\t].join('|');\n\t\t}\n\n\t\tconst target = (entity.group ?? entity.mesh) as Object3D | undefined;\n\t\tif (target) {\n\t\t\tconst position = target.position;\n\t\t\tconst quaternion = target.quaternion;\n\t\t\tconst scale = target.scale;\n\t\t\treturn [\n\t\t\t\t'o',\n\t\t\t\tposition.x.toFixed(3),\n\t\t\t\tposition.y.toFixed(3),\n\t\t\t\tposition.z.toFixed(3),\n\t\t\t\tquaternion.x.toFixed(3),\n\t\t\t\tquaternion.y.toFixed(3),\n\t\t\t\tquaternion.z.toFixed(3),\n\t\t\t\tquaternion.w.toFixed(3),\n\t\t\t\tscale.x.toFixed(3),\n\t\t\t\tscale.y.toFixed(3),\n\t\t\t\tscale.z.toFixed(3),\n\t\t\t\toptions.padding,\n\t\t\t\toptions.requireFullyVisible,\n\t\t\t\toptions.fallbackSize?.x ?? '',\n\t\t\t\toptions.fallbackSize?.y ?? '',\n\t\t\t\toptions.fallbackSize?.z ?? '',\n\t\t\t].join('|');\n\t\t}\n\n\t\tconst position = entity.options?.position ?? { x: 0, y: 0, z: 0 };\n\t\tconst size = entity.options?.size ?? { x: 0, y: 0, z: 0 };\n\t\treturn [\n\t\t\t's',\n\t\t\tposition.x,\n\t\t\tposition.y,\n\t\t\tposition.z,\n\t\t\tsize.x,\n\t\t\tsize.y,\n\t\t\tsize.z,\n\t\t\toptions.padding,\n\t\t\toptions.requireFullyVisible,\n\t\t\toptions.fallbackSize?.x ?? '',\n\t\t\toptions.fallbackSize?.y ?? '',\n\t\t\toptions.fallbackSize?.z ?? '',\n\t\t].join('|');\n\t}\n\n\tprivate resolveFallbackCenter(\n\t\tentity: GameEntity<any>,\n\t\ttarget: Object3D | undefined,\n\t): void {\n\t\tconst body = (entity as any).body;\n\t\tif (body) {\n\t\t\tconst translation = body.translation();\n\t\t\tthis.worldPosition.set(translation.x, translation.y, translation.z);\n\t\t\treturn;\n\t\t}\n\n\t\tif (target) {\n\t\t\ttarget.updateWorldMatrix(true, false);\n\t\t\ttarget.getWorldPosition(this.worldPosition);\n\t\t\treturn;\n\t\t}\n\n\t\tconst position = entity.options?.position ?? { x: 0, y: 0, z: 0 };\n\t\tthis.worldPosition.set(position.x, position.y, position.z);\n\t}\n\n\tprivate isBoundsVisible(\n\t\tbounds: Box3,\n\t\tcameraRef: ZylemCamera,\n\t\trequireFullyVisible: boolean,\n\t): boolean {\n\t\tconst camera = cameraRef.camera;\n\t\tcamera.updateMatrixWorld(true);\n\t\tthis.projectionMatrix.multiplyMatrices(\n\t\t\tcamera.projectionMatrix,\n\t\t\tcamera.matrixWorldInverse,\n\t\t);\n\t\tthis.frustum.setFromProjectionMatrix(this.projectionMatrix);\n\n\t\tif (!requireFullyVisible) {\n\t\t\treturn this.frustum.intersectsBox(bounds);\n\t\t}\n\n\t\treturn this.getCorners(bounds).every((corner) => this.frustum.containsPoint(corner));\n\t}\n\n\tprivate getCorners(bounds: Box3): Vector3[] {\n\t\tconst { min, max } = bounds;\n\t\tthis.corners[0].set(min.x, min.y, min.z);\n\t\tthis.corners[1].set(min.x, min.y, max.z);\n\t\tthis.corners[2].set(min.x, max.y, min.z);\n\t\tthis.corners[3].set(min.x, max.y, max.z);\n\t\tthis.corners[4].set(max.x, min.y, min.z);\n\t\tthis.corners[5].set(max.x, min.y, max.z);\n\t\tthis.corners[6].set(max.x, max.y, min.z);\n\t\tthis.corners[7].set(max.x, max.y, max.z);\n\t\treturn this.corners;\n\t}\n\n\tprivate getCameraLabel(camera: ZylemCamera, index: number): string {\n\t\treturn camera.name || (index === 0 ? 'primary' : `camera-${index}`);\n\t}\n\n\tprivate notifyVisibilityChange(\n\t\tentity: GameEntity<any>,\n\t\toptions: ScreenVisibilityOptions,\n\t\tpreviousState: ScreenVisibilitySnapshot,\n\t\tnextState: ScreenVisibilitySnapshot,\n\t): void {\n\t\tif (!nextState.justEntered && !nextState.justExited) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst context: ScreenVisibilityChangeContext = {\n\t\t\tentity,\n\t\t\tvisible: nextState.visible,\n\t\t\twasVisible: previousState.visible,\n\t\t\tjustEntered: nextState.justEntered,\n\t\t\tjustExited: nextState.justExited,\n\t\t\tvisibleCameraNames: [...nextState.visibleCameraNames],\n\t\t\tcameraName: options.cameraName,\n\t\t};\n\n\t\tif (nextState.justEntered) {\n\t\t\toptions.onEnter?.(context);\n\t\t}\n\n\t\tif (nextState.justExited) {\n\t\t\toptions.onExit?.(context);\n\t\t}\n\n\t\toptions.onChange?.(context);\n\t}\n\n\tdestroy(_ecs: unknown): void {\n\t\tthis.boundsCache.clear();\n\t}\n}\n\nfunction createScreenVisibilityHandle(\n\tref: BehaviorRef<ScreenVisibilityOptions>,\n): ScreenVisibilityHandle {\n\treturn {\n\t\tisVisible: () => {\n\t\t\tconst fsm = ref.fsm as ScreenVisibilityFSM | undefined;\n\t\t\treturn fsm?.isVisible() ?? false;\n\t\t},\n\t\tisOffscreen: () => {\n\t\t\tconst fsm = ref.fsm as ScreenVisibilityFSM | undefined;\n\t\t\treturn !(fsm?.isVisible() ?? false);\n\t\t},\n\t\twasJustEntered: () => {\n\t\t\tconst fsm = ref.fsm as ScreenVisibilityFSM | undefined;\n\t\t\treturn fsm?.wasJustEntered() ?? false;\n\t\t},\n\t\twasJustExited: () => {\n\t\t\tconst fsm = ref.fsm as ScreenVisibilityFSM | undefined;\n\t\t\treturn fsm?.wasJustExited() ?? false;\n\t\t},\n\t\tgetVisibleCameraNames: () => {\n\t\t\tconst fsm = ref.fsm as ScreenVisibilityFSM | undefined;\n\t\t\treturn fsm?.getVisibleCameraNames() ?? [];\n\t\t},\n\t\tgetState: () => {\n\t\t\tconst fsm = ref.fsm as ScreenVisibilityFSM | undefined;\n\t\t\treturn fsm?.getState() ?? null;\n\t\t},\n\t};\n}\n\nexport const ScreenVisibilityBehavior = defineBehavior<\n\tScreenVisibilityOptions,\n\tScreenVisibilityHandle\n>({\n\tname: 'screen-visibility',\n\tdefaultOptions,\n\tsystemFactory: (ctx) =>\n\t\tnew ScreenVisibilitySystem(ctx.scene, ctx.getBehaviorLinks),\n\tcreateHandle: createScreenVisibilityHandle,\n});\n","export interface ScreenVisibilitySnapshot {\n\tinitialized: boolean;\n\tvisible: boolean;\n\tjustEntered: boolean;\n\tjustExited: boolean;\n\tvisibleCameraNames: string[];\n}\n\nexport class ScreenVisibilityFSM {\n\tprivate initialized = false;\n\tprivate visible = false;\n\tprivate justEntered = false;\n\tprivate justExited = false;\n\tprivate visibleCameraNames: string[] = [];\n\n\tupdate(visible: boolean, visibleCameraNames: readonly string[]): void {\n\t\tconst wasVisible = this.visible;\n\n\t\tthis.justEntered = !wasVisible && visible;\n\t\tthis.justExited = wasVisible && !visible;\n\n\t\tif (!this.initialized) {\n\t\t\tthis.justEntered = visible;\n\t\t\tthis.justExited = false;\n\t\t}\n\n\t\tthis.initialized = true;\n\t\tthis.visible = visible;\n\t\tthis.visibleCameraNames = [...visibleCameraNames];\n\t}\n\n\tisInitialized(): boolean {\n\t\treturn this.initialized;\n\t}\n\n\tisVisible(): boolean {\n\t\treturn this.visible;\n\t}\n\n\twasJustEntered(): boolean {\n\t\treturn this.justEntered;\n\t}\n\n\twasJustExited(): boolean {\n\t\treturn this.justExited;\n\t}\n\n\tgetVisibleCameraNames(): string[] {\n\t\treturn [...this.visibleCameraNames];\n\t}\n\n\tgetState(): ScreenVisibilitySnapshot {\n\t\treturn {\n\t\t\tinitialized: this.initialized,\n\t\t\tvisible: this.visible,\n\t\t\tjustEntered: this.justEntered,\n\t\t\tjustExited: this.justExited,\n\t\t\tvisibleCameraNames: this.getVisibleCameraNames(),\n\t\t};\n\t}\n}\n"],"mappings":"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","names":["position"]}

package/dist/chunk-WWVD5DR5.js

@@ -0,0 +1,120 @@
+// src/lib/core/vector.ts
+import { Vector2 as ThreeVector2, Vector3 as ThreeVector3 } from "three";
+import { Vector3 as RapierVector3 } from "@dimforge/rapier3d-compat";
+var VEC2_ZERO = Object.freeze({
+  x: 0,
+  y: 0
+});
+var VEC2_ONE = Object.freeze({ x: 1, y: 1 });
+var VEC3_ZERO = Object.freeze({
+  x: 0,
+  y: 0,
+  z: 0
+});
+var VEC3_ONE = Object.freeze({
+  x: 1,
+  y: 1,
+  z: 1
+});
+function isFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function hasVec2Shape(value) {
+  return value != null && typeof value === "object" && ("x" in value || "y" in value);
+}
+function hasVec3Shape(value) {
+  return value != null && typeof value === "object" && ("x" in value || "y" in value || "z" in value);
+}
+function getArrayAxis(value, index, fallback) {
+  if (!value) {
+    return fallback;
+  }
+  const axis = value[index];
+  return isFiniteNumber(axis) ? axis : fallback;
+}
+function getObjectAxis(value, key, fallback) {
+  if (!value) {
+    return fallback;
+  }
+  const axis = value[key];
+  return isFiniteNumber(axis) ? axis : fallback;
+}
+function getVec2Axis(value, key, index, fallback) {
+  if (!value) {
+    return fallback;
+  }
+  if (Array.isArray(value)) {
+    return getArrayAxis(value, index, fallback);
+  }
+  return getObjectAxis(value, key, fallback);
+}
+function getVec3Axis(value, key, index, fallback) {
+  if (!value) {
+    return fallback;
+  }
+  if (Array.isArray(value)) {
+    return getArrayAxis(value, index, fallback);
+  }
+  return getObjectAxis(value, key, fallback);
+}
+function normalizeVec2Defaults(defaults) {
+  return {
+    x: getVec2Axis(defaults, "x", 0, 0),
+    y: getVec2Axis(defaults, "y", 1, 0)
+  };
+}
+function normalizeVec3Defaults(defaults) {
+  return {
+    x: getVec3Axis(defaults, "x", 0, 0),
+    y: getVec3Axis(defaults, "y", 1, 0),
+    z: getVec3Axis(defaults, "z", 2, 0)
+  };
+}
+function isVec2Input(value) {
+  return Array.isArray(value) || hasVec2Shape(value);
+}
+function isVec3Input(value) {
+  return Array.isArray(value) || hasVec3Shape(value);
+}
+function normalizeVec2(input, defaults = VEC2_ZERO) {
+  const fallback = normalizeVec2Defaults(defaults);
+  return {
+    x: getVec2Axis(input, "x", 0, fallback.x),
+    y: getVec2Axis(input, "y", 1, fallback.y)
+  };
+}
+function normalizeVec3(input, defaults = VEC3_ZERO) {
+  const fallback = normalizeVec3Defaults(defaults);
+  return {
+    x: getVec3Axis(input, "x", 0, fallback.x),
+    y: getVec3Axis(input, "y", 1, fallback.y),
+    z: getVec3Axis(input, "z", 2, fallback.z)
+  };
+}
+function toThreeVector2(input, defaults = VEC2_ZERO) {
+  const { x, y } = normalizeVec2(input, defaults);
+  return new ThreeVector2(x, y);
+}
+function toThreeVector3(input, defaults = VEC3_ZERO) {
+  const { x, y, z } = normalizeVec3(input, defaults);
+  return new ThreeVector3(x, y, z);
+}
+function toRapierVector3(input, defaults = VEC3_ZERO) {
+  const { x, y, z } = normalizeVec3(input, defaults);
+  return new RapierVector3(x, y, z);
+}
+
+export {
+  VEC2_ZERO,
+  VEC2_ONE,
+  VEC3_ZERO,
+  VEC3_ONE,
+  isVec2Input,
+  isVec3Input,
+  normalizeVec2,
+  normalizeVec3,
+  toThreeVector2,
+  toThreeVector3,
+  toRapierVector3
+};
+//# sourceMappingURL=chunk-WWVD5DR5.js.map

package/dist/chunk-WWVD5DR5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/core/vector.ts"],"sourcesContent":["import { Vector2 as ThreeVector2, Vector3 as ThreeVector3 } from 'three';\nimport { Vector3 as RapierVector3 } from '@dimforge/rapier3d-compat';\n\nexport type Vec2 = ThreeVector2;\nexport type Vec3 = ThreeVector3 | RapierVector3;\n\nexport type Vec2Components = { x: number; y: number };\nexport type Vec3Components = { x: number; y: number; z: number };\n\ntype Vec2Tuple = readonly [number?, number?] & { x?: number; y?: number };\ntype Vec3Tuple = readonly [number?, number?, number?] & {\n  x?: number;\n  y?: number;\n  z?: number;\n};\n\nexport type Vec2Input = Vec2 | { x?: number; y?: number } | Vec2Tuple;\nexport type Vec3Input =\n  | Vec3\n  | { x?: number; y?: number; z?: number }\n  | Vec3Tuple;\n\nexport const VEC2_ZERO: Readonly<Vec2Components> = Object.freeze({\n  x: 0,\n  y: 0,\n});\nexport const VEC2_ONE: Readonly<Vec2Components> = Object.freeze({ x: 1, y: 1 });\nexport const VEC3_ZERO: Readonly<Vec3Components> = Object.freeze({\n  x: 0,\n  y: 0,\n  z: 0,\n});\nexport const VEC3_ONE: Readonly<Vec3Components> = Object.freeze({\n  x: 1,\n  y: 1,\n  z: 1,\n});\n\nfunction isFiniteNumber(value: unknown): value is number {\n  return typeof value === 'number' && Number.isFinite(value);\n}\n\nfunction hasVec2Shape(value: unknown): value is { x?: unknown; y?: unknown } {\n  return (\n    value != null && typeof value === 'object' && ('x' in value || 'y' in value)\n  );\n}\n\nfunction hasVec3Shape(\n  value: unknown,\n): value is { x?: unknown; y?: unknown; z?: unknown } {\n  return (\n    value != null &&\n    typeof value === 'object' &&\n    ('x' in value || 'y' in value || 'z' in value)\n  );\n}\n\nfunction getArrayAxis(\n  value: readonly unknown[] | undefined,\n  index: number,\n  fallback: number,\n): number {\n  if (!value) {\n    return fallback;\n  }\n  const axis = value[index];\n  return isFiniteNumber(axis) ? axis : fallback;\n}\n\nfunction getObjectAxis(\n  value: { [key: string]: unknown } | undefined,\n  key: 'x' | 'y' | 'z',\n  fallback: number,\n): number {\n  if (!value) {\n    return fallback;\n  }\n  const axis = value[key];\n  return isFiniteNumber(axis) ? axis : fallback;\n}\n\nfunction getVec2Axis(\n  value: Vec2Input | Partial<Vec2Components> | null | undefined,\n  key: 'x' | 'y',\n  index: 0 | 1,\n  fallback: number,\n): number {\n  if (!value) {\n    return fallback;\n  }\n  if (Array.isArray(value)) {\n    return getArrayAxis(value, index, fallback);\n  }\n  return getObjectAxis(value as { [key: string]: unknown }, key, fallback);\n}\n\nfunction getVec3Axis(\n  value: Vec3Input | Partial<Vec3Components> | null | undefined,\n  key: 'x' | 'y' | 'z',\n  index: 0 | 1 | 2,\n  fallback: number,\n): number {\n  if (!value) {\n    return fallback;\n  }\n  if (Array.isArray(value)) {\n    return getArrayAxis(value, index, fallback);\n  }\n  return getObjectAxis(value as { [key: string]: unknown }, key, fallback);\n}\n\nfunction normalizeVec2Defaults(\n  defaults: Vec2Input | Partial<Vec2Components> | null | undefined,\n): Vec2Components {\n  return {\n    x: getVec2Axis(defaults, 'x', 0, 0),\n    y: getVec2Axis(defaults, 'y', 1, 0),\n  };\n}\n\nfunction normalizeVec3Defaults(\n  defaults: Vec3Input | Partial<Vec3Components> | null | undefined,\n): Vec3Components {\n  return {\n    x: getVec3Axis(defaults, 'x', 0, 0),\n    y: getVec3Axis(defaults, 'y', 1, 0),\n    z: getVec3Axis(defaults, 'z', 2, 0),\n  };\n}\n\nexport function isVec2Input(value: unknown): value is Vec2Input {\n  return Array.isArray(value) || hasVec2Shape(value);\n}\n\nexport function isVec3Input(value: unknown): value is Vec3Input {\n  return Array.isArray(value) || hasVec3Shape(value);\n}\n\nexport function normalizeVec2(\n  input?: Vec2Input | null,\n  defaults: Vec2Input | Partial<Vec2Components> = VEC2_ZERO,\n): Vec2Components {\n  const fallback = normalizeVec2Defaults(defaults);\n  return {\n    x: getVec2Axis(input, 'x', 0, fallback.x),\n    y: getVec2Axis(input, 'y', 1, fallback.y),\n  };\n}\n\nexport function normalizeVec3(\n  input?: Vec3Input | null,\n  defaults: Vec3Input | Partial<Vec3Components> = VEC3_ZERO,\n): Vec3Components {\n  const fallback = normalizeVec3Defaults(defaults);\n  return {\n    x: getVec3Axis(input, 'x', 0, fallback.x),\n    y: getVec3Axis(input, 'y', 1, fallback.y),\n    z: getVec3Axis(input, 'z', 2, fallback.z),\n  };\n}\n\nexport function toThreeVector2(\n  input?: Vec2Input | null,\n  defaults: Vec2Input | Partial<Vec2Components> = VEC2_ZERO,\n): ThreeVector2 {\n  const { x, y } = normalizeVec2(input, defaults);\n  return new ThreeVector2(x, y);\n}\n\nexport function toThreeVector3(\n  input?: Vec3Input | null,\n  defaults: Vec3Input | Partial<Vec3Components> = VEC3_ZERO,\n): ThreeVector3 {\n  const { x, y, z } = normalizeVec3(input, defaults);\n  return new ThreeVector3(x, y, z);\n}\n\nexport function toRapierVector3(\n  input?: Vec3Input | null,\n  defaults: Vec3Input | Partial<Vec3Components> = VEC3_ZERO,\n): RapierVector3 {\n  const { x, y, z } = normalizeVec3(input, defaults);\n  return new RapierVector3(x, y, z);\n}\n"],"mappings":"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","names":[]}