@waica/engine 0.27.0 → 0.29.0

package/dist/spatial-query-3d.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from './entity.js';
 import type { Game } from './game.js';
 import { type Point3d, type QueryVolume3d } from './physics-3d/world-queries.js';
 import type { ComponentClasses, NearestSpatialQueryFilter, SpatialQueryFilter } from './spatial-query.js';
-export type { Point3d, QueryVolume3d } from './physics-3d/world-queries.js';
+export type { Point3d, QueryColliders3d, QueryVolume3d } from './physics-3d/world-queries.js';
 /** The first solid collider a 3D ray reached, with its entity and the crossing (issue #159 CA-21). */
 export interface RayHit3d<T extends Entity = Entity> {
     readonly entity: T;
@@ -18,7 +18,7 @@ type NearestFilter = NearestSpatialQueryFilter<ComponentClasses> | undefined;
 export interface EntityRules {
     matchesCommon(entity: Entity, filter: NearestFilter): boolean;
 }
-/** The 3D forms of `game.query` (ADR 0015's domains kept): `ray` reads solids, `area` and `point` read sensors, `nearest` reads transforms. */
+/** The 3D forms of `game.query` (ADR 0015's domains kept): `ray` reads solids, `area` and `point` read sensors (`area` every collider on request), `nearest` reads transforms. */
 export declare class SpatialQuery3d {
     private readonly game;
     private readonly rules;

package/dist/spatial-query-3d.js

@@ -1,9 +1,16 @@
 import { recordsAtPoint, recordsInVolume, worldRayHits } from './physics-3d/world-queries.js';
 const isPoint3d = (value) => typeof value === 'object' && value !== null && ['x', 'y', 'z'].every((axis) => Number.isFinite(Reflect.get(value, axis)));
 const isExtent = (value) => typeof value === 'number' && Number.isFinite(value) && value > 0;
+/** An absent or known collider domain, and an absent or finite box yaw: the optional parts of a volume. */
+function hasValidOptions(value) {
+    const colliders = Reflect.get(value, 'colliders');
+    const yaw = Reflect.get(value, 'yaw');
+    const knownDomain = colliders === undefined || colliders === 'sensors' || colliders === 'all';
+    return knownDomain && (yaw === undefined || (typeof yaw === 'number' && Number.isFinite(yaw)));
+}
 /** A finite box or sphere with a place: anything else is a volume Rapier cannot test. */
 function isVolume3d(value) {
-    if (typeof value !== 'object' || value === null || !isPoint3d(Reflect.get(value, 'center')))
+    if (typeof value !== 'object' || value === null || !isPoint3d(Reflect.get(value, 'center')) || !hasValidOptions(value))
         return false;
     const shape = Reflect.get(value, 'shape');
     if (shape === 'sphere')
@@ -13,7 +20,7 @@ function isVolume3d(value) {
 }
 /** The farthest a nearest query looks: its `maxDistance`, or no limit. */
 const rangeOf = (filter) => filter?.maxDistance ?? Infinity;
-/** The 3D forms of `game.query` (ADR 0015's domains kept): `ray` reads solids, `area` and `point` read sensors, `nearest` reads transforms. */
+/** The 3D forms of `game.query` (ADR 0015's domains kept): `ray` reads solids, `area` and `point` read sensors (`area` every collider on request), `nearest` reads transforms. */
 export class SpatialQuery3d {
     game;
     rules;
@@ -40,7 +47,8 @@ export class SpatialQuery3d {
         const world = this.worldNow();
         if (!world || !isVolume3d(volume))
             return [];
-        return this.inEntityOrder(recordsInVolume(world, volume, (record) => this.eligible(record, filter, true)), filter);
+        const domain = volume.colliders === 'all' ? 'all' : true;
+        return this.inEntityOrder(recordsInVolume(world, volume, (record) => this.eligible(record, filter, domain)), filter);
     }
     point(at, filter) {
         const world = this.worldNow();
@@ -82,7 +90,8 @@ export class SpatialQuery3d {
      * Rapier's callback, so it reads the record and nothing else.
      */
     eligible(record, filter, sensors) {
-        return record.sensor === sensors && record.entity.alive && this.rules.matchesCommon(record.entity, filter);
+        const inDomain = sensors === 'all' || record.sensor === sensors;
+        return inDomain && record.entity.alive && this.rules.matchesCommon(record.entity, filter);
     }
     /** The user's `where`, run after Rapier has answered: it may throw, spawn or destroy without the world mid-query. */
     wanted(record, filter) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/engine",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Waica game engine core — archetype-driven, web-first, 2D & 3D",
   "license": "MIT",
   "type": "module",