@descix/frqtl-web 0.6.0 → 0.6.1-p1.2
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.
- package/CLAUDE.md +10 -9
- package/LICENSE.md +79 -63
- package/README.md +6 -4
- package/dist/artifact/double-slit.html +1 -1
- package/dist/dist-manifest.json +11 -9
- package/dist/frqtl-web.min.js +1 -1
- package/dist/sdk.html +1 -1
- package/dist/shim/engine/router.js +10 -17
- package/dist/shim/engine/site-graph.js +36 -0
- package/dist/shim/host/host-view.js +6 -2
- package/dist/shim/project/specifiers.js +5 -3
- package/dist/shim/registry/exhibits.js +1 -1
- package/dist/shim/registry/index.js +3 -0
- package/dist/shim/registry/showcase-link.js +61 -0
- package/llms.txt +8 -7
- package/package.json +3 -2
|
@@ -35,6 +35,10 @@
|
|
|
35
35
|
|
|
36
36
|
'use strict';
|
|
37
37
|
|
|
38
|
+
// The static site's shape (graph dir, build stamp, build id, entry page) — owned by site-graph.js, imported from
|
|
39
|
+
// there by every consumer; the router uses them and does not re-export them.
|
|
40
|
+
import { SITE_GRAPH_DIR, SITE_BUILD_ATTR, SITE_BUILD_ID_RE, STATIC_APP_PAGE } from './site-graph.js';
|
|
41
|
+
|
|
38
42
|
// ── Path profiles ────────────────────────────────────────────────────────────
|
|
39
43
|
//
|
|
40
44
|
// Each profile maps a frqtl-relative prefix → URL prefix.
|
|
@@ -148,7 +152,7 @@ var DIST_PROFILE = buildDistProfile('../..');
|
|
|
148
152
|
// lib/shim/engine/test/router.test.mjs asserts them against the two
|
|
149
153
|
// package.json#version fields so a forgotten bump fails `make verify`, not a
|
|
150
154
|
// silent stale-CDN-URL bug.
|
|
151
|
-
var CDN_SDK_VERSION = '0.6.
|
|
155
|
+
var CDN_SDK_VERSION = '0.6.1-p1.2'; // sdk/frqtl-web/package.json#version (the ONE version owner) — bound by router.test.mjs
|
|
152
156
|
var CDN_MATH_SDK_VERSION = '0.3.2'; // sdk/egpt-math-sdk/package.json#version — bound by router.test.mjs; bumped with each npm publish
|
|
153
157
|
|
|
154
158
|
/**
|
|
@@ -302,15 +306,9 @@ function buildStaticProfile(graphBase, entryBase) {
|
|
|
302
306
|
};
|
|
303
307
|
}
|
|
304
308
|
|
|
305
|
-
// The static site's sdk directory, relative to the site's document.
|
|
306
|
-
//
|
|
307
|
-
var STATIC_SDK_DIR = './
|
|
308
|
-
|
|
309
|
-
// The <html> attribute carrying the static site's build id — the cross-repo contract
|
|
310
|
-
// (egpt-frqtl scripts/refresh-site.sh reads it). Every reader and writer names it through here.
|
|
311
|
-
var SITE_BUILD_ATTR = 'data-frqtl-site-build';
|
|
312
|
-
// A build id: the 8-hex-digit short sha of the commit the bundle was built from.
|
|
313
|
-
var SITE_BUILD_ID_RE = /^[0-9a-f]{8}$/;
|
|
309
|
+
// The static site's sdk directory, relative to the site's document (site-graph.js::SITE_GRAPH_DIR);
|
|
310
|
+
// the entries sit directly in it, the graph under its build-stamped child.
|
|
311
|
+
var STATIC_SDK_DIR = './' + SITE_GRAPH_DIR;
|
|
314
312
|
|
|
315
313
|
/**
|
|
316
314
|
* The validated build id, or a thrown error naming what was supplied.
|
|
@@ -381,11 +379,6 @@ function documentSiteBuild() {
|
|
|
381
379
|
return assertSiteBuildId(attr);
|
|
382
380
|
}
|
|
383
381
|
|
|
384
|
-
// The static IDE bundle's entry document, beside its front page. The bundle ships THIS name and no
|
|
385
|
-
// index.html: a site's index.html is the publisher's front page (lib/shim/host/host-view.js::HOST_FRONT_PAGE),
|
|
386
|
-
// which the IDE brand links home to.
|
|
387
|
-
var STATIC_APP_PAGE = 'app.html';
|
|
388
|
-
|
|
389
382
|
// The static IDE bundle's own chunk directory (vite assetsDir), relative to the document. Not
|
|
390
383
|
// `assets/`: the DeSciX platform routes `/assets/` on an app subdomain to app MEDIA, not the site.
|
|
391
384
|
var STATIC_APP_ASSETS_DIR = 'app-assets';
|
|
@@ -507,7 +500,7 @@ var _assertProfileParity = (function () {
|
|
|
507
500
|
* // CDN mode (static hosting — the artifact host shell has no server, no page anchor):
|
|
508
501
|
* const cdnRouter = engineRouter({ mode: 'cdn', engine: 'wasm' });
|
|
509
502
|
* console.log(cdnRouter.resolve('compat/engine.js'));
|
|
510
|
-
* // 'https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.
|
|
503
|
+
* // 'https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.1-p1.2/dist/frqtl/compat/engine.js'
|
|
511
504
|
*
|
|
512
505
|
* // CDN mode, self-hosted: a copy of dist/ served from the consumer's own origin:
|
|
513
506
|
* const selfHosted = engineRouter({ mode: 'cdn', engine: 'wasm', base: 'https://example.org/vendor/frqtl-web/dist' });
|
|
@@ -687,4 +680,4 @@ export function engineRouter(opts) {
|
|
|
687
680
|
|
|
688
681
|
|
|
689
682
|
// Export profiles for the sdk build to consume.
|
|
690
|
-
export { LIB_IDENTITY_PREFIXES, DEV_CORE_PROFILE, DIST_PROFILE, CDN_PROFILE, STATIC_SDK_DIR,
|
|
683
|
+
export { LIB_IDENTITY_PREFIXES, DEV_CORE_PROFILE, DIST_PROFILE, CDN_PROFILE, STATIC_SDK_DIR, STATIC_APP_ASSETS_DIR, STATIC_HOST_VIEW_ENTRY, CDN_SDK_VERSION, CDN_MATH_SDK_VERSION, CDN_BASE, cdnDistBaseFor, CDN_MATH_BASE, buildCdnProfile, buildDistProfile, buildStaticProfile, staticGraphDir, staticSdkBase, staticEntryBase };
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/* Copyright 2023-2026 by Essam Abadir */
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* site-graph.js — the shape of a static FRQTL site: the names a site's documents carry and the
|
|
5
|
+
* directory its build-stamped graph sits in. The ONE owner and the ONE import door of each: lib/shim/engine/router.js
|
|
6
|
+
* and every other consumer import them from here (the router never re-exports them), and a node consumer that reads a SERVED
|
|
7
|
+
* site (a publisher's gate) imports them through the package export `@descix/frqtl-web/site-graph`
|
|
8
|
+
* (or `@descix/frqtl-node/site-graph`), never typing them.
|
|
9
|
+
*
|
|
10
|
+
* SITE_GRAPH_DIR 'pub' — the site directory holding the fixed entries and, under
|
|
11
|
+
* SITE_GRAPH_DIR/<build>/, the build-stamped module graph
|
|
12
|
+
* SITE_BUILD_ATTR the <html> attribute of the IDE document carrying <build>
|
|
13
|
+
* SITE_BUILD_ID_RE a <build>: the 8-hex-digit short sha of the commit the bundle was built from
|
|
14
|
+
* STATIC_APP_PAGE the IDE bundle's entry document, beside the publisher's front page
|
|
15
|
+
* SITE_GRAPH_EXPORTS the published names (the parity gate holds both packages' ./site-graph to this table)
|
|
16
|
+
*
|
|
17
|
+
* Host-neutral ESM with no imports: it loads unchanged in node and in a page.
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
/** The names `./site-graph` publishes. */
|
|
21
|
+
export const SITE_GRAPH_EXPORTS = Object.freeze(['SITE_GRAPH_DIR', 'SITE_BUILD_ATTR', 'SITE_BUILD_ID_RE', 'STATIC_APP_PAGE']);
|
|
22
|
+
|
|
23
|
+
/** The static site's graph directory name (the entries sit in it, the graph under its build-stamped child). */
|
|
24
|
+
export const SITE_GRAPH_DIR = 'pub';
|
|
25
|
+
|
|
26
|
+
/** The <html> attribute carrying the static site's build id — the cross-repo contract. */
|
|
27
|
+
export const SITE_BUILD_ATTR = 'data-frqtl-site-build';
|
|
28
|
+
|
|
29
|
+
/** A build id: the 8-hex-digit short sha of the commit the bundle was built from. */
|
|
30
|
+
export const SITE_BUILD_ID_RE = /^[0-9a-f]{8}$/;
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* The static IDE bundle's entry document, beside its front page. The bundle ships THIS name and no
|
|
34
|
+
* index.html: a site's index.html is the publisher's front page (lib/shim/host/host-view.js::HOST_FRONT_PAGE).
|
|
35
|
+
*/
|
|
36
|
+
export const STATIC_APP_PAGE = 'app.html';
|
|
@@ -42,7 +42,7 @@ export const HOST_SDK_SCRIPT = 'DeSciXAppSDK.js';
|
|
|
42
42
|
export const HOST_PROVIDED_ATTR = 'data-frqtl-host-provided';
|
|
43
43
|
|
|
44
44
|
/**
|
|
45
|
-
* The publisher's front page, beside the IDE entry (
|
|
45
|
+
* The publisher's front page, beside the IDE entry (site-graph.js::STATIC_APP_PAGE). PUBLISHER-provided
|
|
46
46
|
* like HOST_SDK_SCRIPT: the static build declares it once as `<link rel="home" href=HOST_FRONT_PAGE
|
|
47
47
|
* HOST_PROVIDED_ATTR>` (apps/ide/vite.config.js), the bundle gate asserts the bundle does not ship
|
|
48
48
|
* it, and lib/features/ide/home-link.js::homeHrefOf reads the declaration back.
|
|
@@ -83,7 +83,7 @@ export const CONTRACT_VIOLATIONS = Object.freeze({
|
|
|
83
83
|
'view-no-available': Object.freeze({ setCalls: 0, means: 'view has no available() function' }),
|
|
84
84
|
'view-no-set': Object.freeze({ setCalls: 0, means: 'view has no set() function' }),
|
|
85
85
|
'available-threw': Object.freeze({ setCalls: 0, means: 'view.available() threw' }),
|
|
86
|
-
'view-no-modes': Object.freeze({ setCalls: 0, means: 'a fallback was given but view.MODES is not published' }),
|
|
86
|
+
'view-no-modes': Object.freeze({ setCalls: 0, means: 'a fallback was given but view.MODES is not published as the contract\'s object (absent, or an array)' }),
|
|
87
87
|
'set-threw': Object.freeze({ setCalls: 1, means: 'view.set(mode) threw (or view.set(fallback), the mode view.MODES offered)' }),
|
|
88
88
|
'set-returned-other': Object.freeze({ setCalls: 1, means: 'view.set(mode) returned something other than the mode it was asked for' }),
|
|
89
89
|
});
|
|
@@ -191,6 +191,10 @@ export async function declareHostView({ sdk, mode, fallback, root } = {}) {
|
|
|
191
191
|
if (!modes || typeof modes !== 'object') {
|
|
192
192
|
return violated(target, 'view-no-modes', 'fallback given but view.MODES is not published (got ' + String(modes) + ')');
|
|
193
193
|
}
|
|
194
|
+
if (Array.isArray(modes)) {
|
|
195
|
+
return violated(target, 'view-no-modes', 'fallback given but view.MODES is an array ([' + modes.join(', ') + ']), ' +
|
|
196
|
+
'not the published { NAME: mode } object');
|
|
197
|
+
}
|
|
194
198
|
const offered = Object.values(modes);
|
|
195
199
|
const list = '[' + offered.join(', ') + ']';
|
|
196
200
|
if (!offered.includes(mode)) {
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
* stay prefixes. No filesystem computation, so a vendored dist root
|
|
21
21
|
* takes the same call.
|
|
22
22
|
* FRQTL_WEB_HOST_SPECIFIERS rows { specifier, libPath, why } a HOST PAGE imports and a sketch never does:
|
|
23
|
-
* ./boot (FRQTL_WEB_BOOT, the scene doors), ./registry and ./
|
|
23
|
+
* ./boot (FRQTL_WEB_BOOT, the scene doors), ./registry, ./project, ./host-view and ./site-graph. libPathOf
|
|
24
24
|
* refuses every one of them, so a sketch cannot boot a page.
|
|
25
25
|
* pageImportMapFor(libRootUrl) → importMapFor(libRootUrl) plus every FRQTL_WEB_HOST_SPECIFIERS row: the map
|
|
26
26
|
* of a page that boots a scene through the doors and runs sketches beside it.
|
|
@@ -103,11 +103,13 @@ export const FRQTL_WEB_BOOT = Object.freeze({ specifier: '@descix/frqtl-web/boot
|
|
|
103
103
|
export const FRQTL_WEB_HOST_SPECIFIERS = Object.freeze([
|
|
104
104
|
FRQTL_WEB_BOOT,
|
|
105
105
|
Object.freeze({ specifier: '@descix/frqtl-web/registry', libPath: 'shim/registry/index.js',
|
|
106
|
-
why: 'the walk-through rungs, the showcase roster, the scene list (sceneGroups), projectOf' }),
|
|
106
|
+
why: 'the walk-through rungs, the showcase roster, the scene list (sceneGroups), projectOf, showcaseHref + showcaseUrl + SHOWCASE_SITE' }),
|
|
107
107
|
Object.freeze({ specifier: '@descix/frqtl-web/project', libPath: 'shim/project/index.js',
|
|
108
108
|
why: 'the specifier table, the link site, sketchProject and the project identity' }),
|
|
109
109
|
Object.freeze({ specifier: '@descix/frqtl-web/host-view', libPath: 'shim/host/index.js',
|
|
110
|
-
why: 'the DeSciX host-view declarer: a page declares its own view' })
|
|
110
|
+
why: 'the DeSciX host-view declarer: a page declares its own view' }),
|
|
111
|
+
Object.freeze({ specifier: '@descix/frqtl-web/site-graph', libPath: 'shim/engine/site-graph.js',
|
|
112
|
+
why: 'the static site\'s shape: the graph directory, the build-stamp attribute, the build id pattern, the IDE entry page' })
|
|
111
113
|
]);
|
|
112
114
|
|
|
113
115
|
/** The package a self-reference names. */
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* roster scene the GYM plays, and the showcase copy around them (the intro card, the through-line
|
|
6
6
|
* and the one invitation). It is the ONE owner of every word of that copy.
|
|
7
7
|
*
|
|
8
|
-
* EXHIBITS is the ONE source for the front-page tiles
|
|
8
|
+
* EXHIBITS is the ONE source for the front-page tiles (their links: showcase-link.js::showcaseHref) and the scene card:
|
|
9
9
|
* nine rows in front-page order, each
|
|
10
10
|
* `{ kind, id, mode, title, tile, what, why, how, controls, still }`.
|
|
11
11
|
* - `kind` is 'rung' (a walk-through rung, lib/shim/registry/walkthrough.js); `id` resolves there. A row of
|
|
@@ -11,9 +11,12 @@
|
|
|
11
11
|
* exhibits.js the showcase roster
|
|
12
12
|
* scene-roster.js sceneGroups() — THE scene list both views show (the showcase, then the walk-through groups)
|
|
13
13
|
* scene-source.js projectOf(id, { mode }) — a rung as a project folder + its renderState (fetch in a page, file read in node)
|
|
14
|
+
* showcase-link.js showcaseHref(row), showcaseUrl(row), SHOWCASE_SITE — a showcase tile's link (relative, absolute)
|
|
15
|
+
* and the site that serves it; `row` is an element of THIS barrel's EXHIBITS
|
|
14
16
|
*/
|
|
15
17
|
|
|
16
18
|
export * from './walkthrough.js';
|
|
17
19
|
export * from './exhibits.js';
|
|
18
20
|
export * from './scene-roster.js';
|
|
19
21
|
export * from './scene-source.js';
|
|
22
|
+
export * from './showcase-link.js';
|
|
@@ -0,0 +1,61 @@
|
|
|
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
|
+
}
|
package/llms.txt
CHANGED
|
@@ -2,22 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|
> A discrete cellular-automata physics engine (compiled Rust → WASM) for the browser: interference,
|
|
4
4
|
> blackbody spectra and binding emerge from per-pixel rules (1 px/tick, single occupancy, momentum).
|
|
5
|
-
> 0.6.
|
|
5
|
+
> 0.6.1-p1.2 on npm dist-tag `next`. Node twin: @descix/frqtl-node.
|
|
6
6
|
|
|
7
7
|
- Install: `npm install @descix/frqtl-web`
|
|
8
|
-
- Live page (claude.ai artifact-safe): https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.
|
|
9
|
-
- One-file form (global FRQTL): https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.
|
|
8
|
+
- Live page (claude.ai artifact-safe): https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.1-p1.2/dist/artifact/double-slit.html
|
|
9
|
+
- One-file form (global FRQTL): https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.1-p1.2/dist/frqtl-web.min.js — example https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.1-p1.2/dist/artifact/sun.html
|
|
10
10
|
- A scene is an ES module: `export default function buildExperiment(exp)`, first statement
|
|
11
11
|
`exp.createCanvas(w, h, cfg)` (2D, p5) or `exp.createScene(w, h, d, cfg)` (3D, three); parts from
|
|
12
|
-
`@descix/frqtl-web/parts`. Example: https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.
|
|
12
|
+
`@descix/frqtl-web/parts`. Example: https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.1-p1.2/dist/frqtl/scenes/double-slit.js
|
|
13
13
|
- Doors (`@descix/frqtl-web/boot`): `bootScene(mount, buildExperiment, opts)`;
|
|
14
14
|
`bootProject(mount, { files: { 'sketch.js': text }, entry: 'sketch.js' }, opts)` or `{ url, entry }`; a folder whose
|
|
15
15
|
`frqtl.json` names its entry boots as `{ files }` or `{ url }` with no `entry`.
|
|
16
16
|
- `./project`: `FRQTL_WEB_SPECIFIERS`, `libPathOf`, `importMapFor`, `pageImportMapFor`, `FRQTL_WEB_HOST_SPECIFIERS`, `linkProject`, `sketchProject`, `SKETCH_ENTRY`, `projectIdentity`, `MANIFEST_FILE`, `MANIFEST_KEYS`, `normalizeManifest`, `parseManifest`, `serializeManifest`, `manifestFor` (the owner of `frqtl.json`), `RECORD_FILES`, `RECORD_KEYS`, `CHANGE_KEYS`, `OPS`, `BY`, `CLIP_SECONDS`, `CLIP_NAME`, `clipName`, `jsonText`, `recordFolderFaults` (the owner of a Record folder's shape; `recordFolderFaults(files)` is `[]` for a complete Record).
|
|
17
|
-
- `./registry`: walk-through rungs and `projectOf(id, { mode })` → `{ manifest, files, renderState }` (boot it with `bootProject(mount, { files }, { renderState })`).
|
|
17
|
+
- `./registry`: walk-through rungs and `projectOf(id, { mode })` → `{ manifest, files, renderState }` (boot it with `bootProject(mount, { files }, { renderState })`); a showcase tile's link (`showcaseHref(row)` relative to the serving site, `showcaseUrl(row)` absolute on `SHOWCASE_SITE.origin`; `row` is an element of the same imported `EXHIBITS`, and the link carries the row's effective mode on a multi-mode rung).
|
|
18
18
|
- `./kinds`: `registerKind`, `kindNamed`, `kindOf`, `registeredKinds` (a composed fork registers its renamed class).
|
|
19
19
|
- `./host-view`: `declareHostView`, `HOST_VIEW_OUTCOMES`, `CONTRACT_VIOLATIONS`, `HOST_SDK_SCRIPT` (an app asks its DeSciX shell for a view, once: `declareHostView({ sdk: window.DeSciX, mode, fallback })`; the outcome is on the html element's dataset).
|
|
20
|
+
- `./site-graph`: `SITE_GRAPH_DIR`, `SITE_BUILD_ATTR`, `SITE_BUILD_ID_RE`, `STATIC_APP_PAGE` (the static site's shape: graph directory, build-stamp attribute, build id pattern, IDE entry page; for a reader of a served site, both packages)
|
|
20
21
|
- `await recipeContext.fork(name, NewKind, { by })`: copies the `parts` entry's part file into the folder as `parts/<NewKind>.js` (class renamed, imports rewritten to package specifiers) and re-runs the scene in place.
|
|
21
|
-
- API reference: https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.
|
|
22
|
-
- Full agent guide: https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.
|
|
22
|
+
- API reference: https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.1-p1.2/dist/sdk.html
|
|
23
|
+
- Full agent guide: https://cdn.jsdelivr.net/npm/@descix/frqtl-web@0.6.1-p1.2/CLAUDE.md
|
|
23
24
|
- Acceptance is visual; no CLI ships. No account, credits or tokens are needed.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@descix/frqtl-web",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.1-p1.2",
|
|
4
4
|
"description": "FRQTL for the browser \u2014 the discrete fractal physics engine (compiled Rust \u2192 WASM), its parts as ES modules, the scene doors (bootScene, bootProject) and frqtl-web.min.js.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"engines": {
|
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
"./project": "./dist/shim/project/index.js",
|
|
18
18
|
"./registry": "./dist/shim/registry/index.js",
|
|
19
19
|
"./host-view": "./dist/shim/host/index.js",
|
|
20
|
+
"./site-graph": "./dist/shim/engine/site-graph.js",
|
|
20
21
|
"./shim/controls/registry.js": "./dist/shim/controls/registry.js",
|
|
21
22
|
"./shim/render/sun-look.js": "./dist/shim/render/sun-look.js",
|
|
22
23
|
"./compat/renderer/display-slot.js": "./dist/frqtl/compat/renderer/display-slot.js",
|
|
@@ -44,7 +45,7 @@
|
|
|
44
45
|
"./dist-manifest.json": "./dist/dist-manifest.json",
|
|
45
46
|
"./package.json": "./package.json"
|
|
46
47
|
},
|
|
47
|
-
"exportsNotes": "
|
|
48
|
+
"exportsNotes": "The exports map is documented in README.md, section Exports.",
|
|
48
49
|
"files": [
|
|
49
50
|
"dist",
|
|
50
51
|
"README.md",
|