@gramlot/gramlot-examples 0.2.7 → 0.2.9

package/README.md

@@ -12,7 +12,7 @@ npm install @gramlot/gramlot-examples
 [![PyPI](https://img.shields.io/pypi/v/gramlot-examples)](https://pypi.org/project/gramlot-examples/)
 [![npm](https://img.shields.io/npm/v/@gramlot/gramlot-examples)](https://www.npmjs.com/package/@gramlot/gramlot-examples)
 
-Current release: 0.2.7.
+Current release: 0.2.9.
 
 The repositories of the family are described in
 [The Gramlot family](https://github.com/gramlot-org/gramlot/blob/main/docs/public/055-family.md)
@@ -37,7 +37,7 @@ Each `NN_name.js` exports `Page` and `Logic`; the Python page `NN_name.py` takes
 The gallery page lists the families and opens each example beside its README and
 source. `build_gallery` (Python) and `buildGallery` (JavaScript) return its routes and
 static assets; each environment (`gramlot-py-server`, `gramlot-js-server`) serves the
-gallery with its own host and can add its own catalogue. Guide:
+gallery with its own server and can add its own catalogue. Guide:
 [GE-010](https://github.com/gramlot-org/gramlot-examples/blob/main/docs/010-gallery.md).
 
 ```sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gramlot/gramlot-examples",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Gramlot example pages, the gallery page and its catalogue.",
   "license": "Apache-2.0",
   "repository": {
@@ -14,7 +14,7 @@
     "prepack": "node scripts/build-browser.mjs"
   },
   "dependencies": {
-    "@gramlot/gramlot": ">=0.2.5"
+    "@gramlot/gramlot": ">=0.2.12"
   },
   "devDependencies": {
     "@genrojs/bag": ">=0.10.1",

package/src/gramlot_examples/gallery/dist/frame.js

@@ -20,7 +20,7 @@
   // src/gramlot_examples/gallery/browser/frame-entry.js
   var script = document.currentScript;
   queueMicrotask(() => {
-    const renderer = window.gramlot.renderer;
+    const renderer = window.gramlot.src.renderer;
     const record = renderer.elements.get(script);
     if (!record || renderer.disposed || renderer.records.get(record.node) !== record) return;
     mountFrameTheme(renderer, record.node);

package/src/gramlot_examples/gallery/dist/gallery.js

@@ -21253,7 +21253,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   // src/gramlot_examples/gallery/browser/entry.js
   var script = document.currentScript;
   queueMicrotask(() => {
-    const renderer = window.gramlot.renderer;
+    const renderer = window.gramlot.src.renderer;
     const record = renderer.elements.get(script.parentElement);
     if (!record || renderer.disposed || renderer.records.get(record.node) !== record) return;
     mountGallery(renderer, record.node);

package/src/gramlot_examples/index.js

@@ -37,7 +37,7 @@ function readCatalog(catalog, pages, common) {
  * Each item of `catalogs` is a pair `[catalog.json, pages folder]` of one environment.
  * `routes` maps each key to its JavaScript page, its same-name stylesheet and its logic
  * module: `NN_name_aux.js`, else `NN_name.js`, the page module itself, whose `Logic` export
- * the host takes (the host throws when both hold a `Logic`). `assets` maps each URL to its
+ * the server takes (the server throws when both hold a `Logic`). `assets` maps each URL to its
  * file and media type. Nothing is written or served here.
  */
 export function buildGallery({catalogs = []} = {}) {

package/src/gramlot_examples/pages/README.md

@@ -14,7 +14,7 @@ JavaScript, in three families:
 Each example is a file page: `NN_name.py`, its JavaScript equivalent `NN_name.js`,
 its README `NN_name.md`, and where needed a same-name stylesheet `NN_name.css`.
 `NN_name.js` exports `Page` and `Logic`: the JavaScript page uses both, the Python
-page takes `Logic` from it. The pages use only what the core `FileHost` serves:
+page takes `Logic` from it. The pages use only what the core `GramlotFileServer` serves:
 `Page.css`, the same-name stylesheet and the `Logic` of the page module. The gallery
 adds its own files: the frame script, a staged `<key>_aux.js` per example and its
 assets ([GE-010 §025](https://github.com/gramlot-org/gramlot-examples/blob/main/docs/010-gallery.md#ge-010-025)).

package/src/gramlot_examples/pages/binding/08_freeze.js

@@ -28,11 +28,11 @@ export class Page extends BasePage {
 /** Logic of 08_freeze.py and 08_freeze.js: each button's nested controller calls one method. */
 export class Logic {
     sourceNode(nodeId) {
-        return this.page.source.getNodeByAttr('node_id', nodeId);
+        return this.page.src.source.getNodeByAttr('node_id', nodeId);
     }
 
     freeze(node) {
-        this.page.renderer.freeze(this.sourceNode('board'));
+        this.page.src.renderer.freeze(this.sourceNode('board'));
         node.SET('.frozen', true);
     }
 
@@ -47,7 +47,7 @@ export class Logic {
     }
 
     thaw(node) {
-        this.page.renderer.unfreeze(this.sourceNode('board'));
+        this.page.src.renderer.unfreeze(this.sourceNode('board'));
         node.SET('.frozen', false);
     }
 }

package/src/gramlot_examples/pages/controllers/03_named_logic.js

@@ -28,7 +28,7 @@ export class Page extends BasePage {
 }
 
 /**
- * Logic of 03_named_logic.py and 03_named_logic.js. The minimal FileHost serves this module as the
+ * Logic of 03_named_logic.py and 03_named_logic.js. The core GramlotFileServer serves this module as the
  * root group of the page logic: `func='finalPrice'` names the method below.
  */
 export class Logic {

package/src/gramlot_examples/pages/controllers/03_named_logic.md

@@ -1,6 +1,6 @@
 # 03 · Named logic
 
-The code of this page lives in `class Logic`, which `03_named_logic.js` exports beside `Page`. The minimal FileHost serves that module as the page logic for the JavaScript page and for the Python page `03_named_logic.py` alike.
+The code of this page lives in `class Logic`, which `03_named_logic.js` exports beside `Page`. The core GramlotFileServer serves that module as the page logic for the JavaScript page and for the Python page `03_named_logic.py` alike.
 
 - `func='finalPrice'` names a method of `Logic`. A formula method receives one object with the resolved parameters and returns the result: 10% off from the `threshold`.
 - A controller method receives its Source node and the parameters. `node.SET('.changes', …)` writes relative to the node's context.

package/src/gramlot_examples/pages/controllers/07_events.md

@@ -4,7 +4,7 @@
 
 - The value is inline code with `this` = the declaring node and the parameter `event`. `this.SET('.path', …)` writes relative to the node's context.
 - The handler runs with the declaring node also when the event hits a descendant: a click on a chip reaches the section's handler, and `event.target` names the chip.
-- A value of dotted names, such as `gui.focused`, is named logic of a `js_requires` group instead. `js_requires` needs a Host with a resource system: the core `FileHost` and the current adapters have none and raise an error for any name, so this page uses inline code. The resource system comes with genro-kajenn, part of Genro.
+- A value of dotted names, such as `gui.focused`, is named logic of a `js_requires` group instead. `js_requires` needs a server with a resource system: the core `GramlotFileServer` and the current adapters have none and raise an error for any name, so this page uses inline code. The resource system comes with genro-kajenn, part of Genro.
 - Removing the node removes its listeners.
 
 **Try it:** Click the green chip, type a word, then add `connect_onfocus` to the field.

package/src/gramlot_examples/pages/controllers/08_end_to_end.js

@@ -58,7 +58,7 @@ export class Page extends BasePage {
 /** Logic of 08_end_to_end.py and 08_end_to_end.js: the named logic of the story. */
 export class Logic {
     sourceNode(nodeId) {
-        return this.page.source.getNodeByAttr('node_id', nodeId);
+        return this.page.src.source.getNodeByAttr('node_id', nodeId);
     }
 
     /** Controller of the total: the circle turns red above 10. */
@@ -73,7 +73,7 @@ export class Logic {
     }
 
     freeze() {
-        this.page.renderer.freeze(this.sourceNode('later'));
+        this.page.src.renderer.freeze(this.sourceNode('later'));
     }
 
     removeNote() {
@@ -83,6 +83,6 @@ export class Logic {
     }
 
     thaw() {
-        this.page.renderer.unfreeze(this.sourceNode('later'));
+        this.page.src.renderer.unfreeze(this.sourceNode('later'));
     }
 }

package/src/gramlot_examples/pages/html_svg/10_cards_with_icons.js

@@ -18,7 +18,7 @@ export class Page extends BasePage {
         for (const [title, description, kind] of CARDS) {
             const card = cards.article({node_label: kind, class: 'card stack'});
             card.button('×', {type: 'button', class: 'card-remove', aria_label: `Remove ${title}`,
-                connect_onclick: `window.gramlot.builder.source.getItem('main.page.cards').popNode('${kind}')`});
+                connect_onclick: `window.gramlot.src.builder.source.getItem('main.page.cards').popNode('${kind}')`});
             const icon = card.svg({viewBox: '0 0 64 64', width: 64, height: 64, aria_hidden: 'true'});
             this.icon(icon, kind);
             card.h2(title);

package/src/gramlot_examples/pages/html_svg/13_live_source.js

@@ -2,21 +2,21 @@ import {Page as BasePage} from '@gramlot/gramlot/page';
 
 // These browser actions change Source, never DOM elements.
 const ACTIONS = {
-    "add": "window.gramlot.builder.wrapSource(window.gramlot.source.getNode('main.page.work.items')).li('A new item', {class: 'card'})",
-    "remove": "const items = window.gramlot.source.getItem('main.page.work.items'); const last = items.getNodes().at(-1); if (last) items.popNode(last.label)",
-    "clear": "window.gramlot.source.getItem('main.page.work.items').clear()",
-    "rename": "window.gramlot.source.getNode('main.page.heading').setValue('Source is alive!')",
-    "color": "window.gramlot.source.getNode('main.page.motion.scene.ball').setAttr({fill: 'var(--gramlot-warning)'})",
-    "stop": "window.gramlot.source.getItem('main.page').popNode('motion')"
+    "add": "window.gramlot.src.builder.wrapSource(window.gramlot.src.source.getNode('main.page.work.items')).li('A new item', {class: 'card'})",
+    "remove": "const items = window.gramlot.src.source.getItem('main.page.work.items'); const last = items.getNodes().at(-1); if (last) items.popNode(last.label)",
+    "clear": "window.gramlot.src.source.getItem('main.page.work.items').clear()",
+    "rename": "window.gramlot.src.source.getNode('main.page.heading').setValue('Source is alive!')",
+    "color": "window.gramlot.src.source.getNode('main.page.motion.scene.ball').setAttr({fill: 'var(--gramlot-warning)'})",
+    "stop": "window.gramlot.src.source.getItem('main.page').popNode('motion')"
 };
 const ANIMATION = `queueMicrotask(() => {
     const app = window.gramlot;
-    const motion = app.source.getNode('main.page.motion');
-    const ball = app.source.getNode('main.page.motion.scene.ball');
+    const motion = app.src.source.getNode('main.page.motion');
+    const ball = app.src.source.getNode('main.page.motion.scene.ball');
     const timer = setInterval(() => {
         ball.setAttr({cx: 160 + 110 * Math.sin(performance.now() / 700)});
     }, 50);
-    app.renderer.onDispose(motion, () => clearInterval(timer));
+    app.src.renderer.onDispose(motion, () => clearInterval(timer));
 });`;
 
 export class Page extends BasePage {