@gramlot/gramlot-examples 0.2.10 → 0.2.12

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.10.
+Current release: 0.2.12.
 
 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,8 +26,9 @@ 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/`: eleven pages with formulas, controllers, named logic, events, the
-  end-to-end story and `dataRpc` calls to the endpoints of the page (`c01`–`c11`).
+- `controllers/`: seventeen 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`–`c17`).
 
 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.10",
+  "version": "0.2.12",
   "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.14"
+    "@gramlot/gramlot": ">=0.2.17"
   },
   "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

@@ -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",
@@ -260,6 +278,27 @@
           "folder": "11_call_on_click",
           "description": "A dataRpc nested in a button, with _onError for a failing and a protected endpoint.",
           "explanation": "Each click calls the endpoint. An exception answers application_error; an endpoint with auth answers not_authenticated on a server that knows no identity. _onError receives the error."
+        },
+        {
+          "key": "c12",
+          "title": "Remote",
+          "folder": "12_remote",
+          "description": "remote makes the content of an element a fragment built by the server.",
+          "explanation": "The section declares remote('details', record_id='^.record_id'). The page builds the fragment with @source in Python and Page.registerSource in JavaScript; each change of the record requests it again."
+        },
+        {
+          "key": "c13",
+          "title": "Cached remote",
+          "folder": "13_cached_remote",
+          "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": "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."
         }
       ]
     }