@oasys/oecs 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -0,0 +1,66 @@
+/**
+ * # oecs — archetype Entity Component System for TypeScript
+ *
+ * Re-derived from the oasys engine ECS. A determinism-capable archetype ECS
+ * with a topo-sorted scheduler, system sets + run conditions, per-component
+ * observers, relations (with wildcards), sparse storage, templates, and a
+ * typed host→ECS write seam.
+ *
+ * Storage runs over a backing-neutral column store (`ColumnStore`). The default
+ * profile is **pure-TS heap** — a plain resizable `ArrayBuffer`, so no
+ * `SharedArrayBuffer` and no cross-origin isolation (COOP/COEP) are required.
+ * The opt-in `SharedArrayBuffer` + WASM profile lives at `@oasys/oecs/shared`.
+ *
+ * This entry is the **stable public API**: every name below is an explicit
+ * semver commitment (additions to the internal barrel do not auto-publish).
+ * Codecs, ABI constants, memory inspectors, and dev singletons live at
+ * `@oasys/oecs/internal`, which carries no semver guarantees.
+ *
+ * @module oecs
+ */
+export { ECS, type ECSOptions } from './core/ecs/index.cjs';
+export type { ECSRelations, ECSEvents, ECSResources, ECSSnapshots } from './core/ecs/index.cjs';
+export type { ECSMemoryOptions, EntityBudget, WasmMemoryArm } from './core/ecs/index.cjs';
+export type { Template, TemplateEntry, TemplateEntries, TemplateOverrides } from './core/ecs/index.cjs';
+export type { StoreLayoutListener } from './core/ecs/index.cjs';
+export type { ComputeBackend, BackendSystemHandle } from './core/ecs/index.cjs';
+export { SCHEDULE, type SystemEntry, type SystemOrdering, type SystemOrderingTarget, systemSet, type SystemSet, type SystemSetConfig } from './core/ecs/index.cjs';
+export { type RunCondition, type ConditionContext, runIfResourceEq, runEveryNTicks, runIfAnyMatch, not, allOf, anyOf } from './core/ecs/index.cjs';
+export { SystemContext } from './core/ecs/index.cjs';
+export type { SystemFn, SystemConfig, SystemDescriptor, SystemAccessConfig, SystemAccessDeclaration, SystemTransition } from './core/ecs/index.cjs';
+export type { SystemAccess, DeclaredAccess, TypedSystemConfig, DeclaredRead, DeclaredWrite, DeclaredAdd, DeclaredRemove, DeclaredSparseRead, DeclaredSparseWrite, DeclaredRelationRead, DeclaredRelationWrite, DeclaredResourceRead, DeclaredResourceWrite, DespawnArg, DeclaredBundleOrDef, DenseAccessDecl, SpawnsAccessDecl, DespawnsAccessDecl, TransitionsAccessDecl, SparseAccessDecl, RelationsAccessDecl, ResourcesAccessDecl } from './core/ecs/index.cjs';
+export type { ObserverConfig, ObserverHandle, ObserverFn, ArchetypeObserverFn, StructuralObserverConfig, EntitySetObserverConfig, ArchetypeSetObserverConfig } from './core/ecs/index.cjs';
+export { installHostCommandSeam, uninstallHostCommandSeam, applyHostCommand, HostCommandQueue, spawnEntry } from './core/ecs/index.cjs';
+export type { HostCommand, SpawnEntry, SpawnEntryFor, SpawnEntries, HostCommandSeamOptions, HostCommandSink } from './core/ecs/index.cjs';
+export { HostCommandRecorder, serializeCommandLog, deserializeCommandLog, replayCommandLog } from './core/ecs/index.cjs';
+export type { CommandLog, RecordedTick, ReplayResult, ReplayOptions } from './core/ecs/index.cjs';
+export { FrameTraceRecorder } from './core/ecs/index.cjs';
+export type { FrameTraceSink, FrameTrace, FrameTraceEvent, StructuralOp, ObserverOp } from './core/ecs/index.cjs';
+export { FrameStepper } from './core/ecs/index.cjs';
+export type { FrameStepperOptions } from './core/ecs/index.cjs';
+export { ECSRestoreError, ECS_SNAPSHOT_VERSION } from './core/ecs/index.cjs';
+export { StoreRestoreError } from './core/store/index.cjs';
+export type { ComponentRef, ReadonlyComponentRef } from './core/ecs/index.cjs';
+export { Query, QueryBuilder, ChangedQuery, HIERARCHY_UNBOUNDED } from './core/ecs/index.cjs';
+export type { HierarchyTerm } from './core/ecs/index.cjs';
+export { ChunkColumns, Commands } from './core/ecs/index.cjs';
+export type { ArchetypeView, ArchetypeID } from './core/ecs/index.cjs';
+export type { EntityID, ReadonlyEntityIdArray } from './core/ecs/index.cjs';
+export { getEntityIndex } from './core/ecs/index.cjs';
+export type { TypedArrayTag } from './type_primitives/index.cjs';
+export type { ComponentDef, ComponentHandle, ComponentRegisterOptions, ComponentSchema, SchemaOf, DeclaredQueryTerm, FieldValues, CompleteFieldValues, ValuesArg, AttachValuesArg, TagToTypedArray, ColumnsForSchema, MutableColumnsForSchema, ReadonlyColumn, ReadonlyUint32Array } from './core/ecs/index.cjs';
+export { bundle } from './core/ecs/index.cjs';
+export type { Bundle, BundleOrDef } from './core/ecs/index.cjs';
+export type { SparseComponentDef, SparseComponentID, SparseSchemaOf } from './core/ecs/index.cjs';
+export { SparseRestoreError } from './core/ecs/index.cjs';
+export type { RelationDef, RelationID, RelationCardinality, RelationOptions, OnDeleteTarget } from './core/ecs/index.cjs';
+export { ANY_RELATION } from './core/ecs/index.cjs';
+export { registerIsA, registerChildOf, type BuiltinRelationOptions } from './core/ecs/index.cjs';
+export type { EventReader, EventKey, EventSchema, EventShape, EventFieldsCover, EmptyEventSchema, SignalKey } from './core/ecs/index.cjs';
+export { eventKey, signalKey } from './core/ecs/index.cjs';
+export type { ResourceKey, ResourceValueOf } from './core/ecs/index.cjs';
+export { resourceKey } from './core/ecs/index.cjs';
+export { ECSError, ECS_ERROR, isEcsError } from './core/ecs/index.cjs';
+export { SabUnavailableError } from './core/store/index.cjs';
+export { VERSION } from './version.cjs';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -11,7 +11,56 @@
  * `SharedArrayBuffer` and no cross-origin isolation (COOP/COEP) are required.
  * The opt-in `SharedArrayBuffer` + WASM profile lives at `@oasys/oecs/shared`.
  *
+ * This entry is the **stable public API**: every name below is an explicit
+ * semver commitment (additions to the internal barrel do not auto-publish).
+ * Codecs, ABI constants, memory inspectors, and dev singletons live at
+ * `@oasys/oecs/internal`, which carries no semver guarantees.
+ *
  * @module oecs
  */
-export * from './core/ecs';
+export { ECS, type ECSOptions } from './core/ecs/index.js';
+export type { ECSRelations, ECSEvents, ECSResources, ECSSnapshots } from './core/ecs/index.js';
+export type { ECSMemoryOptions, EntityBudget, WasmMemoryArm } from './core/ecs/index.js';
+export type { Template, TemplateEntry, TemplateEntries, TemplateOverrides } from './core/ecs/index.js';
+export type { StoreLayoutListener } from './core/ecs/index.js';
+export type { ComputeBackend, BackendSystemHandle } from './core/ecs/index.js';
+export { SCHEDULE, type SystemEntry, type SystemOrdering, type SystemOrderingTarget, systemSet, type SystemSet, type SystemSetConfig } from './core/ecs/index.js';
+export { type RunCondition, type ConditionContext, runIfResourceEq, runEveryNTicks, runIfAnyMatch, not, allOf, anyOf } from './core/ecs/index.js';
+export { SystemContext } from './core/ecs/index.js';
+export type { SystemFn, SystemConfig, SystemDescriptor, SystemAccessConfig, SystemAccessDeclaration, SystemTransition } from './core/ecs/index.js';
+export type { SystemAccess, DeclaredAccess, TypedSystemConfig, DeclaredRead, DeclaredWrite, DeclaredAdd, DeclaredRemove, DeclaredSparseRead, DeclaredSparseWrite, DeclaredRelationRead, DeclaredRelationWrite, DeclaredResourceRead, DeclaredResourceWrite, DespawnArg, DeclaredBundleOrDef, DenseAccessDecl, SpawnsAccessDecl, DespawnsAccessDecl, TransitionsAccessDecl, SparseAccessDecl, RelationsAccessDecl, ResourcesAccessDecl } from './core/ecs/index.js';
+export type { ObserverConfig, ObserverHandle, ObserverFn, ArchetypeObserverFn, StructuralObserverConfig, EntitySetObserverConfig, ArchetypeSetObserverConfig } from './core/ecs/index.js';
+export { installHostCommandSeam, uninstallHostCommandSeam, applyHostCommand, HostCommandQueue, spawnEntry } from './core/ecs/index.js';
+export type { HostCommand, SpawnEntry, SpawnEntryFor, SpawnEntries, HostCommandSeamOptions, HostCommandSink } from './core/ecs/index.js';
+export { HostCommandRecorder, serializeCommandLog, deserializeCommandLog, replayCommandLog } from './core/ecs/index.js';
+export type { CommandLog, RecordedTick, ReplayResult, ReplayOptions } from './core/ecs/index.js';
+export { FrameTraceRecorder } from './core/ecs/index.js';
+export type { FrameTraceSink, FrameTrace, FrameTraceEvent, StructuralOp, ObserverOp } from './core/ecs/index.js';
+export { FrameStepper } from './core/ecs/index.js';
+export type { FrameStepperOptions } from './core/ecs/index.js';
+export { ECSRestoreError, ECS_SNAPSHOT_VERSION } from './core/ecs/index.js';
+export { StoreRestoreError } from './core/store/index.js';
+export type { ComponentRef, ReadonlyComponentRef } from './core/ecs/index.js';
+export { Query, QueryBuilder, ChangedQuery, HIERARCHY_UNBOUNDED } from './core/ecs/index.js';
+export type { HierarchyTerm } from './core/ecs/index.js';
+export { ChunkColumns, Commands } from './core/ecs/index.js';
+export type { ArchetypeView, ArchetypeID } from './core/ecs/index.js';
+export type { EntityID, ReadonlyEntityIdArray } from './core/ecs/index.js';
+export { getEntityIndex } from './core/ecs/index.js';
+export type { TypedArrayTag } from './type_primitives/index.js';
+export type { ComponentDef, ComponentHandle, ComponentRegisterOptions, ComponentSchema, SchemaOf, DeclaredQueryTerm, FieldValues, CompleteFieldValues, ValuesArg, AttachValuesArg, TagToTypedArray, ColumnsForSchema, MutableColumnsForSchema, ReadonlyColumn, ReadonlyUint32Array } from './core/ecs/index.js';
+export { bundle } from './core/ecs/index.js';
+export type { Bundle, BundleOrDef } from './core/ecs/index.js';
+export type { SparseComponentDef, SparseComponentID, SparseSchemaOf } from './core/ecs/index.js';
+export { SparseRestoreError } from './core/ecs/index.js';
+export type { RelationDef, RelationID, RelationCardinality, RelationOptions, OnDeleteTarget } from './core/ecs/index.js';
+export { ANY_RELATION } from './core/ecs/index.js';
+export { registerIsA, registerChildOf, type BuiltinRelationOptions } from './core/ecs/index.js';
+export type { EventReader, EventKey, EventSchema, EventShape, EventFieldsCover, EmptyEventSchema, SignalKey } from './core/ecs/index.js';
+export { eventKey, signalKey } from './core/ecs/index.js';
+export type { ResourceKey, ResourceValueOf } from './core/ecs/index.js';
+export { resourceKey } from './core/ecs/index.js';
+export { ECSError, ECS_ERROR, isEcsError } from './core/ecs/index.js';
+export { SabUnavailableError } from './core/store/index.js';
+export { VERSION } from './version.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}