@drawcall/charta 0.1.20 → 0.1.21

package/dist/grass/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grass/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,EACb,QAAQ,EAMT,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAO9E,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,qBAAa,SAAU,SAAQ,aAAa;gBAExC,WAAW,EAAE,WAAW,EACxB,QAAQ,GAAE,QAAkC,EAC5C,IAAI,GAAE,YAAiB;CAuP1B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grass/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,EACb,QAAQ,EAMT,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAO9E,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,qBAAa,SAAU,SAAQ,aAAa;gBAExC,WAAW,EAAE,WAAW,EACxB,QAAQ,GAAE,QAAkC,EAC5C,IAAI,GAAE,YAAiB;CAyP1B"}

package/dist/grass/index.js

@@ -15,7 +15,7 @@ export class GrassMesh extends InstancedMesh {
             for (let row = 0; row < rows; row++) {
                 for (let col = 0; col < cols; col++) {
                     // getCalls validates the schema and reports errors
-                    interpreter.getCalls([row, col], { grass: grassSchema });
+                    interpreter.getCalls({ row, col }, { grass: grassSchema });
                 }
             }
             return;
@@ -31,7 +31,7 @@ export class GrassMesh extends InstancedMesh {
         for (let row = 0; row < rows; row++) {
             for (let col = 0; col < cols; col++) {
                 const grassParsed = interpreter
-                    .getCalls([row, col], { grass: grassSchema })
+                    .getCalls({ row, col }, { grass: grassSchema })
                     .at(-1)?.[1];
                 if (!grassParsed)
                     continue;
@@ -42,7 +42,7 @@ export class GrassMesh extends InstancedMesh {
                 const step = cellSize / subN;
                 const jitterAmp = step * 0.35;
                 // top surface stack index = total number of ground/ceiling - 1
-                const topStackIndex = Math.max(0, interpreter.countCalls([row, col], (c) => c.name === "ground" || c.name === "ceiling") - 1);
+                const topStackIndex = Math.max(0, interpreter.countCalls({ row, col }, (c) => c.name === "ground" || c.name === "ceiling") - 1);
                 perCell[row][col] = {
                     subN,
                     jitterAmp,
@@ -101,8 +101,7 @@ export class GrassMesh extends InstancedMesh {
                 const nb = neighbors;
                 const step = cellSize / subN;
                 // Cell center
-                const cx = (col - cols / 2 + 0.5) * cellSize;
-                const cz = (row - rows / 2 + 0.5) * cellSize;
+                const { x: cx, z: cz } = interpreter.gridToWorld({ row, col });
                 for (let gz = 0; gz < subN; gz++) {
                     for (let gx = 0; gx < subN; gx++) {
                         // Optimization: Check stochastic rejection early using simplified fade check
@@ -144,16 +143,16 @@ export class GrassMesh extends InstancedMesh {
                         if (Math.random() >= f)
                             continue;
                         // --- Instance is accepted ---
-                        // Position
-                        const ox = -cellSize * 0.5 + (gx + 0.5) * step;
-                        const oz = -cellSize * 0.5 + (gz + 0.5) * step;
+                        // Position (offset from cell center)
+                        const offsetX = -cellSize * 0.5 + (gx + 0.5) * step;
+                        const offsetZ = -cellSize * 0.5 + (gz + 0.5) * step;
                         const jx = (Math.random() * 2 - 1) * jitterAmp;
                         const jz = (Math.random() * 2 - 1) * jitterAmp;
-                        const px = cx + ox + jx;
-                        const pz = cz + oz + jz;
+                        const px = cx + offsetX + jx;
+                        const pz = cz + offsetZ + jz;
                         let baseY = 0;
                         if (tilesGeometry) {
-                            baseY = tilesGeometry.getHeight(row, col, topStackIndex, px - cx, pz - cz);
+                            baseY = tilesGeometry.getHeightAt({ row, col, offsetX: offsetX + jx, offsetZ: offsetZ + jz }, { stackIndex: topStackIndex });
                         }
                         tmpPos.set(px, baseY, pz);
                         // Scale

package/dist/interpreter.d.ts

@@ -1,7 +1,8 @@
 import { output, ZodObject } from 'zod';
 import { Call } from './parser.js';
 import { ChartaError, ErrorLocation } from './errors.js';
-import { cellSizeSchema } from './schemas.js';
+import { cellSizeSchema, GridCoord, WorldCoord } from './schemas.js';
+export type { GridCoord, WorldCoord };
 export { cellSizeSchema as cellSizeFunctionParams };
 export type InterpreterOptions = {
     throwOnError?: boolean;
@@ -19,13 +20,14 @@ export declare class Interpreter {
     private readonly sourceLines;
     getSource(): string;
     getLineTextForRow(row: number): string;
-    getWorldCellCenter(row: number, col: number): [number, number];
+    gridToWorld(coord: GridCoord): WorldCoord;
+    worldToGrid(coord: WorldCoord): GridCoord;
     getRows(): number;
     getCols(): number;
-    countCalls(index: [number, number] | undefined, filter: string | ((call: Call) => boolean), startAt?: number, endAtExcl?: number): number;
+    countCalls(coord: GridCoord | undefined, filter: string | ((call: Call) => boolean), startAt?: number, endAtExcl?: number): number;
     getCalls<T extends {
         [Key in string]: ZodObject<any>;
-    }>(index: [number, number] | undefined, callSchemas: T): Array<{
+    }>(coord: GridCoord | undefined, callSchemas: T): Array<{
         [Key in keyof T]: [Key, output<T[Key]>, number, {
             line: number;
             column: number;

package/dist/interpreter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../src/interpreter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAa,MAAM,KAAK,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,CAAA;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAS;gBAGV,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAK,EAChC,MAAM,EAAE,MAAM,EAC/B,OAAO,GAAE,kBAAuB;IAelC,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAOrC,SAAS,IAAI,WAAW,EAAE;IAI1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IAEtC,SAAS,IAAI,MAAM;IAInB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAMtC,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAO9D,OAAO,IAAI,MAAM;IAKjB,OAAO,IAAI,MAAM;IAKjB,UAAU,CACR,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACnC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,EAC1C,OAAO,GAAE,MAAU,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM;IAgBT,QAAQ,CAAC,CAAC,SAAS;SAAG,GAAG,IAAI,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC;KAAE,EACpD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACnC,WAAW,EAAE,CAAC,GACb,KAAK,CACN;SACG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;KACpG,CAAC,MAAM,CAAC,CAAC,CACX;IA0GD,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,uBAAuB;IAa/B,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE;QAAE,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;KAAE,EAAE,IAAI,GAAE,MAAyB,GAAG,CAAC,GAAG,SAAS;IAWlH,QAAQ,CAAC,CAAC,EACR,WAAW,EAAE;QAAE,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;KAAE,EAC7C,IAAI,GAAE,MAAyB,EAC/B,GAAG,CAAC,EAAE,aAAa,GAClB,CAAC,GAAG,SAAS;IAmBhB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAIxC,WAAW,IAAI,MAAM;CAStB"}
+{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../src/interpreter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAa,MAAM,KAAK,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEpE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;AAErC,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,CAAA;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAS;gBAGV,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAK,EAChC,MAAM,EAAE,MAAM,EAC/B,OAAO,GAAE,kBAAuB;IAelC,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAOrC,SAAS,IAAI,WAAW,EAAE;IAI1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IAEtC,SAAS,IAAI,MAAM;IAInB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAMtC,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU;IAUzC,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS;IAsBzC,OAAO,IAAI,MAAM;IAKjB,OAAO,IAAI,MAAM;IAKjB,UAAU,CACR,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,EAC1C,OAAO,GAAE,MAAU,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM;IAgBT,QAAQ,CAAC,CAAC,SAAS;SAAG,GAAG,IAAI,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC;KAAE,EACpD,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,WAAW,EAAE,CAAC,GACb,KAAK,CACN;SACG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;KACpG,CAAC,MAAM,CAAC,CAAC,CACX;IA0GD,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,uBAAuB;IAa/B,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE;QAAE,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;KAAE,EAAE,IAAI,GAAE,MAAyB,GAAG,CAAC,GAAG,SAAS;IAWlH,QAAQ,CAAC,CAAC,EACR,WAAW,EAAE;QAAE,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;KAAE,EAC7C,IAAI,GAAE,MAAyB,EAC/B,GAAG,CAAC,EAAE,aAAa,GAClB,CAAC,GAAG,SAAS;IAmBhB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAIxC,WAAW,IAAI,MAAM;CAStB"}

package/dist/interpreter.js

@@ -40,11 +40,31 @@ export class Interpreter {
         const lineNumber = row + 2;
         return this.sourceLines[lineNumber - 1] ?? '';
     }
-    getWorldCellCenter(row, col) {
+    gridToWorld(coord) {
         const cellSize = this.getCellSize();
-        const worldCellCenterX = (col - this.getCols() / 2 + 0.5) * cellSize;
-        const worldCellCenterZ = (row - this.getRows() / 2 + 0.5) * cellSize;
-        return [worldCellCenterX, worldCellCenterZ];
+        const cx = (coord.col - this.getCols() / 2 + 0.5) * cellSize;
+        const cz = (coord.row - this.getRows() / 2 + 0.5) * cellSize;
+        return {
+            x: cx + (coord.offsetX ?? 0),
+            z: cz + (coord.offsetZ ?? 0),
+        };
+    }
+    worldToGrid(coord) {
+        const cellSize = this.getCellSize();
+        const cols = this.getCols();
+        const rows = this.getRows();
+        const rawCol = coord.x / cellSize + cols / 2 - 0.5;
+        const rawRow = coord.z / cellSize + rows / 2 - 0.5;
+        const col = Math.floor(rawCol);
+        const row = Math.floor(rawRow);
+        const cellCenterX = (col - cols / 2 + 0.5) * cellSize;
+        const cellCenterZ = (row - rows / 2 + 0.5) * cellSize;
+        return {
+            row,
+            col,
+            offsetX: coord.x - cellCenterX,
+            offsetZ: coord.z - cellCenterZ,
+        };
     }
     getRows() {
         // Exclude meta row
@@ -54,9 +74,9 @@ export class Interpreter {
         // Use first grid row, if present
         return this.ast.length > 1 ? this.ast[1].length : 0;
     }
-    countCalls(index, filter, startAt = 0, endAtExcl) {
+    countCalls(coord, filter, startAt = 0, endAtExcl) {
         let sum = 0;
-        const calls = index == null ? this.ast[0][0] : this.ast[index[0] + 1][index[1]];
+        const calls = coord == null ? this.ast[0][0] : this.ast[coord.row + 1][coord.col];
         const length = Math.min(endAtExcl ?? Infinity, calls.length);
         for (let i = startAt; i < length; i++) {
             if (typeof filter === 'string' && calls[i].name != filter) {
@@ -69,28 +89,28 @@ export class Interpreter {
         }
         return sum;
     }
-    getCalls(index, callSchemas) {
+    getCalls(coord, callSchemas) {
         let calls;
         const normalizedSource = this.normalizedSource;
         const sourceLines = this.sourceLines;
         let lineNumber = 1;
         let lineText = sourceLines[0] ?? '';
         let callStartColumns = [];
-        if (index == null) {
+        if (coord == null) {
             calls = this.ast[0][0];
             callStartColumns = this.computeCallStartColumns(lineText);
         }
         else {
-            const row = index[0] + 1;
-            const col = index[1];
+            const row = coord.row + 1;
+            const col = coord.col;
             if (row >= this.ast.length || col >= this.ast[row].length) {
-                const lineNumber = index[0] + 2;
+                const lineNumber = coord.row + 2;
                 const lineText = sourceLines[lineNumber - 1] ?? '';
                 this.reportError(new ChartaError(`index ${col}/${row} cannot be used to index the ast (${this.ast.length}/${this.ast[Math.min(1, this.ast.length - 1)].length})`, normalizedSource, { line: lineNumber, column: 1, lineText }));
                 return []; // Return empty if index invalid
             }
             calls = this.ast[row][col];
-            lineNumber = index[0] + 2;
+            lineNumber = coord.row + 2;
             lineText = sourceLines[lineNumber - 1] ?? '';
             const [cellStart, cellEnd] = this.getCellBounds(lineText, col);
             const cellText = lineText.slice(cellStart, cellEnd);

package/dist/locations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../src/locations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAG9C,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,CAAA;AAEzB,qBAAa,SAAS;IACpB,SAAgB,cAAc,uBAA6B;gBAE/C,WAAW,EAAE,WAAW;IAgCpC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;CAOzD"}
+{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../src/locations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAG9C,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,CAAA;AAEzB,qBAAa,SAAS;IACpB,SAAgB,cAAc,uBAA6B;gBAE/C,WAAW,EAAE,WAAW;IA8BpC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;CAOzD"}

package/dist/locations.js

@@ -12,7 +12,7 @@ export class Locations {
         const isLayer = (c) => c.name === 'ground' || c.name === 'ceiling';
         for (let row = 0; row < rows; row++) {
             for (let col = 0; col < cols; col++) {
-                const entries = interpreter.getCalls([row, col], { location: locationSchema });
+                const entries = interpreter.getCalls({ row, col }, { location: locationSchema });
                 for (const [, parsed, callIdx, loc] of entries) {
                     const name = parsed.name;
                     if (this.worldPositions.has(name)) {
@@ -21,12 +21,10 @@ export class Locations {
                     }
                     const offsetX = parsed.offsetX ?? 0;
                     const offsetZ = parsed.offsetZ ?? 0;
-                    const [cx, cz] = interpreter.getWorldCellCenter(row, col);
-                    const x = cx + offsetX;
-                    const z = cz + offsetZ;
-                    const layersBefore = interpreter.countCalls([row, col], isLayer, 0, callIdx);
+                    const { x, z } = interpreter.gridToWorld({ row, col, offsetX, offsetZ });
+                    const layersBefore = interpreter.countCalls({ row, col }, isLayer, 0, callIdx);
                     const stackIndex = layersBefore > 0 ? layersBefore - 1 : 0;
-                    const y = tilesGeometry?.getHeight(row, col, stackIndex, offsetX, offsetZ) ?? 0;
+                    const y = tilesGeometry?.getHeightAt({ row, col, offsetX, offsetZ }, { stackIndex }) ?? 0;
                     this.worldPositions.set(name, new Vector3(x, y, z));
                 }
             }

package/dist/pillars/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pillars/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EAEb,QAAQ,EAMT,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAQ/C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,CAAA;AAYhF,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,qBAAa,UAAW,SAAQ,aAAa;gBAC/B,WAAW,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAkC,EAAE,OAAO,GAAE,iBAAsB;CA4LpH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pillars/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EAEb,QAAQ,EAMT,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAQ/C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,CAAA;AAYhF,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,qBAAa,UAAW,SAAQ,aAAa;gBAC/B,WAAW,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAkC,EAAE,OAAO,GAAE,iBAAsB;CA+LpH"}

package/dist/pillars/index.js

@@ -28,31 +28,30 @@ export class PillarMesh extends InstancedMesh {
             return idx;
         };
         function resolveCornerPosition(row, col, corner) {
-            const [cx, cz] = interpreter.getWorldCellCenter(row, col);
             const half = cellSize * 0.5;
-            switch (corner) {
-                case 'topleft':
-                    return [cx - half, cz - half];
-                case 'topright':
-                    return [cx + half, cz - half];
-                case 'bottomright':
-                    return [cx + half, cz + half];
-                case 'bottomleft':
-                    return [cx - half, cz + half];
-                default: {
-                    const lineNumber = row + 2;
-                    const lineText = interpreter.getLineTextForRow(row);
-                    const pos = lineText.indexOf('pillar(');
-                    const columnNumber = pos >= 0 ? pos + 1 : 1;
-                    interpreter.reportError(new ChartaError(`pillar at ${row}/${col}: invalid corner "${corner}", expected one of topleft, topright, bottomright, bottomleft`, interpreter.getSource(), { line: lineNumber, column: columnNumber, lineText }));
-                    return undefined;
-                }
+            const offsets = {
+                topleft: [-half, -half],
+                topright: [half, -half],
+                bottomright: [half, half],
+                bottomleft: [-half, half],
+            };
+            const offset = offsets[corner];
+            if (offset) {
+                const { x, z } = interpreter.gridToWorld({ row, col, offsetX: offset[0], offsetZ: offset[1] });
+                return [x, z];
             }
+            // Invalid corner
+            const lineNumber = row + 2;
+            const lineText = interpreter.getLineTextForRow(row);
+            const pos = lineText.indexOf('pillar(');
+            const columnNumber = pos >= 0 ? pos + 1 : 1;
+            interpreter.reportError(new ChartaError(`pillar at ${row}/${col}: invalid corner "${corner}", expected one of topleft, topright, bottomright, bottomleft`, interpreter.getSource(), { line: lineNumber, column: columnNumber, lineText }));
+            return undefined;
         }
         // Validation loop runs in both modes
         for (let row = 0; row < rows; row++) {
             for (let col = 0; col < cols; col++) {
-                const entries = interpreter.getCalls([row, col], {
+                const entries = interpreter.getCalls({ row, col }, {
                     pillar: pillarSchema,
                 });
                 for (const [, parsed, idx, loc] of entries) {
@@ -62,9 +61,7 @@ export class PillarMesh extends InstancedMesh {
                     if (!cornerPos)
                         continue;
                     const [px, pz] = cornerPos;
-                    const [cx, cz] = interpreter.getWorldCellCenter(row, col);
-                    const offsetX = px - cx;
-                    const offsetZ = pz - cz;
+                    const { offsetX, offsetZ } = interpreter.worldToGrid({ x: px, z: pz });
                     // Validate texture reference (runs in both modes)
                     const textureId = getTextureId(parsed.texture, loc);
                     // Derive default layers relative to call position (like walls)
@@ -74,7 +71,7 @@ export class PillarMesh extends InstancedMesh {
                     // Validate layer existence (runs in both modes)
                     let bottomStackIndex;
                     if (bottomY == null) {
-                        const layersBefore = interpreter.countCalls([row, col], isLayer, 0, idx);
+                        const layersBefore = interpreter.countCalls({ row, col }, isLayer, 0, idx);
                         bottomStackIndex = layersBefore - 1;
                         if (bottomStackIndex < 0) {
                             interpreter.reportError(new ChartaError(`pillar at ${row}/${col}: missing bottomY and no preceding layer`, interpreter.getSource(), loc));
@@ -85,24 +82,24 @@ export class PillarMesh extends InstancedMesh {
                             const tilesGeometry = interpreter.getAsset(TilesGeometry, 'tilesGeometry', loc);
                             if (!tilesGeometry)
                                 continue;
-                            bottomY = tilesGeometry.getHeight(row, col, bottomStackIndex, offsetX, offsetZ);
+                            bottomY = tilesGeometry.getHeightAt({ row, col, offsetX, offsetZ }, { stackIndex: bottomStackIndex });
                         }
                     }
                     let topStackIndex;
                     if (topY == null) {
-                        const layersAfter = interpreter.countCalls([row, col], isLayer, idx + 1);
+                        const layersAfter = interpreter.countCalls({ row, col }, isLayer, idx + 1);
                         if (layersAfter <= 0) {
                             interpreter.reportError(new ChartaError(`pillar at ${row}/${col}: missing topY and no subsequent layer`, interpreter.getSource(), loc));
                             continue;
                         }
                         // Height sampling only in non-validateOnly mode
                         if (!options.validateOnly) {
-                            const layersBefore = interpreter.countCalls([row, col], isLayer, 0, idx);
+                            const layersBefore = interpreter.countCalls({ row, col }, isLayer, 0, idx);
                             topStackIndex = layersBefore;
                             const tilesGeometry = interpreter.getAsset(TilesGeometry, 'tilesGeometry', loc);
                             if (!tilesGeometry)
                                 continue;
-                            topY = tilesGeometry.getHeight(row, col, topStackIndex, offsetX, offsetZ);
+                            topY = tilesGeometry.getHeightAt({ row, col, offsetX, offsetZ }, { stackIndex: topStackIndex });
                         }
                     }
                     // Only collect pillar data in non-validateOnly mode

package/dist/place/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/place/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAQ,MAAM,OAAO,CAAA;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAO/C,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;AAEvD,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE;IACvC,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,UAAU,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,WAAW,CAAA;IACxB,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;IAC5D,IAAI,EAAE,MAAM,CAAA;CACb,KAAK,IAAI,CAAA;AAKV,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAOvD;AAED,qBAAa,kBAAkB;aAIX,UAAU,EAAE,OAAO;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAJpC,SAAgB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAK;gBAG3B,UAAU,EAAE,OAAO,EAClB,iBAAiB,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ;IAG5E,GAAG,CAAC,MAAM,EAAE,OAAO;IAKZ,KAAK,IAAI,QAAQ;CAGzB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAA;CACjC,CAAA;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,aAAa,kCAAwC;gBAEzD,WAAW,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,GAAE,iBAAsB;IAuPhG,OAAO;CAOR"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/place/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAQ,MAAM,OAAO,CAAA;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAO/C,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;AAEvD,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE;IACvC,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,UAAU,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,WAAW,CAAA;IACxB,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;IAC5D,IAAI,EAAE,MAAM,CAAA;CACb,KAAK,IAAI,CAAA;AAKV,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAOvD;AAED,qBAAa,kBAAkB;aAIX,UAAU,EAAE,OAAO;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAJpC,SAAgB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAK;gBAG3B,UAAU,EAAE,OAAO,EAClB,iBAAiB,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ;IAG5E,GAAG,CAAC,MAAM,EAAE,OAAO;IAKZ,KAAK,IAAI,QAAQ;CAGzB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAA;CACjC,CAAA;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,aAAa,kCAAwC;gBAEzD,WAAW,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,GAAE,iBAAsB;IAkPhG,OAAO;CAOR"}

package/dist/place/index.js

@@ -61,18 +61,17 @@ export class PlaceGroup extends Group {
             const scale = Math.min(sFactorX ?? sFactorZ ?? 1, sFactorZ ?? sFactorX ?? 1);
             return new Vector3(scale, scale, scale);
         };
-        const computeTransform = (px, pz, cell, transformOpts) => {
+        const computeTransform = (worldX, worldZ, cell, transformOpts) => {
             const normal = new Vector3();
-            const offsetX = px - cell.center[0];
-            const offsetZ = pz - cell.center[1];
+            const { offsetX, offsetZ } = interpreter.worldToGrid({ x: worldX, z: worldZ });
             let py = 0;
             if (transformOpts.useFixedY) {
                 py = transformOpts.fixedY;
             }
             else {
-                py = tilesGeometry.getHeight(cell.row, cell.col, transformOpts.layerIndex, offsetX, offsetZ, normal);
+                py = tilesGeometry.getHeightAt({ row: cell.row, col: cell.col, offsetX, offsetZ }, { stackIndex: transformOpts.layerIndex, normalTarget: normal });
             }
-            const pos = new Vector3(px, py, pz);
+            const pos = new Vector3(worldX, py, worldZ);
             const quat = new Quaternion();
             if (transformOpts.alignMode === 'normal' && !transformOpts.useFixedY) {
                 const qAlign = new Quaternion().setFromUnitVectors(new Vector3(0, 1, 0), normal);
@@ -90,19 +89,18 @@ export class PlaceGroup extends Group {
         for (let row = 0; row < rows; row++) {
             for (let col = 0; col < cols; col++) {
                 // getCalls validates the schema and reports errors
-                const scatterEntries = interpreter.getCalls([row, col], { scatter: scatterSchema });
-                const placeEntries = interpreter.getCalls([row, col], { place: placeSchema });
+                const scatterEntries = interpreter.getCalls({ row, col }, { scatter: scatterSchema });
+                const placeEntries = interpreter.getCalls({ row, col }, { place: placeSchema });
                 if (scatterEntries.length === 0 && placeEntries.length === 0)
                     continue;
-                const cx = (col - cols / 2 + 0.5) * cellSize;
-                const cz = (row - rows / 2 + 0.5) * cellSize;
+                const { x: cx, z: cz } = interpreter.gridToWorld({ row, col });
                 const half = cellSize * 0.5;
                 // Collect location points in this cell for collision/footprint validation
-                const locationEntries = interpreter.getCalls([row, col], { location: locationSchema });
-                const locationPoints = locationEntries.map(([, parsed]) => ({
-                    x: cx + (parsed.offsetX ?? 0),
-                    z: cz + (parsed.offsetZ ?? 0),
-                }));
+                const locationEntries = interpreter.getCalls({ row, col }, { location: locationSchema });
+                const locationPoints = locationEntries.map(([, parsed]) => {
+                    const { x, z } = interpreter.gridToWorld({ row, col, offsetX: parsed.offsetX, offsetZ: parsed.offsetZ });
+                    return { x, z };
+                });
                 // scatter: randomized distribution
                 for (const [, parsed, callIdx, loc] of scatterEntries) {
                     const prefabName = `${parsed.model}Prefab`;
@@ -115,7 +113,7 @@ export class PlaceGroup extends Group {
                     this.batchBuilders.set(parsed.model, batchBuilder);
                     const usualSize = new Vector3();
                     usualSize.copy(batchBuilder.prefabSize);
-                    const layerIndex = interpreter.countCalls([row, col], (c) => c.name === 'ground' || c.name === 'ceiling', 0, callIdx) - 1;
+                    const layerIndex = interpreter.countCalls({ row, col }, (c) => c.name === 'ground' || c.name === 'ceiling', 0, callIdx) - 1;
                     const base = hashStringToUint32(parsed.model);
                     const seed = hashNumbersToUint32(base, row, col);
                     const rng = createRng(seed);
@@ -143,7 +141,7 @@ export class PlaceGroup extends Group {
                         const px = cx + ox;
                         const pz = cz + oz;
                         const yaw = yawMin === yawMax ? yawMin : yawMin + (yawMax - yawMin) * rng();
-                        const { pos, quat, scl } = computeTransform(px, pz, { row, col, center: [cx, cz] }, {
+                        const { pos, quat, scl } = computeTransform(px, pz, { row, col }, {
                             alignMode,
                             yaw,
                             useFixedY: useFixedY,
@@ -174,8 +172,12 @@ export class PlaceGroup extends Group {
                     if (!batchBuilder)
                         continue;
                     const usualSize = batchBuilder.prefabSize;
-                    const px = cx + (parsed.offsetX ?? 0);
-                    const pz = cz + (parsed.offsetZ ?? 0);
+                    const { x: px, z: pz } = interpreter.gridToWorld({
+                        row,
+                        col,
+                        offsetX: parsed.offsetX,
+                        offsetZ: parsed.offsetZ,
+                    });
                     // Compute scale for footprint validation (needed for both validateOnly and normal mode)
                     const scale = computeScale(usualSize, parsed.sizeX, parsed.sizeZ);
                     const halfX = (usualSize.x * scale.x) / 2;
@@ -190,10 +192,10 @@ export class PlaceGroup extends Group {
                     if (validateOnly)
                         continue;
                     this.batchBuilders.set(parsed.model, batchBuilder);
-                    const layerIndex = interpreter.countCalls([row, col], (c) => c.name === 'ground' || c.name === 'ceiling', 0, callIdx) - 1;
+                    const layerIndex = interpreter.countCalls({ row, col }, (c) => c.name === 'ground' || c.name === 'ceiling', 0, callIdx) - 1;
                     const yaw = parsed.yaw ?? 0;
                     const alignMode = (parsed.align ?? 'up').toLowerCase();
-                    const { pos, quat, scl } = computeTransform(px, pz, { row, col, center: [cx, cz] }, {
+                    const { pos, quat, scl } = computeTransform(px, pz, { row, col }, {
                         alignMode,
                         yaw,
                         useFixedY: parsed.bottomY != null,

package/dist/schemas.d.ts

@@ -1,4 +1,22 @@
 import { coerce } from 'zod';
+/**
+ * Grid coordinate with optional offset from cell center.
+ * row/col are integer indices into the grid.
+ * offsetX/offsetZ are in meters from the cell center.
+ */
+export type GridCoord = {
+    row: number;
+    col: number;
+    offsetX?: number;
+    offsetZ?: number;
+};
+/**
+ * World coordinate in meters (top-down X/Z plane).
+ */
+export type WorldCoord = {
+    x: number;
+    z: number;
+};
 export declare const alignEnum: import("zod").ZodEnum<{
     up: "up";
     normal: "normal";

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmC,MAAM,KAAK,CAAA;AAM7D,eAAO,MAAM,SAAS;;;EAA4B,CAAA;AAClD,eAAO,MAAM,UAAU;;;;;EAAgE,CAAA;AACvF,eAAO,MAAM,WAAW;;;;;EAA8C,CAAA;AAMtE,eAAO,MAAM,cAAc;;gCAAoC,CAAA;AAC/D,eAAO,MAAM,cAAc;;gCAA6B,CAAA;AACxD,eAAO,MAAM,iBAAiB;;;gCAA6C,CAAA;AAC3E,eAAO,MAAM,eAAe;;;gCAA6C,CAAA;AAMzE,eAAO,MAAM,YAAY;;;gCAAoD,CAAA;AAC7E,eAAO,MAAM,aAAa;;;gCAAoD,CAAA;AAC9E,eAAO,MAAM,WAAW;;gCAAiC,CAAA;AAMzD,eAAO,MAAM,UAAU;;;;;;;;;;gCAKrB,CAAA;AAEF,eAAO,MAAM,YAAY;;;;;gCAKvB,CAAA;AAEF,eAAO,MAAM,UAAU;;;;;;gCAMrB,CAAA;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;gCAOvB,CAAA;AAMF,eAAO,MAAM,cAAc;;;;gCAIzB,CAAA;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;gCAStB,CAAA;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;gCAcxB,CAAA;AAMF,eAAO,MAAM,WAAW;;;;gCAItB,CAAA;AAMF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmC,MAAM,KAAK,CAAA;AAM7D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAMD,eAAO,MAAM,SAAS;;;EAA4B,CAAA;AAClD,eAAO,MAAM,UAAU;;;;;EAAgE,CAAA;AACvF,eAAO,MAAM,WAAW;;;;;EAA8C,CAAA;AAMtE,eAAO,MAAM,cAAc;;gCAAoC,CAAA;AAC/D,eAAO,MAAM,cAAc;;gCAA6B,CAAA;AACxD,eAAO,MAAM,iBAAiB;;;gCAA6C,CAAA;AAC3E,eAAO,MAAM,eAAe;;;gCAA6C,CAAA;AAMzE,eAAO,MAAM,YAAY;;;gCAAoD,CAAA;AAC7E,eAAO,MAAM,aAAa;;;gCAAoD,CAAA;AAC9E,eAAO,MAAM,WAAW;;gCAAiC,CAAA;AAMzD,eAAO,MAAM,UAAU;;;;;;;;;;gCAKrB,CAAA;AAEF,eAAO,MAAM,YAAY;;;;;gCAKvB,CAAA;AAEF,eAAO,MAAM,UAAU;;;;;;gCAMrB,CAAA;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;gCAOvB,CAAA;AAMF,eAAO,MAAM,cAAc;;;;gCAIzB,CAAA;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;gCAStB,CAAA;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;gCAcxB,CAAA;AAMF,eAAO,MAAM,WAAW;;;;gCAItB,CAAA;AAMF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET"}

package/dist/tiles/geometry.d.ts

@@ -1,4 +1,17 @@
 import { BufferGeometry, Vector3 } from 'three';
+import type { GridCoord } from '../schemas.js';
+export type GetHeightAtOptions = {
+    /**
+     * index in the tile stack
+     * use 0 for the lowest and Infinity for the highest
+     * @default infinity
+     */
+    stackIndex?: number;
+    /**
+     * optional target vector that will receive the interpolated face normal at the queried point
+     */
+    normalTarget?: Vector3;
+};
 export type Tile = {
     type: string;
     y: number;
@@ -30,15 +43,7 @@ export declare class TilesGeometry extends BufferGeometry {
         bottom: Array<WallData>;
         left: Array<WallData>;
     }>>, mapSizeX: number, mapSizeZ: number);
-    /**
-     * @param row tile grid row index (Z direction)
-     * @param col tile grid column index (X direction)
-     * @param stackIndex index in the tile stack
-     * @param offsetX world unit offset from tile center X
-     * @param offsetZ world unit offset from tile center Z
-     * @param normalTarget optional target vector that will receive the interpolated face normal at the queried point
-     */
-    getHeight(row: number, col: number, stackIndex?: number, offsetX?: number, offsetZ?: number, normalTarget?: Vector3): number;
+    getHeightAt({ row, col, offsetX, offsetZ }: GridCoord, { normalTarget, stackIndex }?: GetHeightAtOptions): number;
     private addVertex;
     private getVertices;
     private getConnectionVertexId;

package/dist/tiles/geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/tiles/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAMd,OAAO,EACR,MAAM,OAAO,CAAA;AAGd,MAAM,MAAM,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAoB3F,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAkQxD,qBAAa,aAAc,SAAQ,cAAc;IAe7C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;aAQN,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;IAxBlC,SAAgB,SAAS,EAAE,MAAM,CAAA;IACjC,SAAgB,SAAS,EAAE,MAAM,CAAA;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IAErD,OAAO,CAAC,SAAS,CAAI;IAErB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;gBAG7C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAChC,KAAK,EAAE,KAAK,CAC3B,KAAK,CAAC;QACJ,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QACpB,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QACtB,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QACvB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;KACtB,CAAC,CACH,EACe,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;IA0ElC;;;;;;;OAOG;IACI,SAAS,CACd,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,MAAU,EACnB,OAAO,GAAE,MAAU,EACnB,YAAY,CAAC,EAAE,OAAO;IAqFxB,OAAO,CAAC,SAAS;IAoGjB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,qBAAqB;CAiB9B"}
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/tiles/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAMd,OAAO,EACR,MAAM,OAAO,CAAA;AAGd,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAoB3F,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAkQxD,qBAAa,aAAc,SAAQ,cAAc;IAe7C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;aAQN,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;IAxBlC,SAAgB,SAAS,EAAE,MAAM,CAAA;IACjC,SAAgB,SAAS,EAAE,MAAM,CAAA;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IAErD,OAAO,CAAC,SAAS,CAAI;IAErB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;gBAG7C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAChC,KAAK,EAAE,KAAK,CAC3B,KAAK,CAAC;QACJ,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QACpB,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QACtB,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QACvB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;KACtB,CAAC,CACH,EACe,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;IA0E3B,WAAW,CAChB,EAAE,GAAG,EAAE,GAAG,EAAE,OAAW,EAAE,OAAW,EAAE,EAAE,SAAS,EACjD,EAAE,YAAY,EAAE,UAAqB,EAAE,GAAE,kBAAuB;IAiFlE,OAAO,CAAC,SAAS;IAoGjB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,qBAAqB;CAiB9B"}

package/dist/tiles/geometry.js

@@ -1,5 +1,6 @@
 import { BufferGeometry, Float32BufferAttribute, Uint16BufferAttribute, } from 'three';
 import { isLayerConnectedToWall } from '../walls/index.js';
+import { clamp } from 'three/src/math/MathUtils.js';
 const MAX_AUTO_CONNECT_HEIGHT_DIFF_RATIO = 1 / 4;
 const MAX_CONNECTION_HEIGHT_DIFF_RATIO = 8;
 function isBetterConnection(newConnection, oldConnection, tileSize) {
@@ -293,20 +294,12 @@ export class TilesGeometry extends BufferGeometry {
         this.computeVertexNormals();
         this.computeTangents();
     }
-    /**
-     * @param row tile grid row index (Z direction)
-     * @param col tile grid column index (X direction)
-     * @param stackIndex index in the tile stack
-     * @param offsetX world unit offset from tile center X
-     * @param offsetZ world unit offset from tile center Z
-     * @param normalTarget optional target vector that will receive the interpolated face normal at the queried point
-     */
-    getHeight(row, col, stackIndex, offsetX = 0, offsetZ = 0, normalTarget) {
+    getHeightAt({ row, col, offsetX = 0, offsetZ = 0 }, { normalTarget, stackIndex = Infinity } = {}) {
         if (col < 0 || col >= this.tiles[0].length || row < 0 || row >= this.tiles.length) {
             throw new Error(`Tile index out of bounds: (row=${row}, col=${col}). Grid size: ${this.tiles.length}x${this.tiles[0].length}`);
         }
         const vertices = this.getVertices(col, row);
-        const vertex1 = vertices[stackIndex ?? vertices.length - 1];
+        const vertex1 = vertices[clamp(stackIndex, 0, vertices.length - 1)];
         if (vertex1 == null) {
             throw new Error(`No vertex found at stack index "${stackIndex ?? 'any'}" for tile (row=${row}, col=${col}).`);
         }

package/dist/tiles/index.d.ts

@@ -1,7 +1,7 @@
 import { Material, Mesh } from 'three';
 import { Interpreter } from '../interpreter.js';
-import { TilesGeometry } from './geometry.js';
-import { groundSchema, ceilingSchema } from '../schemas.js';
+import { GetHeightAtOptions, TilesGeometry } from './geometry.js';
+import { groundSchema, ceilingSchema, GridCoord } from '../schemas.js';
 export { groundSchema, ceilingSchema };
 export type TilesMeshOptions = {
     /**
@@ -13,5 +13,7 @@ export type TilesMeshOptions = {
 };
 export declare class TilesMesh extends Mesh<TilesGeometry> {
     constructor(interpreter: Interpreter, material?: Material, options?: TilesMeshOptions);
+    getHeightAt(coord: GridCoord, options?: GetHeightAtOptions): number;
+    dispose(): void;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/tiles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tiles/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EACR,IAAI,EAOL,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAuB,MAAM,eAAe,CAAA;AAIlE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAc,MAAM,eAAe,CAAA;AAGvE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA;AAEtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAA;AAyCD,qBAAa,SAAU,SAAQ,IAAI,CAAC,aAAa,CAAC;gBACpC,WAAW,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAkC,EAAE,OAAO,GAAE,gBAAqB;CAqInH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tiles/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EACR,IAAI,EAOL,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAuB,MAAM,eAAe,CAAA;AAItF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAc,SAAS,EAAE,MAAM,eAAe,CAAA;AAGlF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA;AAEtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAA;AAyCD,qBAAa,SAAU,SAAQ,IAAI,CAAC,aAAa,CAAC;gBACpC,WAAW,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAkC,EAAE,OAAO,GAAE,gBAAqB;IAyIlH,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAI1D,OAAO,IAAI,IAAI;CAMhB"}

package/dist/tiles/index.js

@@ -1,4 +1,4 @@
-import { Mesh, Texture, MeshBasicMaterial, } from 'three';
+import { Material, Mesh, Texture, MeshBasicMaterial, } from 'three';
 import { TilesGeometry } from './geometry.js';
 import { buildTilesMaterial } from './material.js';
 import { ChartaError } from '../errors.js';
@@ -66,7 +66,7 @@ export class TilesMesh extends Mesh {
         for (let row = 0; row < rows; row++) {
             for (let col = 0; col < cols; col++) {
                 // Collect and validate all entries for this cell
-                const calls = Array.from(interpreter.getCalls([row, col], {
+                const calls = Array.from(interpreter.getCalls({ row, col }, {
                     ground: groundSchema,
                     ceiling: ceilingSchema,
                     wall: wallSchema,
@@ -138,4 +138,13 @@ export class TilesMesh extends Mesh {
         setupBVH(this.geometry);
         this.raycast = acceleratedRaycast;
     }
+    getHeightAt(coord, options) {
+        return this.geometry.getHeightAt(coord, options);
+    }
+    dispose() {
+        this.geometry.dispose();
+        if (this.material instanceof Material) {
+            this.material.dispose();
+        }
+    }
 }

package/dist/walls/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/walls/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAER,IAAI,EAGJ,YAAY,EAEZ,YAAY,EAOb,MAAM,OAAO,CAAA;AAEd,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAe,aAAa,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAGL,UAAU,EACV,YAAY,EACZ,UAAU,EACX,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,CAAA;AAK/C,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,MAAM,EAAE,YAAY,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,YAAY,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,UAAU,EAAE,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;CAed,CAAA;AAEV,eAAO,MAAM,+BAA+B,QAAQ,CAAA;AAEpD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACxD,MAAM,EAAE,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,EACtD,GAAG,EAAE,aAAa;YAsFO,YAAY;UACd,YAAY;;;cAwDpC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,qBAAa,QAAS,SAAQ,IAAI;gBACpB,WAAW,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAkC,EAAE,OAAO,GAAE,eAAoB;CAkTlH;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAGrG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/walls/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAER,IAAI,EAGJ,YAAY,EAEZ,YAAY,EAOb,MAAM,OAAO,CAAA;AAEd,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAe,aAAa,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAGL,UAAU,EACV,YAAY,EACZ,UAAU,EACX,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,CAAA;AAK/C,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,MAAM,EAAE,YAAY,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,YAAY,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,UAAU,EAAE,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;CAed,CAAA;AAEV,eAAO,MAAM,+BAA+B,QAAQ,CAAA;AAEpD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACxD,MAAM,EAAE,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,EACtD,GAAG,EAAE,aAAa;YAwFO,YAAY;UACd,YAAY;;;cA8DpC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,qBAAa,QAAS,SAAQ,IAAI;gBACpB,WAAW,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAkC,EAAE,OAAO,GAAE,eAAoB;CAkTlH;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAGrG"}

package/dist/walls/index.js

@@ -43,14 +43,17 @@ export function computeWallVerticalBounds(interpreter, tilesGeometry, row, col,
         neighborCol--;
     else if (parsed.dir === 'right')
         neighborCol++;
-    const [worldCellCenterX, worldCellCenterZ] = interpreter.getWorldCellCenter(row, col);
     const localWallX = ('xOffset' in config ? config.xOffset : 0) * cellSize;
     const localWallZ = ('zOffset' in config ? config.zOffset : 0) * cellSize;
-    const worldWallX = worldCellCenterX + localWallX;
-    const worldWallZ = worldCellCenterZ + localWallZ;
+    const { x: worldWallX, z: worldWallZ } = interpreter.gridToWorld({
+        row,
+        col,
+        offsetX: localWallX,
+        offsetZ: localWallZ,
+    });
     // Determine layer context
-    const layersBefore = interpreter.countCalls([row, col], isLayer, 0, wallIdx);
-    const layersAfter = interpreter.countCalls([row, col], isLayer, wallIdx + 1);
+    const layersBefore = interpreter.countCalls({ row, col }, isLayer, 0, wallIdx);
+    const layersAfter = interpreter.countCalls({ row, col }, isLayer, wallIdx + 1);
     const resolveLayer = (explicitY, isTop) => {
         // Case 1: No explicit height -> connect to adjacent layer in current cell
         if (explicitY === undefined) {
@@ -73,7 +76,7 @@ export function computeWallVerticalBounds(interpreter, tilesGeometry, row, col,
         const checkCell = (r, c) => {
             if (r < 0 || r >= rows || c < 0 || c >= cols)
                 return;
-            const calls = interpreter.getCalls([r, c], { ground: groundSchema, ceiling: ceilingSchema });
+            const calls = interpreter.getCalls({ row: r, col: c }, { ground: groundSchema, ceiling: ceilingSchema });
             for (let i = 0; i < calls.length; i++) {
                 const [, { y: layerY }] = calls[i];
                 const diff = Math.abs(layerY - explicitY);
@@ -120,7 +123,7 @@ export function computeWallVerticalBounds(interpreter, tilesGeometry, row, col,
         if (bottomLayer) {
             const offX = sX + (col - bottomLayer.col) * cellSize;
             const offZ = sZ + (row - bottomLayer.row) * cellSize;
-            yStart[k] = tilesGeometry.getHeight(bottomLayer.row, bottomLayer.col, bottomLayer.layerIdx, offX, offZ);
+            yStart[k] = tilesGeometry.getHeightAt({ row: bottomLayer.row, col: bottomLayer.col, offsetX: offX, offsetZ: offZ }, { stackIndex: bottomLayer.layerIdx });
         }
         else {
             yStart[k] = parsed.bottomY;
@@ -129,7 +132,7 @@ export function computeWallVerticalBounds(interpreter, tilesGeometry, row, col,
         if (topLayer) {
             const offX = sX + (col - topLayer.col) * cellSize;
             const offZ = sZ + (row - topLayer.row) * cellSize;
-            yEnd[k] = tilesGeometry.getHeight(topLayer.row, topLayer.col, topLayer.layerIdx, offX, offZ);
+            yEnd[k] = tilesGeometry.getHeightAt({ row: topLayer.row, col: topLayer.col, offsetX: offX, offsetZ: offZ }, { stackIndex: topLayer.layerIdx });
         }
         else {
             yEnd[k] = parsed.topY;
@@ -176,7 +179,7 @@ export class WallMesh extends Mesh {
         // Validation loop runs in both modes
         for (let row = 0; row < rows; row++) {
             for (let col = 0; col < cols; col++) {
-                const entries = interpreter.getCalls([row, col], {
+                const entries = interpreter.getCalls({ row, col }, {
                     wall: wallSchema,
                     window: windowSchema,
                     door: doorSchema,

package/dist/water/index.d.ts

@@ -1,5 +1,7 @@
-import { Mesh } from "three";
-import { Interpreter } from "../interpreter.js";
+import { Mesh } from 'three';
+import { Interpreter } from '../interpreter.js';
+import { GetHeightAtOptions, TilesGeometry } from '../tiles/geometry.js';
+import { GridCoord } from '../schemas.js';
 export type WaterMeshOptions = {
     /**
      * Validate-only mode: validates water calls but skips geometry creation.
@@ -7,10 +9,11 @@ export type WaterMeshOptions = {
      */
     validateOnly?: boolean;
 };
-export declare class WaterMesh extends Mesh {
+export declare class WaterMesh extends Mesh<TilesGeometry> {
     constructor(interpreter: Interpreter, options?: WaterMeshOptions);
+    getHeightAt(coord: GridCoord, options?: GetHeightAtOptions): number;
     dispose(): void;
 }
-export * from "./texture.js";
-export * from "./material.js";
+export * from './texture.js';
+export * from './material.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/water/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/water/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAY,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAC;AAEF,qBAAa,SAAU,SAAQ,IAAI;gBACrB,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB;IAwDpE,OAAO,IAAI,IAAI;CAMhB;AAED,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/water/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAY,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAa,MAAM,sBAAsB,CAAA;AACnF,OAAO,EAAE,SAAS,EAAe,MAAM,eAAe,CAAA;AAGtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,qBAAa,SAAU,SAAQ,IAAI,CAAC,aAAa,CAAC;gBACpC,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB;IAsDpE,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAI1D,OAAO,IAAI,IAAI;CAMhB;AAED,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}

package/dist/water/index.js

@@ -1,7 +1,7 @@
-import { Mesh, Material } from "three";
-import { TilesGeometry } from "../tiles/geometry.js";
-import { waterSchema } from "../schemas.js";
-import { setupBVH, acceleratedRaycast } from "../utils/bvh.js";
+import { Mesh, Material } from 'three';
+import { TilesGeometry } from '../tiles/geometry.js';
+import { waterSchema } from '../schemas.js';
+import { setupBVH, acceleratedRaycast } from '../utils/bvh.js';
 export class WaterMesh extends Mesh {
     constructor(interpreter, options = {}) {
         const rows = interpreter.getRows();
@@ -9,20 +9,18 @@ export class WaterMesh extends Mesh {
         // Build tiles only in non-validateOnly mode (expensive allocation)
         let tiles;
         if (!options.validateOnly) {
-            tiles = new Array(rows)
-                .fill(undefined)
-                .map(() => new Array(cols).fill(undefined).map(() => []));
+            tiles = new Array(rows).fill(undefined).map(() => new Array(cols).fill(undefined).map(() => []));
         }
         // Validation loop runs in both modes
         for (let row = 0; row < rows; row++) {
             for (let col = 0; col < cols; col++) {
-                const entries = interpreter.getCalls([row, col], { water: waterSchema });
+                const entries = interpreter.getCalls({ row, col }, { water: waterSchema });
                 // Only build tile stack in non-validateOnly mode
                 if (!options.validateOnly) {
                     const stack = [];
                     for (const [, parsed] of entries) {
                         stack.push({
-                            type: "water",
+                            type: 'water',
                             y: parsed.y,
                             textureId: 0,
                             row,
@@ -42,7 +40,7 @@ export class WaterMesh extends Mesh {
         const mapSizeX = cols * cellSize;
         const mapSizeZ = rows * cellSize;
         const geometry = new TilesGeometry(tiles, [], mapSizeX, mapSizeZ);
-        interpreter.setAsset("waterGeometry", geometry);
+        interpreter.setAsset('waterGeometry', geometry);
         super(geometry);
         this.renderOrder = 1;
         this.frustumCulled = true;
@@ -50,6 +48,9 @@ export class WaterMesh extends Mesh {
         setupBVH(this.geometry);
         this.raycast = acceleratedRaycast;
     }
+    getHeightAt(coord, options) {
+        return this.geometry.getHeightAt(coord, options);
+    }
     dispose() {
         this.geometry.dispose();
         if (this.material instanceof Material) {
@@ -57,5 +58,5 @@ export class WaterMesh extends Mesh {
         }
     }
 }
-export * from "./texture.js";
-export * from "./material.js";
+export * from './texture.js';
+export * from './material.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawcall/charta",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "author": "Bela Bohlender",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://drawcall.ai",