@woosh/meep-engine 2.156.0 → 2.158.0

package/src/generation/markers/GridActionRuleSet.js

@@ -104,6 +104,11 @@ export class GridActionRuleSet {
          */
         const ruleIterator = new RuleIteratorClass();
 
+        if (this.policy === RuleSelectionPolicyType.Random) {
+            // tie rule visit order to the generation seed
+            ruleIterator.setSeed(seed);
+        }
+
         //initialize rules
         const tInitializeRules = countTask(0, this.elements.length, i => {
             const rule = this.elements[i];
@@ -159,6 +164,11 @@ export class GridActionRuleSet {
 
                     const ROTATION_COUNT = element.allowRotation ? 4 : 1;
 
+                    // a single roll per placement attempt: whether the rule fires is decided once,
+                    // the rotation scan only decides the orientation. Rolling per rotation would
+                    // compound the probability for rotation-symmetric patterns and bias rotation 0
+                    const roll = random();
+
                     for (let j = 0; j < ROTATION_COUNT; j++) {
 
                         const rotation = j * PI_HALF;
@@ -185,8 +195,6 @@ export class GridActionRuleSet {
                             continue;
                         }
 
-                        const roll = random();
-
                         const probabilityValue = element.probability.execute(grid, p_x, p_y, rotation);
 
                         if (probabilityValue > roll) {

package/src/generation/markers/GridCellActionPlaceMarker.d.ts

@@ -55,6 +55,17 @@ export class GridCellActionPlaceMarker extends GridCellAction {
      * @param {MarkerNodeTransformer} transformer
      */
     addTransformer(transformer: MarkerNodeTransformer): void;
+    /**
+     * Build the node geometry only — position, transform, tags, properties — WITHOUT applying
+     * transformers. For collision pre-checks and estimation paths that must avoid transformer
+     * side effects (transformers may be stateful, see {@link MarkerNodeTransformer}).
+     * @param {GridData} data
+     * @param {number} x
+     * @param {number} y
+     * @param {number} rotation
+     * @returns {MarkerNode}
+     */
+    buildBaseNode(data: GridData, x: number, y: number, rotation: number): MarkerNode;
     /**
      *
      * @param {GridData} data

package/src/generation/markers/GridCellActionPlaceMarker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GridCellActionPlaceMarker.d.ts","sourceRoot":"","sources":["../../../../src/generation/markers/GridCellActionPlaceMarker.js"],"names":[],"mappings":"AAOA;IAkFI;;;;;;;;;;OAUG;IACH,0FAFY,yBAAyB,CAwCpC;IAjID;;;OAGG;IACH,aAAY;IAEZ;;;OAGG;IACH,WAFU,SAAS,CAES;IAE5B;;;OAGG;IACH,MAFU,QAAQ,CAER;IAEV,eAAgB;IAEhB,aAAS;IAET;;;OAGG;IACH,cAFU,uBAAuB,CAEf;IAElB;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,QAFU,OAAO,CAEM;IAEvB,uCAWC;IAED;;;;OAIG;IACH,qBAFa,OAAO,CAYnB;IAED;;;OAGG;IACH,yDAIC;IAqDD;;;;;;;OAOG;IACH,6BALW,MAAM,KACN,MAAM,YACN,MAAM,GACJ,UAAU,CAgEtB;IAED,wDAIC;IAGL;;;OAGG;IACH,sCAFU,OAAO,CAE8C;CAN9D;+BArN8B,uCAAuC;0BAD5C,yCAAyC;oBAF/C,4BAA4B;2BAIrB,iBAAiB"}
+{"version":3,"file":"GridCellActionPlaceMarker.d.ts","sourceRoot":"","sources":["../../../../src/generation/markers/GridCellActionPlaceMarker.js"],"names":[],"mappings":"AAOA;IAkFI;;;;;;;;;;OAUG;IACH,0FAFY,yBAAyB,CAwCpC;IAjID;;;OAGG;IACH,aAAY;IAEZ;;;OAGG;IACH,WAFU,SAAS,CAES;IAE5B;;;OAGG;IACH,MAFU,QAAQ,CAER;IAEV,eAAgB;IAEhB,aAAS;IAET;;;OAGG;IACH,cAFU,uBAAuB,CAEf;IAElB;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,QAFU,OAAO,CAEM;IAEvB,uCAWC;IAED;;;;OAIG;IACH,qBAFa,OAAO,CAYnB;IAED;;;OAGG;IACH,yDAIC;IAqDD;;;;;;;;;OASG;IACH,iCALW,MAAM,KACN,MAAM,YACN,MAAM,GACJ,UAAU,CAuDtB;IAED;;;;;;;OAOG;IACH,6BALW,MAAM,KACN,MAAM,YACN,MAAM,GACJ,UAAU,CAgBtB;IAED,wDAIC;IAGL;;;OAGG;IACH,sCAFU,OAAO,CAE8C;CAN9D;+BAtO8B,uCAAuC;0BAD5C,yCAAyC;oBAF/C,4BAA4B;2BAIrB,iBAAiB"}

package/src/generation/markers/GridCellActionPlaceMarker.js

@@ -139,16 +139,18 @@ export class GridCellActionPlaceMarker extends GridCellAction {
     }
 
     /**
-     *
+     * Build the node geometry only — position, transform, tags, properties — WITHOUT applying
+     * transformers. For collision pre-checks and estimation paths that must avoid transformer
+     * side effects (transformers may be stateful, see {@link MarkerNodeTransformer}).
      * @param {GridData} data
      * @param {number} x
      * @param {number} y
      * @param {number} rotation
      * @returns {MarkerNode}
      */
-    buildNode(data, x, y, rotation) {
+    buildBaseNode(data, x, y, rotation) {
 
-        let node = new MarkerNode();
+        const node = new MarkerNode();
 
 
         const sin = Math.sin(rotation);
@@ -198,6 +200,21 @@ export class GridCellActionPlaceMarker extends GridCellAction {
 
         node.priority = this.priority;
 
+        return node;
+    }
+
+    /**
+     *
+     * @param {GridData} data
+     * @param {number} x
+     * @param {number} y
+     * @param {number} rotation
+     * @returns {MarkerNode}
+     */
+    buildNode(data, x, y, rotation) {
+
+        let node = this.buildBaseNode(data, x, y, rotation);
+
         //apply transformations
         const transformers = this.transformers;
         const transformer_count = transformers.length;

package/src/generation/markers/GridCellActionPlaceMarkerGroup.d.ts

@@ -11,7 +11,9 @@ export class GridCellActionPlaceMarkerGroup extends GridCellAction {
      */
     children: GridCellActionPlaceMarker[];
     /**
-     *
+     * Tests the children's geometric footprints against existing markers. Transformers are NOT
+     * applied (they may be stateful, and a test must not have side effects), so position changes
+     * made by transformers are not reflected in this check.
      * @param {GridData} data
      * @param {number} x
      * @param {number} y

package/src/generation/markers/GridCellActionPlaceMarkerGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GridCellActionPlaceMarkerGroup.d.ts","sourceRoot":"","sources":["../../../../src/generation/markers/GridCellActionPlaceMarkerGroup.js"],"names":[],"mappings":"AAKA;IASI;;;;OAIG;IACH,sBAHW,8BAA8B,GAC5B,8BAA8B,CAU1C;IApBD;;;OAGG;IACH,UAFU,2BAA2B,CAEvB;IAkBd;;;;;;;;OAQG;IACH,sCANW,MAAM,KACN,MAAM,YACN,MAAM,+BAEJ,OAAO,CAoBnB;IAED,wDAcC;CACJ;+BAzE8B,uCAAuC"}
+{"version":3,"file":"GridCellActionPlaceMarkerGroup.d.ts","sourceRoot":"","sources":["../../../../src/generation/markers/GridCellActionPlaceMarkerGroup.js"],"names":[],"mappings":"AAUA;IASI;;;;OAIG;IACH,sBAHW,8BAA8B,GAC5B,8BAA8B,CAU1C;IApBD;;;OAGG;IACH,UAFU,2BAA2B,CAEvB;IAkBd;;;;;;;;;;OAUG;IACH,sCANW,MAAM,KACN,MAAM,YACN,MAAM,+BAEJ,OAAO,CAoBnB;IAED,wDAcC;CACJ;+BAhF8B,uCAAuC"}

package/src/generation/markers/GridCellActionPlaceMarkerGroup.js

@@ -1,6 +1,11 @@
 import { GridCellAction } from "../placement/action/GridCellAction.js";
 import { assert } from "../../core/assert.js";
 
+/**
+ * Group IDs are opaque: unique within a session and only meaningful for equality
+ * comparison. Their absolute values are NOT reproducible across runs.
+ * @type {number}
+ */
 let idCounter = 0;
 
 export class GridCellActionPlaceMarkerGroup extends GridCellAction {
@@ -28,7 +33,9 @@ export class GridCellActionPlaceMarkerGroup extends GridCellAction {
     }
 
     /**
-     *
+     * Tests the children's geometric footprints against existing markers. Transformers are NOT
+     * applied (they may be stateful, and a test must not have side effects), so position changes
+     * made by transformers are not reflected in this check.
      * @param {GridData} data
      * @param {number} x
      * @param {number} y
@@ -44,7 +51,7 @@ export class GridCellActionPlaceMarkerGroup extends GridCellAction {
         for (let i = 0; i < n; i++) {
             const child = children[i];
 
-            const node = child.buildNode(data, x, y, rotation);
+            const node = child.buildBaseNode(data, x, y, rotation);
 
             const collision = data.containsMarkerInCircle(node.position.x, node.position.y, node.size, matcher);
 

package/src/generation/markers/MarkerNode.d.ts

@@ -15,12 +15,17 @@ export class MarkerNode {
      */
     tags: string[];
     /**
-     * Grid position
+     * Virtual position in the 2D grid domain. This is what spatial queries, the marker
+     * quadtree and game logic reason about.
      * @type {Vector2}
      */
     position: Vector2;
     /**
-     * World transform, this can differ from the grid position
+     * Concrete world-space presentation. The planar (x,z) part is derived from
+     * {@link MarkerNode#position} via {@link GridData#transform} when the node is built and
+     * must be kept in correspondence by transformers that RELOCATE the marker
+     * (e.g. {@link MarkerNodeTransformerOffsetPosition}). Presentation-only adjustments
+     * (height, rotation, scale) live here exclusively and leave the virtual position alone.
      * @type {Transform}
      */
     transform: Transform;
@@ -58,7 +63,7 @@ export class MarkerNode {
      */
     copy(other: MarkerNode): void;
     /**
-     *
+     * Compares grid-space footprints, same plane as {@link GridData#containsMarkerInCircle}
      * @param {MarkerNode} other
      * @returns {boolean}
      */

package/src/generation/markers/MarkerNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNode.d.ts","sourceRoot":"","sources":["../../../../src/generation/markers/MarkerNode.js"],"names":[],"mappings":"AAKA;IAEI;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,aAAY;IAEZ;;;OAGG;IACH,MAFU,QAAQ,CAER;IAEV;;;OAGG;IACH,UAFU,OAAO,CAEQ;IAEzB;;;OAGG;IACH,WAFU,SAAS,CAES;IAE5B;;;;OAIG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,gBAAgB;IAGhB;;;;OAIG;IACH,YAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;OAIG;IACH,iBAHW,MAAM,EAAE,GACN,OAAO,CAanB;IAED;;;OAGG;IACH,SAFa,UAAU,CAQtB;IAED;;;OAGG;IACH,YAFW,UAAU,QAcpB;IAED;;;;OAIG;IACH,gBAHW,UAAU,GACR,OAAO,CAOnB;IAIL;;;OAGG;IACH,uBAFU,OAAO,CAEgB;CANhC;oBAtHmB,4BAA4B;0BACtB,yCAAyC"}
+{"version":3,"file":"MarkerNode.d.ts","sourceRoot":"","sources":["../../../../src/generation/markers/MarkerNode.js"],"names":[],"mappings":"AAKA;IAEI;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,aAAY;IAEZ;;;OAGG;IACH,MAFU,QAAQ,CAER;IAEV;;;;OAIG;IACH,UAFU,OAAO,CAEQ;IAEzB;;;;;;;OAOG;IACH,WAFU,SAAS,CAES;IAE5B;;;;OAIG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,gBAAgB;IAGhB;;;;OAIG;IACH,YAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;OAIG;IACH,iBAHW,MAAM,EAAE,GACN,OAAO,CAanB;IAED;;;OAGG;IACH,SAFa,UAAU,CAQtB;IAED;;;OAGG;IACH,YAFW,UAAU,QAgBpB;IAED;;;;OAIG;IACH,gBAHW,UAAU,GACR,OAAO,CAOnB;IAIL;;;OAGG;IACH,uBAFU,OAAO,CAEgB;CANhC;oBA7HmB,4BAA4B;0BACtB,yCAAyC"}

package/src/generation/markers/MarkerNode.js

@@ -24,13 +24,18 @@ export class MarkerNode {
     tags = [];
 
     /**
-     * Grid position
+     * Virtual position in the 2D grid domain. This is what spatial queries, the marker
+     * quadtree and game logic reason about.
      * @type {Vector2}
      */
     position = new Vector2();
 
     /**
-     * World transform, this can differ from the grid position
+     * Concrete world-space presentation. The planar (x,z) part is derived from
+     * {@link MarkerNode#position} via {@link GridData#transform} when the node is built and
+     * must be kept in correspondence by transformers that RELOCATE the marker
+     * (e.g. {@link MarkerNodeTransformerOffsetPosition}). Presentation-only adjustments
+     * (height, rotation, scale) live here exclusively and leave the virtual position alone.
      * @type {Transform}
      */
     transform = new Transform();
@@ -93,6 +98,8 @@ export class MarkerNode {
      * @param {MarkerNode} other
      */
     copy(other) {
+        this.priority = other.priority;
+
         this.type = other.type;
 
         array_copy_entire(other.tags, this.tags);
@@ -107,13 +114,13 @@ export class MarkerNode {
     }
 
     /**
-     *
+     * Compares grid-space footprints, same plane as {@link GridData#containsMarkerInCircle}
      * @param {MarkerNode} other
      * @returns {boolean}
      */
     overlaps(other) {
-        const p0 = this.transform.position;
-        const p1 = other.transform.position;
+        const p0 = this.position;
+        const p1 = other.position;
 
         return circle_intersects_circle(p0.x, p0.y, this.size, p1.x, p1.y, other.size);
     }

package/src/generation/markers/actions/MarkerNodeActionEntityPlacement.js

@@ -54,7 +54,7 @@ export class MarkerNodeActionEntityPlacement extends MarkerNodeAction {
 
     initialize(grid, ecd, seed) {
         if (this.processor !== null) {
-            this.processor.initialize(grid, ecd);
+            this.processor.initialize(grid, ecd, seed);
         }
     }
 

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessor.d.ts

@@ -4,7 +4,7 @@ export class MarkerNodeEntityProcessor {
      * @param {GridData} data
      * @param {EntityComponentDataset} ecd
      */
-    initialize(data: GridData, ecd: EntityComponentDataset): void;
+    initialize(data: GridData, ecd: EntityComponentDataset, seed: any): void;
     /**
      *
      * @param {Entity} entity

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeEntityProcessor.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/placement/MarkerNodeEntityProcessor.js"],"names":[],"mappings":"AAAA;IACI;;;;OAIG;IACH,8DAEC;IAED;;;;;;OAMG;IACH,6FAEC;IAGL;;;OAGG;IACH,sCAFU,OAAO,CAE8C;CAN9D"}
+{"version":3,"file":"MarkerNodeEntityProcessor.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/placement/MarkerNodeEntityProcessor.js"],"names":[],"mappings":"AAAA;IACI;;;;OAIG;IACH,yEAEC;IAED;;;;;;OAMG;IACH,6FAEC;IAGL;;;OAGG;IACH,sCAFU,OAAO,CAE8C;CAN9D"}

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessor.js

@@ -4,7 +4,7 @@ export class MarkerNodeEntityProcessor {
      * @param {GridData} data
      * @param {EntityComponentDataset} ecd
      */
-    initialize(data, ecd) {
+    initialize(data, ecd, seed) {
 
     }
 

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorClingToTerrain.d.ts

@@ -15,7 +15,7 @@ export class MarkerNodeEntityProcessorClingToTerrain extends MarkerNodeEntityPro
      * @type {boolean}
      */
     normalAlign: boolean;
-    initialize(data: any, ecd: any): void;
+    initialize(data: any, ecd: any, seed: any): void;
     execute(entity: any, node: any, data: any, ecd: any): void;
 }
 import { MarkerNodeEntityProcessor } from "./MarkerNodeEntityProcessor.js";

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorClingToTerrain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeEntityProcessorClingToTerrain.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/placement/MarkerNodeEntityProcessorClingToTerrain.js"],"names":[],"mappings":"AAOA;IAcI;;;;OAIG;IACH,8BAHW,OAAO,GACN,uCAAuC,CAQlD;IAvBD;;;OAGG;IACH,gBAAe;IAEf;;;OAGG;IACH,aAFU,OAAO,CAEG;IAepB,sCAEC;IAED,2DAcC;CACJ;0CArDyC,gCAAgC"}
+{"version":3,"file":"MarkerNodeEntityProcessorClingToTerrain.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/placement/MarkerNodeEntityProcessorClingToTerrain.js"],"names":[],"mappings":"AAOA;IAcI;;;;OAIG;IACH,8BAHW,OAAO,GACN,uCAAuC,CAQlD;IAvBD;;;OAGG;IACH,gBAAe;IAEf;;;OAGG;IACH,aAFU,OAAO,CAEG;IAepB,iDAEC;IAED,2DAcC;CACJ;0CArDyC,gCAAgC"}

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorClingToTerrain.js

@@ -32,7 +32,7 @@ export class MarkerNodeEntityProcessorClingToTerrain extends MarkerNodeEntityPro
         return r;
     }
 
-    initialize(data, ecd) {
+    initialize(data, ecd, seed) {
         this.terrain = obtainTerrain(ecd);
     }
 

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorRandomRotation.d.ts

@@ -2,7 +2,7 @@ export class MarkerNodeEntityProcessorRandomRotation extends MarkerNodeEntityPro
     static from(): MarkerNodeEntityProcessorRandomRotation;
     __seed: number;
     __random: () => number;
-    initialize(data: any, ecd: any): void;
+    initialize(data: any, ecd: any, seed: any): void;
     execute(entity: any, node: any, data: any, ecd: any): void;
 }
 import { MarkerNodeEntityProcessor } from "./MarkerNodeEntityProcessor.js";

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorRandomRotation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeEntityProcessorRandomRotation.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/placement/MarkerNodeEntityProcessorRandomRotation.js"],"names":[],"mappings":"AAIA;IAKI,uDAEC;IALD,eAAW;IACX,uBAA2B;IAM3B,sCAEC;IAED,2DAQC;CACJ;0CA1ByC,gCAAgC"}
+{"version":3,"file":"MarkerNodeEntityProcessorRandomRotation.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/placement/MarkerNodeEntityProcessorRandomRotation.js"],"names":[],"mappings":"AAIA;IAKI,uDAEC;IALD,eAAW;IACX,uBAA2B;IAM3B,iDAEC;IAED,2DAQC;CACJ;0CA1ByC,gCAAgC"}

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorRandomRotation.js

@@ -11,8 +11,8 @@ export class MarkerNodeEntityProcessorRandomRotation extends MarkerNodeEntityPro
         return new MarkerNodeEntityProcessorRandomRotation();
     }
 
-    initialize(data, ecd) {
-        this.__random.setCurrentSeed(this.__seed);
+    initialize(data, ecd, seed) {
+        this.__random.setCurrentSeed(seed + this.__seed);
     }
 
     execute(entity, node, data, ecd) {

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorSequence.d.ts

@@ -15,7 +15,7 @@ export class MarkerNodeEntityProcessorSequence extends MarkerNodeEntityProcessor
      * @param {MarkerNodeEntityProcessor} element
      */
     add(element: MarkerNodeEntityProcessor): void;
-    initialize(data: any, ecd: any): void;
+    initialize(data: any, ecd: any, seed: any): void;
     execute(entity: any, node: any, data: any, ecd: any): void;
 }
 import { MarkerNodeEntityProcessor } from "./MarkerNodeEntityProcessor.js";

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorSequence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeEntityProcessorSequence.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/placement/MarkerNodeEntityProcessorSequence.js"],"names":[],"mappings":"AAGA;IAQI;;;;OAIG;IACH,sBAHW,yBAAyB,EAAE,GAC1B,iCAAiC,CAQ5C;IAjBD;;;OAGG;IACH,UAFU,yBAAyB,EAAE,CAEvB;IAed;;;OAGG;IACH,aAFW,yBAAyB,QASnC;IAED,sCAUC;IAED,2DAUC;CACJ;0CA5DyC,gCAAgC"}
+{"version":3,"file":"MarkerNodeEntityProcessorSequence.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/placement/MarkerNodeEntityProcessorSequence.js"],"names":[],"mappings":"AAGA;IAQI;;;;OAIG;IACH,sBAHW,yBAAyB,EAAE,GAC1B,iCAAiC,CAQ5C;IAjBD;;;OAGG;IACH,UAFU,yBAAyB,EAAE,CAEvB;IAed;;;OAGG;IACH,aAFW,yBAAyB,QASnC;IAED,iDAUC;IAED,2DAUC;CACJ;0CA5DyC,gCAAgC"}

package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorSequence.js

@@ -35,14 +35,14 @@ export class MarkerNodeEntityProcessorSequence extends MarkerNodeEntityProcessor
         this.elements.push(element);
     }
 
-    initialize(data, ecd) {
+    initialize(data, ecd, seed) {
         const elements = this.elements;
         const n = elements.length;
 
         for (let i = 0; i < n; i++) {
             const element = elements[i];
 
-            element.initialize(data, ecd);
+            element.initialize(data, ecd, seed);
         }
 
     }

package/src/generation/markers/actions/probability/MarkerNodeActionSelectWeighted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeActionSelectWeighted.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/probability/MarkerNodeActionSelectWeighted.js"],"names":[],"mappings":"AAYA;IAUI;;;;OAIG;IACH,sBAFW,iCAAiC,GAD/B,8BAA8B,CAW1C;IArBD;;;OAGG;IACH,UAFU,iCAAiC,CAE7B;IAEd,uBAA2B;IAiB3B,iDAiBC;IAED,8CA6CC;CACJ;iCArGgC,wBAAwB"}
+{"version":3,"file":"MarkerNodeActionSelectWeighted.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/probability/MarkerNodeActionSelectWeighted.js"],"names":[],"mappings":"AAWA;IAUI;;;;OAIG;IACH,sBAFW,iCAAiC,GAD/B,8BAA8B,CAW1C;IArBD;;;OAGG;IACH,UAFU,iCAAiC,CAE7B;IAEd,uBAA2B;IAiB3B,iDAiBC;IAED,8CAgDC;CACJ;iCAtGgC,wBAAwB"}

package/src/generation/markers/actions/probability/MarkerNodeActionSelectWeighted.js

@@ -1,8 +1,7 @@
 import { seededRandom } from "../../../../core/math/random/seededRandom.js";
+import { random_pick_weighted_index } from "../../../../core/math/random/random_pick_weighted_index.js";
 import { MarkerNodeAction } from "../MarkerNodeAction.js";
 import { assert } from "../../../../core/assert.js";
-import { binarySearchHighIndex } from "../../../../core/collection/array/binarySearchHighIndex.js";
-import { number_compare_ascending } from "../../../../core/primitives/numbers/number_compare_ascending.js";
 
 /**
  *
@@ -92,9 +91,12 @@ export class MarkerNodeActionSelectWeighted extends MarkerNodeAction {
 
         }
 
-        const targetWeight = this.__random() * totalWeight;
+        const index = random_pick_weighted_index(this.__random, evaluatedWeights, n);
 
-        const index = binarySearchHighIndex(evaluatedWeights, targetWeight, number_compare_ascending, 0, n - 1);
+        if (index === -1) {
+            // every element has zero weight at this position, nothing to select
+            return;
+        }
 
         const targetElement = elements[index];
 

package/src/generation/markers/actions/probability/MarkerNodeActionWeightedElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeActionWeightedElement.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/probability/MarkerNodeActionWeightedElement.js"],"names":[],"mappings":"AAGA;IA8BI;;;;;OAKG;IACH,4DAFa,+BAA+B,CAY3C;IA5CD;;;OAGG;IACH,yBAAc;IAEd;;;OAGG;IACH,mBAAc;IAGd;;;;;OAKG;IACH,8DAFW,MAAM,QAShB;CAmBJ"}
+{"version":3,"file":"MarkerNodeActionWeightedElement.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/probability/MarkerNodeActionWeightedElement.js"],"names":[],"mappings":"AAGA;IA4BI;;;;;OAKG;IACH,4DAFa,+BAA+B,CAY3C;IA1CD;;;OAGG;IACH,yBAAc;IAEd;;;OAGG;IACH,mBAAc;IAGd;;;;;OAKG;IACH,8DAFW,MAAM,QAOhB;CAmBJ"}

package/src/generation/markers/actions/probability/MarkerNodeActionWeightedElement.js

@@ -26,9 +26,7 @@ export class MarkerNodeActionWeightedElement {
 
         this.action.initialize(grid, ecd, seed);
 
-        if (!this.weight.initialized) {
-            this.weight.initialize(grid, seed);
-        }
+        this.weight.ensureInitialized(grid, seed);
     }
 
     /**

package/src/generation/markers/actions/terrain/MarkerNodeActionPaintTerrain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeActionPaintTerrain.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/terrain/MarkerNodeActionPaintTerrain.js"],"names":[],"mappings":"AAcA;IA4DI;;;;;;;;OAQG;IACH,kEAPW,cAAc,GAKZ,4BAA4B,CAwBxC;IA1FD;;;OAGG;IACH,+BAAoC;IAEpC;;;OAGG;IACH,+BAAa;IAEb;;;;OAIG;IACH,qBAAkB;IAElB;;;;OAIG;IACH,mBAAkB;IAElB;;;;OAIG;IACH,iBAAgB;IAEhB;;;;OAIG;IACH,UAFU,cAAc,CAEgB;IAExC;;;OAGG;IACH,oCAFmB,MAAM,KAAG,MAAM,CAE0B;IAE5D;;;OAGG;IACH,oBAFU,cAAc,CAE0B;IAElD;;;;OAIG;IACH,gBAAQ;IAmCR;;;;;;;;;;OAUG;IACH,wBAmBC;IAED,yBAwBC;IAED,8CA8EC;IAED,iDAkBC;CACJ;iCA5PgC,wBAAwB;uCADlB,sDAAsD;2BAJlE,+CAA+C"}
+{"version":3,"file":"MarkerNodeActionPaintTerrain.d.ts","sourceRoot":"","sources":["../../../../../../src/generation/markers/actions/terrain/MarkerNodeActionPaintTerrain.js"],"names":[],"mappings":"AAeA;IA4DI;;;;;;;;OAQG;IACH,kEAPW,cAAc,GAKZ,4BAA4B,CAwBxC;IA1FD;;;OAGG;IACH,+BAAoC;IAEpC;;;OAGG;IACH,+BAAa;IAEb;;;;OAIG;IACH,qBAAkB;IAElB;;;;OAIG;IACH,mBAAkB;IAElB;;;;OAIG;IACH,iBAAgB;IAEhB;;;;OAIG;IACH,UAFU,cAAc,CAEgB;IAExC;;;OAGG;IACH,oCAFmB,MAAM,KAAG,MAAM,CAE0B;IAE5D;;;OAGG;IACH,oBAFU,cAAc,CAE0B;IAElD;;;;OAIG;IACH,gBAAQ;IAmCR;;;;;;;;;;OAUG;IACH,wBAmBC;IAED,yBAwBC;IAED,8CA8EC;IAED,iDAkBC;CACJ;iCA5PgC,wBAAwB;uCADlB,sDAAsD;2BAJlE,+CAA+C"}

package/src/generation/markers/actions/terrain/MarkerNodeActionPaintTerrain.js

@@ -4,6 +4,7 @@ import { clamp } from "../../../../core/math/clamp.js";
 import { clamp01 } from "../../../../core/math/clamp01.js";
 import { inverseLerp } from "../../../../core/math/inverseLerp.js";
 import { max2 } from "../../../../core/math/max2.js";
+import { min2 } from "../../../../core/math/min2.js";
 import { seededRandom } from "../../../../core/math/random/seededRandom.js";
 import LinearModifier from "../../../../core/model/stat/LinearModifier.js";
 import TransitionFunctions from "../../../../engine/animation/TransitionFunctions.js";
@@ -183,15 +184,15 @@ export class MarkerNodeActionPaintTerrain extends MarkerNodeAction {
         const edge_width = node.size * this.weight_edge_easing.a + this.weight_edge_easing.b;
         const radius_inner = radius_outer - edge_width;
 
-        // we shift to the center of the grid cell
-        const node_p_x = node.position.x + splat_to_grid_x;
-        const node_p_y = node.position.y + splat_to_grid_y;
+        const node_p_x = node.position.x;
+        const node_p_y = node.position.y;
 
-        // compute affected region in Splat space
-        const x0 = Math.floor((node_p_x - radius_outer) * splat_scale_x + 0.5);
-        const x1 = Math.floor((node_p_x + radius_outer) * splat_scale_x + 0.5);
-        const y0 = Math.ceil((node_p_y - radius_outer) * splat_scale_y + 0.5);
-        const y1 = Math.ceil((node_p_y + radius_outer) * splat_scale_y + 0.5);
+        // affected region in splat space, clamped to the splat map;
+        // ratio mapping (see generation/COORDINATES.md): splat texel t is centered at grid t / scale
+        const x0 = max2(0, Math.round((node_p_x - radius_outer) * splat_scale_x));
+        const x1 = min2(splat_resolution_x - 1, Math.round((node_p_x + radius_outer) * splat_scale_x));
+        const y0 = max2(0, Math.round((node_p_y - radius_outer) * splat_scale_y));
+        const y1 = min2(splat_resolution_y - 1, Math.round((node_p_y + radius_outer) * splat_scale_y));
 
         const layer_count = splat.depth;
 
@@ -201,9 +202,9 @@ export class MarkerNodeActionPaintTerrain extends MarkerNodeAction {
         for (let y = y0; y <= y1; y++) {
             for (let x = x0; x <= x1; x++) {
 
-                // convert position into grid coordinates
-                const grid_x = (x - 0.5) * splat_to_grid_x - splat_to_grid_x;
-                const grid_y = (y - 0.5) * splat_to_grid_y - splat_to_grid_y;
+                // convert texel position into grid coordinates
+                const grid_x = x * splat_to_grid_x;
+                const grid_y = y * splat_to_grid_y;
 
                 const weight = this._getPointWeight(grid_x, grid_y, node, grid, radius_outer, radius_inner);
 

package/src/generation/markers/matcher/MarkerNodeMatcherAnd.js

@@ -22,8 +22,8 @@ export class MarkerNodeMatcherAnd extends MarkerNodeMatcherBinary {
     }
 
     match(node) {
-        if (this.left.match(node)) {
-            return true;
+        if (!this.left.match(node)) {
+            return false;
         }
 
         return this.right.match(node);

package/src/generation/markers/transform/MarkerNodeTransformer.d.ts

@@ -6,7 +6,10 @@ export class MarkerNodeTransformer {
      */
     initialize(grid: GridData, seed: number): void;
     /**
-     *
+     * Transformers are only invoked for nodes that are actually produced — estimation and
+     * collision-test paths use {@link GridCellActionPlaceMarker#buildBaseNode} and skip
+     * transformers entirely, so a transformer MAY keep internal state across calls
+     * (e.g. {@link MarkerNodeTransformerRecordUniqueRandomEnum} consumes from a finite pool).
      * @param {MarkerNode} node
      * @param {GridData} grid
      * @returns {MarkerNode}

package/src/generation/markers/transform/MarkerNodeTransformer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeTransformer.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformer.js"],"names":[],"mappings":"AAAA;IACI;;;;OAIG;IACH,iCAFW,MAAM,QAIhB;IAED;;;;;OAKG;IACH,wDAEC;IAGL;;;OAGG;IACH,kCAFU,OAAO,CAEsC;CANtD"}
+{"version":3,"file":"MarkerNodeTransformer.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformer.js"],"names":[],"mappings":"AAAA;IACI;;;;OAIG;IACH,iCAFW,MAAM,QAIhB;IAED;;;;;;;;OAQG;IACH,wDAEC;IAGL;;;OAGG;IACH,kCAFU,OAAO,CAEsC;CANtD"}

package/src/generation/markers/transform/MarkerNodeTransformer.js

@@ -9,7 +9,10 @@ export class MarkerNodeTransformer {
     }
 
     /**
-     *
+     * Transformers are only invoked for nodes that are actually produced — estimation and
+     * collision-test paths use {@link GridCellActionPlaceMarker#buildBaseNode} and skip
+     * transformers entirely, so a transformer MAY keep internal state across calls
+     * (e.g. {@link MarkerNodeTransformerRecordUniqueRandomEnum} consumes from a finite pool).
      * @param {MarkerNode} node
      * @param {GridData} grid
      * @returns {MarkerNode}

package/src/generation/markers/transform/MarkerNodeTransformerAddPositionYFromFilter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeTransformerAddPositionYFromFilter.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerAddPositionYFromFilter.js"],"names":[],"mappings":"AAGA;IAQI;;;;OAIG;IACH,iCAFa,2CAA2C,CAUvD;IAnBD;;;OAGG;IACH,mBAAc;IAiBd,uCAMC;IAED,qCAyBC;CACJ;sCA5DqC,4BAA4B"}
+{"version":3,"file":"MarkerNodeTransformerAddPositionYFromFilter.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerAddPositionYFromFilter.js"],"names":[],"mappings":"AAGA;IAQI;;;;OAIG;IACH,iCAFa,2CAA2C,CAUvD;IAnBD;;;OAGG;IACH,mBAAc;IAiBd,uCAIC;IAED,qCAyBC;CACJ;sCA1DqC,4BAA4B"}

package/src/generation/markers/transform/MarkerNodeTransformerAddPositionYFromFilter.js

@@ -27,9 +27,7 @@ export class MarkerNodeTransformerAddPositionYFromFilter extends MarkerNodeTrans
     initialize(grid, seed) {
         super.initialize(grid, seed);
 
-        if (!this.filter.initialized) {
-            this.filter.initialize(grid, seed);
-        }
+        this.filter.ensureInitialized(grid, seed);
     }
 
     transform(node, grid) {

package/src/generation/markers/transform/MarkerNodeTransformerOffsetPosition.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Relocates the marker by an offset given in grid units, rotated by the node's yaw.
+ * Both domains are updated: the virtual grid position and the planar part of the
+ * concrete world transform (see {@link MarkerNode} domain contract).
+ */
 export class MarkerNodeTransformerOffsetPosition extends MarkerNodeTransformer {
     /**
      *

package/src/generation/markers/transform/MarkerNodeTransformerOffsetPosition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeTransformerOffsetPosition.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerOffsetPosition.js"],"names":[],"mappings":"AAIA;IAII;;;;;OAKG;IACH,eAJW,MAAM,KACN,MAAM,GACL,mCAAmC,CAQ9C;IAdD,gBAAuB;IAgBvB,qCAkBC;CACJ;sCAzCqC,4BAA4B;oBAC9C,+BAA+B"}
+{"version":3,"file":"MarkerNodeTransformerOffsetPosition.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerOffsetPosition.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;IAII;;;;;OAKG;IACH,eAJW,MAAM,KACN,MAAM,GACL,mCAAmC,CAQ9C;IAdD,gBAAuB;IAgBvB,qCA4BC;CACJ;sCAxDqC,4BAA4B;oBAC9C,+BAA+B"}

package/src/generation/markers/transform/MarkerNodeTransformerOffsetPosition.js

@@ -2,6 +2,11 @@ import { MarkerNodeTransformer } from "./MarkerNodeTransformer.js";
 import Vector2 from "../../../core/geom/Vector2.js";
 import Vector3 from "../../../core/geom/Vector3.js";
 
+/**
+ * Relocates the marker by an offset given in grid units, rotated by the node's yaw.
+ * Both domains are updated: the virtual grid position and the planar part of the
+ * concrete world transform (see {@link MarkerNode} domain contract).
+ */
 export class MarkerNodeTransformerOffsetPosition extends MarkerNodeTransformer {
 
     offset = new Vector2();
@@ -37,6 +42,16 @@ export class MarkerNodeTransformerOffsetPosition extends MarkerNodeTransformer {
 
         r.position._add(rotated_local_x, rotated_local_y);
 
+        // the marker is being relocated, keep the concrete world position in
+        // correspondence with the virtual one (world Y is a presentation concern, untouched)
+        const world = grid.transform;
+
+        r.transform.position._add(
+            rotated_local_x * world.scale_x,
+            0,
+            rotated_local_y * world.scale_y
+        );
+
         return r;
     }
 }

package/src/generation/markers/transform/MarkerNodeTransformerRecordProperty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeTransformerRecordProperty.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerRecordProperty.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAcI;;;;;OAKG;IACH,0BAJW,MAAM,sBAEJ,mCAAmC,CAY/C;IA5BD;;;OAGG;IACH,kBAAa;IAEb;;;OAGG;IACH,cAFU,MAAM,CAEI;IAoBpB,uCAIC;IAED,qCAQC;CACJ;sCApDqC,4BAA4B"}
+{"version":3,"file":"MarkerNodeTransformerRecordProperty.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerRecordProperty.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAcI;;;;;OAKG;IACH,0BAJW,MAAM,sBAEJ,mCAAmC,CAY/C;IA5BD;;;OAGG;IACH,kBAAa;IAEb;;;OAGG;IACH,cAFU,MAAM,CAEI;IAoBpB,uCAEC;IAED,qCAQC;CACJ;sCAlDqC,4BAA4B"}

package/src/generation/markers/transform/MarkerNodeTransformerRecordProperty.js

@@ -37,9 +37,7 @@ export class MarkerNodeTransformerRecordProperty extends MarkerNodeTransformer {
     }
 
     initialize(grid, seed) {
-        if (!this.value.initialized) {
-            this.value.initialize(grid, seed);
-        }
+        this.value.ensureInitialized(grid, seed);
     }
 
     transform(node, grid) {

package/src/generation/markers/transform/MarkerNodeTransformerYRotateByFilter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeTransformerYRotateByFilter.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerYRotateByFilter.js"],"names":[],"mappings":"AAQA;IAqBI;;;;OAIG;IACH,yCAFW,MAAM,wCAahB;IAnCD;;;OAGG;IACH,mBAAc;IAEd;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX,uCAIC;IAqBD,qCAmBC;CACJ;sCA/DqC,4BAA4B"}
+{"version":3,"file":"MarkerNodeTransformerYRotateByFilter.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerYRotateByFilter.js"],"names":[],"mappings":"AAQA;IAmBI;;;;OAIG;IACH,yCAFW,MAAM,wCAahB;IAjCD;;;OAGG;IACH,mBAAc;IAEd;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX,uCAEC;IAqBD,qCAmBC;CACJ;sCA7DqC,4BAA4B"}

package/src/generation/markers/transform/MarkerNodeTransformerYRotateByFilter.js

@@ -21,9 +21,7 @@ export class MarkerNodeTransformerYRotateByFilter extends MarkerNodeTransformer
     offset = 0;
 
     initialize(grid, seed) {
-        if (!this.filter.initialized) {
-            this.filter.initialize(grid, seed);
-        }
+        this.filter.ensureInitialized(grid, seed);
     }
 
 
@@ -51,7 +49,7 @@ export class MarkerNodeTransformerYRotateByFilter extends MarkerNodeTransformer
 
         let finalAngle = this.offset + angle_factor * Math.PI * 2;
 
-        node.transform.rotation.toEulerAnglesXYZ(v3_object);
+        node.transform.rotation.toEulerAnglesYXZ(v3_object);
 
         if (epsilonEquals(v3_object.y, finalAngle, EPSILON)) {
             //special case, already facing in the right direction

package/src/generation/markers/transform/MarkerNodeTransformerYRotateByFilterGradient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkerNodeTransformerYRotateByFilterGradient.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerYRotateByFilterGradient.js"],"names":[],"mappings":"AAWA;;;GAGG;AACH;IAoBI;;;;OAIG;IACH,yCAFW,MAAM,gDAahB;IAlCD;;;OAGG;IACH,mBAAc;IAEd;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX,uCAIC;IAoBD,qCA2BC;CACJ;sCA5EqC,4BAA4B"}
+{"version":3,"file":"MarkerNodeTransformerYRotateByFilterGradient.d.ts","sourceRoot":"","sources":["../../../../../src/generation/markers/transform/MarkerNodeTransformerYRotateByFilterGradient.js"],"names":[],"mappings":"AAWA;;;GAGG;AACH;IAkBI;;;;OAIG;IACH,yCAFW,MAAM,gDAahB;IAhCD;;;OAGG;IACH,mBAAc;IAEd;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX,uCAEC;IAoBD,qCA2BC;CACJ;sCA1EqC,4BAA4B"}