@shineuix/core 1.0.0 → 1.0.1

package/dist/docs/shineui-docs.json

@@ -168,7 +168,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "Greys the header and blocks toggling.",
+          "docs": "Grays the header and blocks toggling.",
           "docsTags": [
             {
               "name": "default",
@@ -1314,7 +1314,7 @@
           "mutable": false,
           "attr": "tone",
           "reflectToAttr": true,
-          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
+          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
           "docsTags": [],
           "values": [
             {
@@ -3721,7 +3721,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "Blocks clicks. Filled roles take the disabled well, an outline keeps its surface, and ghost\nand link stay bare; on navy (`tone=\"inverse\"`) the ink fades instead. A disabled link keeps\nthe look, drops its `href`, reads `aria-disabled=\"true\"` and takes no pointer events, since an\nanchor has no `disabled` attribute of its own.",
+          "docs": "Blocks clicks. Filled roles take the disabled well, an outline keeps its surface, and ghost\nand link stay bare; on navy (`tone=\"inverse\"`) the ink fades instead. A disabled link keeps\nthe look, drops its `href`, reads `aria-disabled=\"true\"` and swallows a click, since an anchor\nhas no `disabled` attribute of its own. A disabled button leaves the tab order; to keep it\nthere, so a keyboard or screen reader user reaches it and the reason beside it, set\n`aria-disabled=\"true\"` on the element instead. The button then reads as disabled, takes the\nsame look and ignores a click, Enter and Space; a link drops its `href` and stays a tab stop.\nAn `aria-describedby` on the element reaches the button too, so the reason is read with it.",
           "docsTags": [
             {
               "name": "default",
@@ -3888,7 +3888,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy,\n`aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap\naround it holds; a click, Enter or Space does nothing until it clears. A link behaves the\nsame and keeps its `href`. Reflected.",
+          "docs": "Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy,\n`aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap\naround it holds; a click, Enter or Space does nothing until it clears. A link behaves the\nsame: it drops its `href` until the work is done and stays a tab stop, so nothing opens\nit, a new tab included. Reflected.",
           "docsTags": [
             {
               "name": "default",
@@ -3989,16 +3989,16 @@
         },
         {
           "name": "size",
-          "type": "\"lg\" | \"md\" | \"sm\"",
+          "type": "\"lg\" | \"md\" | \"sm\" | \"xl\"",
           "complexType": {
-            "original": "'sm' | 'md' | 'lg'",
-            "resolved": "\"lg\" | \"md\" | \"sm\"",
+            "original": "'sm' | 'md' | 'lg' | 'xl'",
+            "resolved": "\"lg\" | \"md\" | \"sm\" | \"xl\"",
             "references": {}
           },
           "mutable": false,
           "attr": "size",
           "reflectToAttr": true,
-          "docs": "Control height: sm 28px, md 34px (toolbars), lg 42px (forms). Reflected.",
+          "docs": "Control height: sm 28px (packed rows), md 34px (forms and toolbars), lg 42px (beside the\n42px fields of a sign-in or marketing page), xl 44px (that page's call to action, and the\nsmallest touch target). Reflected.",
           "docsTags": [
             {
               "name": "default",
@@ -4018,6 +4018,10 @@
             {
               "value": "sm",
               "type": "string"
+            },
+            {
+              "value": "xl",
+              "type": "string"
             }
           ],
           "optional": false,
@@ -4062,7 +4066,7 @@
           "mutable": false,
           "attr": "tone",
           "reflectToAttr": true,
-          "docs": "Re-inks the quiet roles, outline, ghost and link. Filled roles ignore it.\n\n`danger` is destructive ink for a button that deletes, removes or voids, so a row or toolbar\ncarries a destructive action without a second solid fill beside the accent; the filled `danger`\nvariant is the confirmation step's.\n\n`inverse` is for a quiet button sitting on dark chrome, an app bar or a side rail, where the\ndefault ink would read against the panel rather than on it. It paints `--ink-inverse-muted` and\nbrightens to `--ink-inverse` on hover, matching `sui-icon-button`'s tone of the same name so a\nlabelled button and an icon button agree on a brand bar.",
+          "docs": "Re-inks the quiet roles, outline, ghost and link. Filled roles ignore it.\n\n`danger` is destructive ink for a button that deletes, removes or voids, so a row or toolbar\ncarries a destructive action without a second solid fill beside the accent; the filled `danger`\nvariant is the confirmation step's.\n\n`inverse` is for a quiet button sitting on dark chrome, an app bar or a side rail, where the\ndefault ink would read against the panel rather than on it. It paints `--ink-inverse-muted` and\nbrightens to `--ink-inverse` on hover, matching `sui-icon-button`'s tone of the same name so a\nlabeled button and an icon button agree on a brand bar.",
           "docsTags": [],
           "values": [
             {
@@ -4222,7 +4226,13 @@
         }
       ],
       "events": [],
-      "listeners": [],
+      "listeners": [
+        {
+          "event": "click",
+          "capture": true,
+          "passive": false
+        }
+      ],
       "styles": [],
       "slots": [
         {
@@ -5851,7 +5861,7 @@
       "encapsulation": "scoped",
       "tag": "sui-carousel",
       "readme": "# sui-carousel\n\n\n",
-      "docs": "Pager for any nodes. The slot children are the pages: cards, images, anything. `perPage` sets\nhow many show per view and `step` how many the rail advances per press. Round arrows, dots\nwith the active one stretched and orange, and a touch or pen swipe page it, sideways by\ndefault or downwards with `orientation`.",
+      "docs": "Pager for any nodes. The slot children are the pages: cards, images, anything. `perPage` sets\nhow many show per view and `step` how many the rail advances per press. Round arrows, dots\nwith the active one stretched and orange, and a touch or pen swipe page it, sideways by\ndefault or downward with `orientation`.",
       "docsTags": [
         {
           "name": "slot",
@@ -6048,7 +6058,7 @@
           "mutable": false,
           "attr": "orientation",
           "reflectToAttr": true,
-          "docs": "`horizontal` (default) runs the pages sideways with the arrows either side. `vertical` stacks\nthem and pages downwards: the arrows sit above and below, ArrowUp and ArrowDown page, the\nswipe runs up and down, and the viewport takes `height`. Unknown values fall back to\n`horizontal`.",
+          "docs": "`horizontal` (default) runs the pages sideways with the arrows either side. `vertical` stacks\nthem and pages downward: the arrows sit above and below, ArrowUp and ArrowDown page, the\nswipe runs up and down, and the viewport takes `height`. Unknown values fall back to\n`horizontal`.",
           "docsTags": [
             {
               "name": "default",
@@ -6724,7 +6734,7 @@
           "mutable": false,
           "attr": "tone",
           "reflectToAttr": true,
-          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
+          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
           "docsTags": [],
           "values": [
             {
@@ -19126,7 +19136,7 @@
           "mutable": false,
           "attr": "copy-formulas",
           "reflectToAttr": true,
-          "docs": "Copies cells that a spreadsheet would read as a formula (text starting with `=`, `+`, `-`,\n`@`, a tab or a line break, other than a plain number) as they are. Off by default: the\nplain-text copy prefixes such a cell with an apostrophe, the mark Excel and Sheets read as\n\"this is text\", so a cell holding `=HYPERLINK(…)` cannot run when pasted into a spreadsheet,\nas OWASP advises for CSV and clipboard output. A paste into a ShineUI grid gets the cells\nexactly either way, from a private clipboard flavour the copy carries beside the plain text.",
+          "docs": "Copies cells that a spreadsheet would read as a formula (text starting with `=`, `+`, `-`,\n`@`, a tab or a line break, other than a plain number) as they are. Off by default: the\nplain-text copy prefixes such a cell with an apostrophe, the mark Excel and Sheets read as\n\"this is text\", so a cell holding `=HYPERLINK(…)` cannot run when pasted into a spreadsheet,\nas OWASP advises for CSV and clipboard output. A paste into a ShineUI grid gets the cells\nexactly either way, from a private clipboard flavor the copy carries beside the plain text.",
           "docsTags": [
             {
               "name": "default",
@@ -19286,7 +19296,7 @@
           "mutable": false,
           "attr": "filter-display",
           "reflectToAttr": true,
-          "docs": "Where a column's filter control lives: a row of boxes under the header, or a menu opened from\na funnel on the header's end edge. A column takes part by declaring `filter: true`. The menu\noffers up to two conditions suited to the column's type, joined by all or any, or a list of\nvalues to tick when the column sets `filterOptions`; it edits a draft and writes it on Apply.\nEither way the grid writes the rule into `filterModel` and emits `suiFilter`.",
+          "docs": "Where a column's filter control lives: a row of boxes under the header, or a menu opened from\na funnel on the header's end edge. A column takes part by declaring `filter: true`. The menu\noffers up to two conditions suited to the column's type, joined by all or any, or a list of\nvalues to check when the column sets `filterOptions`; it edits a draft and writes it on Apply.\nEither way the grid writes the rule into `filterModel` and emits `suiFilter`.",
           "docsTags": [
             {
               "name": "default",
@@ -20167,7 +20177,7 @@
               "docs": ""
             }
           ],
-          "docs": "Copies the selected rectangle, or the focused cell when nothing is selected, as TSV.\n\nThe plain text escapes a cell a spreadsheet would run as a formula unless `copyFormulas` is\nset; a private flavour beside it carries the cells exactly, so a paste into a grid is lossless.\nBoth go in one synchronous copy where the engine allows, else the plain text goes through\n`utils/clipboard.ts`, whose fallback covers plain http and a refused Clipboard API. The boolean\nsays whether the text really reached the clipboard, so a caller never confirms a copy that did\nnot happen; `suiCopy` or `suiCopyError` says the same to a listener. Ctrl+C calls it, and\nCtrl+Shift+C calls it with `withHeaders`, the column headings as a first row.",
+          "docs": "Copies the selected rectangle, or the focused cell when nothing is selected, as TSV.\n\nThe plain text escapes a cell a spreadsheet would run as a formula unless `copyFormulas` is\nset; a private flavor beside it carries the cells exactly, so a paste into a grid is lossless.\nBoth go in one synchronous copy where the engine allows, else the plain text goes through\n`utils/clipboard.ts`, whose fallback covers plain http and a refused Clipboard API. The boolean\nsays whether the text really reached the clipboard, so a caller never confirms a copy that did\nnot happen; `suiCopy` or `suiCopyError` says the same to a listener. Ctrl+C calls it, and\nCtrl+Shift+C calls it with `withHeaders`, the column headings as a first row.",
           "docsTags": []
         },
         {
@@ -20189,7 +20199,7 @@
           },
           "signature": "cut() => Promise<boolean>",
           "parameters": [],
-          "docs": "Copies the selection and reports the rectangle to clear.\n\nThe grid does not blank the cells itself, for the same reason it does not write a fill or a\npaste: only the host knows whether a column may be emptied at all. The clipboard write happens\nfirst and the event is only emitted when it succeeded, so a refused clipboard never costs\nanybody their data. The clipboard holds what `copy()` would write, formula escapes and the\nprivate flavour included. Ctrl+X calls it; it does nothing unless `editMode` is `cell`.",
+          "docs": "Copies the selection and reports the rectangle to clear.\n\nThe grid does not blank the cells itself, for the same reason it does not write a fill or a\npaste: only the host knows whether a column may be emptied at all. The clipboard write happens\nfirst and the event is only emitted when it succeeded, so a refused clipboard never costs\nanybody their data. The clipboard holds what `copy()` would write, formula escapes and the\nprivate flavor included. Ctrl+X calls it; it does nothing unless `editMode` is `cell`.",
           "docsTags": []
         },
         {
@@ -20989,7 +20999,7 @@
               "name": "money",
               "type": "boolean",
               "optional": true,
-              "docs": "Aligned to the inline end, tabular numerals, weight 640. Implies `type: 'number'` for\ncomparison unless the column says otherwise, because a money column holds an amount.",
+              "docs": "Aligned to the inline end, tabular numerals, weight 640, and a figure shown as an amount:\ntwo decimals, no currency sign and a negative in parentheses (`1,234.50`, `(1,890.00)`), the\nbody rows of a statement. The sign belongs on the totals (`footerTotals`, a group summary),\nwhich a sort leaves in place; `format: (v) => money(v)` puts it on every row. Implies\n`type: 'number'` for comparison unless the column says otherwise, because a money column\nholds an amount.",
               "deprecated": false
             },
             {
@@ -21066,7 +21076,7 @@
               "name": "format",
               "type": "(value: unknown, row: SuiGridRow) => string",
               "optional": true,
-              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number or money column\nshows a plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`), while\nthe export, the clipboard and an edit keep the plain figure (`1234.5`).",
+              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number column shows a\nplain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`) and a money column\nan amount (`1,234.50`, `1.234,50`), while the export, the clipboard and an edit keep the\nplain figure (`1234.5`).",
               "deprecated": false
             },
             {
@@ -21690,7 +21700,7 @@
         {
           "name": "SuiGridRowSelection",
           "kind": "type",
-          "docs": "Which rows are selected.\n\n`exclude` is not a convenience. It is the only honest way to express select-all over a dataset\nwhose total the client does not hold: a server-backed grid matching four million rows cannot\nenumerate them, and an `allSelected` boolean beside a key set falls apart the moment the user\nunticks three of them. \"Everything except these three\" survives that, survives paging, and is\nwhat a bulk action posts to a server as a predicate rather than as a list.",
+          "docs": "Which rows are selected.\n\n`exclude` is not a convenience. It is the only honest way to express select-all over a dataset\nwhose total the client does not hold: a server-backed grid matching four million rows cannot\nenumerate them, and an `allSelected` boolean beside a key set falls apart the moment the user\nunchecks three of them. \"Everything except these three\" survives that, survives paging, and is\nwhat a bulk action posts to a server as a predicate rather than as a list.",
           "members": [],
           "type": "SuiGridIncludeSelection | SuiGridExcludeSelection"
         },
@@ -21732,7 +21742,7 @@
         {
           "name": "SuiGridValueType",
           "kind": "type",
-          "docs": "How a column's values are compared, formatted and filtered when the column does not say\notherwise. `text` is the fallback for anything unrecognised.",
+          "docs": "How a column's values are compared, formatted and filtered when the column does not say\notherwise. `text` is the fallback for anything unrecognized.",
           "members": [],
           "type": "'text' | 'number' | 'date' | 'boolean'"
         },
@@ -22118,7 +22128,7 @@
           "mutable": false,
           "attr": "filter-display",
           "reflectToAttr": true,
-          "docs": "Where the filter controls live: nowhere, in a row under the headers, or behind a funnel button\non each header's end edge. The menu offers up to two conditions suited to the column's type,\njoined by all or any, or a list of values to tick when the column sets `filterOptions`; it\nedits a draft and writes it on Apply.",
+          "docs": "Where the filter controls live: nowhere, in a row under the headers, or behind a funnel button\non each header's end edge. The menu offers up to two conditions suited to the column's type,\njoined by all or any, or a list of values to check when the column sets `filterOptions`; it\nedits a draft and writes it on Apply.",
           "docsTags": [
             {
               "name": "default",
@@ -23725,7 +23735,7 @@
               "name": "money",
               "type": "boolean",
               "optional": true,
-              "docs": "Aligned to the inline end, tabular numerals, weight 640. Implies `type: 'number'` for\ncomparison unless the column says otherwise, because a money column holds an amount.",
+              "docs": "Aligned to the inline end, tabular numerals, weight 640, and a figure shown as an amount:\ntwo decimals, no currency sign and a negative in parentheses (`1,234.50`, `(1,890.00)`), the\nbody rows of a statement. The sign belongs on the totals (`footerTotals`, a group summary),\nwhich a sort leaves in place; `format: (v) => money(v)` puts it on every row. Implies\n`type: 'number'` for comparison unless the column says otherwise, because a money column\nholds an amount.",
               "deprecated": false
             },
             {
@@ -23802,7 +23812,7 @@
               "name": "format",
               "type": "(value: unknown, row: SuiGridRow) => string",
               "optional": true,
-              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number or money column\nshows a plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`), while\nthe export, the clipboard and an edit keep the plain figure (`1234.5`).",
+              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number column shows a\nplain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`) and a money column\nan amount (`1,234.50`, `1.234,50`), while the export, the clipboard and an edit keep the\nplain figure (`1234.5`).",
               "deprecated": false
             },
             {
@@ -24096,7 +24106,7 @@
               "name": "money",
               "type": "boolean",
               "optional": true,
-              "docs": "Aligned to the inline end, tabular numerals, weight 640. Implies `type: 'number'` for\ncomparison unless the column says otherwise, because a money column holds an amount.",
+              "docs": "Aligned to the inline end, tabular numerals, weight 640, and a figure shown as an amount:\ntwo decimals, no currency sign and a negative in parentheses (`1,234.50`, `(1,890.00)`), the\nbody rows of a statement. The sign belongs on the totals (`footerTotals`, a group summary),\nwhich a sort leaves in place; `format: (v) => money(v)` puts it on every row. Implies\n`type: 'number'` for comparison unless the column says otherwise, because a money column\nholds an amount.",
               "deprecated": false
             },
             {
@@ -24173,7 +24183,7 @@
               "name": "format",
               "type": "(value: unknown, row: SuiGridRow) => string",
               "optional": true,
-              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number or money column\nshows a plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`), while\nthe export, the clipboard and an edit keep the plain figure (`1234.5`).",
+              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number column shows a\nplain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`) and a money column\nan amount (`1,234.50`, `1.234,50`), while the export, the clipboard and an edit keep the\nplain figure (`1234.5`).",
               "deprecated": false
             },
             {
@@ -24573,7 +24583,7 @@
         {
           "name": "SuiGridRowSelection",
           "kind": "type",
-          "docs": "Which rows are selected.\n\n`exclude` is not a convenience. It is the only honest way to express select-all over a dataset\nwhose total the client does not hold: a server-backed grid matching four million rows cannot\nenumerate them, and an `allSelected` boolean beside a key set falls apart the moment the user\nunticks three of them. \"Everything except these three\" survives that, survives paging, and is\nwhat a bulk action posts to a server as a predicate rather than as a list.",
+          "docs": "Which rows are selected.\n\n`exclude` is not a convenience. It is the only honest way to express select-all over a dataset\nwhose total the client does not hold: a server-backed grid matching four million rows cannot\nenumerate them, and an `allSelected` boolean beside a key set falls apart the moment the user\nunchecks three of them. \"Everything except these three\" survives that, survives paging, and is\nwhat a bulk action posts to a server as a predicate rather than as a list.",
           "members": [],
           "type": "SuiGridIncludeSelection | SuiGridExcludeSelection"
         },
@@ -24615,7 +24625,7 @@
         {
           "name": "SuiGridValueType",
           "kind": "type",
-          "docs": "How a column's values are compared, formatted and filtered when the column does not say\notherwise. `text` is the fallback for anything unrecognised.",
+          "docs": "How a column's values are compared, formatted and filtered when the column does not say\notherwise. `text` is the fallback for anything unrecognized.",
           "members": [],
           "type": "'text' | 'number' | 'date' | 'boolean'"
         },
@@ -26046,7 +26056,7 @@
           "mutable": false,
           "attr": "tone",
           "reflectToAttr": true,
-          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
+          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
           "docsTags": [],
           "values": [
             {
@@ -26344,6 +26354,40 @@
       "docsTags": [],
       "usage": {},
       "props": [
+        {
+          "name": "align",
+          "type": "\"end\" | \"start\"",
+          "complexType": {
+            "original": "'start' | 'end'",
+            "resolved": "\"end\" | \"start\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "align",
+          "reflectToAttr": true,
+          "docs": "Which side the values sit on, in the reading direction. `end` lines figures up on their last\ndigit, for a summary such as subtotal, tax and balance due. It is one side for the whole list,\nas a table column has one: a list that mixes names and dates with amounts reads best at the\nstart. In the columns layout the term moves with its value.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'start'"
+            }
+          ],
+          "default": "'start'",
+          "values": [
+            {
+              "value": "end",
+              "type": "string"
+            },
+            {
+              "value": "start",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "columns",
           "type": "number",
@@ -28041,7 +28085,7 @@
           "mutable": true,
           "attr": "html",
           "reflectToAttr": false,
-          "docs": "Current content as HTML (ShineUI schema). Mutable; updated when an edit is saved. View mode\nand the edit path both read it through `sanitizeEditorHtml`: tags and attributes the editor\ncannot produce are dropped, a script or a handler never reaches the page, and a link whose\naddress is not http, https, mailto, tel or sms, or a relative path, is shown as plain text.\nA picture is shown with `referrerpolicy=\"no-referrer\"`. View mode writes the sanitised markup\nthrough the library's Trusted Types policy, `shineui`. The form value is the string as set, so\na value that came from your own store posts back unchanged until an edit is saved.",
+          "docs": "Current content as HTML (ShineUI schema). Mutable; updated when an edit is saved. View mode\nand the edit path both read it through `sanitizeEditorHtml`: tags and attributes the editor\ncannot produce are dropped, a script or a handler never reaches the page, and a link whose\naddress is not http, https, mailto, tel or sms, or a relative path, is shown as plain text.\nA picture is shown with `referrerpolicy=\"no-referrer\"`. View mode writes the sanitized markup\nthrough the library's Trusted Types policy, `shineui`. The form value is the string as set, so\na value that came from your own store posts back unchanged until an edit is saved.",
           "docsTags": [
             {
               "name": "default",
@@ -28828,7 +28872,7 @@
           "mutable": false,
           "attr": "variant",
           "reflectToAttr": true,
-          "docs": "Outcome flavour: `empty`, `success` (the brand, never a green), `error` (the deep accent) or `not-found`.\nSets the icon well colors and the default icon. Only `error` renders `role=\"alert\"`, so only\na failed operation interrupts a screen reader; do not use it for a merely empty list. The\nicon is `aria-hidden`, so the heading and body are the whole accessible content.",
+          "docs": "Outcome flavor: `empty`, `success` (the brand, never a green), `error` (the deep accent) or `not-found`.\nSets the icon well colors and the default icon. Only `error` renders `role=\"alert\"`, so only\na failed operation interrupts a screen reader; do not use it for a merely empty list. The\nicon is `aria-hidden`, so the heading and body are the whole accessible content.",
           "docsTags": [
             {
               "name": "default",
@@ -28906,7 +28950,7 @@
           "mutable": true,
           "attr": "collapsed",
           "reflectToAttr": true,
-          "docs": "Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.",
+          "docs": "Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.",
           "docsTags": [
             {
               "name": "default",
@@ -30315,7 +30359,7 @@
               "name": "money",
               "type": "boolean",
               "optional": true,
-              "docs": "Aligned to the inline end, tabular numerals, weight 640. Implies `type: 'number'` for\ncomparison unless the column says otherwise, because a money column holds an amount.",
+              "docs": "Aligned to the inline end, tabular numerals, weight 640, and a figure shown as an amount:\ntwo decimals, no currency sign and a negative in parentheses (`1,234.50`, `(1,890.00)`), the\nbody rows of a statement. The sign belongs on the totals (`footerTotals`, a group summary),\nwhich a sort leaves in place; `format: (v) => money(v)` puts it on every row. Implies\n`type: 'number'` for comparison unless the column says otherwise, because a money column\nholds an amount.",
               "deprecated": false
             },
             {
@@ -30392,7 +30436,7 @@
               "name": "format",
               "type": "(value: unknown, row: SuiGridRow) => string",
               "optional": true,
-              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number or money column\nshows a plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`), while\nthe export, the clipboard and an edit keep the plain figure (`1234.5`).",
+              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number column shows a\nplain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`) and a money column\nan amount (`1,234.50`, `1.234,50`), while the export, the clipboard and an edit keep the\nplain figure (`1234.5`).",
               "deprecated": false
             },
             {
@@ -30715,7 +30759,7 @@
         {
           "name": "SuiGridValueType",
           "kind": "type",
-          "docs": "How a column's values are compared, formatted and filtered when the column does not say\notherwise. `text` is the fallback for anything unrecognised.",
+          "docs": "How a column's values are compared, formatted and filtered when the column does not say\notherwise. `text` is the fallback for anything unrecognized.",
           "members": [],
           "type": "'text' | 'number' | 'date' | 'boolean'"
         },
@@ -32595,7 +32639,7 @@
           "mutable": true,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "Shows the full-screen viewer. Mutable; the element opens it from the full-screen control and\ncloses it on Escape, the scrim and the close control. Focus is trapped inside while it is open\nand returns to the control afterwards. While open, and while it fades out, the viewer paints in\nthe browser's top layer, so a transformed or clipping ancestor cannot trap it; everything\noutside it is inert and the page does not scroll, and a node the page adds outside it while it\nis open goes inert too. The viewer is `role=\"dialog\"` with no `aria-modal`, so VoiceOver keeps\nreading the toast region; Tab goes on from the viewer into the toast stack and back. An element\nthe page marks `data-sui-keep-live` stays usable with everything in it, and focus may move into\nit and back.",
+          "docs": "Shows the full-screen viewer. Mutable; the element opens it from the full-screen control and\ncloses it on Escape, the scrim and the close control. Focus is trapped inside while it is open\nand returns to the control afterward. While open, and while it fades out, the viewer paints in\nthe browser's top layer, so a transformed or clipping ancestor cannot trap it; everything\noutside it is inert and the page does not scroll, and a node the page adds outside it while it\nis open goes inert too. The viewer is `role=\"dialog\"` with no `aria-modal`, so VoiceOver keeps\nreading the toast region; Tab goes on from the viewer into the toast stack and back. An element\nthe page marks `data-sui-keep-live` stays usable with everything in it, and focus may move into\nit and back.",
           "docsTags": [
             {
               "name": "default",
@@ -32790,7 +32834,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "Blocks clicks. As on `sui-button`, filled roles take the disabled well, an outline keeps its\nsurface, a ghost stays bare, and on navy the ink fades. A disabled link keeps the look, drops its\n`href`, reads `aria-disabled=\"true\"` and takes no pointer events, since an anchor has no\n`disabled` attribute of its own.",
+          "docs": "Blocks clicks. As on `sui-button`, filled roles take the disabled well, an outline keeps its\nsurface, a ghost stays bare, and on navy the ink fades. A disabled link keeps the look, drops its\n`href`, reads `aria-disabled=\"true\"` and swallows a click, since an anchor has no `disabled`\nattribute of its own. A disabled button leaves the tab order and its tooltip with it; to keep\nboth, so a keyboard or screen reader user reaches it and the reason the tooltip gives, set\n`aria-disabled=\"true\"` on the element instead. The button then reads as disabled, takes the\nsame look and ignores a click, Enter and Space. An `aria-describedby` on the element reaches\nthe button too.",
           "docsTags": [
             {
               "name": "default",
@@ -32897,7 +32941,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy,\n`aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap\naround it holds; a click, Enter or Space does nothing until it clears. A link behaves the\nsame and keeps its `href`. Reflected.",
+          "docs": "Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy,\n`aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap\naround it holds; a click, Enter or Space does nothing until it clears. A link behaves the\nsame: it drops its `href` until the work is done and stays a tab stop, so nothing opens\nit, a new tab included. Reflected.",
           "docsTags": [
             {
               "name": "default",
@@ -33285,7 +33329,13 @@
         }
       ],
       "events": [],
-      "listeners": [],
+      "listeners": [
+        {
+          "event": "click",
+          "capture": true,
+          "passive": false
+        }
+      ],
       "styles": [],
       "slots": [
         {
@@ -33348,7 +33398,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "end - Trailing content inside the field's edge: a shortcut hint, a unit, a small action. It\nsits after the clear control and the trailing icon, centred on the field's height, and the input\ngives up room for it only while it is filled. A press on it that lands on nothing focusable puts\nthe caret in the input, so a `sui-kbd` hint reads and behaves as part of the field."
+          "text": "end - Trailing content inside the field's edge: a shortcut hint, a unit, a small action. It\nsits after the clear control and the trailing icon, centered on the field's height, and the input\ngives up room for it only while it is filled. A press on it that lands on nothing focusable puts\nthe caret in the input, so a `sui-kbd` hint reads and behaves as part of the field."
         }
       ],
       "usage": {},
@@ -34035,7 +34085,7 @@
       "slots": [
         {
           "name": "end",
-          "docs": "Trailing content inside the field's edge: a shortcut hint, a unit, a small action. It\nsits after the clear control and the trailing icon, centred on the field's height, and the input\ngives up room for it only while it is filled. A press on it that lands on nothing focusable puts\nthe caret in the input, so a `sui-kbd` hint reads and behaves as part of the field."
+          "docs": "Trailing content inside the field's edge: a shortcut hint, a unit, a small action. It\nsits after the clear control and the trailing icon, centered on the field's height, and the input\ngives up room for it only while it is filled. A press on it that lands on nothing focusable puts\nthe caret in the input, so a `sui-kbd` hint reads and behaves as part of the field."
         }
       ],
       "parts": [],
@@ -34810,7 +34860,7 @@
           "mutable": true,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "Shows the lightbox. Mutable; the element opens it on click and closes it on Escape, the scrim\nand the close control. Focus is trapped inside while it is open and returns to the frame\nafterwards. Zoomed past 1x, the picture drags to pan and the arrow keys pan it too. While open,\nand while it fades out, the lightbox paints in the browser's top layer, so a transformed or\nclipping ancestor cannot trap it; everything outside it is inert and the page does not scroll,\nand a node the page adds outside it while it is open goes inert too. The lightbox is\n`role=\"dialog\"` with no `aria-modal`, so VoiceOver keeps reading the toast region; Tab goes on\nfrom the lightbox into the toast stack and back. An element the page marks `data-sui-keep-live`\nstays usable with everything in it, and focus may move into it and back.",
+          "docs": "Shows the lightbox. Mutable; the element opens it on click and closes it on Escape, the scrim\nand the close control. Focus is trapped inside while it is open and returns to the frame\nafterward. Zoomed past 1x, the picture drags to pan and the arrow keys pan it too. While open,\nand while it fades out, the lightbox paints in the browser's top layer, so a transformed or\nclipping ancestor cannot trap it; everything outside it is inert and the page does not scroll,\nand a node the page adds outside it while it is open goes inert too. The lightbox is\n`role=\"dialog\"` with no `aria-modal`, so VoiceOver keeps reading the toast region; Tab goes on\nfrom the lightbox into the toast stack and back. An element the page marks `data-sui-keep-live`\nstays usable with everything in it, and focus may move into it and back.",
           "docsTags": [
             {
               "name": "default",
@@ -34914,7 +34964,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": false,
-          "docs": "Frame width: a number of px or any CSS length.",
+          "docs": "Width: a number of px or any CSS length, a percentage of the container included. The element\ntakes it, the frame fills it and the caption wraps to it.",
           "docsTags": [],
           "values": [
             {
@@ -36605,6 +36655,37 @@
       "docsTags": [],
       "usage": {},
       "props": [
+        {
+          "name": "align",
+          "type": "\"end\" | \"start\" | undefined",
+          "complexType": {
+            "original": "'start' | 'end'",
+            "resolved": "\"end\" | \"start\" | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "align",
+          "reflectToAttr": true,
+          "docs": "Which side of the field the number sits on, in the reading direction. Unset, a `money` field\nsits at the end and any other at the start. Set `end` where figures stack and should line up\non their last digit: quantities, hours and rates in a line-item form, as a table's number\ncolumn does. A `quiet` field is as wide as its number, so it has no side to choose.",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "end",
+              "type": "string"
+            },
+            {
+              "value": "start",
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "autocomplete",
           "type": "string | undefined",
@@ -37198,7 +37279,7 @@
           "mutable": false,
           "attr": "tone",
           "reflectToAttr": true,
-          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
+          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
           "docsTags": [],
           "values": [
             {
@@ -39479,7 +39560,7 @@
           "mutable": false,
           "attr": "step",
           "reflectToAttr": false,
-          "docs": "Increment between values; drag positions and keyboard steps snap to it. Decimals are honoured.\nA drag crosses the whole range in 150px whatever the step, so a coarse step lands on the grid\nwithout slowing the drag.",
+          "docs": "Increment between values; drag positions and keyboard steps snap to it. Decimals are honored.\nA drag crosses the whole range in 150px whatever the step, so a coarse step lands on the grid\nwithout slowing the drag.",
           "docsTags": [
             {
               "name": "default",
@@ -42220,7 +42301,7 @@
           "mutable": false,
           "attr": "orientation",
           "reflectToAttr": true,
-          "docs": "Which way the bar runs. `horizontal` (default) is the pill across the card with the legend\nunder it. `vertical` stands the bar up as a column that fills the height of the element or of\nits parent (give one of them a height, e.g. `style=\"height:180px\"`; 120px is the floor),\nstacks the segments top to bottom in legend order, and puts the total and the legend beside\nit. An unrecognised value falls back to `horizontal`.",
+          "docs": "Which way the bar runs. `horizontal` (default) is the pill across the card with the legend\nunder it. `vertical` stands the bar up as a column that fills the height of the element or of\nits parent (give one of them a height, e.g. `style=\"height:180px\"`; 120px is the floor),\nstacks the segments top to bottom in legend order, and puts the total and the legend beside\nit. An unrecognized value falls back to `horizontal`.",
           "docsTags": [
             {
               "name": "default",
@@ -43091,7 +43172,7 @@
           "mutable": false,
           "attr": "tone",
           "reflectToAttr": true,
-          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
+          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
           "docsTags": [],
           "values": [
             {
@@ -43395,7 +43476,7 @@
               "name": "disabled",
               "type": "boolean",
               "optional": true,
-              "docs": "Greys the row out; the arrows and select-all step over it.",
+              "docs": "Grays the row out; the arrows and select-all step over it.",
               "deprecated": false
             },
             {
@@ -44156,7 +44237,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "`single` picks one row at a time. `checkbox` draws a box on every row under a select-all\nheader, and the four controls carry the whole ticked set at once. Spelled as on `sui-tree`,\nwhich names the same two ways of picking rows. Reflected.",
+          "docs": "`single` picks one row at a time. `checkbox` draws a box on every row under a select-all\nheader, and the four controls carry the whole checked set at once. Spelled as on `sui-tree`,\nwhich names the same two ways of picking rows. Reflected.",
           "docsTags": [
             {
               "name": "default",
@@ -45477,7 +45558,7 @@
           "mutable": true,
           "attr": "collapsed",
           "reflectToAttr": true,
-          "docs": "Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.",
+          "docs": "Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.",
           "docsTags": [
             {
               "name": "default",
@@ -47351,7 +47432,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "`single` picks one row at a time. `checkbox` draws a box on every row under a per-pane\nselect-all header, and the transfer controls carry the whole ticked set at once. Reflected.",
+          "docs": "`single` picks one row at a time. `checkbox` draws a box on every row under a per-pane\nselect-all header, and the transfer controls carry the whole checked set at once. Reflected.",
           "docsTags": [
             {
               "name": "default",
@@ -50982,16 +51063,16 @@
       "encapsulation": "scoped",
       "tag": "sui-save-status",
       "readme": "# sui-save-status\n\n\n",
-      "docs": "Autosave status line for record editors: saved, saving, dirty (unsaved changes) or error.\nSlot it into `sui-form-layout` (`slot=\"status\"`) or `sui-form-actions` (`slot=\"status\"`).\nAnnounced politely as a live region.",
+      "docs": "Autosave status line for record editors: nothing yet, saved, saving, dirty (unsaved changes) or\nerror. Slot it into `sui-form-layout` (`slot=\"status\"`) or `sui-form-actions` (`slot=\"status\"`).\nAnnounced politely as a live region.",
       "docsTags": [],
       "usage": {},
       "props": [
         {
           "name": "state",
-          "type": "\"dirty\" | \"error\" | \"saved\" | \"saving\"",
+          "type": "\"dirty\" | \"error\" | \"idle\" | \"saved\" | \"saving\"",
           "complexType": {
             "original": "SuiSaveState",
-            "resolved": "\"dirty\" | \"error\" | \"saved\" | \"saving\"",
+            "resolved": "\"dirty\" | \"error\" | \"idle\" | \"saved\" | \"saving\"",
             "references": {
               "SuiSaveState": {
                 "location": "local",
@@ -51003,14 +51084,14 @@
           "mutable": false,
           "attr": "state",
           "reflectToAttr": true,
-          "docs": "Which line to show.",
+          "docs": "Which line to show. `idle`, the default, has nothing to report: a record opened and not yet\nedited. It draws nothing and stays in the page as the live region, so the first change is\nannounced; a live region added to the page together with its text is often not read. Keep the\nelement in place and change `state`, rather than adding it when there is something to say.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'saved'"
+              "text": "'idle'"
             }
           ],
-          "default": "'saved'",
+          "default": "'idle'",
           "values": [
             {
               "value": "dirty",
@@ -51020,6 +51101,10 @@
               "value": "error",
               "type": "string"
             },
+            {
+              "value": "idle",
+              "type": "string"
+            },
             {
               "value": "saved",
               "type": "string"
@@ -51045,7 +51130,7 @@
           "mutable": false,
           "attr": "time",
           "reflectToAttr": false,
-          "docs": "When the record was saved, in the page's language, e.g. \"2 min ago\". The saved line reads\n\"Saved 2 min ago\"; without it, \"Saved just now\".",
+          "docs": "When the record was saved, in the page's language, e.g. \"2 min ago\". The saved line reads\n\"Saved 2 min ago\"; without it, \"Saved just now\". Read on the saved line only.",
           "docsTags": [],
           "values": [
             {
@@ -51077,7 +51162,7 @@
           "kind": "type",
           "docs": "",
           "members": [],
-          "type": "'saved' | 'saving' | 'dirty' | 'error'"
+          "type": "'idle' | 'saved' | 'saving' | 'dirty' | 'error'"
         }
       ]
     },
@@ -52417,7 +52502,7 @@
           "mutable": false,
           "attr": "tone",
           "reflectToAttr": true,
-          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
+          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
           "docsTags": [],
           "values": [
             {
@@ -52730,7 +52815,7 @@
               "name": "disabled",
               "type": "boolean",
               "optional": true,
-              "docs": "Greys the row out; the arrows step over it.",
+              "docs": "Grays the row out; the arrows step over it.",
               "deprecated": false
             },
             {
@@ -53277,7 +53362,7 @@
               "name": "disabled",
               "type": "boolean",
               "optional": true,
-              "docs": "Keeps the segment in the track but greys it out; the keyboard skips it.",
+              "docs": "Keeps the segment in the track but grays it out; the keyboard skips it.",
               "deprecated": false
             },
             {
@@ -54970,7 +55055,7 @@
           "mutable": false,
           "attr": "direction",
           "reflectToAttr": true,
-          "docs": "Where the satellites fan out from the launcher. The first item is always the one nearest the\nlauncher. An unrecognised value falls back to `up`.",
+          "docs": "Where the satellites fan out from the launcher. The first item is always the one nearest the\nlauncher. An unrecognized value falls back to `up`.",
           "docsTags": [
             {
               "name": "default",
@@ -55262,7 +55347,7 @@
               "name": "disabled",
               "type": "boolean",
               "optional": true,
-              "docs": "Greys the satellite and blocks its press.",
+              "docs": "Grays the satellite and blocks its press.",
               "deprecated": false
             },
             {
@@ -56117,7 +56202,7 @@
           "mutable": true,
           "attr": "ratio",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "default",
@@ -56748,7 +56833,7 @@
           "mutable": false,
           "attr": "severity",
           "reflectToAttr": true,
-          "docs": "How the change reads, on the status ladder `sui-trend` shares: `positive`, good news, in the\npositive ink (the ink under brand status, green under semantic); `critical`, bad news (a\nrising receivable), in the danger ink with the direction arrow ringed and a visually hidden\n\"unfavorable\" after the figure; `neutral`, neither, in the muted ink at regular weight, the\narrow kept and unringed. So the judgement never rests on colour alone. The danger ink\nis the brand's own under brand mode and rose under semantic status mode, the same ink an\noverdue date wears. An unknown value reads as `positive`. Reflected.",
+          "docs": "How the change reads, on the status ladder `sui-trend` shares: `positive`, good news, in the\npositive ink (the ink under brand status, green under semantic); `critical`, bad news (a\nrising receivable), in the danger ink with the direction arrow ringed and a visually hidden\n\"unfavorable\" after the figure; `neutral`, neither, in the muted ink at regular weight, the\narrow kept and unringed. So the judgment never rests on color alone. The danger ink\nis the brand's own under brand mode and rose under semantic status mode, the same ink an\noverdue date wears. An unknown value reads as `positive`. Reflected.",
           "docsTags": [
             {
               "name": "default",
@@ -56948,7 +57033,7 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": false,
-          "docs": "Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterwards; writing it from script emits nothing.",
+          "docs": "Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterward; writing it from script emits nothing.",
           "docsTags": [
             {
               "name": "default",
@@ -57224,7 +57309,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "Greys the tab and blocks activation.",
+          "docs": "Grays the tab and blocks activation.",
           "docsTags": [
             {
               "name": "default",
@@ -57340,7 +57425,7 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "default",
@@ -58665,7 +58750,7 @@
           "mutable": true,
           "attr": "code",
           "reflectToAttr": true,
-          "docs": "Code panes and consoles: `dark` (default) or `light`, written as `data-sui-code`. Independent\nof `mode`, because the light set is computed from the theme rather than from the site's light\nor dark, so a dark site with a light code pane is a supported pair. Unrecognised values become\n`dark`.",
+          "docs": "Code panes and consoles: `dark` (default) or `light`, written as `data-sui-code`. Independent\nof `mode`, because the light set is computed from the theme rather than from the site's light\nor dark, so a dark site with a light code pane is a supported pair. Unrecognized values become\n`dark`.",
           "docsTags": [
             {
               "name": "default",
@@ -58738,7 +58823,7 @@
           "mutable": true,
           "attr": "mode",
           "reflectToAttr": true,
-          "docs": "`light`, `dark`, or `system`, which follows the operating system's `prefers-color-scheme` for\nas long as the element is connected and writes whichever it resolves to. It is the starting\nstate: the switch in the kit shows what is painted and, pressed, picks light or dark outright,\nso `mode=\"system\"` follows the OS until the reader chooses. Unrecognised values become\n`light`. Light removes `data-sui-theme`.",
+          "docs": "`light`, `dark`, or `system`, which follows the operating system's `prefers-color-scheme` for\nas long as the element is connected and writes whichever it resolves to. It is the starting\nstate: the switch in the kit shows what is painted and, pressed, picks light or dark outright,\nso `mode=\"system\"` follows the OS until the reader chooses. Unrecognized values become\n`light`. Light removes `data-sui-theme`.",
           "docsTags": [
             {
               "name": "default",
@@ -58782,7 +58867,7 @@
           "mutable": true,
           "attr": "neutral",
           "reflectToAttr": true,
-          "docs": "Neutral family. Unrecognised values become `tint`.",
+          "docs": "Neutral family. Unrecognized values become `tint`.",
           "docsTags": [
             {
               "name": "default",
@@ -58891,7 +58976,7 @@
           "mutable": true,
           "attr": "preset",
           "reflectToAttr": true,
-          "docs": "Named palette or `custom`. Unrecognised values become `shineui`.",
+          "docs": "Named palette or `custom`. Unrecognized values become `shineui`.",
           "docsTags": [
             {
               "name": "default",
@@ -60838,7 +60923,7 @@
           "mutable": false,
           "attr": "position",
           "reflectToAttr": true,
-          "docs": "Where the stack sits: a corner, the middle of the top or bottom edge, or the center of the\nviewport. A top stack grows downward and a bottom stack grows upward, so the newest toast is\nalways the one nearest the middle of the screen; `center` grows both ways and stays centered.\nThe corner names are sides of the screen in either reading direction; inside a toast the\nseverity edge and the icon lead and the X trails. An unrecognised value falls back to `top-right`.\nWhile toasts show, the stack paints in the browser's top layer, above dialogs and every other\nsurface but tooltips, so it answers to the viewport even inside a transformed or clipping box.\nThe live regions that announce the toasts stay where the element is, and stay live while a\nmodal is open; Tab reaches the stack from the modal's last control and goes back.",
+          "docs": "Where the stack sits: a corner, the middle of the top or bottom edge, or the center of the\nviewport. A top stack grows downward and a bottom stack grows upward, so the newest toast is\nalways the one nearest the middle of the screen; `center` grows both ways and stays centered.\nThe corner names are sides of the screen in either reading direction; inside a toast the\nseverity edge and the icon lead and the X trails. An unrecognized value falls back to `top-right`.\nWhile toasts show, the stack paints in the browser's top layer, above dialogs and every other\nsurface but tooltips, so it answers to the viewport even inside a transformed or clipping box.\nThe live regions that announce the toasts stay where the element is, and stay live while a\nmodal is open; Tab reaches the stack from the modal's last control and goes back.",
           "docsTags": [
             {
               "name": "default",
@@ -64084,7 +64169,7 @@
           "mutable": false,
           "attr": "tone",
           "reflectToAttr": true,
-          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
+          "docs": "Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover\nwash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value\nreads on a `tone=\"brand\"` toolbar. Opening the field shows its shell in the card's own inks. The\ndefault variant ignores it.",
           "docsTags": [],
           "values": [
             {
@@ -64400,7 +64485,7 @@
       "encapsulation": "scoped",
       "tag": "sui-tree-table",
       "readme": "# sui-tree-table\n\n\n",
-      "docs": "A chart of accounts or any outline with columns. Branches open and close, siblings sort at every\nlevel, a filter keeps the ancestors of its matches, a tick carries down a subtree, and a branch\ncan load its children on open. `aria-label` or `aria-labelledby` on the host names it. Use\n`sui-tree` for rows that are labels, not records.",
+      "docs": "A chart of accounts or any outline with columns. Branches open and close, siblings sort at every\nlevel, a filter keeps the ancestors of its matches, a check carries down a subtree, and a branch\ncan load its children on open. `aria-label` or `aria-labelledby` on the host names it. Use\n`sui-tree` for rows that are labels, not records.",
       "docsTags": [],
       "usage": {},
       "props": [
@@ -64884,7 +64969,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The keys the user has ticked. Under `checkbox` a branch is stored only when it was ticked\nwhole: the mixed and fully ticked states of every ancestor are derived from the tree on each\nrender, so there is no second copy to go stale when the tree changes shape. Mutable; updated\nbefore `suiSelectionChange` fires. Property, not attribute.",
+          "docs": "The keys the user has checked. Under `checkbox` a branch is stored only when it was checked\nwhole: the mixed and fully checked states of every ancestor are derived from the tree on each\nrender, so there is no second copy to go stale when the tree changes shape. Mutable; updated\nbefore `suiSelectionChange` fires. Property, not attribute.",
           "docsTags": [
             {
               "name": "default",
@@ -64913,7 +64998,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "`none`, `single` (one highlighted row) or `checkbox` (a box per row, a select-all box in the\nheader, and a tick that carries down a whole subtree).",
+          "docs": "`none`, `single` (one highlighted row) or `checkbox` (a box per row, a select-all box in the\nheader, and a check that carries down a whole subtree).",
           "docsTags": [
             {
               "name": "default",
@@ -65263,7 +65348,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Fires when the selection changes; detail is the new `selection`, the ticked keys. Does not\nbubble.",
+          "docs": "Fires when the selection changes; detail is the new `selection`, the checked keys. Does not\nbubble.",
           "docsTags": []
         },
         {
@@ -65371,7 +65456,7 @@
               "name": "money",
               "type": "boolean",
               "optional": true,
-              "docs": "Aligned to the inline end, tabular numerals, weight 640. Implies `type: 'number'` for\ncomparison unless the column says otherwise, because a money column holds an amount.",
+              "docs": "Aligned to the inline end, tabular numerals, weight 640, and a figure shown as an amount:\ntwo decimals, no currency sign and a negative in parentheses (`1,234.50`, `(1,890.00)`), the\nbody rows of a statement. The sign belongs on the totals (`footerTotals`, a group summary),\nwhich a sort leaves in place; `format: (v) => money(v)` puts it on every row. Implies\n`type: 'number'` for comparison unless the column says otherwise, because a money column\nholds an amount.",
               "deprecated": false
             },
             {
@@ -65448,7 +65533,7 @@
               "name": "format",
               "type": "(value: unknown, row: SuiGridRow) => string",
               "optional": true,
-              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number or money column\nshows a plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`), while\nthe export, the clipboard and an edit keep the plain figure (`1234.5`).",
+              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number column shows a\nplain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`) and a money column\nan amount (`1,234.50`, `1.234,50`), while the export, the clipboard and an edit keep the\nplain figure (`1234.5`).",
               "deprecated": false
             },
             {
@@ -65595,7 +65680,7 @@
               "name": "money",
               "type": "boolean",
               "optional": true,
-              "docs": "Aligned to the inline end, tabular numerals, weight 640. Implies `type: 'number'` for\ncomparison unless the column says otherwise, because a money column holds an amount.",
+              "docs": "Aligned to the inline end, tabular numerals, weight 640, and a figure shown as an amount:\ntwo decimals, no currency sign and a negative in parentheses (`1,234.50`, `(1,890.00)`), the\nbody rows of a statement. The sign belongs on the totals (`footerTotals`, a group summary),\nwhich a sort leaves in place; `format: (v) => money(v)` puts it on every row. Implies\n`type: 'number'` for comparison unless the column says otherwise, because a money column\nholds an amount.",
               "deprecated": false
             },
             {
@@ -65672,7 +65757,7 @@
               "name": "format",
               "type": "(value: unknown, row: SuiGridRow) => string",
               "optional": true,
-              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number or money column\nshows a plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`), while\nthe export, the clipboard and an edit keep the plain figure (`1234.5`).",
+              "docs": "Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\nKeep it cheap; it runs once per visible cell per render. Without it a number column shows a\nplain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`) and a money column\nan amount (`1,234.50`, `1.234,50`), while the export, the clipboard and an edit keep the\nplain figure (`1234.5`).",
               "deprecated": false
             },
             {
@@ -66086,7 +66171,7 @@
         {
           "name": "SuiGridValueType",
           "kind": "type",
-          "docs": "How a column's values are compared, formatted and filtered when the column does not say\notherwise. `text` is the fallback for anything unrecognised.",
+          "docs": "How a column's values are compared, formatted and filtered when the column does not say\notherwise. `text` is the fallback for anything unrecognized.",
           "members": [],
           "type": "'text' | 'number' | 'date' | 'boolean'"
         },
@@ -66183,7 +66268,7 @@
           "mutable": false,
           "attr": "severity",
           "reflectToAttr": true,
-          "docs": "How the change reads, on the status ladder `sui-stat-card` shares: `positive`, good news, in\nthe positive ink (the ink under brand status, green under semantic); `critical`, bad news, in\nthe danger ink with the arrow ringed and a hidden \"unfavorable\" after the figure; `neutral`,\nneither, in the muted ink at regular weight, the arrow kept and unringed, so no tone rests on\ncolour alone. Whether a rise is good is yours to say, since a rising receivable is\nbad: `severity=\"critical\"` marks it. An unknown value reads as `positive`. Reflected.",
+          "docs": "How the change reads, on the status ladder `sui-stat-card` shares: `positive`, good news, in\nthe positive ink (the ink under brand status, green under semantic); `critical`, bad news, in\nthe danger ink with the arrow ringed and a hidden \"unfavorable\" after the figure; `neutral`,\nneither, in the muted ink at regular weight, the arrow kept and unringed, so no tone rests on\ncolor alone. Whether a rise is good is yours to say, since a rising receivable is\nbad: `severity=\"critical\"` marks it. An unknown value reads as `positive`. Reflected.",
           "docsTags": [
             {
               "name": "default",
@@ -67098,7 +67183,7 @@
       "path": "src/components/sui-multi-select/sui-multi-select.tsx"
     },
     "src/utils/grid/types.ts::SuiGridColumn": {
-      "declaration": "export interface SuiGridColumn {\n  /** Unique identity, and the row field read unless `field` or `value` says otherwise. */\n  key: string;\n  /** Column heading. */\n  header: string;\n  /** Heading read by assistive technology when `header` is empty: an actions column shows no words\n   *  and still names itself. Ignored when `header` has text. */\n  headerSr?: string;\n  /** Row field to read, when it is not `key`. */\n  field?: string;\n  /** Computed value for sorting, filtering and export. Takes precedence over `field`; a column with\n   *  only a `render` and no `value` sorts and exports by its raw field, which is usually wrong. */\n  value?: (row: SuiGridRow) => unknown;\n  /** Cell content. A string renders as text; an element is mounted into the cell. Called only for\n   *  cells inside the rendered window. Property, not attribute. */\n  render?: (row: SuiGridRow, key: SuiKey) => SuiGridCellValue;\n  /** Drives the default comparator, the default filter match modes and the default alignment. */\n  type?: SuiGridValueType;\n  /** A side of the screen to align to, in either reading direction. Leave it unset for reading\n   *  order: text at the inline start, numbers and money at the inline end. */\n  align?: SuiGridAlign;\n  /** Aligned to the inline end, tabular numerals, weight 640. Implies `type: 'number'` for\n   *  comparison unless the column says otherwise, because a money column holds an amount. */\n  money?: boolean;\n  /** One line, clipped with an ellipsis, and the full value on the cell's `title`. */\n  nowrap?: boolean;\n  /** Starting width in px. Omit to let `flex` share the space. */\n  width?: number;\n  minWidth?: number;\n  maxWidth?: number;\n  /** Share of the space left after fixed widths. `flex: 1` on two columns splits it evenly. */\n  flex?: number;\n  sortable?: boolean;\n  /** Draggable edge on the header. Off by default; a resized column drops its `flex`. */\n  resizable?: boolean;\n  /** Excluded from the render, from export and from the keyboard, but kept in the model so a column\n   *  toggle can bring it back without the caller rebuilding the array. */\n  hidden?: boolean;\n  /** Pins the column to an edge. Pinned columns are never windowed away. */\n  pin?: SuiGridPin;\n  /** Custom comparator; overrides `type`. Return negative, zero or positive. */\n  compare?: (a: unknown, b: unknown) => number;\n  /** Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\n   *  Keep it cheap; it runs once per visible cell per render. Without it a number or money column\n   *  shows a plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`), while\n   *  the export, the clipboard and an edit keep the plain figure (`1234.5`). */\n  format?: (value: unknown, row: SuiGridRow) => string;\n  /** Drawn in `--ink-muted`: a memo, an account type, anything secondary. */\n  muted?: boolean;\n  /** Header tooltip, for a column whose heading had to be short. */\n  headerTitle?: string;\n  /** Opts a column out of in-cell editing on a grid that has it on. A column that draws its own\n   *  cell is never editable: there is no text for an editor to stand in for. */\n  editable?: boolean;\n  /** Extra classes for this column's cells, per row. Called once per visible cell per render, so\n   *  keep it cheap: return a stable string rather than building one. The grid's own classes are\n   *  always applied; this adds to them. */\n  cellClass?: (value: unknown, row: SuiGridRow, index: number) => string | undefined;\n  /** Offers this column a filter control, in the filter row or the filter menu. Ignored while the\n   *  element's `filterDisplay` is `none`. */\n  filter?: boolean;\n  /** Match mode the column's filter opens with. Defaults by type: `contains` for text, `equals` for\n   *  numbers and booleans, `dateIs` for dates. */\n  matchMode?: SuiGridMatchMode;\n  /** The values a status-like column holds. With them, the column's filter menu is a checklist of\n   *  these values, writing an `in` rule, instead of a list of conditions. A bare string is its own\n   *  value and label. The filter row ignores them and keeps its text box. */\n  filterOptions?: readonly (string | { value: string; label: string })[];\n  /** The control this column opens for editing. A plain text input when it is absent. Named by\n   *  value rather than by a string, so an application that edits only text never carries the date\n   *  picker: see the note at the top of `editing.ts`. */\n  editor?: SuiGridEditor;\n  /** Checked when an edit commits. Returning a message refuses the commit and keeps the editor\n   *  open with the message beside it. */\n  validator?: SuiGridValidator;\n}",
+      "declaration": "export interface SuiGridColumn {\n  /** Unique identity, and the row field read unless `field` or `value` says otherwise. */\n  key: string;\n  /** Column heading. */\n  header: string;\n  /** Heading read by assistive technology when `header` is empty: an actions column shows no words\n   *  and still names itself. Ignored when `header` has text. */\n  headerSr?: string;\n  /** Row field to read, when it is not `key`. */\n  field?: string;\n  /** Computed value for sorting, filtering and export. Takes precedence over `field`; a column with\n   *  only a `render` and no `value` sorts and exports by its raw field, which is usually wrong. */\n  value?: (row: SuiGridRow) => unknown;\n  /** Cell content. A string renders as text; an element is mounted into the cell. Called only for\n   *  cells inside the rendered window. Property, not attribute. */\n  render?: (row: SuiGridRow, key: SuiKey) => SuiGridCellValue;\n  /** Drives the default comparator, the default filter match modes and the default alignment. */\n  type?: SuiGridValueType;\n  /** A side of the screen to align to, in either reading direction. Leave it unset for reading\n   *  order: text at the inline start, numbers and money at the inline end. */\n  align?: SuiGridAlign;\n  /** Aligned to the inline end, tabular numerals, weight 640, and a figure shown as an amount:\n   *  two decimals, no currency sign and a negative in parentheses (`1,234.50`, `(1,890.00)`), the\n   *  body rows of a statement. The sign belongs on the totals (`footerTotals`, a group summary),\n   *  which a sort leaves in place; `format: (v) => money(v)` puts it on every row. Implies\n   *  `type: 'number'` for comparison unless the column says otherwise, because a money column\n   *  holds an amount. */\n  money?: boolean;\n  /** One line, clipped with an ellipsis, and the full value on the cell's `title`. */\n  nowrap?: boolean;\n  /** Starting width in px. Omit to let `flex` share the space. */\n  width?: number;\n  minWidth?: number;\n  maxWidth?: number;\n  /** Share of the space left after fixed widths. `flex: 1` on two columns splits it evenly. */\n  flex?: number;\n  sortable?: boolean;\n  /** Draggable edge on the header. Off by default; a resized column drops its `flex`. */\n  resizable?: boolean;\n  /** Excluded from the render, from export and from the keyboard, but kept in the model so a column\n   *  toggle can bring it back without the caller rebuilding the array. */\n  hidden?: boolean;\n  /** Pins the column to an edge. Pinned columns are never windowed away. */\n  pin?: SuiGridPin;\n  /** Custom comparator; overrides `type`. Return negative, zero or positive. */\n  compare?: (a: unknown, b: unknown) => number;\n  /** Formats the value for text: the cell when there is no `render`, the export, and the clipboard.\n   *  Keep it cheap; it runs once per visible cell per render. Without it a number column shows a\n   *  plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`) and a money column\n   *  an amount (`1,234.50`, `1.234,50`), while the export, the clipboard and an edit keep the\n   *  plain figure (`1234.5`). */\n  format?: (value: unknown, row: SuiGridRow) => string;\n  /** Drawn in `--ink-muted`: a memo, an account type, anything secondary. */\n  muted?: boolean;\n  /** Header tooltip, for a column whose heading had to be short. */\n  headerTitle?: string;\n  /** Opts a column out of in-cell editing on a grid that has it on. A column that draws its own\n   *  cell is never editable: there is no text for an editor to stand in for. */\n  editable?: boolean;\n  /** Extra classes for this column's cells, per row. Called once per visible cell per render, so\n   *  keep it cheap: return a stable string rather than building one. The grid's own classes are\n   *  always applied; this adds to them. */\n  cellClass?: (value: unknown, row: SuiGridRow, index: number) => string | undefined;\n  /** Offers this column a filter control, in the filter row or the filter menu. Ignored while the\n   *  element's `filterDisplay` is `none`. */\n  filter?: boolean;\n  /** Match mode the column's filter opens with. Defaults by type: `contains` for text, `equals` for\n   *  numbers and booleans, `dateIs` for dates. */\n  matchMode?: SuiGridMatchMode;\n  /** The values a status-like column holds. With them, the column's filter menu is a checklist of\n   *  these values, writing an `in` rule, instead of a list of conditions. A bare string is its own\n   *  value and label. The filter row ignores them and keeps its text box. */\n  filterOptions?: readonly (string | { value: string; label: string })[];\n  /** The control this column opens for editing. A plain text input when it is absent. Named by\n   *  value rather than by a string, so an application that edits only text never carries the date\n   *  picker: see the note at the top of `editing.ts`. */\n  editor?: SuiGridEditor;\n  /** Checked when an edit commits. Returning a message refuses the commit and keeps the editor\n   *  open with the message beside it. */\n  validator?: SuiGridValidator;\n}",
       "docstring": "One column. `key` is both the field read from the row and the column's identity, so it must be\nunique across the set; `field` overrides the field when the two need to differ (two columns over\nthe same field, or a computed column with no field at all).",
       "path": "src/utils/grid/types.ts"
     },
@@ -67373,7 +67458,7 @@
       "path": "src/utils/editor-api.ts"
     },
     "src/components/sui-save-status/sui-save-status.tsx::SuiSaveState": {
-      "declaration": "export type SuiSaveState = 'saved' | 'saving' | 'dirty' | 'error';",
+      "declaration": "export type SuiSaveState = 'idle' | 'saved' | 'saving' | 'dirty' | 'error';",
       "docstring": "",
       "path": "src/components/sui-save-status/sui-save-status.tsx"
     },
@@ -67408,7 +67493,7 @@
       "path": "src/components/sui-slider/sui-slider.tsx"
     },
     "src/components/sui-speed-dial/sui-speed-dial.tsx::SuiSpeedDialItem": {
-      "declaration": "export interface SuiSpeedDialItem {\n  label: string;\n  /** Greys the satellite and blocks its press. */\n  disabled?: boolean;\n  /** Font Awesome class, e.g. \"fa-regular fa-file-lines\". */\n  icon: string;\n  /** Runs on press (in addition to the `suiPick` event). */\n  command?: () => void;\n}",
+      "declaration": "export interface SuiSpeedDialItem {\n  label: string;\n  /** Grays the satellite and blocks its press. */\n  disabled?: boolean;\n  /** Font Awesome class, e.g. \"fa-regular fa-file-lines\". */\n  icon: string;\n  /** Runs on press (in addition to the `suiPick` event). */\n  command?: () => void;\n}",
       "docstring": "One satellite action. `label` is the accessible name and the hover capsule text.",
       "path": "src/components/sui-speed-dial/sui-speed-dial.tsx"
     },