@forgeax/engine-ecs 0.1.26 → 0.1.28

package/dist/world-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-read.d.ts","sourceRoot":"","sources":["../src/world-read.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,oEAAoE;AACpE,eAAO,MAAM,SAAS,EAAE,OAAO,MAEC,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,aAAa,EAAE,CACtB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,KACd,MAAM,GAAG,SAAS,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,CACvB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,KACd,MAAM,GAAG,SAAS,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,CACxB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,KACV,MAAM,GAAG,SAAS,CAAC;CACzB"}

package/dist/world-read.mjs

@@ -0,0 +1,8 @@
+// src/world-read.ts
+var worldRead = /* @__PURE__ */ Symbol.for(
+  "forgeax.ecs.worldRead"
+);
+
+export { worldRead };
+//# sourceMappingURL=world-read.mjs.map
+//# sourceMappingURL=world-read.mjs.map

package/dist/world-read.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/world-read.ts"],"names":[],"mappings":";AAUO,IAAM,4BAA2B,MAAA,CAAO,GAAA;AAAA,EAC7C;AACF","file":"world-read.mjs","sourcesContent":["// @forgeax/engine-ecs — safe read-only World seam.\n//\n// This is the only cross-package World capability needed by relationship and\n// scene projections. It exposes semantic scalar/array reads, never the table,\n// archetype, buffer-pool, or mutation stores behind those reads.\n\nimport type { Component } from './component';\nimport type { EntityHandle } from './entity-handle';\n\n/** Stable identity for the World-owned semantic read capability. */\nexport const worldRead: unique symbol = Symbol.for(\n  'forgeax.ecs.worldRead',\n) as unknown as typeof worldRead;\n\n/**\n * Read-only semantic probes used by owner packages such as scene.\n *\n * Missing entities, components, fields, and out-of-range elements return\n * `undefined`; callers never receive a storage object or mutable view.\n */\nexport interface WorldRead {\n  readonly getFieldValue: (\n    entity: EntityHandle,\n    component: Component,\n    fieldName: string,\n  ) => number | undefined;\n  readonly getArrayLength: (\n    entity: EntityHandle,\n    component: Component,\n    fieldName: string,\n  ) => number | undefined;\n  readonly getArrayElement: (\n    entity: EntityHandle,\n    component: Component,\n    fieldName: string,\n    index: number,\n  ) => number | undefined;\n}\n"]}

package/dist/world-scheduling.d.ts

@@ -1,4 +1,3 @@
-import type { Handle } from '@forgeax/engine-types';
 import { type Result } from '@forgeax/engine-types';
 import { CommandFailedError, CyclicDependencyError, ScheduleScopeMismatchError, SystemFailedError, type SystemSetNotRegisteredError, TimeConfigInvalidError, TimeDeltaInvalidError } from './errors';
 import { SharedKernelFailureError, WorldPoisonedError } from './execution/shared-kernel';
@@ -23,8 +22,5 @@ export declare function worldInspect(world: World): WorldInspection;
 export declare function worldScheduleData(world: World): ReadonlyArray<WorldScheduleData>;
 /** Control-plane guard used before releasing a World-local component registration. */
 export declare function worldScheduleUsesComponent(world: World, component: object): boolean;
-export declare function worldAllocUniqueRef<Target extends string, T>(world: World, target: Target, payload: T, onRelease?: (payload: T) => void): Handle<Target, 'unique'>;
-export declare function worldAllocSharedRef<Target extends string, T>(world: World, target: Target, payload: T): Handle<Target, 'shared'>;
-export declare function worldInternSharedRef<Target extends string, T extends object>(world: World, target: Target, payload: T): Handle<Target, 'shared'>;
 export {};
 //# sourceMappingURL=world-scheduling.d.ts.map

package/dist/world-scheduling.d.ts.map

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

package/dist/world-storage-primitives.d.ts

@@ -0,0 +1,26 @@
+import { type ManagedArrayElementType } from './component';
+/** Freeze the detached POD produced by World.inspect(). */
+export declare function detachWorldInspection<T extends object>(snapshot: T): Readonly<T>;
+/**
+ * Element-byte-width for a managed-array element type, read off the global
+ * TYPE_METADATA table (single SSOT). `entity` stores as `u32` (4 bytes); every
+ * scalar maps to its own key. `fieldTypeToMetaKey` always resolves a key for a
+ * ManagedArrayElementType, and every such row carries a concrete `byteSize`.
+ */
+export declare function elementByteSize(elementType: ManagedArrayElementType): number;
+export declare function reinterpretSlotBytes(bytes: Uint8Array, elementType: ManagedArrayElementType, elementCount: number): ReturnType<typeof reinterpretBufferRegion>;
+export declare function reinterpretBufferRegion(buffer: ArrayBufferLike, byteOffset: number, elementType: ManagedArrayElementType, elementCount: number): Float32Array | Float64Array | Int32Array | Uint32Array | Int16Array | Uint16Array | Int8Array | Uint8Array;
+/**
+ * Reinterpret `bytes` as the typed view for `elementType` and write `value`
+ * at element index `idx`. Mirrors the `array<T>` storage law (4/8/2/1-byte
+ * element widths per TYPE_METADATA.byteSize) and is used by `world.push`
+ * to land a new tail element into BufferPool slot bytes after a `grow`.
+ */
+export declare function writeArrayElementAt(bytes: Uint8Array, idx: number, elementType: ManagedArrayElementType, value: number): void;
+/**
+ * Reinterpret `bytes` as the typed view for `elementType` and read element
+ * `idx`. Mirrors `writeArrayElementAt` -- consumed by `world.pop` to materialise
+ * the tail value before the count is decremented.
+ */
+export declare function readArrayElementAt(bytes: Uint8Array, idx: number, elementType: ManagedArrayElementType): number;
+//# sourceMappingURL=world-storage-primitives.d.ts.map

package/dist/world-storage-primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-storage-primitives.d.ts","sourceRoot":"","sources":["../src/world-storage-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,uBAAuB,EAAiB,MAAM,aAAa,CAAC;AAE9F,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAEhF;AAeD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,uBAAuB,GAAG,MAAM,CAI5E;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,uBAAuB,EACpC,YAAY,EAAE,MAAM,GACnB,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAE5C;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,uBAAuB,EACpC,YAAY,EAAE,MAAM,GAElB,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,WAAW,GACX,UAAU,GACV,WAAW,GACX,SAAS,GACT,UAAU,CAmCb;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,uBAAuB,EACpC,KAAK,EAAE,MAAM,GACZ,IAAI,CAkCN;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,uBAAuB,GACnC,MAAM,CAgCR"}