@shineuix/core 1.0.0 → 1.0.1

package/dist/vscode-data.json

@@ -28,7 +28,7 @@
           "name": "disabled",
           "description": {
             "kind": "markdown",
-            "value": "Greys the header and blocks toggling.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Grays the header and blocks toggling.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -288,7 +288,7 @@
           "name": "tone",
           "description": {
             "kind": "markdown",
-            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
+            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
           },
           "values": [
             {
@@ -693,7 +693,7 @@
           "name": "disabled",
           "description": {
             "kind": "markdown",
-            "value": "Blocks clicks. Filled roles take the disabled well, an outline keeps its surface, and ghost and link stay bare; on navy (`tone=\"inverse\"`) the ink fades instead. A disabled link keeps the look, drops its `href`, reads `aria-disabled=\"true\"` and takes no pointer events, since an anchor has no `disabled` attribute of its own.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Blocks clicks. Filled roles take the disabled well, an outline keeps its surface, and ghost and link stay bare; on navy (`tone=\"inverse\"`) the ink fades instead. A disabled link keeps the look, drops its `href`, reads `aria-disabled=\"true\"` and swallows a click, since an anchor has no `disabled` attribute of its own. A disabled button leaves the tab order; to keep it there, so a keyboard or screen reader user reaches it and the reason beside it, set `aria-disabled=\"true\"` on the element instead. The button then reads as disabled, takes the same look and ignores a click, Enter and Space; a link drops its `href` and stays a tab stop. An `aria-describedby` on the element reaches the button too, so the reason is read with it.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -743,7 +743,7 @@
           "name": "loading",
           "description": {
             "kind": "markdown",
-            "value": "Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy, `aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap around it holds; a click, Enter or Space does nothing until it clears. A link behaves the same and keeps its `href`. Reflected.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy, `aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap around it holds; a click, Enter or Space does nothing until it clears. A link behaves the same: it drops its `href` until the work is done and stays a tab stop, so nothing opens it, a new tab included. Reflected.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -771,7 +771,7 @@
           "name": "size",
           "description": {
             "kind": "markdown",
-            "value": "Control height: sm 28px, md 34px (toolbars), lg 42px (forms). Reflected.\n\nDefault: `'md'`\n\nType: `\"lg\" | \"md\" | \"sm\"`"
+            "value": "Control height: sm 28px (packed rows), md 34px (forms and toolbars), lg 42px (beside the 42px fields of a sign-in or marketing page), xl 44px (that page's call to action, and the smallest touch target). Reflected.\n\nDefault: `'md'`\n\nType: `\"lg\" | \"md\" | \"sm\" | \"xl\"`"
           },
           "values": [
             {
@@ -782,6 +782,9 @@
             },
             {
               "name": "sm"
+            },
+            {
+              "name": "xl"
             }
           ]
         },
@@ -796,7 +799,7 @@
           "name": "tone",
           "description": {
             "kind": "markdown",
-            "value": "Re-inks the quiet roles, outline, ghost and link. Filled roles ignore it. `danger` is destructive ink for a button that deletes, removes or voids, so a row or toolbar carries a destructive action without a second solid fill beside the accent; the filled `danger` variant is the confirmation step's. `inverse` is for a quiet button sitting on dark chrome, an app bar or a side rail, where the default ink would read against the panel rather than on it. It paints `--ink-inverse-muted` and brightens to `--ink-inverse` on hover, matching `sui-icon-button`'s tone of the same name so a labelled button and an icon button agree on a brand bar.\n\nType: `\"danger\" | \"inverse\" | undefined`"
+            "value": "Re-inks the quiet roles, outline, ghost and link. Filled roles ignore it. `danger` is destructive ink for a button that deletes, removes or voids, so a row or toolbar carries a destructive action without a second solid fill beside the accent; the filled `danger` variant is the confirmation step's. `inverse` is for a quiet button sitting on dark chrome, an app bar or a side rail, where the default ink would read against the panel rather than on it. It paints `--ink-inverse-muted` and brightens to `--ink-inverse` on hover, matching `sui-icon-button`'s tone of the same name so a labeled button and an icon button agree on a brand bar.\n\nType: `\"danger\" | \"inverse\" | undefined`"
           },
           "values": [
             {
@@ -1092,7 +1095,7 @@
       "name": "sui-carousel",
       "description": {
         "kind": "markdown",
-        "value": "Pager for any nodes. The slot children are the pages: cards, images, anything. `perPage` sets how many show per view and `step` how many the rail advances per press. Round arrows, dots with the active one stretched and orange, and a touch or pen swipe page it, sideways by default or downwards with `orientation`."
+        "value": "Pager for any nodes. The slot children are the pages: cards, images, anything. `perPage` sets how many show per view and `step` how many the rail advances per press. Round arrows, dots with the active one stretched and orange, and a touch or pen swipe page it, sideways by default or downward with `orientation`."
       },
       "attributes": [
         {
@@ -1141,7 +1144,7 @@
           "name": "orientation",
           "description": {
             "kind": "markdown",
-            "value": "`horizontal` (default) runs the pages sideways with the arrows either side. `vertical` stacks them and pages downwards: the arrows sit above and below, ArrowUp and ArrowDown page, the swipe runs up and down, and the viewport takes `height`. Unknown values fall back to `horizontal`.\n\nDefault: `'horizontal'`\n\nType: `\"horizontal\" | \"vertical\"`"
+            "value": "`horizontal` (default) runs the pages sideways with the arrows either side. `vertical` stacks them and pages downward: the arrows sit above and below, ArrowUp and ArrowDown page, the swipe runs up and down, and the viewport takes `height`. Unknown values fall back to `horizontal`.\n\nDefault: `'horizontal'`\n\nType: `\"horizontal\" | \"vertical\"`"
           },
           "values": [
             {
@@ -1302,7 +1305,7 @@
           "name": "tone",
           "description": {
             "kind": "markdown",
-            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
+            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
           },
           "values": [
             {
@@ -3726,7 +3729,7 @@
           "name": "copy-formulas",
           "description": {
             "kind": "markdown",
-            "value": "Copies cells that a spreadsheet would read as a formula (text starting with `=`, `+`, `-`, `@`, a tab or a line break, other than a plain number) as they are. Off by default: the plain-text copy prefixes such a cell with an apostrophe, the mark Excel and Sheets read as \"this is text\", so a cell holding `=HYPERLINK(…)` cannot run when pasted into a spreadsheet, as OWASP advises for CSV and clipboard output. A paste into a ShineUI grid gets the cells exactly either way, from a private clipboard flavour the copy carries beside the plain text.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Copies cells that a spreadsheet would read as a formula (text starting with `=`, `+`, `-`, `@`, a tab or a line break, other than a plain number) as they are. Off by default: the plain-text copy prefixes such a cell with an apostrophe, the mark Excel and Sheets read as \"this is text\", so a cell holding `=HYPERLINK(…)` cannot run when pasted into a spreadsheet, as OWASP advises for CSV and clipboard output. A paste into a ShineUI grid gets the cells exactly either way, from a private clipboard flavor the copy carries beside the plain text.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -3780,7 +3783,7 @@
           "name": "filter-display",
           "description": {
             "kind": "markdown",
-            "value": "Where a column's filter control lives: a row of boxes under the header, or a menu opened from a funnel on the header's end edge. A column takes part by declaring `filter: true`. The menu offers up to two conditions suited to the column's type, joined by all or any, or a list of values to tick when the column sets `filterOptions`; it edits a draft and writes it on Apply. Either way the grid writes the rule into `filterModel` and emits `suiFilter`.\n\nDefault: `'none'`\n\nType: `\"menu\" | \"none\" | \"row\"`"
+            "value": "Where a column's filter control lives: a row of boxes under the header, or a menu opened from a funnel on the header's end edge. A column takes part by declaring `filter: true`. The menu offers up to two conditions suited to the column's type, joined by all or any, or a list of values to check when the column sets `filterOptions`; it edits a draft and writes it on Apply. Either way the grid writes the rule into `filterModel` and emits `suiFilter`.\n\nDefault: `'none'`\n\nType: `\"menu\" | \"none\" | \"row\"`"
           },
           "values": [
             {
@@ -4008,7 +4011,7 @@
           "name": "filter-display",
           "description": {
             "kind": "markdown",
-            "value": "Where the filter controls live: nowhere, in a row under the headers, or behind a funnel button on each header's end edge. The menu offers up to two conditions suited to the column's type, joined by all or any, or a list of values to tick when the column sets `filterOptions`; it edits a draft and writes it on Apply.\n\nDefault: `'none'`\n\nType: `\"menu\" | \"none\" | \"row\"`"
+            "value": "Where the filter controls live: nowhere, in a row under the headers, or behind a funnel button on each header's end edge. The menu offers up to two conditions suited to the column's type, joined by all or any, or a list of values to check when the column sets `filterOptions`; it edits a draft and writes it on Apply.\n\nDefault: `'none'`\n\nType: `\"menu\" | \"none\" | \"row\"`"
           },
           "values": [
             {
@@ -4523,7 +4526,7 @@
           "name": "tone",
           "description": {
             "kind": "markdown",
-            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
+            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
           },
           "values": [
             {
@@ -4562,6 +4565,21 @@
         "value": "Key and value pairs for record inspectors and detail panes, rendered as a real `dl` of `dt` and `dd` pairs. Rows draw hairlines with a fixed term column; columns draw a grid of sunken cells with small uppercase labels. Display only; `sui-config-list` is the interactive sibling."
       },
       "attributes": [
+        {
+          "name": "align",
+          "description": {
+            "kind": "markdown",
+            "value": "Which side the values sit on, in the reading direction. `end` lines figures up on their last digit, for a summary such as subtotal, tax and balance due. It is one side for the whole list, as a table column has one: a list that mixes names and dates with amounts reads best at the start. In the columns layout the term moves with its value.\n\nDefault: `'start'`\n\nType: `\"end\" | \"start\"`"
+          },
+          "values": [
+            {
+              "name": "end"
+            },
+            {
+              "name": "start"
+            }
+          ]
+        },
         {
           "name": "columns",
           "description": {
@@ -4960,7 +4978,7 @@
           "name": "html",
           "description": {
             "kind": "markdown",
-            "value": "Current content as HTML (ShineUI schema). Mutable; updated when an edit is saved. View mode and the edit path both read it through `sanitizeEditorHtml`: tags and attributes the editor cannot produce are dropped, a script or a handler never reaches the page, and a link whose address is not http, https, mailto, tel or sms, or a relative path, is shown as plain text. A picture is shown with `referrerpolicy=\"no-referrer\"`. View mode writes the sanitised markup through the library's Trusted Types policy, `shineui`. The form value is the string as set, so a value that came from your own store posts back unchanged until an edit is saved.\n\nDefault: `''`\n\nType: `string`"
+            "value": "Current content as HTML (ShineUI schema). Mutable; updated when an edit is saved. View mode and the edit path both read it through `sanitizeEditorHtml`: tags and attributes the editor cannot produce are dropped, a script or a handler never reaches the page, and a link whose address is not http, https, mailto, tel or sms, or a relative path, is shown as plain text. A picture is shown with `referrerpolicy=\"no-referrer\"`. View mode writes the sanitized markup through the library's Trusted Types policy, `shineui`. The form value is the string as set, so a value that came from your own store posts back unchanged until an edit is saved.\n\nDefault: `''`\n\nType: `string`"
           }
         },
         {
@@ -5093,7 +5111,7 @@
           "name": "variant",
           "description": {
             "kind": "markdown",
-            "value": "Outcome flavour: `empty`, `success` (the brand, never a green), `error` (the deep accent) or `not-found`. Sets the icon well colors and the default icon. Only `error` renders `role=\"alert\"`, so only a failed operation interrupts a screen reader; do not use it for a merely empty list. The icon is `aria-hidden`, so the heading and body are the whole accessible content.\n\nDefault: `'empty'`\n\nType: `\"empty\" | \"error\" | \"not-found\" | \"success\"`"
+            "value": "Outcome flavor: `empty`, `success` (the brand, never a green), `error` (the deep accent) or `not-found`. Sets the icon well colors and the default icon. Only `error` renders `role=\"alert\"`, so only a failed operation interrupts a screen reader; do not use it for a merely empty list. The icon is `aria-hidden`, so the heading and body are the whole accessible content.\n\nDefault: `'empty'`\n\nType: `\"empty\" | \"error\" | \"not-found\" | \"success\"`"
           },
           "values": [
             {
@@ -5123,7 +5141,7 @@
           "name": "collapsed",
           "description": {
             "kind": "markdown",
-            "value": "Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -5672,7 +5690,7 @@
           "name": "open",
           "description": {
             "kind": "markdown",
-            "value": "Shows the full-screen viewer. Mutable; the element opens it from the full-screen control and closes it on Escape, the scrim and the close control. Focus is trapped inside while it is open and returns to the control afterwards. While open, and while it fades out, the viewer paints in the browser's top layer, so a transformed or clipping ancestor cannot trap it; everything outside it is inert and the page does not scroll, and a node the page adds outside it while it is open goes inert too. The viewer is `role=\"dialog\"` with no `aria-modal`, so VoiceOver keeps reading the toast region; Tab goes on from the viewer into the toast stack and back. An element the page marks `data-sui-keep-live` stays usable with everything in it, and focus may move into it and back.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Shows the full-screen viewer. Mutable; the element opens it from the full-screen control and closes it on Escape, the scrim and the close control. Focus is trapped inside while it is open and returns to the control afterward. While open, and while it fades out, the viewer paints in the browser's top layer, so a transformed or clipping ancestor cannot trap it; everything outside it is inert and the page does not scroll, and a node the page adds outside it while it is open goes inert too. The viewer is `role=\"dialog\"` with no `aria-modal`, so VoiceOver keeps reading the toast region; Tab goes on from the viewer into the toast stack and back. An element the page marks `data-sui-keep-live` stays usable with everything in it, and focus may move into it and back.\n\nDefault: `false`\n\nType: `boolean`"
           }
         }
       ]
@@ -5688,7 +5706,7 @@
           "name": "disabled",
           "description": {
             "kind": "markdown",
-            "value": "Blocks clicks. As on `sui-button`, filled roles take the disabled well, an outline keeps its surface, a ghost stays bare, and on navy the ink fades. A disabled link keeps the look, drops its `href`, reads `aria-disabled=\"true\"` and takes no pointer events, since an anchor has no `disabled` attribute of its own.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Blocks clicks. As on `sui-button`, filled roles take the disabled well, an outline keeps its surface, a ghost stays bare, and on navy the ink fades. A disabled link keeps the look, drops its `href`, reads `aria-disabled=\"true\"` and swallows a click, since an anchor has no `disabled` attribute of its own. A disabled button leaves the tab order and its tooltip with it; to keep both, so a keyboard or screen reader user reaches it and the reason the tooltip gives, set `aria-disabled=\"true\"` on the element instead. The button then reads as disabled, takes the same look and ignores a click, Enter and Space. An `aria-describedby` on the element reaches the button too.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -5716,7 +5734,7 @@
           "name": "loading",
           "description": {
             "kind": "markdown",
-            "value": "Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy, `aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap around it holds; a click, Enter or Space does nothing until it clears. A link behaves the same and keeps its `href`. Reflected.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy, `aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap around it holds; a click, Enter or Space does nothing until it clears. A link behaves the same: it drops its `href` until the work is done and stays a tab stop, so nothing opens it, a new tab included. Reflected.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -6214,7 +6232,7 @@
           "name": "open",
           "description": {
             "kind": "markdown",
-            "value": "Shows the lightbox. Mutable; the element opens it on click and closes it on Escape, the scrim and the close control. Focus is trapped inside while it is open and returns to the frame afterwards. Zoomed past 1x, the picture drags to pan and the arrow keys pan it too. While open, and while it fades out, the lightbox paints in the browser's top layer, so a transformed or clipping ancestor cannot trap it; everything outside it is inert and the page does not scroll, and a node the page adds outside it while it is open goes inert too. The lightbox is `role=\"dialog\"` with no `aria-modal`, so VoiceOver keeps reading the toast region; Tab goes on from the lightbox into the toast stack and back. An element the page marks `data-sui-keep-live` stays usable with everything in it, and focus may move into it and back.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Shows the lightbox. Mutable; the element opens it on click and closes it on Escape, the scrim and the close control. Focus is trapped inside while it is open and returns to the frame afterward. Zoomed past 1x, the picture drags to pan and the arrow keys pan it too. While open, and while it fades out, the lightbox paints in the browser's top layer, so a transformed or clipping ancestor cannot trap it; everything outside it is inert and the page does not scroll, and a node the page adds outside it while it is open goes inert too. The lightbox is `role=\"dialog\"` with no `aria-modal`, so VoiceOver keeps reading the toast region; Tab goes on from the lightbox into the toast stack and back. An element the page marks `data-sui-keep-live` stays usable with everything in it, and focus may move into it and back.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -6242,7 +6260,7 @@
           "name": "width",
           "description": {
             "kind": "markdown",
-            "value": "Frame width: a number of px or any CSS length.\n\nType: `number | string | undefined`"
+            "value": "Width: a number of px or any CSS length, a percentage of the container included. The element takes it, the frame fills it and the caption wraps to it.\n\nType: `number | string | undefined`"
           }
         }
       ]
@@ -6586,6 +6604,21 @@
         "value": "Numeric field with steppers, a money mode and prefix or suffix text. It groups and separates the way `locale` does and accepts what it displays. Form-associated: it posts the raw number under its `name`, never the formatted text, and binds to React, Vue (`v-model`) and Angular forms. Use it for amounts, quantities and rates; always give it a label."
       },
       "attributes": [
+        {
+          "name": "align",
+          "description": {
+            "kind": "markdown",
+            "value": "Which side of the field the number sits on, in the reading direction. Unset, a `money` field sits at the end and any other at the start. Set `end` where figures stack and should line up on their last digit: quantities, hours and rates in a line-item form, as a table's number column does. A `quiet` field is as wide as its number, so it has no side to choose.\n\nType: `\"end\" | \"start\" | undefined`"
+          },
+          "values": [
+            {
+              "name": "end"
+            },
+            {
+              "name": "start"
+            }
+          ]
+        },
         {
           "name": "autocomplete",
           "description": {
@@ -6748,7 +6781,7 @@
           "name": "tone",
           "description": {
             "kind": "markdown",
-            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
+            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
           },
           "values": [
             {
@@ -7271,7 +7304,7 @@
           "name": "step",
           "description": {
             "kind": "markdown",
-            "value": "Increment between values; drag positions and keyboard steps snap to it. Decimals are honoured. A drag crosses the whole range in 150px whatever the step, so a coarse step lands on the grid without slowing the drag.\n\nDefault: `1`\n\nType: `number`"
+            "value": "Increment between values; drag positions and keyboard steps snap to it. Decimals are honored. A drag crosses the whole range in 150px whatever the step, so a coarse step lands on the grid without slowing the drag.\n\nDefault: `1`\n\nType: `number`"
           }
         },
         {
@@ -7665,7 +7698,7 @@
           "name": "orientation",
           "description": {
             "kind": "markdown",
-            "value": "Which way the bar runs. `horizontal` (default) is the pill across the card with the legend under it. `vertical` stands the bar up as a column that fills the height of the element or of its parent (give one of them a height, e.g. `style=\"height:180px\"`; 120px is the floor), stacks the segments top to bottom in legend order, and puts the total and the legend beside it. An unrecognised value falls back to `horizontal`.\n\nDefault: `'horizontal'`\n\nType: `\"horizontal\" | \"vertical\"`"
+            "value": "Which way the bar runs. `horizontal` (default) is the pill across the card with the legend under it. `vertical` stands the bar up as a column that fills the height of the element or of its parent (give one of them a height, e.g. `style=\"height:180px\"`; 120px is the floor), stacks the segments top to bottom in legend order, and puts the total and the legend beside it. An unrecognized value falls back to `horizontal`.\n\nDefault: `'horizontal'`\n\nType: `\"horizontal\" | \"vertical\"`"
           },
           "values": [
             {
@@ -7856,7 +7889,7 @@
           "name": "tone",
           "description": {
             "kind": "markdown",
-            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
+            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
           },
           "values": [
             {
@@ -8000,7 +8033,7 @@
           "name": "selection-mode",
           "description": {
             "kind": "markdown",
-            "value": "`single` picks one row at a time. `checkbox` draws a box on every row under a select-all header, and the four controls carry the whole ticked set at once. Spelled as on `sui-tree`, which names the same two ways of picking rows. Reflected.\n\nDefault: `'single'`\n\nType: `\"checkbox\" | \"single\"`"
+            "value": "`single` picks one row at a time. `checkbox` draws a box on every row under a select-all header, and the four controls carry the whole checked set at once. Spelled as on `sui-tree`, which names the same two ways of picking rows. Reflected.\n\nDefault: `'single'`\n\nType: `\"checkbox\" | \"single\"`"
           },
           "values": [
             {
@@ -8234,7 +8267,7 @@
           "name": "collapsed",
           "description": {
             "kind": "markdown",
-            "value": "Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -8646,7 +8679,7 @@
           "name": "selection-mode",
           "description": {
             "kind": "markdown",
-            "value": "`single` picks one row at a time. `checkbox` draws a box on every row under a per-pane select-all header, and the transfer controls carry the whole ticked set at once. Reflected.\n\nDefault: `'single'`\n\nType: `\"checkbox\" | \"single\"`"
+            "value": "`single` picks one row at a time. `checkbox` draws a box on every row under a per-pane select-all header, and the transfer controls carry the whole checked set at once. Reflected.\n\nDefault: `'single'`\n\nType: `\"checkbox\" | \"single\"`"
           },
           "values": [
             {
@@ -9385,14 +9418,14 @@
       "name": "sui-save-status",
       "description": {
         "kind": "markdown",
-        "value": "Autosave status line for record editors: saved, saving, dirty (unsaved changes) or error. Slot it into `sui-form-layout` (`slot=\"status\"`) or `sui-form-actions` (`slot=\"status\"`). Announced politely as a live region."
+        "value": "Autosave status line for record editors: nothing yet, saved, saving, dirty (unsaved changes) or error. Slot it into `sui-form-layout` (`slot=\"status\"`) or `sui-form-actions` (`slot=\"status\"`). Announced politely as a live region."
       },
       "attributes": [
         {
           "name": "state",
           "description": {
             "kind": "markdown",
-            "value": "Which line to show.\n\nDefault: `'saved'`\n\nType: `\"dirty\" | \"error\" | \"saved\" | \"saving\"`"
+            "value": "Which line to show. `idle`, the default, has nothing to report: a record opened and not yet edited. It draws nothing and stays in the page as the live region, so the first change is announced; a live region added to the page together with its text is often not read. Keep the element in place and change `state`, rather than adding it when there is something to say.\n\nDefault: `'idle'`\n\nType: `\"dirty\" | \"error\" | \"idle\" | \"saved\" | \"saving\"`"
           },
           "values": [
             {
@@ -9401,6 +9434,9 @@
             {
               "name": "error"
             },
+            {
+              "name": "idle"
+            },
             {
               "name": "saved"
             },
@@ -9413,7 +9449,7 @@
           "name": "time",
           "description": {
             "kind": "markdown",
-            "value": "When the record was saved, in the page's language, e.g. \"2 min ago\". The saved line reads \"Saved 2 min ago\"; without it, \"Saved just now\".\n\nType: `string | undefined`"
+            "value": "When the record was saved, in the page's language, e.g. \"2 min ago\". The saved line reads \"Saved 2 min ago\"; without it, \"Saved just now\". Read on the saved line only.\n\nType: `string | undefined`"
           }
         }
       ]
@@ -9664,7 +9700,7 @@
           "name": "tone",
           "description": {
             "kind": "markdown",
-            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
+            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
           },
           "values": [
             {
@@ -10171,7 +10207,7 @@
           "name": "direction",
           "description": {
             "kind": "markdown",
-            "value": "Where the satellites fan out from the launcher. The first item is always the one nearest the launcher. An unrecognised value falls back to `up`.\n\nDefault: `'up'`\n\nType: `\"down\" | \"left\" | \"right\" | \"up\"`"
+            "value": "Where the satellites fan out from the launcher. The first item is always the one nearest the launcher. An unrecognized value falls back to `up`.\n\nDefault: `'up'`\n\nType: `\"down\" | \"left\" | \"right\" | \"up\"`"
           },
           "values": [
             {
@@ -10419,7 +10455,7 @@
           "name": "ratio",
           "description": {
             "kind": "markdown",
-            "value": "Share of the whole the first pane takes (0 to 1): its width side by side, its height when vertical. Seeds the split (the reference `defaultRatio`) and tracks it afterwards.\n\nDefault: `0.5`\n\nType: `number`"
+            "value": "Share of the whole the first pane takes (0 to 1): its width side by side, its height when vertical. Seeds the split (the reference `defaultRatio`) and tracks it afterward.\n\nDefault: `0.5`\n\nType: `number`"
           }
         }
       ]
@@ -10550,7 +10586,7 @@
           "name": "severity",
           "description": {
             "kind": "markdown",
-            "value": "How the change reads, on the status ladder `sui-trend` shares: `positive`, good news, in the positive ink (the ink under brand status, green under semantic); `critical`, bad news (a rising receivable), in the danger ink with the direction arrow ringed and a visually hidden \"unfavorable\" after the figure; `neutral`, neither, in the muted ink at regular weight, the arrow kept and unringed. So the judgement never rests on colour alone. The danger ink is the brand's own under brand mode and rose under semantic status mode, the same ink an overdue date wears. An unknown value reads as `positive`. Reflected.\n\nDefault: `'positive'`\n\nType: `\"critical\" | \"neutral\" | \"positive\"`"
+            "value": "How the change reads, on the status ladder `sui-trend` shares: `positive`, good news, in the positive ink (the ink under brand status, green under semantic); `critical`, bad news (a rising receivable), in the danger ink with the direction arrow ringed and a visually hidden \"unfavorable\" after the figure; `neutral`, neither, in the muted ink at regular weight, the arrow kept and unringed. So the judgment never rests on color alone. The danger ink is the brand's own under brand mode and rose under semantic status mode, the same ink an overdue date wears. An unknown value reads as `positive`. Reflected.\n\nDefault: `'positive'`\n\nType: `\"critical\" | \"neutral\" | \"positive\"`"
           },
           "values": [
             {
@@ -10599,7 +10635,7 @@
           "name": "active",
           "description": {
             "kind": "markdown",
-            "value": "Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterwards; writing it from script emits nothing.\n\nDefault: `0`\n\nType: `number`"
+            "value": "Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterward; writing it from script emits nothing.\n\nDefault: `0`\n\nType: `number`"
           }
         },
         {
@@ -10651,7 +10687,7 @@
           "name": "disabled",
           "description": {
             "kind": "markdown",
-            "value": "Greys the tab and blocks activation.\n\nDefault: `false`\n\nType: `boolean`"
+            "value": "Grays the tab and blocks activation.\n\nDefault: `false`\n\nType: `boolean`"
           }
         },
         {
@@ -10681,7 +10717,7 @@
           "name": "active",
           "description": {
             "kind": "markdown",
-            "value": "Index of the active tab. Seeds the selection (the reference `defaultActive`) and tracks it afterwards; writing it from script moves the bar and emits nothing.\n\nDefault: `0`\n\nType: `number`"
+            "value": "Index of the active tab. Seeds the selection (the reference `defaultActive`) and tracks it afterward; writing it from script moves the bar and emits nothing.\n\nDefault: `0`\n\nType: `number`"
           }
         },
         {
@@ -10990,7 +11026,7 @@
           "name": "code",
           "description": {
             "kind": "markdown",
-            "value": "Code panes and consoles: `dark` (default) or `light`, written as `data-sui-code`. Independent of `mode`, because the light set is computed from the theme rather than from the site's light or dark, so a dark site with a light code pane is a supported pair. Unrecognised values become `dark`.\n\nDefault: `'dark'`\n\nType: `\"auto\" | \"dark\" | \"light\"`"
+            "value": "Code panes and consoles: `dark` (default) or `light`, written as `data-sui-code`. Independent of `mode`, because the light set is computed from the theme rather than from the site's light or dark, so a dark site with a light code pane is a supported pair. Unrecognized values become `dark`.\n\nDefault: `'dark'`\n\nType: `\"auto\" | \"dark\" | \"light\"`"
           },
           "values": [
             {
@@ -11015,7 +11051,7 @@
           "name": "mode",
           "description": {
             "kind": "markdown",
-            "value": "`light`, `dark`, or `system`, which follows the operating system's `prefers-color-scheme` for as long as the element is connected and writes whichever it resolves to. It is the starting state: the switch in the kit shows what is painted and, pressed, picks light or dark outright, so `mode=\"system\"` follows the OS until the reader chooses. Unrecognised values become `light`. Light removes `data-sui-theme`.\n\nDefault: `'light'`\n\nType: `\"dark\" | \"light\" | \"system\"`"
+            "value": "`light`, `dark`, or `system`, which follows the operating system's `prefers-color-scheme` for as long as the element is connected and writes whichever it resolves to. It is the starting state: the switch in the kit shows what is painted and, pressed, picks light or dark outright, so `mode=\"system\"` follows the OS until the reader chooses. Unrecognized values become `light`. Light removes `data-sui-theme`.\n\nDefault: `'light'`\n\nType: `\"dark\" | \"light\" | \"system\"`"
           },
           "values": [
             {
@@ -11033,7 +11069,7 @@
           "name": "neutral",
           "description": {
             "kind": "markdown",
-            "value": "Neutral family. Unrecognised values become `tint`.\n\nDefault: `'tint'`\n\nType: `\"gray\" | \"mauve\" | \"mist\" | \"olive\" | \"sage\" | \"sand\" | \"slate\" | \"stone\" | \"tint\" | \"tintA\" | \"white\" | \"zinc\"`"
+            "value": "Neutral family. Unrecognized values become `tint`.\n\nDefault: `'tint'`\n\nType: `\"gray\" | \"mauve\" | \"mist\" | \"olive\" | \"sage\" | \"sand\" | \"slate\" | \"stone\" | \"tint\" | \"tintA\" | \"white\" | \"zinc\"`"
           },
           "values": [
             {
@@ -11085,7 +11121,7 @@
           "name": "preset",
           "description": {
             "kind": "markdown",
-            "value": "Named palette or `custom`. Unrecognised values become `shineui`.\n\nDefault: `'shineui'`\n\nType: `\"achroma\" | \"aubergine\" | \"charcoal\" | \"cranberry\" | \"custom\" | \"espresso\" | \"evergreen\" | \"forest\" | \"graphite\" | \"harbor\" | \"indigo\" | \"midnight\" | \"ocean\" | \"olive\" | \"plum\" | \"royal\" | \"sage\" | \"shineui\" | \"slate\" | \"steel\" | \"terracotta\" | \"wine\"`"
+            "value": "Named palette or `custom`. Unrecognized values become `shineui`.\n\nDefault: `'shineui'`\n\nType: `\"achroma\" | \"aubergine\" | \"charcoal\" | \"cranberry\" | \"custom\" | \"espresso\" | \"evergreen\" | \"forest\" | \"graphite\" | \"harbor\" | \"indigo\" | \"midnight\" | \"ocean\" | \"olive\" | \"plum\" | \"royal\" | \"sage\" | \"shineui\" | \"slate\" | \"steel\" | \"terracotta\" | \"wine\"`"
           },
           "values": [
             {
@@ -11479,7 +11515,7 @@
           "name": "position",
           "description": {
             "kind": "markdown",
-            "value": "Where the stack sits: a corner, the middle of the top or bottom edge, or the center of the viewport. A top stack grows downward and a bottom stack grows upward, so the newest toast is always the one nearest the middle of the screen; `center` grows both ways and stays centered. The corner names are sides of the screen in either reading direction; inside a toast the severity edge and the icon lead and the X trails. An unrecognised value falls back to `top-right`. While toasts show, the stack paints in the browser's top layer, above dialogs and every other surface but tooltips, so it answers to the viewport even inside a transformed or clipping box. The live regions that announce the toasts stay where the element is, and stay live while a modal is open; Tab reaches the stack from the modal's last control and goes back.\n\nDefault: `'top-right'`\n\nType: `\"bottom-center\" | \"bottom-left\" | \"bottom-right\" | \"center\" | \"top-center\" | \"top-left\" | \"top-right\"`"
+            "value": "Where the stack sits: a corner, the middle of the top or bottom edge, or the center of the viewport. A top stack grows downward and a bottom stack grows upward, so the newest toast is always the one nearest the middle of the screen; `center` grows both ways and stays centered. The corner names are sides of the screen in either reading direction; inside a toast the severity edge and the icon lead and the X trails. An unrecognized value falls back to `top-right`. While toasts show, the stack paints in the browser's top layer, above dialogs and every other surface but tooltips, so it answers to the viewport even inside a transformed or clipping box. The live regions that announce the toasts stay where the element is, and stay live while a modal is open; Tab reaches the stack from the modal's last control and goes back.\n\nDefault: `'top-right'`\n\nType: `\"bottom-center\" | \"bottom-left\" | \"bottom-right\" | \"center\" | \"top-center\" | \"top-left\" | \"top-right\"`"
           },
           "values": [
             {
@@ -12155,7 +12191,7 @@
           "name": "tone",
           "description": {
             "kind": "markdown",
-            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
+            "value": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value reads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The default variant ignores it.\n\nType: `\"inverse\" | undefined`"
           },
           "values": [
             {
@@ -12198,7 +12234,7 @@
       "name": "sui-tree-table",
       "description": {
         "kind": "markdown",
-        "value": "A chart of accounts or any outline with columns. Branches open and close, siblings sort at every level, a filter keeps the ancestors of its matches, a tick carries down a subtree, and a branch can load its children on open. `aria-label` or `aria-labelledby` on the host names it. Use `sui-tree` for rows that are labels, not records."
+        "value": "A chart of accounts or any outline with columns. Branches open and close, siblings sort at every level, a filter keeps the ancestors of its matches, a check carries down a subtree, and a branch can load its children on open. `aria-label` or `aria-labelledby` on the host names it. Use `sui-tree` for rows that are labels, not records."
       },
       "attributes": [
         {
@@ -12306,7 +12342,7 @@
           "name": "selection-mode",
           "description": {
             "kind": "markdown",
-            "value": "`none`, `single` (one highlighted row) or `checkbox` (a box per row, a select-all box in the header, and a tick that carries down a whole subtree).\n\nDefault: `'none'`\n\nType: `\"checkbox\" | \"none\" | \"single\"`"
+            "value": "`none`, `single` (one highlighted row) or `checkbox` (a box per row, a select-all box in the header, and a check that carries down a whole subtree).\n\nDefault: `'none'`\n\nType: `\"checkbox\" | \"none\" | \"single\"`"
           },
           "values": [
             {
@@ -12392,7 +12428,7 @@
           "name": "severity",
           "description": {
             "kind": "markdown",
-            "value": "How the change reads, on the status ladder `sui-stat-card` shares: `positive`, good news, in the positive ink (the ink under brand status, green under semantic); `critical`, bad news, in the danger ink with the arrow ringed and a hidden \"unfavorable\" after the figure; `neutral`, neither, in the muted ink at regular weight, the arrow kept and unringed, so no tone rests on colour alone. Whether a rise is good is yours to say, since a rising receivable is bad: `severity=\"critical\"` marks it. An unknown value reads as `positive`. Reflected.\n\nDefault: `'positive'`\n\nType: `\"critical\" | \"neutral\" | \"positive\"`"
+            "value": "How the change reads, on the status ladder `sui-stat-card` shares: `positive`, good news, in the positive ink (the ink under brand status, green under semantic); `critical`, bad news, in the danger ink with the arrow ringed and a hidden \"unfavorable\" after the figure; `neutral`, neither, in the muted ink at regular weight, the arrow kept and unringed, so no tone rests on color alone. Whether a rise is good is yours to say, since a rising receivable is bad: `severity=\"critical\"` marks it. An unknown value reads as `positive`. Reflected.\n\nDefault: `'positive'`\n\nType: `\"critical\" | \"neutral\" | \"positive\"`"
           },
           "values": [
             {