@drawcall/charta 0.1.17 → 0.1.18

package/dist/assets/loader.d.ts

@@ -1,10 +1,22 @@
 import { LoadingManager, Loader } from 'three';
 import { Interpreter } from '../interpreter.js';
+export type AssetLoaderOptions = {
+    /**
+     * Mock mode: skips actual asset loading and creates placeholder objects.
+     * Useful for server-side validation. Default: false.
+     */
+    mock?: boolean;
+    /**
+     * Skip texture loading entirely. When true, loadTexture calls are ignored.
+     * Default: false.
+     */
+    skipTextureLoading?: boolean;
+};
 export declare class AssetLoader extends Loader<void, Interpreter> {
-    private readonly mock;
     private textureLoader;
     private gltfLoader;
-    constructor(manager?: LoadingManager, mock?: boolean);
+    private readonly options;
+    constructor(manager?: LoadingManager, options?: AssetLoaderOptions);
     load(interpreter: Interpreter, onLoad: (data: void) => void, onProgress?: (event: ProgressEvent) => void, onError?: (err: unknown) => void): void;
     private handleLoadTexture;
     private handleLoadModel;

package/dist/assets/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/assets/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,cAAc,EAAqB,MAAM,EAAW,MAAM,OAAO,CAAA;AAEzG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAM/C,qBAAa,WAAY,SAAQ,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC;IAIlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAH3D,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,UAAU,CAAY;gBAElB,OAAO,CAAC,EAAE,cAAc,EAAmB,IAAI,GAAE,OAAe;IAM5E,IAAI,CACF,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EAC5B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EAC3C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC/B,IAAI;YAuBO,iBAAiB;YA8BjB,eAAe;CAuC9B"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/assets/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,cAAc,EAAqB,MAAM,EAAW,MAAM,OAAO,CAAA;AAEzG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAM/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED,qBAAa,WAAY,SAAQ,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC;IACxD,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,CAAC,EAAE,cAAc,EAAE,OAAO,GAAE,kBAAuB;IAOtE,IAAI,CACF,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EAC5B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EAC3C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC/B,IAAI;YAyBO,iBAAiB;YA8BjB,eAAe;CAuC9B"}

package/dist/assets/loader.js

@@ -5,14 +5,14 @@ import { InstancedMeshGroup } from '../utils/instanced-mesh-group.js';
 import { measureObject, PrefabBatchBuilder } from '../place/index.js';
 import { basePathSchema, loadTextureSchema, loadModelSchema } from '../schemas.js';
 export class AssetLoader extends Loader {
-    mock;
     textureLoader;
     gltfLoader;
-    constructor(manager, mock = false) {
+    options;
+    constructor(manager, options = {}) {
         super(manager);
-        this.mock = mock;
         this.textureLoader = new TextureLoader(manager);
         this.gltfLoader = new GLTFLoader(manager);
+        this.options = options;
     }
     load(interpreter, onLoad, onProgress, onError) {
         const calls = interpreter.getCalls(undefined, {
@@ -27,7 +27,9 @@ export class AssetLoader extends Loader {
                 basePath = args.path.length === 0 ? undefined : args.path;
             }
             else if (key === 'loadTexture') {
-                promises.push(this.handleLoadTexture(interpreter, args.name, basePath, args.path, location));
+                if (!this.options.skipTextureLoading) {
+                    promises.push(this.handleLoadTexture(interpreter, args.name, basePath, args.path, location));
+                }
             }
             else if (key === 'loadModel') {
                 promises.push(this.handleLoadModel(interpreter, args.name, basePath, args.path, location));
@@ -38,7 +40,7 @@ export class AssetLoader extends Loader {
             .catch((reason) => onError?.(reason));
     }
     async handleLoadTexture(interpreter, name, basePath, path, location) {
-        if (this.mock) {
+        if (this.options.mock) {
             const texture = new Texture();
             texture.name = name;
             interpreter.setAsset(`${name}BaseColorTexture`, texture);
@@ -55,7 +57,7 @@ export class AssetLoader extends Loader {
         }
     }
     async handleLoadModel(interpreter, name, basePath, path, location) {
-        if (this.mock) {
+        if (this.options.mock) {
             const batchBuilder = new PrefabBatchBuilder(new Vector3(), () => new Object3D());
             interpreter.setAsset(`${name}Prefab`, batchBuilder);
             return;

package/dist/place/index.d.ts

@@ -28,11 +28,7 @@ export type PlaceGroupOptions = {
      * computation and instance generation. Useful for server-side validation. Default: false.
      */
     mock?: boolean;
-    /**
-     * Skip the final build() call on batch builders. Computes all placements but doesn't
-     * create the final Object3D instances. Useful for testing placement logic. Default: false.
-     */
-    skipBuild?: boolean;
+    skipModelInstantiation?: boolean;
 };
 export declare class PlaceGroup extends Group {
     readonly batchBuilders: Map<string, PrefabBatchBuilder>;

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,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,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,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,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"}

package/dist/place/index.js

@@ -34,7 +34,7 @@ export class PlaceGroup extends Group {
     batchBuilders = new Map();
     constructor(interpreter, _materialFallback, opts = {}) {
         super();
-        const { mock = false, skipBuild = false } = opts;
+        const { mock = false, skipModelInstantiation: skipBuild = false } = opts;
         const rows = interpreter.getRows();
         const cols = interpreter.getCols();
         const cellSize = interpreter.getCellSize();

package/dist/tiles/index.d.ts

@@ -9,6 +9,7 @@ export type TilesMeshOptions = {
      * Useful for server-side validation. Default: false.
      */
     mock?: boolean;
+    skipTextureLoading?: boolean;
 };
 export declare class TilesMesh extends Mesh<TilesGeometry> {
     constructor(interpreter: Interpreter, material?: Material, options?: TilesMeshOptions);

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;AAEvE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA;AAEtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AAyCD,qBAAa,SAAU,SAAQ,IAAI,CAAC,aAAa,CAAC;gBACpC,WAAW,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAkC,EAAE,OAAO,GAAE,gBAAqB;CA0JnH"}
+{"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;AAEvE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA;AAEtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,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;CAiInH"}

package/dist/tiles/index.js

@@ -34,39 +34,10 @@ export class TilesMesh extends Mesh {
     constructor(interpreter, material = new MeshBasicMaterial(), options = {}) {
         const rows = interpreter.getRows();
         const cols = interpreter.getCols();
-        // Mock mode: validate calls exist but skip geometry creation
-        if (options.mock) {
-            super(undefined);
-            for (let row = 0; row < rows; row++) {
-                for (let col = 0; col < cols; col++) {
-                    // Validate all ground/ceiling/wall calls and their parameters
-                    const calls = interpreter.getCalls([row, col], {
-                        ground: groundSchema,
-                        ceiling: ceilingSchema,
-                        wall: wallSchema,
-                    });
-                    // Also validate wall heights using the helper
-                    resolveHeights([row, col], calls.map(([_1, parsed, _2, loc]) => ({
-                        loc,
-                        layerY: 'y' in parsed ? parsed.y : undefined,
-                        explicitWallY: 'bottomY' in parsed ? parsed.bottomY : undefined,
-                    })), interpreter, false);
-                    resolveHeights([row, col], calls.map(([_1, parsed, _2, loc]) => ({
-                        loc,
-                        layerY: 'y' in parsed ? parsed.y : undefined,
-                        explicitWallY: 'topY' in parsed ? parsed.topY : undefined,
-                    })), interpreter, true);
-                    // Validate texture references
-                    for (const [name, parsed, , loc] of calls) {
-                        if (name === 'ground' || name === 'ceiling') {
-                            interpreter.getAsset(Texture, `${parsed.texture}BaseColorTexture`, loc);
-                        }
-                    }
-                }
-            }
-            return;
-        }
-        // Helper to manage texture indices on the fly
+        const { mock = false, skipTextureLoading = false } = options;
+        const createGeometry = !mock;
+        const createMaterial = !mock && !skipTextureLoading;
+        // Texture index tracking (only used when creating materials)
         const textureIndex = new Map();
         const getTextureIndex = (name, loc) => {
             const texture = interpreter.getAsset(Texture, `${name}BaseColorTexture`, loc);
@@ -79,23 +50,27 @@ export class TilesMesh extends Mesh {
             }
             return idx;
         };
-        // Initialize grid structures
-        const tiles = Array.from({ length: rows }, () => Array.from({ length: cols }, () => []));
-        const walls = Array.from({ length: rows }, () => Array.from({ length: cols }, () => ({
-            top: [],
-            bottom: [],
-            left: [],
-            right: [],
-        })));
+        // Initialize grid structures (only needed for geometry)
+        const tiles = createGeometry
+            ? Array.from({ length: rows }, () => Array.from({ length: cols }, () => []))
+            : null;
+        const walls = createGeometry
+            ? Array.from({ length: rows }, () => Array.from({ length: cols }, () => ({
+                top: [],
+                bottom: [],
+                left: [],
+                right: [],
+            })))
+            : null;
         for (let row = 0; row < rows; row++) {
             for (let col = 0; col < cols; col++) {
-                // 1. Collect all entries for this cell
+                // Collect and validate all entries for this cell
                 const calls = Array.from(interpreter.getCalls([row, col], {
                     ground: groundSchema,
                     ceiling: ceilingSchema,
                     wall: wallSchema,
                 }));
-                // 2. Compute wall heights using the helper
+                // Compute/validate wall heights
                 const bottomYs = resolveHeights([row, col], calls.map(([_1, parsed, _2, loc]) => ({
                     loc,
                     layerY: 'y' in parsed ? parsed.y : undefined,
@@ -106,7 +81,7 @@ export class TilesMesh extends Mesh {
                     layerY: 'y' in parsed ? parsed.y : undefined,
                     explicitWallY: 'topY' in parsed ? parsed.topY : undefined,
                 })), interpreter, true);
-                // 3. Populate data structures
+                // Populate data structures and/or validate
                 for (let i = 0; i < calls.length; i++) {
                     const [name, parsed, _, loc] = calls[i];
                     if (name === 'wall') {
@@ -119,32 +94,44 @@ export class TilesMesh extends Mesh {
                             ;
                             [bottomY, topY] = [topY, bottomY];
                         }
-                        const dir = parsed.dir;
-                        if (walls[row][col][dir]) {
+                        if (createGeometry) {
+                            const dir = parsed.dir;
                             walls[row][col][dir].push({ bottomY, topY });
                         }
                     }
                     else {
                         // Ground or Ceiling
-                        tiles[row][col].push({
-                            type: name,
-                            y: parsed.y,
-                            textureId: getTextureIndex(parsed.texture, loc),
-                            row,
-                            col,
-                        });
+                        if (createGeometry) {
+                            tiles[row][col].push({
+                                type: name,
+                                y: parsed.y,
+                                textureId: createMaterial ? getTextureIndex(parsed.texture, loc) : 0,
+                                row,
+                                col,
+                            });
+                        }
+                        else if (!skipTextureLoading) {
+                            // Validate texture exists in mock mode (unless mockTexture is set)
+                            interpreter.getAsset(Texture, `${parsed.texture}BaseColorTexture`, loc);
+                        }
                     }
                 }
             }
         }
+        if (!createGeometry) {
+            super(undefined);
+            return;
+        }
         const cellSize = interpreter.getCellSize();
         const geometry = new TilesGeometry(tiles, walls, cols * cellSize, rows * cellSize);
         super(geometry);
         interpreter.setAsset('tilesGeometry', geometry);
-        // Build texture array from interpreter assets using encountered material names in insertion order
-        const texturesInOrder = Array.from(textureIndex.keys()).sort((a, b) => textureIndex.get(a) - textureIndex.get(b));
-        if (texturesInOrder.length > 0) {
-            this.material = buildTilesMaterial(material, buildTextureArrayFromAssets(texturesInOrder));
+        // Build material from textures
+        if (createMaterial) {
+            const texturesInOrder = Array.from(textureIndex.keys()).sort((a, b) => textureIndex.get(a) - textureIndex.get(b));
+            if (texturesInOrder.length > 0) {
+                this.material = buildTilesMaterial(material, buildTextureArrayFromAssets(texturesInOrder));
+            }
         }
     }
 }

package/package.json

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