@forgeax/engine-ecs 0.1.2

package/dist/world-internal.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ECS package-internal World seam.
+ *
+ * This module is intentionally not re-exported by the package entry points.
+ * It keeps implementation access out of World's discoverable API while
+ * retaining direct bound calls for the hot query and structural paths.
+ */
+export declare const worldInternal: unique symbol;
+type InternalName = 'addComponentCore' | 'allocateIndex' | 'allocatePendingEntity' | 'cancelPendingEntity' | 'despawnCore' | 'getArrayView' | 'getBufferPool' | 'getChangeCursor' | 'getClockWriter' | 'getComponentChange' | 'getComponentMutationEpoch' | 'getEntityArchetype' | 'getFixedAccumulator' | 'getFreeIndices' | 'getGraph' | 'getMutationEpoch' | 'getQueryRow' | 'getRecords' | 'getRelationshipEpoch' | 'getRelationshipTargetEntities' | 'getResources' | 'getSchedule' | 'getSchedules' | 'getSharedRefs' | 'getStructureEpoch' | 'getUniqueRefs' | 'lookupAlive' | 'markComponentAdded' | 'markComponentChanged' | 'markComponentRangeChanged' | 'markComponentsAdded' | 'markDerivedComponentChanges' | 'markStructureChanged' | 'materializePendingEntity' | 'nextMutationEpoch' | 'poisonExecution' | 'preflightComponentData' | 'readChangesSince' | 'readRow' | 'recordIsLive' | 'relationshipOnInsert' | 'relationshipOnRemove' | 'releaseManagedRefsOnRow' | 'removeComponentChange' | 'removeComponentCore' | 'removeEntityChanges' | 'routeError' | 'setFixedAccumulator' | 'setQueryRow' | 'spawnCore' | 'writeEntitySelf' | 'writeRow';
+export type WorldInternal = {
+    readonly [K in InternalName]: (...args: any[]) => any;
+};
+export {};
+//# sourceMappingURL=world-internal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"world-internal.d.ts","sourceRoot":"","sources":["../src/world-internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,eAAO,MAAM,aAAa,EAAE,OAAO,MAEC,CAAC;AAErC,KAAK,YAAY,GACb,kBAAkB,GAClB,eAAe,GACf,uBAAuB,GACvB,qBAAqB,GACrB,aAAa,GACb,cAAc,GACd,eAAe,GACf,iBAAiB,GACjB,gBAAgB,GAChB,oBAAoB,GACpB,2BAA2B,GAC3B,oBAAoB,GACpB,qBAAqB,GACrB,gBAAgB,GAChB,UAAU,GACV,kBAAkB,GAClB,aAAa,GACb,YAAY,GACZ,sBAAsB,GACtB,+BAA+B,GAC/B,cAAc,GACd,aAAa,GACb,cAAc,GACd,eAAe,GACf,mBAAmB,GACnB,eAAe,GACf,aAAa,GACb,oBAAoB,GACpB,sBAAsB,GACtB,2BAA2B,GAC3B,qBAAqB,GACrB,6BAA6B,GAC7B,sBAAsB,GACtB,0BAA0B,GAC1B,mBAAmB,GACnB,iBAAiB,GACjB,wBAAwB,GACxB,kBAAkB,GAClB,SAAS,GACT,cAAc,GACd,sBAAsB,GACtB,sBAAsB,GACtB,yBAAyB,GACzB,uBAAuB,GACvB,qBAAqB,GACrB,qBAAqB,GACrB,YAAY,GACZ,qBAAqB,GACrB,aAAa,GACb,WAAW,GACX,iBAAiB,GACjB,UAAU,CAAC;AAEf,MAAM,MAAM,aAAa,GAAG;IAE1B,QAAQ,EAAE,CAAC,IAAI,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;CACtD,CAAC"}

package/dist/world-scheduling.d.ts

@@ -0,0 +1,30 @@
+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';
+import type { QueryDescriptor } from './query/query';
+import { type SystemDescriptor, type SystemSet, removeSystem as scheduleRemoveSystem, replaceSystem as scheduleReplaceSystem } from './schedule';
+import { type ScheduleToken } from './schedule-token';
+import type { World, WorldInspection, WorldScheduleData } from './world';
+type ResourceKey = string | {
+    readonly name: string;
+};
+export declare function worldAddSystem<const Qs extends ReadonlyArray<QueryDescriptor>>(world: World, token: ScheduleToken, descriptor: SystemDescriptor<Qs>): Result<void, ScheduleScopeMismatchError>;
+export declare function worldRemoveSystem(world: World, token: ScheduleToken, name: string): ReturnType<typeof scheduleRemoveSystem> | Result<never, ScheduleScopeMismatchError>;
+export declare function worldReplaceSystem<const Qs extends ReadonlyArray<QueryDescriptor>>(world: World, token: ScheduleToken, name: string, descriptor: SystemDescriptor<Qs>): ReturnType<typeof scheduleReplaceSystem> | Result<never, ScheduleScopeMismatchError>;
+export declare function worldAddSystems<const Qs extends ReadonlyArray<QueryDescriptor>>(world: World, token: ScheduleToken, set: SystemSet, systems: ReadonlyArray<SystemDescriptor<Qs>>): Result<void, SystemSetNotRegisteredError | ScheduleScopeMismatchError>;
+export declare function worldUpdate(world: World, deltaSeconds?: number): Result<void, TimeDeltaInvalidError | TimeConfigInvalidError | ScheduleScopeMismatchError | WorldPoisonedError | CommandFailedError | SystemFailedError | CyclicDependencyError | SharedKernelFailureError>;
+export declare function worldInsertResource<T>(world: World, key: ResourceKey, value: T): void;
+export declare function worldGetResource<T>(world: World, key: ResourceKey): T;
+export declare function worldHasResource(world: World, key: ResourceKey): boolean;
+export declare function worldRemoveResource(world: World, key: ResourceKey): void;
+export declare function worldInspect(world: World): WorldInspection;
+/** Project schedule registration into a JSON-safe graph for tooling and AI inspection. */
+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

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