@nodegx/mcp 0.1.0 → 0.2.0

package/dist/node-catalog.json

@@ -135,7 +135,8 @@
       "from": "array",
       "to": [
         "collection",
-        "string"
+        "string",
+        "optionslist"
       ]
     }
   ],
@@ -156,6 +157,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/cloud-data/add-record-relation",
+      "usePortAsLabel": "collectionName",
       "inputs": [
         {
           "name": "idSource",
@@ -997,6 +999,7 @@
         "Visual"
       ],
       "allowAsExportRoot": true,
+      "replacedBy": "net.noodl.controls.button",
       "useVariants": true,
       "inputs": [
         {
@@ -1570,7 +1573,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -2301,6 +2304,7 @@
       "docs": "https://docs.noodl.net/nodes/visual/checkbox",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "replacedBy": "net.noodl.controls.checkbox",
       "useVariants": true,
       "inputs": [
         {
@@ -2823,7 +2827,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -3872,7 +3876,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -4930,6 +4934,8 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/cloud-data/cloud-function",
+      "usePortAsLabel": "functionName",
+      "replacedBy": "CloudFunction2",
       "inputs": [
         {
           "name": "call",
@@ -5041,6 +5047,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/cloud-data/cloud-function",
+      "usePortAsLabel": "function",
       "inputs": [
         {
           "name": "call",
@@ -5134,6 +5141,8 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/array",
+      "usePortAsLabel": "collectionId",
+      "replacedBy": "Collection2",
       "inputs": [
         {
           "name": "add",
@@ -5336,6 +5345,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/array/array-node",
+      "usePortAsLabel": "collectionId",
       "inputs": [
         {
           "name": "collectionId",
@@ -5523,6 +5533,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/array/clear-array",
+      "usePortAsLabel": "collectionId",
       "inputs": [
         {
           "name": "clear",
@@ -5635,6 +5646,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/array/insert-into-array",
+      "usePortAsLabel": "collectionId",
       "inputs": [
         {
           "name": "add",
@@ -5849,6 +5861,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/array/remove-from-array",
+      "usePortAsLabel": "collectionId",
       "inputs": [
         {
           "name": "collectionId",
@@ -6215,6 +6228,9 @@
       },
       "shortDesc": "Placeholder marking where children given to an instance of this component are inserted.",
       "allowAsChild": true,
+      "haveComponentChildren": [
+        "Visual"
+      ],
       "inputs": [],
       "outputs": [],
       "dynamicPorts": null,
@@ -6295,6 +6311,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/component-utilities/component-object",
+      "replacedBy": "net.noodl.ComponentObject",
       "inputs": [
         {
           "name": "fetch",
@@ -6715,6 +6732,9 @@
           "after the first: only where Reset returns to → Count Changed stays silent",
           "the first one: the count starts there too → Count Changed"
         ]
+      },
+      "warnings": {
+        "counter/min-above-max": "Min Value is above Max Value"
       }
     },
     {
@@ -6860,6 +6880,8 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/cloud-services/collection",
+      "usePortAsLabel": "collectionName",
+      "replacedBy": "DbCollection2",
       "inputs": [],
       "outputs": [
         {
@@ -7025,6 +7047,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/cloud-data/query-records",
+      "usePortAsLabel": "collectionName",
       "inputs": [],
       "outputs": [
         {
@@ -7361,6 +7384,8 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/cloud-services/model",
+      "usePortAsLabel": "$ndlCollectionName",
+      "replacedBy": "DbModel2",
       "inputs": [
         {
           "name": "delete",
@@ -7628,6 +7653,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/cloud-data/record",
+      "usePortAsLabel": "collectionName",
       "inputs": [
         {
           "name": "fetch",
@@ -7886,6 +7912,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/cloud-data/delete-record",
+      "usePortAsLabel": "collectionName",
       "inputs": [
         {
           "name": "idSource",
@@ -8130,7 +8157,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Lets the user drag this element; when off it still renders and still responds to the Snap actions"
+          "description": "Lets the user drag this element; when off (false, 0, empty or the text \"false\") it still renders and still responds to the Snap actions"
         },
         {
           "name": "inputPositionX",
@@ -8164,7 +8191,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -8576,7 +8603,7 @@
           "always: read at the next Do — how long the Y snap takes, in milliseconds; nothing means 300, and 0 or less lands at Value at the next frame"
         ],
         "enabled": [
-          "always: read at the next press — off (exactly false; 0 or the text \"false\" is not off), a press starts no drag, a drag under way carries on to its let go, and the snaps still run"
+          "always: read at the next press — off (false, 0, empty or the text \"false\"; nothing yet is on), a press starts no drag, a drag under way carries on to its let go, and the snaps still run"
         ],
         "axis": [
           "always: read at the next press, move or let go, a drag under way included — X, Y or Both; on an axis it does not allow the element stays, Drag X / Y say where it is and Delta X / Y is 0; any other value moves it on neither"
@@ -8616,6 +8643,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/events/receive-event",
+      "usePortAsLabel": "channelName",
       "inputs": [
         {
           "name": "channelName",
@@ -8703,6 +8731,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/events/send-event",
+      "usePortAsLabel": "channelName",
       "inputs": [
         {
           "name": "channelName",
@@ -8878,6 +8907,7 @@
         "percent",
         "%"
       ],
+      "usePortAsLabel": "expression",
       "inputs": [
         {
           "name": "evaluateAtLoad",
@@ -9515,7 +9545,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -10755,6 +10785,18 @@
         "refresh": [
           "always: a rebuild at the end of the frame, one however many Refreshes arrived — every row goes and one is built per item, then Done for each Refresh; Failure for each when Template Type has nothing to build from, or there are no Items"
         ]
+      },
+      "warnings": {
+        "repeater/items-not-a-collection": "Items is not a list",
+        "repeater/items-empty-entry": "Items has an empty entry",
+        "repeater/template-script-syntax-error": "Script does not compile",
+        "repeater/template-script-threw": "Script threw for an item, or set its component to something other than a name",
+        "repeater/no-template-for-item": "an item has no component to build its row from",
+        "repeater/template-component-not-found": "an item's component is not in the project",
+        "repeater/input-mapping-syntax-error": "the input mapping does not compile",
+        "repeater/input-mapping-threw": "the input mapping threw for an item",
+        "repeater/no-template": "a Refresh found nothing to build the rows from",
+        "repeater/no-items": "a Refresh found no Items"
       }
     },
     {
@@ -11276,7 +11318,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -13403,7 +13445,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -14675,6 +14717,12 @@
         "visible": [
           "always: shown or hidden at the next paint, its space kept; hidden, it takes no pointer"
         ],
+        "width": [
+          "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
+        ],
+        "height": [
+          "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
+        ],
         "opacity": [
           "always: how see-through it is; at exactly 0 it takes no pointer, and an act goes to what is behind it"
         ],
@@ -14719,8 +14767,8 @@
           "always: read at a drop — which files count as accepted"
         ],
         "focus": [
-          "off the page: nothing is listed → Unchanged; Focused stays silent",
-          "off the page, after outcomes this frame resolved and has not reported: nothing is listed, and Unchanged comes after them → Focused stays silent",
+          "off the page: nothing is listed, and the editor is told → Unchanged; Focused stays silent",
+          "off the page, after outcomes this frame resolved and has not reported: nothing is listed, the editor is told, and Unchanged comes after them → Focused stays silent",
           "already listed as focused → Done; Focused stays silent",
           "already listed, after outcomes this frame has not reported: Done comes after them → Focused stays silent",
           "on the page: listed as focused → Focused, Done",
@@ -14738,6 +14786,10 @@
         "scrollToElement.do": [
           "always: runs at the end of the frame, waiting as Scroll To Index does — Done when Element is empty (nothing to scroll to), Failure for a value that is not an element"
         ]
+      },
+      "warnings": {
+        "focus/not-mounted": "the last Focus arrived while it was not on the page",
+        "dimensions/wired-dimension-becomes-grow": "a wired Width in a row, or a wired Height in a column, is a percent, so it shares out the space instead of setting a size"
       }
     },
     {
@@ -15946,7 +15998,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -16896,6 +16948,12 @@
         "scrollIntoView": [
           "always: the page, or the scrolling Group holding it, scrolls until the element can be seen"
         ],
+        "width": [
+          "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
+        ],
+        "height": [
+          "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, it takes no pointer"
         ],
@@ -16945,6 +17003,9 @@
         "srcSet": [
           "always: the sizes the browser may pick from instead, drawn at the end of the frame"
         ]
+      },
+      "warnings": {
+        "dimensions/wired-dimension-becomes-grow": "a wired Width in a row, or a wired Height in a column, is a percent, so it shares out the space instead of setting a size"
       }
     },
     {
@@ -17450,6 +17511,7 @@
         "Visual"
       ],
       "allowAsExportRoot": true,
+      "replacedBy": "Text",
       "useVariants": true,
       "inputs": [
         {
@@ -18391,7 +18453,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -19300,6 +19362,8 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/object",
+      "usePortAsLabel": "modelId",
+      "replacedBy": "Model2",
       "inputs": [
         {
           "name": "clear",
@@ -19472,6 +19536,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/object/object-node",
+      "usePortAsLabel": "modelId",
       "inputs": [
         {
           "name": "fetch",
@@ -20106,6 +20171,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/cloud-data/create-new-record",
+      "usePortAsLabel": "collectionName",
       "inputs": [
         {
           "name": "accessControl",
@@ -21104,6 +21170,7 @@
       "docs": "https://docs.noodl.net/nodes/visual/options",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "replacedBy": "net.noodl.controls.options",
       "useVariants": true,
       "inputs": [
         {
@@ -21758,7 +21825,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -23317,7 +23384,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -24241,6 +24308,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/component-utilities/parent-component-object",
+      "replacedBy": "net.noodl.ParentComponentObject",
       "inputs": [
         {
           "name": "fetch",
@@ -24370,6 +24438,7 @@
         "request",
         "fetch"
       ],
+      "replacedBy": "net.noodl.HTTP",
       "inputs": [
         {
           "name": "cancel",
@@ -24524,6 +24593,7 @@
       "docs": "https://docs.noodl.net/nodes/visual/radiobutton",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "replacedBy": "net.noodl.controls.radiobutton",
       "useVariants": true,
       "inputs": [
         {
@@ -25035,7 +25105,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -25987,7 +26057,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -26562,9 +26632,18 @@
         "scrollIntoView": [
           "always: the page, or the scrolling Group holding it, scrolls until the group can be seen"
         ],
+        "width": [
+          "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
+        ],
+        "height": [
+          "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, its buttons take no click"
         ]
+      },
+      "warnings": {
+        "dimensions/wired-dimension-becomes-grow": "a wired Width in a row, or a wired Height in a column, is a percent, so it shares out the space instead of setting a size"
       }
     },
     {
@@ -26584,6 +26663,7 @@
       "docs": "https://docs.noodl.net/nodes/visual/range",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "replacedBy": "net.noodl.controls.range",
       "useVariants": true,
       "inputs": [
         {
@@ -27005,7 +27085,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -27684,6 +27764,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/cloud-data/remove-record-relation",
+      "usePortAsLabel": "collectionName",
       "inputs": [
         {
           "name": "idSource",
@@ -28125,7 +28206,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -28933,6 +29014,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/variable/set-variable",
+      "usePortAsLabel": "name",
       "inputs": [
         {
           "name": "do",
@@ -29091,6 +29173,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/cloud-data/set-record-properties",
+      "usePortAsLabel": "collectionName",
       "inputs": [
         {
           "name": "accessControl",
@@ -29421,6 +29504,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/object/set-object-properties",
+      "usePortAsLabel": "modelId",
       "inputs": [
         {
           "name": "idSource",
@@ -30111,7 +30195,7 @@
           "always: the list of states; while none is current, the first (or Start State) is entered at the end of the frame"
         ],
         "values": [
-          "always: the values that differ between states, each an output"
+          "always: the values that differ between states, each an output; a value named as one of the node's outputs is refused and the editor is told"
         ],
         "useTransitions": [
           "always: whether the next move animates its values or jumps"
@@ -30121,6 +30205,12 @@
           "already in, or already heading to, the next state → Unchanged",
           "otherwise it moves to the next state, wrapping round after the last, at the end of the frame — State Changed, then Done"
         ]
+      },
+      "warnings": {
+        "states/unknown-state": "a state was asked for that is not in the list, and no state in the list has been asked for since",
+        "states/no-states": "a Toggle or a To arrived with no States list",
+        "states/unreadable-transition": "a move would have animated along a transition that is not a curve",
+        "states/reserved-port-name": "a value is named as one of the node's own outputs"
       }
     },
     {
@@ -30292,6 +30382,8 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/string",
+      "usePortAsLabel": "value",
+      "portLabelTruncationMode": "length",
       "inputs": [
         {
           "name": "runOnChange-value",
@@ -30475,6 +30567,8 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/string-manipulation/string-format",
+      "usePortAsLabel": "format",
+      "portLabelTruncationMode": "length",
       "inputs": [
         {
           "name": "format",
@@ -30727,6 +30821,7 @@
         "socket",
         "backend"
       ],
+      "usePortAsLabel": "collectionName",
       "inputs": [
         {
           "name": "enabled",
@@ -31156,6 +31251,8 @@
       "docs": "https://docs.noodl.net/nodes/basic-elements/text",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "usePortAsLabel": "text",
+      "portLabelTruncationMode": "length",
       "useVariants": true,
       "visualStates": [
         {
@@ -31920,7 +32017,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -32896,6 +32993,12 @@
         "as": [
           "always: the HTML element the next paint draws (a div when empty) — a new Tag draws a new element"
         ],
+        "width": [
+          "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
+        ],
+        "height": [
+          "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, it takes no pointer"
         ],
@@ -32939,6 +33042,9 @@
         "acceptedFileTypes": [
           "always: read at a drop — which files count as accepted"
         ]
+      },
+      "warnings": {
+        "dimensions/wired-dimension-becomes-grow": "a wired Width in a row, or a wired Height in a column, is a percent, so it shares out the space instead of setting a size"
       }
     },
     {
@@ -32958,6 +33064,7 @@
       "docs": "https://docs.noodl.net/nodes/visual/text-input",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "replacedBy": "net.noodl.controls.textinput",
       "useVariants": true,
       "inputs": [
         {
@@ -33589,7 +33696,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -35026,6 +35133,8 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/variable",
+      "usePortAsLabel": "name",
+      "replacedBy": "Variable2",
       "inputs": [
         {
           "name": "fetch",
@@ -35143,6 +35252,7 @@
         "compat": "safe"
       },
       "docs": "https://docs.noodl.net/nodes/data/variable/variable-node",
+      "usePortAsLabel": "name",
       "inputs": [
         {
           "name": "fetch",
@@ -36332,7 +36442,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -36536,7 +36646,7 @@
             "allowConnectionsOnly": true
           },
           "isSignal": true,
-          "description": "Stops playback and seeks to the beginning"
+          "description": "Stops playback and seeks to Start Time (the beginning when there is none)"
         },
         {
           "name": "restart",
@@ -36548,7 +36658,7 @@
             "allowConnectionsOnly": true
           },
           "isSignal": true,
-          "description": "Seeks to the beginning and plays, then fires Done"
+          "description": "Seeks to Start Time (the beginning when there is none) and plays, then fires Done"
         },
         {
           "name": "scrollIntoView",
@@ -37471,6 +37581,12 @@
         "scrollIntoView": [
           "always: the page, or the scrolling Group holding it, scrolls until the element can be seen"
         ],
+        "width": [
+          "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
+        ],
+        "height": [
+          "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, it takes no pointer"
         ],
@@ -37542,7 +37658,7 @@
           "off the page: waits for the element (at most 16 wait, and the oldest pushed out reports Failure) and plays at the paint that puts the video there — Done then"
         ],
         "restart": [
-          "on the page: wants the video playing and, once it has loaded, goes back to second 0 (Playback Position 0 — not Start Time) and starts it as Play does; before the load, only the wanting; an embedded player is not reached — Done, in its turn after outcomes the frame has already resolved",
+          "on the page: wants the video playing and, once it has loaded, goes back to Start Time as last drawn (Playback Position; second 0 when there is none) and starts it as Play does; before the load, only the wanting; an embedded player is not reached — Done, in its turn after outcomes the frame has already resolved",
           "off the page: waits for the element (at most 16 wait, and the oldest pushed out reports Failure) and restarts at the paint that puts the video there — Done then"
         ],
         "pause": [
@@ -37550,9 +37666,12 @@
           "off the page: waits for the element (at most 16 wait, and the oldest pushed out reports Failure) and pauses at the paint that puts the video there — Done then"
         ],
         "reset": [
-          "on the page: stops wanting the video playing, goes back to second 0 (Playback Position 0 once loaded — not Start Time) and pauses it — On Pause if it was playing; Autoplay no longer starts it on this load; an embedded player is not reached — Done, in its turn after outcomes the frame has already resolved",
+          "on the page: stops wanting the video playing, goes back to Start Time as last drawn (Playback Position, once loaded; second 0 when there is none) and pauses it — On Pause if it was playing; Autoplay no longer starts it on this load; an embedded player is not reached — Done, in its turn after outcomes the frame has already resolved",
           "off the page: waits for the element (at most 16 wait, and the oldest pushed out reports Failure) and resets at the paint that puts the video there — Done then"
         ]
+      },
+      "warnings": {
+        "dimensions/wired-dimension-becomes-grow": "a wired Width in a row, or a wired Height in a column, is a percent, so it shares out the space instead of setting a size"
       }
     },
     {
@@ -37582,6 +37701,7 @@
         "guided",
         "tour"
       ],
+      "usePortAsLabel": "channel",
       "inputs": [
         {
           "name": "action",
@@ -38030,6 +38150,7 @@
         "remote",
         "command"
       ],
+      "usePortAsLabel": "actionType",
       "inputs": [
         {
           "name": "actionType",
@@ -38625,6 +38746,9 @@
           "the Date cannot be read as a date: Result goes empty → Invalid Date; Changed stays silent",
           "otherwise Result is the Date moved by Amount (0 when not a number) in Unit (days when not one of the eight); in months and years Amount counts whole steps only, and the day stops at the month's last → Changed; Invalid Date stays silent"
         ]
+      },
+      "warnings": {
+        "date-add/unknown-unit": "Unit is not one of the eight"
       }
     },
     {
@@ -38970,6 +39094,9 @@
           "either cannot be read as a date: Difference goes empty → Invalid Date; Changed stays silent",
           "otherwise Difference is To minus From in Unit (days when not one of the eight), negative when To is earlier unless Absolute is on → Changed; Invalid Date stays silent"
         ]
+      },
+      "warnings": {
+        "date-difference/unknown-unit": "Unit is not one of the eight"
       }
     },
     {
@@ -39170,6 +39297,7 @@
       "ssr": {
         "compat": "safe"
       },
+      "usePortAsLabel": "storeName",
       "inputs": [
         {
           "name": "initialState",
@@ -39303,6 +39431,7 @@
       "ssr": {
         "compat": "safe"
       },
+      "usePortAsLabel": "key",
       "inputs": [
         {
           "name": "key",
@@ -39438,6 +39567,7 @@
       "ssr": {
         "compat": "safe"
       },
+      "usePortAsLabel": "keys",
       "inputs": [
         {
           "name": "keys",
@@ -40495,6 +40625,7 @@
       "ssr": {
         "compat": "safe"
       },
+      "usePortAsLabel": "key",
       "inputs": [
         {
           "name": "apply",
@@ -41117,7 +41248,7 @@
       "inputs": [
         {
           "name": "maxBytes",
-          "displayName": "Max Bytes",
+          "displayName": "Max Characters",
           "group": "General",
           "plug": "input",
           "type": {
@@ -41125,7 +41256,7 @@
           },
           "isSignal": false,
           "default": 5242880,
-          "description": "Refuse a document larger than this, before parsing it. Raise it for a source that really does publish its whole archive in one file"
+          "description": "Refuse a document longer than this many characters (not bytes), before parsing it. Raise it for a source that really does publish its whole archive in one file"
         },
         {
           "name": "text",
@@ -41328,7 +41459,7 @@
         },
         {
           "name": "maxBytes",
-          "displayName": "Max Bytes",
+          "displayName": "Max Characters",
           "group": "General",
           "plug": "input",
           "type": {
@@ -41336,7 +41467,7 @@
           },
           "isSignal": false,
           "default": 5242880,
-          "description": "Refuse a document larger than this, before parsing it. A big document costs many times its own size in memory once it is an object, and a server can always send more than you expected"
+          "description": "Refuse a document longer than this many characters (not bytes), before parsing it. A big document costs many times its own size in memory once it is an object, and a server can always send more than you expected"
         },
         {
           "name": "text",
@@ -42622,6 +42753,7 @@
       "ssr": {
         "compat": "safe"
       },
+      "usePortAsLabel": "storeName",
       "inputs": [
         {
           "name": "clearHistory",
@@ -42835,6 +42967,7 @@
       "ssr": {
         "compat": "safe"
       },
+      "usePortAsLabel": "storeName",
       "inputs": [
         {
           "name": "jumpTo",
@@ -43026,6 +43159,7 @@
       "ssr": {
         "compat": "safe"
       },
+      "usePortAsLabel": "snapshotName",
       "inputs": [
         {
           "name": "restore",
@@ -44048,6 +44182,8 @@
         "chat",
         "live"
       ],
+      "usePortAsLabel": "url",
+      "portLabelTruncationMode": "path",
       "inputs": [
         {
           "name": "autoConnect",
@@ -44789,6 +44925,8 @@
         "Visual"
       ],
       "allowAsExportRoot": true,
+      "usePortAsLabel": "label",
+      "portLabelTruncationMode": "length",
       "useVariants": true,
       "visualStates": [
         {
@@ -46155,7 +46293,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -47044,7 +47182,7 @@
           "always: the element is put on the page (Did Mount), or taken off it (Will Unmount), at the next paint"
         ],
         "focus": [
-          "not on the page: nothing to focus, and the Focus is not kept → Unchanged; Focused stays silent",
+          "not on the page: nothing to focus, the Focus is not kept, and the editor is told → Unchanged; Focused stays silent",
           "it holds the keyboard already, or is disabled or hidden: nothing changes → Done; Focused stays silent",
           "otherwise the keyboard is put on it, and the Focused state goes true → Focused, Done"
         ],
@@ -47055,9 +47193,20 @@
         "scrollIntoView": [
           "always: the page, or the scrolling Group holding it, scrolls until the button can be seen"
         ],
+        "width": [
+          "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
+        ],
+        "height": [
+          "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"
         ]
+      },
+      "warnings": {
+        "focus/not-mounted": "the last Focus arrived while it was not on the page",
+        "visual/icon-source-not-an-icon/iconIconSource": "Icon Source holds something that is not an icon",
+        "dimensions/wired-dimension-becomes-grow": "a wired Width in a row, or a wired Height in a column, is a percent, so it shares out the space instead of setting a size"
       }
     },
     {
@@ -47077,6 +47226,8 @@
       "docs": "https://docs.noodl.net/nodes/ui-controls/checkbox",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "usePortAsLabel": "label",
+      "portLabelTruncationMode": "length",
       "useVariants": true,
       "visualStates": [
         {
@@ -48415,7 +48566,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -49222,7 +49373,7 @@
           "always: a label is drawn beside the box, or not; the box and its keyboard stay"
         ],
         "focus": [
-          "not on the page: nothing to focus, and the Focus is not kept → Unchanged; Focused stays silent",
+          "not on the page: nothing to focus, the Focus is not kept, and the editor is told → Unchanged; Focused stays silent",
           "it holds the keyboard already, or is disabled or hidden: nothing changes → Done; Focused stays silent",
           "otherwise the keyboard is put on it, and the Focused state goes true → Focused, Done"
         ],
@@ -49236,6 +49387,10 @@
         "visible": [
           "always: shown or hidden at the next paint, its space kept; hidden, a Focus does not reach it"
         ]
+      },
+      "warnings": {
+        "focus/not-mounted": "the last Focus arrived while it was not on the page",
+        "visual/icon-source-not-an-icon/iconIconSource": "Icon Source holds something that is not an icon"
       }
     },
     {
@@ -49255,6 +49410,7 @@
       "docs": "https://docs.noodl.net/nodes/ui-controls/dropdown",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "usePortAsLabel": "label",
       "useVariants": true,
       "visualStates": [
         {
@@ -50871,7 +51027,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -51822,7 +51978,7 @@
           "always: a label is drawn beside the list, or not; the list, its keyboard and its pick stay"
         ],
         "focus": [
-          "not on the page: nothing to focus, and the Focus is not kept → Unchanged; Focused stays silent",
+          "not on the page: nothing to focus, the Focus is not kept, and the editor is told → Unchanged; Focused stays silent",
           "it holds the keyboard already, or is disabled or hidden: nothing changes → Done; Focused stays silent",
           "otherwise the keyboard is put on it, and the Focused state goes true → Focused, Done"
         ],
@@ -51833,9 +51989,20 @@
         "scrollIntoView": [
           "always: the page, or the scrolling Group holding it, scrolls until the list can be seen"
         ],
+        "width": [
+          "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
+        ],
+        "height": [
+          "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"
         ]
+      },
+      "warnings": {
+        "focus/not-mounted": "the last Focus arrived while it was not on the page",
+        "visual/icon-source-not-an-icon/iconIconSource": "Icon Source holds something that is not an icon",
+        "dimensions/wired-dimension-becomes-grow": "a wired Width in a row, or a wired Height in a column, is a percent, so it shares out the space instead of setting a size"
       }
     },
     {
@@ -51855,6 +52022,7 @@
       "docs": "https://docs.noodl.net/nodes/ui-controls/radio-button",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "usePortAsLabel": "label",
       "useVariants": true,
       "visualStates": [
         {
@@ -53199,7 +53367,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -53998,7 +54166,7 @@
           "always: a label is drawn beside the button, or not; the button and its keyboard stay"
         ],
         "focus": [
-          "not on the page: nothing to focus, and the Focus is not kept → Unchanged; Focused stays silent",
+          "not on the page: nothing to focus, the Focus is not kept, and the editor is told → Unchanged; Focused stays silent",
           "it holds the keyboard already, or is disabled or hidden: nothing changes → Done; Focused stays silent",
           "otherwise the keyboard is put on it, and the Focused state goes true → Focused, Done"
         ],
@@ -54012,6 +54180,10 @@
         "visible": [
           "always: shown or hidden at the next paint, its space kept; hidden, it takes no click and a Focus does not reach it"
         ]
+      },
+      "warnings": {
+        "focus/not-mounted": "the last Focus arrived while it was not on the page",
+        "visual/icon-source-not-an-icon/iconIconSource": "Icon Source holds something that is not an icon"
       }
     },
     {
@@ -54426,7 +54598,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -56380,7 +56552,7 @@
         ],
         "value": [
           "empty: no word, and the handle stays where it is",
-          "not a number: no word (the runtime reports it), and the handle stays where it is",
+          "not a number: no word, the editor is told, and the handle stays where it is",
           "a number: at the next paint the handle goes there, clamped to Min and Max and rounded to the Step; Value and Value Percent follow when they move — Changed does not fire (only a person's slide fires it)"
         ],
         "min": [
@@ -56396,7 +56568,7 @@
           "always: the slider is put on the page (Did Mount), or taken off it (Will Unmount), at the next paint; put back, the handle is where it was left"
         ],
         "focus": [
-          "not on the page: nothing to focus, and the Focus is not kept → Unchanged; Focused stays silent",
+          "not on the page: nothing to focus, the Focus is not kept, and the editor is told → Unchanged; Focused stays silent",
           "it holds the keyboard already, or is disabled or hidden: nothing changes → Done; Focused stays silent",
           "otherwise the keyboard is put on it, and the Focused state goes true → Focused, Done"
         ],
@@ -56407,9 +56579,18 @@
         "scrollIntoView": [
           "always: the page, or the scrolling Group holding it, scrolls until the slider can be seen"
         ],
+        "width": [
+          "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"
         ]
+      },
+      "warnings": {
+        "focus/not-mounted": "the last Focus arrived while it was not on the page",
+        "dimensions/wired-dimension-becomes-grow": "a wired Width in a row, or a wired Height in a column, is a percent, so it shares out the space instead of setting a size",
+        "slider/max-below-min": "Max is below Min",
+        "slider/value-not-a-number": "a Value arrived that is not a number"
       }
     },
     {
@@ -56429,6 +56610,7 @@
       "docs": "https://docs.noodl.net/nodes/ui-controls/text-input",
       "allowAsChild": true,
       "allowAsExportRoot": true,
+      "usePortAsLabel": "label",
       "useVariants": true,
       "visualStates": [
         {
@@ -58160,7 +58342,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -59238,7 +59420,7 @@
           "always: a label is drawn above the field, or not; the field and its keyboard stay"
         ],
         "focus": [
-          "not on the page: nothing to focus, and the Focus is not kept → Unchanged; Focused stays silent",
+          "not on the page: nothing to focus, the Focus is not kept, and the editor is told → Unchanged; Focused stays silent",
           "it holds the keyboard already, or is disabled or hidden: nothing changes → Done; Focused stays silent",
           "otherwise the keyboard is put on it, and the Focused state goes true → Focused, Done"
         ],
@@ -59252,12 +59434,23 @@
         "blockTouch": [
           "always: on, a pointer act that lands here goes no further — the nodes it sits inside do not hear it"
         ],
+        "width": [
+          "always: the size it holds now, a bare number read in the unit it held; drawn at the next paint"
+        ],
+        "height": [
+          "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"
         ],
         "opacity": [
           "always: how see-through it is; at exactly 0 it takes no pointer, and an act goes to what is behind it"
         ]
+      },
+      "warnings": {
+        "focus/not-mounted": "the last Focus arrived while it was not on the page",
+        "visual/icon-source-not-an-icon/iconIconSource": "Icon Source holds something that is not an icon",
+        "dimensions/wired-dimension-becomes-grow": "a wired Width in a row, or a wired Height in a column, is a percent, so it shares out the space instead of setting a size"
       }
     },
     {
@@ -60808,7 +61001,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -61533,7 +61726,7 @@
           },
           "isSignal": false,
           "default": true,
-          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind",
+          "description": "Removes the element from the page entirely when false, unlike Visible which leaves its space behind. Wired, it counts as true until the first value arrives, so set it to false here to start hidden (a lock, a private screen)",
           "index": 9999
         },
         {
@@ -62024,6 +62217,9 @@
         "scrollIntoView": [
           "always: the page, or the scrolling Group holding it, scrolls until the icon can be seen"
         ]
+      },
+      "warnings": {
+        "visual/icon-source-not-an-icon/iconIconSource": "Icon Source holds something that is not an icon"
       }
     },
     {
@@ -62193,7 +62389,21 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "role": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "userId": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "createRole": [
+          "always: read at the end of the frame by a Do pressed in it — only true creates a missing role"
+        ],
+        "treatUnchangedAs": [
+          "always: read when an Unchanged is reported"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.aggregate",
@@ -62207,6 +62417,7 @@
       ],
       "providedBy": "noodl-viewer-cloud",
       "docs": "https://docs.noodl.net/nodes/cloud-functions/cloud-data/aggregate-records",
+      "usePortAsLabel": "collectionName",
       "inputs": [
         {
           "name": "aggregates",
@@ -62291,6 +62502,11 @@
             "example": "storageFilterType"
           }
         ]
+      },
+      "rules": {
+        "aggregates": [
+          "always: kept, and read when the next aggregation goes; asks for none itself"
+        ]
       }
     },
     {
@@ -62495,6 +62711,26 @@
       "parameterEncoding": {
         "known": false,
         "reason": "The port helper needs project context this generator cannot supply headlessly — a live component, a connected node, or a backend schema."
+      },
+      "rules": {
+        "username": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "email": [
+          "always: read at the end of the frame by a Do pressed in it"
+        ],
+        "password": [
+          "always: read at the end of the frame by a Do pressed in it"
+        ],
+        "emailVerified": [
+          "always: read at the end of the frame by a Do pressed in it — only true is verified"
+        ],
+        "properties": [
+          "always: nothing while it runs; each name makes a value input"
+        ],
+        "treatUnchangedAs": [
+          "always: read when an Unchanged is reported"
+        ]
       }
     },
     {
@@ -62630,7 +62866,15 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "userId": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "treatUnchangedAs": [
+          "always: read when an Unchanged is reported"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.getuserroles",
@@ -62765,7 +63009,15 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "userId": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "treatUnchangedAs": [
+          "always: read when an Unchanged is reported"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.hmac",
@@ -62925,7 +63177,24 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "value": [
+          "always: read at the end of the frame by a Do pressed in it — as its text, in UTF-8 bytes (nothing, 0 or false as the empty text)"
+        ],
+        "key": [
+          "always: read at the end of the frame by a Do pressed in it — nothing, empty, 0 or false fails that Do; otherwise its text in UTF-8 bytes, and a text that is empty fails it too"
+        ],
+        "algorithm": [
+          "always: read at the end of the frame by a Do pressed in it (empty reads as SHA-256; one the host does not know fails that Do)"
+        ],
+        "encoding": [
+          "always: read at the end of the frame by a Do pressed in it (empty reads as hex; one not in the list fails that Do)"
+        ],
+        "sign": [
+          "always: one signature at the end of the frame however many presses, of Value under Key as they stand then — Signature and a cleared Error, then Done per press; no Key, an unknown Algorithm or Encoding puts the reason on Error, Signature untouched, Failure per press"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.jwtsign",
@@ -63071,7 +63340,24 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "claims": [
+          "always: read at the end of the frame by a Do pressed in it — nothing signs no claims of its own; text is read as an object literal (not one: no claims); an array, null, a number or true/false fails that Do"
+        ],
+        "key": [
+          "always: read at the end of the frame by a Do pressed in it — nothing, empty, 0 or false fails that Do; otherwise its text in UTF-8 bytes"
+        ],
+        "algorithm": [
+          "always: read at the end of the frame by a Do pressed in it (empty reads as HS256; one not HS256/384/512 fails that Do)"
+        ],
+        "expiresIn": [
+          "always: read at the end of the frame by a Do pressed in it — as a number above 0, exp is that many whole seconds after iat; anything else, no exp"
+        ],
+        "sign": [
+          "always: one token at the end of the frame however many presses, iat the clock's second — Token and a cleared Error, then Done per press; claims that are not an object, an unknown Algorithm or no Key put the reason on Error, Token untouched, Failure per press"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.jwtverify",
@@ -63228,7 +63514,24 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "token": [
+          "always: read at the end of the frame by a Do pressed in it"
+        ],
+        "key": [
+          "always: read at the end of the frame by a Do pressed in it — nothing, empty, 0 or false refuses that Do"
+        ],
+        "algorithm": [
+          "always: read at the end of the frame by a Do pressed in it (empty reads as HS256); the token's header must name the same one"
+        ],
+        "clockTolerance": [
+          "always: read at the end of the frame by a Do pressed in it — that many seconds of leeway on nbf and exp (not a number, or below 0, none)"
+        ],
+        "verify": [
+          "always: one check at the end of the frame however many presses — verified: Valid true, Claims the payload, Error cleared, Done per press; refused: Valid false, the reason on Error, Claims untouched, Failure per press"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.listusersinrole",
@@ -63409,7 +63712,21 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "role": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "limit": [
+          "always: read at the end of the frame by a Do pressed in it, handed to the store as is"
+        ],
+        "skip": [
+          "always: read at the end of the frame by a Do pressed in it, handed to the store as is"
+        ],
+        "treatUnchangedAs": [
+          "always: read when an Unchanged is reported"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.modelrequest",
@@ -63741,7 +64058,48 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "provider": [
+          "always: read when the call is made — blank is Anthropic"
+        ],
+        "model": [
+          "always: read when the request is built — blank is the default model"
+        ],
+        "apiKeySecret": [
+          "always: the name read from the secret store when the call is made"
+        ],
+        "baseUrl": [
+          "always: read when the call is made — blank is the Anthropic API"
+        ],
+        "instructions": [
+          "always: read when the request is built"
+        ],
+        "callInstructions": [
+          "always: read when the request is built"
+        ],
+        "input": [
+          "always: read when the request is built, unless Messages holds a conversation"
+        ],
+        "messages": [
+          "always: read when the request is built — a non-empty list replaces Input"
+        ],
+        "outputSchema": [
+          "always: read when the request is built and again when its answer lands"
+        ],
+        "effort": [
+          "always: read when the request is built — blank is high"
+        ],
+        "maxTokens": [
+          "always: a positive number, floored, read when the request is built — anything else is 16000"
+        ],
+        "timeoutMs": [
+          "always: a positive number, floored, read when the call starts and in its timeout sentence — anything else is 120000"
+        ],
+        "send": [
+          "always: one call at the end of the frame however many presses — Done with the answer published, or Failure with Error, Error Code and Status, per press"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.removeuserfromrole",
@@ -63887,7 +64245,18 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "role": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "userId": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "treatUnchangedAs": [
+          "always: read when an Unchanged is reported"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.request",
@@ -64114,6 +64483,14 @@
             "example": "ptype-Sa1"
           }
         ]
+      },
+      "rules": {
+        "allowNoAuth": [
+          "always: read when a request comes, and again when its caller cannot be looked up"
+        ],
+        "params": [
+          "always: nothing while it runs; read when a request comes — each name a contract row and an output a wire can take"
+        ]
       }
     },
     {
@@ -64285,6 +64662,22 @@
             "example": "pm-Sa1"
           }
         ]
+      },
+      "rules": {
+        "params": [
+          "always: nothing while it runs; each name makes a value input the payload carries"
+        ],
+        "errorMessage": [
+          "always: read when Send is pressed with Status Failure"
+        ],
+        "status": [
+          "always: read when Send is pressed — unset or success is a 200, anything else a 400"
+        ],
+        "send": [
+          "no request reached the function this node is part of: the reason on Error → Failure",
+          "the request was already answered — by another Response, by a refusal, or by the runner's timeout: the reason on Error → Failure",
+          "otherwise: the payload goes out just after — a 200 carrying the Parameters when Status is unset or success, else a 400 carrying the Error Message → Done"
+        ]
       }
     },
     {
@@ -64382,7 +64775,15 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "name": [
+          "always: read at the end of the frame by a Do pressed in it"
+        ],
+        "fetch": [
+          "always: one read at the end of the frame however many presses — found: Value and a cleared Error, Done per press; outside a backend, not found, or a store that cannot be read: the reason on Error, Value cleared, Failure per press"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.sendemail",
@@ -64539,7 +64940,30 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "to": [
+          "always: stamped on each Do pressed after it; read at the end of the frame by a send whose presses agree"
+        ],
+        "template": [
+          "always: read when a send is made — set and not None, the message is that template"
+        ],
+        "variables": [
+          "always: read when a send is made"
+        ],
+        "subject": [
+          "always: read when a send is made"
+        ],
+        "text": [
+          "always: read when a send is made"
+        ],
+        "html": [
+          "always: read when a send is made"
+        ],
+        "send": [
+          "always: at the end of the frame, one send when the frame's presses agree on To (to To as it stands then), or one send per run of presses stamped with the same To, each after the one before is answered — Done per press, or the reason on Error and Failure per press"
+        ]
+      }
     },
     {
       "typeName": "noodl.cloud.updateuser",
@@ -64682,6 +65106,17 @@
       "parameterEncoding": {
         "known": false,
         "reason": "The port helper needs project context this generator cannot supply headlessly — a live component, a connected node, or a backend schema."
+      },
+      "rules": {
+        "userId": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "password": [
+          "always: read at the end of the frame by a Do pressed in it"
+        ],
+        "properties": [
+          "always: nothing while it runs; each name makes a value input"
+        ]
       }
     },
     {
@@ -64840,7 +65275,15 @@
         }
       ],
       "dynamicPorts": null,
-      "parameterEncoding": null
+      "parameterEncoding": null,
+      "rules": {
+        "token": [
+          "always: read at the end of the frame by a Do pressed in it — blank fails that Do"
+        ],
+        "treatUnchangedAs": [
+          "always: read when an Unchanged is reported"
+        ]
+      }
     }
   ]
 }