@forgeax/engine-ecs 0.0.0-dev.8d955ade1c79

package/dist/__tests__/handle.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/handle.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/hierarchy.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hierarchy.unit.test.d.ts.map

package/dist/__tests__/hierarchy.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hierarchy.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/managed-array-vocab.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=managed-array-vocab.test-d.d.ts.map

package/dist/__tests__/managed-array-vocab.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-array-vocab.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/managed-array-vocab.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/minimal-example.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=minimal-example.test-d.d.ts.map

package/dist/__tests__/minimal-example.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal-example.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/minimal-example.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/name-read-types.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=name-read-types.test-d.d.ts.map

package/dist/__tests__/name-read-types.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-read-types.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/name-read-types.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/plugin-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-service.test.d.ts.map

package/dist/__tests__/plugin-service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-service.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/plugin-service.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/query-combinations.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-combinations.unit.test.d.ts.map

package/dist/__tests__/query-combinations.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-combinations.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/query-combinations.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/query-light-extract-flat-column-ratio.perf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-light-extract-flat-column-ratio.perf.test.d.ts.map

package/dist/__tests__/query-light-extract-flat-column-ratio.perf.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-light-extract-flat-column-ratio.perf.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/query-light-extract-flat-column-ratio.perf.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/query-storage-trends.perf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-storage-trends.perf.test.d.ts.map

package/dist/__tests__/query-storage-trends.perf.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-storage-trends.perf.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/query-storage-trends.perf.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/query-trs-flat-column-ratio.perf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-trs-flat-column-ratio.perf.test.d.ts.map

package/dist/__tests__/query-trs-flat-column-ratio.perf.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-trs-flat-column-ratio.perf.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/query-trs-flat-column-ratio.perf.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/query.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query.unit.test.d.ts.map

package/dist/__tests__/query.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/query.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/relationship-index.perf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=relationship-index.perf.test.d.ts.map

package/dist/__tests__/relationship-index.perf.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-index.perf.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/relationship-index.perf.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/relationship-index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=relationship-index.test.d.ts.map

package/dist/__tests__/relationship-index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-index.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/relationship-index.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/scalar-field-type-owner.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scalar-field-type-owner.test-d.d.ts.map

package/dist/__tests__/scalar-field-type-owner.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar-field-type-owner.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/scalar-field-type-owner.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/schedule-determinism.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedule-determinism.unit.test.d.ts.map

package/dist/__tests__/schedule-determinism.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-determinism.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schedule-determinism.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schedule-inspection.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedule-inspection.unit.test.d.ts.map

package/dist/__tests__/schedule-inspection.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-inspection.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schedule-inspection.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schedule-scope-error.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedule-scope-error.unit.test.d.ts.map

package/dist/__tests__/schedule-scope-error.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-scope-error.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schedule-scope-error.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schedule-token.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedule-token.unit.test.d.ts.map

package/dist/__tests__/schedule-token.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-token.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schedule-token.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schema-vocab.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-vocab.test-d.d.ts.map

package/dist/__tests__/schema-vocab.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-vocab.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema-vocab.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/serialization.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serialization.unit.test.d.ts.map

package/dist/__tests__/serialization.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/serialization.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/shared-kernel-eligibility.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shared-kernel-eligibility.test-d.d.ts.map

package/dist/__tests__/shared-kernel-eligibility.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-kernel-eligibility.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/shared-kernel-eligibility.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/shared-kernel-eligibility.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shared-kernel-eligibility.unit.test.d.ts.map

package/dist/__tests__/shared-kernel-eligibility.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-kernel-eligibility.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/shared-kernel-eligibility.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/shared-ref-store.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shared-ref-store.unit.test.d.ts.map

package/dist/__tests__/shared-ref-store.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-ref-store.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/shared-ref-store.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sparse-tag.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sparse-tag.unit.test.d.ts.map

package/dist/__tests__/sparse-tag.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparse-tag.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sparse-tag.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/spawn-field-error.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spawn-field-error.test-d.d.ts.map

package/dist/__tests__/spawn-field-error.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-field-error.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/spawn-field-error.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/stale-error.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stale-error.test-d.d.ts.map

package/dist/__tests__/stale-error.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-error.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/stale-error.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/string-view-symmetry.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string-view-symmetry.test-d.d.ts.map

package/dist/__tests__/string-view-symmetry.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-view-symmetry.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/string-view-symmetry.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/string-vocab.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string-vocab.test-d.d.ts.map

package/dist/__tests__/string-vocab.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-vocab.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/string-vocab.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/structure-epoch-boundaries.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=structure-epoch-boundaries.unit.test.d.ts.map

package/dist/__tests__/structure-epoch-boundaries.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-epoch-boundaries.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/structure-epoch-boundaries.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/structure-epoch.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=structure-epoch.unit.test.d.ts.map

package/dist/__tests__/structure-epoch.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-epoch.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/structure-epoch.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/table-archetype-mapping.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=table-archetype-mapping.unit.test.d.ts.map

package/dist/__tests__/table-archetype-mapping.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-archetype-mapping.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/table-archetype-mapping.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/time.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=time.unit.test.d.ts.map

package/dist/__tests__/time.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/time.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/types.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.test-d.d.ts.map

package/dist/__tests__/types.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/types.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/unique-ref-store.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=unique-ref-store.unit.test.d.ts.map

package/dist/__tests__/unique-ref-store.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique-ref-store.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/unique-ref-store.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/utils/handle-numeric.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Unwrap a phantom-branded numeric id (`Handle<T, M>`, `Entity`,
+ * `SceneInstanceId`, ...) to its underlying `number` representation. Used
+ * by test fixtures that need to compare brand-erased numeric values via
+ * `Object.is` / `===`.
+ *
+ * The constraint `H extends number` keeps the helper aligned with the
+ * brand idiom (`number & {brand}`) used throughout the codebase without
+ * coupling to any specific brand class.
+ *
+ * @internal
+ */
+export declare const handleNumeric: <H extends number>(h: H) => number;
+//# sourceMappingURL=handle-numeric.d.ts.map

package/dist/__tests__/utils/handle-numeric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-numeric.d.ts","sourceRoot":"","sources":["../../../src/__tests__/utils/handle-numeric.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,EAAE,GAAG,CAAC,KAAG,MAAmB,CAAC"}

package/dist/__tests__/validation-root-surface.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation-root-surface.unit.test.d.ts.map

package/dist/__tests__/validation-root-surface.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-root-surface.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/validation-root-surface.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/visibility-atomic-write.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=visibility-atomic-write.unit.test.d.ts.map

package/dist/__tests__/visibility-atomic-write.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility-atomic-write.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/visibility-atomic-write.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/world-change-journal.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-change-journal.unit.test.d.ts.map

package/dist/__tests__/world-change-journal.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-change-journal.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/world-change-journal.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/world-characterization.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-characterization.unit.test.d.ts.map

package/dist/__tests__/world-characterization.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-characterization.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/world-characterization.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/world-consumer-inference.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-consumer-inference.test-d.d.ts.map

package/dist/__tests__/world-consumer-inference.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-consumer-inference.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/world-consumer-inference.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/world-health.contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-health.contract.test.d.ts.map

package/dist/__tests__/world-health.contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-health.contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/world-health.contract.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/world-inspection.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-inspection.test.d.ts.map

package/dist/__tests__/world-inspection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-inspection.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/world-inspection.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/world-internal-identity.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-internal-identity.unit.test.d.ts.map

package/dist/__tests__/world-internal-identity.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-internal-identity.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/world-internal-identity.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/world-managed-roundtrip.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-managed-roundtrip.unit.test.d.ts.map

package/dist/__tests__/world-managed-roundtrip.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-managed-roundtrip.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/world-managed-roundtrip.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/world-scheduling.m4.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-scheduling.m4.test.d.ts.map

package/dist/__tests__/world-scheduling.m4.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-scheduling.m4.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/world-scheduling.m4.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/world-unique-roundtrip.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-unique-roundtrip.unit.test.d.ts.map

package/dist/__tests__/world-unique-roundtrip.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-unique-roundtrip.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/world-unique-roundtrip.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/world.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world.test-d.d.ts.map

package/dist/__tests__/world.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/world.test-d.ts"],"names":[],"mappings":""}

package/dist/buffer-pool.d.ts

@@ -0,0 +1,109 @@
+import { type Result } from '@forgeax/engine-types';
+import { ManagedBufferOutOfBoundsError, ManagedBufferShrinkNotSupportedError } from './errors';
+/**
+ * Size-class bucket boundaries in bytes (D-5, radix 4). Frozen tuple - the
+ * order is load-bearing: bucket index = ascending position in the array.
+ *
+ * `alloc(byteLength)` rounds up to `SIZE_CLASSES[i]` for the smallest `i`
+ * with `byteLength <= SIZE_CLASSES[i]`. byteLength === 0 is the special path
+ * (no bucket); byteLength > SIZE_CLASSES[7] (262_144) returns
+ * `managed-buffer-out-of-bounds`.
+ */
+export declare const SIZE_CLASSES: readonly number[];
+/** Result envelope for a fresh alloc - id + initial view. */
+export interface BufferAllocResult {
+    /** Stable slot id; archetype columns store this u32 in their `buffer:<N>` field. */
+    readonly id: number;
+    /** Live Uint8Array view of length `byteLength` (D-5 rounding visible only via `view.buffer.byteLength`). */
+    readonly view: Uint8Array;
+}
+/**
+ * Per-(slot id) managed Uint8Array store backing the `buffer:<bytes>` schema
+ * vocab keyword. Eight size-class free-lists (radix 4); cross-bucket growth
+ * uses `ArrayBuffer.transfer` when available with a copy fallback for older
+ * runtimes.
+ *
+ * AI users do not interact with `BufferPool` directly - it sits behind
+ * `world.get(e, C).<bufferField>` and the M4 carry-over migrate path. The
+ * pool is exposed as a class so World can hold one instance per
+ * `new World()` (D-2 per-World lifecycle).
+ */
+export declare class BufferPool {
+    private readonly slots;
+    /**
+     * Per-bucket free-lists: `freeBuckets[i]` is a LIFO stack of slot ids
+     * whose backing buffer is parked on bucket `i`. Released slots stay on
+     * their original bucket's free-list - v1 never moves a slot between
+     * buckets on release (D-7 no trim).
+     */
+    private readonly freeBuckets;
+    private nextId;
+    /**
+     * Allocate a managed buffer slot of at least `byteLength` bytes.
+     *
+     * Routes:
+     *   - byteLength < 0  -> not in current contract (caller responsibility).
+     *   - byteLength == 0 -> ok({ id, view: zero-length Uint8Array }) (no bucket).
+     *   - byteLength <= 262144 -> ok({ id, view }), bucket = smallest >= byteLength.
+     *   - byteLength  > 262144 -> err(managed-buffer-out-of-bounds).
+     *
+     * D-5: size classes are radix-4 (16 / 64 / 256 / 1K / 4K / 16K / 64K / 256K).
+     * Free-list pop reuses the most recently released slot id at the same bucket;
+     * miss falls through to a fresh allocation.
+     */
+    alloc(byteLength: number): Result<BufferAllocResult, ManagedBufferOutOfBoundsError>;
+    /**
+     * Grow slot `id` to `newBytes`. Returns the post-grow Uint8Array view.
+     *
+     * Routes (D-6 / D-7):
+     *   - newBytes < current  -> err(managed-buffer-shrink-not-supported).
+     *   - newBytes == current -> ok(current view) (no-op, identity preserved).
+     *   - newBytes > current && same bucket -> ok(re-sliced view) (no transfer).
+     *   - newBytes > current && cross bucket -> ok(new view) backed by a fresh
+     *     bucket buffer; the prior ArrayBuffer is detached via transfer (ES2024)
+     *     or replaced via allocate-and-copy fallback. Old `view`s captured by
+     *     the caller become detached / orphaned - callers must use `pool.view(id)`
+     *     after grow to read the refreshed view (the `release` loop refreshes
+     *     automatically).
+     *   - newBytes > 262144 -> err(managed-buffer-out-of-bounds).
+     */
+    grow(id: number, newBytes: number): Result<Uint8Array, ManagedBufferShrinkNotSupportedError | ManagedBufferOutOfBoundsError>;
+    /**
+     * Release slot `id` back to its bucket's free-list. Releasing an unknown id
+     * is a no-op - World's release loop drives this and idempotency keeps the
+     * despawn chain free of bookkeeping noise. Bucket free-lists are NEVER
+     * trimmed in v1 (D-7 no trim).
+     */
+    release(id: number): Result<void, never>;
+    /**
+     * Return the live view for slot `id`. Used by World after `grow` to
+     * refresh the column's stored view reference. Returns a zero-length view
+     * for unknown / released ids so callers never crash on use-after-release.
+     */
+    view(id: number): Uint8Array;
+    /**
+     * Return the bucket-rounded byte capacity for slot `id` --- i.e.
+     * `SIZE_CLASSES[slot.sizeClassIdx]`. Used by managed-buffer view callers
+     * (D-4 no-cache: re-queried per accessor). Returns `0` for the zero-length
+     * (`alloc(0)`) slot; returns `0` for unknown / released ids (mirrors
+     * `view(id)` use-after-release semantics).
+     */
+    byteCapacity(id: number): number;
+    /**
+     * Reset the logical byteLength of slot `id` to `newByteLength` while
+     * keeping the same bucket allocation (no transfer, no release). Only
+     * legal when `newByteLength <= bucketBytes`; the slot's bucket index
+     * does not move (D-7 v1 forbids cross-bucket shrink). Used by managed-
+     * buffer clear paths so the slot retains its `byteCapacity` while the
+     * live view becomes zero-length. Bytes past the new logical length are
+     * zero-filled defensively.
+     *
+     * Returns `err(ManagedBufferShrinkNotSupportedError)` when called on a
+     * `sizeClassIdx === -1` slot (alloc(0)) with `newByteLength > 0`, or
+     * when `newByteLength` exceeds the bucket capacity.
+     */
+    setLogicalLength(id: number, newByteLength: number): Result<Uint8Array, ManagedBufferShrinkNotSupportedError | ManagedBufferOutOfBoundsError>;
+    /** @internal Diagnostic count of live slots. Exposed for tests + inspector. */
+    _liveCount(): number;
+}
+//# sourceMappingURL=buffer-pool.d.ts.map

package/dist/buffer-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-pool.d.ts","sourceRoot":"","sources":["../src/buffer-pool.ts"],"names":[],"mappings":"AA2CA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,6BAA6B,EAAE,oCAAoC,EAAE,MAAM,UAAU,CAAC;AAE/F;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAExC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4GAA4G;IAC5G,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAyCD;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsD;IAClF,OAAO,CAAC,MAAM,CAAK;IAEnB;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,CAAC;IAoDnF;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,UAAU,EAAE,oCAAoC,GAAG,6BAA6B,CAAC;IAgD3F;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;IAgBxC;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU;IAM5B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAOhC;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,EAAE,EAAE,MAAM,EACV,aAAa,EAAE,MAAM,GACpB,MAAM,CAAC,UAAU,EAAE,oCAAoC,GAAG,6BAA6B,CAAC;IA4B3F,+EAA+E;IAC/E,UAAU,IAAI,MAAM;CAKrB"}

package/dist/commands.d.ts

@@ -0,0 +1,93 @@
+import type { Result } from '@forgeax/engine-types';
+import type { Component, ComponentSchema } from './component';
+import { type EntityHandle } from './entity-handle';
+import { type CommandKind } from './errors';
+import type { ComponentData, EcsError } from './world';
+import { type WorldInternal, worldInternal } from './world-internal';
+export type Command = {
+    type: 'spawn';
+    componentDatas: ComponentData[];
+    entity: EntityHandle;
+} | {
+    type: 'despawn';
+    entity: EntityHandle;
+} | {
+    type: 'addComponent';
+    entity: EntityHandle;
+    componentData: ComponentData;
+} | {
+    type: 'removeComponent';
+    entity: EntityHandle;
+    component: Component;
+};
+/**
+ * CommandBuffer queues structural changes (spawn/despawn/addComponent/removeComponent)
+ * during system execution. Flushed at end of world.update().
+ */
+export interface CommandBuffer {
+    readonly status: 'open' | 'committed' | 'aborted';
+    /** Deferred spawn: returns pending Entity handle. */
+    spawn(...componentDatas: ComponentData[]): EntityHandle;
+    /** Deferred despawn. */
+    despawn(entity: EntityHandle): unknown;
+    /** Deferred addComponent. */
+    addComponent<S extends ComponentSchema>(entity: EntityHandle, componentData: ComponentData<S>): unknown;
+    /** Deferred removeComponent. */
+    removeComponent<S extends ComponentSchema>(entity: EntityHandle, component: Component<string, S>): unknown;
+    /** Check if an entity is pending (deferred spawn, not yet flushed). */
+    isDeferred(entity: EntityHandle): boolean;
+    commit(): void;
+    abort(error?: unknown): void;
+}
+/** Minimal world interface needed by CommandBuffer for entity allocation. */
+export interface WorldForCommands {
+    readonly [worldInternal]: WorldInternal;
+    /**
+     * Allocate a pending entity index, returning [entity handle, index slot].
+     * @internal
+     */
+    /**
+     * Mark a pending entity as materialized (flush phase).
+     * @internal
+     */
+    /** Execute despawn directly (flush phase). */
+    despawn(entity: EntityHandle): Result<void, EcsError>;
+    /** Execute addComponent directly (flush phase). */
+    addComponent<S extends ComponentSchema>(entity: EntityHandle, componentData: ComponentData<S>): Result<void, EcsError>;
+    /** Execute removeComponent directly (flush phase). */
+    removeComponent<S extends ComponentSchema>(entity: EntityHandle, component: Component<string, S>): Result<void, EcsError>;
+    /** Fast membership probe used by command preflight. */
+    hasComponent(entity: EntityHandle, component: Component): boolean;
+}
+export interface CommandBufferImpl extends CommandBuffer {
+    /** @internal */
+    _queue: Command[];
+    /** @internal */
+    _pendingEntities: Set<number>;
+    /** @internal First validation failure captured while the system was staging commands. */
+    _queueError: {
+        readonly index: number;
+        readonly kind: CommandKind;
+        readonly cause: unknown;
+    } | null;
+    /** @internal */
+    readonly _systemName: string;
+    /** @internal */
+    readonly _scheduleName: string;
+    /** @internal */
+    _setStatus(status: 'committed' | 'aborted'): void;
+}
+/**
+ * Create a CommandBuffer bound to a World.
+ * @param world - the World (for pending entity allocation)
+ */
+export declare function createCommandBuffer(world: WorldForCommands, context?: {
+    readonly systemName?: string;
+    readonly scheduleName?: string;
+}): CommandBufferImpl;
+/**
+ * Flush all queued commands against the World.
+ * Uses while(queue.length > 0) to support cascade (commands spawned during flush).
+ */
+export declare function flushCommands(buffer: CommandBufferImpl, world: WorldForCommands): void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

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