@nodegx/mcp 0.2.7 → 0.2.8

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodegx-mcp-bundles",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "private": true,
   "description": "Build metadata for the bundled CLIs beside it. See build-cloud-bundle.mjs: @noodl/platform reads it."
 }

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

@@ -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)."
         ],
@@ -51302,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": {
@@ -53520,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": {
@@ -56156,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": {
@@ -58360,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": {
@@ -60786,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": {
@@ -63679,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"
@@ -69257,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",
@@ -75415,7 +75416,7 @@
               "label": "Update note",
               "parameters": {
                 "collectionName": "Note",
-                "idSource": "value"
+                "idSource": "explicit"
               }
             },
             {
@@ -75424,7 +75425,7 @@
               "label": "Delete note",
               "parameters": {
                 "collectionName": "Note",
-                "idSource": "value"
+                "idSource": "explicit"
               }
             }
           ],
@@ -86180,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",
@@ -86294,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",
@@ -87500,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",
@@ -87567,7 +87890,7 @@
               "children": [
                 "heading",
                 "list",
-                "empty"
+                "emptyWrap"
               ]
             },
             {
@@ -87591,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",
@@ -87616,7 +87955,7 @@
             {
               "fromId": "query",
               "fromProperty": "isEmpty",
-              "toId": "empty",
+              "toId": "emptyWrap",
               "toProperty": "mounted"
             }
           ]

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

@@ -47268,7 +47268,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": {
@@ -49453,7 +49453,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": {
@@ -52065,7 +52065,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": {
@@ -54247,7 +54247,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": {
@@ -56652,7 +56652,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": {
@@ -59522,7 +59522,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"
@@ -64364,7 +64364,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",