neba 1.16.2 → 1.17.1

package/dist/a2ui/catalog.json

@@ -1,11 +1,11 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://neba.cdget.com/a2ui/catalog.json",
+  "$id": "https://neba.cdget.com/a2ui/1.17/catalog.json",
   "protocolVersion": "1.0",
   "title": "Neba",
   "description": "The subset of the Neba component library an agent can describe: eighteen components whose every prop is a literal, an enumerated value or a reference to another component by ID.",
-  "catalogId": "https://neba.cdget.com/a2ui/catalog.json",
-  "instructions": "Neba is a React component library. Every component below is a real one, and what you write here is turned into that component rather than into markup.\n\n## Laying a surface out\n\nNothing has a margin of its own. Two components sit beside each other only inside a `Flex`, and the gutter between them is that `Flex`'s `spacing`. Nest a vertical `Flex` inside a horizontal one to build a grid.\n\nA component that takes a child takes an **ID**, never an inline definition, and a `Card` and an `Alert` take exactly one — wrap several in a `Flex` and pass that.\n\n## Colour means something here\n\n`color` is one of six semantic families and never a decorative choice. `success`, `warning` and `danger` say how something went; `info` is a note; `primary` is the product's own accent and `secondary` is the quiet one. Do not reach for a family because a screen needs variety, and do not use `danger` for anything but something that failed or something that destroys.\n\nThere is **one** `solid` control in a view — the action the view exists for. Everything else is `outline` or `text`.\n\n## One ladder\n\n`size` is the same five steps on every component, so an `md` Button, an `md` TextField and an `md` Select are the same height and line up in a row. Pick one size for a screen and stay on it; `density` is the prop for making something tighter, and it changes padding only.\n\n## Fields carry their own words\n\nA `TextField`, a `Select`, a `Checkbox` and the rest each draw their own label, helper line and error message. Never add a `Typography` above a field to label it, and never add one below it to show an error — put the message in the field's own `checks`.\n\n## Text\n\nEvery string a reader sees is a `Typography`. Its `level` says what the text *is* rather than how big it should be: use `h1`…`h6` in order for real headings, and do not pick a heading level because you want larger text.\n\n## Building a sentence out of a value\n\nThere are no operators. `formatString(\"Hello ${/user/name}\")` is how a value is put into a sentence, and `formatNumber`, `formatCurrency`, `formatDate` and `pluralize` are how a number or a date is written in the reader's own language. Never assemble a date out of its parts.",
+  "catalogId": "https://neba.cdget.com/a2ui/1.17/catalog.json",
+  "instructions": "Neba is a React component library. Every component below is a real one, and what you write here is turned into that component rather than into markup.\n\n## Laying a surface out\n\nNothing has a margin of its own. Two components sit beside each other only inside a `Flex`, and the gutter between them is that `Flex`'s `spacing`. Nest a vertical `Flex` inside a horizontal one to build a grid.\n\nA component that takes a child takes an **ID**, never an inline definition, and a `Card` and an `Alert` take exactly one — wrap several in a `Flex` and pass that.\n\n## Colour means something here\n\n`color` is one of six semantic families and never a decorative choice. `success`, `warning` and `danger` say how something went; `info` is a note; `primary` is the product's own accent and `secondary` is the quiet one. Do not reach for a family because a screen needs variety, and do not use `danger` for anything but something that failed or something that destroys.\n\nThere is **one** `solid` control in a view — the action the view exists for. Everything else is `outline` or `text`.\n\n## One ladder\n\n`size` is the same five steps on every component, so an `md` Button, an `md` TextField and an `md` Select are the same height and line up in a row. Pick one size for a screen and stay on it; `density` is the prop for making something tighter, and it changes padding only.\n\n## Fields carry their own words\n\nA `TextField`, a `Select`, a `Checkbox` and the rest each draw their own label, helper line and error message. Never add a `Typography` above a field to label it, and never add one below it to show an error — put the message in the field's own `checks`. Give every check a `message` that says what to fix: one without a message shows \"Validation failed\", which tells the reader nothing.\n\n## Text\n\nEvery string a reader sees is a `Typography`. Its `level` says what the text *is* rather than how big it should be: use `h1`…`h6` in order for real headings, and do not pick a heading level because you want larger text.\n\n## Building a sentence out of a value\n\nThere are no operators. `formatString(\"Hello ${/user/name}\")` is how a value is put into a sentence, and `formatNumber`, `formatCurrency`, `formatDate` and `pluralize` are how a number or a date is written in the reader's own language. Never assemble a date out of its parts.",
   "components": {
     "Flex": {
       "type": "object",
@@ -20,7 +20,10 @@
         },
         "direction": {
           "type": "string",
-          "enum": ["horizontal", "vertical"],
+          "enum": [
+            "horizontal",
+            "vertical"
+          ],
           "default": "horizontal",
           "description": "Which way the children run. `horizontal` is a row and `vertical` is a column."
         },
@@ -45,7 +48,13 @@
         },
         "alignItems": {
           "type": "string",
-          "enum": ["start", "center", "end", "stretch", "baseline"],
+          "enum": [
+            "start",
+            "center",
+            "end",
+            "stretch",
+            "baseline"
+          ],
           "default": "stretch",
           "description": "Where the children sit across the direction."
         },
@@ -55,7 +64,10 @@
           "description": "Lets the children fall onto another line when they do not fit. Set it on a row of chips or of cards; leave it off on a row of two buttons."
         }
       },
-      "required": ["component", "children"]
+      "required": [
+        "component",
+        "children"
+      ]
     },
     "Card": {
       "type": "object",
@@ -78,36 +90,63 @@
         },
         "variant": {
           "type": "string",
-          "enum": ["solid", "outline", "text"],
+          "enum": [
+            "solid",
+            "outline",
+            "text"
+          ],
           "default": "outline",
           "description": "The weight of the sheet. `outline` is a hairline, `solid` a filled panel, `text` no sheet at all."
         },
         "size": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "default": "md",
           "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
         },
         "color": {
           "type": "string",
-          "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+          "enum": [
+            "primary",
+            "secondary",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
           "default": "primary",
           "description": "The family the edge and the focus ring take. The sheet itself is never dyed: a card holds other people's content, and tinting the paper under it puts every colour on that content on a background nobody chose."
         },
         "density": {
           "type": "string",
-          "enum": ["default", "compact"],
+          "enum": [
+            "default",
+            "compact"
+          ],
           "default": "default",
           "description": "How tightly it packs its content. Padding only — never a height and never the type scale, so a compact control still lines up with a default one beside it."
         },
         "elevation": {
           "type": "integer",
-          "enum": [0, 1, 2, 3],
+          "enum": [
+            0,
+            1,
+            2,
+            3
+          ],
           "default": 0,
           "description": "How far it sits off the page, as a drop shadow. `0` means no shadow at all, and is right for almost everything: the surface already has an edge. Raise it only for something that genuinely floats over the content around it."
         }
       },
-      "required": ["component"]
+      "required": [
+        "component"
+      ]
     },
     "Divider": {
       "type": "object",
@@ -122,18 +161,29 @@
         },
         "orientation": {
           "type": "string",
-          "enum": ["horizontal", "vertical"],
+          "enum": [
+            "horizontal",
+            "vertical"
+          ],
           "default": "horizontal",
           "description": "Which way the rule runs."
         },
         "size": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "default": "md",
           "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
         }
       },
-      "required": ["component"]
+      "required": [
+        "component"
+      ]
     },
     "Typography": {
       "type": "object",
@@ -148,26 +198,52 @@
         },
         "level": {
           "type": "string",
-          "enum": ["h1", "h2", "h3", "h4", "h5", "h6", "body", "lead", "caption", "overline"],
+          "enum": [
+            "h1",
+            "h2",
+            "h3",
+            "h4",
+            "h5",
+            "h6",
+            "body",
+            "lead",
+            "caption",
+            "overline"
+          ],
           "default": "body",
           "description": "What the text *is*, not how big it should be. `h1`…`h6` are headings and are drawn as real heading elements, so use them in order and do not pick one for its size; `lead` is the opening paragraph, `caption` a note under something, `overline` a small label above a figure."
         },
         "weight": {
           "type": "string",
-          "enum": ["regular", "medium", "semibold", "bold"],
+          "enum": [
+            "regular",
+            "medium",
+            "semibold",
+            "bold"
+          ],
           "default": "regular",
           "description": "How heavy it is. A heading is already heavier than body text, so this is for the rare line that has to stand out inside one weight."
         },
         "align": {
           "type": "string",
-          "enum": ["start", "center", "end", "justify"],
-          "default": "start",
-          "description": "Where the text sits in the width it has."
+          "enum": [
+            "start",
+            "center",
+            "end",
+            "justify"
+          ],
+          "description": "Where the text sits in the width it has. Left out, it follows the text around it."
         },
         "color": {
           "type": "string",
-          "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
-          "default": "primary",
+          "enum": [
+            "primary",
+            "secondary",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
           "description": "A semantic family, and it is deliberately not set by default: text in a paragraph is the paragraph's colour. Set it only when the colour *means* something — a figure that is over budget."
         },
         "lines": {
@@ -176,7 +252,10 @@
           "description": "Cuts the text off after this many lines with an ellipsis. Do not put it on anything a reader has to read."
         }
       },
-      "required": ["component", "text"]
+      "required": [
+        "component",
+        "text"
+      ]
     },
     "Image": {
       "type": "object",
@@ -199,17 +278,33 @@
         },
         "fit": {
           "type": "string",
-          "enum": ["cover", "contain", "fill", "none", "scale-down"],
+          "enum": [
+            "cover",
+            "contain",
+            "fill",
+            "none",
+            "scale-down"
+          ],
           "default": "cover",
           "description": "What the picture does inside that box. `cover` crops to fill it and `contain` fits the whole picture inside it."
         },
         "rounded": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "description": "Rounds the corners by one step of the radius ladder."
         }
       },
-      "required": ["component", "src", "alt"]
+      "required": [
+        "component",
+        "src",
+        "alt"
+      ]
     },
     "Chip": {
       "type": "object",
@@ -224,19 +319,36 @@
         },
         "variant": {
           "type": "string",
-          "enum": ["solid", "outline", "text"],
+          "enum": [
+            "solid",
+            "outline",
+            "text"
+          ],
           "default": "outline",
           "description": "The weight of the surface."
         },
         "size": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
-          "default": "sm",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
+          "default": "md",
           "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
         },
         "color": {
           "type": "string",
-          "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+          "enum": [
+            "primary",
+            "secondary",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
           "default": "primary",
           "description": "The family. It is the one thing a chip says beyond its word, so let it mean something: `success` for a state that is good, `danger` for one that is not."
         },
@@ -250,7 +362,10 @@
           "description": "Draws it as chosen. For a row of filters where some are on."
         }
       },
-      "required": ["component", "text"]
+      "required": [
+        "component",
+        "text"
+      ]
     },
     "Avatar": {
       "type": "object",
@@ -269,24 +384,42 @@
         },
         "shape": {
           "type": "string",
-          "enum": ["circle", "square"],
+          "enum": [
+            "circle",
+            "square"
+          ],
           "default": "circle",
           "description": "A circle for a person, a square for an organisation or a thing."
         },
         "size": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "default": "md",
           "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
         },
         "color": {
           "type": "string",
-          "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+          "enum": [
+            "primary",
+            "secondary",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
           "default": "primary",
           "description": "The family behind the initials, when they are what is drawn."
         }
       },
-      "required": ["component"]
+      "required": [
+        "component"
+      ]
     },
     "Statistic": {
       "type": "object",
@@ -301,7 +434,7 @@
         },
         "value": {
           "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
-          "description": "The figure itself."
+          "description": "The figure itself. Write it as plain digits, such as `1234.5`, when `previousValue` is given: that is the number the delta is worked out from, and it is then written in the reader's own language. Anything else is drawn as written, with no delta."
         },
         "unit": {
           "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
@@ -317,30 +450,51 @@
         },
         "delta": {
           "type": "string",
-          "enum": ["percent", "absolute", "both", "none"],
+          "enum": [
+            "percent",
+            "absolute",
+            "both",
+            "none"
+          ],
           "default": "percent",
           "description": "How the change is written."
         },
         "betterWhen": {
           "type": "string",
-          "enum": ["up", "down"],
+          "enum": [
+            "up",
+            "down"
+          ],
           "default": "up",
           "description": "Which direction is good news, and therefore which colour the delta takes. Set it to `down` for anything that should be falling — failures, latency, cost — or a drop will be drawn in red."
         },
         "size": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "default": "md",
           "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
         },
         "align": {
           "type": "string",
-          "enum": ["start", "center", "end"],
+          "enum": [
+            "start",
+            "center",
+            "end"
+          ],
           "default": "start",
           "description": "Where the block sits in the width it has."
         }
       },
-      "required": ["component", "value"]
+      "required": [
+        "component",
+        "value"
+      ]
     },
     "DataList": {
       "type": "object",
@@ -364,13 +518,19 @@
                 "description": "The value."
               }
             },
-            "required": ["label", "value"],
+            "required": [
+              "label",
+              "value"
+            ],
             "additionalProperties": false
           }
         },
         "orientation": {
           "type": "string",
-          "enum": ["horizontal", "vertical"],
+          "enum": [
+            "horizontal",
+            "vertical"
+          ],
           "default": "horizontal",
           "description": "`horizontal` puts the label beside the value, which is what a details panel wants; `vertical` puts it above, for a narrow column or for values long enough that a label beside them would leave the row mostly empty."
         },
@@ -381,18 +541,30 @@
         },
         "size": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "default": "md",
           "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
         },
         "density": {
           "type": "string",
-          "enum": ["default", "compact"],
+          "enum": [
+            "default",
+            "compact"
+          ],
           "default": "default",
           "description": "How tightly it packs its content. Padding only — never a height and never the type scale, so a compact control still lines up with a default one beside it."
         }
       },
-      "required": ["component", "items"]
+      "required": [
+        "component",
+        "items"
+      ]
     },
     "Alert": {
       "type": "object",
@@ -411,30 +583,52 @@
         },
         "color": {
           "type": "string",
-          "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+          "enum": [
+            "primary",
+            "secondary",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
           "default": "info",
           "description": "Which kind of message it is, and the one prop here that carries meaning. `info` is a note, `success` something that went right, `warning` something to look at before it goes wrong, `danger` something that failed. The shape of the mark changes with it too, so the message is not carried by colour alone."
         },
         "variant": {
           "type": "string",
-          "enum": ["solid", "outline", "text"],
+          "enum": [
+            "solid",
+            "outline",
+            "text"
+          ],
           "default": "outline",
           "description": "The weight of the surface. `text` draws no box, which is right for an alert set among form fields."
         },
         "size": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "default": "md",
           "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
         },
         "density": {
           "type": "string",
-          "enum": ["default", "compact"],
+          "enum": [
+            "default",
+            "compact"
+          ],
           "default": "default",
           "description": "How tightly it packs its content. Padding only — never a height and never the type scale, so a compact control still lines up with a default one beside it."
         }
       },
-      "required": ["component"]
+      "required": [
+        "component"
+      ]
     },
     "Button": {
       "type": "object",
@@ -458,31 +652,56 @@
             },
             "variant": {
               "type": "string",
-              "enum": ["solid", "outline", "text"],
+              "enum": [
+                "solid",
+                "outline",
+                "text"
+              ],
               "default": "solid",
               "description": "How loud it is. There is **one** `solid` button in a view — the thing the view is for — and everything else is `outline` or `text`. Three filled buttons in a row is three buttons with no answer."
             },
             "size": {
               "type": "string",
-              "enum": ["xs", "sm", "md", "lg", "xl"],
+              "enum": [
+                "xs",
+                "sm",
+                "md",
+                "lg",
+                "xl"
+              ],
               "default": "md",
               "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
             },
             "color": {
               "type": "string",
-              "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+              "enum": [
+                "primary",
+                "secondary",
+                "success",
+                "warning",
+                "danger",
+                "info"
+              ],
               "default": "primary",
               "description": "The family. Use `danger` for something that destroys, and leave the rest alone: a button is not coloured for variety."
             },
             "density": {
               "type": "string",
-              "enum": ["default", "compact"],
+              "enum": [
+                "default",
+                "compact"
+              ],
               "default": "default",
               "description": "How tightly it packs its content. Padding only — never a height and never the type scale, so a compact control still lines up with a default one beside it."
             },
             "elevation": {
               "type": "integer",
-              "enum": [0, 1, 2, 3],
+              "enum": [
+                0,
+                1,
+                2,
+                3
+              ],
               "default": 0,
               "description": "How far it sits off the page, as a drop shadow. `0` means no shadow at all, and is right for almost everything: the surface already has an edge. Raise it only for something that genuinely floats over the content around it."
             },
@@ -502,7 +721,11 @@
               "description": "Stretches it to the width it is given."
             }
           },
-          "required": ["component", "text", "action"]
+          "required": [
+            "component",
+            "text",
+            "action"
+          ]
         }
       ]
     },
@@ -525,7 +748,7 @@
             },
             "value": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
-              "description": "What is in it."
+              "description": "What is in it. Bind it to a path in the data model, which is where what the reader enters is written; a literal is only where it starts, and nothing the reader does to it reaches the data model."
             },
             "placeholder": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
@@ -548,25 +771,45 @@
             },
             "variant": {
               "type": "string",
-              "enum": ["solid", "outline", "text"],
+              "enum": [
+                "solid",
+                "outline",
+                "text"
+              ],
               "default": "outline",
               "description": "The weight of the shell."
             },
             "size": {
               "type": "string",
-              "enum": ["xs", "sm", "md", "lg", "xl"],
+              "enum": [
+                "xs",
+                "sm",
+                "md",
+                "lg",
+                "xl"
+              ],
               "default": "md",
               "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
             },
             "color": {
               "type": "string",
-              "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+              "enum": [
+                "primary",
+                "secondary",
+                "success",
+                "warning",
+                "danger",
+                "info"
+              ],
               "default": "primary",
               "description": "The family the edge, the ring and the caret take."
             },
             "density": {
               "type": "string",
-              "enum": ["default", "compact"],
+              "enum": [
+                "default",
+                "compact"
+              ],
               "default": "default",
               "description": "How tightly it packs its content. Padding only — never a height and never the type scale, so a compact control still lines up with a default one beside it."
             },
@@ -591,7 +834,10 @@
               "description": "Stretches it to the width it is given."
             }
           },
-          "required": ["component", "label"]
+          "required": [
+            "component",
+            "label"
+          ]
         }
       ]
     },
@@ -614,7 +860,7 @@
             },
             "value": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicNumber",
-              "description": "The number."
+              "description": "The number. Bind it to a path in the data model, which is where what the reader enters is written; a literal is only where it starts, and nothing the reader does to it reaches the data model."
             },
             "description": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
@@ -635,25 +881,45 @@
             },
             "variant": {
               "type": "string",
-              "enum": ["solid", "outline", "text"],
+              "enum": [
+                "solid",
+                "outline",
+                "text"
+              ],
               "default": "outline",
               "description": "The weight of the shell."
             },
             "size": {
               "type": "string",
-              "enum": ["xs", "sm", "md", "lg", "xl"],
+              "enum": [
+                "xs",
+                "sm",
+                "md",
+                "lg",
+                "xl"
+              ],
               "default": "md",
               "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
             },
             "color": {
               "type": "string",
-              "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+              "enum": [
+                "primary",
+                "secondary",
+                "success",
+                "warning",
+                "danger",
+                "info"
+              ],
               "default": "primary",
               "description": "The family the edge, the ring and the caret take."
             },
             "density": {
               "type": "string",
-              "enum": ["default", "compact"],
+              "enum": [
+                "default",
+                "compact"
+              ],
               "default": "default",
               "description": "How tightly it packs its content. Padding only — never a height and never the type scale, so a compact control still lines up with a default one beside it."
             },
@@ -673,7 +939,10 @@
               "description": "Shown but not editable."
             }
           },
-          "required": ["component", "label"]
+          "required": [
+            "component",
+            "label"
+          ]
         }
       ]
     },
@@ -696,7 +965,7 @@
             },
             "checked": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicBoolean",
-              "description": "Whether it is ticked."
+              "description": "Whether it is ticked. Bind it to a path in the data model, which is where what the reader enters is written; a literal is only where it starts, and nothing the reader does to it reaches the data model."
             },
             "description": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
@@ -704,13 +973,26 @@
             },
             "size": {
               "type": "string",
-              "enum": ["xs", "sm", "md", "lg", "xl"],
+              "enum": [
+                "xs",
+                "sm",
+                "md",
+                "lg",
+                "xl"
+              ],
               "default": "md",
               "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
             },
             "color": {
               "type": "string",
-              "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+              "enum": [
+                "primary",
+                "secondary",
+                "success",
+                "warning",
+                "danger",
+                "info"
+              ],
               "default": "primary",
               "description": "The family the tick takes."
             },
@@ -725,7 +1007,10 @@
               "description": "Unavailable."
             }
           },
-          "required": ["component", "label"]
+          "required": [
+            "component",
+            "label"
+          ]
         }
       ]
     },
@@ -742,7 +1027,7 @@
         },
         "checked": {
           "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicBoolean",
-          "description": "Whether it is on."
+          "description": "Whether it is on. Bind it to a path in the data model, which is where what the reader enters is written; a literal is only where it starts, and nothing the reader does to it reaches the data model."
         },
         "description": {
           "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
@@ -750,13 +1035,26 @@
         },
         "size": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "default": "md",
           "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
         },
         "color": {
           "type": "string",
-          "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+          "enum": [
+            "primary",
+            "secondary",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
           "default": "primary",
           "description": "The family the track takes when it is on."
         },
@@ -766,7 +1064,10 @@
           "description": "Unavailable."
         }
       },
-      "required": ["component", "label"]
+      "required": [
+        "component",
+        "label"
+      ]
     },
     "RadioGroup": {
       "type": "object",
@@ -787,7 +1088,7 @@
             },
             "value": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
-              "description": "Which option is taken, by its `value`."
+              "description": "Which option is taken, by its `value`. Bind it to a path in the data model, which is where what the reader enters is written; a literal is only where it starts, and nothing the reader does to it reaches the data model."
             },
             "options": {
               "type": "array",
@@ -813,7 +1114,10 @@
                     "description": "Offered but not available."
                   }
                 },
-                "required": ["label", "value"],
+                "required": [
+                  "label",
+                  "value"
+                ],
                 "additionalProperties": false
               }
             },
@@ -823,19 +1127,35 @@
             },
             "orientation": {
               "type": "string",
-              "enum": ["horizontal", "vertical"],
+              "enum": [
+                "horizontal",
+                "vertical"
+              ],
               "default": "vertical",
               "description": "Which way the options run. A column is nearly always right; a row only works while every label is one word."
             },
             "size": {
               "type": "string",
-              "enum": ["xs", "sm", "md", "lg", "xl"],
+              "enum": [
+                "xs",
+                "sm",
+                "md",
+                "lg",
+                "xl"
+              ],
               "default": "md",
               "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
             },
             "color": {
               "type": "string",
-              "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+              "enum": [
+                "primary",
+                "secondary",
+                "success",
+                "warning",
+                "danger",
+                "info"
+              ],
               "default": "primary",
               "description": "The family the chosen dot takes."
             },
@@ -850,7 +1170,11 @@
               "description": "Unavailable."
             }
           },
-          "required": ["component", "label", "options"]
+          "required": [
+            "component",
+            "label",
+            "options"
+          ]
         }
       ]
     },
@@ -873,7 +1197,7 @@
             },
             "value": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
-              "description": "Which option is taken, by its `value`."
+              "description": "Which option is taken, by its `value`. Bind it to a path in the data model, which is where what the reader enters is written; a literal is only where it starts, and nothing the reader does to it reaches the data model."
             },
             "placeholder": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
@@ -903,7 +1227,9 @@
                     "description": "Listed but not available."
                   }
                 },
-                "required": ["value"],
+                "required": [
+                  "value"
+                ],
                 "additionalProperties": false
               }
             },
@@ -913,25 +1239,45 @@
             },
             "variant": {
               "type": "string",
-              "enum": ["solid", "outline", "text"],
+              "enum": [
+                "solid",
+                "outline",
+                "text"
+              ],
               "default": "outline",
               "description": "The weight of the trigger, which is a field's shell."
             },
             "size": {
               "type": "string",
-              "enum": ["xs", "sm", "md", "lg", "xl"],
+              "enum": [
+                "xs",
+                "sm",
+                "md",
+                "lg",
+                "xl"
+              ],
               "default": "md",
               "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
             },
             "color": {
               "type": "string",
-              "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+              "enum": [
+                "primary",
+                "secondary",
+                "success",
+                "warning",
+                "danger",
+                "info"
+              ],
               "default": "primary",
               "description": "The family the edge and the ring take."
             },
             "density": {
               "type": "string",
-              "enum": ["default", "compact"],
+              "enum": [
+                "default",
+                "compact"
+              ],
               "default": "default",
               "description": "How tightly it packs its content. Padding only — never a height and never the type scale, so a compact control still lines up with a default one beside it."
             },
@@ -951,7 +1297,11 @@
               "description": "Stretches it to the width it is given."
             }
           },
-          "required": ["component", "label", "options"]
+          "required": [
+            "component",
+            "label",
+            "options"
+          ]
         }
       ]
     },
@@ -968,7 +1318,7 @@
         },
         "value": {
           "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicNumber",
-          "description": "Where it is."
+          "description": "Where it is. Bind it to a path in the data model, which is where what the reader enters is written; a literal is only where it starts, and nothing the reader does to it reaches the data model."
         },
         "min": {
           "type": "number",
@@ -991,13 +1341,26 @@
         },
         "size": {
           "type": "string",
-          "enum": ["xs", "sm", "md", "lg", "xl"],
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "default": "md",
           "description": "How big it is. One ladder for the whole library: an `md` Button, field and Chip are the same height and line up in a row."
         },
         "color": {
           "type": "string",
-          "enum": ["primary", "secondary", "success", "warning", "danger", "info"],
+          "enum": [
+            "primary",
+            "secondary",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
           "default": "primary",
           "description": "The family the filled part of the track takes."
         },
@@ -1007,7 +1370,10 @@
           "description": "Unavailable."
         }
       },
-      "required": ["component", "label"]
+      "required": [
+        "component",
+        "label"
+      ]
     }
   },
   "functions": {
@@ -1025,16 +1391,21 @@
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString"
             }
           },
-          "required": ["value"],
+          "required": [
+            "value"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "boolean"
     },
     "length": {
       "type": "object",
-      "description": "True when the value is between `min` and `max` characters long. Either bound may be left out.",
+      "description": "True when the value is at least `min` and at most `max` characters long. Give at least one of the two.",
       "properties": {
         "call": {
           "const": "length"
@@ -1052,11 +1423,28 @@
               "type": "number"
             }
           },
-          "required": ["value"],
-          "unevaluatedProperties": false
+          "required": [
+            "value"
+          ],
+          "unevaluatedProperties": false,
+          "anyOf": [
+            {
+              "required": [
+                "min"
+              ]
+            },
+            {
+              "required": [
+                "max"
+              ]
+            }
+          ]
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "boolean"
     },
     "regex": {
@@ -1076,16 +1464,22 @@
               "type": "string"
             }
           },
-          "required": ["value", "pattern"],
+          "required": [
+            "value",
+            "pattern"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "boolean"
     },
     "numeric": {
       "type": "object",
-      "description": "True when the value is a number, and between `min` and `max` if either is given.",
+      "description": "True when the value is a number at least `min` and at most `max`. Give at least one of the two.",
       "properties": {
         "call": {
           "const": "numeric"
@@ -1103,11 +1497,28 @@
               "type": "number"
             }
           },
-          "required": ["value"],
-          "unevaluatedProperties": false
+          "required": [
+            "value"
+          ],
+          "unevaluatedProperties": false,
+          "anyOf": [
+            {
+              "required": [
+                "min"
+              ]
+            },
+            {
+              "required": [
+                "max"
+              ]
+            }
+          ]
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "boolean"
     },
     "email": {
@@ -1124,11 +1535,16 @@
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString"
             }
           },
-          "required": ["value"],
+          "required": [
+            "value"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "boolean"
     },
     "formatString": {
@@ -1145,16 +1561,21 @@
               "type": "string"
             }
           },
-          "required": ["value"],
+          "required": [
+            "value"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "string"
     },
     "formatNumber": {
       "type": "object",
-      "description": "Writes a number in the reader's own language, with the digit grouping that language uses.",
+      "description": "Writes a number in the language the renderer was built for, with the digit grouping that language uses.",
       "properties": {
         "call": {
           "const": "formatNumber"
@@ -1165,18 +1586,26 @@
             "value": {
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicNumber"
             },
-            "minimumFractionDigits": {
-              "type": "number"
+            "decimals": {
+              "type": "number",
+              "description": "How many digits follow the decimal point. Left out, the number keeps the digits it has."
             },
-            "maximumFractionDigits": {
-              "type": "number"
+            "grouping": {
+              "type": "boolean",
+              "description": "Whether to write the thousands separators.",
+              "default": true
             }
           },
-          "required": ["value"],
+          "required": [
+            "value"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "string"
     },
     "formatCurrency": {
@@ -1195,18 +1624,33 @@
             "currency": {
               "type": "string",
               "description": "An ISO 4217 code, such as `USD` or `KRW`."
+            },
+            "decimals": {
+              "type": "number",
+              "description": "How many digits follow the decimal point. Left out, the currency's own number of them."
+            },
+            "grouping": {
+              "type": "boolean",
+              "description": "Whether to write the thousands separators.",
+              "default": true
             }
           },
-          "required": ["value", "currency"],
+          "required": [
+            "value",
+            "currency"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "string"
     },
     "formatDate": {
       "type": "object",
-      "description": "Writes a date in the reader's own language. Never assemble one out of numbers: the order of the parts is exactly what differs between languages.",
+      "description": "Writes a date or a time through a pattern. The names of months and weekdays are English whatever the reader's language, so for a reader in another language write a pattern of numbers in the order that language uses.",
       "properties": {
         "call": {
           "const": "formatDate"
@@ -1218,25 +1662,27 @@
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString",
               "description": "An ISO 8601 date or date-time."
             },
-            "dateStyle": {
+            "format": {
               "type": "string",
-              "enum": ["full", "long", "medium", "short"]
-            },
-            "timeStyle": {
-              "type": "string",
-              "enum": ["full", "long", "medium", "short"]
+              "description": "A Unicode TR35 pattern, such as `MMM d, yyyy` or `HH:mm`; or `ISO` for the ISO 8601 string."
             }
           },
-          "required": ["value"],
+          "required": [
+            "value",
+            "format"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "string"
     },
     "pluralize": {
       "type": "object",
-      "description": "Picks the wording that goes with a count. English has two forms and other languages have up to six, which is why this is a function rather than a ternary.",
+      "description": "Picks the wording that goes with a count, by the plural category of the language the renderer was built for. English needs `one` and `other`; other languages use up to six categories, and `other` is the one that is always required.",
       "properties": {
         "call": {
           "const": "pluralize"
@@ -1244,21 +1690,40 @@
         "args": {
           "type": "object",
           "properties": {
-            "count": {
-              "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicNumber"
+            "value": {
+              "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicNumber",
+              "description": "The count."
+            },
+            "zero": {
+              "type": "string"
             },
             "one": {
               "type": "string"
             },
+            "two": {
+              "type": "string"
+            },
+            "few": {
+              "type": "string"
+            },
+            "many": {
+              "type": "string"
+            },
             "other": {
               "type": "string"
             }
           },
-          "required": ["count", "one", "other"],
+          "required": [
+            "value",
+            "other"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "string"
     },
     "openUrl": {
@@ -1275,18 +1740,23 @@
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicString"
             }
           },
-          "required": ["url"],
+          "required": [
+            "url"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "void",
       "allowedCallers": "rendererOnly",
       "requiresUserActivation": true
     },
     "and": {
       "type": "object",
-      "description": "True when every one of them is.",
+      "description": "True when every one of two or more values is.",
       "properties": {
         "call": {
           "const": "and"
@@ -1298,19 +1768,25 @@
               "type": "array",
               "items": {
                 "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicBoolean"
-              }
+              },
+              "minItems": 2
             }
           },
-          "required": ["values"],
+          "required": [
+            "values"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "boolean"
     },
     "or": {
       "type": "object",
-      "description": "True when any one of them is.",
+      "description": "True when any one of two or more values is.",
       "properties": {
         "call": {
           "const": "or"
@@ -1322,14 +1798,20 @@
               "type": "array",
               "items": {
                 "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicBoolean"
-              }
+              },
+              "minItems": 2
             }
           },
-          "required": ["values"],
+          "required": [
+            "values"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "boolean"
     },
     "not": {
@@ -1346,11 +1828,16 @@
               "$ref": "https://a2ui.org/specification/v1_0/common_types.json#/$defs/DynamicBoolean"
             }
           },
-          "required": ["value"],
+          "required": [
+            "value"
+          ],
           "unevaluatedProperties": false
         }
       },
-      "required": ["call", "args"],
+      "required": [
+        "call",
+        "args"
+      ],
       "returnType": "boolean"
     }
   },