@gramlot/gramlot-examples 0.2.11 → 0.2.14

package/README.md

@@ -12,7 +12,13 @@ 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.11.
+Current release: 0.2.14.
+
+[Documentation and learning sequence](https://gramlot-examples.readthedocs.io/en/latest/)
+include every lesson, its Python and JavaScript source, and the gallery guide.
+To run the examples, choose the [Python server](https://gramlot-py-server.readthedocs.io/en/latest/),
+[Node.js/Bun server](https://gramlot-js-server.readthedocs.io/en/latest/010-tutorial.html)
+or [serverless exporter](https://gramlot-js-server.readthedocs.io/en/latest/135-serverless-tutorial.html).
 
 The repositories of the family are described in
 [The Gramlot family](https://github.com/gramlot-org/gramlot/blob/main/docs/public/055-family.md)
@@ -26,9 +32,10 @@ same-name README:
 
 - `html_svg/`: thirteen HTML and SVG pages, without binding (`e01`–`e13`);
 - `binding/`: eleven pages whose DOM follows the Data (`b01`–`b11`);
-- `controllers/`: fourteen pages with formulas, controllers, named logic, events, the
+- `controllers/`: nineteen pages with formulas, controllers, named logic, events, the
   end-to-end story, `dataRpc` calls to the endpoints of the page, `remote` fragments and
-  `dataRemote` values (`c01`–`c14`).
+  `dataRemote` values (`c01`–`c19`). The last two introduce: topics,
+  authored references, native ask and parent/child messages. They require core 0.2.18 or later.
 
 Each `NN_name.js` exports `Page` and `Logic`; the Python page `NN_name.py` takes its
 `Logic` from the module beside it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gramlot/gramlot-examples",
-  "version": "0.2.11",
+  "version": "0.2.14",
   "description": "Gramlot example pages, the gallery page and its catalogue.",
   "license": "Apache-2.0",
   "repository": {
@@ -14,10 +14,10 @@
     "prepack": "node scripts/build-browser.mjs"
   },
   "dependencies": {
-    "@gramlot/gramlot": ">=0.2.16"
+    "@gramlot/gramlot": ">=0.2.18"
   },
   "devDependencies": {
-    "@genrojs/bag": ">=0.10.1",
+    "@genrojs/bag": ">=0.11.0",
     "dompurify": "3.4.16",
     "esbuild": "0.28.2",
     "highlight.js": "^11.11.1",

package/src/gramlot_examples/catalog.json

@@ -72,7 +72,7 @@
           "title": "Cards with icons",
           "folder": "10_cards_with_icons",
           "description": "HTML cards with SVG icons and live Source removal.",
-          "explanation": "Helpers and loops build the cards. Each × button removes its labelled Source node through the browser Builder; Gramlot updates the DOM without reloading. Reload restores the initial cards. No Data binding or server synchronization is involved."
+          "explanation": "Helpers and loops build the cards. Each \u00d7 button removes its labelled Source node through the browser Builder; Gramlot updates the DOM without reloading. Reload restores the initial cards. No Data binding or server synchronization is involved."
         },
         {
           "key": "e11",
@@ -154,7 +154,7 @@
           "key": "b08",
           "title": "Freeze",
           "folder": "08_freeze",
-          "description": "Freeze a branch, change its Data and Source, then thaw once.",
+          "description": "Freeze structural rendering while Data keeps updating; increment a counter, remove Source items, then thaw.",
           "explanation": "A frozen branch keeps reacting to Data but defers structural DOM work. Removing a child under freeze takes effect at the thaw, which builds the current Source once."
         },
         {
@@ -237,8 +237,26 @@
           "key": "c08",
           "title": "End-to-end story",
           "folder": "08_end_to_end",
-          "description": "Title, input, radios, checkbox, formula, SVG, button and freeze together.",
-          "explanation": "Setters after the controls, live editing, a radio pair, a formula and controller driving text and SVG, a counting button and freeze."
+          "description": "First the local 0.2.0 story; return after the endpoint lessons for a separate 0.2.14 quote, error and recovery step.",
+          "explanation": "First compare setters, live editing, radio flags, formulas, SVG and freeze. After c09/c11, revisit the same inputs with a click-only dataRpc: the server quote is a snapshot, errors retain it and a successful retry clears the error."
+        },
+        {
+          "key": "c15",
+          "title": "Lifecycle",
+          "folder": "15_lifecycle",
+          "description": "Core 0.2.0: observe hook order, freeze, removal and Source/DOM lookup."
+        },
+        {
+          "key": "c16",
+          "title": "Attribute projection",
+          "folder": "16_attribute_projection",
+          "description": "Core 0.2.0 templates/masks, then the 0.2.3 sandboxed Data preview."
+        },
+        {
+          "key": "c17",
+          "title": "Data exchange",
+          "folder": "17_data_exchange",
+          "description": "Core 0.2.5: save/restore typed Data and export JSON/XML; current utility path from 0.2.10."
         },
         {
           "key": "c09",
@@ -272,15 +290,27 @@
           "key": "c13",
           "title": "Cached remote",
           "folder": "13_cached_remote",
-          "description": "remote with _cachedRemote and _onRemote, under a variable datapath.",
+          "description": "Revisit remote with a last-result cache; distinguish mounted fragments from observed calls.",
           "explanation": "The rules fragment depends on the category of the product. _cachedRemote makes no request when the category is the same; _onRemote is inline code that counts the mounted fragments and writes the status."
         },
         {
           "key": "c14",
           "title": "Data remote",
           "folder": "14_data_remote",
-          "description": "dataRemote computes a Data value with an endpoint when the value is read.",
+          "description": "Revisit endpoint values with lazy Data; compare a bound read, an explicit snapshot and cache expiry.",
           "explanation": "The menu path holds a resolver of the endpoint load_menu with cacheTime 5. The ^.menu paragraph reads it: the answer arrives with the Data event. A change of the table loads the menu again."
+        },
+        {
+          "key": "c18",
+          "title": "Publish and subscribe",
+          "folder": "18_publish_subscribe",
+          "description": "Development core 0.2.18: revisit button actions with page topics, self receivers, references and native ask."
+        },
+        {
+          "key": "c19",
+          "title": "Parent and child messages",
+          "folder": "19_frame_messages",
+          "description": "Development core 0.2.18: local-first publish and direct parent/child postMessage exchange."
         }
       ]
     }