@oasys/oecs 0.5.3 → 0.6.0

package/dist/core/ecs/access_check.d.cts

@@ -17,58 +17,58 @@ interface AccessSets {
     relationWrites: Set<number>;
 }
 declare function setsFor(desc: SystemDescriptor): AccessSets;
-/** The reads-only access surface a run condition declares (#576). A condition
- * can only `reads` components (via a captured query) and `resourceReads`; every
+/** The reads-only access surface a run condition declares. A condition
+ * can only `reads` components (via a captured query) and `resourceReads`. Every
  * mutation set is empty by construction, so the same `check_*` machinery rejects
- * any write/structural/resource-write a misbehaving predicate attempts. */
+ * any write, structural or resource-write a misbehaving predicate attempts. */
 interface ConditionAccess {
     readonly name: string;
     readonly reads?: readonly ComponentDef[];
     readonly resourceReads?: readonly ResourceKey<any>[];
 }
 declare class AccessCheck {
-    private active;
-    private sets;
-    private activeName;
-    private exclusive;
+    private _activeSystem;
+    private _activeSets;
+    private _activeName;
+    private _exclusive;
     enter(desc: SystemDescriptor): void;
-    /** Open a reads-only span for a run condition (#576). No descriptor — a
+    /** Open a reads-only span for a run condition. No descriptor, a
      * condition can gate a whole SystemSet, so it isn't attributable to one
-     * system — just its declared reads/resource_reads and a name for diagnostics.
+     * system, only its declared `reads` and `resourceReads` and a name for diagnostics.
      * Paired with `leave()`. */
     enterCondition(cond: ConditionAccess): void;
     leave(): void;
     isActive(): boolean;
     /** Current system descriptor, if any. Null during a run-condition span. */
     current(): SystemDescriptor | null;
-    checkRead(def: ComponentHandle): void;
-    checkWrite(def: ComponentHandle): void;
-    checkAdd(def: ComponentHandle): void;
-    checkRemove(def: ComponentHandle): void;
-    checkDestroy(): void;
-    checkResourceRead(key: ResourceKey<any>): void;
-    checkResourceWrite(key: ResourceKey<any>): void;
-    checkSparseRead(def: SparseComponentDef): void;
-    checkSparseWrite(def: SparseComponentDef): void;
-    checkRelationRead(def: RelationDef): void;
-    checkRelationWrite(def: RelationDef): void;
-    /** A `(*, T)` wildcard (`Query.forEachRelatedTo`, #579) reads every
-     * relation's reverse index, so it can't name a specific relation — it is
+    assertRead(def: ComponentHandle): void;
+    assertWrite(def: ComponentHandle): void;
+    assertAdd(def: ComponentHandle): void;
+    assertRemove(def: ComponentHandle): void;
+    assertDespawn(): void;
+    assertResourceRead(key: ResourceKey<any>): void;
+    assertResourceWrite(key: ResourceKey<any>): void;
+    assertSparseRead(def: SparseComponentDef): void;
+    assertSparseWrite(def: SparseComponentDef): void;
+    assertRelationRead(def: RelationDef): void;
+    assertRelationWrite(def: RelationDef): void;
+    /** A `(*, T)` wildcard (`Query.forEachRelatedTo`) reads every
+     * relation's reverse index, so it can't name a specific relation. It is
      * authorised by the `ANY_RELATION` sentinel in `relationReads`. Honoured here
-     * exactly like a per-relation read, just keyed on the reserved sentinel id
+     * exactly like a per-relation read, only keyed on the reserved sentinel id
      * (which computeSets folds into `relationReads` like any other entry). */
-    checkRelationReadAny(): void;
-    private optionalScopes;
+    assertRelationReadAny(): void;
+    private _optionalScopes;
     enterOptionalScope(optional: readonly number[]): void;
     leaveOptionalScope(): void;
-    checkOptionalFetch(def: ComponentHandle): void;
-    private failComponent;
-    private failSparse;
-    private failRelation;
-    private failResource;
+    assertOptionalFetch(def: ComponentHandle): void;
+    private _failComponent;
+    private _failSparse;
+    private _failRelation;
+    private _failResource;
 }
 export declare const accessCheck: AccessCheck;
-/** @internal — test seam for unit tests that need a fresh tracker. */
+/** @internal, test seam for unit tests that need a fresh tracker. */
 export declare const _accessCheckInternals: {
     create: () => AccessCheck;
     setsFor: typeof setsFor;

package/dist/core/ecs/access_check.d.ts

@@ -17,58 +17,58 @@ interface AccessSets {
     relationWrites: Set<number>;
 }
 declare function setsFor(desc: SystemDescriptor): AccessSets;
-/** The reads-only access surface a run condition declares (#576). A condition
- * can only `reads` components (via a captured query) and `resourceReads`; every
+/** The reads-only access surface a run condition declares. A condition
+ * can only `reads` components (via a captured query) and `resourceReads`. Every
  * mutation set is empty by construction, so the same `check_*` machinery rejects
- * any write/structural/resource-write a misbehaving predicate attempts. */
+ * any write, structural or resource-write a misbehaving predicate attempts. */
 interface ConditionAccess {
     readonly name: string;
     readonly reads?: readonly ComponentDef[];
     readonly resourceReads?: readonly ResourceKey<any>[];
 }
 declare class AccessCheck {
-    private active;
-    private sets;
-    private activeName;
-    private exclusive;
+    private _activeSystem;
+    private _activeSets;
+    private _activeName;
+    private _exclusive;
     enter(desc: SystemDescriptor): void;
-    /** Open a reads-only span for a run condition (#576). No descriptor — a
+    /** Open a reads-only span for a run condition. No descriptor, a
      * condition can gate a whole SystemSet, so it isn't attributable to one
-     * system — just its declared reads/resource_reads and a name for diagnostics.
+     * system, only its declared `reads` and `resourceReads` and a name for diagnostics.
      * Paired with `leave()`. */
     enterCondition(cond: ConditionAccess): void;
     leave(): void;
     isActive(): boolean;
     /** Current system descriptor, if any. Null during a run-condition span. */
     current(): SystemDescriptor | null;
-    checkRead(def: ComponentHandle): void;
-    checkWrite(def: ComponentHandle): void;
-    checkAdd(def: ComponentHandle): void;
-    checkRemove(def: ComponentHandle): void;
-    checkDestroy(): void;
-    checkResourceRead(key: ResourceKey<any>): void;
-    checkResourceWrite(key: ResourceKey<any>): void;
-    checkSparseRead(def: SparseComponentDef): void;
-    checkSparseWrite(def: SparseComponentDef): void;
-    checkRelationRead(def: RelationDef): void;
-    checkRelationWrite(def: RelationDef): void;
-    /** A `(*, T)` wildcard (`Query.forEachRelatedTo`, #579) reads every
-     * relation's reverse index, so it can't name a specific relation — it is
+    assertRead(def: ComponentHandle): void;
+    assertWrite(def: ComponentHandle): void;
+    assertAdd(def: ComponentHandle): void;
+    assertRemove(def: ComponentHandle): void;
+    assertDespawn(): void;
+    assertResourceRead(key: ResourceKey<any>): void;
+    assertResourceWrite(key: ResourceKey<any>): void;
+    assertSparseRead(def: SparseComponentDef): void;
+    assertSparseWrite(def: SparseComponentDef): void;
+    assertRelationRead(def: RelationDef): void;
+    assertRelationWrite(def: RelationDef): void;
+    /** A `(*, T)` wildcard (`Query.forEachRelatedTo`) reads every
+     * relation's reverse index, so it can't name a specific relation. It is
      * authorised by the `ANY_RELATION` sentinel in `relationReads`. Honoured here
-     * exactly like a per-relation read, just keyed on the reserved sentinel id
+     * exactly like a per-relation read, only keyed on the reserved sentinel id
      * (which computeSets folds into `relationReads` like any other entry). */
-    checkRelationReadAny(): void;
-    private optionalScopes;
+    assertRelationReadAny(): void;
+    private _optionalScopes;
     enterOptionalScope(optional: readonly number[]): void;
     leaveOptionalScope(): void;
-    checkOptionalFetch(def: ComponentHandle): void;
-    private failComponent;
-    private failSparse;
-    private failRelation;
-    private failResource;
+    assertOptionalFetch(def: ComponentHandle): void;
+    private _failComponent;
+    private _failSparse;
+    private _failRelation;
+    private _failResource;
 }
 export declare const accessCheck: AccessCheck;
-/** @internal — test seam for unit tests that need a fresh tracker. */
+/** @internal, test seam for unit tests that need a fresh tracker. */
 export declare const _accessCheckInternals: {
     create: () => AccessCheck;
     setsFor: typeof setsFor;

package/dist/core/ecs/access_check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"access_check.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/access_check.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"access_check.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/access_check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BK;AAEL,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD,UAAU,UAAU;IACnB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE5B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAoHD,iBAAS,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,UAAU,CAMnD;AAED;;;+EAG+E;AAC/E,UAAU,eAAe;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;CACrD;AA4CD,cAAM,WAAW;IAChB,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,WAAW,CAA2B;IAI9C,OAAO,CAAC,WAAW,CAAuB;IAI1C,OAAO,CAAC,UAAU,CAAS;IAE3B,KAAK,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAUnC;;;gCAG4B;IAC5B,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAM3C,KAAK,IAAI,IAAI;IAOb,QAAQ,IAAI,OAAO;IAInB,2EAA2E;IAC3E,OAAO,IAAI,gBAAgB,GAAG,IAAI;IAIlC,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAMtC,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAMvC,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAMrC,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAMxC,aAAa,IAAI,IAAI;IAYrB,kBAAkB,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI;IAO/C,mBAAmB,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI;IAahD,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI;IAO/C,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI;IAOhD,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAO1C,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAO3C;;;;8EAI0E;IAC1E,qBAAqB,IAAI,IAAI;IA8B7B,OAAO,CAAC,eAAe,CAA6B;IAEpD,kBAAkB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIrD,kBAAkB,IAAI,IAAI;IAI1B,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAc/C,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;CAUrB;AAED,eAAO,MAAM,WAAW,EAAE,WAA+B,CAAC;AAE1D,qEAAqE;AACrE,eAAO,MAAM,qBAAqB;;;CAGjC,CAAC"}