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

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/levels/registry.d.ts

@@ -0,0 +1,88 @@
+/**
+ * `bitmagic levels` — the level registry in `worldProfileData.levels`, without the web Creator.
+ *
+ * `forge` can CREATE levels but never could manage them: only a game's first forge becomes the
+ * start level (or `forge --make-start` at creation), so fixing a wrong start, renaming, or deleting
+ * a level meant opening the Creator.
+ *
+ * ── The invariant this file exists to respect ────────────────────────────────────────────────
+ *
+ * `worldProfileData` keeps three LEGACY MIRRORS — `voxelUrl`, `spawnPoints` and
+ * `playerSpawnPosition` — describing the START level, because frozen genre and work-template code
+ * boots from those rather than from the registry (see `WorldLevel` in game/src/types/game.ts).
+ *
+ * Nothing self-heals on the normal boot path. `applyBootLevelOverride` does recompute them, but
+ * only when the main screen's level chooser passes a `bootLevelId`. So a `startLevelId` moved
+ * without its mirrors boots the NEW level's objects, lighting and navmesh over the OLD level's
+ * terrain, and nothing throws. That is the failure this module exists to prevent.
+ *
+ * The mirrors come from `buildStartLevelMirrors` in `@bitmagic/world-forger`, deliberately rather
+ * than reimplemented — the same function the forge uses, carrying a subtlety worth not
+ * rediscovering: spawn mirrors are written ONLY when the level owns spawn points, because a level
+ * without its own inherits the globals, which are then already correct.
+ *
+ * Pure: it computes modifications and never applies them.
+ */
+import { type LevelEntry, type WorldJsonModification } from '@bitmagic/world-forger/pipeline/index.js';
+import { type JsonObject } from '../project/world-json.js';
+export interface LevelRow {
+    id: string;
+    name: string;
+    vwldAssetId: string;
+    /** The `.vwld` asset is absent from `assets[]`, so this level has nothing to load. */
+    missingAsset: boolean;
+    start: boolean;
+    spawnPoints: number;
+    /** Placed objects tagged to this level. Untagged ones are global and belong to none. */
+    placed: number;
+}
+export declare function listLevels(world: JsonObject): LevelRow[];
+export interface LevelPlan {
+    modifications: WorldJsonModification[];
+    /** Said after the write. Never a reason to refuse. */
+    notes: string[];
+}
+/**
+ * Make `levelId` the level the game boots into — registry AND mirrors, together.
+ *
+ * Refused when the level's `.vwld` asset is missing or has no url: the mirrors are what actually
+ * boot the game, so writing `startLevelId` alone would leave `voxelUrl` describing the previous
+ * level, and the registry and the thing that loads would disagree with no error anywhere.
+ */
+export declare function planSetStart(world: JsonObject, levelId: string): LevelPlan;
+export declare function planRename(world: JsonObject, levelId: string, name: string): LevelPlan;
+export interface AddPlan extends LevelPlan {
+    level: LevelEntry;
+    /** True when this made the game multi-level for the first time. */
+    converted: boolean;
+}
+/**
+ * Register an existing `.vwld` asset as a level.
+ *
+ * Start-level policy matches `forge`'s: a game's FIRST level becomes the start, later ones do not,
+ * and `--make-start` overrides. Stealing the start from a working game because someone registered
+ * a second level would be the surprising outcome.
+ */
+export declare function planAdd(world: JsonObject, vwldAssetId: string, options: {
+    name?: string;
+    makeStart: boolean;
+}): AddPlan;
+export interface RemovePlan extends LevelPlan {
+    level: LevelEntry;
+    /** Placed instances tagged to this level, which go with it. */
+    placedRemoved: number;
+    /** Doors and key items scoped to it, which also go. */
+    scopedRemoved: string[];
+}
+/**
+ * Remove a level from the registry.
+ *
+ * Two refusals, matching the agent's `manage-levels delete` so the two lanes cannot disagree:
+ * the last level, and the START level. The second matters most — `startLevelId` naming nothing
+ * falls back to `levels[0]` at boot while the mirrors still describe the deleted level, which is
+ * the silent stale-mirror failure. Move the start first, deliberately.
+ *
+ * The `.vwld` asset is left alone: it may be large, nothing here deletes uploaded bytes, and a
+ * re-add is then free.
+ */
+export declare function planRemove(world: JsonObject, levelId: string): RemovePlan;