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

package/dist/frqtl/parts/SlitLightSource.js

@@ -82,7 +82,7 @@ import { V1_REPLACEMENTS } from '../objects/v1-replacements.js';
         var zDepth = (depth !== null) ? depth : null;
 
         this.universe = universe;
-        this._schemaKind = 'SlitLightSource';
+        this._schemaKind = this.constructor.name;
 
         // Light source diameter: hardcoded to 16 matching devsdk's pointSOURCESIZE.
         // (wavelength * 0.25 * 2 = 32 would double the emission radius and velocity)

package/dist/frqtl/parts/SlitScreen.js

@@ -137,7 +137,7 @@ import { ObjectSchema } from '../objects/schema/index.js';
      */
     function SlitScreen(universe, wallLeft, wallWidth, canvasHeight, wavelength, absorbAtSlitWall, detectAtSlits, slitHeight, gapHeight, depth, holeDepth, linerScatter) {
         this.universe = universe;
-        this._schemaKind = 'SlitScreen';
+        this._schemaKind = this.constructor.name;
         this.wavelength = wavelength;
         this.depth = (depth !== undefined && depth !== null) ? depth : null;
         // 'current' (default/omitted) = today's exact liner behavior, byte-identical.

package/dist/frqtl/parts/SphereEmitter.js

@@ -157,7 +157,7 @@ import { CollisionTypes } from './CollisionTypes.js';
      * @param {Object} [opts]
      */
     function SphereEmitter(position, opts) {
-        this._schemaKind = 'SphereEmitter';
+        this._schemaKind = this.constructor.name;
         // First-arg overload: an array is a position; a plain object is opts
         // (position defaults to canvas center → byte-identical factory default).
         if (Array.isArray(position)) {
@@ -180,7 +180,7 @@ import { CollisionTypes } from './CollisionTypes.js';
         // self-throttle target — the emitter deactivates when the live population
         // measured by the counting Wall NAMED by `gateCounter` reaches the cap, and
         // reactivates below it. Compiled at CONSTRUCTION into a host tick-fn (see
-        // _installEmissionGate in addTo) so the gate is codegen-round-trippable and
+        // _installEmissionGate in addTo) so the gate is captured by the parts writer and
         // Restart-safe (the Restart-safe host-tick-fn rule — the gate is a
         // construction side effect of captured descriptor fields, exactly like the
         // ABSORB radiator, NEVER free recipe JS). Validation is throw-or-apply:
@@ -275,7 +275,7 @@ import { CollisionTypes } from './CollisionTypes.js';
      * `fn(universe)` seam — the SAME seam as the emit tick-fn, the blackbody
      * thermostat, and the ABSORB radiator). Each tick it:
      *   1. LAZILY resolves the counting Wall by NAME on the FIRST tick (handles are
-     *      registration-fresh and never survive codegen — the name is the reference;
+     *      registration-fresh and never survive a rebuild — the name is the reference;
      *      lazy resolution makes emitter/counter construction order irrelevant).
      *      Unresolved after the first tick → THROW (never a silent uncapped run).
      *   2. Reads the live population through `counter.getLiveCount(universe._lastTickData)`
@@ -447,7 +447,7 @@ import { CollisionTypes } from './CollisionTypes.js';
     // captureProps(sphereObj, SphereEmitterDescriptor) reads `sphereObj[field.name]`
     // DIRECTLY for every descriptor field (a getter satisfies it). These expose the
     // LIVE resolved value (from the factory's control) so a dragged/edited emitter
-    // Saves at its current state — the codegen round-trip authority. Boot-level fields
+    // Saves at its current state — what the parts writer captures. Boot-level fields
     // (fundamentalWaveLength) that the control doesn't surface read from the
     // construction opts (they cannot change live). `rect` is a WRITE-ONLY reposition
     // adapter: its getter is deliberately `undefined` so captureProps SKIPS it —
@@ -463,7 +463,7 @@ import { CollisionTypes } from './CollisionTypes.js';
         // the ObjectFactory marker diameter + makeControlsForObject's rect-seed. captureProps no
         // longer trips on this: the descriptor's rect field is `writeOnly:true`, so captureProps
         // SKIPS it by the descriptor flag (not by the getter being undefined) — `center` stays the
-        // single captured position authority (codegen round-trip unchanged). The write path
+        // single captured position authority. The write path
         // (rect → setCenter) is still the applyProp adapter (updateObjectProperty).
         get: function () {
             var c = (this._control && typeof this._control.getCenter === 'function')
@@ -487,7 +487,7 @@ import { CollisionTypes } from './CollisionTypes.js';
     Object.defineProperty(SphereEmitter.prototype, 'is2D',           _liveGetter(function (c) { return c.getIs2D(); }));
     Object.defineProperty(SphereEmitter.prototype, 'orientationDeg', _liveGetter(function (c) { return c.getOrientation(); }));
     Object.defineProperty(SphereEmitter.prototype, 'emissionBox',    _liveGetter(function (c) { return c.getEmissionBox(); }));
-    // Declared emission-gate fields (captured for codegen round-trip; undefined
+    // Declared emission-gate fields (captured by the parts writer; undefined
     // when uncapped → captureProps SKIPS them → byte-identical legacy scenes).
     Object.defineProperty(SphereEmitter.prototype, 'emissionCap', {
         get: function () { return this._emissionCap; }
@@ -585,7 +585,7 @@ import { CollisionTypes } from './CollisionTypes.js';
      * builder composes a LargeObject-visual marker + the factory's host emit
      * tick-fn (SU1 — the visual LO is NONE-collision, non-leaf, zero physics).
      *
-     * This descriptor is the SINGLE field authority: captureProps (codegen),
+     * This descriptor is the SINGLE field authority: captureProps (the parts writer),
      * makeControlsForObject (the Inspector), and FrqtlApp.updateObjectProperty
      * (the live-edit write path) ALL drive off it — no hand-list anywhere.
      *
@@ -600,7 +600,7 @@ import { CollisionTypes } from './CollisionTypes.js';
      *                round-trip; the Inspector just renders it read-only.
      *
      * FIELD SET is COMPLETE w.r.t. every scene-affecting setupSphereEmitter3D opt
-     * (a missing opt = lossy codegen). `emissionBoxSide` is subsumed by the
+     * (a missing opt = a lossy capture). `emissionBoxSide` is subsumed by the
      * captured derived `emissionBox`. There is no init flag: the SKETCH inits the
      * world once (setupSphereEmitter3D.initWorld / the co-init call), so a second emitter on
      * one universe (6A/6B/6C) is simply a second object.
@@ -635,7 +635,7 @@ import { CollisionTypes } from './CollisionTypes.js';
                 live: true,
                 // PR-1 item iii: the facade's `.rect` getter now returns a REAL rect DERIVED from
                 // the live center (so computeEntityBboxForDesign reads fresh — no stale bbox). To
-                // keep `center` the SINGLE captured position authority (codegen round-trip), this
+                // keep `center` the SINGLE captured position authority, this
                 // field is `writeOnly:true` → captureProps SKIPS it BY THE FLAG (not by the getter
                 // being undefined). The WRITE path is unchanged: a rect write maps rect-CENTER →
                 // the emission center (control.setCenter, via applyProp).
@@ -653,7 +653,7 @@ import { CollisionTypes } from './CollisionTypes.js';
                 engineVisible: false,
                 live: false,
                 description: 'Emission SOURCE POSITION in absolute canvas px as [x,y,z] (the captured ' +
-                    'position authority — codegen round-trips this, not rect). Edited live via the rect ' +
+                    'position authority — the parts writer writes this, not rect). Edited live via the rect ' +
                     'adapter / the visual marker drag; shown read-only here.'
             },
             {
@@ -698,7 +698,7 @@ import { CollisionTypes } from './CollisionTypes.js';
                 //    pattern; circulation-emission-gate-contract §2 field shapes).
                 //    Sensor = a placeable counting Wall (name in gateCounter); regulation =
                 //    emitter-side sugar compiled at CONSTRUCTION into a host tick-fn (the
-                //    Restart-safe host-tick-fn rule — codegen captures these two fields and
+                //    Restart-safe host-tick-fn rule — the parts writer captures these two fields and
                 //    the reconstructed emitter's constructor rebuilds the gate).
                 name: 'emissionCap',
                 type: 'number',
@@ -811,7 +811,7 @@ import { CollisionTypes } from './CollisionTypes.js';
                 constraint: { min: 0, integer: true },
                 engineVisible: false,
                 live: true,
-                // Field NAME stays `leafDimension` (codegen/capture key; a rename = round-trip
+                // Field NAME stays `leafDimension` (the capture key; a rename = round-trip
                 // break + a second name = schema mirror — Q-A2). The Inspector shows
                 // the display LABEL "Emit Dimension"; the write routes through applyProp →
                 // control.setLeafDimension (host-side addDimension + closure var flip; the NEXT

package/dist/frqtl/parts/Trace.js

@@ -245,7 +245,7 @@ import { Wall as _Wall } from './Wall.js';
     function Trace(universe, opts) {
         opts = opts || {};
         this.universe = universe;
-        this._schemaKind = 'Trace';
+        this._schemaKind = this.constructor.name;
 
         var path = opts.path;
         if (!Array.isArray(path) || path.length < 2) {

package/dist/frqtl/parts/Tunnel.js

@@ -239,7 +239,7 @@ import { setupTunnelPointExit } from '../objects/setup/setupTunnelPointExit.js';
     function Tunnel(universe, opts) {
         opts = opts || {};
         this.universe = universe;
-        this._schemaKind = 'Tunnel';
+        this._schemaKind = this.constructor.name;
 
         var left = opts.left, top = opts.top;
         var length = opts.length, bore = opts.bore;
@@ -307,7 +307,7 @@ import { setupTunnelPointExit } from '../objects/setup/setupTunnelPointExit.js';
                 'contention rather than the point source. (FAIL-LOUD.)');
         }
 
-        // Stash the authored construction values (the codegen round-trip authority —
+        // Stash the authored construction values (what the parts writer captures —
         // the descriptor fields read these back verbatim, Box precedent).
         this.left = left; this.top = top; this.length = length; this.bore = bore;
         this.wallThickness = wallThickness; this.axis = axis; this.color = color;
@@ -316,7 +316,7 @@ import { setupTunnelPointExit } from '../objects/setup/setupTunnelPointExit.js';
         // knob, so the Inspector must render its selector on every tunnel, which needs a
         // defined value to read. The three directed-only tunables follow the z/depth
         // OPT-IN precedent instead — left undefined in mirror mode so captureProps skips
-        // them and a mirror tunnel's codegen gains exactly ONE key, not four.
+        // them and a mirror tunnel's captured entry gains exactly ONE key, not four.
         this.mode = mode;
         if (directed) {
             this.directedAngle = directedAngleDeg;
@@ -331,9 +331,9 @@ import { setupTunnelPointExit } from '../objects/setup/setupTunnelPointExit.js';
             this.exitPhaseReset = exitPhaseReset;
         }
         // z/depth are DECLARED descriptor fields (TunnelDescriptor) so a 3D corridor
-        // round-trips through codegen/Restart. A FLAT (2D) tunnel leaves them
-        // `undefined` — captureProps skips undefined, so a 2D codegen stays
-        // byte-identical to the pre-3D output (no `"z":0,"depth":null` noise).
+        // round-trips through the parts writer. A FLAT (2D) tunnel leaves them
+        // `undefined` — captureProps skips undefined, so a 2D capture carries
+        // no `"z":0,"depth":null` noise.
         if (hasDepth) { this.z = z; this.depth = depth; }
 
         // ── Mirror wall rects (two parallel plates a `bore` apart) ───────────
@@ -734,9 +734,9 @@ import { setupTunnelPointExit } from '../objects/setup/setupTunnelPointExit.js';
      * Subscribe this tunnel's redirect to a runner's per-tick fan-out
      * (`FrqtlApp.addTickListener` — the multi-subscriber peer of the page's single
      * `onTick` slot, so it never steals it). Called by the ObjectFactory builder, which is
-     * what makes the directed mode survive codegen → Restart: the mode is a DECLARED
-     * descriptor field on the facade, so the rebuilt object re-wires itself. A raw tick-fn
-     * hand-written in a recipe would NOT survive (Restart evals the codegen'd module).
+     * what makes the directed mode part of the declared object: the mode is a DECLARED
+     * descriptor field on the facade, so every build of it (a sketch entry, a Restart)
+     * re-wires itself.
      *
      * Idempotent, and a no-op for a mirror tunnel or a runner without the fan-out.
      * @param {Object} runner - an FrqtlApp (needs `addTickListener`).
@@ -1045,8 +1045,8 @@ import { setupTunnelPointExit } from '../objects/setup/setupTunnelPointExit.js';
             // mode:'directed' — subscribe the host redirect to the runner's per-tick fan-out.
             // Self-gating + idempotent, so this is called unconditionally (a mirror tunnel
             // no-ops). Wiring it HERE, off the DECLARED `mode` field, is what makes the
-            // directed behavior survive codegen → Restart: the rebuilt facade re-subscribes
-            // itself, where a recipe-authored tick-fn would be lost.
+            // directed behavior part of the declared object: every build of the facade
+            // re-subscribes itself.
             if (typeof tunnel.attachToRunner === 'function') { tunnel.attachToRunner(ctx.runner); }
             return tunnel;
         }

package/dist/frqtl/parts/Wall.js

@@ -178,10 +178,20 @@ import { wallBehaviorV2ValuesMap as _wallBehaviorV2ValuesMap, bounceDirectionVal
     }
 
     function _rectFromOpts(opts) {
-        // Normalize an OBJECT-bag rect ({left,top,w,h} / {left,top,z,w,h,d} — the shape a
-        // codegen round-trip captures from the live LO, restart-bug fix 2026-07-25) to the
-        // canonical ARRAY form FIRST, so the 3D checks below (_rectIs3D/_rectDepth are
-        // Array-based) see a captured 3D wall as 3D. Mirrors LargeObject's own rectToArray.
+        // ONE spelling of the z-slab: a rect that already carries z/depth (the 6-element form, or an
+        // object rect with z/d) beside the z / d / depth props would be two statements of one fact,
+        // one of them silently ignored. Refused, naming both.
+        var slabProps = ['z', 'd', 'depth'].filter(function (k) { return opts[k] !== undefined; });
+        if (slabProps.length && opts.rect && (Array.isArray(opts.rect) ? opts.rect.length === 6
+                : (opts.rect.z !== undefined || opts.rect.d !== undefined))) {
+            throw new Error('[Wall] rect is already the z/depth form ' + ValueNormalizer.rectTupleText(6) +
+                ' and the props also give ' + slabProps.join(', ') + ' — write the z-slab ONE way: the 6-element rect, ' +
+                'or a 4-element rect beside z/depth. (FAIL-LOUD.)');
+        }
+        // Normalize an OBJECT-bag rect ({left,top,w,h} / {left,top,z,w,h,d} — the shape a live LO's
+        // rect reads as) to the canonical ARRAY form FIRST, so the 3D checks below
+        // (_rectIs3D/_rectDepth are Array-based) see such a 3D wall as 3D. Mirrors LargeObject's
+        // own rectToArray.
         if (opts.rect && !Array.isArray(opts.rect) && opts.rect.left !== undefined && opts.rect.w !== undefined) {
             var ob = opts.rect;
             var arr = (ob.z !== undefined || ob.d !== undefined)
@@ -382,7 +392,7 @@ import { wallBehaviorV2ValuesMap as _wallBehaviorV2ValuesMap, bounceDirectionVal
             self._radiationTickFn = tickFn;
             // The radiator OWNS the live emissivity (including the default when none was
             // stated). Read the facade prop back off it rather than leaving it undefined —
-            // captureProps/codegen and the Inspector read `wall.emissivity`, and a facade that
+            // captureProps (the parts writer) and the Inspector read `wall.emissivity`, and a facade that
             // says nothing while the radiator says 0.5 is a second, wrong answer.
             self.emissivity = tickFn.emissivity();
             if (universe && Array.isArray(universe.experimentTickFunctions)) {
@@ -399,10 +409,10 @@ import { wallBehaviorV2ValuesMap as _wallBehaviorV2ValuesMap, bounceDirectionVal
     function Wall(universe, opts) {
         opts = opts || {};
         this.universe = universe;
-        this._schemaKind = 'Wall';
+        this._schemaKind = this.constructor.name;
 
-        // A `preset` expands to the v2 descriptor fields (construction sugar; codegen
-        // round-trips the EXPANDED fields, never the preset name).
+        // A `preset` expands to the v2 descriptor fields (construction sugar; the parts
+        // writer captures the EXPANDED fields, never the preset name).
         if (opts.preset) {
             var expanded = expandWallPreset(opts.preset);
             var merged = {}; Object.keys(opts).forEach(function (k) { if (k !== 'preset') { merged[k] = opts[k]; } });
@@ -437,7 +447,7 @@ import { wallBehaviorV2ValuesMap as _wallBehaviorV2ValuesMap, bounceDirectionVal
     // ── Descriptor-field read surface (captureProps / Inspector) ─────────────
     // captureProps(wall, WallDescriptor) reads wall[field.name] directly; these
     // getters expose the LIVE inner-LO state so a dragged/edited wall Saves at its
-    // current state (the codegen round-trip authority). `rect` is the single
+    // current state (what the parts writer captures). `rect` is the single
     // captured position authority (the LO's own Rectangle, whose toJSON pins the
     // {left,top,w,h} wire shape).
     Object.defineProperty(Wall.prototype, 'rect',        { get: function () { return this.lo ? this.lo.rect : undefined; } });
@@ -573,7 +583,7 @@ import { wallBehaviorV2ValuesMap as _wallBehaviorV2ValuesMap, bounceDirectionVal
      */
     Wall.prototype.setV2Prop = function (prop, value) {
         // EMISSIVITY — live radiating efficiency. The running radiator OWNS the value (one
-        // live copy); the facade prop is a ferried mirror for the Inspector/codegen read.
+        // live copy); the facade prop is a ferried mirror for the Inspector and capture read.
         // Validation (fullness fraction in (0,1]) belongs to the owner and throws from there.
         if (prop === 'emissivity') {
             if (this.collisionBehavior !== 'absorb' || !this._radiationTickFn) {

package/dist/frqtl/scenes/circuit-sat.js

@@ -22,6 +22,7 @@
 import { FrqtlControlOverlay, FrqtlControlsPanel, LogicGate, SphereEmitter, Trace } from '@descix/frqtl-web/parts';
 import * as ControlRegistry from '@descix/frqtl-web/shim/controls/registry.js';
 
+// Code-declared on purpose: the emitter centres and rail traces derive from the gates' port geometry and RAIL (a knob rewrites it), and a Trace has no kind — a literal block would restate derived geometry by hand.
 export const parts = {};
 
 export default function buildExperiment(exp) {

package/dist/frqtl/scenes/dse-one-emitter.js

@@ -67,9 +67,10 @@
 // 2D ONLY, deliberately. There is no `modes` strip and no `exp.is3D` guard: these
 // rungs declare one world each. A second dimensional variant would be a separate
 // recipe declaration, not a mode.
-// THE PAIR. `dse-two-emitters.js` is the SAME apparatus with NSRC = 2. The two files differ ONLY in
-// the title lines and the `var NSRC` line — lib/frqtl/scenes/test/scene-files.test.mjs
-// fails if any other line diverges, so the A/B the pair exists to make stays an A/B.
+// THE PAIR. `dse-two-emitters.js` is the SAME apparatus with TWO source entries. The two files differ ONLY in the
+// title lines, this note, and their `source*` entries of `parts` (with the world call naming the first
+// of them) — lib/frqtl/scenes/test/scene-files.test.mjs fails if anything else diverges, so the A/B the
+// pair exists to make stays an A/B.
 
 import { SphereEmitter, Wall } from '@descix/frqtl-web/parts';
 
@@ -116,7 +117,34 @@ const detW = Math.round(lamPx / 64);      // 5   — plate thickness
 // the photoelectric experiment, and it saturates.
 const detectorPreset = 'transparent-probe';
 
+const lamArg = 3.2;                       // capacity/mass -> fullness 1/3.2 = 0.3125 (yellow)
+const fwl    = 4 * (lamPx / lamArg);      // 400 -> wavelengthScale floor(400/4) = 100
+const wlScale = Math.floor(fwl / 4);      // 100
+const cy   = Math.round(H / 2);           // 200 — the source plane's midline
+// TWO-SOURCE SEPARATION. Two sources reinforce when their separation is a
+// multiple of lambda/2, and the coupling falls as (lambda/d)^2, so lambda/2 is
+// the strongest case. At this leg it also puts a band of EACH source on the
+// midline y = H/2 (source 1's lower band and source 2's upper band coincide
+// there) — the doubly-reinforced central peak, equidistant from both emitters,
+// exactly where the one-source rung has no peak at all.
+const sep  = lamPx / 2;                   // 160 -> sources at y 120 and 280
+// ── THE LIGHT SOURCE ────────────────────────────────────────────────────
+// preset 'hemisphere' = 180 degrees of FORWARD (+X) emission: the SAME
+// ball-rejected sampler as the omni source with the forward axis' range halved,
+// so nothing about the walk changes, it is simply pointed at the plate. The
+// default emission box is 0 for this preset, so the source is a single PIXEL —
+// load-bearing, because any spread at birth blurs every band by that spread.
+// NO START WALL: the backward population is empty by construction, and `wrap` is
+// false, so the canvas edge kills whatever transverse wiggle out-runs its
+// forward component. One sink, not two.
+const SRC = {
+  preset: 'hemisphere', is2D: true, chargeMode: 'random',
+  wavelength: lamArg, fundamentalDimension: 2, fundamentalWaveLength: fwl,
+  burstSize: 8, emitEveryTicks: 1
+};
+
 export const parts = {
+  source: [SphereEmitter, { ...SRC, center: [srcX, cy] }],
   // FAR-EDGE SINK. The plate below counts WITHOUT removing, so quanta fly on past
   // it; this is the experiment-boundary sink downstream of the plate. It is not
   // load-bearing (wrap is false, so the canvas edge would remove them anyway) — it
@@ -134,41 +162,11 @@ export const parts = {
 };
 
 export default function buildExperiment(exp) {
-  var NSRC = 1;
-  var lamArg = 3.2;                       // capacity/mass -> fullness 1/3.2 = 0.3125 (yellow)
-  var fwl    = 4 * (lamPx / lamArg);      // 400 -> wavelengthScale floor(400/4) = 100
-  var wlScale = Math.floor(fwl / 4);      // 100
   if (Math.abs(lamArg * wlScale - lamPx) > 1e-9) {
     throw new Error('[dse-h1] lamPx ' + lamPx + ' is not realisable as lambda_eff: the engine ' +
       'can only produce wavelengthArg x floor(fwl/4) = ' + (lamArg * wlScale) + '. (FAIL-LOUD.)');
   }
-  var cy   = Math.round(H / 2);           // 200 — the source plane's midline
-  // TWO-SOURCE SEPARATION. Two sources reinforce when their separation is a
-  // multiple of lambda/2, and the coupling falls as (lambda/d)^2, so lambda/2 is
-  // the strongest case. At this leg it also puts a band of EACH source on the
-  // midline y = H/2 (source 1's lower band and source 2's upper band coincide
-  // there) — the doubly-reinforced central peak, equidistant from both emitters,
-  // exactly where the one-source rung has no peak at all.
-  var sep  = lamPx / 2;                   // 160 -> sources at y 120 and 280
-  var srcYs = (NSRC === 2) ? [cy - sep / 2, cy + sep / 2] : [cy];
-  // ── THE LIGHT SOURCE ────────────────────────────────────────────────────
-  // preset 'hemisphere' = 180 degrees of FORWARD (+X) emission: the SAME
-  // ball-rejected sampler as the omni source with the forward axis' range halved,
-  // so nothing about the walk changes, it is simply pointed at the plate. The
-  // default emission box is 0 for this preset, so the source is a single PIXEL —
-  // load-bearing, because any spread at birth blurs every band by that spread.
-  // NO START WALL: the backward population is empty by construction, and `wrap` is
-  // false, so the canvas edge kills whatever transverse wiggle out-runs its
-  // forward component. One sink, not two.
-  var SRC = {
-    preset: 'hemisphere', is2D: true, chargeMode: 'random',
-    wavelength: lamArg, fundamentalDimension: 2, fundamentalWaveLength: fwl,
-    burstSize: 8, emitEveryTicks: 1
-  };
-  exp.createCanvas(CW, H, SphereEmitter.worldCfg(SRC));   // THE WORLD: a 2D canvas + universe — first, then parts
-  for (var si = 0; si < srcYs.length; si++) {
-    exp.addObject('SphereEmitter', Object.assign({}, SRC, { center: [srcX, Math.round(srcYs[si])] }));
-  }
+  exp.createCanvas(CW, H, SphereEmitter.worldCfg(parts.source[1]));   // THE WORLD: a 2D canvas + universe — first, then parts
   const p = exp.declare(parts);
   // ── THE INSTRUMENT — the live count-by-y histogram, REGISTERED TO THE PLATE ──
   // The panel takes the plate's OWN rect y-origin (0) and height (H), so the two

package/dist/frqtl/scenes/dse-two-emitters.js

@@ -67,9 +67,10 @@
 // 2D ONLY, deliberately. There is no `modes` strip and no `exp.is3D` guard: these
 // rungs declare one world each. A second dimensional variant would be a separate
 // recipe declaration, not a mode.
-// THE PAIR. `dse-one-emitter.js` is the SAME apparatus with NSRC = 1. The two files differ ONLY in
-// the title lines and the `var NSRC` line — lib/frqtl/scenes/test/scene-files.test.mjs
-// fails if any other line diverges, so the A/B the pair exists to make stays an A/B.
+// THE PAIR. `dse-one-emitter.js` is the SAME apparatus with ONE source entry. The two files differ ONLY in the
+// title lines, this note, and their `source*` entries of `parts` (with the world call naming the first
+// of them) — lib/frqtl/scenes/test/scene-files.test.mjs fails if anything else diverges, so the A/B the
+// pair exists to make stays an A/B.
 
 import { SphereEmitter, Wall } from '@descix/frqtl-web/parts';
 
@@ -116,7 +117,35 @@ const detW = Math.round(lamPx / 64);      // 5   — plate thickness
 // the photoelectric experiment, and it saturates.
 const detectorPreset = 'transparent-probe';
 
+const lamArg = 3.2;                       // capacity/mass -> fullness 1/3.2 = 0.3125 (yellow)
+const fwl    = 4 * (lamPx / lamArg);      // 400 -> wavelengthScale floor(400/4) = 100
+const wlScale = Math.floor(fwl / 4);      // 100
+const cy   = Math.round(H / 2);           // 200 — the source plane's midline
+// TWO-SOURCE SEPARATION. Two sources reinforce when their separation is a
+// multiple of lambda/2, and the coupling falls as (lambda/d)^2, so lambda/2 is
+// the strongest case. At this leg it also puts a band of EACH source on the
+// midline y = H/2 (source 1's lower band and source 2's upper band coincide
+// there) — the doubly-reinforced central peak, equidistant from both emitters,
+// exactly where the one-source rung has no peak at all.
+const sep  = lamPx / 2;                   // 160 -> sources at y 120 and 280
+// ── THE LIGHT SOURCE ────────────────────────────────────────────────────
+// preset 'hemisphere' = 180 degrees of FORWARD (+X) emission: the SAME
+// ball-rejected sampler as the omni source with the forward axis' range halved,
+// so nothing about the walk changes, it is simply pointed at the plate. The
+// default emission box is 0 for this preset, so the source is a single PIXEL —
+// load-bearing, because any spread at birth blurs every band by that spread.
+// NO START WALL: the backward population is empty by construction, and `wrap` is
+// false, so the canvas edge kills whatever transverse wiggle out-runs its
+// forward component. One sink, not two.
+const SRC = {
+  preset: 'hemisphere', is2D: true, chargeMode: 'random',
+  wavelength: lamArg, fundamentalDimension: 2, fundamentalWaveLength: fwl,
+  burstSize: 8, emitEveryTicks: 1
+};
+
 export const parts = {
+  source1: [SphereEmitter, { ...SRC, center: [srcX, Math.round(cy - sep / 2)] }],
+  source2: [SphereEmitter, { ...SRC, center: [srcX, Math.round(cy + sep / 2)] }],
   // FAR-EDGE SINK. The plate below counts WITHOUT removing, so quanta fly on past
   // it; this is the experiment-boundary sink downstream of the plate. It is not
   // load-bearing (wrap is false, so the canvas edge would remove them anyway) — it
@@ -134,41 +163,11 @@ export const parts = {
 };
 
 export default function buildExperiment(exp) {
-  var NSRC = 2;
-  var lamArg = 3.2;                       // capacity/mass -> fullness 1/3.2 = 0.3125 (yellow)
-  var fwl    = 4 * (lamPx / lamArg);      // 400 -> wavelengthScale floor(400/4) = 100
-  var wlScale = Math.floor(fwl / 4);      // 100
   if (Math.abs(lamArg * wlScale - lamPx) > 1e-9) {
     throw new Error('[dse-h1] lamPx ' + lamPx + ' is not realisable as lambda_eff: the engine ' +
       'can only produce wavelengthArg x floor(fwl/4) = ' + (lamArg * wlScale) + '. (FAIL-LOUD.)');
   }
-  var cy   = Math.round(H / 2);           // 200 — the source plane's midline
-  // TWO-SOURCE SEPARATION. Two sources reinforce when their separation is a
-  // multiple of lambda/2, and the coupling falls as (lambda/d)^2, so lambda/2 is
-  // the strongest case. At this leg it also puts a band of EACH source on the
-  // midline y = H/2 (source 1's lower band and source 2's upper band coincide
-  // there) — the doubly-reinforced central peak, equidistant from both emitters,
-  // exactly where the one-source rung has no peak at all.
-  var sep  = lamPx / 2;                   // 160 -> sources at y 120 and 280
-  var srcYs = (NSRC === 2) ? [cy - sep / 2, cy + sep / 2] : [cy];
-  // ── THE LIGHT SOURCE ────────────────────────────────────────────────────
-  // preset 'hemisphere' = 180 degrees of FORWARD (+X) emission: the SAME
-  // ball-rejected sampler as the omni source with the forward axis' range halved,
-  // so nothing about the walk changes, it is simply pointed at the plate. The
-  // default emission box is 0 for this preset, so the source is a single PIXEL —
-  // load-bearing, because any spread at birth blurs every band by that spread.
-  // NO START WALL: the backward population is empty by construction, and `wrap` is
-  // false, so the canvas edge kills whatever transverse wiggle out-runs its
-  // forward component. One sink, not two.
-  var SRC = {
-    preset: 'hemisphere', is2D: true, chargeMode: 'random',
-    wavelength: lamArg, fundamentalDimension: 2, fundamentalWaveLength: fwl,
-    burstSize: 8, emitEveryTicks: 1
-  };
-  exp.createCanvas(CW, H, SphereEmitter.worldCfg(SRC));   // THE WORLD: a 2D canvas + universe — first, then parts
-  for (var si = 0; si < srcYs.length; si++) {
-    exp.addObject('SphereEmitter', Object.assign({}, SRC, { center: [srcX, Math.round(srcYs[si])] }));
-  }
+  exp.createCanvas(CW, H, SphereEmitter.worldCfg(parts.source1[1]));   // THE WORLD: a 2D canvas + universe — first, then parts
   const p = exp.declare(parts);
   // ── THE INSTRUMENT — the live count-by-y histogram, REGISTERED TO THE PLATE ──
   // The panel takes the plate's OWN rect y-origin (0) and height (H), so the two