@flighthq/spatial 0.3.1-next.975.01aea94 → 0.4.0-edge.1908.751021c

package/dist/explainSpatialIndexing2D.d.ts

@@ -0,0 +1,3 @@
+import type { SpatialIndex2D, SpatialIndexingExplanation, SpatialObjectId } from '@flighthq/types/contract';
+export declare function explainSpatialIndexing2D(index: Readonly<SpatialIndex2D>, id: SpatialObjectId): SpatialIndexingExplanation;
+//# sourceMappingURL=explainSpatialIndexing2D.d.ts.map

package/dist/explainSpatialIndexing2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainSpatialIndexing2D.d.ts","sourceRoot":"","sources":["../src/explainSpatialIndexing2D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAY5G,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,EAAE,EAAE,eAAe,GAClB,0BAA0B,CAE5B"}

package/dist/{explainSpatialIndexing.js → explainSpatialIndexing2D.js}

@@ -8,7 +8,7 @@
 // This is the pull half of the diagnostics convention, and the measurement seam a regression test
 // asserts the cost bound against: `bucketCount` is the number that goes unbounded when the bound is
 // removed, so a test can pin it without timing anything.
-export function explainSpatialIndexing(index, id) {
+export function explainSpatialIndexing2D(index, id) {
     return index.runtime.backend.explainSpatialIndexing(id);
 }
-//# sourceMappingURL=explainSpatialIndexing.js.map
+//# sourceMappingURL=explainSpatialIndexing2D.js.map

package/dist/explainSpatialIndexing2D.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainSpatialIndexing2D.js","sourceRoot":"","sources":["../src/explainSpatialIndexing2D.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,sGAAsG;AACtG,+FAA+F;AAC/F,sGAAsG;AACtG,6FAA6F;AAC7F,yBAAyB;AACzB,EAAE;AACF,kGAAkG;AAClG,oGAAoG;AACpG,yDAAyD;AACzD,MAAM,UAAU,wBAAwB,CACtC,KAA+B,EAC/B,EAAmB;IAEnB,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/explainSpatialIndexing3D.d.ts

@@ -0,0 +1,3 @@
+import type { SpatialIndex3D, SpatialIndexingExplanation, SpatialObjectId } from '@flighthq/types/contract';
+export declare function explainSpatialIndexing3D(index: Readonly<SpatialIndex3D>, id: SpatialObjectId): SpatialIndexingExplanation;
+//# sourceMappingURL=explainSpatialIndexing3D.d.ts.map

package/dist/explainSpatialIndexing3D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainSpatialIndexing3D.d.ts","sourceRoot":"","sources":["../src/explainSpatialIndexing3D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAa5G,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,EAAE,EAAE,eAAe,GAClB,0BAA0B,CAE5B"}

package/dist/explainSpatialIndexing3D.js

@@ -0,0 +1,15 @@
+// Reports how the index is currently holding `id`, as plain data. Pure: reads only, indexes nothing,
+// never throws on an unknown id, and retains no reference to the backend. Import it to answer "why is
+// this object not in my query results?" — `absent` means it was never inserted or was removed,
+// `declined` means its bounds were non-finite or inverted and it is deliberately not held, `overflow`
+// means it is held but cannot be usefully bucketed, and `cells` reports the bucket count the
+// per-object bound caps.
+//
+// This is the pull half of the diagnostics convention, and the measurement seam a regression test
+// asserts the cost bound against: `bucketCount` is the number that goes unbounded when the bound is
+// removed, so a test can pin it without timing anything. It matters more here than in 2D — the span
+// a missing bound would walk grows with the cube of an object's extent rather than the square.
+export function explainSpatialIndexing3D(index, id) {
+    return index.runtime.backend.explainSpatialIndexing(id);
+}
+//# sourceMappingURL=explainSpatialIndexing3D.js.map

package/dist/explainSpatialIndexing3D.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainSpatialIndexing3D.js","sourceRoot":"","sources":["../src/explainSpatialIndexing3D.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,sGAAsG;AACtG,+FAA+F;AAC/F,sGAAsG;AACtG,6FAA6F;AAC7F,yBAAyB;AACzB,EAAE;AACF,kGAAkG;AAClG,oGAAoG;AACpG,oGAAoG;AACpG,+FAA+F;AAC/F,MAAM,UAAU,wBAAwB,CACtC,KAA+B,EAC/B,EAAmB;IAEnB,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/formatSpatialIndexingNotice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatSpatialIndexingNotice.d.ts","sourceRoot":"","sources":["../src/formatSpatialIndexingNotice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAiBtE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAsB3F"}
+{"version":3,"file":"formatSpatialIndexingNotice.d.ts","sourceRoot":"","sources":["../src/formatSpatialIndexingNotice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAuBtE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAsB3F"}

package/dist/formatSpatialIndexingNotice.js

@@ -3,6 +3,12 @@ import { MAX_INDEXED_CELLS_PER_OBJECT } from './uniformGrid';
 // holds one. Import it to turn the structured record a SpatialIndexingGuard receives into something a
 // developer reads; leave it unimported and neither the text nor its cost reaches a bundle.
 //
+// The sentences name the UNSUFFIXED backend methods (`removeSpatialObject`), never the dimensioned
+// free-function wrappers. A notice carries no axis — one guard serves both dimensions — so there is
+// nothing here from which to pick 2D or 3D, and naming one would misdescribe every notice from the
+// other. The unsuffixed names are also the ones a caller greps: they are what the backend seam
+// declares and what a consumer like physics3d actually calls.
+//
 // This package deliberately stops at the structured guard seam plus this optional formatter rather
 // than adding an `enableSpatialGuards` that chooses reporting policy. A caller can send the record to
 // tests, telemetry, a host sink, or `@flighthq/log`, choosing its own channel and deduplication. An
@@ -14,10 +20,10 @@ import { MAX_INDEXED_CELLS_PER_OBJECT } from './uniformGrid';
 //   setSpatialIndexingGuard((notice) => logWarn({ message: formatSpatialIndexingNotice(notice) }, 'spatial'));
 export function formatSpatialIndexingNotice(notice) {
     if (notice.reason === 'invalid-cell-size') {
-        return `createUniformGridSpatialBackend(${notice.cellSize}): cellSize must be a positive finite number. ${notice.operation}SpatialObject(${notice.id}) used the bounded overflow path instead, so results remain correct but queries scan this object.`;
+        return `the uniform grid's cellSize (${notice.cellSize}) must be a positive finite number. ${notice.operation}SpatialObject(${notice.id}) used the bounded overflow path instead, so results remain correct but queries scan this object.`;
     }
     if (notice.reason === 'inverted-bounds') {
-        return `${notice.operation}SpatialObject(${notice.id}): minX/minY must not exceed maxX/maxY, so the object was not indexed and no query will return it. The operation returns false for this — normalize or correct the bounds upstream.`;
+        return `${notice.operation}SpatialObject(${notice.id}): no minimum may exceed its matching maximum, so the object was not indexed and no query will return it. The operation returns false for this — normalize or correct the bounds upstream.`;
     }
     if (notice.reason === 'missing-id') {
         if (notice.operation === 'remove') {

package/dist/formatSpatialIndexingNotice.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatSpatialIndexingNotice.js","sourceRoot":"","sources":["../src/formatSpatialIndexingNotice.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAE7D,qGAAqG;AACrG,sGAAsG;AACtG,2FAA2F;AAC3F,EAAE;AACF,mGAAmG;AACnG,sGAAsG;AACtG,oGAAoG;AACpG,sGAAsG;AACtG,wGAAwG;AACxG,wGAAwG;AACxG,2CAA2C;AAC3C,EAAE;AACF,+GAA+G;AAC/G,MAAM,UAAU,2BAA2B,CAAC,MAAuC;IACjF,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QAC1C,OAAO,mCAAmC,MAAM,CAAC,QAAQ,iDAAiD,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,mGAAmG,CAAC;IAC1P,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;QACxC,OAAO,GAAG,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,qLAAqL,CAAC;IAC5O,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,uBAAuB,MAAM,CAAC,EAAE,kHAAkH,CAAC;QAC5J,CAAC;QACD,OAAO,uBAAuB,MAAM,CAAC,EAAE,oGAAoG,MAAM,CAAC,IAAI,yFAAyF,CAAC;IAClP,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,2MAA2M,CAAC;IAClQ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,sBAAsB,MAAM,CAAC,sBAAsB,oBAAoB,4BAA4B,kPAAkP,CAAC;IAC5Y,CAAC;IACD,gGAAgG;IAChG,oGAAoG;IACpG,OAAO,GAAG,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,kBAAkB,MAAM,CAAC,IAAI,2CAA2C,CAAC;AAC/H,CAAC"}
+{"version":3,"file":"formatSpatialIndexingNotice.js","sourceRoot":"","sources":["../src/formatSpatialIndexingNotice.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAE7D,qGAAqG;AACrG,sGAAsG;AACtG,2FAA2F;AAC3F,EAAE;AACF,mGAAmG;AACnG,oGAAoG;AACpG,mGAAmG;AACnG,+FAA+F;AAC/F,8DAA8D;AAC9D,EAAE;AACF,mGAAmG;AACnG,sGAAsG;AACtG,oGAAoG;AACpG,sGAAsG;AACtG,wGAAwG;AACxG,wGAAwG;AACxG,2CAA2C;AAC3C,EAAE;AACF,+GAA+G;AAC/G,MAAM,UAAU,2BAA2B,CAAC,MAAuC;IACjF,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QAC1C,OAAO,gCAAgC,MAAM,CAAC,QAAQ,uCAAuC,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,mGAAmG,CAAC;IAC7O,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;QACxC,OAAO,GAAG,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,4LAA4L,CAAC;IACnP,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,uBAAuB,MAAM,CAAC,EAAE,kHAAkH,CAAC;QAC5J,CAAC;QACD,OAAO,uBAAuB,MAAM,CAAC,EAAE,oGAAoG,MAAM,CAAC,IAAI,yFAAyF,CAAC;IAClP,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,2MAA2M,CAAC;IAClQ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,sBAAsB,MAAM,CAAC,sBAAsB,oBAAoB,4BAA4B,kPAAkP,CAAC;IAC5Y,CAAC;IACD,gGAAgG;IAChG,oGAAoG;IACpG,OAAO,GAAG,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,EAAE,kBAAkB,MAAM,CAAC,IAAI,2CAA2C,CAAC;AAC/H,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { MAX_INDEXED_CELLS_PER_OBJECT, clearSpatialIndex, createSpatialIndex, createUniformGridSpatialBackend, explainSpatialIndexing, formatSpatialIndexingNotice, insertSpatialObject, querySpatialPairs, querySpatialPoint, querySpatialRay, querySpatialRegion, removeSpatialObject, setSpatialIndexingGuard, updateSpatialObject, } from './contract';
+export { MAX_INDEXED_CELLS_PER_OBJECT, clearSpatialIndex2D, clearSpatialIndex3D, createSpatialIndex2D, createSpatialIndex3D, createUniformGridSpatialBackend2D, createBvhSpatialBackend3D, createUniformGridSpatialBackend3D, explainSpatialIndexing2D, explainSpatialIndexing3D, formatSpatialIndexingNotice, insertSpatialObject2D, insertSpatialObject3D, querySpatialPairs2D, querySpatialPairs3D, querySpatialPoint2D, querySpatialPoint3D, querySpatialRay2D, querySpatialRay3D, querySpatialRegion2D, querySpatialFrustum3D, querySpatialRegion3D, querySpatialSphere3D, removeSpatialObject2D, removeSpatialObject3D, setSpatialIndexingGuard, updateSpatialObject2D, updateSpatialObject3D, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,+BAA+B,EAC/B,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,iCAAiC,EACjC,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { MAX_INDEXED_CELLS_PER_OBJECT, clearSpatialIndex, createSpatialIndex, createUniformGridSpatialBackend, explainSpatialIndexing, formatSpatialIndexingNotice, insertSpatialObject, querySpatialPairs, querySpatialPoint, querySpatialRay, querySpatialRegion, removeSpatialObject, setSpatialIndexingGuard, updateSpatialObject, } from './contract';
+export { MAX_INDEXED_CELLS_PER_OBJECT, clearSpatialIndex2D, clearSpatialIndex3D, createSpatialIndex2D, createSpatialIndex3D, createUniformGridSpatialBackend2D, createBvhSpatialBackend3D, createUniformGridSpatialBackend3D, explainSpatialIndexing2D, explainSpatialIndexing3D, formatSpatialIndexingNotice, insertSpatialObject2D, insertSpatialObject3D, querySpatialPairs2D, querySpatialPairs3D, querySpatialPoint2D, querySpatialPoint3D, querySpatialRay2D, querySpatialRay3D, querySpatialRegion2D, querySpatialFrustum3D, querySpatialRegion3D, querySpatialSphere3D, removeSpatialObject2D, removeSpatialObject3D, setSpatialIndexingGuard, updateSpatialObject2D, updateSpatialObject3D, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,+BAA+B,EAC/B,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,iCAAiC,EACjC,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/spatialIndex.d.ts

@@ -1,11 +1,11 @@
-import type { SpatialAabb, SpatialIndex, SpatialIndexBackend, SpatialObjectId, SpatialPair } from '@flighthq/types/contract';
-export declare function clearSpatialIndex(index: Readonly<SpatialIndex>): void;
-export declare function createSpatialIndex(backend?: SpatialIndexBackend): SpatialIndex;
-export declare function insertSpatialObject(index: Readonly<SpatialIndex>, id: SpatialObjectId, bounds: Readonly<SpatialAabb>): boolean;
-export declare function querySpatialPairs(index: Readonly<SpatialIndex>, out: SpatialPair[]): void;
-export declare function querySpatialPoint(index: Readonly<SpatialIndex>, x: number, y: number, out: SpatialObjectId[]): void;
-export declare function querySpatialRay(index: Readonly<SpatialIndex>, x: number, y: number, dx: number, dy: number, out: SpatialObjectId[]): void;
-export declare function querySpatialRegion(index: Readonly<SpatialIndex>, region: Readonly<SpatialAabb>, out: SpatialObjectId[]): void;
-export declare function removeSpatialObject(index: Readonly<SpatialIndex>, id: SpatialObjectId): void;
-export declare function updateSpatialObject(index: Readonly<SpatialIndex>, id: SpatialObjectId, bounds: Readonly<SpatialAabb>): boolean;
+import type { SpatialAabb2D, SpatialIndex2D, SpatialIndexBackend2D, SpatialObjectId, SpatialPair } from '@flighthq/types/contract';
+export declare function clearSpatialIndex2D(index: Readonly<SpatialIndex2D>): void;
+export declare function createSpatialIndex2D(backend?: SpatialIndexBackend2D): SpatialIndex2D;
+export declare function insertSpatialObject2D(index: Readonly<SpatialIndex2D>, id: SpatialObjectId, bounds: Readonly<SpatialAabb2D>): boolean;
+export declare function querySpatialPairs2D(index: Readonly<SpatialIndex2D>, out: SpatialPair[]): void;
+export declare function querySpatialPoint2D(index: Readonly<SpatialIndex2D>, x: number, y: number, out: SpatialObjectId[]): void;
+export declare function querySpatialRay2D(index: Readonly<SpatialIndex2D>, x: number, y: number, dx: number, dy: number, out: SpatialObjectId[]): void;
+export declare function querySpatialRegion2D(index: Readonly<SpatialIndex2D>, region: Readonly<SpatialAabb2D>, out: SpatialObjectId[]): void;
+export declare function removeSpatialObject2D(index: Readonly<SpatialIndex2D>, id: SpatialObjectId): void;
+export declare function updateSpatialObject2D(index: Readonly<SpatialIndex2D>, id: SpatialObjectId, bounds: Readonly<SpatialAabb2D>): boolean;
 //# sourceMappingURL=spatialIndex.d.ts.map

package/dist/spatialIndex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spatialIndex.d.ts","sourceRoot":"","sources":["../src/spatialIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAKlC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAErE;AAMD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAM9E;AAOD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC7B,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,OAAO,CAET;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,CAEzF;AAGD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,IAAI,CAEnH;AAID,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,eAAe,EAAE,GACrB,IAAI,CAEN;AAGD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC7B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC7B,GAAG,EAAE,eAAe,EAAE,GACrB,IAAI,CAEN;AAGD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,eAAe,GAAG,IAAI,CAE5F;AAMD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC7B,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,OAAO,CAET"}
+{"version":3,"file":"spatialIndex.d.ts","sourceRoot":"","sources":["../src/spatialIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAKlC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,IAAI,CAEzE;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAMpF;AAOD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC9B,OAAO,CAET;AAKD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,CAE7F;AAGD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,eAAe,EAAE,GACrB,IAAI,CAEN;AAID,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,eAAe,EAAE,GACrB,IAAI,CAEN;AAGD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,GAAG,EAAE,eAAe,EAAE,GACrB,IAAI,CAEN;AAGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,eAAe,GAAG,IAAI,CAEhG;AAMD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC9B,OAAO,CAET"}

package/dist/spatialIndex.js

@@ -1,16 +1,16 @@
-import { createUniformGridSpatialBackend } from './uniformGrid';
+import { createUniformGridSpatialBackend2D } from './uniformGrid';
 // Empties the index of all objects while keeping it (and its backend) reusable.
-export function clearSpatialIndex(index) {
+export function clearSpatialIndex2D(index) {
     index.runtime.backend.clearSpatialIndex();
 }
 // Creates a 2D broadphase index. With no backend it defaults to a uniform grid sized for
 // medium-scale scenes; pass an explicit backend (a differently-sized grid, or a future quadtree /
 // sweep-and-prune) to select the structure for the workload. Constructing the default grid happens
 // here, on call — importing the package has no side effect.
-export function createSpatialIndex(backend) {
+export function createSpatialIndex2D(backend) {
     return {
         runtime: {
-            backend: backend ?? createUniformGridSpatialBackend(DEFAULT_SPATIAL_CELL_SIZE),
+            backend: backend ?? createUniformGridSpatialBackend2D(DEFAULT_SPATIAL_CELL_SIZE),
         },
     };
 }
@@ -18,41 +18,41 @@ export function createSpatialIndex(backend) {
 // may reuse its own value afterward. Returns false when the bounds cannot be indexed at all
 // (non-finite or inverted) — the object is then absent from every query rather than present at a
 // nonsense position. Oversized-but-valid bounds return true and stay fully queryable; the backend
-// decides how to hold them. explainSpatialIndexing reports which happened.
-export function insertSpatialObject(index, id, bounds) {
+// decides how to hold them. explainSpatialIndexing2D reports which happened.
+export function insertSpatialObject2D(index, id, bounds) {
     return index.runtime.backend.insertSpatialObject(id, bounds);
 }
 // Fills `out` (cleared first) with every deduplicated candidate pair — each unordered pair at most
 // once, never an object with itself. A pair is a broadphase candidate: the two objects are close
 // enough to be worth a narrow-phase test, which the caller (or @flighthq/collision) performs.
-export function querySpatialPairs(index, out) {
+export function querySpatialPairs2D(index, out) {
     index.runtime.backend.querySpatialPairs(out);
 }
 // Fills `out` (cleared first) with the ids whose bounds contain the point (`x`,`y`).
-export function querySpatialPoint(index, x, y, out) {
+export function querySpatialPoint2D(index, x, y, out) {
     index.runtime.backend.querySpatialPoint(x, y, out);
 }
 // Fills `out` (cleared first) with the ids whose bounds the ray from (`x`,`y`) along (`dx`,`dy`)
 // intersects. The direction need not be normalized; the ray is treated as extending forward only.
-export function querySpatialRay(index, x, y, dx, dy, out) {
+export function querySpatialRay2D(index, x, y, dx, dy, out) {
     index.runtime.backend.querySpatialRay(x, y, dx, dy, out);
 }
 // Fills `out` (cleared first) with the ids whose bounds overlap `region`.
-export function querySpatialRegion(index, region, out) {
+export function querySpatialRegion2D(index, region, out) {
     index.runtime.backend.querySpatialRegion(region, out);
 }
 // Removes an object from the index. A no-op if the id is not present.
-export function removeSpatialObject(index, id) {
+export function removeSpatialObject2D(index, id) {
     index.runtime.backend.removeSpatialObject(id);
 }
 // Moves an already-inserted object to new bounds. Inserting a not-yet-present id behaves as insert.
-// Returns the same sentinel as insertSpatialObject. A declined update removes the object rather than
+// Returns the same sentinel as insertSpatialObject2D. A declined update removes the object rather than
 // leaving it at its old bounds, so a caller that ignores the sentinel can never read a stale position
 // as a current one.
-export function updateSpatialObject(index, id, bounds) {
+export function updateSpatialObject2D(index, id, bounds) {
     return index.runtime.backend.updateSpatialObject(id, bounds);
 }
-// The default uniform-grid cell size when createSpatialIndex is called without an explicit backend —
+// The default uniform-grid cell size when createSpatialIndex2D is called without an explicit backend —
 // a middle-of-the-road choice; a workload with a known typical object size should pass its own grid.
 const DEFAULT_SPATIAL_CELL_SIZE = 128;
 //# sourceMappingURL=spatialIndex.js.map

package/dist/spatialIndex.js.map

@@ -1 +1 @@
-{"version":3,"file":"spatialIndex.js","sourceRoot":"","sources":["../src/spatialIndex.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAC;AAEhE,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;AAC5C,CAAC;AAED,yFAAyF;AACzF,kGAAkG;AAClG,mGAAmG;AACnG,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,OAAO;QACL,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,IAAI,+BAA+B,CAAC,yBAAyB,CAAC;SAC/E;KACF,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,4FAA4F;AAC5F,iGAAiG;AACjG,kGAAkG;AAClG,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CACjC,KAA6B,EAC7B,EAAmB,EACnB,MAA6B;IAE7B,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,mGAAmG;AACnG,iGAAiG;AACjG,8FAA8F;AAC9F,MAAM,UAAU,iBAAiB,CAAC,KAA6B,EAAE,GAAkB;IACjF,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,KAA6B,EAAE,CAAS,EAAE,CAAS,EAAE,GAAsB;IAC3G,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,iGAAiG;AACjG,kGAAkG;AAClG,MAAM,UAAU,eAAe,CAC7B,KAA6B,EAC7B,CAAS,EACT,CAAS,EACT,EAAU,EACV,EAAU,EACV,GAAsB;IAEtB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAChC,KAA6B,EAC7B,MAA6B,EAC7B,GAAsB;IAEtB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,KAA6B,EAAE,EAAmB;IACpF,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,oGAAoG;AACpG,qGAAqG;AACrG,sGAAsG;AACtG,oBAAoB;AACpB,MAAM,UAAU,mBAAmB,CACjC,KAA6B,EAC7B,EAAmB,EACnB,MAA6B;IAE7B,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,qGAAqG;AACrG,qGAAqG;AACrG,MAAM,yBAAyB,GAAG,GAAG,CAAC"}
+{"version":3,"file":"spatialIndex.js","sourceRoot":"","sources":["../src/spatialIndex.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AAElE,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IACjE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;AAC5C,CAAC;AAED,yFAAyF;AACzF,kGAAkG;AAClG,mGAAmG;AACnG,4DAA4D;AAC5D,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,OAAO;QACL,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,IAAI,iCAAiC,CAAC,yBAAyB,CAAC;SACjF;KACF,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,4FAA4F;AAC5F,iGAAiG;AACjG,kGAAkG;AAClG,6EAA6E;AAC7E,MAAM,UAAU,qBAAqB,CACnC,KAA+B,EAC/B,EAAmB,EACnB,MAA+B;IAE/B,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,mGAAmG;AACnG,iGAAiG;AACjG,8FAA8F;AAC9F,MAAM,UAAU,mBAAmB,CAAC,KAA+B,EAAE,GAAkB;IACrF,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CACjC,KAA+B,EAC/B,CAAS,EACT,CAAS,EACT,GAAsB;IAEtB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,iGAAiG;AACjG,kGAAkG;AAClG,MAAM,UAAU,iBAAiB,CAC/B,KAA+B,EAC/B,CAAS,EACT,CAAS,EACT,EAAU,EACV,EAAU,EACV,GAAsB;IAEtB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB,CAClC,KAA+B,EAC/B,MAA+B,EAC/B,GAAsB;IAEtB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,qBAAqB,CAAC,KAA+B,EAAE,EAAmB;IACxF,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,oGAAoG;AACpG,uGAAuG;AACvG,sGAAsG;AACtG,oBAAoB;AACpB,MAAM,UAAU,qBAAqB,CACnC,KAA+B,EAC/B,EAAmB,EACnB,MAA+B;IAE/B,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,uGAAuG;AACvG,qGAAqG;AACrG,MAAM,yBAAyB,GAAG,GAAG,CAAC"}

package/dist/spatialIndex3D.d.ts

@@ -0,0 +1,13 @@
+import type { SpatialAabb3D, SpatialFrustum3D, SpatialIndex3D, SpatialIndexBackend3D, SpatialObjectId, SpatialPair } from '@flighthq/types/contract';
+export declare function clearSpatialIndex3D(index: Readonly<SpatialIndex3D>): void;
+export declare function createSpatialIndex3D(backend?: SpatialIndexBackend3D): SpatialIndex3D;
+export declare function insertSpatialObject3D(index: Readonly<SpatialIndex3D>, id: SpatialObjectId, bounds: Readonly<SpatialAabb3D>): boolean;
+export declare function querySpatialFrustum3D(index: Readonly<SpatialIndex3D>, frustum: Readonly<SpatialFrustum3D>, out: SpatialObjectId[], slices?: number): void;
+export declare function querySpatialPairs3D(index: Readonly<SpatialIndex3D>, out: SpatialPair[]): void;
+export declare function querySpatialPoint3D(index: Readonly<SpatialIndex3D>, x: number, y: number, z: number, out: SpatialObjectId[]): void;
+export declare function querySpatialRay3D(index: Readonly<SpatialIndex3D>, x: number, y: number, z: number, dx: number, dy: number, dz: number, out: SpatialObjectId[]): void;
+export declare function querySpatialRegion3D(index: Readonly<SpatialIndex3D>, region: Readonly<SpatialAabb3D>, out: SpatialObjectId[]): void;
+export declare function querySpatialSphere3D(index: Readonly<SpatialIndex3D>, x: number, y: number, z: number, radius: number, out: SpatialObjectId[]): void;
+export declare function removeSpatialObject3D(index: Readonly<SpatialIndex3D>, id: SpatialObjectId): void;
+export declare function updateSpatialObject3D(index: Readonly<SpatialIndex3D>, id: SpatialObjectId, bounds: Readonly<SpatialAabb3D>): boolean;
+//# sourceMappingURL=spatialIndex3D.d.ts.map

package/dist/spatialIndex3D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatialIndex3D.d.ts","sourceRoot":"","sources":["../src/spatialIndex3D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAKlC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,IAAI,CAEzE;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAMpF;AAOD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC9B,OAAO,CAET;AAmBD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EACnC,GAAG,EAAE,eAAe,EAAE,EACtB,MAAM,SAAyB,GAC9B,IAAI,CAqDN;AAKD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,CAE7F;AAGD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,eAAe,EAAE,GACrB,IAAI,CAEN;AAKD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,eAAe,EAAE,GACrB,IAAI,CAEN;AAGD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,GAAG,EAAE,eAAe,EAAE,GACrB,IAAI,CAEN;AASD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,eAAe,EAAE,GACrB,IAAI,CAUN;AAGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,eAAe,GAAG,IAAI,CAEhG;AAMD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC9B,OAAO,CAET"}

package/dist/spatialIndex3D.js

@@ -0,0 +1,166 @@
+import { createUniformGridSpatialBackend3D } from './uniformGrid3D';
+// Empties the index of all objects while keeping it (and its backend) reusable.
+export function clearSpatialIndex3D(index) {
+    index.runtime.backend.clearSpatialIndex();
+}
+// Creates a 3D broadphase index. With no backend it defaults to a uniform grid sized for
+// medium-scale scenes; pass an explicit backend (a differently-sized grid, or a future octree / BVH)
+// to select the structure for the workload. Constructing the default grid happens here, on call —
+// importing the package has no side effect.
+export function createSpatialIndex3D(backend) {
+    return {
+        runtime: {
+            backend: backend ?? createUniformGridSpatialBackend3D(DEFAULT_SPATIAL_CELL_SIZE_3D),
+        },
+    };
+}
+// Adds an object to the index under `id` with its current bounds. The bounds are copied; the caller
+// may reuse its own value afterward. Returns false when the bounds cannot be indexed at all
+// (non-finite or inverted) — the object is then absent from every query rather than present at a
+// nonsense position. Oversized-but-valid bounds return true and stay fully queryable; the backend
+// decides how to hold them. explainSpatialIndexing3D reports which happened.
+export function insertSpatialObject3D(index, id, bounds) {
+    return index.runtime.backend.insertSpatialObject(id, bounds);
+}
+// Fills `out` (cleared first) with the ids whose bounds may lie inside the view volume — the candidate
+// set for view culling.
+//
+// Built on the region query rather than on a new backend method, so every present and future backend
+// answers it without implementing anything, and the ratified eight-method seam does not widen for a
+// query that needs no structural knowledge.
+//
+// The volume is covered by `slices` axis-aligned boxes taken along its DEPTH rather than by one box
+// around the whole thing. A single AABB is correct but nearly useless for culling: a long perspective
+// frustum's bounding box approaches the whole world, so the query would hand back almost every object
+// and cull nothing. Slicing costs one region query per slice and shrinks the covered volume toward the
+// frustum itself — eight slices is a good default, and more is a straight trade of query time against
+// candidates the caller would otherwise reject.
+//
+// The result is a CANDIDATE set, in the same sense as `querySpatialPairs3D`: every id whose bounds the
+// covering boxes touch, which is a superset of what is truly visible. The caller applies the exact
+// plane test to what comes back.
+export function querySpatialFrustum3D(index, frustum, out, slices = DEFAULT_FRUSTUM_SLICES) {
+    out.length = 0;
+    const corners = frustum.corners;
+    if (corners.length < 24 || !(slices >= 1))
+        return;
+    const steps = Math.floor(slices);
+    frustumSeen.clear();
+    for (let slice = 0; slice < steps; slice += 1) {
+        const nearT = slice / steps;
+        const farT = (slice + 1) / steps;
+        let minX = Infinity;
+        let minY = Infinity;
+        let minZ = Infinity;
+        let maxX = -Infinity;
+        let maxY = -Infinity;
+        let maxZ = -Infinity;
+        // Both ends of the slice, for all four edges: the volume between two depths is bounded by the eight
+        // points at those depths. Taking only the far end would clip the slice's own near face away.
+        for (let corner = 0; corner < 4; corner += 1) {
+            const near = corner * 3;
+            const far = 12 + corner * 3;
+            for (const t of [nearT, farT]) {
+                const x = corners[near] + (corners[far] - corners[near]) * t;
+                const y = corners[near + 1] + (corners[far + 1] - corners[near + 1]) * t;
+                const z = corners[near + 2] + (corners[far + 2] - corners[near + 2]) * t;
+                if (x < minX)
+                    minX = x;
+                if (x > maxX)
+                    maxX = x;
+                if (y < minY)
+                    minY = y;
+                if (y > maxY)
+                    maxY = y;
+                if (z < minZ)
+                    minZ = z;
+                if (z > maxZ)
+                    maxZ = z;
+            }
+        }
+        if (!Number.isFinite(minX) || !Number.isFinite(maxZ))
+            return;
+        queryRegionScratch.minX = minX;
+        queryRegionScratch.minY = minY;
+        queryRegionScratch.minZ = minZ;
+        queryRegionScratch.maxX = maxX;
+        queryRegionScratch.maxY = maxY;
+        queryRegionScratch.maxZ = maxZ;
+        index.runtime.backend.querySpatialRegion(queryRegionScratch, frustumSlice);
+        // Slices share objects that straddle their boundary, so the union has to be deduplicated — without
+        // this the same id appears once per slice it touches, and a caller counting results would over-count
+        // a large object exactly in proportion to how large it is.
+        for (const id of frustumSlice) {
+            if (frustumSeen.has(id))
+                continue;
+            frustumSeen.add(id);
+            out.push(id);
+        }
+    }
+}
+// Fills `out` (cleared first) with every deduplicated candidate pair — each unordered pair at most
+// once, never an object with itself. A pair is a broadphase candidate: the two objects are close
+// enough to be worth a narrow-phase test, which the caller (or @flighthq/collision) performs.
+export function querySpatialPairs3D(index, out) {
+    index.runtime.backend.querySpatialPairs(out);
+}
+// Fills `out` (cleared first) with the ids whose bounds contain the point (`x`,`y`,`z`).
+export function querySpatialPoint3D(index, x, y, z, out) {
+    index.runtime.backend.querySpatialPoint(x, y, z, out);
+}
+// Fills `out` (cleared first) with the ids whose bounds the ray from (`x`,`y`,`z`) along
+// (`dx`,`dy`,`dz`) intersects. The direction need not be normalized; the ray is treated as extending
+// forward only.
+export function querySpatialRay3D(index, x, y, z, dx, dy, dz, out) {
+    index.runtime.backend.querySpatialRay(x, y, z, dx, dy, dz, out);
+}
+// Fills `out` (cleared first) with the ids whose bounds overlap `region`.
+export function querySpatialRegion3D(index, region, out) {
+    index.runtime.backend.querySpatialRegion(region, out);
+}
+// Fills `out` (cleared first) with the ids whose bounds may lie within `radius` of (`x`,`y`,`z`).
+//
+// A CANDIDATE set over the sphere's bounding cube, not an exact sphere test — the index stores bounds
+// and answers box questions, and the corners of that cube reach past the sphere by a factor of the
+// square root of three. That is the same contract every other query here keeps, and the caller that
+// needs exactness applies the distance test to what comes back. The value of the export is that the
+// cube is derived once, correctly, instead of at every callsite.
+export function querySpatialSphere3D(index, x, y, z, radius, out) {
+    out.length = 0;
+    if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z) || !(radius >= 0))
+        return;
+    queryRegionScratch.minX = x - radius;
+    queryRegionScratch.minY = y - radius;
+    queryRegionScratch.minZ = z - radius;
+    queryRegionScratch.maxX = x + radius;
+    queryRegionScratch.maxY = y + radius;
+    queryRegionScratch.maxZ = z + radius;
+    index.runtime.backend.querySpatialRegion(queryRegionScratch, out);
+}
+// Removes an object from the index. A no-op if the id is not present.
+export function removeSpatialObject3D(index, id) {
+    index.runtime.backend.removeSpatialObject(id);
+}
+// Moves an already-inserted object to new bounds. Inserting a not-yet-present id behaves as insert.
+// Returns the same sentinel as insertSpatialObject3D. A declined update removes the object rather than
+// leaving it at its old bounds, so a caller that ignores the sentinel can never read a stale position
+// as a current one.
+export function updateSpatialObject3D(index, id, bounds) {
+    return index.runtime.backend.updateSpatialObject(id, bounds);
+}
+// The default uniform-grid cell size when createSpatialIndex3D is called without an explicit backend.
+// Deliberately the same middle-of-the-road number as the 2D default: a cell is a world-space length,
+// not a volume, so "roughly the size of a typical object" means the same thing in both dimensions. A
+// workload with a known typical object size should pass its own grid — and in 3D it pays off sooner,
+// since the per-object cell budget is a ~10-cell cube rather than a 32-cell square.
+const DEFAULT_SPATIAL_CELL_SIZE_3D = 128;
+// How many depth slices cover a frustum when the caller does not choose. Eight brings a typical
+// perspective volume's covered bounds close to the volume itself while keeping the query to eight
+// region calls; one slice degenerates to the single-AABB behaviour that makes frustum culling pointless.
+const DEFAULT_FRUSTUM_SLICES = 8;
+// Reused across calls: a culling pass runs every frame, and these would otherwise be three allocations
+// per frame in the hot path. Never held beyond the call that fills them.
+const queryRegionScratch = { maxX: 0, maxY: 0, maxZ: 0, minX: 0, minY: 0, minZ: 0 };
+const frustumSeen = new Set();
+const frustumSlice = [];
+//# sourceMappingURL=spatialIndex3D.js.map

package/dist/spatialIndex3D.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatialIndex3D.js","sourceRoot":"","sources":["../src/spatialIndex3D.ts"],"names":[],"mappings":"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"}

package/dist/spatialIndexingGuard.d.ts

@@ -0,0 +1,4 @@
+import type { SpatialIndexingGuard, SpatialIndexingNotice } from '@flighthq/types/contract';
+export declare function reportSpatialIndexing(notice: Readonly<SpatialIndexingNotice>): void;
+export declare function setSpatialIndexingGuard(guard: SpatialIndexingGuard | null): void;
+//# sourceMappingURL=spatialIndexingGuard.d.ts.map

package/dist/spatialIndexingGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatialIndexingGuard.d.ts","sourceRoot":"","sources":["../src/spatialIndexingGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAU5F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAGnF;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAEhF"}

package/dist/spatialIndexingGuard.js

@@ -0,0 +1,23 @@
+// Hands a notice to the installed guard, or does nothing when none is installed. The null check is
+// all production pays at a noteworthy site; the caller-facing text lives in the separately-importable
+// formatSpatialIndexingNotice, per the diagnostics inversion rule.
+//
+// Shared by both dimensions' grids on purpose. The guard is a development diagnostic keyed to the
+// question "why is this object not in my query results?", which is dimension-free — the notice's own
+// vocabulary (mode, operation, reason, bucketCount) carries no axis. Giving 2D and 3D separate guards
+// would mean an application debugging an index had to install two.
+export function reportSpatialIndexing(notice) {
+    if (_indexingGuard === null)
+        return;
+    _indexingGuard(notice);
+}
+// Installs the indexing guard consulted for invalid configuration or bounds, missing-id operations,
+// and overflow routing; null uninstalls it. Module-scoped rather than per-grid: it is a development
+// diagnostic, and an application debugging an index wants it on for every grid at once — in either
+// dimension.
+export function setSpatialIndexingGuard(guard) {
+    _indexingGuard = guard;
+}
+// Diagnostics seam filled by setSpatialIndexingGuard.
+let _indexingGuard = null;
+//# sourceMappingURL=spatialIndexingGuard.js.map

package/dist/spatialIndexingGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatialIndexingGuard.js","sourceRoot":"","sources":["../src/spatialIndexingGuard.ts"],"names":[],"mappings":"AAEA,mGAAmG;AACnG,sGAAsG;AACtG,mEAAmE;AACnE,EAAE;AACF,kGAAkG;AAClG,qGAAqG;AACrG,sGAAsG;AACtG,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CAAC,MAAuC;IAC3E,IAAI,cAAc,KAAK,IAAI;QAAE,OAAO;IACpC,cAAc,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,oGAAoG;AACpG,oGAAoG;AACpG,mGAAmG;AACnG,aAAa;AACb,MAAM,UAAU,uBAAuB,CAAC,KAAkC;IACxE,cAAc,GAAG,KAAK,CAAC;AACzB,CAAC;AAED,sDAAsD;AACtD,IAAI,cAAc,GAAgC,IAAI,CAAC"}

package/dist/uniformGrid.d.ts

@@ -1,5 +1,4 @@
-import type { SpatialIndexBackend, SpatialIndexingGuard } from '@flighthq/types/contract';
+import type { SpatialIndexBackend2D } from '@flighthq/types/contract';
 export declare const MAX_INDEXED_CELLS_PER_OBJECT = 1024;
-export declare function createUniformGridSpatialBackend(cellSize: number): SpatialIndexBackend;
-export declare function setSpatialIndexingGuard(guard: SpatialIndexingGuard | null): void;
+export declare function createUniformGridSpatialBackend2D(cellSize: number): SpatialIndexBackend2D;
 //# sourceMappingURL=uniformGrid.d.ts.map

package/dist/uniformGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uniformGrid.d.ts","sourceRoot":"","sources":["../src/uniformGrid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EAGnB,oBAAoB,EAMrB,MAAM,0BAA0B,CAAC;AAiBlC,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAejD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAkDrF;AAKD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAEhF"}
+{"version":3,"file":"uniformGrid.d.ts","sourceRoot":"","sources":["../src/uniformGrid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EAQtB,MAAM,0BAA0B,CAAC;AAmBlC,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAejD,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAkDzF"}

package/dist/uniformGrid.js

@@ -1,3 +1,4 @@
+import { reportSpatialIndexing } from './spatialIndexingGuard';
 // The per-object cell budget. An object whose AABB covers more cells than this is held in the flat
 // overflow list instead of being written into every cell it spans.
 //
@@ -21,13 +22,13 @@ export const MAX_INDEXED_CELLS_PER_OBJECT = 1024;
 // good value is a positive finite number roughly the size of a typical object (too small over-spans
 // large objects across many cells, too large lumps unrelated objects together). An invalid size uses
 // the bounded overflow path to keep results correct and reports through the indexing guard. No
-// import-time side effect — the caller constructs a grid explicitly, and createSpatialIndex uses
+// import-time side effect — the caller constructs a grid explicitly, and createSpatialIndex2D uses
 // this as its default index.
 //
 // Object size does not set the cost: an AABB spanning more than MAX_INDEXED_CELLS_PER_OBJECT cells
 // goes to a flat overflow list that every query scans, and non-finite or inverted bounds are declined
-// outright with a false sentinel. Both are visible through explainSpatialIndexing.
-export function createUniformGridSpatialBackend(cellSize) {
+// outright with a false sentinel. Both are visible through explainSpatialIndexing2D.
+export function createUniformGridSpatialBackend2D(cellSize) {
     const grid = {
         cellSize,
         cells: new Map(),
@@ -79,12 +80,6 @@ export function createUniformGridSpatialBackend(cellSize) {
         },
     };
 }
-// Installs the indexing guard consulted for invalid configuration or bounds, missing-id operations,
-// and overflow routing; null uninstalls it. Module-scoped rather than per-grid: it is a development
-// diagnostic, and an application debugging an index wants it on for every grid at once.
-export function setSpatialIndexingGuard(guard) {
-    _indexingGuard = guard;
-}
 // Maps a world coordinate to its cell index along one axis. Uses floor so negative coordinates map
 // to consistently decreasing cell indices (world 0 is the boundary between cell -1 and cell 0).
 function _cellIndex(coord, cellSize) {
@@ -387,9 +382,7 @@ function _queryGridPairs(grid, out) {
         _queryGridOverflowPairs(grid, out);
 }
 function _reportGridIndexing(grid, id, mode, operation, reason, wouldOccupyBucketCount) {
-    if (_indexingGuard === null)
-        return;
-    _indexingGuard({ cellSize: grid.cellSize, id, mode, operation, reason, wouldOccupyBucketCount });
+    reportSpatialIndexing({ cellSize: grid.cellSize, id, mode, operation, reason, wouldOccupyBucketCount });
 }
 // Gathers the ids in the cell containing the point, then confirms each against its real bounds. A
 // single cell holds each id at most once, so no dedup pass is needed. Overflowed objects hold no cell
@@ -560,7 +553,4 @@ function _spannedCellCount(cellSize, aabb) {
     const cy1 = _cellIndex(aabb.maxY, cellSize);
     return (cx1 - cx0 + 1) * (cy1 - cy0 + 1);
 }
-// Diagnostics seam filled by setSpatialIndexingGuard. Caller-facing text stays in the separate
-// formatSpatialIndexingNotice module, so production pays only the null checks at noteworthy sites.
-let _indexingGuard = null;
 //# sourceMappingURL=uniformGrid.js.map