@shineuix/core 1.0.0 → 1.0.1

package/dist/types/components.d.ts

@@ -227,7 +227,7 @@ export namespace Components {
      */
     interface SuiAccordionItem {
         /**
-          * Greys the header and blocks toggling.
+          * Grays the header and blocks toggling.
           * @default false
          */
         "disabled": boolean;
@@ -416,7 +416,7 @@ export namespace Components {
          */
         "size": 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -667,7 +667,7 @@ export namespace Components {
          */
         "block": boolean;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "disabled": boolean;
@@ -693,7 +693,7 @@ export namespace Components {
          */
         "label"?: string;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "loading": boolean;
@@ -715,16 +715,16 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Control height: sm 28px, md 34px (toolbars), lg 42px (forms). Reflected.
+          * 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.
           * @default 'md'
          */
-        "size": 'sm' | 'md' | 'lg';
+        "size": 'sm' | 'md' | 'lg' | 'xl';
         /**
           * Where the link opens, e.g. `_blank`. Nothing without `href`.
          */
         "target"?: string;
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'danger' | 'inverse';
         /**
@@ -915,7 +915,7 @@ export namespace Components {
      * 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`.
+     * default or downward with `orientation`.
      */
     interface SuiCarousel {
         /**
@@ -947,7 +947,7 @@ export namespace Components {
          */
         "index": number;
         /**
-          * `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`.
+          * `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`.
           * @default 'horizontal'
          */
         "orientation": SuiCarouselOrientation;
@@ -1060,7 +1060,7 @@ export namespace Components {
          */
         "size": 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -2786,16 +2786,16 @@ export namespace Components {
          */
         "columns": SuiGridColumn[];
         /**
-          * Copies the selected rectangle, or the focused cell when nothing is selected, as TSV.  The plain text escapes a cell a spreadsheet would run as a formula unless `copyFormulas` is set; a private flavour beside it carries the cells exactly, so a paste into a grid is lossless. Both go in one synchronous copy where the engine allows, else the plain text goes through `utils/clipboard.ts`, whose fallback covers plain http and a refused Clipboard API. The boolean says whether the text really reached the clipboard, so a caller never confirms a copy that did not happen; `suiCopy` or `suiCopyError` says the same to a listener. Ctrl+C calls it, and Ctrl+Shift+C calls it with `withHeaders`, the column headings as a first row.
+          * Copies the selected rectangle, or the focused cell when nothing is selected, as TSV.  The plain text escapes a cell a spreadsheet would run as a formula unless `copyFormulas` is set; a private flavor beside it carries the cells exactly, so a paste into a grid is lossless. Both go in one synchronous copy where the engine allows, else the plain text goes through `utils/clipboard.ts`, whose fallback covers plain http and a refused Clipboard API. The boolean says whether the text really reached the clipboard, so a caller never confirms a copy that did not happen; `suiCopy` or `suiCopyError` says the same to a listener. Ctrl+C calls it, and Ctrl+Shift+C calls it with `withHeaders`, the column headings as a first row.
          */
         "copy": (withHeaders?: boolean) => Promise<boolean>;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "copyFormulas": boolean;
         /**
-          * Copies the selection and reports the rectangle to clear.  The grid does not blank the cells itself, for the same reason it does not write a fill or a paste: only the host knows whether a column may be emptied at all. The clipboard write happens first and the event is only emitted when it succeeded, so a refused clipboard never costs anybody their data. The clipboard holds what `copy()` would write, formula escapes and the private flavour included. Ctrl+X calls it; it does nothing unless `editMode` is `cell`.
+          * Copies the selection and reports the rectangle to clear.  The grid does not blank the cells itself, for the same reason it does not write a fill or a paste: only the host knows whether a column may be emptied at all. The clipboard write happens first and the event is only emitted when it succeeded, so a refused clipboard never costs anybody their data. The clipboard holds what `copy()` would write, formula escapes and the private flavor included. Ctrl+X calls it; it does nothing unless `editMode` is `cell`.
          */
         "cut": () => Promise<boolean>;
         /**
@@ -2821,7 +2821,7 @@ export namespace Components {
          */
         "exportCsv": (filename?: string) => Promise<boolean>;
         /**
-          * 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`.
+          * 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`.
           * @default 'none'
          */
         "filterDisplay": 'none' | 'row' | 'menu';
@@ -3024,7 +3024,7 @@ export namespace Components {
          */
         "exportCsv": (filename?: string) => Promise<boolean>;
         /**
-          * 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.
+          * 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.
           * @default 'none'
          */
         "filterDisplay": 'none' | 'row' | 'menu';
@@ -3400,7 +3400,7 @@ export namespace Components {
          */
         "todayDate"?: SuiDateInput;
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -3419,6 +3419,11 @@ export namespace Components {
      * with small uppercase labels. Display only; `sui-config-list` is the interactive sibling.
      */
     interface SuiDescriptionList {
+        /**
+          * 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.
+          * @default 'start'
+         */
+        "align": 'start' | 'end';
         /**
           * Grid column count in the columns layout.
           * @default 2
@@ -3664,7 +3669,7 @@ export namespace Components {
          */
         "help"?: string;
         /**
-          * 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.
+          * 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.
           * @default ''
          */
         "html": string;
@@ -3750,7 +3755,7 @@ export namespace Components {
          */
         "icon"?: string;
         /**
-          * 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.
+          * 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.
           * @default 'empty'
          */
         "variant": 'empty' | 'success' | 'error' | 'not-found';
@@ -3763,7 +3768,7 @@ export namespace Components {
      */
     interface SuiFieldset {
         /**
-          * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.
+          * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.
           * @default false
          */
         "collapsed": boolean;
@@ -4180,7 +4185,7 @@ export namespace Components {
          */
         "items": SuiGalleriaItem[];
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "open": boolean;
@@ -4197,7 +4202,7 @@ export namespace Components {
      */
     interface SuiIconButton {
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "disabled": boolean;
@@ -4214,7 +4219,7 @@ export namespace Components {
          */
         "icon"?: string;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "loading": boolean;
@@ -4485,7 +4490,7 @@ export namespace Components {
          */
         "noPreview": boolean;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "open": boolean;
@@ -4506,7 +4511,7 @@ export namespace Components {
          */
         "src": string;
         /**
-          * Frame width: a number of px or any CSS length.
+          * 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.
          */
         "width"?: string | number;
     }
@@ -4752,6 +4757,10 @@ export namespace Components {
      * and Angular forms. Use it for amounts, quantities and rates; always give it a label.
      */
     interface SuiInputNumber {
+        /**
+          * 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.
+         */
+        "align"?: 'start' | 'end';
         /**
           * Native autocomplete hint, e.g. "transaction-amount" or "postal-code".
          */
@@ -4854,7 +4863,7 @@ export namespace Components {
          */
         "suffixText"?: string;
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -5181,7 +5190,7 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * 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.
+          * 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.
           * @default 1
          */
         "step": number;
@@ -5476,7 +5485,7 @@ export namespace Components {
          */
         "hideLegend": boolean;
         /**
-          * 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`.
+          * 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`.
           * @default 'horizontal'
          */
         "orientation": 'horizontal' | 'vertical';
@@ -5616,7 +5625,7 @@ export namespace Components {
          */
         "size": 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -5727,7 +5736,7 @@ export namespace Components {
          */
         "selection": SuiKey[];
         /**
-          * `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.
+          * `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.
           * @default 'single'
          */
         "selectionMode": SuiListSelectionMode;
@@ -5881,7 +5890,7 @@ export namespace Components {
      */
     interface SuiPanel {
         /**
-          * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.
+          * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.
           * @default false
          */
         "collapsed": boolean;
@@ -6153,7 +6162,7 @@ export namespace Components {
          */
         "selection": SuiKey[];
         /**
-          * `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.
+          * `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.
           * @default 'single'
          */
         "selectionMode": SuiListSelectionMode;
@@ -6653,18 +6662,18 @@ export namespace Components {
         "variant": 'classic' | 'compact' | 'bubble';
     }
     /**
-     * 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"`).
+     * 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.
      */
     interface SuiSaveStatus {
         /**
-          * Which line to show.
-          * @default 'saved'
+          * 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.
+          * @default 'idle'
          */
         "state": SuiSaveState;
         /**
-          * 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".
+          * 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.
          */
         "time"?: string;
     }
@@ -6856,7 +6865,7 @@ export namespace Components {
          */
         "size": 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -7182,7 +7191,7 @@ export namespace Components {
      */
     interface SuiSpeedDial {
         /**
-          * 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`.
+          * 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`.
           * @default 'up'
          */
         "direction": 'up' | 'down' | 'left' | 'right';
@@ -7324,7 +7333,7 @@ export namespace Components {
          */
         "orientation": 'horizontal' | 'vertical';
         /**
-          * 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.
+          * 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.
           * @default 0.5
          */
         "ratio": number;
@@ -7419,7 +7428,7 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * 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.
+          * 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.
           * @default 'positive'
          */
         "severity": SuiTrendSeverity;
@@ -7442,7 +7451,7 @@ export namespace Components {
      */
     interface SuiStepper {
         /**
-          * Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterwards; writing it from script emits nothing.
+          * Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterward; writing it from script emits nothing.
           * @default 0
          */
         "active": number;
@@ -7482,7 +7491,7 @@ export namespace Components {
          */
         "badge"?: string | number;
         /**
-          * Greys the tab and blocks activation.
+          * Grays the tab and blocks activation.
           * @default false
          */
         "disabled": boolean;
@@ -7504,7 +7513,7 @@ export namespace Components {
      */
     interface SuiTabs {
         /**
-          * 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.
+          * 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.
           * @default 0
          */
         "active": number;
@@ -7706,7 +7715,7 @@ export namespace Components {
          */
         "appearance": 'compact' | 'panel';
         /**
-          * 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`.
+          * 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`.
           * @default 'dark'
          */
         "code": SuiThemeCode;
@@ -7716,12 +7725,12 @@ export namespace Components {
          */
         "disabled": boolean;
         /**
-          * `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`.
+          * `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`.
           * @default 'light'
          */
         "mode": SuiThemeMode;
         /**
-          * Neutral family. Unrecognised values become `tint`.
+          * Neutral family. Unrecognized values become `tint`.
           * @default 'tint'
          */
         "neutral": SuiThemeNeutral;
@@ -7731,7 +7740,7 @@ export namespace Components {
          */
         "persist": boolean;
         /**
-          * Named palette or `custom`. Unrecognised values become `shineui`.
+          * Named palette or `custom`. Unrecognized values become `shineui`.
           * @default 'shineui'
          */
         "preset": SuiThemePreset;
@@ -7952,7 +7961,7 @@ export namespace Components {
          */
         "name"?: string;
         /**
-          * 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.
+          * 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.
           * @default 'top-right'
          */
         "position": SuiToastPosition;
@@ -8383,7 +8392,7 @@ export namespace Components {
          */
         "size": 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -8403,7 +8412,7 @@ export namespace Components {
     }
     /**
      * 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
+     * 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.
      */
@@ -8482,12 +8491,12 @@ export namespace Components {
          */
         "nullOrder": SuiGridNullOrder;
         /**
-          * The keys the user has ticked. Under `checkbox` a branch is stored only when it was ticked whole: the mixed and fully ticked states of every ancestor are derived from the tree on each render, so there is no second copy to go stale when the tree changes shape. Mutable; updated before `suiSelectionChange` fires. Property, not attribute.
+          * The keys the user has checked. Under `checkbox` a branch is stored only when it was checked whole: the mixed and fully checked states of every ancestor are derived from the tree on each render, so there is no second copy to go stale when the tree changes shape. Mutable; updated before `suiSelectionChange` fires. Property, not attribute.
           * @default []
          */
         "selection": SuiKey[];
         /**
-          * `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).
+          * `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).
           * @default 'none'
          */
         "selectionMode": 'none' | 'single' | 'checkbox';
@@ -8536,7 +8545,7 @@ export namespace Components {
          */
         "note"?: string;
         /**
-          * 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.
+          * 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.
           * @default 'positive'
          */
         "severity": SuiTrendSeverity;
@@ -9352,7 +9361,7 @@ declare global {
      * 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`.
+     * default or downward with `orientation`.
      */
     interface HTMLSuiCarouselElement extends Components.SuiCarousel, HTMLStencilElement {
         addEventListener<K extends keyof HTMLSuiCarouselElementEventMap>(type: K, listener: (this: HTMLSuiCarouselElement, ev: SuiCarouselCustomEvent<HTMLSuiCarouselElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -11433,8 +11442,8 @@ declare global {
         new (): HTMLSuiRichTextEditorElement;
     };
     /**
-     * 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"`).
+     * 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.
      */
     interface HTMLSuiSaveStatusElement extends Components.SuiSaveStatus, HTMLStencilElement {
@@ -12143,7 +12152,7 @@ declare global {
     }
     /**
      * 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
+     * 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.
      */
@@ -12377,7 +12386,7 @@ declare namespace LocalJSX {
      */
     interface SuiAccordionItem {
         /**
-          * Greys the header and blocks toggling.
+          * Grays the header and blocks toggling.
           * @default false
          */
         "disabled"?: boolean;
@@ -12598,7 +12607,7 @@ declare namespace LocalJSX {
          */
         "size"?: 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -12857,7 +12866,7 @@ declare namespace LocalJSX {
          */
         "block"?: boolean;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "disabled"?: boolean;
@@ -12883,7 +12892,7 @@ declare namespace LocalJSX {
          */
         "label"?: string;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "loading"?: boolean;
@@ -12901,16 +12910,16 @@ declare namespace LocalJSX {
          */
         "rel"?: string;
         /**
-          * Control height: sm 28px, md 34px (toolbars), lg 42px (forms). Reflected.
+          * 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.
           * @default 'md'
          */
-        "size"?: 'sm' | 'md' | 'lg';
+        "size"?: 'sm' | 'md' | 'lg' | 'xl';
         /**
           * Where the link opens, e.g. `_blank`. Nothing without `href`.
          */
         "target"?: string;
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'danger' | 'inverse';
         /**
@@ -13109,7 +13118,7 @@ declare namespace LocalJSX {
      * 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`.
+     * default or downward with `orientation`.
      */
     interface SuiCarousel {
         /**
@@ -13145,7 +13154,7 @@ declare namespace LocalJSX {
          */
         "onSuiIndexChange"?: (event: SuiCarouselCustomEvent<number>) => void;
         /**
-          * `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`.
+          * `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`.
           * @default 'horizontal'
          */
         "orientation"?: SuiCarouselOrientation;
@@ -13270,7 +13279,7 @@ declare namespace LocalJSX {
          */
         "size"?: 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -15080,7 +15089,7 @@ declare namespace LocalJSX {
          */
         "columns"?: SuiGridColumn[];
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "copyFormulas"?: boolean;
@@ -15103,7 +15112,7 @@ declare namespace LocalJSX {
          */
         "emptyMessage"?: string;
         /**
-          * 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`.
+          * 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`.
           * @default 'none'
          */
         "filterDisplay"?: 'none' | 'row' | 'menu';
@@ -15330,7 +15339,7 @@ declare namespace LocalJSX {
          */
         "expandedRows"?: SuiKey[];
         /**
-          * 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.
+          * 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.
           * @default 'none'
          */
         "filterDisplay"?: 'none' | 'row' | 'menu';
@@ -15762,7 +15771,7 @@ declare namespace LocalJSX {
          */
         "todayDate"?: SuiDateInput;
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -15781,6 +15790,11 @@ declare namespace LocalJSX {
      * with small uppercase labels. Display only; `sui-config-list` is the interactive sibling.
      */
     interface SuiDescriptionList {
+        /**
+          * 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.
+          * @default 'start'
+         */
+        "align"?: 'start' | 'end';
         /**
           * Grid column count in the columns layout.
           * @default 2
@@ -16050,7 +16064,7 @@ declare namespace LocalJSX {
          */
         "help"?: string;
         /**
-          * 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.
+          * 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.
           * @default ''
          */
         "html"?: string;
@@ -16136,7 +16150,7 @@ declare namespace LocalJSX {
          */
         "icon"?: string;
         /**
-          * 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.
+          * 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.
           * @default 'empty'
          */
         "variant"?: 'empty' | 'success' | 'error' | 'not-found';
@@ -16149,7 +16163,7 @@ declare namespace LocalJSX {
      */
     interface SuiFieldset {
         /**
-          * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.
+          * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.
           * @default false
          */
         "collapsed"?: boolean;
@@ -16642,7 +16656,7 @@ declare namespace LocalJSX {
          */
         "onSuiOpen"?: (event: SuiGalleriaCustomEvent<void>) => void;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "open"?: boolean;
@@ -16655,7 +16669,7 @@ declare namespace LocalJSX {
      */
     interface SuiIconButton {
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "disabled"?: boolean;
@@ -16672,7 +16686,7 @@ declare namespace LocalJSX {
          */
         "icon"?: string;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "loading"?: boolean;
@@ -16979,7 +16993,7 @@ declare namespace LocalJSX {
          */
         "onSuiOpen"?: (event: SuiImageCustomEvent<void>) => void;
         /**
-          * 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.
+          * 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.
           * @default false
          */
         "open"?: boolean;
@@ -16996,7 +17010,7 @@ declare namespace LocalJSX {
          */
         "src": string;
         /**
-          * Frame width: a number of px or any CSS length.
+          * 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.
          */
         "width"?: string | number;
     }
@@ -17278,6 +17292,10 @@ declare namespace LocalJSX {
      * and Angular forms. Use it for amounts, quantities and rates; always give it a label.
      */
     interface SuiInputNumber {
+        /**
+          * 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.
+         */
+        "align"?: 'start' | 'end';
         /**
           * Native autocomplete hint, e.g. "transaction-amount" or "postal-code".
          */
@@ -17392,7 +17410,7 @@ declare namespace LocalJSX {
          */
         "suffixText"?: string;
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -17775,7 +17793,7 @@ declare namespace LocalJSX {
          */
         "required"?: boolean;
         /**
-          * 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.
+          * 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.
           * @default 1
          */
         "step"?: number;
@@ -18098,7 +18116,7 @@ declare namespace LocalJSX {
          */
         "hideLegend"?: boolean;
         /**
-          * 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`.
+          * 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`.
           * @default 'horizontal'
          */
         "orientation"?: 'horizontal' | 'vertical';
@@ -18246,7 +18264,7 @@ declare namespace LocalJSX {
          */
         "size"?: 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -18385,7 +18403,7 @@ declare namespace LocalJSX {
          */
         "selection"?: SuiKey[];
         /**
-          * `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.
+          * `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.
           * @default 'single'
          */
         "selectionMode"?: SuiListSelectionMode;
@@ -18543,7 +18561,7 @@ declare namespace LocalJSX {
      */
     interface SuiPanel {
         /**
-          * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.
+          * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.
           * @default false
          */
         "collapsed"?: boolean;
@@ -18847,7 +18865,7 @@ declare namespace LocalJSX {
          */
         "selection"?: SuiKey[];
         /**
-          * `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.
+          * `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.
           * @default 'single'
          */
         "selectionMode"?: SuiListSelectionMode;
@@ -19359,18 +19377,18 @@ declare namespace LocalJSX {
         "variant"?: 'classic' | 'compact' | 'bubble';
     }
     /**
-     * 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"`).
+     * 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.
      */
     interface SuiSaveStatus {
         /**
-          * Which line to show.
-          * @default 'saved'
+          * 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.
+          * @default 'idle'
          */
         "state"?: SuiSaveState;
         /**
-          * 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".
+          * 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.
          */
         "time"?: string;
     }
@@ -19562,7 +19580,7 @@ declare namespace LocalJSX {
          */
         "size"?: 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -19912,7 +19930,7 @@ declare namespace LocalJSX {
      */
     interface SuiSpeedDial {
         /**
-          * 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`.
+          * 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`.
           * @default 'up'
          */
         "direction"?: 'up' | 'down' | 'left' | 'right';
@@ -20078,7 +20096,7 @@ declare namespace LocalJSX {
          */
         "orientation"?: 'horizontal' | 'vertical';
         /**
-          * 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.
+          * 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.
           * @default 0.5
          */
         "ratio"?: number;
@@ -20173,7 +20191,7 @@ declare namespace LocalJSX {
          */
         "scaleMin"?: number;
         /**
-          * 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.
+          * 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.
           * @default 'positive'
          */
         "severity"?: SuiTrendSeverity;
@@ -20196,7 +20214,7 @@ declare namespace LocalJSX {
      */
     interface SuiStepper {
         /**
-          * Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterwards; writing it from script emits nothing.
+          * Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterward; writing it from script emits nothing.
           * @default 0
          */
         "active"?: number;
@@ -20236,7 +20254,7 @@ declare namespace LocalJSX {
          */
         "badge"?: string | number;
         /**
-          * Greys the tab and blocks activation.
+          * Grays the tab and blocks activation.
           * @default false
          */
         "disabled"?: boolean;
@@ -20258,7 +20276,7 @@ declare namespace LocalJSX {
      */
     interface SuiTabs {
         /**
-          * 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.
+          * 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.
           * @default 0
          */
         "active"?: number;
@@ -20460,7 +20478,7 @@ declare namespace LocalJSX {
          */
         "appearance"?: 'compact' | 'panel';
         /**
-          * 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`.
+          * 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`.
           * @default 'dark'
          */
         "code"?: SuiThemeCode;
@@ -20470,12 +20488,12 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * `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`.
+          * `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`.
           * @default 'light'
          */
         "mode"?: SuiThemeMode;
         /**
-          * Neutral family. Unrecognised values become `tint`.
+          * Neutral family. Unrecognized values become `tint`.
           * @default 'tint'
          */
         "neutral"?: SuiThemeNeutral;
@@ -20489,7 +20507,7 @@ declare namespace LocalJSX {
          */
         "persist"?: boolean;
         /**
-          * Named palette or `custom`. Unrecognised values become `shineui`.
+          * Named palette or `custom`. Unrecognized values become `shineui`.
           * @default 'shineui'
          */
         "preset"?: SuiThemePreset;
@@ -20714,7 +20732,7 @@ declare namespace LocalJSX {
          */
         "onSuiRemove"?: (event: SuiToastHostCustomEvent<SuiToastItem>) => void;
         /**
-          * 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.
+          * 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.
           * @default 'top-right'
          */
         "position"?: SuiToastPosition;
@@ -21185,7 +21203,7 @@ declare namespace LocalJSX {
          */
         "size"?: 'sm' | 'md' | 'lg';
         /**
-          * 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.
+          * 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.
          */
         "tone"?: 'inverse';
         /**
@@ -21205,7 +21223,7 @@ declare namespace LocalJSX {
     }
     /**
      * 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
+     * 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.
      */
@@ -21288,7 +21306,7 @@ declare namespace LocalJSX {
          */
         "onSuiLoad"?: (event: SuiTreeTableCustomEvent<SuiGridTreeNode>) => void;
         /**
-          * Fires when the selection changes; detail is the new `selection`, the ticked keys. Does not bubble.
+          * Fires when the selection changes; detail is the new `selection`, the checked keys. Does not bubble.
          */
         "onSuiSelectionChange"?: (event: SuiTreeTableCustomEvent<SuiKey[]>) => void;
         /**
@@ -21296,12 +21314,12 @@ declare namespace LocalJSX {
          */
         "onSuiSort"?: (event: SuiTreeTableCustomEvent<SuiGridSort[]>) => void;
         /**
-          * The keys the user has ticked. Under `checkbox` a branch is stored only when it was ticked whole: the mixed and fully ticked states of every ancestor are derived from the tree on each render, so there is no second copy to go stale when the tree changes shape. Mutable; updated before `suiSelectionChange` fires. Property, not attribute.
+          * The keys the user has checked. Under `checkbox` a branch is stored only when it was checked whole: the mixed and fully checked states of every ancestor are derived from the tree on each render, so there is no second copy to go stale when the tree changes shape. Mutable; updated before `suiSelectionChange` fires. Property, not attribute.
           * @default []
          */
         "selection"?: SuiKey[];
         /**
-          * `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).
+          * `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).
           * @default 'none'
          */
         "selectionMode"?: 'none' | 'single' | 'checkbox';
@@ -21342,7 +21360,7 @@ declare namespace LocalJSX {
          */
         "note"?: string;
         /**
-          * 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.
+          * 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.
           * @default 'positive'
          */
         "severity"?: SuiTrendSeverity;
@@ -21501,7 +21519,7 @@ declare namespace LocalJSX {
     interface SuiButtonAttributes {
         "variant": 'accent' | 'brand' | 'outline' | 'ghost' | 'danger' | 'link';
         "tone": 'danger' | 'inverse';
-        "size": 'sm' | 'md' | 'lg';
+        "size": 'sm' | 'md' | 'lg' | 'xl';
         "label": string;
         "icon": string;
         "iconPos": 'start' | 'end';
@@ -21998,6 +22016,7 @@ declare namespace LocalJSX {
         "layout": 'rows' | 'columns';
         "columns": number;
         "termWidth": number;
+        "align": 'start' | 'end';
     }
     interface SuiDialogAttributes {
         "open": boolean;
@@ -22273,6 +22292,7 @@ declare namespace LocalJSX {
         "step": number;
         "money": boolean;
         "currency": string;
+        "align": 'start' | 'end';
         "locale": string;
         "prefixText": string;
         "suffixText": string;
@@ -23252,7 +23272,7 @@ declare module "@stencil/core" {
              * 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`.
+             * default or downward with `orientation`.
              */
             "sui-carousel": LocalJSX.IntrinsicElements["sui-carousel"] & JSXBase.HTMLAttributes<HTMLSuiCarouselElement>;
             /**
@@ -23891,8 +23911,8 @@ declare module "@stencil/core" {
              */
             "sui-rich-text-editor": LocalJSX.IntrinsicElements["sui-rich-text-editor"] & JSXBase.HTMLAttributes<HTMLSuiRichTextEditorElement>;
             /**
-             * 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"`).
+             * 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.
              */
             "sui-save-status": LocalJSX.IntrinsicElements["sui-save-status"] & JSXBase.HTMLAttributes<HTMLSuiSaveStatusElement>;
@@ -24122,7 +24142,7 @@ declare module "@stencil/core" {
             "sui-tree-select": LocalJSX.IntrinsicElements["sui-tree-select"] & JSXBase.HTMLAttributes<HTMLSuiTreeSelectElement>;
             /**
              * 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
+             * 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.
              */