@descix/frqtl-node 0.6.0-p1.1 → 0.6.0

package/llms.txt

@@ -1,12 +1,13 @@
 # @descix/frqtl-node
 
 > The FRQTL physics engine (compiled Rust → WASM) for node: the same modules as @descix/frqtl-web, plus
-> `bootNode` and the hosted eyes. Pre-release 0.6.0-p1.1 on npm dist-tag `next`. Node ≥ 22.12.
+> `bootNode` and the hosted eyes. 0.6.0 on npm dist-tag `latest`. Node ≥ 22.12.
 
-- Install: `npm install @descix/frqtl-node@next`
+- Install: `npm install @descix/frqtl-node`
 - `import { bootNode, Wall } from '@descix/frqtl-node'` (require() works too); `await bootNode()` → the engine handle.
 - `./eyes`: `openHostedEyes({ sceneRecord, sceneSource: { kind: 'project', files, entry }, pageUrl })`.
 - `./project`: `linkProject` links a scene file against this package's own copy.
+- `./host-view`: `declareHostView`, `HOST_VIEW_OUTCOMES`, `CONTRACT_VIOLATIONS`, `HOST_SDK_SCRIPT` — the same declarer as @descix/frqtl-web/host-view, pure, for a node test of a call site.
 - `./register`: `node --import @descix/frqtl-node/register scene.mjs` resolves a scene's `@descix/frqtl-web/...` imports to this package.
-- Full agent guide: https://cdn.jsdelivr.net/npm/@descix/frqtl-node@0.6.0-p1.1/CLAUDE.md
+- Full agent guide: https://cdn.jsdelivr.net/npm/@descix/frqtl-node@0.6.0/CLAUDE.md
 - Acceptance is visual; no CLI ships. No account, credits or tokens are needed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@descix/frqtl-node",
-  "version": "0.6.0-p1.1",
+  "version": "0.6.0",
   "description": "FRQTL for node \u2014 the discrete fractal physics engine (compiled Rust \u2192 WASM), its parts as ES modules, the node engine door (bootNode) and the hosted eyes.",
   "type": "module",
   "engines": {
@@ -13,6 +13,7 @@
     "./parts/*": "./dist/frqtl/parts/*",
     "./project": "./dist/shim/project/index.js",
     "./registry": "./dist/shim/registry/index.js",
+    "./host-view": "./dist/shim/host/index.js",
     "./register": "./dist/shim/project/register-node.mjs",
     "./shim/controls/registry.js": "./dist/shim/controls/registry.js",
     "./shim/render/sun-look.js": "./dist/shim/render/sun-look.js",
@@ -21,6 +22,23 @@
     "./objects/setup/_collisionMatrixLanes.js": "./dist/frqtl/objects/setup/_collisionMatrixLanes.js",
     "./compat/engine.js": "./dist/frqtl/compat/engine.js",
     "./kinds": "./dist/frqtl/objects/kinds-entry.js",
+    "./objects/objects/tagger.js": "./dist/frqtl/objects/objects/tagger.js",
+    "./objects/schema/index.js": "./dist/frqtl/objects/schema/index.js",
+    "./shim/render/heat-colormap.js": "./dist/shim/render/heat-colormap.js",
+    "./objects/schema/valueNormalizer.js": "./dist/frqtl/objects/schema/valueNormalizer.js",
+    "./objects/objects/Box.js": "./dist/frqtl/objects/objects/Box.js",
+    "./objects/objects/QuantumEmitter.js": "./dist/frqtl/objects/objects/QuantumEmitter.js",
+    "./shim/expr/ast-schema.js": "./dist/shim/expr/ast-schema.js",
+    "./objects/objects/actionCompiler.js": "./dist/frqtl/objects/objects/actionCompiler.js",
+    "./objects/v1-replacements.js": "./dist/frqtl/objects/v1-replacements.js",
+    "./objects/objects/slitLinerScatter.js": "./dist/frqtl/objects/objects/slitLinerScatter.js",
+    "./objects/setup/setupSphereEmitter3D.js": "./dist/frqtl/objects/setup/setupSphereEmitter3D.js",
+    "./objects/objects/directedRedirectProgram.js": "./dist/frqtl/objects/objects/directedRedirectProgram.js",
+    "./compat/renderer/lo-drawn-center.js": "./dist/frqtl/compat/renderer/lo-drawn-center.js",
+    "./objects/setup/setupTunnelPointExit.js": "./dist/frqtl/objects/setup/setupTunnelPointExit.js",
+    "./objects/constants/WallBehaviors.js": "./dist/frqtl/objects/constants/WallBehaviors.js",
+    "./objects/objects/absorbRadiation.js": "./dist/frqtl/objects/objects/absorbRadiation.js",
+    "./objects/geometry/SlabFace.js": "./dist/frqtl/objects/geometry/SlabFace.js",
     "./dist-manifest.json": "./dist/dist-manifest.json",
     "./package.json": "./package.json"
   },

package/dist/shim/bundle/frqnb.js

@@ -1,112 +0,0 @@
-/* Copyright 2023-2026 by Essam Abadir */
-
-/**
- * lib/shim/bundle/frqnb.js — the `.frqnb` teaching/gallery projection of a
- * recipe bundle.
- *
- * Builds a notebook OBJECT (never hand-emitted `<cell>` markup) and serializes
- * it THROUGH `lib/shim/notebook/format.js` `serialize` — the ONE notebook
- * serializer (no second serializer, no CELL_ATTRS mirror). The projection is:
- *
- *   1. markdown prose cell — title + teaching blurb.
- *   2. module cell (name './experiment.js') — carries the recipe source verbatim.
- *   3. canvas cell — wired to '<module>' (a recipe is the module's default export), carrying the render
- *      intent (stage/seed/render3d/cameraPreset/renderOptions) ferried from the
- *      normalized renderState bag.
- *
- * Because it serializes through format.js, ANY new CELL_ATTR added there flows
- * through this projection automatically — the conformance gate asserts it.
- *
- * The canvas cell carries `shape="recipe"` (the CELL_ATTRS discriminator owned by format.js):
- * the module's default export is a RecipeContext recipe (its co-init call + `exp.addObject`), and
- * the shim's setup-builder synthesizes `frqtl.RecipeContext` + `exp.build(buildExperiment)` for it.
- *
- * Layer 2 (physics): none — pure notebook projection.
- */
-
-'use strict';
-
-import { serialize } from '../notebook/format.js';
-
-var MODULE_NAME = './experiment.js';
-var CANVAS_ID   = 'c-recipe';
-
-/**
- * Fold a normalized renderState `render` array ([{key,value}]) into a plain
- * `{key: value}` bag for the canvas cell's `renderOptions` (CELL_ATTRS 'opts' kind).
- * @param {{key:string,value:*}[]} render
- * @returns {object}
- */
-function _renderOptionsBag(render) {
-    var bag = {};
-    if (Array.isArray(render)) {
-        for (var i = 0; i < render.length; i++) {
-            var row = render[i];
-            if (row && typeof row.key === 'string' && row.key.length > 0) {
-                bag[row.key] = row.value;
-            }
-        }
-    }
-    return bag;
-}
-
-/**
- * Build the `.frqnb` notebook string for a recipe bundle.
- *
- * @param {object} args
- * @param {string} args.name          — human-readable project name (notebook title + markdown heading).
- * @param {string} args.source        — the `experiment.js` recipe source (module cell body).
- * @param {object} [args.renderState] — a NORMALIZED renderState bag (from
- *   `lib/shim/render-state` normalizeSavedRenderState). Render intent is ferried
- *   onto the canvas cell; absent → the canvas carries stage/seed defaults only.
- * @param {string} [args.stage='600x400'] — canvas stage '<W>x<H>'.
- * @param {string} [args.prose]       — optional teaching blurb appended under the heading.
- * @returns {string} the serialized `.frqnb` notebook.
- */
-export function buildFrqnb(args) {
-    args = args || {};
-    if (typeof args.source !== 'string' || args.source.length === 0) {
-        throw new Error('[bundle/frqnb] buildFrqnb: args.source (experiment.js) is required.');
-    }
-    var name = (typeof args.name === 'string' && args.name.length > 0) ? args.name : 'FRQTL Recipe';
-    var rs = args.renderState || {};
-    var stage = (typeof args.stage === 'string' && args.stage.length > 0) ? args.stage : '600x400';
-    var seed = (rs.seed != null && rs.seed !== '') ? String(rs.seed) : '42';
-
-    var markdownBody = '# ' + name + '\n\n' +
-        (typeof args.prose === 'string' && args.prose.length > 0
-            ? args.prose
-            : 'A FRQTL recipe. The module cell below is the `experiment.js` source of truth; ' +
-              'the canvas runs it live.');
-
-    var canvasCell = {
-        type: 'canvas',
-        id: CANVAS_ID,
-        setup: MODULE_NAME,
-        // The module's DEFAULT export is a `buildExperiment(exp)` RECIPE (RecipeContext
-        // form), NOT a `(frqtl,universe,options)` setup factory — declare it so the
-        // shim synthesizes the RecipeContext path (a recipe canvas names no export).
-        shape: 'recipe',
-        stage: stage,
-        seed: seed
-    };
-    // Ferry render intent from the normalized renderState bag onto the canvas cell.
-    if (rs.renderer === 'three') { canvasCell.render3d = true; }   // three IS the 3D display
-    if (rs.camera && typeof rs.camera.preset === 'string' && rs.camera.preset.length > 0) {
-        canvasCell.cameraPreset = rs.camera.preset;
-    }
-    var renderOptions = _renderOptionsBag(rs.render);
-    if (Object.keys(renderOptions).length > 0) { canvasCell.renderOptions = renderOptions; }
-
-    var notebook = {
-        version: '1',
-        title: name,
-        cells: [
-            { type: 'markdown', body: markdownBody },
-            { type: 'module', name: MODULE_NAME, body: args.source },
-            canvasCell
-        ]
-    };
-
-    return serialize(notebook);
-}

package/dist/shim/bundle/manifest.js

@@ -1,95 +0,0 @@
-/* Copyright 2023-2026 by Essam Abadir */
-
-/**
- * lib/shim/bundle/manifest.js — the bundle manifest as an ENVELOPE FERRY
- * (E1).
- *
- * ── The rule (E1): manifest = the Module envelope minus `source` ─────────────
- *
- * The bundle is a projection of the `lib/shim/storage/modules.js` Module
- * envelope. `experiment.js` = `module.source`. The manifest carries EVERYTHING
- * ELSE from the envelope, ferried VERBATIM (`{...envelope}` minus `source`) plus
- * a small set of bundle-only fields. Critically this module NEVER re-enumerates
- * the envelope's field list (`{name: mod.name, renderState: mod.renderState, …}`)
- * — that would be a schema mirror of modules.js. It spreads the whole envelope
- * and deletes the ONE key (`source`) the sibling `experiment.js` file owns. Any
- * field modules.js adds in future rides through automatically; `renderState`
- * rides through as an ordinary envelope field, opaque (never parsed here).
- *
- * ── Bundle-only fields ───────────────────────────────────────────────────────
- *
- *   sdkVersion : string  — the `@descix/frqtl-web@<pin>` the index.html imports.
- *                          A VALUE passed IN by the caller (the feature side
- *                          DERIVES it from the built SDK's package.json at export
- *                          time — truth-in-labeling; NEVER a literal in bundle
- *                          code). REQUIRED — FAIL-LOUD when absent.
- *   preview    : string|null — the preview image filename ref (e.g. 'preview.png'),
- *                          or null when no preview was captured.
- *   descix     : {}      — reserved inert publish block (DeSciX now-vs-later).
- *
- * Layer 2 (physics): none — pure metadata projection.
- */
-
-'use strict';
-
-/** The envelope key the sibling `experiment.js` file owns (never in the manifest). */
-export var SOURCE_KEY = 'source';
-
-/** Bundle-only manifest keys (NOT envelope fields — stripped on import). */
-export var BUNDLE_ONLY_KEYS = ['sdkVersion', 'preview', 'descix'];
-
-/**
- * Build the manifest object from a Module envelope + bundle-only inputs.
- *
- * @param {object} envelope   — a `lib/shim/storage/modules.js` Module envelope
- *   (MUST carry `source`; every other field is ferried verbatim).
- * @param {object} opts
- * @param {string} opts.sdkVersion — REQUIRED; the CDN pin (e.g. '0.6.0-p1.1').
- * @param {string|null} [opts.preview] — preview filename ref, or null/omitted.
- * @returns {object} the manifest (JSON-serializable).
- */
-export function buildManifest(envelope, opts) {
-    if (!envelope || typeof envelope !== 'object') {
-        throw new Error('[bundle/manifest] buildManifest(envelope): envelope must be an object.');
-    }
-    opts = opts || {};
-    if (typeof opts.sdkVersion !== 'string' || opts.sdkVersion.length === 0) {
-        throw new Error('[bundle/manifest] buildManifest: opts.sdkVersion is REQUIRED (a derived value, ' +
-            'never a literal) — the index.html CDN pin depends on it.');
-    }
-
-    // Ferry the WHOLE envelope minus `source` (no per-field re-enumeration).
-    var manifest = Object.assign({}, envelope);
-    delete manifest[SOURCE_KEY];
-
-    // Bundle-only fields.
-    manifest.sdkVersion = opts.sdkVersion;
-    manifest.preview = (opts.preview != null) ? opts.preview : null;
-    manifest.descix = {};   // reserved inert publish block
-
-    return manifest;
-}
-
-/**
- * Recover the Module envelope from a manifest + the `experiment.js` source.
- * Inverse of `buildManifest`: strips the bundle-only fields and re-attaches
- * `source`. The result is a full Module envelope (validatable by modules.js).
- *
- * @param {object} manifest — the parsed manifest.json object.
- * @param {string} source   — the `experiment.js` recipe source.
- * @returns {object} the reconstructed Module envelope.
- */
-export function manifestToEnvelope(manifest, source) {
-    if (!manifest || typeof manifest !== 'object') {
-        throw new Error('[bundle/manifest] manifestToEnvelope(manifest): manifest must be an object.');
-    }
-    if (typeof source !== 'string') {
-        throw new Error('[bundle/manifest] manifestToEnvelope: source (experiment.js) must be a string.');
-    }
-    var envelope = Object.assign({}, manifest);
-    for (var i = 0; i < BUNDLE_ONLY_KEYS.length; i++) {
-        delete envelope[BUNDLE_ONLY_KEYS[i]];
-    }
-    envelope[SOURCE_KEY] = source;
-    return envelope;
-}

package/dist/shim/registry/experiments.js

@@ -1,215 +0,0 @@
-/* Copyright 2023-2026 by Essam Abadir */
-
-/**
- * EXPERIMENTS — canonical experiment registry.
- *
- * Single ESM named export. Replaces the dual window.EXPERIMENTS + CommonJS export.
- * Consumed by lib/features/ide via import; SimPane reads experiments from the prop.
- *
- * id      : the directory name under frqtl/experiments/{id}/index.html
- * title   : human-readable label
- * cat     : category label
- * jsOnly  : true if the experiment requires JS-engine-only APIs
- *
- * Ordering (G1):
- *   Experiments listed in the exhibit manifest appear FIRST, in manifest order.
- *   Remaining experiments follow in their original declaration order.
- *   This ordering is consumed by SimPane's dropdown via the existing prop path
- *   (zero SimPane changes required).
- *
- * The manifest import is done lazily via a factory to avoid circular dependency
- * (exhibits.js imports EXPERIMENTS from here; we cannot import exhibits.js at
- * the top level of this file). The ordered list is computed once on first access.
- */
-
-/**
- * EXPERIMENT_TIERS — the tier vocabulary and what each tier means for PUBLIC
- * SURFACING. This table is the contract; consumers never hardcode a tier string.
- *
- *   - A row with NO `tier` is public (absence = public; there is deliberately no
- *     `tier:'public'` literal to maintain on every row).
- *   - A row whose tier resolves `public:false` is dropped from the public
- *     experiment choosers by `isPublicExperiment()` / `publicExperiments()`.
- *   - An UNKNOWN tier value FAILS LOUD (`isPublicExperiment` throws) — a typo'd
- *     tier must never silently publish a lab.
- *   - Tier gates the CURATED public chooser (STUDIO Templates). The GYM lists
- *     `internalExperiments()` instead — see that function's doc.
- *
- * Visibility only: a non-public tier NEVER affects loadability, deep-linking,
- * ordering, `is3D`, or the label lookup. Those all read the full EXPERIMENTS list
- * / `experimentById()`. `sdk/frqtl-web/build.js` ships `publicExperiments()` +
- * the named infra ids: a dev-tier page is absent from the npm/CDN package, but
- * present in the GYM (both the dev IDE and the shipped static deploy).
- *
- * ── The public set is the NEW-SUGAR content ONLY ─────────────────────────────
- * EVERY row below is `tier:'dev'`: none of these pages has been rebuilt on the
- * current sugar objects (SphereEmitter / v2 `Wall` / `Tunnel` / LiveChart /
- * GraphingDetectorWall), so none is public and none ships. The PUBLIC gallery
- * content is the WALK-THROUGH rung registry (`./walkthrough.js`), which is built
- * entirely on those objects; `sdk/frqtl-web/src/index.html` is its dist surface.
- * An unmigrated page FAILING LOUD in a dist context is the DESIRED signal — it is
- * the list of what remains to migrate. A row returns to the public set by being
- * REBUILT on the new objects and having its `tier` dropped — never by exception.
- *
- * @type {Readonly<Record<string, Readonly<{id:string, public:boolean, label:string}>>>}
- */
-export const EXPERIMENT_TIERS = Object.freeze({
-    dev: Object.freeze({
-        id:     'dev',
-        public: false,
-        label:  'Developer isolation lab / demo',
-    }),
-});
-
-/** @type {Array<{id:string, title:string, cat:string, jsOnly?:boolean, wasmOnly?:boolean, is3D?:boolean, tier?:string}>}
- *  jsOnly  : requires JS-engine-only APIs (no WASM build) — filtered out of Compare.
- *  tier    : a key of EXPERIMENT_TIERS (above). `tier:'dev'` marks a DEVELOPER-tier
- *            isolation lab / demo: fully registered and BOOTABLE by id (direct
- *            experiment-page URL + STUDIO deep link — the dev surface), HIDDEN from
- *            the PUBLIC experiment chooser (STUDIO Templates). It stays LISTED in
- *            the GYM (reads `internalExperiments()`), which is what driving these
- *            labs is for. Omit `tier` for a public experiment.
- *  wasmOnly: 3D experiment; the JS reference is a frozen 2D fixture, so Compare runs
- *            WASM-only (JS-reference pane disabled). See CompareView filter.
- *  is3D    : the ONE mount-time 3D-render authority (E-W0a). TRUE iff
- *            the experiment page unconditionally boots a 3D display — its runner is
- *            `new FrqtlApp({ is3D: true, … })` on the three display — the ground-truth
- *            signal, NOT wasmOnly (orthogonal: collision-matrix is wasmOnly+2D). STUDIO
- *            reads THIS field pre-boot to light up the camera strip + MOVE/LOOK drive for a
- *            template-loaded 3D experiment. A gate test (experiment-is3d-agreement.test.mjs)
- *            asserts THIS field ↔ the page's runner `is3D: true` — a hand-typed drift is a
- *            CI failure (mirror kill). A page that switches 3D only via a `?renderer=three`
- *            reinit toggle (single-source-interference) is 2D-DEFAULT → is3D omitted/false. */
-const _EXPERIMENTS_BASE = [
-    { id: 'g1-lo-race',        title: 'G1: LO races a quantum',     cat: 'Engine Tests', wasmOnly: true, is3D: true, tier: 'dev' },
-    { id: 'g2-lo-sweep',       title: 'G2: moving LO sweeps a field', cat: 'Engine Tests', wasmOnly: true, tier: 'dev' },
-    { id: 'g3-lo-collide',     title: 'G3: Collision Lab (box-of-balls)', cat: 'Engine Tests', wasmOnly: true, tier: 'dev' },
-    { id: 'collision-matrix',    title: 'Collision Matrix (density sweep)',    cat: 'Engine Tests', wasmOnly: true, tier: 'dev' },
-    { id: 'tunnel-lab',          title: 'Tunnel Lab (DirectedTunnel isolation)', cat: 'Engine Tests', wasmOnly: true, is3D: true, tier: 'dev' },
-    { id: 'lightsource-lab',     title: 'LightSource Lab (LightSource isolation)', cat: 'Engine Tests', wasmOnly: true, is3D: true, tier: 'dev' },
-    { id: 'mesh-demo',           title: 'render.mesh demo (external glTF)',    cat: 'Render Effects', wasmOnly: true, is3D: true, tier: 'dev' },
-    { id: 'cone-emitter-3d',   title: 'Cone Emitter 3D (laser ↔ flashlight)', cat: 'Wave Mechanics', wasmOnly: true, is3D: true, tier: 'dev' },
-    { id: 'sphere-emitter-3d', title: 'Sphere Emitter 3D (sun / laser / drum)', cat: 'Wave Mechanics', wasmOnly: true, is3D: true, tier: 'dev' },
-    { id: 'single-source-interference', title: 'Single-Source Self-Interference (omni, 2D)', cat: 'Wave Mechanics', wasmOnly: true, tier: 'dev' },
-    { id: 'tunnel-point-exit',   title: 'Tunnel Point-Exit (collapsed mouth, 2D)', cat: 'Wave Mechanics', wasmOnly: true, tier: 'dev' },
-    { id: 'fx-glow',           title: 'FX: Glow',                   cat: 'Render Effects', wasmOnly: true, is3D: true, tier: 'dev' },
-    { id: 'fx-godrays',        title: 'FX: God-rays',               cat: 'Render Effects', wasmOnly: true, is3D: true, tier: 'dev' },
-    { id: 'fx-smoke',          title: 'FX: Smoke',                  cat: 'Render Effects', wasmOnly: true, is3D: true, tier: 'dev' },
-    { id: 'blackbody-substrate',    title: 'Blackbody Substrate (L1+L2+L3+L4)', cat: 'Thermodynamics', tier: 'dev' },
-    { id: 'circuit-basic',     title: 'Circuit: Series Resistor',   cat: 'Computing',          tier: 'dev' },
-    { id: 'trace-circuit',     title: 'Trace: the wire part',       cat: 'Computing', wasmOnly: true, tier: 'dev' },
-    { id: 'oscillator',        title: 'Quantum Oscillator',         cat: 'Structure & Forces', tier: 'dev' }
-];
-
-/**
- * The flat experiment list, in declaration order. (The showcase roster — the front-page tiles — is
- * scene files, lib/shim/registry/exhibits.js; no experiment page is a tile.)
- *
- * @type {Array<{id:string, title:string, cat:string, jsOnly?:boolean, wasmOnly?:boolean}>}
- */
-export const EXPERIMENTS = _EXPERIMENTS_BASE;
-
-/**
- * isPublicExperiment(entry) — THE tier-visibility predicate. Resolves an entry's
- * `tier` against the EXPERIMENT_TIERS contract: no tier ⇒ public; a known tier ⇒
- * that tier's `public` flag; an unknown tier ⇒ THROWS (fail loud — a typo must
- * never silently publish a dev lab).
- *
- * This is the ONE place the tier→visibility rule lives. Any surface that lists
- * experiments to the public FERRIES this predicate (or `publicExperiments()`
- * below) — re-writing `e.tier !== 'dev'` in a consumer is the schema-mirror
- * anti-pattern and will drift the moment a second non-public tier is added.
- *
- * @param {{id?:string, tier?:string}} entry — an EXPERIMENTS row.
- * @returns {boolean} true if the entry belongs in a public experiment chooser.
- * @throws {Error} if `entry.tier` is not a key of EXPERIMENT_TIERS.
- */
-export function isPublicExperiment(entry) {
-    if (!entry || !entry.tier) { return true; }
-    var tier = EXPERIMENT_TIERS[entry.tier];
-    if (!tier) {
-        throw new Error(
-            '[experiments] unknown tier "' + entry.tier + '" on experiment "' +
-            (entry.id || '?') + '". Known tiers: ' +
-            Object.keys(EXPERIMENT_TIERS).join(', ') + ' (omit `tier` for public).'
-        );
-    }
-    return tier.public === true;
-}
-
-/**
- * publicExperiments() — the EXPERIMENTS a PUBLIC chooser should list, filtered by
- * `isPublicExperiment`. The single filtered view both public experiment-chooser
- * surfaces (STUDIO Templates via ExperimentDropdown, the GYM/Compare select)
- * consume, so the dev-tier hide is declared ONCE. Non-public experiments remain
- * registered and bootable by id (direct experiment-page URL, STUDIO deep link) —
- * they are only hidden from these curated lists.
- *
- * @returns {Array<{id:string, title:string, cat:string}>}
- */
-export function publicExperiments() {
-    return EXPERIMENTS.filter(isPublicExperiment);
-}
-
-/**
- * internalExperiments() — the roster an INTERNAL-ONLY experiment chooser lists.
- *
- * ── Layer 1: API contract ────────────────────────────────────────────────────
- * Every registered row, tier-independent, in registry order. This is the peer of
- * `publicExperiments()`, and the split is by SURFACE AUDIENCE, not by taste:
- *
- *   - `publicExperiments()` — for a chooser a STRANGER can reach (STUDIO
- *     Templates). Tier gates it, because tier means "has this page been rebuilt
- *     on the current sugar and is it fit to publish".
- *   - `internalExperiments()` — for the GYM (`preset='compare'`), which drives
- *     dev-tier isolation labs directly by id and so needs the full roster
- *     regardless of tier.
- *
- * WHY THIS EXISTS (2026-07-28): with the whole legacy roster moved to `tier:'dev'`,
- * `publicExperiments()` is legitimately EMPTY. A surface that lists it therefore
- * offers nothing — which is correct for a public chooser (the public content set
- * is the WALK-THROUGH registry) and wrong for the maintainer's driving
- * instrument. Passing the audience question through the tier table was the
- * conflation; naming the two rosters separately is the fix.
- *
- * A consumer picks the roster that matches ITS audience and derives everything
- * else (its default selection included) from that ONE list — never a second
- * hardcoded id.
- *
- * @returns {Array<{id:string, title:string, cat:string}>} registry rows BY REFERENCE.
- */
-export function internalExperiments() {
-    return EXPERIMENTS.slice();
-}
-
-/**
- * experimentById(id) — THE id→entry resolution for the registry. Reads the FULL
- * EXPERIMENTS list, tier-independent: a dev-tier experiment resolves exactly like
- * a public one, which is what keeps it reachable by direct URL / deep link while
- * hidden from the public choosers.
- *
- * @param {string} id — an experiment id (directory name under experiments/).
- * @returns {{id:string, title:string, cat:string}|null} the entry, or null if unknown.
- */
-export function experimentById(id) {
-    for (var i = 0; i < EXPERIMENTS.length; i++) {
-        if (EXPERIMENTS[i].id === id) { return EXPERIMENTS[i]; }
-    }
-    return null;
-}
-
-/**
- * experimentIs3D(id) — the ONE mount-time 3D-render predicate for a gallery
- * experiment (E-W0a). Reads the declarative `is3D` field off the registry entry
- * (the single authority; see the `is3D` doc on `_EXPERIMENTS_BASE`). Returns
- * false for an unknown id or a 2D-default experiment. STUDIO consults this pre-boot
- * for a template-loaded experiment — the axis the walkthrough path derives from
- * `renderState.renderer`. Never sniffs a page or a runner: 3D-ness is DATA here.
- *
- * @param {string} id — an experiment id (directory name under experiments/).
- * @returns {boolean}
- */
-export function experimentIs3D(id) {
-    var entry = experimentById(id);
-    return !!entry && entry.is3D === true;
-}