@bldrs-ai/conway 1.511.1441 → 1.513.1447

package/compiled/examples/browser-bundled.cjs

@@ -30,7 +30,7 @@ var import_node_process = require("node:process");
 var readline = __toESM(require("node:readline"), 1);
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.511.1441";
+var versionString = "Conway v1.513.1447";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 var wasmType = "";
@@ -2910,7 +2910,10 @@ var StepParser = class extends StepHeaderParser {
         if (!charws(SEMICOLON)) {
           return syntaxError();
         }
-        onRecordIndexed?.(topLevelCount, expressID, 0);
+        {
+          const recordLen = input2.address - startElement2;
+          onRecordIndexed?.(topLevelCount, expressID, 0, input2.buffer.subarray(input2.cursor - recordLen, input2.cursor));
+        }
         ++topLevelCount;
         pushEntry({
           address: startElement2,
@@ -3000,7 +3003,10 @@ var StepParser = class extends StepHeaderParser {
       if (!charws(SEMICOLON)) {
         return syntaxError();
       }
-      onRecordIndexed?.(topLevelCount, expressID, foundItem);
+      {
+        const recordLen = input2.address - startElement;
+        onRecordIndexed?.(topLevelCount, expressID, foundItem, input2.buffer.subarray(input2.cursor - recordLen, input2.cursor));
+      }
       ++topLevelCount;
       pushEntry({
         address: startElement,
@@ -5532,6 +5538,9 @@ var StepModelBase = class {
     if (element.vtableIndex === void 0 && !this.populateVtableEntryRaw(element)) {
       return void 0;
     }
+    if (element.buffer === void 0) {
+      this.populateBufferEntry(localID);
+    }
     const vtable = element.vtable;
     const buffer = element.buffer;
     if (vtable === void 0 || buffer === void 0 || offset >= (element.vtableCount ?? 0)) {
@@ -5601,6 +5610,11 @@ var StepModelBase = class {
     }
     const element = this.entry(localID);
     element.buffer = this.bufferProvider_.acquire(element.address, element.length).buffer;
+    if (element.multiMapping !== void 0) {
+      for (const mapped of element.multiMapping) {
+        mapped.buffer = this.bufferProvider_.acquire(mapped.address, mapped.length).buffer;
+      }
+    }
   }
   /**
    * Get the size in bytes of the backing buffer for this.
@@ -5721,24 +5735,39 @@ var StepModelBase = class {
     if (!this.isSourceExternal) {
       return seen;
     }
-    const stack = [localID];
+    const frontier = [];
+    const enqueue = (id) => {
+      if (id < this.count_ && !seen.has(id)) {
+        frontier.push(id);
+      }
+    };
+    enqueue(localID);
     if (extraLocalIDs !== void 0) {
       for (const extra of extraLocalIDs) {
-        stack.push(extra);
+        enqueue(extra);
       }
     }
-    while (stack.length > 0) {
-      const id = stack.pop();
-      if (seen.has(id) || id >= this.count_) {
-        continue;
+    while (frontier.length > 0) {
+      const wave = [];
+      for (const id of frontier) {
+        if (seen.has(id) || id >= this.count_) {
+          continue;
+        }
+        seen.add(id);
+        this.pinByLocalID(id);
+        wave.push(id);
+      }
+      frontier.length = 0;
+      if (wave.length === 0) {
+        break;
       }
-      seen.add(id);
-      await this.ensureResidentByLocalID(id);
-      this.pinByLocalID(id);
-      for (const expressID of this.scanRecordRefs_(id)) {
-        const referenced = this.expressIDMap_.get(expressID);
-        if (referenced !== void 0 && !seen.has(referenced)) {
-          stack.push(referenced);
+      await Promise.all(wave.map((id) => this.ensureResidentByLocalID(id)));
+      for (const id of wave) {
+        for (const expressID of this.scanRecordRefs_(id)) {
+          const referenced = this.expressIDMap_.get(expressID);
+          if (referenced !== void 0 && !seen.has(referenced)) {
+            frontier.push(referenced);
+          }
         }
       }
     }
@@ -5767,6 +5796,35 @@ var StepModelBase = class {
     }
     this.bufferProvider_.unpinRange?.(this.address_[localID], this.length_[localID]);
   }
+  /**
+   * Drop captured source-window views on `localIDs` so the LRU can
+   * evict those chunks. Vtables stay — `acquire` of the same
+   * `(address, length)` is at a stable base. The next
+   * `ensureResident` + field read rematerialises the view.
+   *
+   * @param localIDs Records whose `buffer` views to drop.
+   */
+  releaseSourceViews(localIDs) {
+    if (!this.isSourceExternal) {
+      return;
+    }
+    for (const localID of localIDs) {
+      if (localID >= this.count_) {
+        continue;
+      }
+      const item = this.complexEntries_?.get(localID) ?? this.descriptorCache_[localID];
+      if (item === void 0) {
+        continue;
+      }
+      item.buffer = void 0;
+      if (item.multiMapping !== void 0) {
+        for (const mapped of item.multiMapping) {
+          mapped.buffer = void 0;
+        }
+      }
+    }
+    releaseScratchParsingBuffer();
+  }
   /**
    * Unpin every local ID in `localIDs` (best-effort; missing IDs are
    * ignored). Use after {@link ensureResidentClosureByLocalID}, which
@@ -11230,6 +11288,7 @@ var StepEntityBase = class {
    */
   extractParseBuffer(offset, baseOffset, depth, result, module2, optional) {
     offset -= this.multiReference_ !== void 0 ? baseOffset : 0;
+    this.guaranteeBuffer();
     const internalReference = this.guaranteeVTable(depth);
     if (offset >= internalReference.vtableCount) {
       throw new Error("Couldn't read field due to too few fields in record");
@@ -11342,6 +11401,7 @@ var StepEntityBase = class {
    * @return {Uint8Array} The buffer for this.
    */
   get buffer() {
+    this.guaranteeBuffer();
     return this.internalReference_.buffer;
   }
   /**
@@ -11432,6 +11492,9 @@ var StepEntityBase = class {
           throw new Error("Entity does not have matching table entry to read from model");
         }
       }
+      if (classReference.buffer === void 0) {
+        this.model.populateBufferEntry(this.localID);
+      }
       this.internalReference_.buffer = classReference.buffer;
       return classReference;
     }
@@ -11442,6 +11505,9 @@ var StepEntityBase = class {
         throw new Error("Entity does not have matching table entry to read from model");
       }
     }
+    if (internalReference.buffer === void 0) {
+      this.guaranteeBuffer();
+    }
     return internalReference;
   }
   /**

package/compiled/examples/cli-bundled.cjs

@@ -14965,7 +14965,7 @@ ${t5.join("\n")}` : "";
 var import_process = require("process");
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.511.1441";
+var versionString = "Conway v1.513.1447";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 function pThreadsAllowed() {
@@ -16397,13 +16397,15 @@ var ProgressTracker = class {
    * Report progress within the current phase; throttled.
    *
    * @param completed Units completed so far.
+   * @param extras Optional extras (window residency) merged into the event.
    */
-  update(completed) {
+  update(completed, extras) {
+    this.extras_ = extras;
     const now = Date.now();
     if (now - this.lastEmitTime < this.minIntervalMs) {
       return;
     }
-    this.emit(completed, now);
+    this.emit(completed, now, extras);
   }
   /**
    * End the current phase, emitting an unthrottled final event with
@@ -16412,16 +16414,18 @@ var ProgressTracker = class {
    * @param completed Final completed units (defaults to the phase total).
    */
   endPhase(completed) {
-    this.emit(completed ?? this.total_ ?? 0);
+    this.emit(completed ?? this.total_ ?? 0, Date.now(), this.extras_);
     this.phase_ = void 0;
+    this.extras_ = void 0;
   }
   /**
    * Materialize and forward an event now, bypassing the throttle.
    *
    * @param completed Units completed so far.
    * @param now Current time in ms (defaults to Date.now()).
+   * @param extras Optional extras merged into the event.
    */
-  emit(completed, now = Date.now()) {
+  emit(completed, now = Date.now(), extras) {
     if (this.phase_ === void 0) {
       return;
     }
@@ -16433,7 +16437,8 @@ var ProgressTracker = class {
       total,
       unit: this.unit_,
       elapsedMs: now - this.startTime,
-      memoryMb: Memory.usedHeapMb()
+      memoryMb: Memory.usedHeapMb(),
+      residentSourceMb: extras?.residentSourceMb
     });
   }
 };
@@ -18741,7 +18746,10 @@ var StepParser = class extends StepHeaderParser {
         if (!charws(SEMICOLON)) {
           return syntaxError();
         }
-        onRecordIndexed?.(topLevelCount, expressID, 0);
+        {
+          const recordLen = input.address - startElement2;
+          onRecordIndexed?.(topLevelCount, expressID, 0, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+        }
         ++topLevelCount;
         pushEntry({
           address: startElement2,
@@ -18831,7 +18839,10 @@ var StepParser = class extends StepHeaderParser {
       if (!charws(SEMICOLON)) {
         return syntaxError();
       }
-      onRecordIndexed?.(topLevelCount, expressID, foundItem);
+      {
+        const recordLen = input.address - startElement;
+        onRecordIndexed?.(topLevelCount, expressID, foundItem, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+      }
       ++topLevelCount;
       pushEntry({
         address: startElement,
@@ -21410,6 +21421,9 @@ var StepModelBase = class {
     if (element.vtableIndex === void 0 && !this.populateVtableEntryRaw(element)) {
       return void 0;
     }
+    if (element.buffer === void 0) {
+      this.populateBufferEntry(localID);
+    }
     const vtable = element.vtable;
     const buffer = element.buffer;
     if (vtable === void 0 || buffer === void 0 || offset >= (element.vtableCount ?? 0)) {
@@ -21479,6 +21493,11 @@ var StepModelBase = class {
     }
     const element = this.entry(localID);
     element.buffer = this.bufferProvider_.acquire(element.address, element.length).buffer;
+    if (element.multiMapping !== void 0) {
+      for (const mapped of element.multiMapping) {
+        mapped.buffer = this.bufferProvider_.acquire(mapped.address, mapped.length).buffer;
+      }
+    }
   }
   /**
    * Get the size in bytes of the backing buffer for this.
@@ -21599,24 +21618,39 @@ var StepModelBase = class {
     if (!this.isSourceExternal) {
       return seen;
     }
-    const stack = [localID];
+    const frontier = [];
+    const enqueue = (id) => {
+      if (id < this.count_ && !seen.has(id)) {
+        frontier.push(id);
+      }
+    };
+    enqueue(localID);
     if (extraLocalIDs !== void 0) {
       for (const extra of extraLocalIDs) {
-        stack.push(extra);
+        enqueue(extra);
       }
     }
-    while (stack.length > 0) {
-      const id = stack.pop();
-      if (seen.has(id) || id >= this.count_) {
-        continue;
+    while (frontier.length > 0) {
+      const wave = [];
+      for (const id of frontier) {
+        if (seen.has(id) || id >= this.count_) {
+          continue;
+        }
+        seen.add(id);
+        this.pinByLocalID(id);
+        wave.push(id);
+      }
+      frontier.length = 0;
+      if (wave.length === 0) {
+        break;
       }
-      seen.add(id);
-      await this.ensureResidentByLocalID(id);
-      this.pinByLocalID(id);
-      for (const expressID of this.scanRecordRefs_(id)) {
-        const referenced = this.expressIDMap_.get(expressID);
-        if (referenced !== void 0 && !seen.has(referenced)) {
-          stack.push(referenced);
+      await Promise.all(wave.map((id) => this.ensureResidentByLocalID(id)));
+      for (const id of wave) {
+        for (const expressID of this.scanRecordRefs_(id)) {
+          const referenced = this.expressIDMap_.get(expressID);
+          if (referenced !== void 0 && !seen.has(referenced)) {
+            frontier.push(referenced);
+          }
         }
       }
     }
@@ -21645,6 +21679,35 @@ var StepModelBase = class {
     }
     this.bufferProvider_.unpinRange?.(this.address_[localID], this.length_[localID]);
   }
+  /**
+   * Drop captured source-window views on `localIDs` so the LRU can
+   * evict those chunks. Vtables stay — `acquire` of the same
+   * `(address, length)` is at a stable base. The next
+   * `ensureResident` + field read rematerialises the view.
+   *
+   * @param localIDs Records whose `buffer` views to drop.
+   */
+  releaseSourceViews(localIDs) {
+    if (!this.isSourceExternal) {
+      return;
+    }
+    for (const localID of localIDs) {
+      if (localID >= this.count_) {
+        continue;
+      }
+      const item = this.complexEntries_?.get(localID) ?? this.descriptorCache_[localID];
+      if (item === void 0) {
+        continue;
+      }
+      item.buffer = void 0;
+      if (item.multiMapping !== void 0) {
+        for (const mapped of item.multiMapping) {
+          mapped.buffer = void 0;
+        }
+      }
+    }
+    releaseScratchParsingBuffer();
+  }
   /**
    * Unpin every local ID in `localIDs` (best-effort; missing IDs are
    * ignored). Use after {@link ensureResidentClosureByLocalID}, which
@@ -27108,6 +27171,7 @@ var StepEntityBase = class {
    */
   extractParseBuffer(offset, baseOffset, depth, result, module2, optional) {
     offset -= this.multiReference_ !== void 0 ? baseOffset : 0;
+    this.guaranteeBuffer();
     const internalReference = this.guaranteeVTable(depth);
     if (offset >= internalReference.vtableCount) {
       throw new Error("Couldn't read field due to too few fields in record");
@@ -27220,6 +27284,7 @@ var StepEntityBase = class {
    * @return {Uint8Array} The buffer for this.
    */
   get buffer() {
+    this.guaranteeBuffer();
     return this.internalReference_.buffer;
   }
   /**
@@ -27310,6 +27375,9 @@ var StepEntityBase = class {
           throw new Error("Entity does not have matching table entry to read from model");
         }
       }
+      if (classReference.buffer === void 0) {
+        this.model.populateBufferEntry(this.localID);
+      }
       this.internalReference_.buffer = classReference.buffer;
       return classReference;
     }
@@ -27320,6 +27388,9 @@ var StepEntityBase = class {
         throw new Error("Entity does not have matching table entry to read from model");
       }
     }
+    if (internalReference.buffer === void 0) {
+      this.guaranteeBuffer();
+    }
     return internalReference;
   }
   /**
@@ -93385,12 +93456,13 @@ function heapDeltaSuffix(state) {
 function formatStageLine(state, final) {
   const duration = state.lastElapsedMs - state.startElapsedMs;
   const heap = heapDeltaSuffix(state);
+  const window2 = state.residentSourceMb !== void 0 ? `, window=${formatMb(state.residentSourceMb)} MB` : "";
   const determinate = state.percent !== void 0;
   if (final && !(determinate && state.percent < PERCENT)) {
-    return `${state.label}: ${formatSeconds(duration)}${heap}`;
+    return `${state.label}: ${formatSeconds(duration)}${heap}${window2}`;
   }
   const bar = formatBar(determinate ? state.percent : void 0);
-  return `${state.label} ${bar} ${formatSeconds(duration)}${heap}`;
+  return `${state.label} ${bar} ${formatSeconds(duration)}${heap}${window2}`;
 }
 var LoadLogAccumulator = class {
   constructor() {
@@ -93439,6 +93511,9 @@ var LoadLogAccumulator = class {
       current.startHeapMb ??= event.memoryMb;
       current.lastHeapMb = event.memoryMb;
     }
+    if (event.residentSourceMb !== void 0) {
+      current.residentSourceMb = event.residentSourceMb;
+    }
     if (event.total !== void 0 && event.total > 0) {
       current.percent = event.completed / event.total * PERCENT;
     }

package/compiled/examples/cli-step-bundled.cjs

@@ -15943,7 +15943,7 @@ var ParsingBuffer = class {
 };
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.511.1441";
+var versionString = "Conway v1.513.1447";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 function pThreadsAllowed() {
@@ -18649,7 +18649,10 @@ var StepParser = class extends StepHeaderParser {
         if (!charws(SEMICOLON)) {
           return syntaxError();
         }
-        onRecordIndexed?.(topLevelCount, expressID, 0);
+        {
+          const recordLen = input.address - startElement2;
+          onRecordIndexed?.(topLevelCount, expressID, 0, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+        }
         ++topLevelCount;
         pushEntry({
           address: startElement2,
@@ -18739,7 +18742,10 @@ var StepParser = class extends StepHeaderParser {
       if (!charws(SEMICOLON)) {
         return syntaxError();
       }
-      onRecordIndexed?.(topLevelCount, expressID, foundItem);
+      {
+        const recordLen = input.address - startElement;
+        onRecordIndexed?.(topLevelCount, expressID, foundItem, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+      }
       ++topLevelCount;
       pushEntry({
         address: startElement,
@@ -21154,6 +21160,9 @@ var StepModelBase = class {
     if (element.vtableIndex === void 0 && !this.populateVtableEntryRaw(element)) {
       return void 0;
     }
+    if (element.buffer === void 0) {
+      this.populateBufferEntry(localID);
+    }
     const vtable = element.vtable;
     const buffer = element.buffer;
     if (vtable === void 0 || buffer === void 0 || offset >= (element.vtableCount ?? 0)) {
@@ -21223,6 +21232,11 @@ var StepModelBase = class {
     }
     const element = this.entry(localID);
     element.buffer = this.bufferProvider_.acquire(element.address, element.length).buffer;
+    if (element.multiMapping !== void 0) {
+      for (const mapped of element.multiMapping) {
+        mapped.buffer = this.bufferProvider_.acquire(mapped.address, mapped.length).buffer;
+      }
+    }
   }
   /**
    * Get the size in bytes of the backing buffer for this.
@@ -21343,24 +21357,39 @@ var StepModelBase = class {
     if (!this.isSourceExternal) {
       return seen;
     }
-    const stack = [localID];
+    const frontier = [];
+    const enqueue = (id) => {
+      if (id < this.count_ && !seen.has(id)) {
+        frontier.push(id);
+      }
+    };
+    enqueue(localID);
     if (extraLocalIDs !== void 0) {
       for (const extra of extraLocalIDs) {
-        stack.push(extra);
+        enqueue(extra);
       }
     }
-    while (stack.length > 0) {
-      const id = stack.pop();
-      if (seen.has(id) || id >= this.count_) {
-        continue;
+    while (frontier.length > 0) {
+      const wave = [];
+      for (const id of frontier) {
+        if (seen.has(id) || id >= this.count_) {
+          continue;
+        }
+        seen.add(id);
+        this.pinByLocalID(id);
+        wave.push(id);
+      }
+      frontier.length = 0;
+      if (wave.length === 0) {
+        break;
       }
-      seen.add(id);
-      await this.ensureResidentByLocalID(id);
-      this.pinByLocalID(id);
-      for (const expressID of this.scanRecordRefs_(id)) {
-        const referenced = this.expressIDMap_.get(expressID);
-        if (referenced !== void 0 && !seen.has(referenced)) {
-          stack.push(referenced);
+      await Promise.all(wave.map((id) => this.ensureResidentByLocalID(id)));
+      for (const id of wave) {
+        for (const expressID of this.scanRecordRefs_(id)) {
+          const referenced = this.expressIDMap_.get(expressID);
+          if (referenced !== void 0 && !seen.has(referenced)) {
+            frontier.push(referenced);
+          }
         }
       }
     }
@@ -21389,6 +21418,35 @@ var StepModelBase = class {
     }
     this.bufferProvider_.unpinRange?.(this.address_[localID], this.length_[localID]);
   }
+  /**
+   * Drop captured source-window views on `localIDs` so the LRU can
+   * evict those chunks. Vtables stay — `acquire` of the same
+   * `(address, length)` is at a stable base. The next
+   * `ensureResident` + field read rematerialises the view.
+   *
+   * @param localIDs Records whose `buffer` views to drop.
+   */
+  releaseSourceViews(localIDs) {
+    if (!this.isSourceExternal) {
+      return;
+    }
+    for (const localID of localIDs) {
+      if (localID >= this.count_) {
+        continue;
+      }
+      const item = this.complexEntries_?.get(localID) ?? this.descriptorCache_[localID];
+      if (item === void 0) {
+        continue;
+      }
+      item.buffer = void 0;
+      if (item.multiMapping !== void 0) {
+        for (const mapped of item.multiMapping) {
+          mapped.buffer = void 0;
+        }
+      }
+    }
+    releaseScratchParsingBuffer();
+  }
   /**
    * Unpin every local ID in `localIDs` (best-effort; missing IDs are
    * ignored). Use after {@link ensureResidentClosureByLocalID}, which
@@ -23035,6 +23093,7 @@ var StepEntityBase = class {
    */
   extractParseBuffer(offset, baseOffset, depth, result, module2, optional) {
     offset -= this.multiReference_ !== void 0 ? baseOffset : 0;
+    this.guaranteeBuffer();
     const internalReference = this.guaranteeVTable(depth);
     if (offset >= internalReference.vtableCount) {
       throw new Error("Couldn't read field due to too few fields in record");
@@ -23147,6 +23206,7 @@ var StepEntityBase = class {
    * @return {Uint8Array} The buffer for this.
    */
   get buffer() {
+    this.guaranteeBuffer();
     return this.internalReference_.buffer;
   }
   /**
@@ -23237,6 +23297,9 @@ var StepEntityBase = class {
           throw new Error("Entity does not have matching table entry to read from model");
         }
       }
+      if (classReference.buffer === void 0) {
+        this.model.populateBufferEntry(this.localID);
+      }
       this.internalReference_.buffer = classReference.buffer;
       return classReference;
     }
@@ -23247,6 +23310,9 @@ var StepEntityBase = class {
         throw new Error("Entity does not have matching table entry to read from model");
       }
     }
+    if (internalReference.buffer === void 0) {
+      this.guaranteeBuffer();
+    }
     return internalReference;
   }
   /**