@bitmagic/cli 0.1.52-dev.7 → 0.1.52-dev.9

package/dist/editor/shell-page.js

@@ -370,6 +370,24 @@ ${ASSET_DETAIL_HTML}
     if (frame.contentWindow) frame.contentWindow.postMessage(message, '*');
   }
 
+  /**
+   * POST JSON to the sidecar and read its JSON answer.
+   *
+   * Every endpoint replies { ok, ... }, and an HTTP failure means the same thing to this page as an
+   * ok:false body, so the two are folded into one flag rather than re-checked at every call site.
+   * Rejects only when the request never landed or the answer was not JSON, which the callers that
+   * can say something useful about it catch.
+   */
+  async function postJson(path, body) {
+    var response = await fetch(path, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body)
+    });
+    var result = await response.json();
+    return { ok: response.ok && result.ok === true, result: result };
+  }
+
   /**
    * What this host can do, for the editor's feature detection (game/src/editor/EditorHost.ts).
    *
@@ -391,27 +409,21 @@ ${ASSET_DETAIL_HTML}
     });
   }
 
-  /** Write the URL the engine just uploaded terrain to into src/work/world.json. */
   /**
    * Persist an object voxel sculpt. Mirrors recordTerrainSave: the bytes are already in storage,
    * only the record crosses this boundary.
    */
   async function recordVoxelSave(message) {
     try {
-      var response = await fetch('/api/editor/voxel-saved', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
-          asset: message.asset,
-          environmentObjects: message.environmentObjects || []
-        })
+      var saved = await postJson('/api/editor/voxel-saved', {
+        asset: message.asset,
+        environmentObjects: message.environmentObjects || []
       });
-      var result = await response.json();
-      if (!response.ok || !result.ok) {
-        setStatus('error', result.error || 'Voxel edit could not be saved');
+      if (!saved.ok) {
+        setStatus('error', saved.result.error || 'Voxel edit could not be saved');
         return;
       }
-      lastKnownMtime = result.worldMtimeMs || lastKnownMtime;
+      lastKnownMtime = saved.result.worldMtimeMs || lastKnownMtime;
       lastLocalEditAt = Date.now();
       setStatus('saved', 'Voxel edit saved to world.json');
     } catch (error) {
@@ -419,17 +431,13 @@ ${ASSET_DETAIL_HTML}
     }
   }
 
+  /** Write the URL the engine just uploaded terrain to into src/work/world.json. */
   async function recordTerrainSave(voxelUrl) {
     if (!voxelUrl) return;
     try {
-      var response = await fetch('/api/editor/terrain-saved', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ voxelUrl: voxelUrl })
-      });
-      var result = await response.json();
-      if (!response.ok || result.ok !== true) throw new Error(result.error || 'save failed');
-      lastKnownMtime = result.worldMtimeMs || lastKnownMtime;
+      var saved = await postJson('/api/editor/terrain-saved', { voxelUrl: voxelUrl });
+      if (!saved.ok) throw new Error(saved.result.error || 'save failed');
+      lastKnownMtime = saved.result.worldMtimeMs || lastKnownMtime;
       setStatus('saved', 'Terrain saved to world.json');
     } catch (error) {
       // The bytes ARE uploaded — only the one-line reference failed to land. Say so precisely, so
@@ -508,11 +516,8 @@ ${ASSET_DETAIL_HTML}
       case 'EDITOR_JOURNAL_EVENT':
         // Terrain and voxel saves, which the journal's world.json diff cannot see — and their
         // failures, which change no file at all.
-        void fetch('/api/editor/journal', {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify(message)
-        }).catch(function () { /* the journal is a convenience; never break the editor for it */ });
+        void postJson('/api/editor/journal', message)
+          .catch(function () { /* the journal is a convenience; never break the editor for it */ });
         break;
 
       case 'VOXEL_ASSET_SAVED':
@@ -623,13 +628,11 @@ ${ASSET_DETAIL_HTML}
     if (!hqAsset) return;
     var prompt = hqPrompt.value.trim();
     if (prompt === '') { hqPrompt.focus(); return; }
-    var response = await fetch('/api/editor/hq-request', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ assetId: hqAsset.id, assetName: hqAsset.name, prompt: prompt })
+    var saved = await postJson('/api/editor/hq-request', {
+      assetId: hqAsset.id, assetName: hqAsset.name, prompt: prompt
     });
-    var result = await response.json();
-    if (!response.ok || !result.ok) {
+    var result = saved.result;
+    if (!saved.ok) {
       setStatus('error', result.error || 'Could not record the request');
       closeHqDialog();
       return;
@@ -911,13 +914,11 @@ ${ASSET_DETAIL_HTML}
     saving = true;
     setStatus('saving', 'Saving…');
     try {
-      var response = await fetch('/api/scene/save', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ changes: changes, status: status, markersDirty: markersDirty })
+      var saved = await postJson('/api/scene/save', {
+        changes: changes, status: status, markersDirty: markersDirty
       });
-      var result = await response.json();
-      if (!response.ok || !result.ok) {
+      var result = saved.result;
+      if (!saved.ok) {
         setStatus('error', result.error || 'Save failed');
         return;
       }
@@ -934,7 +935,6 @@ ${ASSET_DETAIL_HTML}
     }
   }
 
-
   /**
    * The pre-SSE way of noticing an agent's edit, kept as the fallback for a dropped stream.
    *
@@ -1022,12 +1022,21 @@ ${ASSET_DETAIL_HTML}
     return (bytes / (1024 * 1024)).toFixed(1) + ' MB';
   }
 
-  function formatElapsed(since) {
-    var ms = Date.now() - Date.parse(since);
-    if (!isFinite(ms) || ms < 0) return '';
-    var seconds = Math.floor(ms / 1000);
+  /**
+   * A span of time in the panel's vocabulary: seconds under a minute, then minutes and seconds.
+   * One formatter for a step's duration and a job's elapsed time alike, so two rows of the same
+   * forge cannot count in different shapes. '' for anything that is not a real duration.
+   */
+  function formatDuration(ms) {
+    if (typeof ms !== 'number' || !isFinite(ms) || ms < 0) return '';
+    var seconds = Math.round(ms / 1000);
     if (seconds < 60) return seconds + 's';
-    return Math.floor(seconds / 60) + 'm ' + (seconds % 60) + 's';
+    return Math.floor(seconds / 60) + 'm ' + String(seconds % 60).padStart(2, '0') + 's';
+  }
+
+  /** How long ago an ISO timestamp was. */
+  function formatElapsed(since) {
+    return formatDuration(Date.now() - Date.parse(since));
   }
 
   /** When an asset was made, or 0 for the ones that came with the template. */
@@ -1054,6 +1063,13 @@ ${ASSET_DETAIL_HTML}
     return dated.concat(undated);
   }
 
+  /** A membership lookup over a list of asset ids — what '/api/assets' answers with its previews. */
+  function idSet(ids) {
+    var set = {};
+    for (var i = 0; i < ids.length; i++) set[ids[i]] = true;
+    return set;
+  }
+
   function el(tag, className, text) {
     var node = document.createElement(tag);
     if (className) node.className = className;
@@ -1063,14 +1079,6 @@ ${ASSET_DETAIL_HTML}
     return node;
   }
 
-  /** A step duration, in the same vocabulary as formatElapsed but from milliseconds. */
-  function formatDuration(ms) {
-    if (typeof ms !== 'number' || !isFinite(ms) || ms < 0) return '';
-    var seconds = Math.round(ms / 1000);
-    if (seconds < 60) return seconds + 's';
-    return Math.floor(seconds / 60) + 'm ' + String(seconds % 60).padStart(2, '0') + 's';
-  }
-
   function formatCount(value) {
     return typeof value === 'number' && isFinite(value) ? value.toLocaleString() : '';
   }
@@ -1223,6 +1231,28 @@ ${ASSET_DETAIL_HTML}
     return row;
   }
 
+  var MAX_VXL_PREVIEW_BYTES = 8 * 1024 * 1024;
+
+  /** The mesh route: the asset itself, or the GLB a voxelized one was baked from. */
+  function glbJobFor(asset) {
+    var glb = asset.sourceGlbUrl || asset.url;
+    // Double-escaped because this whole page is a template literal: a single backslash is consumed
+    // by the literal, and the browser would receive the invalid regex /.(glb|gltf)(?|$)/.
+    if (typeof glb !== 'string' || !/\\.(glb|gltf)(\\?|$)/i.test(glb)) return null;
+    return { kind: 'glb', url: glb };
+  }
+
+  /** The voxel route, for assets small enough to be worth shipping through a postMessage. */
+  function vxlJobFor(asset) {
+    var url = asset.url;
+    if (typeof url !== 'string' || !/\\.vxl(\\?|$)/i.test(url)) return null;
+    // The voxel message carries the FILE, so this one costs a fetch and a structured clone of the
+    // whole thing. The templates' files are 0.5-2.5 KB; a multi-megabyte one is a hitch on the
+    // render thread in exchange for a 46px tile, and the glyph is the better trade.
+    if (typeof asset.size === 'number' && asset.size > MAX_VXL_PREVIEW_BYTES) return null;
+    return { kind: 'vxl', url: url };
+  }
+
   /**
    * How the engine should draw this asset's thumbnail, or null when there is nothing to draw.
    *
@@ -1240,20 +1270,8 @@ ${ASSET_DETAIL_HTML}
    * An asset with neither — a sound, an animation, a level — keeps its glyph, which is the honest
    * answer for something with no appearance.
    */
-  var MAX_VXL_PREVIEW_BYTES = 8 * 1024 * 1024;
-
   function previewJobFor(asset) {
-    var glb = asset.sourceGlbUrl || asset.url;
-    // Double-escaped because this whole page is a template literal: a single backslash is consumed
-    // by the literal, and the browser would receive the invalid regex /.(glb|gltf)(?|$)/.
-    if (typeof glb === 'string' && /\\.(glb|gltf)(\\?|$)/i.test(glb)) return { kind: 'glb', url: glb };
-    var url = asset.url;
-    if (typeof url !== 'string' || !/\\.vxl(\\?|$)/i.test(url)) return null;
-    // The voxel message carries the FILE, so this one costs a fetch and a structured clone of the
-    // whole thing. The templates' files are 0.5-2.5 KB; a multi-megabyte one is a hitch on the
-    // render thread in exchange for a 46px tile, and the glyph is the better trade.
-    if (typeof asset.size === 'number' && asset.size > MAX_VXL_PREVIEW_BYTES) return null;
-    return { kind: 'vxl', url: url };
+    return glbJobFor(asset) || vxlJobFor(asset);
   }
 
   function assetRow(asset, isFresh, hasPreview) {
@@ -1317,30 +1335,26 @@ ${ASSET_DETAIL_HTML}
 
   function renderAssets(assets, jobs, previews) {
     var sorted = sortAssets(assets);
-    var cached = {};
-    for (var p = 0; p < previews.length; p++) cached[previews[p]] = true;
+    var cached = idSet(previews);
 
     assetsJobs.textContent = '';
-    for (var j = 0; j < jobs.length; j++) assetsJobs.appendChild(jobRow(jobs[j]));
-
-    var ids = {};
-    var signature = [];
-    for (var i = 0; i < sorted.length; i++) {
-      ids[sorted[i].id] = true;
-      // The preview state is part of the signature: a thumbnail landing is a change worth redrawing
-      // for, and it is the only one that alters a row without altering the asset set.
-      signature.push(sorted[i].id + (cached[sorted[i].id] ? '*' : ''));
-    }
-    var joined = signature.join(',');
+    jobs.forEach(function (job) { assetsJobs.appendChild(jobRow(job)); });
+
+    var ids = idSet(sorted.map(function (asset) { return asset.id; }));
+    // The preview state is part of the signature: a thumbnail landing is a change worth redrawing
+    // for, and it is the only one that alters a row without altering the asset set.
+    var signature = sorted.map(function (asset) {
+      return asset.id + (cached[asset.id] ? '*' : '');
+    }).join(',');
 
-    if (joined !== lastAssetSignature) {
+    if (signature !== lastAssetSignature) {
       assetsList.textContent = '';
-      for (var k = 0; k < sorted.length; k++) {
-        var fresh = seenAssetIds !== null && !seenAssetIds[sorted[k].id];
-        assetsList.appendChild(assetRow(sorted[k], fresh, cached[sorted[k].id] === true));
-      }
+      sorted.forEach(function (asset) {
+        var fresh = seenAssetIds !== null && !seenAssetIds[asset.id];
+        assetsList.appendChild(assetRow(asset, fresh, cached[asset.id] === true));
+      });
       seenAssetIds = ids;
-      lastAssetSignature = joined;
+      lastAssetSignature = signature;
     }
 
     lastJobs = jobs;
@@ -1446,12 +1460,10 @@ ${ASSET_DETAIL_HTML}
           continue;
         }
 
-        var saved = await (await fetch('/api/assets/preview', {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ assetId: asset.id, image: response.previewBase64 })
-        })).json();
-        if (saved.stored === true) stored += 1;
+        var saved = await postJson('/api/assets/preview', {
+          assetId: asset.id, image: response.previewBase64
+        });
+        if (saved.result.stored === true) stored += 1;
       }
     } catch (error) {
       // A thumbnail is a decoration; losing the queue must not take the panel with it.
@@ -1510,8 +1522,8 @@ ${ASSET_DETAIL_HTML}
   var assetReturnFocus = null;
   var assetLoadTimer = null;
 
-  var IMAGE_TYPES = { image: 1, skybox: 1 };
-  var AUDIO_TYPES = { audio: 1, sound: 1, 'sound-effect': 1 };
+  var IMAGE_TYPES = { image: true, skybox: true };
+  var AUDIO_TYPES = { audio: true, sound: true, 'sound-effect': true };
 
   /**
    * What the VIEWER should load — which is not always what the thumbnail drew.
@@ -1521,14 +1533,7 @@ ${ASSET_DETAIL_HTML}
    * shows the asset: a .vxl is drawn as voxels even when the mesh it was baked from is on record.
    */
   function detailJobFor(asset) {
-    var url = asset.url;
-    if (typeof url === 'string' && /\\.vxl(\\?|$)/i.test(url)) {
-      if (typeof asset.size === 'number' && asset.size > MAX_VXL_PREVIEW_BYTES) return null;
-      return { kind: 'vxl', url: url };
-    }
-    var glb = asset.sourceGlbUrl || url;
-    if (typeof glb === 'string' && /\\.(glb|gltf)(\\?|$)/i.test(glb)) return { kind: 'glb', url: glb };
-    return null;
+    return vxlJobFor(asset) || glbJobFor(asset);
   }
 
   function fact(term, value) {
@@ -1563,22 +1568,24 @@ ${ASSET_DETAIL_HTML}
     fact('Voxels', typeof asset.voxelCount === 'number' ? String(asset.voxelCount) : '');
     fact('Id', asset.id || '');
 
-    assetNote.classList.add('hidden');
-    assetFrame.classList.add('hidden');
-    assetImage.classList.add('hidden');
-    assetAudio.classList.add('hidden');
-    assetResetButton.classList.add('hidden');
+    [assetNote, assetFrame, assetImage, assetAudio, assetResetButton].forEach(function (node) {
+      node.classList.add('hidden');
+    });
     if (assetLoadTimer) clearTimeout(assetLoadTimer);
 
     var type = String(asset.type || '').toLowerCase();
     var job = detailJobFor(asset);
+    // The asset's own file, for the types a browser can show without a renderer.
+    var direct = typeof asset.url === 'string' ? asset.url : '';
 
-    if (IMAGE_TYPES[type] === 1 && typeof asset.url === 'string' && asset.url !== '') {
+    // '=== true' rather than a truthy read: a type of 'constructor' would otherwise find
+    // Object.prototype's own property and pass for an image.
+    if (IMAGE_TYPES[type] === true && direct) {
       // An image is already the thing. Loading a 3D viewer to show a picture would be theatre.
-      assetImage.src = asset.url;
+      assetImage.src = direct;
       assetImage.classList.remove('hidden');
-    } else if (AUDIO_TYPES[type] === 1 && typeof asset.url === 'string' && asset.url !== '') {
-      assetAudio.src = asset.url;
+    } else if (AUDIO_TYPES[type] === true && direct) {
+      assetAudio.src = direct;
       assetAudio.classList.remove('hidden');
     } else if (job !== null) {
       assetResetButton.classList.remove('hidden');
@@ -1695,14 +1702,12 @@ ${ASSET_DETAIL_HTML}
    * into the creator's file.
    */
   function withThumbnails(assets, previews) {
-    var cached = {};
-    for (var i = 0; i < previews.length; i++) cached[previews[i]] = true;
+    var cached = idSet(previews);
     return assets.map(function (asset) {
       if (asset.screenshotUrl || !cached[asset.id]) return asset;
-      var copy = {};
-      for (var key in asset) if (Object.prototype.hasOwnProperty.call(asset, key)) copy[key] = asset[key];
-      copy.screenshotUrl = SHELL_ORIGIN + '/api/assets/preview/' + encodeURIComponent(asset.id) + '.png';
-      return copy;
+      return Object.assign({}, asset, {
+        screenshotUrl: SHELL_ORIGIN + '/api/assets/preview/' + encodeURIComponent(asset.id) + '.png'
+      });
     });
   }
 

package/dist/editor/shell-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-page.js","sourceRoot":"","sources":["../../src/editor/shell-page.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+lD3B,CAAC;AACF,CAAC"}
+{"version":3,"file":"shell-page.js","sourceRoot":"","sources":["../../src/editor/shell-page.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAomD3B,CAAC;AACF,CAAC"}

package/dist/editor/voxel-save.js

@@ -1,6 +1,7 @@
 import { isJsonObject } from '../project/world-json.js';
-function assetsOf(world) {
-    return Array.isArray(world.assets) ? world.assets : [];
+/** Match an array item by its `id`, the predicate every write below uses. Mirrors `save.ts`. */
+function byId(id) {
+    return (item) => isJsonObject(item) && item.id === id;
 }
 /**
  * Returns null when there is nothing safe to write.
@@ -14,32 +15,27 @@ export function buildVoxelSaveModifications(payload, world) {
     if (!isJsonObject(asset) || typeof asset.id !== 'string' || asset.id === '')
         return null;
     const assetId = asset.id;
-    const existing = assetsOf(world).some((item) => isJsonObject(item) && item.id === assetId);
+    const isThisAsset = byId(assetId);
+    const existing = (Array.isArray(world.assets) ? world.assets : []).some(isThisAsset);
     const modifications = [existing
             ? {
                 type: 'updateRoot',
                 path: ['assets'],
-                predicate: (item) => isJsonObject(item) && item.id === assetId,
+                predicate: isThisAsset,
                 // Field by field, so anything the agent added since LOAD_GAME survives. See the header.
                 value: (item) => ({ ...(isJsonObject(item) ? item : {}), ...asset }),
             }
-            : {
-                type: 'upsertRoot',
-                path: ['assets'],
-                predicate: (item) => isJsonObject(item) && item.id === assetId,
-                value: asset,
-            }];
+            : { type: 'upsertRoot', path: ['assets'], predicate: isThisAsset, value: asset }];
     // Instances the save minted. Upserted by id rather than pushed, so a retry of the same save does
     // not leave two copies of one object standing in the same place.
     const instances = Array.isArray(payload.environmentObjects) ? payload.environmentObjects : [];
     for (const instance of instances) {
         if (!isJsonObject(instance) || typeof instance.id !== 'string' || instance.id === '')
             continue;
-        const instanceId = instance.id;
         modifications.push({
             type: 'upsertRoot',
             path: ['environmentObjects'],
-            predicate: (item) => isJsonObject(item) && item.id === instanceId,
+            predicate: byId(instance.id),
             value: instance,
         });
     }

package/dist/editor/voxel-save.js.map

@@ -1 +1 @@
-{"version":3,"file":"voxel-save.js","sourceRoot":"","sources":["../../src/editor/voxel-save.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,YAAY,EAAmB,MAAM,0BAA0B,CAAC;AAkBzE,SAAS,QAAQ,CAAC,KAAiB;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAyB,EACzB,KAAiB;IAEjB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACzF,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;IAEzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAC3F,MAAM,aAAa,GAA4B,CAAC,QAAQ;YACtD,CAAC,CAAC;gBACA,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,OAAO;gBACvE,wFAAwF;gBACxF,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;aAC9E;YACD,CAAC,CAAC;gBACA,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,OAAO;gBACvE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;IAEL,iGAAiG;IACjG,iEAAiE;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,IAAI,QAAQ,CAAC,EAAE,KAAK,EAAE;YAAE,SAAS;QAC/F,MAAM,UAAU,GAAG,QAAQ,CAAC,EAAE,CAAC;QAC/B,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,CAAC,oBAAoB,CAAC;YAC5B,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,UAAU;YAC1E,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,aAAa;QACb,OAAO;QACP,SAAS,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;QACrF,MAAM,EAAE,QAAQ;KACjB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"voxel-save.js","sourceRoot":"","sources":["../../src/editor/voxel-save.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,YAAY,EAAmB,MAAM,0BAA0B,CAAC;AAkBzE,gGAAgG;AAChG,SAAS,IAAI,CAAC,EAAU;IACtB,OAAO,CAAC,IAAa,EAAW,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAyB,EACzB,KAAiB;IAEjB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACzF,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;IAEzB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrF,MAAM,aAAa,GAA4B,CAAC,QAAQ;YACtD,CAAC,CAAC;gBACA,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,SAAS,EAAE,WAAW;gBACtB,wFAAwF;gBACxF,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;aAC9E;YACD,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAEpF,iGAAiG;IACjG,iEAAiE;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,IAAI,QAAQ,CAAC,EAAE,KAAK,EAAE;YAAE,SAAS;QAC/F,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,CAAC,oBAAoB,CAAC;YAC5B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,aAAa;QACb,OAAO;QACP,SAAS,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;QACrF,MAAM,EAAE,QAAQ;KACjB,CAAC;AACJ,CAAC"}

package/dist/generate/prop.d.ts

@@ -1,5 +1,32 @@
 import type { Environment } from '../config/environments.js';
+import { withVoxelizeSession } from '../forge/voxelize-session.js';
 import type { ProjectContext } from '../project/context.js';
+/**
+ * What the bake was handed: a mesh to voxelize, or a voxel master to compile.
+ *
+ * A union rather than two optional URLs because exactly one is always true, and the error messages
+ * differ in the only part that matters — what was kept and how to retry with it.
+ */
+export type PropSource = {
+    kind: 'glb';
+    glbUrl: string;
+} | {
+    kind: 'master';
+    masterUrl: string;
+};
+/**
+ * Whether this project's engine can bake a voxel master.
+ *
+ * A capability probe, not a version comparison. `withVoxelizeSession` runs the project's OWN
+ * vendored engine, and `CREATE_ASSET_FROM_VXL_MASTER` only exists in engines from 2026-08-02 —
+ * but the failure mode of guessing wrong is what makes this worth checking rather than trying:
+ * an engine with no handler for a message does not answer, so the request stalls for the full
+ * VOXELIZE_TIMEOUT_MS (10 minutes) and then again on the retry, after which the paid generation
+ * is thrown away. Reading a version string is the indirect way to ask; the file is the answer.
+ *
+ * `engine` resolves to `engine/engine` — see scaffold/aliases.ts.
+ */
+export declare function engineSupportsVxlMaster(projectRoot: string): boolean;
 interface FitBox {
     x: number;
     z: number;
@@ -11,8 +38,14 @@ export interface PropVoxelizeOptions {
     token: string;
     assetId: string;
     prompt: string;
-    glbUrl: string;
+    source: PropSource;
     log: (message: string) => void;
+    /**
+     * Injected by tests so the bake runs without Chrome, matching the `voxelize` seam
+     * `generateAndInstallModel` already has. Without it none of the routing, capability or fallback
+     * logic below can be covered at all — every path ends in a real browser.
+     */
+    session?: typeof withVoxelizeSession;
 }
 export interface GenerateAndInstallOptions {
     context: ProjectContext;
@@ -24,7 +57,24 @@ export interface GenerateAndInstallOptions {
     glbUrl?: string;
     fetchImpl?: typeof globalThis.fetch;
     log: (message: string) => void;
+    /** See PropVoxelizeOptions.session. */
+    session?: typeof withVoxelizeSession;
 }
+/**
+ * What the asset was made from, reported so callers do not have to guess.
+ *
+ * Two fields rather than one, because both end up in machine-readable output — the `--json`
+ * document and the editor's journal — and a voxel master reported under `glbUrl` would tell an
+ * agent there is a mesh to retry with when there is not, on the one path whose whole point is
+ * that no mesh exists.
+ */
+export type PropSourceResult = {
+    glbUrl: string;
+    masterUrl?: undefined;
+} | {
+    masterUrl: string;
+    glbUrl?: undefined;
+};
 export interface PropVoxelizeResult {
     assetId: string;
     assetName: string;
@@ -58,9 +108,7 @@ export declare function shouldFillInterior(fitBox: FitBox): boolean;
  * Everything the caller must resolve first (project, environment, token) is a parameter, so this
  * stays free of CLI output plumbing and of how the token was obtained.
  */
-export declare function generateAndInstallProp(options: GenerateAndInstallOptions): Promise<PropVoxelizeResult & {
-    glbUrl: string;
-}>;
+export declare function generateAndInstallProp(options: GenerateAndInstallOptions): Promise<PropVoxelizeResult & PropSourceResult>;
 /**
  * Steps 2 and 3. Split from the command so the browser work is callable directly on a retry that
  * already has a GLB, and so the command file stays about flags and output.