@woosh/meep-engine 3.25.0 → 3.27.0

package/src/shade/renderer/geometry/virtual/residency/VGeoResidencyOptions.js

@@ -1,50 +0,0 @@
-/**
- * What a {@link VGeoResidencyManager} is allowed to spend.
- *
- * @author Alex Goldring
- * @copyright Company Named Limited (c) 2026
- */
-export class VGeoResidencyOptions {
-    /**
-     * The RAM tier's budget: decoded page bytes, summed over every registered reader.
-     *
-     * Design §6 pins the tiers — CDN ⊇ RAM ⊇ VRAM — and says residency is a small fraction of the
-     * asset in RAM. What makes a number necessary rather than advisory is scale: a thousand assets
-     * of a hundred million triangles each are several gigabytes of pages *apiece*, so the resident
-     * set has to be a small fraction of *one* of them, and nothing about a single reader can know
-     * that. 512 MiB is a default to be overridden by whoever knows the device, not a measurement.
-     *
-     * It is spent against `VGeoContainerReader.resident_bytes`, which is decoded page images and
-     * not what those pages cost in the heap — the reader's own per-page bookkeeping measured
-     * 6.4–11.9 KB on top of each image, which is 1.2% at the page sizes design §5 targets. A budget
-     * set against unusually small pages should allow for it.
-     *
-     * @type {number}
-     */
-    budget_bytes = 512 * 1024 * 1024;
-
-    /**
-     * How many page fetches may be in flight at once, across every registered reader.
-     *
-     * The number that matters to a browser and to a CDN, and the one no reader can set: eight
-     * readers at the per-reader default of 6 were measured issuing 48 concurrent range requests.
-     * Twelve is more than one HTTP/1.1 connection pool will give and less than an H2/H3 multiplex
-     * will happily carry, which is the range this wants to sit in.
-     *
-     * @type {number}
-     */
-    max_concurrent_fetches = 12;
-
-    /**
-     * How many frames a page is protected from eviction after it was last touched.
-     *
-     * Design §6: eviction is LRU on **last-touched**, with a protect window no shorter than the
-     * feedback latency. The window is what stops the classic fallback-chain bug — feedback arrives a
-     * frame or three late, so a page that is on screen right now may not have been reported as
-     * touched yet, and evicting on a stamp that has not caught up evicts exactly what is being
-     * drawn. Three frames is one `mapAsync` round trip's worth of slack.
-     *
-     * @type {number}
-     */
-    protect_frames = 3;
-}

package/src/shade/renderer/shader/chunk/jobs/NOTES.md

@@ -1,47 +0,0 @@
-see https://youtu.be/nWgPtCDXlPc?si=QcFQ62Wz3I6W4FEE&t=1881
-
-Original code from Capcom:
-
-```hlsl
-bool JobScattering(uint job) {
-    if (job != JOB_EMPTY) {
-        uint counts = WaveActiveCountBits(1);
-        uint writeoffset = 0;
-        if (WaveIsFirstLane()) {
-            RingBuffer.InterlockedAdd(JOB_RING_TAIL, counts, writeoffset);
-        }
-
-        writeoffset = WaveReadLaneFirst(writeoffset) + WavePrefixCountBits(1);
-        writeoffset &= WORK_BUFFER_SIZE_IN_DWORD - 1;
-        uint ret;
-        RingBuffer.InterlockedCompareExchange(writeoffset * 4, JOB_EMPTY, job, ret);
-        if (ret == JOB_EMPTY) {
-            uint counts = WaveActiveCountBits(1);
-            if (WaveIsFirstLane()) {
-                RingBuffer.InterlockedAdd(JOB_COUNT, counts);
-            }
-            return true;
-        }
-    }
-    return false;
-}
-
-bool JobGathering(out uint job) {
-    uint counts = WaveActiveCountBits(1);
-    uint readoffset = 0;
-    if (WaveIsFirstLane()) {
-        RingBuffer.InterlockedAdd(JOB_RING_HEAD, counts, readoffset);
-    }
-    readoffset = WaveReadLaneFirst(readoffset) + WavePrefixCountBits(1);
-    readoffset &= WORK_BUFFER_SIZE_IN_DWORD - 1;
-    RingBuffer.InterlockedMin(readoffset * 4, JOB_EMPTY, job);
-    if (job != JOB_EMPTY) {
-        int counts = (int)WaveActiveCountBits(1);
-        if (WaveIsFirstLane()) {
-            RingBuffer.InterlockedAdd(JOB_COUNT, -counts);
-        }
-        return true;
-    }
-    return false;
-}
-```

package/src/shade/renderer/shader/chunk/jobs/chunk_job_system.js

@@ -1,102 +0,0 @@
-import { CodeChunk } from "../../compiler/CodeChunk.js";
-
-export const chunk_job_system = CodeChunk.from(
-    //language=WGSL
-    `
-
-const JOB_RING_TAIL: u32 = 0u;
-const JOB_RING_HEAD: u32 = 1u;
-const JOB_COUNT: u32 = 2u;
-
-const JOB_EMPTY: u32 = 0u;
-const WORK_BUFFER_SIZE: u32 = 512u; 
-
-var<workgroup> jobs_ring_buffer: array<atomic<u32>, WORK_BUFFER_SIZE>;
-
-// --- Helper function for WaveActiveCountBits ---
-// HLSL's WaveActiveCountBits(1) counts all active invocations (lanes) in the wave.
-// In WGSL, we can achieve this by getting a bitmask of all active invocations
-// with subgroupBallot(true) and then counting the set bits (1s).
-fn subgroup_active_count() -> u32 {
-    let ballot = subgroupBallot(true); // Returns vec4<u32> bitmask
-    return countOneBits(ballot.x) + countOneBits(ballot.y) +
-           countOneBits(ballot.z) + countOneBits(ballot.w);
-}
-
-
-// --- Translated Functions ---
-
-/// @brief Scatters a job into the ring buffer.
-/// Corresponds to the HLSL \`JobScattering\` function.
-fn jobScattering(job: u32) -> bool {
-    if (job != JOB_EMPTY) {
-        // WaveActiveCountBits(1) -> Get the total number of active invocations.
-        let counts = subgroup_active_count();
-        var writeoffset: u32 = 0u;
-
-        // WaveIsFirstLane() -> subgroupElect()
-        // The first active invocation atomically reserves a block of 'counts' size.
-        if (subgroupElect()) {
-            // InterlockedAdd -> atomicAdd. Returns the original value before the addition.
-            writeoffset = atomicAdd(&jobs_ring_buffer[JOB_RING_TAIL], counts);
-        }
-
-        // WaveReadLaneFirst -> subgroupBroadcastFirst
-        // Broadcast the base offset from the first lane to all others.
-        // WavePrefixCountBits -> subgroupExclusiveAdd(1u)
-        // Each active lane gets a unique index within the reserved block.
-        writeoffset = subgroupBroadcastFirst(writeoffset) + subgroupExclusiveAdd(1u);
-        writeoffset = writeoffset & (WORK_BUFFER_SIZE - 1u);
-
-        // InterlockedCompareExchange -> atomicCompareExchangeWeak
-        // Attempt to write the job into the slot if it's empty.
-        // We use .old_value as the HLSL function returns the original value.
-        let result = atomicCompareExchangeWeak(&jobs_ring_buffer[writeoffset], JOB_EMPTY, job);
-
-        if (result.old_value == JOB_EMPTY) {
-            // If the write was successful (the slot was empty), update the total job count.
-            let final_counts = subgroup_active_count();
-            if (subgroupElect()) {
-                // The '_' ignores the return value of atomicAdd, as we don't need it here.
-                _ = atomicAdd(&jobs_ring_buffer[JOB_COUNT], final_counts);
-            }
-            return true;
-        }
-    }
-    return false;
-}
-
-/// @brief Gathers a job from the ring buffer.
-/// Corresponds to the HLSL \`JobGathering\` function.
-/// WGSL uses pointers for 'out' parameters.
-fn jobGathering(job_out: ptr<function, u32>) -> bool {
-    let counts = subgroup_active_count();
-    var readoffset: u32 = 0u;
-
-    if (subgroupElect()) {
-        readoffset = atomicAdd(&jobs_ring_buffer[JOB_RING_HEAD], counts);
-    }
-
-    readoffset = subgroupBroadcastFirst(readoffset) + subgroupExclusiveAdd(1u);
-    readoffset = readoffset & (WORK_BUFFER_SIZE - 1u);
-
-    // InterlockedMin -> atomicMin
-    // Atomically read the job and replace it with JOB_EMPTY.
-    // This effectively "takes" the job from the queue.
-    *job_out = atomicMin(&jobs_ring_buffer[readoffset], JOB_EMPTY);
-
-    if (*job_out != JOB_EMPTY) {
-        // If a valid job was successfully gathered, decrement the total job count.
-        let final_counts = subgroup_active_count();
-        if (subgroupElect()) {
-            // WGSL's atomicAdd on a u32 wraps around, which is equivalent
-            // to subtraction when using two's complement representation.
-            _ = atomicAdd(&jobs_ring_buffer[JOB_COUNT], u32(-i32(final_counts)));
-        }
-        return true;
-    }
-    return false;
-}
-
-`
-)