@descix/frqtl-web 0.6.0-p0.1 → 0.6.0-p1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (174) hide show
  1. package/CLAUDE.md +19 -9
  2. package/LICENSE.md +664 -0
  3. package/README.md +31 -7
  4. package/dist/artifact/double-slit.html +4 -1
  5. package/dist/dist-manifest.json +169 -164
  6. package/dist/experiments/empty/index.html +3 -3
  7. package/dist/fat/pkg-web/egpt_wasm.js +7 -7
  8. package/dist/fat/pkg-web/egpt_wasm_bg.wasm +0 -0
  9. package/dist/frqtl/assets/vendor/acorn.LICENSE +21 -0
  10. package/dist/frqtl/assets/vendor/acorn.PINNED.json +9 -0
  11. package/dist/frqtl/assets/vendor/acorn.mjs +6266 -0
  12. package/dist/frqtl/compat/providers/wasm-engine.js +29 -31
  13. package/dist/frqtl/compat/providers/wasm-load-browser.js +2 -2
  14. package/dist/frqtl/compat/renderer/RenderFamily.js +1 -2
  15. package/dist/frqtl/compat/renderer/RenderMesh.js +2 -3
  16. package/dist/frqtl/compat/renderer/RenderShape.js +1 -1
  17. package/dist/frqtl/compat/renderer/captureStill-common.js +1 -2
  18. package/dist/frqtl/compat/renderer/display-slot.js +1 -1
  19. package/dist/frqtl/compat/renderer/lo-drawn-center.js +41 -0
  20. package/dist/frqtl/compat/renderer/providers/p5-provider.js +5 -5
  21. package/dist/frqtl/compat/renderer/providers/three-camera-contract.js +1 -1
  22. package/dist/frqtl/compat/renderer/providers/three-camera-geometry.js +4 -4
  23. package/dist/frqtl/compat/renderer/providers/three-provider.js +23 -27
  24. package/dist/frqtl/compat/renderer/renderCapabilities-common.js +2 -2
  25. package/dist/frqtl/compat/renderer/renderer-provider-contract.js +1 -1
  26. package/dist/frqtl/compat/vendor.js +2 -2
  27. package/dist/frqtl/experiments/_shared/doors.js +2 -2
  28. package/dist/frqtl/experiments/_shared/experiment-layout.css +2 -2
  29. package/dist/frqtl/experiments/_shared/fx-experiment.js +11 -13
  30. package/dist/frqtl/experiments/_shared/interference-analysis.js +1 -1
  31. package/dist/frqtl/objects/FrqtlApp.js +130 -53
  32. package/dist/frqtl/objects/ObjectFactory.js +5 -7
  33. package/dist/frqtl/objects/RecipeContext.js +451 -9
  34. package/dist/frqtl/objects/constants/WallBehaviors.js +5 -5
  35. package/dist/frqtl/objects/geometry/SlabFace.js +6 -6
  36. package/dist/frqtl/objects/instruments/capture-host.js +2 -2
  37. package/dist/frqtl/objects/instruments/capture.js +4 -5
  38. package/dist/frqtl/objects/instruments/hosted-eyes.js +71 -32
  39. package/dist/frqtl/objects/objects/DirectedTunnel.js +10 -11
  40. package/dist/frqtl/objects/objects/LightSource.js +22 -25
  41. package/dist/frqtl/objects/objects/QuantumEmitter.js +15 -15
  42. package/dist/frqtl/objects/objects/Tube.js +14 -14
  43. package/dist/frqtl/objects/objects/absorbRadiation.js +12 -13
  44. package/dist/frqtl/objects/objects/actionCompiler.js +52 -52
  45. package/dist/frqtl/objects/objects/controlAction.js +2 -2
  46. package/dist/frqtl/objects/objects/controlBind.js +2 -2
  47. package/dist/frqtl/objects/objects/directedRedirectProgram.js +3 -3
  48. package/dist/frqtl/objects/objects/emitterProgram.js +9 -9
  49. package/dist/frqtl/objects/objects/frqtl-control-slider.js +3 -3
  50. package/dist/frqtl/objects/objects/frqtl-control-sync.js +9 -9
  51. package/dist/frqtl/objects/objects/frqtl-control-widgets.js +2 -2
  52. package/dist/frqtl/objects/objects/frqtl-control-write-queue.js +2 -2
  53. package/dist/frqtl/objects/objects/makeControlsForObject.js +25 -29
  54. package/dist/frqtl/objects/objects/makeControlsForRenderSurface.js +2 -2
  55. package/dist/frqtl/objects/objects/slitLinerScatter.js +8 -10
  56. package/dist/frqtl/objects/objects/sustainedSource.js +15 -16
  57. package/dist/frqtl/objects/objects/tagger.js +2 -2
  58. package/dist/frqtl/objects/schema/engine-scopes.js +11 -12
  59. package/dist/frqtl/objects/schema/index.js +78 -6
  60. package/dist/frqtl/objects/schema/scopes.js +10 -10
  61. package/dist/frqtl/objects/setup/_collisionMatrixLanes.js +1 -1
  62. package/dist/frqtl/objects/setup/setupBlackbodySubstrate.js +1 -1
  63. package/dist/frqtl/objects/setup/setupCollisionMatrix.js +3 -3
  64. package/dist/frqtl/objects/setup/setupConeEmitter3D.js +7 -8
  65. package/dist/frqtl/objects/setup/setupDoubleSlit.js +20 -21
  66. package/dist/frqtl/objects/setup/setupFxSmoke.js +1 -1
  67. package/dist/frqtl/objects/setup/setupLightSourceLab.js +23 -26
  68. package/dist/frqtl/objects/setup/setupSphereEmitter3D.js +39 -40
  69. package/dist/frqtl/objects/setup/setupTunnelLab.js +17 -19
  70. package/dist/frqtl/objects/setup/setupTunnelPointExit.js +1 -1
  71. package/dist/frqtl/objects/setup/setupWaveInterference.js +4 -5
  72. package/dist/frqtl/objects/v1-replacements.js +0 -1
  73. package/dist/frqtl/parts/CameraControls.js +5 -5
  74. package/dist/frqtl/parts/CameraPath.js +1 -1
  75. package/dist/frqtl/parts/CollisionActions.js +2 -3
  76. package/dist/frqtl/parts/CollisionTypes.js +1 -2
  77. package/dist/frqtl/parts/DetectorWall.js +11 -11
  78. package/dist/frqtl/parts/FrqtlControlsPanel.js +15 -13
  79. package/dist/frqtl/parts/FrqtlVision.js +1 -1
  80. package/dist/frqtl/parts/GraphingDetectorWall.js +3 -4
  81. package/dist/frqtl/parts/LargeObject.js +7 -8
  82. package/dist/frqtl/parts/LightColor.js +2 -2
  83. package/dist/frqtl/parts/LiveChart.js +1 -1
  84. package/dist/frqtl/parts/LogicGate.js +4 -7
  85. package/dist/frqtl/parts/OvenBox.js +1 -2
  86. package/dist/frqtl/parts/PointSource.js +10 -11
  87. package/dist/frqtl/parts/SlitLightSource.js +6 -6
  88. package/dist/frqtl/parts/SlitScreen.js +14 -14
  89. package/dist/frqtl/parts/SphereEmitter.js +24 -24
  90. package/dist/frqtl/parts/Tunnel.js +17 -17
  91. package/dist/frqtl/parts/Wall.js +19 -17
  92. package/dist/frqtl/scenes/absorbing-wall-3d.js +18 -14
  93. package/dist/frqtl/scenes/absorbing-wall.js +18 -14
  94. package/dist/frqtl/scenes/atomic-model.js +3 -0
  95. package/dist/frqtl/scenes/big-bang.js +3 -0
  96. package/dist/frqtl/scenes/blackbody.js +14 -11
  97. package/dist/frqtl/scenes/circuit-sat.js +7 -4
  98. package/dist/frqtl/scenes/collision-matrix-3d.js +3 -0
  99. package/dist/frqtl/scenes/counting-wall-3d.js +19 -15
  100. package/dist/frqtl/scenes/counting-wall.js +19 -15
  101. package/dist/frqtl/scenes/double-slit.js +3 -0
  102. package/dist/frqtl/scenes/dse-one-emitter.js +65 -59
  103. package/dist/frqtl/scenes/dse-one-slit.js +61 -57
  104. package/dist/frqtl/scenes/dse-photoelectric.js +31 -27
  105. package/dist/frqtl/scenes/dse-tunnel-rebuild.js +128 -104
  106. package/dist/frqtl/scenes/dse-two-emitters.js +65 -59
  107. package/dist/frqtl/scenes/dse-two-slits.js +71 -67
  108. package/dist/frqtl/scenes/empty.js +3 -0
  109. package/dist/frqtl/scenes/laser-buildup.js +24 -17
  110. package/dist/frqtl/scenes/mirror-3d.js +33 -29
  111. package/dist/frqtl/scenes/mirror-route.js +13 -10
  112. package/dist/frqtl/scenes/mirror.js +24 -20
  113. package/dist/frqtl/scenes/omni-3d.js +7 -4
  114. package/dist/frqtl/scenes/omni-source.js +7 -4
  115. package/dist/frqtl/scenes/self-interference.js +14 -11
  116. package/dist/frqtl/scenes/smoking-gun.js +16 -12
  117. package/dist/frqtl/scenes/straight-walk.js +7 -4
  118. package/dist/frqtl/scenes/sun.js +13 -10
  119. package/dist/frqtl/scenes/two-source.js +22 -17
  120. package/dist/frqtl/scenes/wave.js +10 -7
  121. package/dist/frqtl-web.min.js +56 -27
  122. package/dist/notebooks/gallery-atomic-model.html +3 -0
  123. package/dist/notebooks/gallery-big-bang.html +4 -1
  124. package/dist/notebooks/gallery-blackbody.html +15 -12
  125. package/dist/notebooks/gallery-collision-matrix-3d.html +3 -0
  126. package/dist/notebooks/gallery-double-slit.html +2 -2
  127. package/dist/notebooks/gallery-particle-walk-3d.html +2 -2
  128. package/dist/notebooks/gallery-recipe-emitter-wall.html +3 -1
  129. package/dist/notebooks/gallery-wave-interference.html +2 -2
  130. package/dist/notebooks/reference-prime-atom-polynomial-test.html +1 -1
  131. package/dist/notebooks/view-vendored-d3.html +1 -1
  132. package/dist/sdk.html +2 -2
  133. package/dist/shim/bundle/frqnb.js +3 -3
  134. package/dist/shim/bundle/index.js +1 -1
  135. package/dist/shim/bundle/manifest.js +2 -2
  136. package/dist/shim/bundle/zip.js +1 -1
  137. package/dist/shim/controls/index.js +14 -14
  138. package/dist/shim/controls/registry.js +3 -3
  139. package/dist/shim/engine/artifact-shell.js +1 -2
  140. package/dist/shim/engine/router.js +15 -17
  141. package/dist/shim/expr/ast-schema.js +5 -5
  142. package/dist/shim/field-descriptor/index.js +7 -8
  143. package/dist/shim/frame-data/index.js +3 -3
  144. package/dist/shim/index.js +4 -4
  145. package/dist/shim/notebook/canvas-guard.js +1 -1
  146. package/dist/shim/notebook/catalog.js +2 -2
  147. package/dist/shim/notebook/format.js +26 -26
  148. package/dist/shim/notebook/kernel.js +3 -4
  149. package/dist/shim/notebook/knob.js +0 -1
  150. package/dist/shim/notebook/module-resolver.js +6 -6
  151. package/dist/shim/notebook/produced-bindings.js +1 -1
  152. package/dist/shim/notebook/setup-builder.js +9 -12
  153. package/dist/shim/notebook/vendor-importmap.js +1 -1
  154. package/dist/shim/notebook/view-builder.js +1 -1
  155. package/dist/shim/notebook/view-ctx.js +1 -1
  156. package/dist/shim/notebook/warmup.js +2 -2
  157. package/dist/shim/page-params/index.js +10 -11
  158. package/dist/shim/project/index.js +7 -5
  159. package/dist/shim/project/link.js +12 -5
  160. package/dist/shim/project/parts-module.js +67 -0
  161. package/dist/shim/project/parts-writer.js +453 -0
  162. package/dist/shim/project/specifiers.js +41 -13
  163. package/dist/shim/registry/copy-gate.js +1 -1
  164. package/dist/shim/registry/exhibits.js +4 -4
  165. package/dist/shim/registry/experiments.js +3 -3
  166. package/dist/shim/registry/walkthrough.js +29 -32
  167. package/dist/shim/render/render-stages.js +2 -2
  168. package/dist/shim/render/sun-look.js +2 -2
  169. package/dist/shim/render-state/apply.js +11 -14
  170. package/dist/shim/rpc/index.js +2 -2
  171. package/dist/shim/runtime/index.js +12 -12
  172. package/dist/shim/storage/modules.js +8 -8
  173. package/llms.txt +7 -7
  174. package/package.json +4 -3
package/CLAUDE.md CHANGED
@@ -5,7 +5,7 @@ in the browser. Physics comes out of local per-pixel rules — a frame moves one
5
5
  occupancy, momentum — rather than force equations or wave PDEs. Double-slit fringes, wave interference
6
6
  and blackbody spectra are computed live from the automaton, not replayed.
7
7
 
8
- Pre-release `0.6.0-p0.1` (npm dist-tag `next`). The node twin is `@descix/frqtl-node` (the same modules,
8
+ Pre-release `0.6.0-p1.1` (npm dist-tag `next`). The node twin is `@descix/frqtl-node` (the same modules,
9
9
  plus `bootNode` and the hosted eyes).
10
10
 
11
11
  ## Install
@@ -14,11 +14,11 @@ plus `bootNode` and the hosted eyes).
14
14
  ## See it run immediately
15
15
  Open this URL, or embed it in a claude.ai artifact iframe (self-contained):
16
16
 
17
- https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p0.1/dist/artifact/double-slit.html
17
+ https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p1.1/dist/artifact/double-slit.html
18
18
 
19
19
  and the one-file form (a `<script>` tag, global `FRQTL`) booting a 3D sun:
20
20
 
21
- https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p0.1/dist/artifact/sun.html
21
+ https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p1.1/dist/artifact/sun.html
22
22
 
23
23
  ## A scene is a sketch
24
24
  A scene is an ES module whose default export is `buildExperiment(exp)`. Its first statement is the
@@ -35,8 +35,15 @@ export default function buildExperiment(exp) {
35
35
  }
36
36
  ```
37
37
 
38
- Read a real one before writing your own: `https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p0.1/dist/frqtl/scenes/double-slit.js` (every walk-through
39
- rung is a file under `dist/frqtl/scenes/`), and a part: `https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p0.1/dist/frqtl/parts/DetectorWall.js`.
38
+ Its movable parts are DATA: `export const parts = { name: [Kind, { …props }] }` (Kind an imported class, the
39
+ key its name), declared by one `exp.declare(parts)` in key order. A hand on a declared entry is written back
40
+ into that literal by the `recipeContext` a project boot returns: `await recipeContext.toSketch()` → `{ files,
41
+ changes, refused }` (only touched values change; a new kind brings one import line; a code-declared object is
42
+ refused by name), and `await recipeContext.setDeclared(name, patch)` changes one entry and re-runs in place
43
+ (seed and camera kept). `runner.declared` rows read `inParts` and `module`.
44
+
45
+ Read a real one before writing your own: `https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p1.1/dist/frqtl/scenes/double-slit.js` (every walk-through
46
+ rung is a file under `dist/frqtl/scenes/`), and a part: `https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p1.1/dist/frqtl/parts/DetectorWall.js`.
40
47
 
41
48
  ## Boot it — the two doors (`@descix/frqtl-web/boot`)
42
49
  bootScene(mount, buildExperiment, { renderer: 'p5' | 'three', seed, onTick, render })
@@ -52,8 +59,11 @@ in the mount and rejects. The runner's SceneRecord carries the project's identit
52
59
  `./project`) as `sourceSha256`.
53
60
 
54
61
  A page with no build step needs an import map; render it from the package's own table:
55
- `importMapFor('<the dist root URL>/')` (`./project`) — every `@descix/frqtl-web/...` row at its file.
56
- Or skip the map: `<script src="https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p0.1/dist/frqtl-web.min.js"></script>` then `FRQTL.bootScene(…)`,
62
+ `importMapFor('<the dist root URL>/')` (`./project`) — every `@descix/frqtl-web/...` row at its file; a host page that
63
+ imports `./boot`, `./registry` or `./project` by specifier renders `pageImportMapFor(...)` instead; it has no manifest
64
+ row, so read the manifest from the same root: `new URL('dist-manifest.json', root)`.
65
+ The root is an absolute URL or starts with `/`, `./` or `../`. A sketch held as text boots as `bootProject(mount, sketchProject(text))`.
66
+ Or skip the map: `<script src="https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p1.1/dist/frqtl-web.min.js"></script>` then `FRQTL.bootScene(…)`,
57
67
  `FRQTL.Wall`, …
58
68
 
59
69
  String kinds: `exp.addObject('Wall', props)` resolves the kind in the SCENE's realm (the frame the scene
@@ -66,7 +76,7 @@ it never imports the registry into its own document, where no kind is registered
66
76
  | `.` | the parts (`Wall`, `SphereEmitter`, `Tunnel`, `FrqtlVision`, …), `bootScene`, `bootProject`, `engine`, `engineState`, `FrqtlCapture`, `RenderStages`, `FieldBuilder`, `CaptureEnvelope`, `validateRendererProvider` |
67
77
  | `./boot` | `bootScene`, `bootProject` (in node it throws naming `@descix/frqtl-node`) |
68
78
  | `./parts`, `./parts/*` | the parts barrel; one part = one file |
69
- | `./project` | `FRQTL_WEB_SPECIFIERS`, `libPathOf`, `importMapFor`, `linkProject`, `projectIdentity` |
79
+ | `./project` | `FRQTL_WEB_SPECIFIERS`, `libPathOf`, `importMapFor`, `pageImportMapFor`, `linkProject`, `sketchProject`, `SKETCH_ENTRY`, `projectIdentity` |
70
80
  | `./registry` | the walk-through rungs, the showcase roster, the experiment registry, `loadSceneSource(id)` |
71
81
  | `./kinds` | `registerKind`, `kindNamed`, `kindOf` (the parent's row, frozen), `registeredKinds` — a composed fork registers its renamed class |
72
82
  | `./shim/controls/registry.js`, `./shim/render/sun-look.js`, `./compat/renderer/display-slot.js`, `./compat/renderer/orbit-bag.js`, `./objects/setup/_collisionMatrixLanes.js`, `./compat/engine.js` | the six non-part modules a scene may import (the rows of `FRQTL_WEB_SPECIFIERS`) |
@@ -106,6 +116,6 @@ Everything is a Frame (recursive); there is no separate "particle" class.
106
116
  - The published build is WASM-only on the engine side (compiled surface).
107
117
 
108
118
  ## Curated notebooks
109
- Index: `https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p0.1/dist/notebooks/notebooks.json`
119
+ Index: `https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p1.1/dist/notebooks/notebooks.json`
110
120
 
111
121
  ## No account, credits, or tokens are needed for anything above.