@nodegx/mcp 0.2.6 → 0.2.8

package/dist/render-harness/data/node-catalog-enriched.json

@@ -5114,7 +5114,7 @@
         "whenToUse": "Whenever a file handle needs to become a URL or filename. Note the cloudfile→image typecast lets a cloudfile feed an Image `src` directly; reach for Cloud File when you need the URL as a *string* or the file's name.",
         "ports": {
           "file": "The cloudfile value to unwrap.",
-          "url": "The file's public URL as a string.",
+          "url": "The file's URL as a string, for an Image `src` or a link. It's the address the backend answered from, so don't save it into a text property. Save the file itself into a file-typed one.",
           "name": "The stored file's name."
         },
         "examples": [
@@ -7119,7 +7119,8 @@
           "isfalse": "Boolean level, inverse of `result`; saves an Inverter when driving 'error shown' style inputs."
         },
         "examples": [
-          "validate-before-submit"
+          "validate-before-submit",
+          "score-then-move-on"
         ],
         "patterns": [
           "Button `onClick` → `eval`, with `ontrue` driving the action: gate an action behind a validity check at click time.",
@@ -7128,7 +7129,7 @@
         "antiPatterns": [
           "Wiring `ontrue` (signal) to a boolean input like `visible` delivers only a momentary pulse — use `result` for anything that must stay on.",
           "Leaving Run On Value Change on when `ontrue`/`onfalse` DOES something (advance a question, navigate, set a Variable, start a Timer): the gate then fires whenever its input settles, including once while the page loads, before anyone has acted. Set `runOnChange-condition: false` and wire `eval` from the signal that should ask — a Repeat's tick, a button's click, a Timer's finish.",
-          "Two gates evaluated by one signal, where one gate's On True changes what the other one reads (advancing a question index that the other's 'is the answer right?' compares against): the second can read the changed value. Chain them instead — the reader's `done` → the writer's `eval` — so the reader decides first.",
+          "Two gates evaluated by one signal, where one gate's On True changes what the other one reads (advancing a question index that the other's 'is the answer right?' compares against): the reader sees the changed value, whichever order the two are wired in, so wire order is no fix. Chain them instead — the reader's `done` → the writer's `eval` — so the reader decides first (example `score-then-move-on`; the Problems panel warns `condition-reads-a-siblings-change`).",
           "Expecting a second Evaluate with an unchanged condition to stay silent: every Evaluate fires On True or On False again, whether or not the value changed.",
           "A gate left on Run On Value Change fires the moment its condition is true, even for one step in the middle of a chain of Set Variables. A timeout watching 'time is up AND not answered' fires again while moving on if `answered` is cleared while the countdown still reads 0: the next question starts answered and its first tap is refused (a quiz that scored the right answer after a timeout as wrong). Reset the value that makes it true (the countdown back to 10) before the one that holds it off (`answered` back to false)."
         ],
@@ -18526,12 +18527,14 @@
         "examples": [
           "function-compute-on-run",
           "community-csv-download",
-          "community-seo-meta-tag-setter"
+          "community-seo-meta-tag-setter",
+          "cloud-members-can-edit-my-records"
         ],
         "patterns": [
           "Async action: `run` from a click → `await fetch(...)` → set value outputs → `Outputs.Success()`; wire Success onward for sequencing.",
           "Transform between nodes: array in, reshaped array out, feeding a Repeater.",
-          "Shared helper: `exports.canStep = …` in `scripts/engine/rules.js`, `engine/rules.js` under Uses on each Function that needs it, and `Scripts.rules.canStep(tile)` in each body."
+          "Shared helper: `exports.canStep = …` in `scripts/engine/rules.js`, `engine/rules.js` under Uses on each Function that needs it, and `Scripts.rules.canStep(tile)` in each body.",
+          "Records from a script, in a cloud function: `await Noodl.Records.query('Note', { owner: id }, { plain: true })` (rows as stored, ids as strings), `await Noodl.Records.create('Note', { title, owner }, { acl })`, `await Noodl.Records.save(id, { title }, { className: 'Note', acl })`, `await Noodl.Records.delete(id, { className: 'Note' })` and `Noodl.Records.increment`. A cloud function runs as the system: it reads every record, may name `owner`, and creates where the collection's create rule is \"nobody\". `acl` is the record's whole ACL: `{ \"<userId>\": { read: true, write: true }, \"role:<name>\": { … }, \"*\": { … } }` (example `cloud-members-can-edit-my-records`)."
         ],
         "antiPatterns": [
           "Wiring to the bare script name — `toProperty: \"amount\"` for a script reading `Inputs.amount`. The port is `in-amount`; the bare name is only its display label. The door refuses it, and drawn by hand it fails on the canvas.",
@@ -21802,7 +21805,7 @@
       },
       "enrichment": {
         "typeName": "NewDbModelProperties",
-        "summary": "Create Record: inserts a record into a cloud database class from its property inputs when Do is triggered.",
+        "summary": "Create Record: inserts a record into a cloud database class from its property inputs on Do, with optional access rules (ACL: users, roles).",
         "description": "NewDbModelProperties (Create Record) creates one record in the cloud database class chosen with the `collectionName` (Class) parameter. Each property of the class becomes a value input; when the `store` (Do) signal is triggered, the current input values are sent to the server as a new record. On success the node binds to the new record, outputs its `id`, and fires `done` (Done) followed by `completed`; on failure it fires `failure` with a message on `error`, and `completed` after that too. Optionally, `sourceObjectId` seeds the new record with the data of an existing local object (explicit property inputs win), and Access Control Rules restrict who can read/write the record (defaulting to the creating user when a rule is left unconfigured).",
         "whenToUse": "The write half of every 'add item' flow — forms, quick-add buttons, duplicating a record via `sourceObjectId`. Live Query Records nodes pick the new record up automatically, so no manual re-fetch is needed. To modify an existing record use SetDbModelProperties instead; for a non-cloud (BYOB) backend use noodl.byob.CreateRecord.",
         "ports": {
@@ -21811,18 +21814,20 @@
           "completed": "Signal; fires after every Do whatever the outcome — wire it to carry on regardless. It never replaces `failure`, which still fires and still carries its reason.",
           "id": "String value; the id of the created record — feed it to a Record node or navigation parameter.",
           "sourceObjectId": "Value input (connections only): id of a local object/record whose data seeds the new record before the property inputs are applied.",
-          "accessControl": "Edit-only list of access rules; each rule expands into its own Target/Read/Write inputs (see runtimeBehavior). With no rules the record gets the class default (public) permissions."
+          "accessControl": "Edit-only list of access rules; each rule expands into its own Target/Read/Write inputs (see runtimeBehavior). With no rules, on the NodeGX backend's default (creator-owned) collections the record is the creator's alone: readable and changeable only by them. Rules you set REPLACE that, so keep one for the creator (target user, the User node's `id` wired into its User Id)."
         },
-        "runtimeBehavior": "Ports are runtime-determined: `collectionName` (Class) is registered as an edit-only enum of the project's classes plus _User/_Role, and each schema property of the chosen class becomes a value input `prop-<name>` typed from the schema. Each entry in the `accessControl` list additionally spawns `acl-<ruleId>-target` (user/everyone/role), then `acl-<ruleId>-userid` or `acl-<ruleId>-role`, plus `acl-<ruleId>-read` and `acl-<ruleId>-write` booleans. An authoring tool should set `collectionName` in parameters and drive `prop-<name>` inputs it knows from the class schema.",
+        "runtimeBehavior": "Ports are runtime-determined: `collectionName` (Class) is registered as an edit-only enum of the project's classes plus _User/_Role, and each schema property of the chosen class becomes a value input `prop-<name>` typed from the schema. Each entry in the `accessControl` list additionally spawns `acl-<ruleId>-target` (user/everyone/role), then `acl-<ruleId>-userid` or `acl-<ruleId>-role`, plus `acl-<ruleId>-read` and `acl-<ruleId>-write` booleans. An authoring tool should set `collectionName` in parameters and drive `prop-<name>` inputs it knows from the class schema. What the rules store is the record's ACL, one key per rule: the user's id, `role:<name>` for a role rule (set `acl-<ruleId>-target` to \"role\" as a parameter, then wire or set `acl-<ruleId>-role` to the role's name without the `role:` prefix), or `*` for everyone; each key holds `{\"read\": true, \"write\": true}`. The backend lets a caller read or change the record only through a key it holds, after the collection's own find/get/update rule. Who joins a role is decided only in a cloud function (Add User To Role).",
         "examples": [
           "cloud-create-record-with-upload",
           "cloud-record-crud",
           "community-simple-audio-recorde",
-          "community-web-rtc-video-record"
+          "community-web-rtc-video-record",
+          "cloud-members-can-edit-my-records"
         ],
         "patterns": [
           "Text Input `text` → `prop-<name>`, Button `onClick` → `store`: the minimal create form.",
-          "`done` → a navigation or Event Sender, with `id` as payload: jump straight to the new record's detail page."
+          "`done` → a navigation or Event Sender, with `id` as payload: jump straight to the new record's detail page.",
+          "Records several people may all change: a rule for the creator and a role rule (`members-of-<ownerId>`), the role joined only in a cloud function that reads an invitation's `owner` (example `cloud-members-can-edit-my-records`). Where only a function should create the records, it creates them as the system and the collection's create rule is \"nobody\". A record it creates while a signed-in person's call runs is that person's (P112-OWN026-OPENSTAT); to share one, the function passes `acl` with `'*'`."
         ],
         "antiPatterns": [
           "Re-fetching a Query Records node after `done` — live queries already receive the new record; only re-fetch when the query is not live.",
@@ -31602,7 +31607,7 @@
       },
       "enrichment": {
         "typeName": "SetDbModelProperties",
-        "summary": "Update Record: writes property values to an existing cloud database record when Do is triggered.",
+        "summary": "Update Record: writes property values to an existing cloud database record on Do; access rules sent with it replace its ACL.",
         "description": "SetDbModelProperties (Update Record) updates the record identified by `modelId` in the class chosen with the `collectionName` (Class) parameter. Each class property becomes a value input; triggering `store` (Do) applies the connected inputs to the local record and saves them to the server, firing `done` (Done) on confirmation or `failure` with `error` on problems, and `completed` after either. `storeType` (Store to) can switch the node to 'Local only', which updates the in-memory record without any server call — useful for optimistic UI or scratch state. By default only the properties you actually supply are sent (`storeProperties` = 'Only specified'); 'All' sends the record's entire current data. Because the shared local record is updated, every bound Record node and live query in the app sees the change immediately.",
         "whenToUse": "The save half of every edit form, and the way to flip a single field ('mark done') from a list row. To create a record use NewDbModelProperties; to remove one use DeleteDbModelProperties; for BYOB backends use noodl.byob.UpdateRecord. For a count, score, balance or progress, set `addTo` and wire the change, not the new total.",
         "ports": {
@@ -31613,7 +31618,7 @@
           "idSource": "Edit-only choice: 'Specify explicitly' uses `modelId`; 'From repeater' targets the record driving the nearest enclosing For Each item.",
           "storeProperties": "Edit-only choice ('Only specified' / 'All'): whether to send just the supplied property inputs or the record's whole data. Shown while `storeType` is cloud.",
           "storeType": "Edit-only choice ('Cloud and local' / 'Local only'): whether the save reaches the server or only the in-memory record.",
-          "accessControl": "Edit-only list of access rules applied with the save; each rule expands into its own Target/Read/Write inputs.",
+          "accessControl": "Edit-only list of access rules applied with the save; each rule expands into its own Target/Read/Write inputs. Rules sent with an update replace the record's whole ACL (keys and shape as on Create Record); an update without rules leaves the ACL as it was.",
           "onlyIfUnchanged": "Edit-only text (displayed as Only If Unchanged): property names, comma-separated, usually `version`. The update applies only if those properties still hold the values the record had when it was read (taken before this node's inputs are applied), checked by the backend inside the UPDATE itself. If someone else wrote the record in between, nothing is written, `failure` fires, `error` says so, and the local record goes back to what it held (the backend answered 409 with reason `precondition-failed`). To retry, FETCH the record again first: retrying with the same values fails the same way. NodeGX backends only; other backends refuse it. Empty: always write.",
           "addTo": "Edit-only text (displayed as Add To): property names, comma-separated. For these, the value wired into `prop-<name>` is an AMOUNT (1, -1, 5) the backend adds to what it holds, in one step, instead of a value that replaces it, so two devices or tabs adding at once both count. The record then shows the backend's total. The other properties are saved first, so `onlyIfUnchanged` still guards them and a refused save adds nothing. A value that is not a number fails the Do and says so. 'Local only' adds the amount to the record held in memory."
         },
@@ -31621,7 +31626,8 @@
         "examples": [
           "cloud-edit-record",
           "cloud-record-crud",
-          "cloud-shared-counter"
+          "cloud-shared-counter",
+          "cloud-members-can-edit-my-records"
         ],
         "patterns": [
           "A count, score, balance or progress: `addTo` = `points`, `prop-points` = 1 (or the change a Function works out), Button `onClick` → `store`. No script, no read of the old value: the backend adds it, and two devices pressing together both count (example `cloud-shared-counter`).",
@@ -37749,7 +37755,8 @@
         ],
         "antiPatterns": [
           "Treating `cloudFile` as set before `done` fired — sequence record writes on the Done signal.",
-          "Setting `private: true` and then binding `cloudFile.url` straight to an Image/link — a private file's plain url 403s for anyone but the uploader; sign it first."
+          "Setting `private: true` and then binding `cloudFile.url` straight to an Image/link — a private file's plain url 403s for anyone but the uploader; sign it first.",
+          "Saving the url of `cloudFile` (or Cloud File's `url`) into a text property. That url names the address the backend was reached at during the upload, which is `127.0.0.1` on your own machine, so it stops working once the app runs on a host. Save the `cloudFile` handle into a file-typed property instead. The NodeGX backend keeps the file's name and fills its address in on every read."
         ],
         "relatedNodes": [
           "Open File Picker",
@@ -51296,7 +51303,7 @@
           "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
         ],
         "visible": [
-          "always: shown or hidden at the next paint, its space kept; hidden, a Focus does not reach it"
+          "always: shown or hidden at once, its space kept; hidden, a Focus does not reach it"
         ]
       },
       "warnings": {
@@ -53514,7 +53521,7 @@
           "always: the page, or the scrolling Group holding it, scrolls until the box can be seen"
         ],
         "visible": [
-          "always: shown or hidden at the next paint, its space kept; hidden, a Focus does not reach it"
+          "always: shown or hidden at once, its space kept; hidden, a Focus does not reach it"
         ]
       },
       "warnings": {
@@ -56117,11 +56124,12 @@
         ],
         "items": [
           "nothing handed (undefined): the list it has stays",
+          "the value is still the placed node's seed and the list does not offer it: the list is kept, and the value is cleared to '' and sent",
           "otherwise: the list is kept as handed and drawn at the next paint; the value stays, so a list handed again keeps the pick"
         ],
         "value": [
           "null: ignored",
-          "the value it already holds, as text: nothing",
+          "the value it already holds, as text: nothing (it is no longer the seed)",
           "a change: kept as text, Value follows, and the list selects it at the next paint if it names an option — Changed does not fire (only a person's pick fires it)"
         ],
         "mounted": [
@@ -56149,7 +56157,7 @@
           "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
         ],
         "visible": [
-          "always: shown or hidden at the next paint, its space kept; hidden, a Focus does not reach it"
+          "always: shown or hidden at once, its space kept; hidden, a Focus does not reach it"
         ]
       },
       "warnings": {
@@ -58353,7 +58361,7 @@
           "always: the page, or the scrolling Group holding it, scrolls until the button can be seen"
         ],
         "visible": [
-          "always: shown or hidden at the next paint, its space kept; hidden, it takes no click and a Focus does not reach it"
+          "always: shown or hidden at once, its space kept; hidden, it takes no click and a Focus does not reach it"
         ]
       },
       "warnings": {
@@ -60779,7 +60787,7 @@
           "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
         ],
         "visible": [
-          "always: shown or hidden at the next paint, its space kept; hidden, a Focus does not reach it"
+          "always: shown or hidden at once, its space kept; hidden, a Focus does not reach it"
         ]
       },
       "warnings": {
@@ -63672,7 +63680,7 @@
           "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
         ],
         "visible": [
-          "always: shown or hidden at the next paint, its space kept; hidden, a Focus does not reach it"
+          "always: shown or hidden at once, its space kept; hidden, a Focus does not reach it"
         ],
         "opacity": [
           "always: how see-through it is; at exactly 0 it takes no pointer, and an act goes to what is behind it"
@@ -66997,10 +67005,12 @@
           "error": "Value; why the last attempt failed."
         },
         "examples": [
-          "cloud-invite-a-team-member"
+          "cloud-invite-a-team-member",
+          "cloud-members-can-edit-my-records"
         ],
         "patterns": [
-          "Wire straight after Create User in a signup function to put every new account into a default role like `member` — `unchanged` and `done` both mean the account is now in that role, so wiring both to the same next step covers a re-run cleanly."
+          "Wire straight after Create User in a signup function to put every new account into a default role like `member` — `unchanged` and `done` both mean the account is now in that role, so wiring both to the same next step covers a re-run cleanly.",
+          "A group per owner, joined by invitation: the role is named in code from the owner's id (`'members-of-' + invitation.owner`), so `createRole` is on (one name per owner, never typed), and the owner is the invitation's `owner` (the backend's word), never a group field the invitation carries: anyone signed in can create an invitation naming any group (example `cloud-members-can-edit-my-records`)."
         ],
         "antiPatterns": [
           "Wiring a request parameter straight into `userId` (or `role`) on a function anyone may call. That is 'grant any role to any account' with an HTTP endpoint in front of it — give the function a `call` rule (CWF-017) and check inside the graph that the caller is entitled to make this particular grant.",
@@ -69207,7 +69217,8 @@
           "error": "Value; why the last attempt failed, or (on Unchanged) which of the two non-membership cases it was."
         },
         "examples": [
-          "cloud-revoke-a-role-and-record-it"
+          "cloud-revoke-a-role-and-record-it",
+          "cloud-members-can-edit-my-records"
         ],
         "patterns": [
           "Wire a lapsed-subscription webhook straight to this node's `remove`, with `done` and `unchanged` both leading to the same next step — the account ends up without the role either way, which is the only thing that response needs to be true."
@@ -69247,7 +69258,7 @@
           },
           "isSignal": false,
           "default": false,
-          "description": "Whether a request with no valid session token is allowed to run this function at all"
+          "description": "Whether a request with no valid session token is allowed to run this function at all. A run the app starts itself — a schedule, a row change, a run from Studio — is always allowed and sees nobody signed in; a webhook is a request like any other"
         },
         {
           "name": "params",
@@ -69301,7 +69312,7 @@
           "group": "Request",
           "plug": "output",
           "type": {
-            "name": "boolean"
+            "name": "string"
           },
           "isSignal": false,
           "description": "Id of the user the session token resolved to, and blank for an unauthenticated request"
@@ -70962,7 +70973,10 @@
             {
               "id": "prompt_body",
               "type": "Javascript2",
-              "label": "Build request body"
+              "label": "Build request body",
+              "parameters": {
+                "code": "Script.Inputs = { prompt: 'string', token: 'string' };\nScript.Outputs = { body: 'object', headers: 'object', send: 'signal' };\n\n// Run builds the request from the prompt as it is now, then asks the stream to connect.\n// `token` is the signed-in person's token for your own endpoint, never a provider key in the page.\nScript.Signals.run = function () {\n  Script.setOutputs({\n    body: { stream: true, messages: [{ role: 'user', content: Script.Inputs.prompt || '' }] },\n    headers: { Authorization: 'Bearer ' + (Script.Inputs.token || '') }\n  });\n  Script.Outputs.send();\n};"
+              }
             },
             {
               "id": "chat_stream",
@@ -70990,7 +71004,18 @@
             {
               "id": "state_label",
               "type": "String Mapper",
-              "label": "State to label"
+              "label": "State to label",
+              "parameters": {
+                "input 0": "connecting",
+                "output 0": "Connecting…",
+                "input 1": "open",
+                "output 1": "Answering",
+                "input 2": "reconnecting",
+                "output 2": "Reconnecting…",
+                "input 3": "error",
+                "output 3": "The stream failed",
+                "defaultMapping": ""
+              }
             }
           ],
           "connections": [
@@ -71052,11 +71077,11 @@
               "fromId": "chat_stream",
               "fromProperty": "connectionState",
               "toId": "state_label",
-              "toProperty": "input"
+              "toProperty": "inputString"
             },
             {
               "fromId": "state_label",
-              "fromProperty": "output",
+              "fromProperty": "mappedString",
               "toId": "status_text",
               "toProperty": "text"
             }
@@ -71469,7 +71494,7 @@
     {
       "id": "agent-store-shared-state",
       "title": "Shared state: one store read by two unrelated components",
-      "description": "Two components that are not parent and child, sharing state through a named store instead of prop drilling or a Send/Receive Event pair. Sign In writes `user` with Set Global Store; Header declares the same store by name and renders `state` — no wiring runs between the two components, because naming the store is what connects them. Header also subscribes to just the `user` key, so a write to any other key does not wake it, and uses `previousValue` against `value` to fire only on the signed-out → signed-in transition rather than on every change. Initial State fills gaps without overwriting live state, so Header remounting cannot reset a store Sign In is already using.",
+      "description": "Two components that are not parent and child, sharing state through a named store instead of prop drilling or a Send/Receive Event pair. Sign In writes `user` with Set Global Store; Header declares the same store by name and reads `user` from it — no wiring runs between the two components, because naming the store is what connects them. Header subscribes to just the `user` key, so a write to any other key does not wake it, and puts the value into its greeting through a String Format whose `{user}` tag is the input the wire lands on. The store persists under its storage key, so the greeting survives a reload.",
       "demonstrates": [
         "net.noodl.GlobalStore",
         "net.noodl.GlobalStore.Set",
@@ -71571,7 +71596,10 @@
             {
               "id": "greeting",
               "type": "String Format",
-              "label": "Format greeting"
+              "label": "Format greeting",
+              "parameters": {
+                "format": "Signed in as {user}"
+              }
             }
           ],
           "connections": [
@@ -71579,11 +71607,11 @@
               "fromId": "watch_user",
               "fromProperty": "value",
               "toId": "greeting",
-              "toProperty": "input"
+              "toProperty": "user"
             },
             {
               "fromId": "greeting",
-              "fromProperty": "result",
+              "fromProperty": "formatted",
               "toId": "user_text",
               "toProperty": "text"
             }
@@ -71952,7 +71980,7 @@
               "type": "net.noodl.Log",
               "label": "The provider round trip did not start",
               "parameters": {
-                "level": "warning"
+                "level": "warn"
               }
             },
             {
@@ -72554,7 +72582,7 @@
               "type": "net.noodl.Log",
               "label": "Unreadable due date",
               "parameters": {
-                "level": "warning",
+                "level": "warn",
                 "message": "Invoice row: the due date could not be read as a date."
               }
             }
@@ -72779,7 +72807,7 @@
               "type": "net.noodl.Log",
               "label": "The server did not answer usably",
               "parameters": {
-                "level": "warning"
+                "level": "warn"
               }
             },
             {
@@ -72787,7 +72815,7 @@
               "type": "net.noodl.Log",
               "label": "The answer was not a feed",
               "parameters": {
-                "level": "warning"
+                "level": "warn"
               }
             }
           ],
@@ -72958,7 +72986,7 @@
               "type": "net.noodl.Log",
               "label": "The paste would not parse",
               "parameters": {
-                "level": "warning"
+                "level": "warn"
               }
             }
           ],
@@ -73057,7 +73085,7 @@
               "type": "net.noodl.Log",
               "label": "The server did not answer usably",
               "parameters": {
-                "level": "warning"
+                "level": "warn"
               }
             },
             {
@@ -73065,7 +73093,7 @@
               "type": "net.noodl.Log",
               "label": "Refused or unreadable — read Error Code",
               "parameters": {
-                "level": "warning"
+                "level": "warn"
               }
             }
           ],
@@ -73422,7 +73450,7 @@
       ],
       "components": [
         {
-          "name": "/Cloud Functions/Check Client Session",
+          "name": "/#__cloud__/Cloud Functions/Check Client Session",
           "nodes": [
             {
               "id": "fn_request",
@@ -73526,7 +73554,7 @@
       ],
       "components": [
         {
-          "name": "/Cloud Functions/Verify Inbound",
+          "name": "/#__cloud__/Cloud Functions/Verify Inbound",
           "nodes": [
             {
               "id": "fn_request",
@@ -73834,7 +73862,7 @@
       ],
       "components": [
         {
-          "name": "/Cloud Functions/Delete Account",
+          "name": "/#__cloud__/Cloud Functions/Delete Account",
           "nodes": [
             {
               "id": "fn_request",
@@ -74208,7 +74236,7 @@
       ],
       "components": [
         {
-          "name": "/Cloud Functions/Invite Team Member",
+          "name": "/#__cloud__/Cloud Functions/Invite Team Member",
           "nodes": [
             {
               "id": "fn_request",
@@ -74346,6 +74374,853 @@
         }
       ]
     },
+    {
+      "id": "cloud-members-can-edit-my-records",
+      "title": "Invite people who can change my records too: a role per owner, joined only through an invitation its owner made",
+      "description": "A second person, or several, who can change everything you can: people who may all read AND change the same records (a partner, a co-organiser, a colleague, anyone you invite to edit with you). The group belongs to one person, its owner, and its role is named from that person's id (\"members-of-<id>\"). The owner's page creates an Invite holding only the invited address; the backend writes who made it into `owner`. Join Group, a cloud function the invited person's page calls, finds the invitations naming the caller's own address (from their session, not the request) and puts them in the role of the invitation's OWNER, never a group id the invitation carries: anyone signed in can create an Invite naming any group, and only `owner` is the server's word, so an invitation can only ever let someone into its creator's own group. Every record of the group is created by Add To Group, which runs as the system: it refuses a caller who is neither the owner nor in the role (the User node's `roles`, read from the caller's session), writes the GROUP owner into `owner` (a page could never name it), and stores access rules for the owner and the role ({\"<ownerId>\": read+write, \"role:members-of-<ownerId>\": read+write}). So members change a record straight from the page with Update Record (the role's write rule lets them), and the group's list is a Query Records filtered on `owner` = the group, which a record somebody else made and opened to the role can never match. Remove Member takes back the caller's own invitation and takes the member out of the caller's own group, whatever the invitation says. `createRole` is on in Join Group because the role name is built in code, one per owner, never typed. Declare Invite (withEmail, memberId) and Note (title) in provision_backend, both creator-owned (the default), and set Note's create rule to \"nobody\" (set_collection_permissions): a cloud function runs as the system and still creates, and a Note posted straight to the collection from a page is refused, so a check in Add To Group is not one a caller can walk around.",
+      "demonstrates": [
+        "NewDbModelProperties",
+        "SetDbModelProperties",
+        "DbCollection2",
+        "CloudFunction2",
+        "noodl.cloud.request",
+        "net.noodl.user.User",
+        "JavaScriptFunction",
+        "noodl.cloud.addusertorole",
+        "noodl.cloud.removeuserfromrole",
+        "noodl.cloud.response"
+      ],
+      "components": [
+        {
+          "name": "/Member Row",
+          "nodes": [
+            {
+              "id": "mem_root",
+              "type": "Group",
+              "label": "One invitation",
+              "parameters": {
+                "flexDirection": "row",
+                "columnGap": "var(--space-2)",
+                "alignItems": "center"
+              },
+              "children": [
+                "mem_address",
+                "mem_remove"
+              ]
+            },
+            {
+              "id": "mem_address",
+              "type": "Text",
+              "label": "Who it invites",
+              "parent": "mem_root"
+            },
+            {
+              "id": "mem_remove",
+              "type": "net.noodl.controls.button",
+              "label": "Take it back",
+              "parent": "mem_root",
+              "parameters": {
+                "label": "Remove"
+              }
+            },
+            {
+              "id": "mem_inputs",
+              "type": "Component Inputs",
+              "label": "Invitation in",
+              "ports": [
+                {
+                  "name": "withEmail",
+                  "plug": "output",
+                  "type": "*"
+                }
+              ]
+            },
+            {
+              "id": "mem_call",
+              "type": "CloudFunction2",
+              "label": "Take the invitation back, and the access with it",
+              "parameters": {
+                "function": "Cloud Functions/Remove Member"
+              }
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "mem_inputs",
+              "fromProperty": "withEmail",
+              "toId": "mem_address",
+              "toProperty": "text"
+            },
+            {
+              "fromId": "mem_inputs",
+              "fromProperty": "withEmail",
+              "toId": "mem_call",
+              "toProperty": "in-withEmail"
+            },
+            {
+              "fromId": "mem_remove",
+              "fromProperty": "onClick",
+              "toId": "mem_call",
+              "toProperty": "call"
+            }
+          ]
+        },
+        {
+          "name": "/Invite Someone To Edit",
+          "nodes": [
+            {
+              "id": "inv_root",
+              "type": "Group",
+              "label": "Invite someone to edit my notes",
+              "parameters": {
+                "flexDirection": "column",
+                "rowGap": "var(--space-3)"
+              },
+              "children": [
+                "inv_address",
+                "inv_button",
+                "inv_error",
+                "inv_list"
+              ]
+            },
+            {
+              "id": "inv_address",
+              "type": "net.noodl.controls.textinput",
+              "label": "Their email address",
+              "parent": "inv_root",
+              "parameters": {
+                "type": "email",
+                "placeholder": "name@example.com"
+              }
+            },
+            {
+              "id": "inv_button",
+              "type": "net.noodl.controls.button",
+              "label": "Invite them",
+              "parent": "inv_root",
+              "parameters": {
+                "label": "Invite"
+              }
+            },
+            {
+              "id": "inv_error",
+              "type": "Text",
+              "label": "Why it did not save",
+              "parent": "inv_root",
+              "parameters": {
+                "text": ""
+              }
+            },
+            {
+              "id": "inv_list",
+              "type": "For Each",
+              "label": "One row per invitation I made",
+              "parent": "inv_root",
+              "parameters": {
+                "template": "/Member Row"
+              }
+            },
+            {
+              "id": "inv_create",
+              "type": "NewDbModelProperties",
+              "label": "An Invite naming only their address (owner is the backend's)",
+              "parameters": {
+                "collectionName": "Invite"
+              }
+            },
+            {
+              "id": "inv_mine",
+              "type": "DbCollection2",
+              "label": "My invitations (creator-owned: a query returns only mine)",
+              "parameters": {
+                "collectionName": "Invite",
+                "runOnChange-collectionName": false,
+                "runOnChange-querySettings": false
+              }
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "inv_address",
+              "fromProperty": "onTextChanged",
+              "toId": "inv_create",
+              "toProperty": "prop-withEmail"
+            },
+            {
+              "fromId": "inv_button",
+              "fromProperty": "onClick",
+              "toId": "inv_create",
+              "toProperty": "store"
+            },
+            {
+              "fromId": "inv_create",
+              "fromProperty": "error",
+              "toId": "inv_error",
+              "toProperty": "text"
+            },
+            {
+              "fromId": "inv_root",
+              "fromProperty": "didMount",
+              "toId": "inv_mine",
+              "toProperty": "storageFetch"
+            },
+            {
+              "fromId": "inv_create",
+              "fromProperty": "done",
+              "toId": "inv_mine",
+              "toProperty": "storageFetch"
+            },
+            {
+              "fromId": "inv_mine",
+              "fromProperty": "items",
+              "toId": "inv_list",
+              "toProperty": "items"
+            }
+          ]
+        },
+        {
+          "name": "/Group Note Row",
+          "nodes": [
+            {
+              "id": "gnr_root",
+              "type": "Group",
+              "label": "One note of the group",
+              "parameters": {
+                "flexDirection": "row",
+                "columnGap": "var(--space-2)",
+                "alignItems": "center"
+              },
+              "children": [
+                "gnr_title",
+                "gnr_save"
+              ]
+            },
+            {
+              "id": "gnr_title",
+              "type": "net.noodl.controls.textinput",
+              "label": "The note, editable by every member",
+              "parent": "gnr_root"
+            },
+            {
+              "id": "gnr_save",
+              "type": "net.noodl.controls.button",
+              "label": "Save the change",
+              "parent": "gnr_root",
+              "parameters": {
+                "label": "Save"
+              }
+            },
+            {
+              "id": "gnr_inputs",
+              "type": "Component Inputs",
+              "label": "Note in",
+              "ports": [
+                {
+                  "name": "title",
+                  "plug": "output",
+                  "type": "*"
+                }
+              ]
+            },
+            {
+              "id": "gnr_update",
+              "type": "SetDbModelProperties",
+              "label": "Change this note (the group's role may write it)",
+              "parameters": {
+                "collectionName": "Note",
+                "idSource": "foreach"
+              }
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "gnr_inputs",
+              "fromProperty": "title",
+              "toId": "gnr_title",
+              "toProperty": "startValue"
+            },
+            {
+              "fromId": "gnr_title",
+              "fromProperty": "onTextChanged",
+              "toId": "gnr_update",
+              "toProperty": "prop-title"
+            },
+            {
+              "fromId": "gnr_save",
+              "fromProperty": "onClick",
+              "toId": "gnr_update",
+              "toProperty": "store"
+            }
+          ]
+        },
+        {
+          "name": "/Group Notes",
+          "nodes": [
+            {
+              "id": "grp_root",
+              "type": "Group",
+              "label": "The notes of the group I am in",
+              "parameters": {
+                "flexDirection": "column",
+                "rowGap": "var(--space-3)"
+              },
+              "children": [
+                "grp_title",
+                "grp_add",
+                "grp_list"
+              ]
+            },
+            {
+              "id": "grp_title",
+              "type": "net.noodl.controls.textinput",
+              "label": "A new note",
+              "parent": "grp_root",
+              "parameters": {
+                "placeholder": "A new note"
+              }
+            },
+            {
+              "id": "grp_add",
+              "type": "net.noodl.controls.button",
+              "label": "Add it to the group",
+              "parent": "grp_root",
+              "parameters": {
+                "label": "Add"
+              }
+            },
+            {
+              "id": "grp_list",
+              "type": "For Each",
+              "label": "One row per note of the group",
+              "parent": "grp_root",
+              "parameters": {
+                "template": "/Group Note Row"
+              }
+            },
+            {
+              "id": "grp_join",
+              "type": "CloudFunction2",
+              "label": "Which group am I in (the server decides)",
+              "parameters": {
+                "function": "Cloud Functions/Join Group"
+              }
+            },
+            {
+              "id": "grp_notes",
+              "type": "DbCollection2",
+              "label": "The group's notes: owned by the group's owner",
+              "parameters": {
+                "collectionName": "Note",
+                "visualFilter": {
+                  "combinator": "and",
+                  "rules": [
+                    {
+                      "property": "owner",
+                      "operator": "equal to",
+                      "input": "group"
+                    }
+                  ]
+                },
+                "visualSort": [
+                  {
+                    "property": "createdAt",
+                    "order": "ascending"
+                  }
+                ],
+                "runOnChange-collectionName": false,
+                "runOnChange-querySettings": false
+              }
+            },
+            {
+              "id": "grp_add_call",
+              "type": "CloudFunction2",
+              "label": "Add a note to the group (the server checks I am in it)",
+              "parameters": {
+                "function": "Cloud Functions/Add To Group"
+              }
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "grp_root",
+              "fromProperty": "didMount",
+              "toId": "grp_join",
+              "toProperty": "call"
+            },
+            {
+              "fromId": "grp_join",
+              "fromProperty": "out-group",
+              "toId": "grp_notes",
+              "toProperty": "qp-group"
+            },
+            {
+              "fromId": "grp_join",
+              "fromProperty": "done",
+              "toId": "grp_notes",
+              "toProperty": "storageFetch"
+            },
+            {
+              "fromId": "grp_notes",
+              "fromProperty": "items",
+              "toId": "grp_list",
+              "toProperty": "items"
+            },
+            {
+              "fromId": "grp_title",
+              "fromProperty": "onTextChanged",
+              "toId": "grp_add_call",
+              "toProperty": "in-title"
+            },
+            {
+              "fromId": "grp_join",
+              "fromProperty": "out-group",
+              "toId": "grp_add_call",
+              "toProperty": "in-group"
+            },
+            {
+              "fromId": "grp_add",
+              "fromProperty": "onClick",
+              "toId": "grp_add_call",
+              "toProperty": "call"
+            },
+            {
+              "fromId": "grp_add_call",
+              "fromProperty": "done",
+              "toId": "grp_notes",
+              "toProperty": "storageFetch"
+            }
+          ]
+        },
+        {
+          "name": "/#__cloud__/Cloud Functions/Join Group",
+          "nodes": [
+            {
+              "id": "jg_request",
+              "type": "noodl.cloud.request",
+              "label": "The caller (no parameters: nothing to forge)",
+              "parameters": {
+                "allowNoAuth": false
+              }
+            },
+            {
+              "id": "jg_me",
+              "type": "net.noodl.user.User",
+              "label": "The caller's own session"
+            },
+            {
+              "id": "jg_invites",
+              "type": "DbCollection2",
+              "label": "Every invitation",
+              "parameters": {
+                "collectionName": "Invite",
+                "runOnChange-collectionName": false,
+                "runOnChange-querySettings": false
+              }
+            },
+            {
+              "id": "jg_pick",
+              "type": "JavaScriptFunction",
+              "label": "The group of whoever invited this address: the invitation's owner",
+              "parameters": {
+                "functionScript": "if (Inputs.me === undefined || Inputs.email === undefined || Inputs.invites === undefined) return;\nconst me = String(Inputs.me || '');\nconst email = String(Inputs.email || '').trim().toLowerCase();\n// The group an invitation lets you into is the person who MADE it: its owner, which the backend wrote\n// from their session and nobody can change. Never a group id the invitation carries: anyone signed in\n// can create an invitation naming any group. Your own invitations are not a way in to anything.\nconst mine = Inputs.invites\n  .filter((i) => email !== '' && String(i.withEmail || '').trim().toLowerCase() === email && String(i.owner) !== me)\n  .sort((a, b) => String(a.createdAt || '').localeCompare(String(b.createdAt || '')));\nconst invite = mine[0];\nif (!invite) {\n  // Nobody invited this address: the caller's group is their own.\n  Outputs.group = me;\n  Outputs.none();\n  return;\n}\n// Remember who took the invitation up, so its owner can take it back (Remove Member).\nawait Noodl.Records.save(invite.id || invite.objectId, { memberId: me }, { className: 'Invite' });\nOutputs.group = String(invite.owner);\nOutputs.userId = me;\nOutputs.role = 'members-of-' + String(invite.owner);\nOutputs.join();"
+              }
+            },
+            {
+              "id": "jg_join",
+              "type": "noodl.cloud.addusertorole",
+              "label": "Put the caller in that group's role",
+              "parameters": {
+                "createRole": true
+              }
+            },
+            {
+              "id": "jg_ok",
+              "type": "noodl.cloud.response",
+              "label": "The group this caller is in",
+              "parameters": {
+                "params": "group"
+              }
+            },
+            {
+              "id": "jg_fail",
+              "type": "noodl.cloud.response",
+              "label": "Tell the caller it went wrong",
+              "parameters": {
+                "status": "failure"
+              }
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "jg_request",
+              "fromProperty": "receive",
+              "toId": "jg_me",
+              "toProperty": "fetch"
+            },
+            {
+              "fromId": "jg_request",
+              "fromProperty": "receive",
+              "toId": "jg_invites",
+              "toProperty": "storageFetch"
+            },
+            {
+              "fromId": "jg_me",
+              "fromProperty": "id",
+              "toId": "jg_pick",
+              "toProperty": "in-me"
+            },
+            {
+              "fromId": "jg_me",
+              "fromProperty": "email",
+              "toId": "jg_pick",
+              "toProperty": "in-email"
+            },
+            {
+              "fromId": "jg_invites",
+              "fromProperty": "items",
+              "toId": "jg_pick",
+              "toProperty": "in-invites"
+            },
+            {
+              "fromId": "jg_pick",
+              "fromProperty": "out-role",
+              "toId": "jg_join",
+              "toProperty": "role"
+            },
+            {
+              "fromId": "jg_pick",
+              "fromProperty": "out-userId",
+              "toId": "jg_join",
+              "toProperty": "userId"
+            },
+            {
+              "fromId": "jg_pick",
+              "fromProperty": "out-join",
+              "toId": "jg_join",
+              "toProperty": "add"
+            },
+            {
+              "fromId": "jg_pick",
+              "fromProperty": "out-group",
+              "toId": "jg_ok",
+              "toProperty": "pm-group"
+            },
+            {
+              "fromId": "jg_pick",
+              "fromProperty": "out-none",
+              "toId": "jg_ok",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "jg_join",
+              "fromProperty": "done",
+              "toId": "jg_ok",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "jg_join",
+              "fromProperty": "unchanged",
+              "toId": "jg_ok",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "jg_pick",
+              "fromProperty": "error",
+              "toId": "jg_fail",
+              "toProperty": "errorMessage"
+            },
+            {
+              "fromId": "jg_join",
+              "fromProperty": "error",
+              "toId": "jg_fail",
+              "toProperty": "errorMessage"
+            },
+            {
+              "fromId": "jg_pick",
+              "fromProperty": "failure",
+              "toId": "jg_fail",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "jg_join",
+              "fromProperty": "failure",
+              "toId": "jg_fail",
+              "toProperty": "send"
+            }
+          ]
+        },
+        {
+          "name": "/#__cloud__/Cloud Functions/Add To Group",
+          "nodes": [
+            {
+              "id": "ag_request",
+              "type": "noodl.cloud.request",
+              "label": "A note, and the group it is for",
+              "parameters": {
+                "allowNoAuth": false,
+                "params": "title,group"
+              }
+            },
+            {
+              "id": "ag_me",
+              "type": "net.noodl.user.User",
+              "label": "The caller's own session, and the roles it carries"
+            },
+            {
+              "id": "ag_add",
+              "type": "JavaScriptFunction",
+              "label": "Only a member writes, and the note is the group owner's",
+              "parameters": {
+                "functionScript": "if (Inputs.me === undefined || Inputs.roles === undefined || Inputs.group === undefined) return;\nconst me = String(Inputs.me || '');\nconst group = String(Inputs.group || '');\nconst roles = Array.isArray(Inputs.roles) ? Inputs.roles : [];\n// The group a caller may add to: their own, or one whose role their own session carries. The role is\n// only ever granted by Join Group, from an invitation's owner, so a group id sent here proves nothing.\nif (group === '' || (group !== me && !roles.includes('members-of-' + group))) {\n  Outputs.reason = 'You are not a member of this group.';\n  Outputs.refused();\n  return;\n}\n// Created as the system, so the record's owner is the GROUP's owner (a page could never name it), and\n// its access rules are the owner and the group's role: every member reads and changes it.\nconst acl = {};\nacl[group] = { read: true, write: true };\nacl['role:members-of-' + group] = { read: true, write: true };\nconst note = await Noodl.Records.create('Note', { title: String(Inputs.title || ''), owner: group }, { acl });\nOutputs.id = note.getId();\nOutputs.added();"
+              }
+            },
+            {
+              "id": "ag_ok",
+              "type": "noodl.cloud.response",
+              "label": "The new note",
+              "parameters": {
+                "params": "id"
+              }
+            },
+            {
+              "id": "ag_fail",
+              "type": "noodl.cloud.response",
+              "label": "Refused, or it went wrong",
+              "parameters": {
+                "status": "failure"
+              }
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "ag_request",
+              "fromProperty": "receive",
+              "toId": "ag_me",
+              "toProperty": "fetch"
+            },
+            {
+              "fromId": "ag_me",
+              "fromProperty": "id",
+              "toId": "ag_add",
+              "toProperty": "in-me"
+            },
+            {
+              "fromId": "ag_me",
+              "fromProperty": "roles",
+              "toId": "ag_add",
+              "toProperty": "in-roles"
+            },
+            {
+              "fromId": "ag_request",
+              "fromProperty": "pm-group",
+              "toId": "ag_add",
+              "toProperty": "in-group"
+            },
+            {
+              "fromId": "ag_request",
+              "fromProperty": "pm-title",
+              "toId": "ag_add",
+              "toProperty": "in-title"
+            },
+            {
+              "fromId": "ag_add",
+              "fromProperty": "out-id",
+              "toId": "ag_ok",
+              "toProperty": "pm-id"
+            },
+            {
+              "fromId": "ag_add",
+              "fromProperty": "out-added",
+              "toId": "ag_ok",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "ag_add",
+              "fromProperty": "out-reason",
+              "toId": "ag_fail",
+              "toProperty": "errorMessage"
+            },
+            {
+              "fromId": "ag_add",
+              "fromProperty": "out-refused",
+              "toId": "ag_fail",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "ag_add",
+              "fromProperty": "error",
+              "toId": "ag_fail",
+              "toProperty": "errorMessage"
+            },
+            {
+              "fromId": "ag_add",
+              "fromProperty": "failure",
+              "toId": "ag_fail",
+              "toProperty": "send"
+            }
+          ]
+        },
+        {
+          "name": "/#__cloud__/Cloud Functions/Remove Member",
+          "nodes": [
+            {
+              "id": "rm_request",
+              "type": "noodl.cloud.request",
+              "label": "The address whose invitation the caller takes back",
+              "parameters": {
+                "allowNoAuth": false,
+                "params": "withEmail"
+              }
+            },
+            {
+              "id": "rm_me",
+              "type": "net.noodl.user.User",
+              "label": "The caller's own session"
+            },
+            {
+              "id": "rm_invites",
+              "type": "DbCollection2",
+              "label": "Every invitation",
+              "parameters": {
+                "collectionName": "Invite",
+                "runOnChange-collectionName": false,
+                "runOnChange-querySettings": false
+              }
+            },
+            {
+              "id": "rm_pick",
+              "type": "JavaScriptFunction",
+              "label": "The caller's own invitation, and the member who took it up",
+              "parameters": {
+                "functionScript": "if (Inputs.me === undefined || Inputs.withEmail === undefined || Inputs.invites === undefined) return;\nconst me = String(Inputs.me || '');\nconst email = String(Inputs.withEmail || '').trim().toLowerCase();\n// Only the caller's own invitations, and only the caller's own group: whatever an invitation says, the\n// role taken away is the caller's.\nconst mine = Inputs.invites.filter(\n  (i) => String(i.owner) === me && String(i.withEmail || '').trim().toLowerCase() === email\n);\nif (mine.length === 0) {\n  Outputs.reason = 'You have not invited that address.';\n  Outputs.refused();\n  return;\n}\nconst member = mine.map((i) => String(i.memberId || '')).find((m) => m !== '') || '';\nfor (const i of mine) await Noodl.Records.delete(i.id || i.objectId, { className: 'Invite' });\nif (member === '') {\n  Outputs.removed();\n  return;\n}\nOutputs.userId = member;\nOutputs.role = 'members-of-' + me;\nOutputs.remove();"
+              }
+            },
+            {
+              "id": "rm_role",
+              "type": "noodl.cloud.removeuserfromrole",
+              "label": "Take them out of the caller's group"
+            },
+            {
+              "id": "rm_ok",
+              "type": "noodl.cloud.response",
+              "label": "Taken back"
+            },
+            {
+              "id": "rm_fail",
+              "type": "noodl.cloud.response",
+              "label": "Refused, or it went wrong",
+              "parameters": {
+                "status": "failure"
+              }
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "rm_request",
+              "fromProperty": "receive",
+              "toId": "rm_me",
+              "toProperty": "fetch"
+            },
+            {
+              "fromId": "rm_request",
+              "fromProperty": "receive",
+              "toId": "rm_invites",
+              "toProperty": "storageFetch"
+            },
+            {
+              "fromId": "rm_me",
+              "fromProperty": "id",
+              "toId": "rm_pick",
+              "toProperty": "in-me"
+            },
+            {
+              "fromId": "rm_request",
+              "fromProperty": "pm-withEmail",
+              "toId": "rm_pick",
+              "toProperty": "in-withEmail"
+            },
+            {
+              "fromId": "rm_invites",
+              "fromProperty": "items",
+              "toId": "rm_pick",
+              "toProperty": "in-invites"
+            },
+            {
+              "fromId": "rm_pick",
+              "fromProperty": "out-role",
+              "toId": "rm_role",
+              "toProperty": "role"
+            },
+            {
+              "fromId": "rm_pick",
+              "fromProperty": "out-userId",
+              "toId": "rm_role",
+              "toProperty": "userId"
+            },
+            {
+              "fromId": "rm_pick",
+              "fromProperty": "out-remove",
+              "toId": "rm_role",
+              "toProperty": "remove"
+            },
+            {
+              "fromId": "rm_pick",
+              "fromProperty": "out-removed",
+              "toId": "rm_ok",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "rm_role",
+              "fromProperty": "done",
+              "toId": "rm_ok",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "rm_role",
+              "fromProperty": "unchanged",
+              "toId": "rm_ok",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "rm_pick",
+              "fromProperty": "out-reason",
+              "toId": "rm_fail",
+              "toProperty": "errorMessage"
+            },
+            {
+              "fromId": "rm_pick",
+              "fromProperty": "out-refused",
+              "toId": "rm_fail",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "rm_pick",
+              "fromProperty": "error",
+              "toId": "rm_fail",
+              "toProperty": "errorMessage"
+            },
+            {
+              "fromId": "rm_role",
+              "fromProperty": "error",
+              "toId": "rm_fail",
+              "toProperty": "errorMessage"
+            },
+            {
+              "fromId": "rm_pick",
+              "fromProperty": "failure",
+              "toId": "rm_fail",
+              "toProperty": "send"
+            },
+            {
+              "fromId": "rm_role",
+              "fromProperty": "failure",
+              "toId": "rm_fail",
+              "toProperty": "send"
+            }
+          ]
+        }
+      ]
+    },
     {
       "id": "cloud-query-own-rows",
       "title": "Only my records: a Query Records filtered on the server by the signed-in user's id",
@@ -74541,7 +75416,7 @@
               "label": "Update note",
               "parameters": {
                 "collectionName": "Note",
-                "idSource": "value"
+                "idSource": "explicit"
               }
             },
             {
@@ -74550,7 +75425,7 @@
               "label": "Delete note",
               "parameters": {
                 "collectionName": "Note",
-                "idSource": "value"
+                "idSource": "explicit"
               }
             }
           ],
@@ -75001,7 +75876,7 @@
       ],
       "components": [
         {
-          "name": "/Cloud Functions/Revoke Role",
+          "name": "/#__cloud__/Cloud Functions/Revoke Role",
           "nodes": [
             {
               "id": "fn_request",
@@ -75589,7 +76464,7 @@
       ],
       "components": [
         {
-          "name": "/Cloud Functions/Issue Partner Token",
+          "name": "/#__cloud__/Cloud Functions/Issue Partner Token",
           "nodes": [
             {
               "id": "fn_request",
@@ -76217,7 +77092,7 @@
       ],
       "components": [
         {
-          "name": "/Cloud Functions/List Role Members",
+          "name": "/#__cloud__/Cloud Functions/List Role Members",
           "nodes": [
             {
               "id": "fn_request",
@@ -76429,7 +77304,7 @@
               "type": "Javascript2",
               "label": "Extract headline",
               "parameters": {
-                "code": "script.inputs = { response: 'object' };\nscript.outputs = { headline: 'string' };\nscript.run = function (inputs, outputs) {\n  outputs.headline = inputs.response && inputs.response.items ? inputs.response.items[0].title : '';\n};"
+                "code": "Script.Inputs = { response: 'object' };\nScript.Outputs = { headline: 'string' };\n\n// Each response sets the headline: the first item's title, or nothing when the answer has no items.\nScript.Setters.response = function (response) {\n  Script.setOutputs({ headline: response && response.items && response.items.length ? response.items[0].title : '' });\n};"
               }
             },
             {
@@ -76745,9 +77620,7 @@
                 {
                   "name": "Clicked",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 0
                 }
               ]
@@ -76759,135 +77632,105 @@
                 {
                   "name": "text",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "General",
                   "index": 2
                 },
                 {
                   "name": "css-class",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "General",
                   "index": 1
                 },
                 {
                   "name": "padding top",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Margin and padding",
                   "index": 3
                 },
                 {
                   "name": "padding bottom",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Margin and padding",
                   "index": 4
                 },
                 {
                   "name": "padding left",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Margin and padding",
                   "index": 5
                 },
                 {
                   "name": "padding right",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Margin and padding",
                   "index": 6
                 },
                 {
                   "name": "margin top",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Margin and padding",
                   "index": 7
                 },
                 {
                   "name": "margin bottom",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Margin and padding",
                   "index": 8
                 },
                 {
                   "name": "margin left",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Margin and padding",
                   "index": 9
                 },
                 {
                   "name": "margin right",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Margin and padding",
                   "index": 10
                 },
                 {
                   "name": "mounted",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "General",
                   "index": 0
                 },
                 {
                   "name": "align horizontal",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Other",
                   "index": 11
                 },
                 {
                   "name": "align vertical",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Other",
                   "index": 12
                 },
                 {
                   "name": "position",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Other",
                   "index": 13
                 },
                 {
                   "name": "layout",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Other",
                   "index": 14
                 }
@@ -77067,17 +77910,13 @@
                 {
                   "name": "Do",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 0
                 },
                 {
                   "name": "JsonArray",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 1
                 }
               ]
@@ -77139,54 +77978,42 @@
                 {
                   "name": "File",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "General",
                   "index": 0
                 },
                 {
                   "name": "Path",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Metadata",
                   "index": 1
                 },
                 {
                   "name": "Name",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Metadata",
                   "index": 2
                 },
                 {
                   "name": "Size in bytes",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Metadata",
                   "index": 3
                 },
                 {
                   "name": "Type",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Metadata",
                   "index": 4
                 },
                 {
                   "name": "Success",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Events",
                   "index": 5
                 }
@@ -77226,18 +78053,14 @@
                 {
                   "name": "Enable File Picker on click",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Dropzone",
                   "index": 0
                 },
                 {
                   "name": "Accepted file types",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Dropzone",
                   "index": 1
                 }
@@ -77269,54 +78092,42 @@
                 {
                   "name": "File",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "General",
                   "index": 0
                 },
                 {
                   "name": "Path",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Metadata",
                   "index": 1
                 },
                 {
                   "name": "Name",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Metadata",
                   "index": 2
                 },
                 {
                   "name": "Size in bytes",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Metadata",
                   "index": 3
                 },
                 {
                   "name": "Type",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Metadata",
                   "index": 4
                 },
                 {
                   "name": "Success",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Events",
                   "index": 5
                 }
@@ -77773,108 +78584,84 @@
                 {
                   "name": "title",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "General search engine",
                   "index": 1
                 },
                 {
                   "name": "description",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "General search engine",
                   "index": 2
                 },
                 {
                   "name": "og:title",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Open Graph",
                   "index": 4
                 },
                 {
                   "name": "og:description",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Open Graph",
                   "index": 5
                 },
                 {
                   "name": "og:image",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Open Graph",
                   "index": 6
                 },
                 {
                   "name": "og:type",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Open Graph",
                   "index": 9
                 },
                 {
                   "name": "og:url (override default)",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Open Graph",
                   "index": 10
                 },
                 {
                   "name": "robots",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "General search engine",
                   "index": 3
                 },
                 {
                   "name": "twitter:title",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Twitter",
                   "index": 11
                 },
                 {
                   "name": "twitter:description",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Twitter",
                   "index": 12
                 },
                 {
                   "name": "twitter:card",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Twitter",
                   "index": 13
                 },
                 {
                   "name": "twitter:image",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "group": "Twitter",
                   "index": 14
                 }
@@ -78381,17 +79168,13 @@
                 {
                   "name": "uploadRecordCreated",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 1
                 },
                 {
                   "name": "absoluteFilePathCreated",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 2
                 }
               ]
@@ -78949,25 +79732,19 @@
                 {
                   "name": "Html Content",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 1
                 },
                 {
                   "name": "Changed",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 2
                 },
                 {
                   "name": "Saved",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 3
                 }
               ]
@@ -78979,17 +79756,13 @@
                 {
                   "name": "Initial Content",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 1
                 },
                 {
                   "name": "Update Content",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 2
                 }
               ]
@@ -79093,7 +79866,7 @@
     {
       "id": "community-tiptap-text-editor",
       "title": "A rich-text editor with a toolbar and local drafts",
-      "description": "The larger companion to the single-button component: a `Static Data` node holds the list of toolbar commands, a `For Each` draws one button per entry, and the editor itself is mounted by a `JavaScriptFunction` onto a `Group`'s element. Two details are worth more than the editor. The draft is saved to `localStorage` on a `Timer` and read back on mount, which is the whole of 'don't lose my work' and costs two function nodes. And `Model2` plus `SetModelProperties` keep the document in the project's own data model rather than only inside the third-party editor, so something other than the editor can read what was typed. ⚠️ The toolbar is driven by data, so adding a command is a row in the `Static Data` node — not a new button.",
+      "description": "The larger companion to the single-button component: a `Static Data` node holds the list of toolbar commands, a `For Each` draws one button per entry, and the editor itself is mounted by a `JavaScriptFunction` onto a `Group`'s element. Two details are worth more than the editor. The draft is saved to `localStorage` on a `Timer` and read back on mount, which is the whole of 'don't lose my work' and costs two function nodes. And `Model2` plus `SetModelProperties` keep the document in the project's own data model rather than only inside the third-party editor, so something other than the editor can read what was typed. ⚠️ The toolbar is driven by data, so adding a command is a row in the `Static Data` node — not a new button. Each row is the companion example's button component, `/Tiptap text editor r` (`community-tiptap-text-editor-r`): write that one first.",
       "demonstrates": [
         "Boolean",
         "CSS Definition",
@@ -79155,7 +79928,7 @@
               "type": "For Each",
               "parent": "menu",
               "parameters": {
-                "template": "/#Experiments/experiments/Tiptap editor/Editor button"
+                "template": "/Tiptap text editor r"
               }
             },
             {
@@ -79470,7 +80243,7 @@
             },
             {
               "fromId": "setmodelproperties",
-              "fromProperty": "stored",
+              "fromProperty": "done",
               "toId": "model2",
               "toProperty": "fetch"
             },
@@ -79608,17 +80381,13 @@
                 {
                   "name": "buttonType",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 1
                 },
                 {
                   "name": "editor",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 2
                 }
               ]
@@ -79664,17 +80433,13 @@
                 {
                   "name": "Success",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 1
                 },
                 {
                   "name": "buttonClicked",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 2
                 }
               ]
@@ -79892,17 +80657,13 @@
                 {
                   "name": "videoURL",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 1
                 },
                 {
                   "name": "uploadId",
                   "plug": "input",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 2
                 }
               ]
@@ -79914,9 +80675,7 @@
                 {
                   "name": "assignmentId",
                   "plug": "output",
-                  "type": {
-                    "name": "*"
-                  },
+                  "type": "*",
                   "index": 1
                 }
               ]
@@ -80590,7 +81349,7 @@
             },
             {
               "fromId": "draft_object",
-              "fromProperty": "title",
+              "fromProperty": "prop-title",
               "toId": "draft_title_text",
               "toProperty": "text"
             }
@@ -81056,7 +81815,7 @@
               "parent": "row",
               "parameters": {
                 "useLabel": true,
-                "labelSpacing": "8px"
+                "labelSpacing": "var(--space-2)"
               }
             },
             {
@@ -82718,7 +83477,7 @@
     {
       "id": "fn-aggregate-stats-function",
       "title": "Server-side aggregation exposed as a cloud function",
-      "description": "Aggregate Records runs count/sum/min/max/average over a database class without transferring the records — it exists only in the cloud runtime, so the idiomatic shape is a small cloud function around it: Request triggers the aggregate's fetch, `fetched` sends the Response, and the aggregate results (outputs generated from the `aggregates` configuration) are returned as response params. The browser calls it like any cloud function and renders the statistic.",
+      "description": "Aggregate Records runs a sum, min, max or average over a number column (or the distinct values of a text column) of a database class without transferring the records — it exists only in the cloud runtime, so the idiomatic shape is a small cloud function around it: Request triggers the aggregate's fetch, `fetched` sends the Response, and each name in `aggregates` gets its own Property and Operation inputs (`aggprop-<name>`, `aggop-<name>`) and its result on `agg-<name>`, returned as a response param. Here that is `totalHours`, the sum of every task's `hours`. There is no count operation: for a count, use Query Records with Fetch total count on. The browser calls the function like any cloud function and renders the statistic.",
       "demonstrates": [
         "noodl.cloud.aggregate",
         "CloudFunction2",
@@ -82738,7 +83497,7 @@
               },
               "children": [
                 "refresh_btn",
-                "count_text"
+                "total_text"
               ]
             },
             {
@@ -82751,9 +83510,9 @@
               }
             },
             {
-              "id": "count_text",
+              "id": "total_text",
               "type": "Text",
-              "label": "Task count",
+              "label": "Total hours",
               "parent": "root"
             },
             {
@@ -82774,8 +83533,8 @@
             },
             {
               "fromId": "call_stats",
-              "fromProperty": "out-taskCount",
-              "toId": "count_text",
+              "fromProperty": "out-totalHours",
+              "toId": "total_text",
               "toProperty": "text"
             }
           ]
@@ -82789,12 +83548,14 @@
               "label": "Request"
             },
             {
-              "id": "count_tasks",
+              "id": "sum_hours",
               "type": "noodl.cloud.aggregate",
-              "label": "Count tasks",
+              "label": "Sum task hours",
               "parameters": {
                 "collectionName": "Task",
-                "aggregates": "taskCount"
+                "aggregates": "totalHours",
+                "aggprop-totalHours": "hours",
+                "aggop-totalHours": "sum"
               }
             },
             {
@@ -82802,7 +83563,7 @@
               "type": "noodl.cloud.response",
               "label": "Response",
               "parameters": {
-                "params": "taskCount"
+                "params": "totalHours"
               }
             },
             {
@@ -82818,29 +83579,29 @@
             {
               "fromId": "fn_request",
               "fromProperty": "receive",
-              "toId": "count_tasks",
+              "toId": "sum_hours",
               "toProperty": "fetch"
             },
             {
-              "fromId": "count_tasks",
-              "fromProperty": "taskCount",
+              "fromId": "sum_hours",
+              "fromProperty": "agg-totalHours",
               "toId": "fn_response",
-              "toProperty": "pm-taskCount"
+              "toProperty": "pm-totalHours"
             },
             {
-              "fromId": "count_tasks",
+              "fromId": "sum_hours",
               "fromProperty": "fetched",
               "toId": "fn_response",
               "toProperty": "send"
             },
             {
-              "fromId": "count_tasks",
+              "fromId": "sum_hours",
               "fromProperty": "error",
               "toId": "fn_fail_response",
               "toProperty": "errorMessage"
             },
             {
-              "fromId": "count_tasks",
+              "fromId": "sum_hours",
               "fromProperty": "failure",
               "toId": "fn_fail_response",
               "toProperty": "send"
@@ -83243,7 +84004,7 @@
       ],
       "components": [
         {
-          "name": "/Cloud Functions/Notify",
+          "name": "/#__cloud__/Cloud Functions/Notify",
           "nodes": [
             {
               "id": "fn_request",
@@ -85420,6 +86181,176 @@
         }
       ]
     },
+    {
+      "id": "option-set",
+      "title": "A fixed list as an option set: the languages, read by a dropdown, the choice stored by a Set Variable",
+      "description": "A fixed list (a language, a status, a priority) lives in ONE place: a logic component under `Option sets/<Name>` holding one `Static Data` node with the list as a JSON array, published through `Component Outputs` as `items` and `count`. NodeGX Studio lists every component under `Option sets/` in Data → Option sets, where the person adds or renames an option themselves, and the NodeGX editor shows it as the Static Data node it is. A page places an instance and wires its `items` wherever the list is needed (a Dropdown here; a `For Each` of buttons works the same). The step that stores the person's choice takes the chosen row's value from the control, so no literal like \"fr\" or \"en\" is typed into a Set Variable anywhere: two steps typing two literals into one variable are a fixed list the project does not have, and the next language means editing every one of them. Each row carries `Label` (what the person reads) and `Value` (what the app stores), the two fields a Dropdown reads off each item.",
+      "demonstrates": [
+        "Static Data",
+        "Component Outputs",
+        "net.noodl.controls.options",
+        "Set Variable",
+        "Variable2"
+      ],
+      "components": [
+        {
+          "name": "/Option sets/Languages",
+          "nodes": [
+            {
+              "id": "options",
+              "type": "Static Data",
+              "label": "Languages · the options",
+              "parameters": {
+                "type": "json",
+                "json": "[{\"Label\":\"English\",\"Value\":\"en\"},{\"Label\":\"Français\",\"Value\":\"fr\"}]"
+              }
+            },
+            {
+              "id": "out",
+              "type": "Component Outputs",
+              "label": "What the page reads",
+              "ports": [
+                {
+                  "name": "items",
+                  "plug": "input",
+                  "type": "array"
+                },
+                {
+                  "name": "count",
+                  "plug": "input",
+                  "type": "number"
+                }
+              ]
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "options",
+              "fromProperty": "items",
+              "toId": "out",
+              "toProperty": "items"
+            },
+            {
+              "fromId": "options",
+              "fromProperty": "count",
+              "toId": "out",
+              "toProperty": "count"
+            }
+          ]
+        },
+        {
+          "name": "/Pages/Language",
+          "nodes": [
+            {
+              "id": "page",
+              "type": "Page",
+              "label": "Page",
+              "parameters": {
+                "title": "Language",
+                "urlPath": "language"
+              },
+              "children": [
+                "body"
+              ]
+            },
+            {
+              "id": "body",
+              "type": "Group",
+              "label": "Body",
+              "parent": "page",
+              "parameters": {
+                "width": {
+                  "value": 100,
+                  "unit": "%"
+                },
+                "sizeMode": "contentHeight",
+                "flexDirection": "column",
+                "rowGap": "var(--space-3)",
+                "paddingLeft": "var(--space-4)",
+                "paddingRight": "var(--space-4)",
+                "paddingTop": "var(--space-4)",
+                "paddingBottom": "var(--space-4)"
+              },
+              "children": [
+                "prompt",
+                "picker"
+              ]
+            },
+            {
+              "id": "prompt",
+              "type": "Text",
+              "label": "Prompt",
+              "parent": "body",
+              "parameters": {
+                "text": "Language"
+              }
+            },
+            {
+              "id": "picker",
+              "type": "net.noodl.controls.options",
+              "label": "Language picker",
+              "parent": "body",
+              "parameters": {
+                "placeholder": "Choose a language",
+                "sizeMode": "contentHeight",
+                "width": {
+                  "value": 100,
+                  "unit": "%"
+                }
+              }
+            },
+            {
+              "id": "languages",
+              "type": "/Option sets/Languages",
+              "label": "Languages"
+            },
+            {
+              "id": "store_language",
+              "type": "Set Variable",
+              "label": "Remember the language",
+              "parameters": {
+                "name": "language",
+                "setWith": "string"
+              }
+            },
+            {
+              "id": "read_language",
+              "type": "Variable2",
+              "label": "Current language",
+              "parameters": {
+                "name": "language"
+              }
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "languages",
+              "fromProperty": "items",
+              "toId": "picker",
+              "toProperty": "items"
+            },
+            {
+              "fromId": "picker",
+              "fromProperty": "value",
+              "toId": "store_language",
+              "toProperty": "value"
+            },
+            {
+              "fromId": "picker",
+              "fromProperty": "onChange",
+              "toId": "store_language",
+              "toProperty": "do"
+            },
+            {
+              "fromId": "read_language",
+              "fromProperty": "value",
+              "toId": "picker",
+              "toProperty": "value"
+            }
+          ]
+        }
+      ]
+    },
     {
       "id": "repeater-query-records",
       "title": "List page: Repeater fed by Query Records",
@@ -85534,6 +86465,158 @@
         }
       ]
     },
+    {
+      "id": "score-then-move-on",
+      "title": "Score an answer, then move on to the next question",
+      "description": "Two gates that act on one press, where the second changes what the first reads: moving on changes the question index, and the 'is the answer right?' check compares against that index. Wire both Evaluates from the press and the scoring gate reads the NEXT question, whichever order the wires are in, so every answer is scored against the wrong question. Chain them instead: the press evaluates the scoring gate, and the scoring gate's Done evaluates the move-on gate, so the score is decided before the index moves. Both gates have Run On Value Change unticked, so only the press asks them.",
+      "demonstrates": [
+        "Condition",
+        "Counter",
+        "Expression",
+        "net.noodl.controls.button",
+        "net.noodl.controls.textinput",
+        "Group"
+      ],
+      "components": [
+        {
+          "name": "/Quiz Step",
+          "nodes": [
+            {
+              "id": "root",
+              "type": "Group",
+              "label": "Question layout",
+              "parameters": {
+                "flexDirection": "column",
+                "paddingLeft": "var(--space-4)",
+                "paddingRight": "var(--space-4)",
+                "paddingTop": "var(--space-4)",
+                "paddingBottom": "var(--space-4)"
+              },
+              "children": [
+                "answer_input",
+                "next_button"
+              ]
+            },
+            {
+              "id": "answer_input",
+              "type": "net.noodl.controls.textinput",
+              "label": "Answer field",
+              "parent": "root",
+              "parameters": {
+                "placeholder": "Your answer"
+              }
+            },
+            {
+              "id": "next_button",
+              "type": "net.noodl.controls.button",
+              "label": "Next",
+              "parent": "root",
+              "parameters": {
+                "label": "Next"
+              }
+            },
+            {
+              "id": "question_index",
+              "type": "Counter",
+              "label": "Question index"
+            },
+            {
+              "id": "score",
+              "type": "Counter",
+              "label": "Score"
+            },
+            {
+              "id": "is_right",
+              "type": "Expression",
+              "label": "Answer is right?",
+              "parameters": {
+                "expression": "answer == ['Paris', 'Lisbon', 'Rome', 'Madrid', 'Berlin'][index]"
+              }
+            },
+            {
+              "id": "is_not_last",
+              "type": "Expression",
+              "label": "Not the last question?",
+              "parameters": {
+                "expression": "index < 4"
+              }
+            },
+            {
+              "id": "score_gate",
+              "type": "Condition",
+              "label": "Score if right",
+              "parameters": {
+                "runOnChange-condition": false
+              }
+            },
+            {
+              "id": "advance_gate",
+              "type": "Condition",
+              "label": "Move on if not last",
+              "parameters": {
+                "runOnChange-condition": false
+              }
+            }
+          ],
+          "connections": [
+            {
+              "fromId": "answer_input",
+              "fromProperty": "onTextChanged",
+              "toId": "is_right",
+              "toProperty": "answer"
+            },
+            {
+              "fromId": "question_index",
+              "fromProperty": "currentCount",
+              "toId": "is_right",
+              "toProperty": "index"
+            },
+            {
+              "fromId": "question_index",
+              "fromProperty": "currentCount",
+              "toId": "is_not_last",
+              "toProperty": "index"
+            },
+            {
+              "fromId": "is_right",
+              "fromProperty": "result",
+              "toId": "score_gate",
+              "toProperty": "condition"
+            },
+            {
+              "fromId": "is_not_last",
+              "fromProperty": "result",
+              "toId": "advance_gate",
+              "toProperty": "condition"
+            },
+            {
+              "fromId": "next_button",
+              "fromProperty": "onClick",
+              "toId": "score_gate",
+              "toProperty": "eval"
+            },
+            {
+              "fromId": "score_gate",
+              "fromProperty": "ontrue",
+              "toId": "score",
+              "toProperty": "increase"
+            },
+            {
+              "fromId": "score_gate",
+              "fromProperty": "done",
+              "toId": "advance_gate",
+              "toProperty": "eval"
+            },
+            {
+              "fromId": "advance_gate",
+              "fromProperty": "ontrue",
+              "toId": "question_index",
+              "toProperty": "increase"
+            }
+          ]
+        }
+      ]
+    },
     {
       "id": "send-event-across-components",
       "title": "Decoupled communication with Send Event / Receive Event",
@@ -86740,7 +87823,7 @@
     {
       "id": "ui-empty-state",
       "title": "Empty state: what a list shows when it has no rows",
-      "description": "A list with nothing in it should say what it is and what to do, not render nothing. The designed version is small and centred inside a dashed card: an icon in a muted disc, one heading, one line of explanation capped at ~380px, and exactly one action. The switch is one wire: the query's `isEmpty` boolean into the empty state's `mounted` input. Use `mounted`, not `visible` — `mounted` takes the element out of the layout, while `visible` only hides it and keeps the space it occupies, which leaves a page-height hole above your empty state. The list needs no gate at all: a `For Each` over an empty array renders no rows and occupies no height, so nothing has to be inverted and no logic node is involved. Skipping the empty state is the difference between an app that looks unfinished on first run and one that does not, and first run is when it is always seen.",
+      "description": "A list with nothing in it should say what it is and what to do, not render nothing. The designed version is small and centred inside a dashed card: an icon in a muted disc, one heading, one line of explanation capped at ~380px, and exactly one action. The switch is one wire: the query's `isEmpty` boolean into the `mounted` input of a Group that holds the empty state. A placed component has no `mounted` or `visible` of its own, so the wire goes to the Group around it. Use `mounted`, not `visible` — `mounted` takes the element out of the layout, while `visible` only hides it and keeps the space it occupies, which leaves a page-height hole above your empty state. The list needs no gate at all: a `For Each` over an empty array renders no rows and occupies no height, so nothing has to be inverted and no logic node is involved. Skipping the empty state is the difference between an app that looks unfinished on first run and one that does not, and first run is when it is always seen.",
       "demonstrates": [
         "Group",
         "net.noodl.visual.icon",
@@ -86807,7 +87890,7 @@
               "children": [
                 "heading",
                 "list",
-                "empty"
+                "emptyWrap"
               ]
             },
             {
@@ -86831,11 +87914,27 @@
               },
               "parent": "shell"
             },
+            {
+              "id": "emptyWrap",
+              "type": "Group",
+              "label": "Shown only when the query is empty",
+              "parameters": {
+                "width": {
+                  "value": 100,
+                  "unit": "%"
+                },
+                "flexDirection": "column"
+              },
+              "parent": "shell",
+              "children": [
+                "empty"
+              ]
+            },
             {
               "id": "empty",
               "type": "/Components/EmptyState",
-              "label": "Shown only when the query is empty",
-              "parent": "shell"
+              "label": "The empty state",
+              "parent": "emptyWrap"
             },
             {
               "id": "query",
@@ -86856,7 +87955,7 @@
             {
               "fromId": "query",
               "fromProperty": "isEmpty",
-              "toId": "empty",
+              "toId": "emptyWrap",
               "toProperty": "mounted"
             }
           ]
@@ -92952,7 +94051,7 @@
     {
       "id": "user-login-flow",
       "title": "Log in, show the user, log out",
-      "description": "The authentication triangle: Log In takes `username`/`password` values and a `login` signal, firing `success` or `failure` (+`error`). The User node is the session's single source of truth — its `authenticated` boolean and profile outputs update on login/logout, so UI binds to it rather than to the action nodes. Log Out ends the session from anywhere. Gate visible areas on `authenticated`, not on the login node's `success` pulse.",
+      "description": "The authentication triangle: Log In takes `username`/`password` values and a `login` signal, firing `done` or `failure` (+`error`). The User node is the session's single source of truth — its `authenticated` boolean and profile outputs update on login/logout, so UI binds to it rather than to the action nodes. Log Out ends the session from anywhere. Gate visible areas on `authenticated`, not on the login node's `done` pulse.",
       "demonstrates": [
         "net.noodl.user.LogIn",
         "net.noodl.user.LogOut",