@woosh/meep-engine 3.24.0 → 3.26.0

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_CUT_STAT_COUNT.js

@@ -0,0 +1,8 @@
+/**
+ * How many counters {@link VGEO_CUT_STAT} names.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_CUT_STAT_COUNT = 14;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_FEEDBACK_OFFSET.d.ts

@@ -0,0 +1,7 @@
+export namespace VGEO_FEEDBACK_OFFSET {
+    let WANT_COUNT: number;
+    let TOUCH_COUNT: number;
+    let STATS: number;
+    let HEADER_WORDS: number;
+}
+//# sourceMappingURL=VGEO_FEEDBACK_OFFSET.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_FEEDBACK_OFFSET.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_FEEDBACK_OFFSET.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_FEEDBACK_OFFSET.js"],"names":[],"mappings":""}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_FEEDBACK_OFFSET.js

@@ -0,0 +1,27 @@
+import { VGEO_CUT_STAT_COUNT } from "./VGEO_CUT_STAT_COUNT.js";
+
+/**
+ * Word offsets in the feedback buffer — the one thing the cut hands back to the CPU, and the only
+ * place in the runtime where a GPU pass and a host frame meet.
+ *
+ * Header first, then the two lists, so a readback of the header alone tells a saturated frame how
+ * much of the rest is worth mapping. Design §6: the wants loop tolerates its transport — multi-frame
+ * `mapAsync` latency, a small in-flight cap, and frames where feedback is skipped entirely.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export const VGEO_FEEDBACK_OFFSET = {
+    WANT_COUNT: 0,
+    TOUCH_COUNT: 1,
+    /**
+     * Counters live in the header so that a frame whose lists overflowed still says so.
+     */
+    STATS: 2,
+    /**
+     * Where the want records begin. The lists themselves are sized by the caller's options and
+     * their bases travel in the params block, because a graph resource's size is a host-side
+     * decision and the kernel must not assume one.
+     */
+    HEADER_WORDS: 2 + VGEO_CUT_STAT_COUNT,
+};

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_NONE.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `GEOMETRY_METADATA_STRUCT.vg_row` for a geometry that is not virtual — which is nearly all of
+ * them, and every one that existed before this field did.
+ *
+ * It is how a shader handed a list of visible mesh instances tells a VG instance from a static one,
+ * and it is the whole of what the engine's record formats had to learn about virtual geometry. The
+ * draw records, the meshlet metadata, the material buckets and the indirect draws are unchanged.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_GEOMETRY_ROW_NONE: number;
+//# sourceMappingURL=VGEO_GEOMETRY_ROW_NONE.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_NONE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_GEOMETRY_ROW_NONE.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_NONE.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qCAFU,MAAM,CAEiC"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_NONE.js

@@ -0,0 +1,13 @@
+/**
+ * `GEOMETRY_METADATA_STRUCT.vg_row` for a geometry that is not virtual — which is nearly all of
+ * them, and every one that existed before this field did.
+ *
+ * It is how a shader handed a list of visible mesh instances tells a VG instance from a static one,
+ * and it is the whole of what the engine's record formats had to learn about virtual geometry. The
+ * draw records, the meshlet metadata, the material buckets and the indirect draws are unchanged.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_GEOMETRY_ROW_NONE = 0xFFFFFFFF;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_OFFSET.d.ts

@@ -0,0 +1,7 @@
+export namespace VGEO_GEOMETRY_ROW_OFFSET {
+    let ROOT_PAGE_ROW: number;
+    let LOOKUP_WORD_OFFSET: number;
+    let PAGE_COUNT: number;
+    let ORDINAL_CAPACITY: number;
+}
+//# sourceMappingURL=VGEO_GEOMETRY_ROW_OFFSET.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_OFFSET.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_GEOMETRY_ROW_OFFSET.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_OFFSET.js"],"names":[],"mappings":""}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_OFFSET.js

@@ -0,0 +1,35 @@
+/**
+ * Word offsets within one VG geometry row.
+ *
+ * Read by the instance-collect pass and folded into each instance record, so the traversal kernel
+ * never binds this table at all — which is one of the reasons it fits inside the engine's
+ * ten-storage-buffer floor (`runtime/RUNTIME_PLAN.md` §4.9).
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export const VGEO_GEOMETRY_ROW_OFFSET = {
+    /**
+     * Page-table row of page 0, which is pinned and therefore always valid.
+     */
+    ROOT_PAGE_ROW: 0,
+    /**
+     * Start of this geometry's page lookup in the arena: `PAGE_COUNT` words, container page index →
+     * page-table row or {@link VGEO_PAGE_ROW_NONE}.
+     *
+     * A lookup rather than a pointer stored in each referring cluster row, because the pointer
+     * makes an install a scatter over every cluster that refers into the arriving page — across
+     * pages, unbounded, and undone on eviction. One indirection in the shader is cheaper than that
+     * every time.
+     */
+    LOOKUP_WORD_OFFSET: 1,
+    /**
+     * `total_pages` of the container — the lookup's extent.
+     */
+    PAGE_COUNT: 2,
+    /**
+     * How wide one instance's slice of the claim bitmask has to be. The high-water mark of handed
+     * out ordinals, not the resident count: ordinals come from a free list and can be sparse.
+     */
+    ORDINAL_CAPACITY: 3,
+};

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_WORDS.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Words in one VG geometry row.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_GEOMETRY_ROW_WORDS: number;
+//# sourceMappingURL=VGEO_GEOMETRY_ROW_WORDS.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_WORDS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_GEOMETRY_ROW_WORDS.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_WORDS.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,sCAFU,MAAM,CAEyB"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GEOMETRY_ROW_WORDS.js

@@ -0,0 +1,8 @@
+/**
+ * Words in one VG geometry row.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_GEOMETRY_ROW_WORDS = 4;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_FLAG_SELECTABLE.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The group is selectable: every one of its `parent_cluster_count` references is live —
+ * the referencing cluster's page installed and that cluster's own group selectable
+ * (`VGEO_FORMAT.md` §10).
+ *
+ * The cut rule's clamp reads *this*, not residency, and so does the predicate's own-group term.
+ * `runtime/RUNTIME_PLAN.md` §4.4: leaving the own-group term out draws a coarse stand-in and the
+ * fine surface it stands in for, both, a few microns apart.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_GROUP_FLAG_SELECTABLE: number;
+//# sourceMappingURL=VGEO_GROUP_FLAG_SELECTABLE.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_FLAG_SELECTABLE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_GROUP_FLAG_SELECTABLE.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_FLAG_SELECTABLE.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,yCAFU,MAAM,CAE4B"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_FLAG_SELECTABLE.js

@@ -0,0 +1,14 @@
+/**
+ * The group is selectable: every one of its `parent_cluster_count` references is live —
+ * the referencing cluster's page installed and that cluster's own group selectable
+ * (`VGEO_FORMAT.md` §10).
+ *
+ * The cut rule's clamp reads *this*, not residency, and so does the predicate's own-group term.
+ * `runtime/RUNTIME_PLAN.md` §4.4: leaving the own-group term out draws a coarse stand-in and the
+ * fine surface it stands in for, both, a few microns apart.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_GROUP_FLAG_SELECTABLE = 1;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_ROW_OFFSET.d.ts

@@ -0,0 +1,7 @@
+export namespace VGEO_GROUP_ROW_OFFSET {
+    let CLUSTER_FIRST: number;
+    let CLUSTER_COUNT: number;
+    let FLAGS: number;
+    let PARENT_COUNT: number;
+}
+//# sourceMappingURL=VGEO_GROUP_ROW_OFFSET.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_ROW_OFFSET.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_GROUP_ROW_OFFSET.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_ROW_OFFSET.js"],"names":[],"mappings":""}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_ROW_OFFSET.js

@@ -0,0 +1,36 @@
+/**
+ * Word offsets within one group row.
+ *
+ * The group is the atomic LOD decision unit (design §3) and the atomic *activation* unit
+ * (`VGEO_FORMAT.md` §10), so selectability lives here and nowhere else — a per-cluster copy would
+ * have to be scattered over every referring cluster on each install.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export const VGEO_GROUP_ROW_OFFSET = {
+    /**
+     * First cluster of this group, as a row within its page's cluster block.
+     */
+    CLUSTER_FIRST: 0,
+    CLUSTER_COUNT: 1,
+    /**
+     * @see VGEO_GROUP_FLAG_SELECTABLE
+     */
+    FLAGS: 2,
+    /**
+     * How many clusters anywhere in the container refine into this group — the format's
+     * `group_parent_count`, copied in at install.
+     *
+     * It is here so that **this tier can answer its own activation question**. Selectability is
+     * "every parent reference is live", and which references are live depends on which pages are
+     * resident *in the tier asking* — so the RAM tier's answer is not the VRAM tier's, and the VRAM
+     * tier publishing the RAM tier's answer is REVIEW_LEDGER C1: a group drawn because its
+     * ancestors are in RAM, under a coarse stand-in drawn because one of them is not in VRAM.
+     *
+     * With this word, `VGeoRuntimeTables.refresh_selectable` computes the VRAM answer from the
+     * arena and the page lookup alone. No reader is consulted, which also means a page whose RAM
+     * copy has been evicted underneath this tier still has a correct answer.
+     */
+    PARENT_COUNT: 3,
+};

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_ROW_WORDS.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Words in one group row. Four rather than three so a group block stays 16-byte aligned, which
+ * costs nothing — a page carries a handful of groups against hundreds of clusters.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_GROUP_ROW_WORDS: number;
+//# sourceMappingURL=VGEO_GROUP_ROW_WORDS.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_ROW_WORDS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_GROUP_ROW_WORDS.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_ROW_WORDS.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,mCAFU,MAAM,CAEsB"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_GROUP_ROW_WORDS.js

@@ -0,0 +1,9 @@
+/**
+ * Words in one group row. Four rather than three so a group block stays 16-byte aligned, which
+ * costs nothing — a page carries a handful of groups against hundreds of clusters.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_GROUP_ROW_WORDS = 4;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_INSTANCE_OFFSET.d.ts

@@ -0,0 +1,11 @@
+export namespace VGEO_INSTANCE_OFFSET {
+    let EYE: number;
+    let PROJECTION_K: number;
+    let FRUSTUM: number;
+    let MESH_INDEX: number;
+    let ROOT_PAGE_ROW: number;
+    let LOOKUP_WORD_OFFSET: number;
+    let CLAIM_BASE: number;
+    let ORDINAL_CAPACITY: number;
+}
+//# sourceMappingURL=VGEO_INSTANCE_OFFSET.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_INSTANCE_OFFSET.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_INSTANCE_OFFSET.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_INSTANCE_OFFSET.js"],"names":[],"mappings":""}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_INSTANCE_OFFSET.js

@@ -0,0 +1,54 @@
+/**
+ * Word offsets within one instance record — a visible VG instance, as the cut kernel sees it.
+ *
+ * Everything here is **object space**, and that is `MICRON_COMPARISON_2026_08_20.md` §2.7 as
+ * design §3.1 adopted it: multiply the camera's view-projection by the instance transform once,
+ * derive the frustum from the result, and run every cull and error test against untransformed
+ * cluster bounds. One matrix per instance instead of a transform per cluster, and with thousands
+ * of instances sharing one geometry that difference is the entire cost.
+ *
+ * The geometry's own fields are folded in here rather than looked up, so the traversal kernel does
+ * not bind the geometry table.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export const VGEO_INSTANCE_OFFSET = {
+    /**
+     * The camera's position in this instance's object space.
+     */
+    EYE: 0,
+    /**
+     * `screen_height / (2 * tan(fov_y / 2))`, times the scale correction below.
+     *
+     * Error and distance are both object-space, so a **uniform** instance scale cancels out of
+     * `r_e * k / d` exactly and needs no term at all. A non-uniform one does not cancel, and the
+     * correction is the ratio of the transform's singular values — σ_max / σ_min, not the ratio of
+     * its column lengths, which a shear leaves at 1 while stretching space without bound
+     * (REVIEW_LEDGER M4). It over-refines rather than under-refines, and it is exactly 1 for every
+     * instance that is not stretched.
+     */
+    PROJECTION_K: 3,
+    /**
+     * Five object-space frustum planes, `xyzw` each, in the order left, right, bottom, top, near.
+     *
+     * Five and not six: the projection is infinite reverse-Z, so the far plane's row is degenerate
+     * and normalizing it produces nothing a test can use. Ordering it last is what makes "test the
+     * first five" true by construction rather than by knowing which one to skip.
+     */
+    FRUSTUM: 4,
+    /**
+     * Which mesh row this instance is — the second half of every draw record it emits.
+     */
+    MESH_INDEX: 24,
+    ROOT_PAGE_ROW: 25,
+    LOOKUP_WORD_OFFSET: 26,
+    /**
+     * First bit of this instance's slice of the claim bitmask.
+     */
+    CLAIM_BASE: 27,
+    /**
+     * How many bits that slice runs to.
+     */
+    ORDINAL_CAPACITY: 28,
+};

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_INSTANCE_WORDS.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Words in one instance record.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_INSTANCE_WORDS: number;
+//# sourceMappingURL=VGEO_INSTANCE_WORDS.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_INSTANCE_WORDS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_INSTANCE_WORDS.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_INSTANCE_WORDS.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,kCAFU,MAAM,CAEsB"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_INSTANCE_WORDS.js

@@ -0,0 +1,8 @@
+/**
+ * Words in one instance record.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_INSTANCE_WORDS = 32;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_LEAF_BIT.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Set in a node row's `CHILD_COUNT_AND_FLAGS` when the children are groups rather than nodes.
+ *
+ * Above the fanout cap of 4 by a wide margin, so the count is readable as the low byte.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_NODE_ROW_LEAF_BIT: number;
+//# sourceMappingURL=VGEO_NODE_ROW_LEAF_BIT.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_LEAF_BIT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_NODE_ROW_LEAF_BIT.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_LEAF_BIT.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qCAFU,MAAM,CAE4B"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_LEAF_BIT.js

@@ -0,0 +1,10 @@
+/**
+ * Set in a node row's `CHILD_COUNT_AND_FLAGS` when the children are groups rather than nodes.
+ *
+ * Above the fanout cap of 4 by a wide margin, so the count is readable as the low byte.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_NODE_ROW_LEAF_BIT = 0x100;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_OFFSET.d.ts

@@ -0,0 +1,7 @@
+export namespace VGEO_NODE_ROW_OFFSET {
+    let SPHERE: number;
+    let MAX_PARENT_ERROR: number;
+    let CHILD_FIRST: number;
+    let CHILD_COUNT_AND_FLAGS: number;
+}
+//# sourceMappingURL=VGEO_NODE_ROW_OFFSET.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_OFFSET.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_NODE_ROW_OFFSET.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_OFFSET.js"],"names":[],"mappings":""}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_OFFSET.js

@@ -0,0 +1,30 @@
+/**
+ * Word offsets within one node row — the page's own tree over its own groups
+ * (`VGEO_FORMAT.md` §6.1).
+ *
+ * `min_self_error` is not carried. It ranks a prefetch, and the cut never asks it anything:
+ * see `runtime/RUNTIME_PLAN.md` §4.8.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export const VGEO_NODE_ROW_OFFSET = {
+    /**
+     * Contains every `parent_sphere` under this node, so it bounds the subtree's geometry too.
+     */
+    SPHERE: 0,
+    /**
+     * The coarsest parent error covered. A node whose largest parent error still projects to no
+     * more than τ has nothing drawable anywhere under it.
+     */
+    MAX_PARENT_ERROR: 4,
+    /**
+     * A node index when interior, a group index when a leaf.
+     */
+    CHILD_FIRST: 5,
+    /**
+     * `count | (leaf ? 0x100 : 0)`.
+     * @see VGEO_NODE_ROW_LEAF_BIT
+     */
+    CHILD_COUNT_AND_FLAGS: 6,
+};

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_WORDS.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Words in one node row.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_NODE_ROW_WORDS: number;
+//# sourceMappingURL=VGEO_NODE_ROW_WORDS.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_WORDS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_NODE_ROW_WORDS.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_WORDS.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,kCAFU,MAAM,CAEqB"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NODE_ROW_WORDS.js

@@ -0,0 +1,8 @@
+/**
+ * Words in one node row.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_NODE_ROW_WORDS = 8;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NO_CHILD_PAGE.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A cluster row's `CHILD_PAGE_INDEX` when the cluster is a leaf — nothing refines it, and the cut
+ * takes it at any threshold.
+ *
+ * Distinct from {@link VGEO_PAGE_ROW_NONE}, which says a child exists and is not here. Conflating
+ * them would turn every leaf into a permanent want.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_NO_CHILD_PAGE: number;
+//# sourceMappingURL=VGEO_NO_CHILD_PAGE.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NO_CHILD_PAGE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_NO_CHILD_PAGE.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NO_CHILD_PAGE.js"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,iCAFU,MAAM,CAE6B"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_NO_CHILD_PAGE.js

@@ -0,0 +1,12 @@
+/**
+ * A cluster row's `CHILD_PAGE_INDEX` when the cluster is a leaf — nothing refines it, and the cut
+ * takes it at any threshold.
+ *
+ * Distinct from {@link VGEO_PAGE_ROW_NONE}, which says a child exists and is not here. Conflating
+ * them would turn every leaf into a permanent want.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_NO_CHILD_PAGE = 0xFFFFFFFF;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_NONE.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The page-lookup entry for a page that is not VRAM-resident.
+ *
+ * A cluster whose child page reads this is **clamped**: it draws as it stands and records a want.
+ * That is the residency clamp (design §4), and it is the reason a cut can be taken at all before a
+ * file has finished arriving — the coarser cluster is not a fallback for a missing one, it is the
+ * correct surface over exactly the region the missing page would have refined.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_PAGE_ROW_NONE: number;
+//# sourceMappingURL=VGEO_PAGE_ROW_NONE.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_NONE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_PAGE_ROW_NONE.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_NONE.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,iCAFU,MAAM,CAE6B"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_NONE.js

@@ -0,0 +1,13 @@
+/**
+ * The page-lookup entry for a page that is not VRAM-resident.
+ *
+ * A cluster whose child page reads this is **clamped**: it draws as it stands and records a want.
+ * That is the residency clamp (design §4), and it is the reason a cut can be taken at all before a
+ * file has finished arriving — the coarser cluster is not a fallback for a missing one, it is the
+ * correct surface over exactly the region the missing page would have refined.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_PAGE_ROW_NONE = 0xFFFFFFFF;

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_OFFSET.d.ts

@@ -0,0 +1,11 @@
+export namespace VGEO_PAGE_ROW_OFFSET {
+    let NODE_COUNT: number;
+    let GROUP_COUNT: number;
+    let CLUSTER_COUNT: number;
+    let MESHLET_BASE: number;
+    let PAGE_INDEX: number;
+    let ORDINAL: number;
+    let GEOMETRY_ROW: number;
+    let DECODED_SIZE: number;
+}
+//# sourceMappingURL=VGEO_PAGE_ROW_OFFSET.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_OFFSET.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_PAGE_ROW_OFFSET.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_OFFSET.js"],"names":[],"mappings":""}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_OFFSET.js

@@ -0,0 +1,61 @@
+/**
+ * Word offsets within the **header of one page slot** — the first words of every fixed-stride slot
+ * in the arena, before that page's node, group and cluster rows.
+ *
+ * This is `VIRTUAL_GEOMETRY_DESIGN.md` §6's "fixed-size page-slot allocation" taken literally. A
+ * slot's address is `page row × VGEO_CUT_PARAMS.page_slot_words`: no allocator, no growth path, no
+ * ceiling to run into, and no second buffer to keep coherent with this one. What made that
+ * available is format §11.14 — `nominal_page_size` is a bound every page is within, announced by a
+ * feature bit, and `GPUVirtualGeometryPool.register` refuses a container that does not carry it.
+ *
+ * **The page header is inside the slot rather than in a table of its own**, and that is worth a
+ * sentence because the plan drew it the other way. A separate table costs a second storage binding
+ * in the traversal, which declares nine against the engine's floor of ten (RUNTIME_PLAN §4.9), and
+ * it costs a coherence question — a page row and its block written to two buffers, dirtied
+ * separately, uploaded separately. In one slot an install is one contiguous range and the header is
+ * where the reader of the block already is.
+ *
+ * There is no `ARENA_WORD_OFFSET` any more. It was the allocator's answer to "where is this page",
+ * and the answer is now a multiply.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export const VGEO_PAGE_ROW_OFFSET = {
+    NODE_COUNT: 0,
+    GROUP_COUNT: 1,
+    CLUSTER_COUNT: 2,
+    /**
+     * Row of this page's cluster 0 in the meshlet **metadata** pool, so a draw record is
+     * `meshlet_base + local cluster` and downstream reads the buffer it already reads.
+     *
+     * The one field of a slot that moves without the page moving: `GPUMeshletManager` relocates
+     * batches when it compacts, and the pool republishes this from the batch's `changed` signal.
+     */
+    MESHLET_BASE: 3,
+    /**
+     * The container's own page index — the frame ordinal. What a touch reports, and what a want
+     * dedups on.
+     */
+    PAGE_INDEX: 4,
+    /**
+     * Dense index of this page *within its geometry*, which is what the per-instance claim bitmask
+     * is indexed by. Global page-table rows would make the claim `instances × pool capacity`, which
+     * does not fit; per-geometry ordinals make it `instances × that geometry's working set`.
+     */
+    ORDINAL: 5,
+    /**
+     * Row in the VG geometry table.
+     */
+    GEOMETRY_ROW: 6,
+    /**
+     * Decoded bytes this page cost the tier, held here rather than re-derived from the RAM reader
+     * at eviction time.
+     *
+     * The tier that charged the budget is the tier that has to refund it, and the RAM tier can drop
+     * a page the VRAM tier still holds — which made the refund zero and walked `resident_bytes`
+     * upward until the budget refused every install (REVIEW_LEDGER C4). A number the tier wrote
+     * down itself cannot drift.
+     */
+    DECODED_SIZE: 7,
+};

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_WORDS.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Words in one page-table row.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_PAGE_ROW_WORDS: number;
+//# sourceMappingURL=VGEO_PAGE_ROW_WORDS.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_WORDS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VGEO_PAGE_ROW_WORDS.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_WORDS.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,kCAFU,MAAM,CAEqB"}

package/src/shade/renderer/geometry/virtual/runtime/layout/VGEO_PAGE_ROW_WORDS.js

@@ -0,0 +1,8 @@
+/**
+ * Words in one page-table row.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ * @type {number}
+ */
+export const VGEO_PAGE_ROW_WORDS = 8;