@gramlot/gramlot-examples 0.2.5 → 0.2.6

package/README.md

@@ -9,13 +9,18 @@ pip install gramlot-examples
 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.6.
+
 The repositories of the family are described in
 [The Gramlot family](https://github.com/gramlot-org/gramlot/blob/main/docs/public/055-family.md)
 (GC-055).
 
 ## Pages
 
-[`src/gramlot_examples/pages/`](src/gramlot_examples/pages/README.md) holds three
+[`src/gramlot_examples/pages/`](https://github.com/gramlot-org/gramlot-examples/blob/main/src/gramlot_examples/pages/README.md) holds three
 families. Each example is a Python page and its JavaScript equivalent, with a
 same-name README:
 
@@ -33,7 +38,7 @@ 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:
-[GE-010](docs/010-gallery.md).
+[GE-010](https://github.com/gramlot-org/gramlot-examples/blob/main/docs/010-gallery.md).
 
 ```sh
 npm install --no-package-lock
@@ -42,11 +47,4 @@ npm test
 python -m unittest discover -s tests
 ```
 
-## Applications
-
-[Hello World](apps/hello-world/README.md) stays here until its launchers move to the
-adapters as their quick-start examples. Its JavaScript launchers use
-`@gramlot/gramlot-js-server`; its Python launchers wait for `gramlot-py-server`.
-Database profiles remain placeholders.
-
-[Repository map](docs/005-repository-map.md) (GE-005).
+[Repository map](https://github.com/gramlot-org/gramlot-examples/blob/main/docs/005-repository-map.md) (GE-005).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gramlot/gramlot-examples",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Gramlot example pages, the gallery page and its catalogue.",
   "license": "Apache-2.0",
   "repository": {

package/src/gramlot_examples/catalog.json

@@ -93,7 +93,7 @@
           "title": "Live Source playground",
           "folder": "13_live_source",
           "description": "Create, update and remove Source nodes, with a small SVG animation.",
-          "explanation": "Builder calls create list items. Source mutations update text, color and structure. A setInterval animates an SVG attribute; removing its section disposes the timer. Works in hosted profiles and the standalone directory."
+          "explanation": "Builder calls create list items. Source mutations update text, color and structure. A setInterval animates an SVG attribute; removing its section disposes the timer. Works in every gallery command and in the static gallery opened from disk."
         }
       ]
     },

package/src/gramlot_examples/pages/README.md

@@ -14,8 +14,10 @@ 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 gallery uses only what the minimal `FileHost`
-serves: `Page.css`, the same-name stylesheet and the root logic group.
+page takes `Logic` from it. The pages use only what the core `FileHost` 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)).
 
 The pages depend only on the Gramlot core. Shared visual styling is the
 `gramlot-base` theme shipped in the core package, served by each environment at

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. The minimal FileHost serves only the root logic group, so this page uses inline code.
+- 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.
 - 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/html_svg/10_cards_with_icons.md

@@ -10,7 +10,8 @@ Source deletion and removes the corresponding DOM branch, including its SVG.
 The action never removes a DOM element directly.
 
 Python and JavaScript declare the same page and browser action. It also works
-in the generated standalone directory opened directly from disk, offline.
+in the static gallery of `gramlot-serverless gallery <folder>`, opened from disk,
+offline.
 
 **Try it:** Remove the middle card, then the others. Reload to restore all three.
 Add a fourth card to the local dataset and give it a matching icon branch.

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

@@ -14,5 +14,5 @@ Named Source paths make the target of each operation explicit. Methods divide
 the page into sections and loops construct the initial items and buttons.
 
 This example demonstrates live Source, not Data binding, persistence or server
-synchronization. Its scripts/actions run in the hosted profiles and in the regenerated standalone
-directory opened directly from disk, offline.
+synchronization. Its scripts and actions run in every gallery command, and in the
+static gallery of `gramlot-serverless gallery <folder>` opened from disk, offline.

package/src/gramlot_examples/pages/html_svg/README.md

@@ -7,4 +7,4 @@ Start with **Hello World**, then explore text, lists, tables and form controls.
 Compare each preview with its code, then try the small change suggested in the example's notes. Python and JavaScript express the same ideas.
 
 Finish with **Live Source playground**: change the page while it is running and
-watch a small SVG animation driven by Source attributes. The live examples also run in the regenerated standalone directory, offline.
+watch a small SVG animation driven by Source attributes. The live examples also run in the static gallery of `gramlot-serverless gallery <folder>`, opened from disk, offline.