@flighthq/spatial 0.3.0-next.1032.e2b99fc → 0.3.0-next.1162.e90e518
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/contract.d.ts +2 -0
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +2 -0
- package/dist/contract.js.map +1 -1
- package/dist/explainSpatialIndexing.d.ts +3 -0
- package/dist/explainSpatialIndexing.d.ts.map +1 -0
- package/dist/explainSpatialIndexing.js +13 -0
- package/dist/explainSpatialIndexing.js.map +1 -0
- package/dist/formatSpatialIndexingNotice.d.ts +3 -0
- package/dist/formatSpatialIndexingNotice.d.ts.map +1 -0
- package/dist/formatSpatialIndexingNotice.js +23 -0
- package/dist/formatSpatialIndexingNotice.js.map +1 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/spatialIndex.d.ts +2 -2
- package/dist/spatialIndex.d.ts.map +1 -1
- package/dist/spatialIndex.js +9 -3
- package/dist/spatialIndex.js.map +1 -1
- package/dist/uniformGrid.d.ts +3 -1
- package/dist/uniformGrid.d.ts.map +1 -1
- package/dist/uniformGrid.js +182 -17
- package/dist/uniformGrid.js.map +1 -1
- package/package.json +3 -3
- package/src/explainSpatialIndexing.test.ts +76 -0
- package/src/formatSpatialIndexingNotice.test.ts +58 -0
- package/src/uniformGrid.test.ts +279 -3
package/dist/contract.d.ts
CHANGED
package/dist/contract.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
|
|
1
|
+
{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
|
package/dist/contract.js
CHANGED
package/dist/contract.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
|
|
1
|
+
{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { SpatialIndex, SpatialIndexingExplanation, SpatialObjectId } from '@flighthq/types/contract';
|
|
2
|
+
export declare function explainSpatialIndexing(index: Readonly<SpatialIndex>, id: SpatialObjectId): SpatialIndexingExplanation;
|
|
3
|
+
//# sourceMappingURL=explainSpatialIndexing.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"explainSpatialIndexing.d.ts","sourceRoot":"","sources":["../src/explainSpatialIndexing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAW1G,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,eAAe,GAAG,0BAA0B,CAErH"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
// Reports how the index is currently holding `id`, as plain data. Pure: reads only, indexes nothing,
|
|
2
|
+
// never throws on an unknown id, and retains no reference to the backend. Import it to answer "why is
|
|
3
|
+
// this object not in my query results?" — `absent` means it was never inserted or was removed,
|
|
4
|
+
// `declined` means its bounds were non-finite and it is deliberately not held, `overflow` means it is
|
|
5
|
+
// held but too large to bucket, and `cells` reports the bucket count the per-object bound caps.
|
|
6
|
+
//
|
|
7
|
+
// This is the pull half of the diagnostics convention, and the measurement seam a regression test
|
|
8
|
+
// asserts the cost bound against: `bucketCount` is the number that goes unbounded when the bound is
|
|
9
|
+
// removed, so a test can pin it without timing anything.
|
|
10
|
+
export function explainSpatialIndexing(index, id) {
|
|
11
|
+
return index.runtime.backend.explainSpatialIndexing(id);
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=explainSpatialIndexing.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"explainSpatialIndexing.js","sourceRoot":"","sources":["../src/explainSpatialIndexing.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,sGAAsG;AACtG,+FAA+F;AAC/F,sGAAsG;AACtG,gGAAgG;AAChG,EAAE;AACF,kGAAkG;AAClG,oGAAoG;AACpG,yDAAyD;AACzD,MAAM,UAAU,sBAAsB,CAAC,KAA6B,EAAE,EAAmB;IACvF,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"formatSpatialIndexingNotice.d.ts","sourceRoot":"","sources":["../src/formatSpatialIndexingNotice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AActE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAU3F"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { MAX_INDEXED_CELLS_PER_OBJECT } from './uniformGrid';
|
|
2
|
+
// Renders an indexing notice as a caller-facing sentence, and is the only place in this package that
|
|
3
|
+
// holds one. Import it to turn the structured record a SpatialIndexingGuard receives into something a
|
|
4
|
+
// developer reads; leave it unimported and neither the text nor its cost reaches a bundle.
|
|
5
|
+
//
|
|
6
|
+
// The text lives here rather than inside an `enableSpatialGuards` that logs for you because
|
|
7
|
+
// `@flighthq/spatial` is a core-layer package and may not depend on `@flighthq/log` — the same shape
|
|
8
|
+
// `@flighthq/importdiagnostics` uses, where core carries the record and a separate module carries the
|
|
9
|
+
// words. Wiring the two together is three lines at the application layer, which can reach both:
|
|
10
|
+
//
|
|
11
|
+
// setSpatialIndexingGuard((notice) => logWarn({ message: formatSpatialIndexingNotice(notice) }, 'spatial'));
|
|
12
|
+
export function formatSpatialIndexingNotice(notice) {
|
|
13
|
+
if (notice.mode === 'declined') {
|
|
14
|
+
return `insertSpatialObject(${notice.id}): the bounds are not finite, so the object was not indexed and no query will return it. Insert returns false for this — check the sentinel, and check what produced NaN/Infinity bounds upstream.`;
|
|
15
|
+
}
|
|
16
|
+
if (notice.mode === 'overflow') {
|
|
17
|
+
return `insertSpatialObject(${notice.id}): the bounds span ${notice.wouldOccupyBucketCount} cells, over the ${MAX_INDEXED_CELLS_PER_OBJECT} per-object budget, so the object is held in the flat overflow list instead of the grid. Results are unaffected. If this is not a one-off outlier, the grid's cellSize is too small for the objects being indexed — size it to a typical object.`;
|
|
18
|
+
}
|
|
19
|
+
// `cells` and `absent` are ordinary outcomes no guard reports, so reaching here means a backend
|
|
20
|
+
// notified about something this text does not cover. Say exactly that rather than inventing advice.
|
|
21
|
+
return `insertSpatialObject(${notice.id}): indexed as '${notice.mode}', which carries no caller-facing advice.`;
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=formatSpatialIndexingNotice.js.map
|
|
@@ -0,0 +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,4FAA4F;AAC5F,qGAAqG;AACrG,sGAAsG;AACtG,gGAAgG;AAChG,EAAE;AACF,+GAA+G;AAC/G,MAAM,UAAU,2BAA2B,CAAC,MAAuC;IACjF,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,uBAAuB,MAAM,CAAC,EAAE,oMAAoM,CAAC;IAC9O,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,uBAAuB,MAAM,CAAC,EAAE,sBAAsB,MAAM,CAAC,sBAAsB,oBAAoB,4BAA4B,kPAAkP,CAAC;IAC/X,CAAC;IACD,gGAAgG;IAChG,oGAAoG;IACpG,OAAO,uBAAuB,MAAM,CAAC,EAAE,kBAAkB,MAAM,CAAC,IAAI,2CAA2C,CAAC;AAClH,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { clearSpatialIndex, createSpatialIndex, createUniformGridSpatialBackend, insertSpatialObject, querySpatialPairs, querySpatialPoint, querySpatialRay, querySpatialRegion, removeSpatialObject, updateSpatialObject, } from './contract';
|
|
1
|
+
export { MAX_INDEXED_CELLS_PER_OBJECT, clearSpatialIndex, createSpatialIndex, createUniformGridSpatialBackend, explainSpatialIndexing, formatSpatialIndexingNotice, insertSpatialObject, querySpatialPairs, querySpatialPoint, querySpatialRay, querySpatialRegion, removeSpatialObject, setSpatialIndexingGuard, updateSpatialObject, } from './contract';
|
|
2
2
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,+BAA+B,EAC/B,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
|
|
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"}
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { clearSpatialIndex, createSpatialIndex, createUniformGridSpatialBackend, insertSpatialObject, querySpatialPairs, querySpatialPoint, querySpatialRay, querySpatialRegion, removeSpatialObject, updateSpatialObject, } from './contract';
|
|
1
|
+
export { MAX_INDEXED_CELLS_PER_OBJECT, clearSpatialIndex, createSpatialIndex, createUniformGridSpatialBackend, explainSpatialIndexing, formatSpatialIndexingNotice, insertSpatialObject, querySpatialPairs, querySpatialPoint, querySpatialRay, querySpatialRegion, removeSpatialObject, setSpatialIndexingGuard, updateSpatialObject, } from './contract';
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,+BAA+B,EAC/B,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
|
|
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"}
|
package/dist/spatialIndex.d.ts
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import type { SpatialAabb, SpatialIndex, SpatialIndexBackend, SpatialObjectId, SpatialPair } from '@flighthq/types/contract';
|
|
2
2
|
export declare function clearSpatialIndex(index: Readonly<SpatialIndex>): void;
|
|
3
3
|
export declare function createSpatialIndex(backend?: SpatialIndexBackend): SpatialIndex;
|
|
4
|
-
export declare function insertSpatialObject(index: Readonly<SpatialIndex>, id: SpatialObjectId, bounds: Readonly<SpatialAabb>):
|
|
4
|
+
export declare function insertSpatialObject(index: Readonly<SpatialIndex>, id: SpatialObjectId, bounds: Readonly<SpatialAabb>): boolean;
|
|
5
5
|
export declare function querySpatialPairs(index: Readonly<SpatialIndex>, out: SpatialPair[]): void;
|
|
6
6
|
export declare function querySpatialPoint(index: Readonly<SpatialIndex>, x: number, y: number, out: SpatialObjectId[]): void;
|
|
7
7
|
export declare function querySpatialRay(index: Readonly<SpatialIndex>, x: number, y: number, dx: number, dy: number, out: SpatialObjectId[]): void;
|
|
8
8
|
export declare function querySpatialRegion(index: Readonly<SpatialIndex>, region: Readonly<SpatialAabb>, out: SpatialObjectId[]): void;
|
|
9
9
|
export declare function removeSpatialObject(index: Readonly<SpatialIndex>, id: SpatialObjectId): void;
|
|
10
|
-
export declare function updateSpatialObject(index: Readonly<SpatialIndex>, id: SpatialObjectId, bounds: Readonly<SpatialAabb>):
|
|
10
|
+
export declare function updateSpatialObject(index: Readonly<SpatialIndex>, id: SpatialObjectId, bounds: Readonly<SpatialAabb>): boolean;
|
|
11
11
|
//# sourceMappingURL=spatialIndex.d.ts.map
|
|
@@ -1 +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;
|
|
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"}
|
package/dist/spatialIndex.js
CHANGED
|
@@ -15,9 +15,12 @@ export function createSpatialIndex(backend) {
|
|
|
15
15
|
};
|
|
16
16
|
}
|
|
17
17
|
// Adds an object to the index under `id` with its current bounds. The bounds are copied; the caller
|
|
18
|
-
// may reuse its own value afterward.
|
|
18
|
+
// may reuse its own value afterward. Returns false when the bounds cannot be indexed at all
|
|
19
|
+
// (non-finite) — the object is then absent from every query rather than present at a nonsense
|
|
20
|
+
// position. Oversized-but-finite bounds return true and stay fully queryable; the backend decides how
|
|
21
|
+
// to hold them. explainSpatialIndexing reports which happened.
|
|
19
22
|
export function insertSpatialObject(index, id, bounds) {
|
|
20
|
-
index.runtime.backend.insertSpatialObject(id, bounds);
|
|
23
|
+
return index.runtime.backend.insertSpatialObject(id, bounds);
|
|
21
24
|
}
|
|
22
25
|
// Fills `out` (cleared first) with every deduplicated candidate pair — each unordered pair at most
|
|
23
26
|
// once, never an object with itself. A pair is a broadphase candidate: the two objects are close
|
|
@@ -43,8 +46,11 @@ export function removeSpatialObject(index, id) {
|
|
|
43
46
|
index.runtime.backend.removeSpatialObject(id);
|
|
44
47
|
}
|
|
45
48
|
// Moves an already-inserted object to new bounds. Inserting a not-yet-present id behaves as insert.
|
|
49
|
+
// Returns the same sentinel as insertSpatialObject. A declined update removes the object rather than
|
|
50
|
+
// leaving it at its old bounds, so a caller that ignores the sentinel can never read a stale position
|
|
51
|
+
// as a current one.
|
|
46
52
|
export function updateSpatialObject(index, id, bounds) {
|
|
47
|
-
index.runtime.backend.updateSpatialObject(id, bounds);
|
|
53
|
+
return index.runtime.backend.updateSpatialObject(id, bounds);
|
|
48
54
|
}
|
|
49
55
|
// The default uniform-grid cell size when createSpatialIndex is called without an explicit backend —
|
|
50
56
|
// a middle-of-the-road choice; a workload with a known typical object size should pass its own grid.
|
package/dist/spatialIndex.js.map
CHANGED
|
@@ -1 +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,
|
|
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,8FAA8F;AAC9F,sGAAsG;AACtG,+DAA+D;AAC/D,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"}
|
package/dist/uniformGrid.d.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
-
import type { SpatialIndexBackend } from '@flighthq/types/contract';
|
|
1
|
+
import type { SpatialIndexBackend, SpatialIndexingGuard } from '@flighthq/types/contract';
|
|
2
|
+
export declare const MAX_INDEXED_CELLS_PER_OBJECT = 1024;
|
|
2
3
|
export declare function createUniformGridSpatialBackend(cellSize: number): SpatialIndexBackend;
|
|
4
|
+
export declare function setSpatialIndexingGuard(guard: SpatialIndexingGuard | null): void;
|
|
3
5
|
//# sourceMappingURL=uniformGrid.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"uniformGrid.d.ts","sourceRoot":"","sources":["../src/uniformGrid.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,mBAAmB,
|
|
1
|
+
{"version":3,"file":"uniformGrid.d.ts","sourceRoot":"","sources":["../src/uniformGrid.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,mBAAmB,EAEnB,oBAAoB,EAGrB,MAAM,0BAA0B,CAAC;AAiBlC,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAajD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAiDrF;AAOD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAEhF"}
|
package/dist/uniformGrid.js
CHANGED
|
@@ -1,4 +1,20 @@
|
|
|
1
1
|
import { containsRectanglePointXY, intersectsRectangle } from '@flighthq/geometry/contract';
|
|
2
|
+
// The per-object cell budget. An object whose AABB covers more cells than this is held in the flat
|
|
3
|
+
// overflow list instead of being written into every cell it spans.
|
|
4
|
+
//
|
|
5
|
+
// This bound is what makes insert cost independent of object size. Without it the cell walk is
|
|
6
|
+
// proportional to extent ÷ cellSize *squared*, so cost is set by the largest object rather than by
|
|
7
|
+
// the object count: measured on this grid at one cell per unit, a 200-unit box costs 40k cell writes
|
|
8
|
+
// (~28 ms) and a 2000-unit box costs 4M (~4.7 s), while an AABB a trillion units wide — reachable
|
|
9
|
+
// from any diverging simulation — never returns at all. A hang is worse than a throw because it is
|
|
10
|
+
// uncatchable and takes the caller with it.
|
|
11
|
+
//
|
|
12
|
+
// Overflow is not a degraded result: an object that spans a thousand cells is a co-occupant of nearly
|
|
13
|
+
// everything, so the cell index tells the queries almost nothing and a linear scan answers the same
|
|
14
|
+
// question at a bounded cost. 1024 cells is a 32×32 block — an object 32× the cell size on each axis,
|
|
15
|
+
// far past the "cell size ≈ typical object size" the grid is built around. An object over the budget
|
|
16
|
+
// is a signal the cell size is wrong for the workload, which is what enableSpatialGuards reports.
|
|
17
|
+
export const MAX_INDEXED_CELLS_PER_OBJECT = 1024;
|
|
2
18
|
// Builds a uniform-grid (spatial-hash) backend: an object's AABB is mapped to the rectangular block
|
|
3
19
|
// of fixed-size cells it covers, and each cell holds the ids overlapping it. Co-located objects share
|
|
4
20
|
// a cell, so candidate pairs and region/point/ray hits are found by looking only at the relevant
|
|
@@ -6,11 +22,17 @@ import { containsRectanglePointXY, intersectsRectangle } from '@flighthq/geometr
|
|
|
6
22
|
// good value is roughly the size of a typical object (too small over-spans large objects across many
|
|
7
23
|
// cells, too large lumps unrelated objects together). No import-time side effect — the caller
|
|
8
24
|
// constructs a grid explicitly, and createSpatialIndex uses this as its default index.
|
|
25
|
+
//
|
|
26
|
+
// Object size does not set the cost: an AABB spanning more than MAX_INDEXED_CELLS_PER_OBJECT cells
|
|
27
|
+
// goes to a flat overflow list that every query scans, and non-finite bounds are declined outright
|
|
28
|
+
// with a false sentinel. Both are visible through explainSpatialIndexing.
|
|
9
29
|
export function createUniformGridSpatialBackend(cellSize) {
|
|
10
30
|
const grid = {
|
|
11
31
|
cellSize,
|
|
12
32
|
cells: new Map(),
|
|
13
33
|
bounds: new Map(),
|
|
34
|
+
overflow: new Set(),
|
|
35
|
+
declined: new Set(),
|
|
14
36
|
minCellX: 0,
|
|
15
37
|
minCellY: 0,
|
|
16
38
|
maxCellX: 0,
|
|
@@ -20,11 +42,11 @@ export function createUniformGridSpatialBackend(cellSize) {
|
|
|
20
42
|
};
|
|
21
43
|
return {
|
|
22
44
|
insertSpatialObject(id, bounds) {
|
|
23
|
-
_insertIntoGrid(grid, id, bounds);
|
|
45
|
+
return _insertIntoGrid(grid, id, bounds);
|
|
24
46
|
},
|
|
25
47
|
updateSpatialObject(id, bounds) {
|
|
26
48
|
_removeFromGrid(grid, id);
|
|
27
|
-
_insertIntoGrid(grid, id, bounds);
|
|
49
|
+
return _insertIntoGrid(grid, id, bounds);
|
|
28
50
|
},
|
|
29
51
|
removeSpatialObject(id) {
|
|
30
52
|
_removeFromGrid(grid, id);
|
|
@@ -32,9 +54,14 @@ export function createUniformGridSpatialBackend(cellSize) {
|
|
|
32
54
|
clearSpatialIndex() {
|
|
33
55
|
grid.cells.clear();
|
|
34
56
|
grid.bounds.clear();
|
|
57
|
+
grid.overflow.clear();
|
|
58
|
+
grid.declined.clear();
|
|
35
59
|
grid.seen.clear();
|
|
36
60
|
grid.empty = true;
|
|
37
61
|
},
|
|
62
|
+
explainSpatialIndexing(id) {
|
|
63
|
+
return _explainGridIndexing(grid, id);
|
|
64
|
+
},
|
|
38
65
|
querySpatialPairs(out) {
|
|
39
66
|
_queryGridPairs(grid, out);
|
|
40
67
|
},
|
|
@@ -49,6 +76,14 @@ export function createUniformGridSpatialBackend(cellSize) {
|
|
|
49
76
|
},
|
|
50
77
|
};
|
|
51
78
|
}
|
|
79
|
+
// Installs the indexing guard consulted whenever an object is declined or routed to overflow; null
|
|
80
|
+
// uninstalls it. This is the diagnostics seam, not the caller-facing entry point — use
|
|
81
|
+
// enableSpatialGuards, which installs the @flighthq/log reporter through here. Module-scoped rather
|
|
82
|
+
// than per-grid: it is a development diagnostic, and an application debugging a missing object wants
|
|
83
|
+
// it on for every index at once.
|
|
84
|
+
export function setSpatialIndexingGuard(guard) {
|
|
85
|
+
_indexingGuard = guard;
|
|
86
|
+
}
|
|
52
87
|
// Maps a world coordinate to its cell index along one axis. Uses floor so negative coordinates map
|
|
53
88
|
// to consistently decreasing cell indices (world 0 is the boundary between cell -1 and cell 0).
|
|
54
89
|
function _cellIndex(coord, cellSize) {
|
|
@@ -69,15 +104,59 @@ function _fillRectFromAabb(out, aabb) {
|
|
|
69
104
|
out.width = aabb.maxX - aabb.minX;
|
|
70
105
|
out.height = aabb.maxY - aabb.minY;
|
|
71
106
|
}
|
|
72
|
-
//
|
|
73
|
-
|
|
107
|
+
// Reports how `id` is currently held. Pure: reads only, allocates only the returned record.
|
|
108
|
+
function _explainGridIndexing(grid, id) {
|
|
109
|
+
if (grid.declined.has(id))
|
|
110
|
+
return { bucketCount: 0, id, mode: 'declined', reason: 'non-finite-bounds' };
|
|
111
|
+
if (grid.overflow.has(id))
|
|
112
|
+
return { bucketCount: 0, id, mode: 'overflow', reason: null };
|
|
113
|
+
const bounds = grid.bounds.get(id);
|
|
114
|
+
if (bounds === undefined)
|
|
115
|
+
return { bucketCount: 0, id, mode: 'absent', reason: null };
|
|
116
|
+
return { bucketCount: _spannedCellCount(grid.cellSize, bounds), id, mode: 'cells', reason: null };
|
|
117
|
+
}
|
|
118
|
+
// Adds an object to the index, storing a private copy of the bounds; the caller may safely mutate or
|
|
119
|
+
// reuse the passed bounds afterward. Returns false only for bounds that cannot be indexed at all.
|
|
120
|
+
//
|
|
121
|
+
// Three outcomes, and which one applies is decided *before* any cell is touched — that ordering is
|
|
122
|
+
// the whole point, since deciding afterward would mean walking the cells to find out they were too
|
|
123
|
+
// many:
|
|
124
|
+
// - non-finite bounds are declined. There is no cell range to compute, and storing them would let a
|
|
125
|
+
// NaN leak into every later overlap test, so the object is left out of the index entirely and the
|
|
126
|
+
// caller gets a false sentinel rather than an exception or a silent no-op.
|
|
127
|
+
// - bounds spanning more than MAX_INDEXED_CELLS_PER_OBJECT cells go to the overflow list, which
|
|
128
|
+
// every query scans. Bounded by the object count instead of the object's size.
|
|
129
|
+
// - everything else takes the ordinary path: one entry in each cell it covers.
|
|
74
130
|
function _insertIntoGrid(grid, id, bounds) {
|
|
131
|
+
if (!Number.isFinite(bounds.minX) ||
|
|
132
|
+
!Number.isFinite(bounds.minY) ||
|
|
133
|
+
!Number.isFinite(bounds.maxX) ||
|
|
134
|
+
!Number.isFinite(bounds.maxY)) {
|
|
135
|
+
grid.declined.add(id);
|
|
136
|
+
if (_indexingGuard !== null) {
|
|
137
|
+
_indexingGuard({ id, mode: 'declined', reason: 'non-finite-bounds', wouldOccupyBucketCount: 0 });
|
|
138
|
+
}
|
|
139
|
+
return false;
|
|
140
|
+
}
|
|
75
141
|
const cs = grid.cellSize;
|
|
76
|
-
const
|
|
77
|
-
const
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
142
|
+
const copy = { minX: bounds.minX, minY: bounds.minY, maxX: bounds.maxX, maxY: bounds.maxY };
|
|
143
|
+
const spanned = _spannedCellCount(cs, copy);
|
|
144
|
+
// Written as a negated `<=` so a NaN span — a zero or non-finite cellSize makes every cell index
|
|
145
|
+
// NaN — falls to overflow rather than through to a loop whose bounds are NaN and which therefore
|
|
146
|
+
// never runs, silently indexing nothing.
|
|
147
|
+
if (!(spanned <= MAX_INDEXED_CELLS_PER_OBJECT)) {
|
|
148
|
+
grid.bounds.set(id, copy);
|
|
149
|
+
grid.overflow.add(id);
|
|
150
|
+
if (_indexingGuard !== null) {
|
|
151
|
+
_indexingGuard({ id, mode: 'overflow', reason: null, wouldOccupyBucketCount: spanned });
|
|
152
|
+
}
|
|
153
|
+
return true;
|
|
154
|
+
}
|
|
155
|
+
const cx0 = _cellIndex(copy.minX, cs);
|
|
156
|
+
const cx1 = _cellIndex(copy.maxX, cs);
|
|
157
|
+
const cy0 = _cellIndex(copy.minY, cs);
|
|
158
|
+
const cy1 = _cellIndex(copy.maxY, cs);
|
|
159
|
+
grid.bounds.set(id, copy);
|
|
81
160
|
for (let cy = cy0; cy <= cy1; cy++) {
|
|
82
161
|
for (let cx = cx0; cx <= cx1; cx++) {
|
|
83
162
|
const key = _cellKey(cx, cy);
|
|
@@ -106,6 +185,7 @@ function _insertIntoGrid(grid, id, bounds) {
|
|
|
106
185
|
if (cy1 > grid.maxCellY)
|
|
107
186
|
grid.maxCellY = cy1;
|
|
108
187
|
}
|
|
188
|
+
return true;
|
|
109
189
|
}
|
|
110
190
|
// Reports whether an AABB contains the point (`x`,`y`), reusing the geometry rectangle helper.
|
|
111
191
|
function _isSpatialAabbContainsPoint(aabb, x, y) {
|
|
@@ -165,11 +245,20 @@ function _rayBoxEntryT(ox, oy, dx, dy, minX, minY, maxX, maxY) {
|
|
|
165
245
|
}
|
|
166
246
|
// Removes an object from every cell its stored AABB covered and drops now-empty cells. The occupied
|
|
167
247
|
// cell range is intentionally not shrunk (only reset when the grid fully empties). A no-op for an
|
|
168
|
-
// unknown id.
|
|
248
|
+
// unknown id. Overflowed and declined ids leave through their own sets without a cell walk — remove
|
|
249
|
+
// re-derives the cell range from the stored bounds, so an overflowed object taking the ordinary path
|
|
250
|
+
// here would reintroduce exactly the unbounded walk the insert bound removed.
|
|
169
251
|
function _removeFromGrid(grid, id) {
|
|
252
|
+
grid.declined.delete(id);
|
|
170
253
|
const bounds = grid.bounds.get(id);
|
|
171
254
|
if (bounds === undefined)
|
|
172
255
|
return;
|
|
256
|
+
if (grid.overflow.delete(id)) {
|
|
257
|
+
grid.bounds.delete(id);
|
|
258
|
+
if (grid.bounds.size === 0)
|
|
259
|
+
grid.empty = true;
|
|
260
|
+
return;
|
|
261
|
+
}
|
|
173
262
|
const cs = grid.cellSize;
|
|
174
263
|
const cx0 = _cellIndex(bounds.minX, cs);
|
|
175
264
|
const cx1 = _cellIndex(bounds.maxX, cs);
|
|
@@ -190,6 +279,30 @@ function _removeFromGrid(grid, id) {
|
|
|
190
279
|
if (grid.bounds.size === 0)
|
|
191
280
|
grid.empty = true;
|
|
192
281
|
}
|
|
282
|
+
// Appends the pairs involving overflowed objects. An overflowed object occupies no cell, so the cell
|
|
283
|
+
// walk in _queryGridPairs can never emit a pair for it and no dedup against that walk is needed. Its
|
|
284
|
+
// pairs are enumerated here instead: against every other indexed object, which is what "spans nearly
|
|
285
|
+
// the whole world" already means. Unlike the cell path these are filtered by a real AABB overlap test
|
|
286
|
+
// rather than emitted as bare locality candidates — the result stays a superset of the true overlaps
|
|
287
|
+
// either way, and an object this large would otherwise nominate every other object every frame.
|
|
288
|
+
function _queryGridOverflowPairs(grid, out) {
|
|
289
|
+
for (const id of grid.overflow) {
|
|
290
|
+
const bounds = grid.bounds.get(id);
|
|
291
|
+
if (bounds === undefined)
|
|
292
|
+
continue;
|
|
293
|
+
for (const [otherId, otherBounds] of grid.bounds) {
|
|
294
|
+
if (otherId === id)
|
|
295
|
+
continue;
|
|
296
|
+
// Each overflow×overflow pair would otherwise be emitted from both sides; taking it only from
|
|
297
|
+
// the lower id emits it once. An overflow×celled pair reaches this test from one side only.
|
|
298
|
+
if (grid.overflow.has(otherId) && otherId < id)
|
|
299
|
+
continue;
|
|
300
|
+
if (!_isSpatialAabbOverlapping(bounds, otherBounds))
|
|
301
|
+
continue;
|
|
302
|
+
out.push(id < otherId ? { a: id, b: otherId } : { a: otherId, b: id });
|
|
303
|
+
}
|
|
304
|
+
}
|
|
305
|
+
}
|
|
193
306
|
// Enumerates candidate pairs. Within each cell every co-occupant pair is a candidate, but a pair may
|
|
194
307
|
// share several cells; to emit it exactly once, a pair is emitted only from its canonical cell — the
|
|
195
308
|
// top-left (min x, min y) cell of the two objects' overlapping cell ranges, which both objects are
|
|
@@ -223,16 +336,25 @@ function _queryGridPairs(grid, out) {
|
|
|
223
336
|
}
|
|
224
337
|
}
|
|
225
338
|
}
|
|
339
|
+
if (grid.overflow.size !== 0)
|
|
340
|
+
_queryGridOverflowPairs(grid, out);
|
|
226
341
|
}
|
|
227
342
|
// Gathers the ids in the cell containing the point, then confirms each against its real bounds. A
|
|
228
|
-
// single cell holds each id at most once, so no dedup pass is needed.
|
|
343
|
+
// single cell holds each id at most once, so no dedup pass is needed. Overflowed objects hold no cell
|
|
344
|
+
// and are tested directly; they cannot collide with the cell gather, so no dedup is needed there
|
|
345
|
+
// either.
|
|
229
346
|
function _queryGridPoint(grid, x, y, out) {
|
|
230
347
|
out.length = 0;
|
|
231
348
|
const cs = grid.cellSize;
|
|
232
349
|
const cell = grid.cells.get(_cellKey(_cellIndex(x, cs), _cellIndex(y, cs)));
|
|
233
|
-
if (cell
|
|
234
|
-
|
|
235
|
-
|
|
350
|
+
if (cell !== undefined) {
|
|
351
|
+
for (const id of cell.ids) {
|
|
352
|
+
const bounds = grid.bounds.get(id);
|
|
353
|
+
if (bounds !== undefined && _isSpatialAabbContainsPoint(bounds, x, y))
|
|
354
|
+
out.push(id);
|
|
355
|
+
}
|
|
356
|
+
}
|
|
357
|
+
for (const id of grid.overflow) {
|
|
236
358
|
const bounds = grid.bounds.get(id);
|
|
237
359
|
if (bounds !== undefined && _isSpatialAabbContainsPoint(bounds, x, y))
|
|
238
360
|
out.push(id);
|
|
@@ -244,8 +366,6 @@ function _queryGridPoint(grid, x, y, out) {
|
|
|
244
366
|
// point query at the origin. An empty grid returns nothing.
|
|
245
367
|
function _queryGridRay(grid, ox, oy, dx, dy, out) {
|
|
246
368
|
out.length = 0;
|
|
247
|
-
if (grid.empty)
|
|
248
|
-
return;
|
|
249
369
|
const cs = grid.cellSize;
|
|
250
370
|
const seen = grid.seen;
|
|
251
371
|
seen.clear();
|
|
@@ -253,6 +373,17 @@ function _queryGridRay(grid, ox, oy, dx, dy, out) {
|
|
|
253
373
|
_queryGridPoint(grid, ox, oy, out);
|
|
254
374
|
return;
|
|
255
375
|
}
|
|
376
|
+
// Overflowed objects are outside the cell range the DDA walks — deliberately, so one huge AABB
|
|
377
|
+
// cannot stretch that range and make every ray traverse it — so they are slab-tested directly.
|
|
378
|
+
for (const id of grid.overflow) {
|
|
379
|
+
const bounds = grid.bounds.get(id);
|
|
380
|
+
if (bounds !== undefined &&
|
|
381
|
+
_rayBoxEntryT(ox, oy, dx, dy, bounds.minX, bounds.minY, bounds.maxX, bounds.maxY) >= 0) {
|
|
382
|
+
out.push(id);
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
if (grid.empty)
|
|
386
|
+
return;
|
|
256
387
|
const boxMinX = grid.minCellX * cs;
|
|
257
388
|
const boxMinY = grid.minCellY * cs;
|
|
258
389
|
const boxMaxX = (grid.maxCellX + 1) * cs;
|
|
@@ -316,12 +447,25 @@ function _queryGridRay(grid, ox, oy, dx, dy, out) {
|
|
|
316
447
|
}
|
|
317
448
|
// Gathers the ids in every cell the region covers (deduplicated via the reused scratch set), then
|
|
318
449
|
// confirms each against the region's real bounds — so a false cell-mate whose bounds miss the region
|
|
319
|
-
// is dropped.
|
|
450
|
+
// is dropped. Overflowed objects hold no cell and are tested directly.
|
|
451
|
+
//
|
|
452
|
+
// The region is caller-supplied, so it carries the same unbounded-walk hazard the insert bound closes
|
|
453
|
+
// and needs its own guard: a query region wider than the world costs extent ÷ cellSize squared cell
|
|
454
|
+
// lookups against a grid that may hold one object. When the region spans more cells than the grid has
|
|
455
|
+
// occupied, walking the objects is both cheaper and exact, so the walk flips — a region query is
|
|
456
|
+
// never more expensive than a full scan.
|
|
320
457
|
function _queryGridRegion(grid, region, out) {
|
|
321
458
|
out.length = 0;
|
|
322
459
|
const cs = grid.cellSize;
|
|
323
460
|
const seen = grid.seen;
|
|
324
461
|
seen.clear();
|
|
462
|
+
if (!(_spannedCellCount(cs, region) <= grid.cells.size)) {
|
|
463
|
+
for (const [id, bounds] of grid.bounds) {
|
|
464
|
+
if (_isSpatialAabbOverlapping(bounds, region))
|
|
465
|
+
out.push(id);
|
|
466
|
+
}
|
|
467
|
+
return;
|
|
468
|
+
}
|
|
325
469
|
const cx0 = _cellIndex(region.minX, cs);
|
|
326
470
|
const cx1 = _cellIndex(region.maxX, cs);
|
|
327
471
|
const cy0 = _cellIndex(region.minY, cs);
|
|
@@ -341,7 +485,28 @@ function _queryGridRegion(grid, region, out) {
|
|
|
341
485
|
}
|
|
342
486
|
}
|
|
343
487
|
}
|
|
488
|
+
for (const id of grid.overflow) {
|
|
489
|
+
const bounds = grid.bounds.get(id);
|
|
490
|
+
if (bounds !== undefined && _isSpatialAabbOverlapping(bounds, region))
|
|
491
|
+
out.push(id);
|
|
492
|
+
}
|
|
493
|
+
}
|
|
494
|
+
// How many cells an AABB's span covers, as a count rather than a walk — the number the per-object
|
|
495
|
+
// budget is compared against, computed before any cell is touched. Returns NaN for bounds or a cell
|
|
496
|
+
// size that make the cell indices non-finite; callers test it with a negated `<=` so NaN falls to the
|
|
497
|
+
// bounded path rather than through it.
|
|
498
|
+
function _spannedCellCount(cellSize, aabb) {
|
|
499
|
+
const cx0 = _cellIndex(aabb.minX, cellSize);
|
|
500
|
+
const cx1 = _cellIndex(aabb.maxX, cellSize);
|
|
501
|
+
const cy0 = _cellIndex(aabb.minY, cellSize);
|
|
502
|
+
const cy1 = _cellIndex(aabb.maxY, cellSize);
|
|
503
|
+
return (cx1 - cx0 + 1) * (cy1 - cy0 + 1);
|
|
344
504
|
}
|
|
505
|
+
// Diagnostics seam: enableSpatialGuards (separately imported, so its message text and its
|
|
506
|
+
// @flighthq/log dependency shake out of a production bundle) fills this, and the insert path reaches
|
|
507
|
+
// it through the null check. Not enabling guards costs one comparison per declined-or-overflowed
|
|
508
|
+
// insert — and nothing at all on the ordinary path.
|
|
509
|
+
let _indexingGuard = null;
|
|
345
510
|
// Reused scratch rectangles for the geometry overlap/containment helpers. Only ever read+written
|
|
346
511
|
// within a single non-nested helper call, so sharing them across the module allocates nothing per
|
|
347
512
|
// query without aliasing hazard.
|
package/dist/uniformGrid.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"uniformGrid.js","sourceRoot":"","sources":["../src/uniformGrid.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"uniformGrid.js","sourceRoot":"","sources":["../src/uniformGrid.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@flighthq/spatial",
|
|
3
|
-
"version": "0.3.0-next.
|
|
3
|
+
"version": "0.3.0-next.1162.e90e518",
|
|
4
4
|
"repository": {
|
|
5
5
|
"type": "git",
|
|
6
6
|
"url": "https://github.com/flighthq/flight.git",
|
|
@@ -36,8 +36,8 @@
|
|
|
36
36
|
"clean:dist": "tsx ../../scripts/clean-package-dist.ts"
|
|
37
37
|
},
|
|
38
38
|
"dependencies": {
|
|
39
|
-
"@flighthq/geometry": "0.3.0-next.
|
|
40
|
-
"@flighthq/types": "0.3.0-next.
|
|
39
|
+
"@flighthq/geometry": "0.3.0-next.1162.e90e518",
|
|
40
|
+
"@flighthq/types": "0.3.0-next.1162.e90e518"
|
|
41
41
|
},
|
|
42
42
|
"devDependencies": {
|
|
43
43
|
"typescript": "^5.3.0"
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import type { SpatialObjectId } from '@flighthq/types/contract';
|
|
2
|
+
import { describe, expect, it } from 'vitest';
|
|
3
|
+
|
|
4
|
+
import { explainSpatialIndexing } from './explainSpatialIndexing';
|
|
5
|
+
import { createSpatialIndex, insertSpatialObject, removeSpatialObject, updateSpatialObject } from './spatialIndex';
|
|
6
|
+
import { MAX_INDEXED_CELLS_PER_OBJECT, createUniformGridSpatialBackend } from './uniformGrid';
|
|
7
|
+
|
|
8
|
+
describe('explainSpatialIndexing', () => {
|
|
9
|
+
it('reports absent for an id that was never inserted', () => {
|
|
10
|
+
const index = createSpatialIndex(createUniformGridSpatialBackend(10));
|
|
11
|
+
expect(explainSpatialIndexing(index, 42)).toEqual({ bucketCount: 0, id: 42, mode: 'absent', reason: null });
|
|
12
|
+
});
|
|
13
|
+
|
|
14
|
+
it('reports the bucket count of an ordinary object', () => {
|
|
15
|
+
const index = createSpatialIndex(createUniformGridSpatialBackend(10));
|
|
16
|
+
insertSpatialObject(index, 1, { minX: 0, minY: 0, maxX: 25, maxY: 25 });
|
|
17
|
+
// Covers cells 0..2 on each axis.
|
|
18
|
+
expect(explainSpatialIndexing(index, 1)).toEqual({ bucketCount: 9, id: 1, mode: 'cells', reason: null });
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
it('reports overflow with no buckets for an oversized object', () => {
|
|
22
|
+
const index = createSpatialIndex(createUniformGridSpatialBackend(1));
|
|
23
|
+
insertSpatialObject(index, 1, { minX: 0, minY: 0, maxX: 1e6, maxY: 1e6 });
|
|
24
|
+
expect(explainSpatialIndexing(index, 1)).toEqual({ bucketCount: 0, id: 1, mode: 'overflow', reason: null });
|
|
25
|
+
});
|
|
26
|
+
|
|
27
|
+
it('reports declined with the reason for non-finite bounds', () => {
|
|
28
|
+
const index = createSpatialIndex(createUniformGridSpatialBackend(10));
|
|
29
|
+
insertSpatialObject(index, 1, { minX: 0, minY: 0, maxX: Infinity, maxY: 10 });
|
|
30
|
+
expect(explainSpatialIndexing(index, 1)).toEqual({
|
|
31
|
+
bucketCount: 0,
|
|
32
|
+
id: 1,
|
|
33
|
+
mode: 'declined',
|
|
34
|
+
reason: 'non-finite-bounds',
|
|
35
|
+
});
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
it('returns to absent after a remove', () => {
|
|
39
|
+
const index = createSpatialIndex(createUniformGridSpatialBackend(10));
|
|
40
|
+
insertSpatialObject(index, 1, { minX: 0, minY: 0, maxX: 5, maxY: 5 });
|
|
41
|
+
removeSpatialObject(index, 1);
|
|
42
|
+
expect(explainSpatialIndexing(index, 1).mode).toBe('absent');
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
it('tracks the mode across updates', () => {
|
|
46
|
+
const index = createSpatialIndex(createUniformGridSpatialBackend(1));
|
|
47
|
+
insertSpatialObject(index, 1, { minX: 0, minY: 0, maxX: 2, maxY: 2 });
|
|
48
|
+
expect(explainSpatialIndexing(index, 1).mode).toBe('cells');
|
|
49
|
+
updateSpatialObject(index, 1, { minX: 0, minY: 0, maxX: 1e9, maxY: 1e9 });
|
|
50
|
+
expect(explainSpatialIndexing(index, 1).mode).toBe('overflow');
|
|
51
|
+
updateSpatialObject(index, 1, { minX: NaN, minY: 0, maxX: 2, maxY: 2 });
|
|
52
|
+
expect(explainSpatialIndexing(index, 1).mode).toBe('declined');
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
it('never exceeds the per-object bucket budget it exists to measure', () => {
|
|
56
|
+
const index = createSpatialIndex(createUniformGridSpatialBackend(1));
|
|
57
|
+
const ids: SpatialObjectId[] = [];
|
|
58
|
+
for (let i = 0; i < 8; i++) {
|
|
59
|
+
const extent = 10 ** i;
|
|
60
|
+
insertSpatialObject(index, i, { minX: 0, minY: 0, maxX: extent, maxY: extent });
|
|
61
|
+
ids.push(i);
|
|
62
|
+
}
|
|
63
|
+
for (const id of ids) {
|
|
64
|
+
expect(explainSpatialIndexing(index, id).bucketCount).toBeLessThanOrEqual(MAX_INDEXED_CELLS_PER_OBJECT);
|
|
65
|
+
}
|
|
66
|
+
});
|
|
67
|
+
|
|
68
|
+
it('mutates nothing — repeated calls report the same thing', () => {
|
|
69
|
+
const index = createSpatialIndex(createUniformGridSpatialBackend(10));
|
|
70
|
+
insertSpatialObject(index, 1, { minX: 0, minY: 0, maxX: 5, maxY: 5 });
|
|
71
|
+
const first = explainSpatialIndexing(index, 1);
|
|
72
|
+
expect(explainSpatialIndexing(index, 1)).toEqual(first);
|
|
73
|
+
expect(explainSpatialIndexing(index, 99).mode).toBe('absent');
|
|
74
|
+
expect(explainSpatialIndexing(index, 1)).toEqual(first);
|
|
75
|
+
});
|
|
76
|
+
});
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import type { SpatialIndexingNotice } from '@flighthq/types/contract';
|
|
2
|
+
import { afterEach, describe, expect, it } from 'vitest';
|
|
3
|
+
|
|
4
|
+
import { formatSpatialIndexingNotice } from './formatSpatialIndexingNotice';
|
|
5
|
+
import { MAX_INDEXED_CELLS_PER_OBJECT, createUniformGridSpatialBackend, setSpatialIndexingGuard } from './uniformGrid';
|
|
6
|
+
|
|
7
|
+
afterEach(() => {
|
|
8
|
+
setSpatialIndexingGuard(null);
|
|
9
|
+
});
|
|
10
|
+
|
|
11
|
+
describe('formatSpatialIndexingNotice', () => {
|
|
12
|
+
it('names the sentinel to check for a decline', () => {
|
|
13
|
+
const message = formatSpatialIndexingNotice({
|
|
14
|
+
id: 3,
|
|
15
|
+
mode: 'declined',
|
|
16
|
+
reason: 'non-finite-bounds',
|
|
17
|
+
wouldOccupyBucketCount: 0,
|
|
18
|
+
});
|
|
19
|
+
expect(message).toContain('insertSpatialObject(3)');
|
|
20
|
+
expect(message).toContain('not finite');
|
|
21
|
+
expect(message).toContain('returns false');
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
it('names the span and the cell-size cause for an overflow, without calling it wrong', () => {
|
|
25
|
+
const message = formatSpatialIndexingNotice({
|
|
26
|
+
id: 4,
|
|
27
|
+
mode: 'overflow',
|
|
28
|
+
reason: null,
|
|
29
|
+
wouldOccupyBucketCount: 40000,
|
|
30
|
+
});
|
|
31
|
+
expect(message).toContain('insertSpatialObject(4)');
|
|
32
|
+
expect(message).toContain('40000 cells');
|
|
33
|
+
expect(message).toContain(`${MAX_INDEXED_CELLS_PER_OBJECT} per-object budget`);
|
|
34
|
+
expect(message).toContain('cellSize is too small');
|
|
35
|
+
// Overflow is a cost decision, not a wrong answer, and the message must not imply otherwise.
|
|
36
|
+
expect(message).toContain('Results are unaffected');
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
it('says plainly that a mode it does not cover carries no advice', () => {
|
|
40
|
+
expect(formatSpatialIndexingNotice({ id: 5, mode: 'cells', reason: null, wouldOccupyBucketCount: 4 })).toContain(
|
|
41
|
+
'no caller-facing advice',
|
|
42
|
+
);
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
it('formats what the grid actually hands a guard', () => {
|
|
46
|
+
// Pins the two halves together: a record produced by a real insert, rendered by this formatter.
|
|
47
|
+
const notices: SpatialIndexingNotice[] = [];
|
|
48
|
+
setSpatialIndexingGuard((notice) => notices.push({ ...notice }));
|
|
49
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
50
|
+
grid.insertSpatialObject(9, { minX: 0, minY: 0, maxX: 199, maxY: 199 });
|
|
51
|
+
grid.insertSpatialObject(10, { minX: NaN, minY: 0, maxX: 1, maxY: 1 });
|
|
52
|
+
expect(notices.map(formatSpatialIndexingNotice)).toEqual([
|
|
53
|
+
formatSpatialIndexingNotice({ id: 9, mode: 'overflow', reason: null, wouldOccupyBucketCount: 40000 }),
|
|
54
|
+
formatSpatialIndexingNotice({ id: 10, mode: 'declined', reason: 'non-finite-bounds', wouldOccupyBucketCount: 0 }),
|
|
55
|
+
]);
|
|
56
|
+
expect(notices.map(formatSpatialIndexingNotice)[0]).toContain('40000 cells');
|
|
57
|
+
});
|
|
58
|
+
});
|
package/src/uniformGrid.test.ts
CHANGED
|
@@ -1,7 +1,11 @@
|
|
|
1
|
-
import type { SpatialAabb, SpatialObjectId, SpatialPair } from '@flighthq/types/contract';
|
|
2
|
-
import { describe, expect, it } from 'vitest';
|
|
1
|
+
import type { SpatialAabb, SpatialIndexingNotice, SpatialObjectId, SpatialPair } from '@flighthq/types/contract';
|
|
2
|
+
import { afterEach, describe, expect, it } from 'vitest';
|
|
3
3
|
|
|
4
|
-
import { createUniformGridSpatialBackend } from './uniformGrid';
|
|
4
|
+
import { MAX_INDEXED_CELLS_PER_OBJECT, createUniformGridSpatialBackend, setSpatialIndexingGuard } from './uniformGrid';
|
|
5
|
+
|
|
6
|
+
afterEach(() => {
|
|
7
|
+
setSpatialIndexingGuard(null);
|
|
8
|
+
});
|
|
5
9
|
|
|
6
10
|
// A plain AABB-overlap confirmation used to turn broadphase candidate pairs into confirmed pairs (the
|
|
7
11
|
// narrow-phase stand-in): exactly the check the caller would apply downstream.
|
|
@@ -95,3 +99,275 @@ describe('createUniformGridSpatialBackend', () => {
|
|
|
95
99
|
expect(coarse).toEqual(fine);
|
|
96
100
|
});
|
|
97
101
|
});
|
|
102
|
+
|
|
103
|
+
describe('MAX_INDEXED_CELLS_PER_OBJECT', () => {
|
|
104
|
+
it('is the per-object cell budget the oversized path is chosen by', () => {
|
|
105
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
106
|
+
// A square block of exactly the budget stays on the ordinary path; one cell more does not. The
|
|
107
|
+
// budget is a count of cells, not an extent, so it is asserted through the count.
|
|
108
|
+
const side = Math.sqrt(MAX_INDEXED_CELLS_PER_OBJECT);
|
|
109
|
+
expect(Number.isInteger(side)).toBe(true);
|
|
110
|
+
grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: side - 1, maxY: side - 1 });
|
|
111
|
+
expect(grid.explainSpatialIndexing(1)).toEqual({
|
|
112
|
+
bucketCount: MAX_INDEXED_CELLS_PER_OBJECT,
|
|
113
|
+
id: 1,
|
|
114
|
+
mode: 'cells',
|
|
115
|
+
reason: null,
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
grid.insertSpatialObject(2, { minX: 0, minY: 0, maxX: side, maxY: side - 1 });
|
|
119
|
+
expect(grid.explainSpatialIndexing(2).mode).toBe('overflow');
|
|
120
|
+
});
|
|
121
|
+
});
|
|
122
|
+
|
|
123
|
+
describe('non-finite bounds', () => {
|
|
124
|
+
it('declines rather than indexing, and answers with the false sentinel', () => {
|
|
125
|
+
const grid = createUniformGridSpatialBackend(10);
|
|
126
|
+
expect(grid.insertSpatialObject(1, { minX: NaN, minY: 0, maxX: 10, maxY: 10 })).toBe(false);
|
|
127
|
+
expect(grid.insertSpatialObject(2, { minX: 0, minY: 0, maxX: Infinity, maxY: 10 })).toBe(false);
|
|
128
|
+
expect(grid.insertSpatialObject(3, { minX: 0, minY: -Infinity, maxX: 10, maxY: 10 })).toBe(false);
|
|
129
|
+
expect(grid.explainSpatialIndexing(1)).toEqual({
|
|
130
|
+
bucketCount: 0,
|
|
131
|
+
id: 1,
|
|
132
|
+
mode: 'declined',
|
|
133
|
+
reason: 'non-finite-bounds',
|
|
134
|
+
});
|
|
135
|
+
});
|
|
136
|
+
|
|
137
|
+
it('returns true for finite bounds, so the sentinel distinguishes decline from success', () => {
|
|
138
|
+
const grid = createUniformGridSpatialBackend(10);
|
|
139
|
+
expect(grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: 10, maxY: 10 })).toBe(true);
|
|
140
|
+
});
|
|
141
|
+
|
|
142
|
+
it('keeps a declined object out of every query rather than out of some', () => {
|
|
143
|
+
const grid = createUniformGridSpatialBackend(10);
|
|
144
|
+
grid.insertSpatialObject(1, { minX: NaN, minY: NaN, maxX: NaN, maxY: NaN });
|
|
145
|
+
grid.insertSpatialObject(2, { minX: 0, minY: 0, maxX: 10, maxY: 10 });
|
|
146
|
+
|
|
147
|
+
const region: SpatialObjectId[] = [];
|
|
148
|
+
grid.querySpatialRegion({ minX: -1e6, minY: -1e6, maxX: 1e6, maxY: 1e6 }, region);
|
|
149
|
+
expect(region).toEqual([2]);
|
|
150
|
+
|
|
151
|
+
const point: SpatialObjectId[] = [];
|
|
152
|
+
grid.querySpatialPoint(5, 5, point);
|
|
153
|
+
expect(point).toEqual([2]);
|
|
154
|
+
|
|
155
|
+
const ray: SpatialObjectId[] = [];
|
|
156
|
+
grid.querySpatialRay(-5, 5, 1, 0, ray);
|
|
157
|
+
expect(ray).toEqual([2]);
|
|
158
|
+
|
|
159
|
+
const pairs: SpatialPair[] = [];
|
|
160
|
+
grid.querySpatialPairs(pairs);
|
|
161
|
+
expect(pairs).toEqual([]);
|
|
162
|
+
});
|
|
163
|
+
|
|
164
|
+
it('drops an object that updates to non-finite bounds instead of stranding it at its old ones', () => {
|
|
165
|
+
const grid = createUniformGridSpatialBackend(10);
|
|
166
|
+
grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: 10, maxY: 10 });
|
|
167
|
+
expect(grid.updateSpatialObject(1, { minX: NaN, minY: NaN, maxX: NaN, maxY: NaN })).toBe(false);
|
|
168
|
+
expect(grid.explainSpatialIndexing(1).mode).toBe('declined');
|
|
169
|
+
const out: SpatialObjectId[] = [];
|
|
170
|
+
grid.querySpatialPoint(5, 5, out);
|
|
171
|
+
expect(out).toEqual([]);
|
|
172
|
+
});
|
|
173
|
+
|
|
174
|
+
it('lets a declined object recover on a later finite update', () => {
|
|
175
|
+
const grid = createUniformGridSpatialBackend(10);
|
|
176
|
+
grid.insertSpatialObject(1, { minX: NaN, minY: NaN, maxX: NaN, maxY: NaN });
|
|
177
|
+
expect(grid.updateSpatialObject(1, { minX: 0, minY: 0, maxX: 10, maxY: 10 })).toBe(true);
|
|
178
|
+
expect(grid.explainSpatialIndexing(1).mode).toBe('cells');
|
|
179
|
+
const out: SpatialObjectId[] = [];
|
|
180
|
+
grid.querySpatialPoint(5, 5, out);
|
|
181
|
+
expect(out).toEqual([1]);
|
|
182
|
+
});
|
|
183
|
+
});
|
|
184
|
+
|
|
185
|
+
describe('oversized region query', () => {
|
|
186
|
+
// The same unbounded-walk hazard from the caller's side: the region is caller-supplied, so a query
|
|
187
|
+
// wider than the world would walk extent-squared cells against a grid holding almost nothing.
|
|
188
|
+
// Measured at 69 ms for a 1000x1000-cell region over a one-object grid before the bound.
|
|
189
|
+
it('answers a region far wider than the grid without walking it cell by cell', () => {
|
|
190
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
191
|
+
grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: 1, maxY: 1 });
|
|
192
|
+
const out: SpatialObjectId[] = [];
|
|
193
|
+
grid.querySpatialRegion({ minX: -1e12, minY: -1e12, maxX: 1e12, maxY: 1e12 }, out);
|
|
194
|
+
expect(out).toEqual([1]);
|
|
195
|
+
});
|
|
196
|
+
|
|
197
|
+
it('returns the same objects either way it walks', () => {
|
|
198
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
199
|
+
for (let i = 0; i < 40; i++) grid.insertSpatialObject(i, { minX: i, minY: 0, maxX: i + 0.5, maxY: 1 });
|
|
200
|
+
const wide: SpatialObjectId[] = [];
|
|
201
|
+
grid.querySpatialRegion({ minX: -1e9, minY: -1e9, maxX: 1e9, maxY: 1e9 }, wide);
|
|
202
|
+
const narrow: SpatialObjectId[] = [];
|
|
203
|
+
grid.querySpatialRegion({ minX: -1, minY: -1, maxX: 41, maxY: 2 }, narrow);
|
|
204
|
+
expect([...wide].sort((a, b) => a - b)).toEqual([...narrow].sort((a, b) => a - b));
|
|
205
|
+
expect(wide.length).toBe(40);
|
|
206
|
+
});
|
|
207
|
+
|
|
208
|
+
it('still excludes objects the wide region misses', () => {
|
|
209
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
210
|
+
grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: 1, maxY: 1 });
|
|
211
|
+
grid.insertSpatialObject(2, { minX: 5e11, minY: 0, maxX: 5e11 + 1, maxY: 1 });
|
|
212
|
+
const out: SpatialObjectId[] = [];
|
|
213
|
+
grid.querySpatialRegion({ minX: -1e12, minY: -1e12, maxX: 10, maxY: 1e12 }, out);
|
|
214
|
+
expect(out).toEqual([1]);
|
|
215
|
+
});
|
|
216
|
+
});
|
|
217
|
+
|
|
218
|
+
describe('oversized-extent bound', () => {
|
|
219
|
+
// THE REGRESSION GUARD for the unbounded insert walk.
|
|
220
|
+
//
|
|
221
|
+
// The extent here is deliberately modest — 200 units at one cell per unit, so 40,401 cells, which
|
|
222
|
+
// an unbounded build writes in about 28 ms. That is the point: this assertion FAILS on unbounded
|
|
223
|
+
// code rather than HANGING it, so it stays a usable test. A realistic reproduction (an AABB 1e12
|
|
224
|
+
// wide, which is what a diverging rigid-body simulation actually produces) would be 1e24 cells and
|
|
225
|
+
// would never return, which is exactly why the bound cannot be tested at its motivating scale.
|
|
226
|
+
it('holds an oversized object without writing a cell per unit of its extent', () => {
|
|
227
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
228
|
+
grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: 200, maxY: 200 });
|
|
229
|
+
const explanation = grid.explainSpatialIndexing(1);
|
|
230
|
+
expect(explanation.mode).toBe('overflow');
|
|
231
|
+
expect(explanation.bucketCount).toBe(0);
|
|
232
|
+
});
|
|
233
|
+
|
|
234
|
+
it('indexes an AABB far past any walkable extent in constant time', () => {
|
|
235
|
+
// Unreachable for an unbounded build (1e24 cells), so this one cannot be written as a
|
|
236
|
+
// before/after assertion — it is the proof that the motivating case is now O(1). Safe to run only
|
|
237
|
+
// because the assertion above fails first if the bound is ever removed.
|
|
238
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
239
|
+
expect(grid.insertSpatialObject(1, { minX: -1e12, minY: -1e12, maxX: 1e12, maxY: 1e12 })).toBe(true);
|
|
240
|
+
expect(grid.explainSpatialIndexing(1).mode).toBe('overflow');
|
|
241
|
+
});
|
|
242
|
+
|
|
243
|
+
it('keeps an oversized object queryable — the bound is a cost decision, not a dropped object', () => {
|
|
244
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
245
|
+
grid.insertSpatialObject(1, { minX: -1e12, minY: -1e12, maxX: 1e12, maxY: 1e12 });
|
|
246
|
+
grid.insertSpatialObject(2, { minX: 0, minY: 0, maxX: 1, maxY: 1 });
|
|
247
|
+
|
|
248
|
+
const region: SpatialObjectId[] = [];
|
|
249
|
+
grid.querySpatialRegion({ minX: 100, minY: 100, maxX: 101, maxY: 101 }, region);
|
|
250
|
+
expect(region).toEqual([1]);
|
|
251
|
+
|
|
252
|
+
const point: SpatialObjectId[] = [];
|
|
253
|
+
grid.querySpatialPoint(500, 500, point);
|
|
254
|
+
expect(point).toEqual([1]);
|
|
255
|
+
|
|
256
|
+
const ray: SpatialObjectId[] = [];
|
|
257
|
+
grid.querySpatialRay(1e6, 1e6, 1, 0, ray);
|
|
258
|
+
expect(ray).toEqual([1]);
|
|
259
|
+
|
|
260
|
+
const pairs: SpatialPair[] = [];
|
|
261
|
+
grid.querySpatialPairs(pairs);
|
|
262
|
+
expect(pairKeys(pairs)).toEqual(['1-2']);
|
|
263
|
+
});
|
|
264
|
+
|
|
265
|
+
it('emits each overflow pair once, including overflow against overflow', () => {
|
|
266
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
267
|
+
grid.insertSpatialObject(1, { minX: -1e9, minY: -1e9, maxX: 1e9, maxY: 1e9 });
|
|
268
|
+
grid.insertSpatialObject(2, { minX: -1e9, minY: -1e9, maxX: 1e9, maxY: 1e9 });
|
|
269
|
+
grid.insertSpatialObject(3, { minX: 0, minY: 0, maxX: 1, maxY: 1 });
|
|
270
|
+
const pairs: SpatialPair[] = [];
|
|
271
|
+
grid.querySpatialPairs(pairs);
|
|
272
|
+
expect(pairKeys(pairs)).toEqual(['1-2', '1-3', '2-3']);
|
|
273
|
+
});
|
|
274
|
+
|
|
275
|
+
it('does not pair an overflow object with a disjoint object', () => {
|
|
276
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
277
|
+
grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: 100000, maxY: 100000 });
|
|
278
|
+
grid.insertSpatialObject(2, { minX: -50, minY: -50, maxX: -40, maxY: -40 });
|
|
279
|
+
const pairs: SpatialPair[] = [];
|
|
280
|
+
grid.querySpatialPairs(pairs);
|
|
281
|
+
expect(pairs).toEqual([]);
|
|
282
|
+
});
|
|
283
|
+
|
|
284
|
+
it('removes an oversized object without walking its extent, and stops returning it', () => {
|
|
285
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
286
|
+
grid.insertSpatialObject(1, { minX: -1e12, minY: -1e12, maxX: 1e12, maxY: 1e12 });
|
|
287
|
+
grid.removeSpatialObject(1);
|
|
288
|
+
expect(grid.explainSpatialIndexing(1).mode).toBe('absent');
|
|
289
|
+
const out: SpatialObjectId[] = [];
|
|
290
|
+
grid.querySpatialPoint(0, 0, out);
|
|
291
|
+
expect(out).toEqual([]);
|
|
292
|
+
});
|
|
293
|
+
|
|
294
|
+
it('moves an object between the celled and overflow paths as it grows and shrinks', () => {
|
|
295
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
296
|
+
grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: 2, maxY: 2 });
|
|
297
|
+
expect(grid.explainSpatialIndexing(1).mode).toBe('cells');
|
|
298
|
+
grid.updateSpatialObject(1, { minX: -1e12, minY: -1e12, maxX: 1e12, maxY: 1e12 });
|
|
299
|
+
expect(grid.explainSpatialIndexing(1).mode).toBe('overflow');
|
|
300
|
+
grid.updateSpatialObject(1, { minX: 0, minY: 0, maxX: 2, maxY: 2 });
|
|
301
|
+
expect(grid.explainSpatialIndexing(1).mode).toBe('cells');
|
|
302
|
+
|
|
303
|
+
// Back on the ordinary path the object must be findable through the cells again, not stranded.
|
|
304
|
+
const out: SpatialObjectId[] = [];
|
|
305
|
+
grid.querySpatialPoint(1, 1, out);
|
|
306
|
+
expect(out).toEqual([1]);
|
|
307
|
+
});
|
|
308
|
+
|
|
309
|
+
it('clears overflow with the rest of the index', () => {
|
|
310
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
311
|
+
grid.insertSpatialObject(1, { minX: -1e12, minY: -1e12, maxX: 1e12, maxY: 1e12 });
|
|
312
|
+
grid.clearSpatialIndex();
|
|
313
|
+
expect(grid.explainSpatialIndexing(1).mode).toBe('absent');
|
|
314
|
+
const out: SpatialObjectId[] = [];
|
|
315
|
+
grid.querySpatialPoint(0, 0, out);
|
|
316
|
+
expect(out).toEqual([]);
|
|
317
|
+
});
|
|
318
|
+
|
|
319
|
+
it('keeps an oversized object out of the ray-traversal cell range', () => {
|
|
320
|
+
// Without the bound the occupied cell range stretches to the oversized object's span, and every
|
|
321
|
+
// subsequent ray walks it. Two small objects far apart bound the range; the oversized one must
|
|
322
|
+
// not widen it, which shows up as the ray still resolving correctly and promptly.
|
|
323
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
324
|
+
grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: 1, maxY: 1 });
|
|
325
|
+
grid.insertSpatialObject(2, { minX: -1e12, minY: -1e12, maxX: 1e12, maxY: 1e12 });
|
|
326
|
+
const out: SpatialObjectId[] = [];
|
|
327
|
+
grid.querySpatialRay(-5, 0.5, 1, 0, out);
|
|
328
|
+
expect(out.sort()).toEqual([1, 2]);
|
|
329
|
+
});
|
|
330
|
+
});
|
|
331
|
+
|
|
332
|
+
describe('setSpatialIndexingGuard', () => {
|
|
333
|
+
it('reports a decline with its reason, and no span', () => {
|
|
334
|
+
const notices: SpatialIndexingNotice[] = [];
|
|
335
|
+
setSpatialIndexingGuard((notice) => notices.push({ ...notice }));
|
|
336
|
+
const grid = createUniformGridSpatialBackend(10);
|
|
337
|
+
grid.insertSpatialObject(7, { minX: NaN, minY: 0, maxX: 10, maxY: 10 });
|
|
338
|
+
expect(notices).toEqual([{ id: 7, mode: 'declined', reason: 'non-finite-bounds', wouldOccupyBucketCount: 0 }]);
|
|
339
|
+
});
|
|
340
|
+
|
|
341
|
+
it('reports an overflow with the span the bound refused to walk', () => {
|
|
342
|
+
const notices: SpatialIndexingNotice[] = [];
|
|
343
|
+
setSpatialIndexingGuard((notice) => notices.push({ ...notice }));
|
|
344
|
+
const grid = createUniformGridSpatialBackend(1);
|
|
345
|
+
grid.insertSpatialObject(7, { minX: 0, minY: 0, maxX: 199, maxY: 199 });
|
|
346
|
+
expect(notices).toEqual([{ id: 7, mode: 'overflow', reason: null, wouldOccupyBucketCount: 40000 }]);
|
|
347
|
+
});
|
|
348
|
+
|
|
349
|
+
it('stays silent on the ordinary path', () => {
|
|
350
|
+
const notices: SpatialIndexingNotice[] = [];
|
|
351
|
+
setSpatialIndexingGuard((notice) => notices.push({ ...notice }));
|
|
352
|
+
const grid = createUniformGridSpatialBackend(10);
|
|
353
|
+
grid.insertSpatialObject(1, { minX: 0, minY: 0, maxX: 10, maxY: 10 });
|
|
354
|
+
grid.removeSpatialObject(1);
|
|
355
|
+
expect(notices).toEqual([]);
|
|
356
|
+
});
|
|
357
|
+
|
|
358
|
+
it('null uninstalls it', () => {
|
|
359
|
+
const notices: SpatialIndexingNotice[] = [];
|
|
360
|
+
setSpatialIndexingGuard((notice) => notices.push({ ...notice }));
|
|
361
|
+
setSpatialIndexingGuard(null);
|
|
362
|
+
const grid = createUniformGridSpatialBackend(10);
|
|
363
|
+
grid.insertSpatialObject(1, { minX: NaN, minY: 0, maxX: 10, maxY: 10 });
|
|
364
|
+
expect(notices).toEqual([]);
|
|
365
|
+
});
|
|
366
|
+
|
|
367
|
+
it('does not change what insert returns', () => {
|
|
368
|
+
setSpatialIndexingGuard(() => {});
|
|
369
|
+
const grid = createUniformGridSpatialBackend(10);
|
|
370
|
+
expect(grid.insertSpatialObject(1, { minX: NaN, minY: 0, maxX: 10, maxY: 10 })).toBe(false);
|
|
371
|
+
expect(grid.insertSpatialObject(2, { minX: 0, minY: 0, maxX: 10, maxY: 10 })).toBe(true);
|
|
372
|
+
});
|
|
373
|
+
});
|