@descix/frqtl-web 0.0.0-stage → 0.6.0-p0.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 (473) hide show
  1. package/CLAUDE.md +111 -0
  2. package/README.md +94 -2
  3. package/dist/artifact/double-slit.html +89 -0
  4. package/dist/artifact/sun.html +81 -0
  5. package/dist/boot/node-refusal.js +24 -0
  6. package/dist/css/bootstrap.min.css +6 -0
  7. package/dist/css/devsdk.css +518 -0
  8. package/dist/dist-manifest.json +474 -0
  9. package/dist/experiments/empty/index.html +338 -0
  10. package/dist/fat/pkg-web/egpt_wasm.js +1373 -0
  11. package/dist/fat/pkg-web/egpt_wasm_bg.wasm +0 -0
  12. package/dist/frqtl/assets/vendor/bootstrap.bundle.min.js +7 -0
  13. package/dist/frqtl/assets/vendor/chroma.mjs +64 -0
  14. package/dist/frqtl/assets/vendor/d3.min.js +2 -0
  15. package/dist/frqtl/assets/vendor/github-markdown-css/github-markdown.css +1195 -0
  16. package/dist/frqtl/assets/vendor/mediabunny.LICENSE +373 -0
  17. package/dist/frqtl/assets/vendor/mediabunny.PINNED.json +9 -0
  18. package/dist/frqtl/assets/vendor/mediabunny.min.mjs +50 -0
  19. package/dist/frqtl/assets/vendor/monaco/vs/base/browser/ui/codicons/codicon/codicon.ttf +0 -0
  20. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.de.js +8 -0
  21. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.es.js +8 -0
  22. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.fr.js +8 -0
  23. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.it.js +8 -0
  24. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.ja.js +8 -0
  25. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.js +8 -0
  26. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.ko.js +8 -0
  27. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.ru.js +8 -0
  28. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.zh-cn.js +8 -0
  29. package/dist/frqtl/assets/vendor/monaco/vs/base/common/worker/simpleWorker.nls.zh-tw.js +8 -0
  30. package/dist/frqtl/assets/vendor/monaco/vs/base/worker/workerMain.js +27 -0
  31. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/abap/abap.js +10 -0
  32. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/apex/apex.js +10 -0
  33. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/azcli/azcli.js +10 -0
  34. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/bat/bat.js +10 -0
  35. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/bicep/bicep.js +11 -0
  36. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/cameligo/cameligo.js +10 -0
  37. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/clojure/clojure.js +10 -0
  38. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/coffee/coffee.js +10 -0
  39. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/cpp/cpp.js +10 -0
  40. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/csharp/csharp.js +10 -0
  41. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/csp/csp.js +10 -0
  42. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/css/css.js +12 -0
  43. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/cypher/cypher.js +10 -0
  44. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/dart/dart.js +10 -0
  45. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/dockerfile/dockerfile.js +10 -0
  46. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/ecl/ecl.js +10 -0
  47. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/elixir/elixir.js +10 -0
  48. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/flow9/flow9.js +10 -0
  49. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/freemarker2/freemarker2.js +12 -0
  50. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/fsharp/fsharp.js +10 -0
  51. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/go/go.js +10 -0
  52. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/graphql/graphql.js +10 -0
  53. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/handlebars/handlebars.js +10 -0
  54. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/hcl/hcl.js +10 -0
  55. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/html/html.js +10 -0
  56. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/ini/ini.js +10 -0
  57. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/java/java.js +10 -0
  58. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/javascript/javascript.js +10 -0
  59. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/julia/julia.js +10 -0
  60. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/kotlin/kotlin.js +10 -0
  61. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/less/less.js +11 -0
  62. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/lexon/lexon.js +10 -0
  63. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/liquid/liquid.js +10 -0
  64. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/lua/lua.js +10 -0
  65. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/m3/m3.js +10 -0
  66. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/markdown/markdown.js +10 -0
  67. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/mdx/mdx.js +10 -0
  68. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/mips/mips.js +10 -0
  69. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/msdax/msdax.js +10 -0
  70. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/mysql/mysql.js +10 -0
  71. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/objective-c/objective-c.js +10 -0
  72. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/pascal/pascal.js +10 -0
  73. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/pascaligo/pascaligo.js +10 -0
  74. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/perl/perl.js +10 -0
  75. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/pgsql/pgsql.js +10 -0
  76. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/php/php.js +10 -0
  77. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/pla/pla.js +10 -0
  78. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/postiats/postiats.js +10 -0
  79. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/powerquery/powerquery.js +10 -0
  80. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/powershell/powershell.js +10 -0
  81. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/protobuf/protobuf.js +11 -0
  82. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/pug/pug.js +10 -0
  83. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/python/python.js +10 -0
  84. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/qsharp/qsharp.js +10 -0
  85. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/r/r.js +10 -0
  86. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/razor/razor.js +10 -0
  87. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/redis/redis.js +10 -0
  88. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/redshift/redshift.js +10 -0
  89. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/restructuredtext/restructuredtext.js +10 -0
  90. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/ruby/ruby.js +10 -0
  91. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/rust/rust.js +10 -0
  92. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/sb/sb.js +10 -0
  93. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/scala/scala.js +10 -0
  94. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/scheme/scheme.js +10 -0
  95. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/scss/scss.js +12 -0
  96. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/shell/shell.js +10 -0
  97. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/solidity/solidity.js +10 -0
  98. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/sophia/sophia.js +10 -0
  99. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/sparql/sparql.js +10 -0
  100. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/sql/sql.js +10 -0
  101. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/st/st.js +10 -0
  102. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/swift/swift.js +13 -0
  103. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/systemverilog/systemverilog.js +10 -0
  104. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/tcl/tcl.js +10 -0
  105. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/twig/twig.js +10 -0
  106. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/typescript/typescript.js +10 -0
  107. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/vb/vb.js +10 -0
  108. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/wgsl/wgsl.js +307 -0
  109. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/xml/xml.js +10 -0
  110. package/dist/frqtl/assets/vendor/monaco/vs/basic-languages/yaml/yaml.js +10 -0
  111. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.css +6 -0
  112. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.js +745 -0
  113. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.de.js +31 -0
  114. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.es.js +31 -0
  115. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.fr.js +29 -0
  116. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.it.js +29 -0
  117. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.ja.js +31 -0
  118. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.js +29 -0
  119. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.ko.js +29 -0
  120. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.ru.js +31 -0
  121. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.zh-cn.js +31 -0
  122. package/dist/frqtl/assets/vendor/monaco/vs/editor/editor.main.nls.zh-tw.js +29 -0
  123. package/dist/frqtl/assets/vendor/monaco/vs/language/css/cssMode.js +13 -0
  124. package/dist/frqtl/assets/vendor/monaco/vs/language/css/cssWorker.js +81 -0
  125. package/dist/frqtl/assets/vendor/monaco/vs/language/html/htmlMode.js +13 -0
  126. package/dist/frqtl/assets/vendor/monaco/vs/language/html/htmlWorker.js +453 -0
  127. package/dist/frqtl/assets/vendor/monaco/vs/language/json/jsonMode.js +15 -0
  128. package/dist/frqtl/assets/vendor/monaco/vs/language/json/jsonWorker.js +36 -0
  129. package/dist/frqtl/assets/vendor/monaco/vs/language/typescript/tsMode.js +20 -0
  130. package/dist/frqtl/assets/vendor/monaco/vs/language/typescript/tsWorker.js +37016 -0
  131. package/dist/frqtl/assets/vendor/monaco/vs/loader.js +11 -0
  132. package/dist/frqtl/assets/vendor/p5.dom.min.js +1 -0
  133. package/dist/frqtl/assets/vendor/p5.min.js +1 -0
  134. package/dist/frqtl/assets/vendor/three-loaders/DRACOLoader.js +571 -0
  135. package/dist/frqtl/assets/vendor/three-loaders/GLTFLoader.js +3629 -0
  136. package/dist/frqtl/assets/vendor/three-loaders/draco/draco_decoder.wasm +0 -0
  137. package/dist/frqtl/assets/vendor/three-loaders/draco/draco_wasm_wrapper.js +104 -0
  138. package/dist/frqtl/assets/vendor/three.min.js +6 -0
  139. package/dist/frqtl/boot-entry.js +18 -0
  140. package/dist/frqtl/compat/engine.js +127 -0
  141. package/dist/frqtl/compat/package-root.js +24 -0
  142. package/dist/frqtl/compat/providers/wasm-engine.js +2501 -0
  143. package/dist/frqtl/compat/providers/wasm-load-browser.js +134 -0
  144. package/dist/frqtl/compat/renderer/FieldBuilder.js +145 -0
  145. package/dist/frqtl/compat/renderer/Filters.js +163 -0
  146. package/dist/frqtl/compat/renderer/RenderFamily.js +85 -0
  147. package/dist/frqtl/compat/renderer/RenderMesh.js +100 -0
  148. package/dist/frqtl/compat/renderer/RenderShape.js +154 -0
  149. package/dist/frqtl/compat/renderer/camera2d-geometry.js +183 -0
  150. package/dist/frqtl/compat/renderer/captureStill-common.js +259 -0
  151. package/dist/frqtl/compat/renderer/display-slot.js +96 -0
  152. package/dist/frqtl/compat/renderer/lo-drawn-center.js +231 -0
  153. package/dist/frqtl/compat/renderer/orbit-bag.js +216 -0
  154. package/dist/frqtl/compat/renderer/providers/godrays-layer.js +213 -0
  155. package/dist/frqtl/compat/renderer/providers/index.js +22 -0
  156. package/dist/frqtl/compat/renderer/providers/p5-provider.js +861 -0
  157. package/dist/frqtl/compat/renderer/providers/three-camera-contract.js +160 -0
  158. package/dist/frqtl/compat/renderer/providers/three-camera-geometry.js +571 -0
  159. package/dist/frqtl/compat/renderer/providers/three-provider.js +2474 -0
  160. package/dist/frqtl/compat/renderer/renderCapabilities-common.js +186 -0
  161. package/dist/frqtl/compat/renderer/renderer-provider-contract.js +238 -0
  162. package/dist/frqtl/compat/renderer/unprojectStill.js +172 -0
  163. package/dist/frqtl/compat/vendor.js +196 -0
  164. package/dist/frqtl/experiments/_shared/boot-failure.js +60 -0
  165. package/dist/frqtl/experiments/_shared/boot.js +418 -0
  166. package/dist/frqtl/experiments/_shared/doors.js +310 -0
  167. package/dist/frqtl/experiments/_shared/experiment-layout.css +275 -0
  168. package/dist/frqtl/experiments/_shared/experiment-metrics.js +131 -0
  169. package/dist/frqtl/experiments/_shared/fx-experiment.js +451 -0
  170. package/dist/frqtl/experiments/_shared/interference-analysis.js +396 -0
  171. package/dist/frqtl/experiments/_shared/page-door.js +113 -0
  172. package/dist/frqtl/experiments/_shared/radiation-histogram.js +202 -0
  173. package/dist/frqtl/experiments/_shared/retired-globals.js +192 -0
  174. package/dist/frqtl/objects/FrqtlApp.js +2922 -0
  175. package/dist/frqtl/objects/ObjectFactory.js +297 -0
  176. package/dist/frqtl/objects/RecipeContext.js +322 -0
  177. package/dist/frqtl/objects/collectors/DataCollector.js +116 -0
  178. package/dist/frqtl/objects/constants/WallBehaviors.js +178 -0
  179. package/dist/frqtl/objects/geometry/SlabFace.js +258 -0
  180. package/dist/frqtl/objects/instruments/capture-host.js +453 -0
  181. package/dist/frqtl/objects/instruments/capture.js +711 -0
  182. package/dist/frqtl/objects/instruments/hosted-eyes.js +985 -0
  183. package/dist/frqtl/objects/kinds-entry.js +14 -0
  184. package/dist/frqtl/objects/kinds.js +190 -0
  185. package/dist/frqtl/objects/objects/Box.js +273 -0
  186. package/dist/frqtl/objects/objects/Bullet.js +155 -0
  187. package/dist/frqtl/objects/objects/CircuitGate.js +380 -0
  188. package/dist/frqtl/objects/objects/CircuitProbe.js +214 -0
  189. package/dist/frqtl/objects/objects/DirectedTunnel.js +412 -0
  190. package/dist/frqtl/objects/objects/EgptFractal.js +164 -0
  191. package/dist/frqtl/objects/objects/LightSource.js +354 -0
  192. package/dist/frqtl/objects/objects/QuantumEmitter.js +760 -0
  193. package/dist/frqtl/objects/objects/Tube.js +471 -0
  194. package/dist/frqtl/objects/objects/absorbRadiation.js +310 -0
  195. package/dist/frqtl/objects/objects/actionCompiler.js +1747 -0
  196. package/dist/frqtl/objects/objects/controlAction.js +89 -0
  197. package/dist/frqtl/objects/objects/controlBind.js +278 -0
  198. package/dist/frqtl/objects/objects/directedRedirectProgram.js +120 -0
  199. package/dist/frqtl/objects/objects/emitterProgram.js +209 -0
  200. package/dist/frqtl/objects/objects/frqtl-control-slider.js +197 -0
  201. package/dist/frqtl/objects/objects/frqtl-control-sync.js +272 -0
  202. package/dist/frqtl/objects/objects/frqtl-control-widgets.js +219 -0
  203. package/dist/frqtl/objects/objects/frqtl-control-write-queue.js +174 -0
  204. package/dist/frqtl/objects/objects/makeControlsForObject.js +824 -0
  205. package/dist/frqtl/objects/objects/makeControlsForRenderSurface.js +161 -0
  206. package/dist/frqtl/objects/objects/slitLinerScatter.js +263 -0
  207. package/dist/frqtl/objects/objects/sustainedSource.js +299 -0
  208. package/dist/frqtl/objects/objects/tagger.js +228 -0
  209. package/dist/frqtl/objects/schema/engine-scopes.js +469 -0
  210. package/dist/frqtl/objects/schema/index.js +256 -0
  211. package/dist/frqtl/objects/schema/scopes.js +457 -0
  212. package/dist/frqtl/objects/schema/validate-descriptor.js +49 -0
  213. package/dist/frqtl/objects/schema/valueNormalizer.js +366 -0
  214. package/dist/frqtl/objects/setup/_collisionMatrixLanes.js +66 -0
  215. package/dist/frqtl/objects/setup/_setupOptions.js +118 -0
  216. package/dist/frqtl/objects/setup/_worldInit.js +162 -0
  217. package/dist/frqtl/objects/setup/setupBlackbodySubstrate.js +242 -0
  218. package/dist/frqtl/objects/setup/setupCircuitBasic.js +447 -0
  219. package/dist/frqtl/objects/setup/setupCollisionMatrix.js +188 -0
  220. package/dist/frqtl/objects/setup/setupConeEmitter3D.js +251 -0
  221. package/dist/frqtl/objects/setup/setupDoubleSlit.js +327 -0
  222. package/dist/frqtl/objects/setup/setupDoubleSlit_Laser.js +229 -0
  223. package/dist/frqtl/objects/setup/setupEmpty.js +59 -0
  224. package/dist/frqtl/objects/setup/setupFxSmoke.js +209 -0
  225. package/dist/frqtl/objects/setup/setupG1Race.js +80 -0
  226. package/dist/frqtl/objects/setup/setupG2Sweep.js +89 -0
  227. package/dist/frqtl/objects/setup/setupG3Collide.js +177 -0
  228. package/dist/frqtl/objects/setup/setupLightSourceLab.js +280 -0
  229. package/dist/frqtl/objects/setup/setupOscillator.js +68 -0
  230. package/dist/frqtl/objects/setup/setupParticleWalk.js +93 -0
  231. package/dist/frqtl/objects/setup/setupParticleWalk3D.js +133 -0
  232. package/dist/frqtl/objects/setup/setupSphereEmitter3D.js +1259 -0
  233. package/dist/frqtl/objects/setup/setupTraceCircuit.js +239 -0
  234. package/dist/frqtl/objects/setup/setupTunnelLab.js +242 -0
  235. package/dist/frqtl/objects/setup/setupTunnelPointExit.js +306 -0
  236. package/dist/frqtl/objects/setup/setupWaveInterference.js +178 -0
  237. package/dist/frqtl/objects/v1-replacements.js +30 -0
  238. package/dist/frqtl/package-core.js +23 -0
  239. package/dist/frqtl/parts/CameraControls.js +643 -0
  240. package/dist/frqtl/parts/CameraPath.js +575 -0
  241. package/dist/frqtl/parts/CollisionActions.js +35 -0
  242. package/dist/frqtl/parts/CollisionTypes.js +31 -0
  243. package/dist/frqtl/parts/DetectorWall.js +496 -0
  244. package/dist/frqtl/parts/FrqtlControlOverlay.js +227 -0
  245. package/dist/frqtl/parts/FrqtlControlsPanel.js +415 -0
  246. package/dist/frqtl/parts/FrqtlVision.js +818 -0
  247. package/dist/frqtl/parts/GraphingDetectorWall.js +490 -0
  248. package/dist/frqtl/parts/LargeObject.js +406 -0
  249. package/dist/frqtl/parts/LightColor.js +255 -0
  250. package/dist/frqtl/parts/LiveChart.js +285 -0
  251. package/dist/frqtl/parts/LogicGate.js +720 -0
  252. package/dist/frqtl/parts/OvenBox.js +612 -0
  253. package/dist/frqtl/parts/PointSource.js +763 -0
  254. package/dist/frqtl/parts/Rectangle.js +200 -0
  255. package/dist/frqtl/parts/SlitLightSource.js +234 -0
  256. package/dist/frqtl/parts/SlitScreen.js +628 -0
  257. package/dist/frqtl/parts/SphereEmitter.js +946 -0
  258. package/dist/frqtl/parts/Trace.js +508 -0
  259. package/dist/frqtl/parts/Tunnel.js +1057 -0
  260. package/dist/frqtl/parts/Wall.js +1211 -0
  261. package/dist/frqtl/parts/index.js +33 -0
  262. package/dist/frqtl/scenes/absorbing-wall-3d.js +33 -0
  263. package/dist/frqtl/scenes/absorbing-wall.js +32 -0
  264. package/dist/frqtl/scenes/atomic-model.js +88 -0
  265. package/dist/frqtl/scenes/big-bang.js +46 -0
  266. package/dist/frqtl/scenes/blackbody.js +81 -0
  267. package/dist/frqtl/scenes/circuit-sat.js +127 -0
  268. package/dist/frqtl/scenes/collision-matrix-3d.js +107 -0
  269. package/dist/frqtl/scenes/counting-wall-3d.js +36 -0
  270. package/dist/frqtl/scenes/counting-wall.js +38 -0
  271. package/dist/frqtl/scenes/double-slit.js +31 -0
  272. package/dist/frqtl/scenes/dse-one-emitter.js +196 -0
  273. package/dist/frqtl/scenes/dse-one-slit.js +114 -0
  274. package/dist/frqtl/scenes/dse-photoelectric.js +70 -0
  275. package/dist/frqtl/scenes/dse-tunnel-rebuild.js +244 -0
  276. package/dist/frqtl/scenes/dse-two-emitters.js +196 -0
  277. package/dist/frqtl/scenes/dse-two-slits.js +132 -0
  278. package/dist/frqtl/scenes/empty.js +14 -0
  279. package/dist/frqtl/scenes/laser-buildup.js +49 -0
  280. package/dist/frqtl/scenes/mirror-3d.js +56 -0
  281. package/dist/frqtl/scenes/mirror-route.js +140 -0
  282. package/dist/frqtl/scenes/mirror.js +38 -0
  283. package/dist/frqtl/scenes/omni-3d.js +27 -0
  284. package/dist/frqtl/scenes/omni-source.js +22 -0
  285. package/dist/frqtl/scenes/self-interference.js +39 -0
  286. package/dist/frqtl/scenes/smoking-gun.js +122 -0
  287. package/dist/frqtl/scenes/straight-walk.js +22 -0
  288. package/dist/frqtl/scenes/sun.js +39 -0
  289. package/dist/frqtl/scenes/two-source.js +37 -0
  290. package/dist/frqtl/scenes/wave.js +26 -0
  291. package/dist/frqtl-web.min.js +105 -0
  292. package/dist/images/BlackBodyRadiation.png +0 -0
  293. package/dist/images/EGPTFractal.png +0 -0
  294. package/dist/images/atom_strongforce.png +0 -0
  295. package/dist/images/big_bang.png +0 -0
  296. package/dist/images/colored_light_packets.png +0 -0
  297. package/dist/images/concentric_interference.png +0 -0
  298. package/dist/images/early_universe.png +0 -0
  299. package/dist/images/greenlaser_doubleslit.png +0 -0
  300. package/dist/images/interference_all.png +0 -0
  301. package/dist/images/interference_slit1.png +0 -0
  302. package/dist/images/interference_slit2.png +0 -0
  303. package/dist/images/particle_walk.png +0 -0
  304. package/dist/images/particles which did not go through a slit at all.png +0 -0
  305. package/dist/images/particles_only.png +0 -0
  306. package/dist/images/wave_particle_duality.png +0 -0
  307. package/dist/js/models/flamingo-draco.glb +0 -0
  308. package/dist/js/models/flamingo.glb +0 -0
  309. package/dist/notebooks/arithmetic-basics.html +166 -0
  310. package/dist/notebooks/complex-twiddle.html +148 -0
  311. package/dist/notebooks/egpt-fft-test.html +202 -0
  312. package/dist/notebooks/egpt-matrix-test.html +241 -0
  313. package/dist/notebooks/egpt-polynomial-test.html +703 -0
  314. package/dist/notebooks/egpt-prime-composite-test.html +553 -0
  315. package/dist/notebooks/egpt-test-suite.html +1387 -0
  316. package/dist/notebooks/egpt-topology-test.html +410 -0
  317. package/dist/notebooks/factorization-basics.html +131 -0
  318. package/dist/notebooks/fft.html +154 -0
  319. package/dist/notebooks/gallery-atomic-model.html +120 -0
  320. package/dist/notebooks/gallery-big-bang.html +94 -0
  321. package/dist/notebooks/gallery-blackbody.html +119 -0
  322. package/dist/notebooks/gallery-collision-matrix-3d.html +143 -0
  323. package/dist/notebooks/gallery-double-slit.html +53 -0
  324. package/dist/notebooks/gallery-particle-walk-3d.html +53 -0
  325. package/dist/notebooks/gallery-recipe-emitter-wall.html +104 -0
  326. package/dist/notebooks/gallery-wave-interference.html +52 -0
  327. package/dist/notebooks/getting-started-hello-frqtl.html +58 -0
  328. package/dist/notebooks/iso-canonical-chain.html +203 -0
  329. package/dist/notebooks/iso-entropy-log.html +129 -0
  330. package/dist/notebooks/iso-fft-polynomial.html +135 -0
  331. package/dist/notebooks/iso-matrix-four-views.html +131 -0
  332. package/dist/notebooks/iso-number-theory-four-views.html +101 -0
  333. package/dist/notebooks/iso-pi-log-fraction-loop.html +138 -0
  334. package/dist/notebooks/matrix.html +202 -0
  335. package/dist/notebooks/notebooks.json +229 -0
  336. package/dist/notebooks/polynomials.html +201 -0
  337. package/dist/notebooks/prime-composite.html +266 -0
  338. package/dist/notebooks/rational-core.html +179 -0
  339. package/dist/notebooks/reference-egpt-fft-test.html +187 -0
  340. package/dist/notebooks/reference-order-finder-test.html +196 -0
  341. package/dist/notebooks/reference-prime-atom-polynomial-test.html +542 -0
  342. package/dist/notebooks/reference-solve-polynomial-system-test.html +471 -0
  343. package/dist/notebooks/scaled-vectors.html +112 -0
  344. package/dist/notebooks/stats.html +206 -0
  345. package/dist/notebooks/transcendentals.html +195 -0
  346. package/dist/notebooks/view-vendored-d3.html +78 -0
  347. package/dist/sdk.html +689 -0
  348. package/dist/shim/bundle/frqnb.js +112 -0
  349. package/dist/shim/bundle/index.js +121 -0
  350. package/dist/shim/bundle/indexHtml.js +107 -0
  351. package/dist/shim/bundle/manifest.js +95 -0
  352. package/dist/shim/bundle/zip.js +243 -0
  353. package/dist/shim/bus.js +67 -0
  354. package/dist/shim/controls/index.js +627 -0
  355. package/dist/shim/controls/registry.js +274 -0
  356. package/dist/shim/engine/artifact-shell.js +212 -0
  357. package/dist/shim/engine/boot-phases.js +44 -0
  358. package/dist/shim/engine/engine-stack-boot.js +59 -0
  359. package/dist/shim/engine/router.js +692 -0
  360. package/dist/shim/experiment-frame/index.js +296 -0
  361. package/dist/shim/expr/ast-schema.js +369 -0
  362. package/dist/shim/field-descriptor/index.js +326 -0
  363. package/dist/shim/frame-data/index.js +224 -0
  364. package/dist/shim/index.js +67 -0
  365. package/dist/shim/notebook/canvas-guard.js +82 -0
  366. package/dist/shim/notebook/catalog.js +35 -0
  367. package/dist/shim/notebook/format.js +736 -0
  368. package/dist/shim/notebook/frqtl-setups-importmap.js +81 -0
  369. package/dist/shim/notebook/kernel.js +672 -0
  370. package/dist/shim/notebook/knob.js +151 -0
  371. package/dist/shim/notebook/module-resolver.js +260 -0
  372. package/dist/shim/notebook/notebook-knobs.js +65 -0
  373. package/dist/shim/notebook/produced-bindings.js +67 -0
  374. package/dist/shim/notebook/realm-registry.js +121 -0
  375. package/dist/shim/notebook/realm-transport.js +73 -0
  376. package/dist/shim/notebook/setup-builder.js +510 -0
  377. package/dist/shim/notebook/store.js +159 -0
  378. package/dist/shim/notebook/vendor-importmap.js +134 -0
  379. package/dist/shim/notebook/view-builder.js +189 -0
  380. package/dist/shim/notebook/view-ctx.js +100 -0
  381. package/dist/shim/notebook/view-handle.js +202 -0
  382. package/dist/shim/notebook/warmup.js +102 -0
  383. package/dist/shim/package.json +4 -0
  384. package/dist/shim/page-params/index.js +214 -0
  385. package/dist/shim/project/identity.js +112 -0
  386. package/dist/shim/project/index.js +19 -0
  387. package/dist/shim/project/link.js +402 -0
  388. package/dist/shim/project/specifiers.js +106 -0
  389. package/dist/shim/registry/copy-gate.js +110 -0
  390. package/dist/shim/registry/exhibits.js +455 -0
  391. package/dist/shim/registry/experiments.js +215 -0
  392. package/dist/shim/registry/index.js +19 -0
  393. package/dist/shim/registry/scene-source.js +157 -0
  394. package/dist/shim/registry/walkthrough.js +807 -0
  395. package/dist/shim/render/capture-envelope.js +279 -0
  396. package/dist/shim/render/heat-colormap.js +92 -0
  397. package/dist/shim/render/render-stages.js +855 -0
  398. package/dist/shim/render/sun-look.js +33 -0
  399. package/dist/shim/render-state/apply.js +262 -0
  400. package/dist/shim/render-state/index.js +74 -0
  401. package/dist/shim/rpc/index.js +207 -0
  402. package/dist/shim/runtime/index.js +1023 -0
  403. package/dist/shim/storage/boot.js +69 -0
  404. package/dist/shim/storage/index.js +169 -0
  405. package/dist/shim/storage/local-storage-provider.js +230 -0
  406. package/dist/shim/storage/make-namespace-store.js +132 -0
  407. package/dist/shim/storage/modules.js +249 -0
  408. package/dist/shim/storage/projects.js +150 -0
  409. package/dist/vendor/d3-array/src/array.js +4 -0
  410. package/dist/vendor/d3-array/src/ascending.js +3 -0
  411. package/dist/vendor/d3-array/src/bin.js +125 -0
  412. package/dist/vendor/d3-array/src/bisect.js +9 -0
  413. package/dist/vendor/d3-array/src/bisector.js +56 -0
  414. package/dist/vendor/d3-array/src/blur.js +115 -0
  415. package/dist/vendor/d3-array/src/constant.js +3 -0
  416. package/dist/vendor/d3-array/src/count.js +18 -0
  417. package/dist/vendor/d3-array/src/cross.js +33 -0
  418. package/dist/vendor/d3-array/src/cumsum.js +6 -0
  419. package/dist/vendor/d3-array/src/descending.js +7 -0
  420. package/dist/vendor/d3-array/src/deviation.js +6 -0
  421. package/dist/vendor/d3-array/src/difference.js +11 -0
  422. package/dist/vendor/d3-array/src/disjoint.js +15 -0
  423. package/dist/vendor/d3-array/src/every.js +10 -0
  424. package/dist/vendor/d3-array/src/extent.js +29 -0
  425. package/dist/vendor/d3-array/src/filter.js +11 -0
  426. package/dist/vendor/d3-array/src/fsum.js +69 -0
  427. package/dist/vendor/d3-array/src/greatest.js +29 -0
  428. package/dist/vendor/d3-array/src/greatestIndex.js +19 -0
  429. package/dist/vendor/d3-array/src/group.js +65 -0
  430. package/dist/vendor/d3-array/src/groupSort.js +10 -0
  431. package/dist/vendor/d3-array/src/identity.js +3 -0
  432. package/dist/vendor/d3-array/src/index.js +57 -0
  433. package/dist/vendor/d3-array/src/intersection.js +19 -0
  434. package/dist/vendor/d3-array/src/least.js +29 -0
  435. package/dist/vendor/d3-array/src/leastIndex.js +19 -0
  436. package/dist/vendor/d3-array/src/map.js +5 -0
  437. package/dist/vendor/d3-array/src/max.js +20 -0
  438. package/dist/vendor/d3-array/src/maxIndex.js +22 -0
  439. package/dist/vendor/d3-array/src/mean.js +19 -0
  440. package/dist/vendor/d3-array/src/median.js +9 -0
  441. package/dist/vendor/d3-array/src/merge.js +9 -0
  442. package/dist/vendor/d3-array/src/min.js +20 -0
  443. package/dist/vendor/d3-array/src/minIndex.js +22 -0
  444. package/dist/vendor/d3-array/src/mode.js +28 -0
  445. package/dist/vendor/d3-array/src/nice.js +18 -0
  446. package/dist/vendor/d3-array/src/number.js +20 -0
  447. package/dist/vendor/d3-array/src/pairs.js +15 -0
  448. package/dist/vendor/d3-array/src/permute.js +3 -0
  449. package/dist/vendor/d3-array/src/quantile.js +47 -0
  450. package/dist/vendor/d3-array/src/quickselect.js +53 -0
  451. package/dist/vendor/d3-array/src/range.js +13 -0
  452. package/dist/vendor/d3-array/src/rank.js +24 -0
  453. package/dist/vendor/d3-array/src/reduce.js +14 -0
  454. package/dist/vendor/d3-array/src/reverse.js +4 -0
  455. package/dist/vendor/d3-array/src/scan.js +6 -0
  456. package/dist/vendor/d3-array/src/shuffle.js +13 -0
  457. package/dist/vendor/d3-array/src/some.js +10 -0
  458. package/dist/vendor/d3-array/src/sort.js +39 -0
  459. package/dist/vendor/d3-array/src/subset.js +5 -0
  460. package/dist/vendor/d3-array/src/sum.js +18 -0
  461. package/dist/vendor/d3-array/src/superset.js +19 -0
  462. package/dist/vendor/d3-array/src/threshold/freedmanDiaconis.js +7 -0
  463. package/dist/vendor/d3-array/src/threshold/scott.js +7 -0
  464. package/dist/vendor/d3-array/src/threshold/sturges.js +5 -0
  465. package/dist/vendor/d3-array/src/ticks.js +55 -0
  466. package/dist/vendor/d3-array/src/transpose.js +15 -0
  467. package/dist/vendor/d3-array/src/union.js +11 -0
  468. package/dist/vendor/d3-array/src/variance.js +25 -0
  469. package/dist/vendor/d3-array/src/zip.js +5 -0
  470. package/dist/vendor/internmap/src/index.js +61 -0
  471. package/dist/vendor/manifest.json +11 -0
  472. package/llms.txt +20 -0
  473. package/package.json +64 -4
package/CLAUDE.md ADDED
@@ -0,0 +1,111 @@
1
+ # @descix/frqtl-web
2
+
3
+ A discrete cellular-automata physics engine (compiled Rust → WASM) for realtime, emergent simulations
4
+ in the browser. Physics comes out of local per-pixel rules — a frame moves one pixel per tick, single
5
+ occupancy, momentum — rather than force equations or wave PDEs. Double-slit fringes, wave interference
6
+ and blackbody spectra are computed live from the automaton, not replayed.
7
+
8
+ Pre-release `0.6.0-p0.1` (npm dist-tag `next`). The node twin is `@descix/frqtl-node` (the same modules,
9
+ plus `bootNode` and the hosted eyes).
10
+
11
+ ## Install
12
+ npm install @descix/frqtl-web@next
13
+
14
+ ## See it run immediately
15
+ Open this URL, or embed it in a claude.ai artifact iframe (self-contained):
16
+
17
+ https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p0.1/dist/artifact/double-slit.html
18
+
19
+ and the one-file form (a `<script>` tag, global `FRQTL`) booting a 3D sun:
20
+
21
+ https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p0.1/dist/artifact/sun.html
22
+
23
+ ## A scene is a sketch
24
+ A scene is an ES module whose default export is `buildExperiment(exp)`. Its first statement is the
25
+ co-init call — `exp.createCanvas(w, h, cfg)` for a 2D world drawn by p5, `exp.createScene(w, h, d, cfg)`
26
+ for a 3D world drawn by three — the only place the world's size is written. It imports its parts from
27
+ `@descix/frqtl-web/parts`.
28
+
29
+ ```js
30
+ import { SphereEmitter } from '@descix/frqtl-web/parts';
31
+ export default function buildExperiment(exp) {
32
+ const SRC = { preset: 'spherical', emissionBoxSide: 0, is2D: false, chargeMode: 'random', fundamentalDimension: 2 };
33
+ exp.createScene(480, 480, 480, SphereEmitter.worldCfg(SRC));
34
+ exp.addObject('SphereEmitter', SRC);
35
+ }
36
+ ```
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`.
40
+
41
+ ## Boot it — the two doors (`@descix/frqtl-web/boot`)
42
+ bootScene(mount, buildExperiment, { renderer: 'p5' | 'three', seed, onTick, render })
43
+ → { runner, recipeContext, display } the sketch is an imported FUNCTION
44
+ bootProject(mount, { files: { 'sketch.js': text, 'parts/MyEmitter.js': text }, entry: 'sketch.js' }, { renderState, seed, onTick })
45
+ → { runner, recipeContext, display, retainedRenderRows }
46
+ bootProject(mount, { url: '<served folder>/', entry: 'sketch.js' }, opts)
47
+
48
+ A project's files import each other by relative specifiers (`./parts/MyEmitter.js`) and the package by
49
+ `@descix/frqtl-web/...`; an import that names no project file, or a cycle, is refused naming the file.
50
+ One boot per document (a second throws naming the re-scene door). Every load failure paints an overlay
51
+ in the mount and rejects. The runner's SceneRecord carries the project's identity (`projectIdentity`,
52
+ `./project`) as `sourceSha256`.
53
+
54
+ 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(…)`,
57
+ `FRQTL.Wall`, …
58
+
59
+ String kinds: `exp.addObject('Wall', props)` resolves the kind in the SCENE's realm (the frame the scene
60
+ runs in). A host that drives a scene in an iframe passes the string through that frame's `recipeContext`;
61
+ it never imports the registry into its own document, where no kind is registered.
62
+
63
+ ## Exports
64
+ | subpath | what |
65
+ |---|---|
66
+ | `.` | the parts (`Wall`, `SphereEmitter`, `Tunnel`, `FrqtlVision`, …), `bootScene`, `bootProject`, `engine`, `engineState`, `FrqtlCapture`, `RenderStages`, `FieldBuilder`, `CaptureEnvelope`, `validateRendererProvider` |
67
+ | `./boot` | `bootScene`, `bootProject` (in node it throws naming `@descix/frqtl-node`) |
68
+ | `./parts`, `./parts/*` | the parts barrel; one part = one file |
69
+ | `./project` | `FRQTL_WEB_SPECIFIERS`, `libPathOf`, `importMapFor`, `linkProject`, `projectIdentity` |
70
+ | `./registry` | the walk-through rungs, the showcase roster, the experiment registry, `loadSceneSource(id)` |
71
+ | `./kinds` | `registerKind`, `kindNamed`, `kindOf` (the parent's row, frozen), `registeredKinds` — a composed fork registers its renamed class |
72
+ | `./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`) |
73
+ | `./dist-manifest.json` | sha256 of every dist file (check a self-hosted copy against it) |
74
+ `dist/frqtl-web.min.js` is a file, not an export.
75
+
76
+ Self-hosting: serve an unmodified copy of `dist/` and import the doors from YOUR copy — every file a
77
+ module loads resolves relative to that module's own URL.
78
+
79
+ ## Eyes
80
+ `FrqtlCapture` and `FrqtlVision` (`runner.capture(stage)`, `FrqtlVision.attach(runner).getStill(stage)`,
81
+ `.record(opts)`) look through THIS page's own render stack. From node, the same composite comes from the
82
+ hosted eyes in `@descix/frqtl-node/eyes`.
83
+
84
+ No CLI ships with this package. FRQTL scenes are fractal and non-linear, so a static numeric check cannot
85
+ tell you a scene is right before you have drawn it — acceptance is visual: run a scene and look at it.
86
+
87
+ ## The physics model (enough to code against)
88
+ Three primitives: time = 1 tick, space = 1 pixel, mass = pixel occupancy.
89
+ Everything is a Frame (recursive); there is no separate "particle" class.
90
+
91
+ - A frame moves at most 1 pixel/tick per axis relative to its parent; excess
92
+ intended motion accumulates as momentum (this is the speed limit).
93
+ - Single occupancy: two quanta can't share a pixel; a failed placement is a
94
+ collision (bounce/merge), not a force.
95
+ - Interference fringes are the statistics of many discrete walks through the
96
+ slits — the pattern builds up from individual quanta, not a wave equation.
97
+ - Fullness (mass/capacity) sets two decoupled things: how often a frame steps
98
+ (its effective speed) and its oscillation wavelength
99
+ (wavelength = floor(capacity/mass × constant), minimum 4).
100
+ - `doTick()` runs a fixed pipeline (inject → structure → physics → collect) and
101
+ returns pure data; rendering is downstream.
102
+
103
+ ## What this is NOT
104
+ - Not a general PDE / force-integration physics library.
105
+ - Not a math library — that is the sibling package @descix/egpt-math-sdk.
106
+ - The published build is WASM-only on the engine side (compiled surface).
107
+
108
+ ## Curated notebooks
109
+ Index: `https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.0-p0.1/dist/notebooks/notebooks.json`
110
+
111
+ ## No account, credits, or tokens are needed for anything above.
package/README.md CHANGED
@@ -1,3 +1,95 @@
1
- # Temporary Holding Version
1
+ # @descix/frqtl-web
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ FRQTL for the browser: a discrete cellular-automata physics engine (compiled Rust → WASM). Physics
4
+ comes out of local per-pixel rules — a frame moves one pixel per tick, single occupancy, momentum —
5
+ rather than force equations. Interference, blackbody spectra and atom-like binding emerge from the
6
+ automaton.
7
+
8
+ Pre-release `0.6.0-p0.1` (npm dist-tag `next`). The node twin is `@descix/frqtl-node` — the same
9
+ modules, built from the same source.
10
+
11
+ ## Install
12
+
13
+ npm install @descix/frqtl-web@next
14
+
15
+ ## A scene, booted
16
+
17
+ ```js
18
+ import { bootScene } from '@descix/frqtl-web/boot';
19
+ import { SphereEmitter } from '@descix/frqtl-web/parts';
20
+
21
+ await bootScene('mount', function buildExperiment(exp) {
22
+ const SRC = { preset: 'spherical', emissionBoxSide: 0, is2D: false, chargeMode: 'random', fundamentalDimension: 2 };
23
+ exp.createScene(480, 480, 480, SphereEmitter.worldCfg(SRC)); // the world: the sketch's first statement
24
+ exp.addObject('SphereEmitter', SRC);
25
+ }, { renderer: 'three', render: { shape: 'sphere', godrays: 0.8 } });
26
+ ```
27
+
28
+ A sketch held as text — or a project with more files beside it — boots through `bootProject`:
29
+
30
+ ```js
31
+ import { bootProject } from '@descix/frqtl-web/boot';
32
+ await bootProject('mount', { files: { 'sketch.js': sketch, 'parts/MyEmitter.js': fork }, entry: 'sketch.js' });
33
+ ```
34
+
35
+ Project files import each other by relative specifiers and the package by a `@descix/frqtl-web/...`
36
+ row of `FRQTL_WEB_SPECIFIERS`. Before anything runs, `bootProject` refuses, naming the file and the
37
+ specifier: an import that names no project file, one that climbs out of the project, a package path
38
+ the table does not offer, a cycle, a served file that is not UTF-8. A served folder (`{ url, entry }`)
39
+ is fetched once per file, as bytes. The runner's SceneRecord carries the project's identity as
40
+ `sourceSha256`: `projectIdentity({ files })` over those BYTES, a BOM included (`linkProject` returns them
41
+ as `files`).
42
+
43
+ A fork of a part is a project file that extends the part and registers its renamed class — it imports only
44
+ public specifiers, so the same file resolves in every host:
45
+
46
+ ```js
47
+ // parts/MySphereEmitter.js
48
+ import { SphereEmitter } from '@descix/frqtl-web/parts';
49
+ import { registerKind, kindOf } from '@descix/frqtl-web/kinds';
50
+ export class MySphereEmitter extends SphereEmitter {}
51
+ const base = kindOf(SphereEmitter); // the parent's row, frozen
52
+ registerKind(MySphereEmitter, { from: import.meta.url, descriptor: base.descriptor, defaults: base.defaults, build: base.build });
53
+ ```
54
+
55
+ `exp.addObject('MySphereEmitter', props)` then builds it. A copy that keeps the parent's class name is refused,
56
+ naming both files. A verbatim copy of a package part FILE is refused by the linker: its imports name package
57
+ internals, which have no public specifier (that form arrives with the editor's fork door).
58
+
59
+ No build step: load `dist/frqtl-web.min.js` with a `<script>` tag and call `FRQTL.bootScene(…)`
60
+ (`FRQTL.Wall`, `FRQTL.SphereEmitter`, …). A min.js page owns only `FRQTL` (and the booted page's
61
+ `FrqtlPage` seam); bind parts however you like. A page that uses ES modules without a bundler renders its
62
+ import map from the package's own table: `importMapFor('<dist root URL>/')` (`./project`).
63
+
64
+ String kinds — `exp.addObject('Wall', props)` — resolve in the SCENE's realm. A host driving a scene in
65
+ an iframe passes the string through that frame's `recipeContext`; it never imports the kind registry
66
+ into its own document, where no kind is registered.
67
+
68
+ ## Exports
69
+
70
+ | subpath | what |
71
+ |---|---|
72
+ | `.` | the parts, `bootScene`, `bootProject`, `engine`, `engineState`, `FrqtlCapture`, `RenderStages`, `FieldBuilder`, `CaptureEnvelope`, `validateRendererProvider` |
73
+ | `./boot` | `bootScene`, `bootProject` (in node it throws, naming `@descix/frqtl-node`) |
74
+ | `./parts`, `./parts/*` | the parts barrel; one part = one file |
75
+ | `./project` | `FRQTL_WEB_SPECIFIERS`, `libPathOf`, `importMapFor`, `linkProject`, `projectIdentity` |
76
+ | `./registry` | the walk-through rungs, the showcase roster, the experiment registry, `loadSceneSource` |
77
+ | `./kinds` | `registerKind`, `kindNamed`, `kindOf`, `registeredKinds` — the kind registry a composed fork registers in |
78
+ | `./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`) |
79
+ | `./dist-manifest.json` | sha256 of every dist file |
80
+
81
+ `dist/frqtl-web.min.js` is a file, not an export. `dist/sdk.html` is the API reference.
82
+
83
+ Self-hosting: serve an unmodified copy of `dist/` and import from YOUR copy — every module loads its
84
+ imports relative to its own URL. Check the copy against `dist/dist-manifest.json`.
85
+
86
+ ## Acceptance is visual
87
+
88
+ There is no CLI. FRQTL scenes are fractal and non-linear: run a scene and look at it. A numeric score
89
+ is a design aid in your own harness, never the acceptance criterion.
90
+
91
+ ## Packaging
92
+
93
+ The npm payload is `dist/`, `README.md`, `CLAUDE.md` and `llms.txt`. No JS physics-engine source ships:
94
+ the engine is the compiled WASM build (`dist/fat/pkg-web/`), checked by
95
+ `sdk/_build/verify-publish-surface.mjs`.
@@ -0,0 +1,89 @@
1
+ <!DOCTYPE html>
2
+ <!-- Copyright 2023-2026 by Essam Abadir -->
3
+ <!-- FRQTL — claude.ai Artifact host shell (ws-artifact-showcase Bite A2).
4
+ Generated by lib/shim/engine/artifact-shell.js — DO NOT hand-edit.
5
+ Paste this ENTIRE file into a claude.ai chat as an Artifact (type: HTML). -->
6
+ <html lang="en">
7
+ <head>
8
+ <meta charset="UTF-8">
9
+ <meta name="viewport" content="width=device-width, initial-scale=1">
10
+ <title>FRQTL — Double-Slit (live)</title>
11
+ <style>
12
+ html,body{margin:0;padding:0;background:#0b0b0b;color:#c9c9c9;font-family:ui-monospace,Menlo,Consolas,monospace;}
13
+ #frqtl-status{text-align:center;font-size:12px;color:#888;padding:10px 0 4px;}
14
+ #frqtl-mount{width:fit-content;margin:0 auto 24px;position:relative;}
15
+ </style>
16
+ </head>
17
+ <body>
18
+ <div id="frqtl-status" data-role="frqtl-artifact-status">booting FRQTL…</div>
19
+ <div id="frqtl-mount" data-role="frqtl-artifact-mount"></div>
20
+ <script type="importmap">{"imports":{"@descix/frqtl-web/parts":"../frqtl/parts/index.js","@descix/frqtl-web/parts/":"../frqtl/parts/","@descix/frqtl-web/shim/controls/registry.js":"../shim/controls/registry.js","@descix/frqtl-web/shim/render/sun-look.js":"../shim/render/sun-look.js","@descix/frqtl-web/compat/renderer/display-slot.js":"../frqtl/compat/renderer/display-slot.js","@descix/frqtl-web/compat/renderer/orbit-bag.js":"../frqtl/compat/renderer/orbit-bag.js","@descix/frqtl-web/objects/setup/_collisionMatrixLanes.js":"../frqtl/objects/setup/_collisionMatrixLanes.js","@descix/frqtl-web/compat/engine.js":"../frqtl/compat/engine.js","@descix/frqtl-web/kinds":"../frqtl/objects/kinds-entry.js","@descix/frqtl-web/boot":"../frqtl/experiments/_shared/doors.js"}}</script>
21
+ <script>
22
+ /* BOOT DEADLINE — lib/shim/engine/artifact-shell.js ARTIFACT_BOOT_DEADLINE_MS. */
23
+ setTimeout(function () {
24
+ if (window.__frqtlLive) { return; }
25
+ var map = document.querySelector('script[type="importmap"]');
26
+ var min = document.querySelector('script[src$="frqtl-web.min.js"]');
27
+ var entry = min ? min.src : '(no import map)';
28
+ try { if (map) { entry = new URL(JSON.parse(map.textContent).imports['@descix/frqtl-web/boot'], document.baseURI).href; } } catch (e) { /* the message names the absence */ }
29
+ var msg = 'FRQTL BOOT TIMEOUT — not live after ' + (30000 / 1000) + ' s: the SDK entry ' + entry +
30
+ ' did not load, or its boot never reached a first tick.';
31
+ var el = document.getElementById('frqtl-status');
32
+ if (el) { el.textContent = msg; el.setAttribute('data-egpt-boot-timeout', '1'); }
33
+ if (window.console && console.error) { console.error('[frqtl-artifact]', msg); }
34
+ }, 30000);
35
+ </script>
36
+ <script type="module">
37
+ import { bootScene } from '@descix/frqtl-web/boot';
38
+ var statusEl = document.getElementById('frqtl-status');
39
+ var tickCount = 0;
40
+ /* Copyright 2023-2026 by Essam Abadir */
41
+
42
+ /**
43
+ * SCENE — Double slit (the SDK's artifact page)
44
+ *
45
+ * A sketch file: the WHOLE scene as one ES module, `export default function buildExperiment(exp)`. The world (its
46
+ * co-init call, `exp.createCanvas` — the one place its size is written), the parts and their order
47
+ * are all here; the sugar (SlitScreen, SlitLightSource, DetectorWall, LargeObject), the renderer
48
+ * and the engine are imports. Shipped as `dist/artifact/double-slit.html`: the generator
49
+ * (lib/shim/engine/artifact-shell.js, ARTIFACT_SCENE) embeds THIS file's text verbatim.
50
+ *
51
+ * The parts are setupDoubleSlit's at its defaults (slit screen at 1.5 λ, an absorbing start wall,
52
+ * the slit light source at a 10° step, the detector 3 λ past the screen), so the seeded run is
53
+ * that factory's, tick for tick (lib/shim/engine/test/artifact-shell-sketch.test.mjs holds it on
54
+ * the WASM engine). Zero new physics.
55
+ */
56
+
57
+ import { CollisionTypes, DetectorWall, LargeObject, SlitLightSource, SlitScreen } from '@descix/frqtl-web/parts';
58
+
59
+ export default function buildExperiment(exp) {
60
+ var S = 480, WAVELENGTH = 64; // THE WORLD this scene states (its co-init call below) and its one geometry knob
61
+
62
+ exp.createCanvas(S, S, { dimension: 2, wavelengthScale: Math.floor(WAVELENGTH / 16) }); // a 2D canvas + universe, S x S
63
+ var u = exp.universe;
64
+
65
+ var slits = new SlitScreen(u, WAVELENGTH * 1.5, WAVELENGTH, S, WAVELENGTH, true, 1);
66
+ new LargeObject(u, [0, 0, 10, S], CollisionTypes.ABSORB, [], 'start_wall', 'closest', null, 1, [120, 120, 120]);
67
+ var light = new SlitLightSource(u, slits, 10);
68
+ new DetectorWall(u, u.universe_rect, slits.wall1.rect.left + slits.wall1.rect.w + 3 * WAVELENGTH);
69
+ u.experimentTickFunctions.push(light.getTickFunction());
70
+ }
71
+ bootScene('frqtl-mount', buildExperiment, {
72
+ seed: 42,
73
+ onTick: function () {
74
+ tickCount++;
75
+ if (tickCount % 20 === 0) {
76
+ statusEl.textContent = 'FRQTL double-slit — live — tick ' + tickCount;
77
+ }
78
+ }
79
+ }).then(function () {
80
+ window.__frqtlLive = true;
81
+ statusEl.textContent = 'FRQTL double-slit — live';
82
+ }).catch(function (err) {
83
+ window.__frqtlLive = true; // failed LOUDLY already — the deadline has nothing to add
84
+ statusEl.textContent = 'FRQTL boot FAILED — see overlay below.';
85
+ if (window.console && console.error) { console.error('[frqtl-artifact]', err); }
86
+ });
87
+ </script>
88
+ </body>
89
+ </html>
@@ -0,0 +1,81 @@
1
+ <!DOCTYPE html>
2
+ <!-- Copyright 2023-2026 by Essam Abadir -->
3
+ <!-- FRQTL — bootScene self-contained scene page (a spherical "sun").
4
+ Authored at sdk/frqtl-web/src/artifact/sun.html; written to dist/artifact/sun.html by
5
+ sdk/frqtl-web/build.js (the build places its relative URLs: sdk/_build/lib-dist-placement.cjs
6
+ placePageHtml).
7
+
8
+ It boots through frqtl-web.min.js, the one-file form of the package (global FRQTL), served from the
9
+ SAME dist as this page: the bundle locates every engine, renderer and vendor file relative to the
10
+ URL it was loaded from.
11
+
12
+ The scene is a SKETCH, buildExperiment(exp): its first statement, exp.createScene, states the world
13
+ (a 480-cube, drawn by three); the mount takes its size from the canvas that call creates. -->
14
+ <html lang="en">
15
+ <head>
16
+ <meta charset="UTF-8">
17
+ <meta name="viewport" content="width=device-width, initial-scale=1">
18
+ <title>FRQTL — Sun (bootScene / SphereEmitter)</title>
19
+ <style>
20
+ html,body{margin:0;padding:0;background:#050507;color:#c9c9c9;font-family:ui-monospace,Menlo,Consolas,monospace;}
21
+ #frqtl-status{text-align:center;font-size:12px;color:#888;padding:10px 0 4px;}
22
+ #frqtl-mount{width:fit-content;margin:0 auto 24px;position:relative;}
23
+ </style>
24
+ </head>
25
+ <body>
26
+ <div id="frqtl-status" data-role="frqtl-scene-status">booting FRQTL sun…</div>
27
+ <div id="frqtl-mount" data-role="frqtl-scene-mount"></div>
28
+ <script src="../frqtl-web.min.js"></script>
29
+ <script>
30
+ /* BOOT DEADLINE — lib/shim/engine/artifact-shell.js ARTIFACT_BOOT_DEADLINE_MS. */
31
+ setTimeout(function () {
32
+ if (window.__frqtlLive) { return; }
33
+ var map = document.querySelector('script[type="importmap"]');
34
+ var min = document.querySelector('script[src$="frqtl-web.min.js"]');
35
+ var entry = min ? min.src : '(no import map)';
36
+ try { if (map) { entry = new URL(JSON.parse(map.textContent).imports['@descix/frqtl-web/boot'], document.baseURI).href; } } catch (e) { /* the message names the absence */ }
37
+ var msg = 'FRQTL BOOT TIMEOUT — not live after ' + (30000 / 1000) + ' s: the SDK entry ' + entry +
38
+ ' did not load, or its boot never reached a first tick.';
39
+ var el = document.getElementById('frqtl-status');
40
+ if (el) { el.textContent = msg; el.setAttribute('data-egpt-boot-timeout', '1'); }
41
+ if (window.console && console.error) { console.error('[frqtl-artifact]', msg); }
42
+ }, 30000);
43
+ </script>
44
+
45
+ <script>
46
+ var SphereEmitter = FRQTL.SphereEmitter;
47
+
48
+ var statusEl = document.getElementById('frqtl-status');
49
+ var tickCount = 0;
50
+
51
+ // The sun — a 3D omni POINT source: a spherical SphereEmitter at the centre of a 480-cube.
52
+ var SRC = {
53
+ preset: 'spherical', emissionBoxSide: 0, is2D: false,
54
+ chargeMode: 'random', fundamentalDimension: 2
55
+ };
56
+ FRQTL.bootScene('frqtl-mount', function buildExperiment(exp) {
57
+ exp.createScene(480, 480, 480, SphereEmitter.worldCfg(SRC)); // THE WORLD: a 3D scene + universe, 480 x 480 x 480
58
+ exp.addObject('SphereEmitter', SRC);
59
+ }, {
60
+ renderer: 'three',
61
+ seed: 42,
62
+ render: { shape: 'sphere', godrays: 0.8, glowIntensity: 1.6 },
63
+ onTick: function () {
64
+ tickCount++;
65
+ if (tickCount % 20 === 0) {
66
+ statusEl.textContent = 'FRQTL sun — live — tick ' + tickCount;
67
+ }
68
+ }
69
+ }).then(function (scene) {
70
+ window.__frqtlLive = true;
71
+ statusEl.textContent = 'FRQTL sun — live';
72
+ // Expose for realm assertions (Playwright): tweak render options live.
73
+ window.__frqtlScene = scene;
74
+ }).catch(function (err) {
75
+ window.__frqtlLive = true; // failed LOUDLY already — the deadline has nothing to add
76
+ statusEl.textContent = 'FRQTL sun boot FAILED — see overlay below.';
77
+ if (window.console && console.error) { console.error('[frqtl-sun]', err); }
78
+ });
79
+ </script>
80
+ </body>
81
+ </html>
@@ -0,0 +1,24 @@
1
+ /* Copyright 2023-2026 by Essam Abadir */
2
+
3
+ /**
4
+ * boot/node-refusal.js — the NODE condition of @descix/frqtl-web's `./boot`.
5
+ *
6
+ * `./boot` is the page's scene doors (bootScene / bootProject mount into a DOM element and boot a
7
+ * renderer). In node there is no page to boot, so this module THROWS on load, naming the right door —
8
+ * a refusal, not a missing feature: a silent no-op would hand a consumer a page that never renders.
9
+ */
10
+
11
+ throw new Error(
12
+ '[frqtl-web/boot] `@descix/frqtl-web/boot` is a BROWSER-HOST surface and this is node.\n' +
13
+ '\n' +
14
+ 'bootScene / bootProject mount into a DOM element and boot a page\'s renderer —\n' +
15
+ 'there is no page here to boot.\n' +
16
+ '\n' +
17
+ 'THE RIGHT PACKAGE IN NODE is @descix/frqtl-node:\n' +
18
+ ' import { bootNode, Wall, SphereEmitter, FrqtlVision } from \'@descix/frqtl-node\';\n' +
19
+ ' — bootNode() boots the WASM engine; the parts and the headless eyes (the tick and field\n' +
20
+ ' stages need no canvas) are the same modules. For a `composite` still through the REAL\n' +
21
+ ' renderer, drive a real browser FROM node: import { openHostedEyes } from \'@descix/frqtl-node/eyes\'.\n' +
22
+ '\n' +
23
+ '(FAIL-LOUD.)'
24
+ );