@descix/frqtl-web 0.6.1-p3.4 → 0.6.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 (47) hide show
  1. package/CLAUDE.md +11 -13
  2. package/LICENSE.md +63 -79
  3. package/README.md +7 -9
  4. package/dist/artifact/double-slit.html +1 -1
  5. package/dist/dist-manifest.json +37 -42
  6. package/dist/frqtl/compat/providers/wasm-load-browser.js +1 -2
  7. package/dist/frqtl/compat/renderer/providers/godrays-layer.js +12 -301
  8. package/dist/frqtl/compat/renderer/providers/p5-provider.js +0 -6
  9. package/dist/frqtl/compat/renderer/providers/three-provider.js +17 -66
  10. package/dist/frqtl/objects/FrqtlApp.js +1 -17
  11. package/dist/frqtl/objects/RecipeContext.js +41 -38
  12. package/dist/frqtl/objects/objects/QuantumEmitter.js +1 -1
  13. package/dist/frqtl/objects/objects/sustainedSource.js +2 -2
  14. package/dist/frqtl/objects/record/Record.js +9 -4
  15. package/dist/frqtl/objects/setup/setupConeEmitter3D.js +3 -3
  16. package/dist/frqtl/objects/setup/setupSphereEmitter3D.js +6 -8
  17. package/dist/frqtl/parts/FrqtlVision.js +27 -158
  18. package/dist/frqtl/parts/GraphingDetectorWall.js +1 -1
  19. package/dist/frqtl/parts/LiveChart.js +1 -1
  20. package/dist/frqtl/parts/SphereEmitter.js +2 -2
  21. package/dist/frqtl/parts/Tunnel.js +1 -1
  22. package/dist/frqtl/parts/Wall.js +10 -97
  23. package/dist/frqtl/scenes/dse-tunnel-rebuild.js +22 -33
  24. package/dist/frqtl/scenes/mirror-route.js +6 -10
  25. package/dist/frqtl-web.min.js +51 -56
  26. package/dist/notebooks/notebooks.json +1 -1
  27. package/dist/sdk.html +2 -3
  28. package/dist/shim/controls/index.js +2 -2
  29. package/dist/shim/engine/router.js +30 -49
  30. package/dist/shim/field-descriptor/index.js +5 -5
  31. package/dist/shim/host/host-view.js +10 -7
  32. package/dist/shim/host/index.js +1 -2
  33. package/dist/shim/project/index.js +3 -13
  34. package/dist/shim/project/record-format.js +4 -96
  35. package/dist/shim/project/specifiers.js +3 -5
  36. package/dist/shim/registry/exhibits.js +11 -11
  37. package/dist/shim/registry/index.js +0 -6
  38. package/dist/shim/registry/walkthrough.js +90 -38
  39. package/dist/shim/render/capture-envelope.js +0 -21
  40. package/dist/shim/render/sun-look.js +11 -6
  41. package/llms.txt +8 -9
  42. package/package.json +2 -3
  43. package/dist/shim/engine/site-graph.js +0 -184
  44. package/dist/shim/host/device.js +0 -42
  45. package/dist/shim/project/parts-spelling.js +0 -77
  46. package/dist/shim/registry/showcase-link.js +0 -61
  47. package/dist/shim/registry/studio-landing.js +0 -70
@@ -1,61 +0,0 @@
1
- /* Copyright 2023-2026 by Essam Abadir */
2
-
3
- /**
4
- * showcase-link.js — the ONE writer of a showcase tile's link: where a roster row opens on the site that serves
5
- * the IDE. Every front page (the publisher sites, Gods World) composes its tile hrefs from these two names and types
6
- * no query, page or origin of its own.
7
- *
8
- * showcaseHref(row) → 'app.html?preset=author&walkthrough=<id>[&mode=<mode>]', relative to the serving site's root:
9
- * the IDE entry page (site-graph.js::STATIC_APP_PAGE) opened on STUDIO at the row's rung. `mode`
10
- * is the row's EFFECTIVE mode (exhibits.js normalizes it: on a multi-mode rung the mode the row
11
- * names, else the rung's default; null on a single-mode rung, which carries no `mode`), so the
12
- * link opens the mode the tile's still shows.
13
- * showcaseUrl(row) → the same link, absolute on SHOWCASE_SITE.origin: what a front page on ANY other origin uses.
14
- * Whether a page links relative (it is the serving site) or absolute is the page's own fact.
15
- * SHOWCASE_SITE → { app, origin } — the DeSciX app that serves the IDE and its public origin.
16
- *
17
- * `row` must be an element of the EXHIBITS array imported from the SAME module instance (the ./registry export):
18
- * a copied, JSON-deserialized or second-copy row is refused, loudly.
19
- *
20
- * It writes no IDE state: the query is a link, read by the one parser (lib/features/ide/deep-link.js::parseDeepLink).
21
- * The shim cannot import that parser (shim → features is illegal), so the binding is a round-trip conformance test
22
- * in lib/features/ide/test/showcase-link-round-trip.test.mjs: for every EXHIBITS row the parsed link shows STUDIO,
23
- * names the row's rung and mode, and is refused by nothing.
24
- *
25
- * Host-neutral ESM: it runs unchanged in node and in a page (the `./registry` export).
26
- */
27
-
28
- import { STATIC_APP_PAGE } from '../engine/site-graph.js';
29
- import { EXHIBITS } from './exhibits.js';
30
-
31
- /** The IDE surface a showcase tile opens: STUDIO (presets.js PRESETS.author; the round-trip test binds the two). */
32
- const SHOWCASE_SURFACE = 'author';
33
-
34
- /** The DeSciX app serving the IDE every showcase tile opens, and its public origin (no trailing slash). */
35
- export const SHOWCASE_SITE = Object.freeze({ app: 'egpt-frqtl', origin: 'https://egpt-frqtl.descix.net' });
36
-
37
- /**
38
- * @param {object} row an element of EXHIBITS (exhibits.js)
39
- * @returns {string} the tile's link, relative to the serving site's root
40
- * @throws {Error} a row that is not on the roster
41
- */
42
- export function showcaseHref(row) {
43
- if (EXHIBITS.indexOf(row) === -1) {
44
- throw new Error('[showcase-link] showcaseHref(row): not a showcase roster row — pass an element of EXHIBITS ' +
45
- '(lib/shim/registry/exhibits.js), got ' + JSON.stringify(row && { kind: row.kind, id: row.id }) + '. (FAIL-LOUD.)');
46
- }
47
- const params = new URLSearchParams();
48
- params.set('preset', SHOWCASE_SURFACE);
49
- params.set('walkthrough', row.id);
50
- if (row.mode !== null) { params.set('mode', row.mode); }
51
- return STATIC_APP_PAGE + '?' + params.toString();
52
- }
53
-
54
- /**
55
- * @param {object} row an element of EXHIBITS (exhibits.js), from the same module instance
56
- * @returns {string} the tile's link, absolute on SHOWCASE_SITE.origin
57
- * @throws {Error} a row that is not on the roster
58
- */
59
- export function showcaseUrl(row) {
60
- return new URL(showcaseHref(row), SHOWCASE_SITE.origin + '/').href;
61
- }
@@ -1,70 +0,0 @@
1
- /* Copyright 2023-2026 by Essam Abadir */
2
-
3
- /**
4
- * studio-landing.js — the ONE record of how STUDIO resolved the deep link it opened with, as host-view.js records
5
- * its view outcome: STUDIO's resolver (lib/features/ide/studio-landing-of.js::studioLandingOf) decides the row and
6
- * AuthorView.jsx writes it on `document.documentElement` under STUDIO_LANDING_ATTR, through recordStudioLanding,
7
- * and a gate that opens a link (a showcase tile, showcase-link.js) reads that attribute instead of STUDIO's DOM or
8
- * its error copy.
9
- *
10
- * STUDIO_LANDING_ATTR the <html> attribute carrying the outcome id
11
- * STUDIO_LANDING_OUTCOMES the closed table: one row per branch of STUDIO's link resolution, `{ id, runs, means }`;
12
- * `runs` says whether the scene that landing opens starts on load (through STUDIO's Run
13
- * control's own path) — true only on `ok`, a deep link that named a scene; every other
14
- * landing opens its scene in Design, waiting for Run
15
- * recordStudioLanding(root, id) writes `id` on `root` (an Element, or null to only validate); an id outside the
16
- * table THROWS — that is a defect in the writer, never a landing
17
- *
18
- * The rows are the branches the resolution already takes, no more: the link's keys are read by the one parser
19
- * (lib/features/ide/deep-link.js) and the refusal of a key STUDIO does not own is its deepLinkRefusalOf. `ok` says the
20
- * linked scene RESOLVED and was handed to STUDIO's selection path; whether that scene then boots is the boot record's
21
- * business (boot-phases.js), not this one's.
22
- *
23
- * Lives in the registry, published by `./registry`: the outcome is the landing of the link showcaseHref writes, so a
24
- * gate following a tile takes both from one module instance; the parser's own home (lib/features) has no package
25
- * door, and shim may not import features.
26
- *
27
- * Host-neutral ESM with no imports: it runs unchanged in node and in a page.
28
- */
29
-
30
- /** The <html> attribute STUDIO records its deep-link landing on. */
31
- export const STUDIO_LANDING_ATTR = 'data-frqtl-studio-landing';
32
-
33
- /** The closed table of STUDIO deep-link landings, in the order the resolver tests them (lib/features/ide/test/studio-landing-of.test.mjs holds it). */
34
- export const STUDIO_LANDING_OUTCOMES = Object.freeze([
35
- { id: 'refused-key', runs: false,
36
- means: 'the link carries a key STUDIO does not own, or a deleted key (deep-link.js deepLinkRefusalOf): the refusal is on the deep-link strip and the opening rung opens' },
37
- { id: 'conflict', runs: false,
38
- means: 'the link names both a walkthrough and a saved project: nothing opens' },
39
- { id: 'mode-without-walkthrough', runs: false,
40
- means: 'the link names a mode and no walkthrough: nothing opens' },
41
- { id: 'unknown-walkthrough', runs: false,
42
- means: 'the linked walkthrough is not in the walkthrough registry (walkthroughById): nothing opens' },
43
- { id: 'unknown-mode', runs: false,
44
- means: 'the linked mode is not one the linked rung declares (walkthroughModes): nothing opens' },
45
- { id: 'project-unreadable', runs: false,
46
- means: 'the linked saved project is present but its folder is refused by the load: nothing opens' },
47
- { id: 'project-not-found', runs: false,
48
- means: 'no saved project of the linked name in this browser: nothing opens' },
49
- { id: 'ok', runs: true,
50
- means: 'the linked walkthrough (in the linked mode, else its default) or saved project resolved and was handed to STUDIO\'s selection path; the scene starts on load' },
51
- { id: 'first-contact', runs: false,
52
- means: 'no STUDIO deep link: the walkthrough registry\'s opening rung opens' },
53
- ].map(Object.freeze));
54
-
55
- const IDS = new Set(STUDIO_LANDING_OUTCOMES.map((r) => r.id));
56
-
57
- /**
58
- * @param {Element|null} root the document element STUDIO runs in (null: validate only)
59
- * @param {string} id a STUDIO_LANDING_OUTCOMES id
60
- * @returns {string} id
61
- * @throws {Error} an id the table does not list
62
- */
63
- export function recordStudioLanding(root, id) {
64
- if (!IDS.has(id)) {
65
- throw new Error('[studio-landing] \'' + id + '\' is not a STUDIO_LANDING_OUTCOMES row — declared: [' +
66
- [...IDS].join(', ') + ']. (FAIL-LOUD.)');
67
- }
68
- if (root) { root.setAttribute(STUDIO_LANDING_ATTR, id); }
69
- return id;
70
- }