@shineuix/core 1.0.0 → 1.0.1

package/dist/types/components/sui-color-picker/sui-color-picker.d.ts

@@ -94,13 +94,13 @@ export declare class SuiColorPicker {
     private requestClose;
     private swatches;
     /** The swatch that holds the value, as row and column: the one a pick chose while the value is
-     *  still its colour, else the first in reading order, so a value set from outside lands on the
+     *  still its color, else the first in reading order, so a value set from outside lands on the
      *  palette row. Undefined when no swatch has the value. */
     private owner;
     /** The one swatch in the tab order: the selected one, else the first. */
     private tabStop;
     private isSel;
-    /** A pick of the copy of the current colour that is not selected moves the pick there and leaves
+    /** A pick of the copy of the current color that is not selected moves the pick there and leaves
      *  the value as it is. */
     private pick;
     private focusSwatch;

package/dist/types/components/sui-context-menu/sui-context-menu.d.ts

@@ -124,7 +124,7 @@ export declare class SuiContextMenu {
     /** The keyboard's own way in: Shift+F10 and the Menu key, as every desktop context menu has.
      *  Without it the whole element is pointer-only, and the keyboard map below describes rows a
      *  keyboard user has no way to reach. It opens at the focused element rather than at a pointer,
-     *  which is where a reader expects it. Browsers also synthesise a `contextmenu` event for these
+     *  which is where a reader expects it. Browsers also synthesize a `contextmenu` event for these
      *  keys, but only over a focusable target, so this does not wait for that. */
     private onHostKey;
     /** Opens at a viewport point, shared by the pointer and the keyboard routes. */

package/dist/types/components/sui-data-grid/sui-data-grid.d.ts

@@ -163,7 +163,7 @@ export declare class SuiDataGrid {
      *  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. */
+     *  exactly either way, from a private clipboard flavor the copy carries beside the plain text. */
     copyFormulas: boolean;
     /** Whether a cell can be edited in place, spelled as on `sui-data-table`: `cell` turns editing
      *  on and `none`, the default, leaves the cells read-only. A column opts out with
@@ -211,7 +211,7 @@ export declare class SuiDataGrid {
     /** 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.
+     *  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`. */
     filterDisplay: 'none' | 'row' | 'menu';
     /** Fires when the mounted window changes, and once after the first render. Fetch the rows the
@@ -269,7 +269,7 @@ export declare class SuiDataGrid {
     private focusRevision;
     /** The header cell that holds focus, as a column index, or -1 while focus is in the body. The
      *  header is a row in the arrow-key map: ArrowUp from the first row enters it, ArrowDown leaves
-     *  it, Enter and Space sort a column or tick the select-all box. */
+     *  it, Enter and Space sort a column or check the select-all box. */
     private headerCol;
     /** The cell a pointer range drag started from, while the button is down. */
     private dragAnchor?;
@@ -330,7 +330,7 @@ export declare class SuiDataGrid {
     private redoStack;
     /** `rows` indexed by record, built when an event first needs it and again when `rows` changes. */
     private sourceMap?;
-    /** The clipboard fallback a Ctrl+V arms, cancelled when the browser's own paste event arrives. */
+    /** The clipboard fallback a Ctrl+V arms, canceled when the browser's own paste event arrives. */
     private pasteFallback?;
     /** Column being dragged to a new position; its header dims while it is carried. */
     private dragKey?;
@@ -634,7 +634,7 @@ export declare class SuiDataGrid {
     private rowNumberWidth;
     /** The first column focus may land on: past the row numbers, which are never focused. The
      *  selection column is not skipped: each of its cells holds the row's box and takes focus like any
-     *  other cell, so Home and ArrowLeft reach it and Space or Enter ticks it, as in AG Grid. */
+     *  other cell, so Home and ArrowLeft reach it and Space or Enter checks it, as in AG Grid. */
     private minCol;
     /** The first data column: past every column the grid adds for itself. */
     private dataStart;
@@ -660,7 +660,7 @@ export declare class SuiDataGrid {
      * grid keeps its one tab stop and lets the arrows do the walking, as AG Grid does.
      */
     private focusHeader;
-    /** Enter or Space on a header: sorts a sortable column, or ticks the select-all box. */
+    /** Enter or Space on a header: sorts a sortable column, or checks the select-all box. */
     private activateHeader;
     /** Scrolls the smallest amount that puts a cell fully inside the viewport. */
     private revealCell;
@@ -694,13 +694,13 @@ export declare class SuiDataGrid {
     private hasSelectColumn;
     private setSelection;
     /**
-     * Selects one row, honouring the modifiers a person expects from a file list.
+     * Selects one row, honoring the modifiers a person expects from a file list.
      *
      * Shift extends from the anchor and *sets* the run rather than flipping it, because flipping
-     * deselects the half that was already ticked, which is never what a drag across a range means.
+     * deselects the half that was already checked, which is never what a drag across a range means.
      */
     private selectRow;
-    /** The header box: ticks everything in the view, or clears it. */
+    /** The header box: checks everything in the view, or clears it. */
     private toggleSelectAll;
     /** The rectangle a fill would start from: the selected range, or the focused cell alone. */
     private fillSource;
@@ -760,7 +760,7 @@ export declare class SuiDataGrid {
     private onHeadDragOver;
     /** Leaving a header for anything but a part of it clears its mark. */
     private onHeadDragLeave;
-    /** A drag that ends anywhere, dropped or cancelled, lets its header go, so a later drag of
+    /** A drag that ends anywhere, dropped or canceled, lets its header go, so a later drag of
      *  something else over the header is not taken for a column. */
     private onHeadDragEnd;
     private onHeadDrop;
@@ -885,7 +885,7 @@ export declare class SuiDataGrid {
      * 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.
+     * 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
@@ -917,7 +917,7 @@ export declare class SuiDataGrid {
      * 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`.
+     * private flavor included. Ctrl+X calls it; it does nothing unless `editMode` is `cell`.
      */
     cut(): Promise<boolean>;
     /** The header's own keys: the sideways arrows, Home and End walk the headers, ArrowDown returns

package/dist/types/components/sui-data-table/sui-data-table.d.ts

@@ -94,7 +94,7 @@ export declare class SuiDataTable {
     sortIndicator: 'sorted' | 'all';
     /** 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
+     *  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. */
     filterDisplay: 'none' | 'row' | 'menu';
     /** The filter model: one rule per column plus an optional global term. Named for the model, since
@@ -605,10 +605,10 @@ export declare class SuiDataTable {
     private applyFilter;
     private clearFilter;
     /** Applies a new selection and reports it. The model says what changed on its own: comparing it
-     *  with the one before tells a tick from an untick, which a list of the keys on screen cannot once
+     *  with the one before tells a check from an uncheck, which a list of the keys on screen cannot once
      *  only part of the set is loaded. */
     private setSelection;
-    /** Whether the header box is ticked, mixed or clear. Memoized on the selection and the rows,
+    /** Whether the header box is checked, mixed or clear. Memoized on the selection and the rows,
      *  because it walks every row and a scroll must not pay for it. */
     private headState;
     private onToggleAll;
@@ -677,7 +677,7 @@ export declare class SuiDataTable {
     private onHeadDragOver;
     /** Leaving a header for anything but a part of it clears its mark. */
     private onHeadDragLeave;
-    /** A drag that ends anywhere, dropped or cancelled, lets its header go. */
+    /** A drag that ends anywhere, dropped or canceled, lets its header go. */
     private onHeadDragEnd;
     private onHeadDrop;
     private writeLayout;

package/dist/types/components/sui-date-picker/sui-date-picker.d.ts

@@ -116,7 +116,7 @@ export declare class SuiDatePicker {
     variant: 'default' | 'quiet';
     /**
      * 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
+     * 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.
      */
@@ -185,7 +185,7 @@ export declare class SuiDatePicker {
     private gridEl?;
     private pendingFocus;
     private pendingTimeFocus;
-    /** A value written from outside while the time column shows: centre the new time on the next render. */
+    /** A value written from outside while the time column shows: center the new time on the next render. */
     private pendingTimeScroll;
     /** True while the element writes `value` itself, so the column keeps the scroll the user left it at. */
     private selfWrite;
@@ -262,7 +262,7 @@ export declare class SuiDatePicker {
     /** The row holding the tab stop: the moved-to row, else the picked time, else the first the day allows. */
     private activeTime;
     private activeTimeRow;
-    /** Brings the active time row into view inside the column, centred on open; nothing else scrolls. */
+    /** Brings the active time row into view inside the column, centered on open; nothing else scrolls. */
     private scrollTime;
     /** A day's button, in the calendar wherever it sits. */
     private dayButton;

package/dist/types/components/sui-description-list/sui-description-list.d.ts

@@ -29,6 +29,13 @@ export declare class SuiDescriptionList {
     columns: number;
     /** Term column width in px in the rows layout. */
     termWidth: number;
+    /**
+     * 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.
+     */
+    align: 'start' | 'end';
     /** Fires after a value reaches the clipboard, together with the short "Copied" state on the
      *  control; detail is the copied text, as on every element that copies. */
     suiCopy: EventEmitter<string>;

package/dist/types/components/sui-dialog/sui-dialog.d.ts

@@ -120,7 +120,7 @@ export declare class SuiDialog {
      *  it was instead of on the page behind the dialog; the click still asks to close. */
     private onScrimPress;
     private deactivate;
-    /** The fade has run (or there was none): the layer goes, and a dragged card returns to centre
+    /** The fade has run (or there was none): the layer goes, and a dragged card returns to center
      *  for the next open rather than snapping there while still visible. */
     private exited;
     private requestClose;

package/dist/types/components/sui-edit-box/sui-edit-box.d.ts

@@ -18,7 +18,7 @@ export declare class SuiEditBox {
      * 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
+     * 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.
      */

package/dist/types/components/sui-empty-state/sui-empty-state.d.ts

@@ -12,7 +12,7 @@
  */
 export declare class SuiEmptyState {
     host: HTMLElement;
-    /** Outcome flavour: `empty`, `success` (the brand, never a green), `error` (the deep accent) or `not-found`.
+    /** 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. */

package/dist/types/components/sui-fieldset/sui-fieldset.d.ts

@@ -15,7 +15,7 @@ export declare class SuiFieldset {
     /** Puts a disclosure button with `aria-expanded` and `aria-controls` inside the legend. The body
      *  closes over `--duration-base` and unmounts once it has closed. Reflected. */
     collapsible: boolean;
-    /** 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. */
     collapsed: boolean;
     /**
      * Disables every form control inside the group through the native `fieldset[disabled]`

package/dist/types/components/sui-galleria/sui-galleria.d.ts

@@ -51,7 +51,7 @@ export declare class SuiGalleria {
     /**
      * 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
+     * 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

package/dist/types/components/sui-icon-button/sui-icon-button.d.ts

@@ -33,13 +33,18 @@ export declare class SuiIconButton {
     tone?: 'inverse' | 'danger';
     /** 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. */
+     *  `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. */
     disabled: boolean;
     /** 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. */
+     *  same: it drops its `href` until the work is done and stays a tab stop, so nothing opens
+     *  it, a new tab included. Reflected. */
     loading: boolean;
     /** Leaves out the tooltip the `aria-label` would otherwise draw, for a button whose name is
      *  already on screen beside it: a chip's remove control, a row that repeats the word. The name
@@ -88,6 +93,12 @@ export declare class SuiIconButton {
     private stopAria?;
     private hostState;
     private stopAriaState?;
+    /** The element's own `aria-disabled="true"`: the focusable disabled button. */
+    private hostDisabled;
+    private stopAriaDisabled?;
+    /** The element's own `aria-describedby`, forwarded to the button. */
+    private hostDescribedby?;
+    private stopAriaDescribedby?;
     /** Armed on every connect, not once at load: a button moved in the document, as a framework moves
      *  a keyed row or a dragged card, is disconnected on the way and would stop following its
      *  `aria-label` and state attributes. */
@@ -96,12 +107,19 @@ export declare class SuiIconButton {
     private btn?;
     /** Moves keyboard focus to the button, or to the link when `href` is set. */
     setFocus(): Promise<void>;
-    /** True while the control swallows its activation: a busy button, or a link that is busy or
-     *  disabled. A disabled button dispatches no click of its own, so it needs nothing. */
+    /** Disabled by the element's `aria-disabled`, and not by `disabled`, which wins. */
+    private get held();
+    /** True while the control swallows its activation: a busy button, a link that is busy or
+     *  disabled, or a button held by `aria-disabled`. A disabled button dispatches no click of its
+     *  own, so it needs nothing. */
     private get blocked();
     /** The `rel` a link carries: the prop as given, else `noopener` for a `_blank` target. */
     private get linkRel();
     /** A blocked control swallows its activation before the host, the form or a router hears it. */
     private onClick;
+    /** A script's `element.click()` lands on the element, not on the control inside, so the
+     *  control's handler never sees it. A native disabled button dispatches nothing for `click()`,
+     *  and this element swallows it the same way while it is disabled or blocked. */
+    onHostClick(e: MouseEvent): void;
     render(): any;
 }

package/dist/types/components/sui-icon-field/sui-icon-field.d.ts

@@ -7,7 +7,7 @@ import { SuiInputType } from '../../utils/input-type.js';
  * it posts `name=value`.
  *
  * @slot end - Trailing content inside the field's edge: a shortcut hint, a unit, a small action. It
- * sits after the clear control and the trailing icon, centred on the field's height, and the input
+ * sits after the clear control and the trailing icon, centered on the field's height, and the input
  * gives up room for it only while it is filled. A press on it that lands on nothing focusable puts
  * the caret in the input, so a `sui-kbd` hint reads and behaves as part of the field.
  */

package/dist/types/components/sui-image/sui-image.d.ts

@@ -28,7 +28,8 @@ export declare class SuiImage {
     alt: string;
     /** Caption under the image (11.5px faint ink) and under the lightbox preview. */
     caption?: 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;
     /** Frame height: a number of px or any CSS length. */
     height?: string | number;
@@ -55,7 +56,7 @@ export declare class SuiImage {
     /**
      * 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,
+     * 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

package/dist/types/components/sui-input-number/sui-input-number.d.ts

@@ -33,7 +33,7 @@ export declare class SuiInputNumber {
     variant: 'default' | 'quiet';
     /**
      * 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
+     * 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.
      */
@@ -70,6 +70,13 @@ export declare class SuiInputNumber {
      * without `money`.
      */
     currency: string;
+    /**
+     * 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';
     /**
      * BCP 47 tag that sets the grouping and decimal characters, e.g. "de-DE" shows 1.234,50 and
      * accepts it typed. Unset, the page's locale (`setLocale()` or `<html lang>`), else en-US, as on
@@ -149,7 +156,7 @@ export declare class SuiInputNumber {
     private clamp;
     /** Coerce, round to `decimals`, then clamp to `min`/`max`, so the number the element holds, posts
         and reports through `aria-valuenow` is always the one it displays. Never emits: a mount-time or
-        author-driven normalisation is not a user commit (same rule as sui-color-editor). */
+        author-driven normalization is not a user commit (same rule as sui-color-editor). */
     private normalizeValue;
     /** Step size, guarded the way the HTML step algorithm guards it: a non-numeric or non-positive
         `step` falls back to 1 rather than destroying the value. */

package/dist/types/components/sui-knob/sui-knob.d.ts

@@ -22,7 +22,7 @@ export declare class SuiKnob {
     min: number;
     /** Highest value. */
     max: number;
-    /** Increment between values; drag positions and keyboard steps snap to it. Decimals are honoured.
+    /** 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. */
     step: number;

package/dist/types/components/sui-message/sui-message.d.ts

@@ -62,6 +62,6 @@ export declare class SuiMessage {
      * page; focus moves instead to where Tab would have gone next, or back to where it came from
      * when the message was the last stop, so the reader keeps their place.
      */
-    private neighbour;
+    private neighbor;
     render(): any;
 }

package/dist/types/components/sui-meter-group/sui-meter-group.d.ts

@@ -34,7 +34,7 @@ export declare class SuiMeterGroup {
      *  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`. */
+     *  it. An unrecognized value falls back to `horizontal`. */
     orientation: 'horizontal' | 'vertical';
     render(): any;
 }

package/dist/types/components/sui-multi-select/sui-multi-select.d.ts

@@ -10,7 +10,7 @@ export interface SuiMultiSelectOption {
     /** One of the values `value` holds, as given: a number stays a number through `value`,
      *  `suiChange` and a framework binding. The form posts its text. */
     value: SuiKey;
-    /** Greys the row out; the arrows and select-all step over it. */
+    /** Grays the row out; the arrows and select-all step over it. */
     disabled?: boolean;
     /** Font Awesome class drawn before the label, in the row and on the chip. */
     icon?: string;
@@ -111,7 +111,7 @@ export declare class SuiMultiSelect {
     variant: 'default' | 'quiet';
     /**
      * 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
+     * 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.
      */

package/dist/types/components/sui-order-list/sui-order-list.d.ts

@@ -29,7 +29,7 @@ export declare class SuiOrderList {
     /** Hides the click controls; pointer drag and the keyboard lift remain. Reflected. */
     dragOnly: boolean;
     /** `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`,
+     *  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. */
     selectionMode: SuiListSelectionMode;
     /** Shows the filter box above the list. It narrows what is drawn (by label, description and
@@ -83,13 +83,13 @@ export declare class SuiOrderList {
     /** Writes the selection as the values of rows `next` and reports it, unless nothing changed. */
     private setSel;
     private select;
-    /** Checkbox mode: adds or removes one row from the ticked set, keeping it in list order. */
+    /** Checkbox mode: adds or removes one row from the checked set, keeping it in list order. */
     private toggle;
-    /** Select-all header: ticks every row the filter shows, or clears them when they are all ticked. */
+    /** Select-all header: checks every row the filter shows, or clears them when they are all checked. */
     private toggleAll;
     private commit;
     private reorder;
-    /** True when the ticked rows already sit together at one end, so that edge's controls are spent. */
+    /** True when the checked rows already sit together at one end, so that edge's controls are spent. */
     private packed;
     private move;
     private resetDrag;

package/dist/types/components/sui-panel/sui-panel.d.ts

@@ -19,7 +19,7 @@ export declare class SuiPanel {
      *  `aria-controls`. The body's height closes over the base duration, with the chevron, and the
      *  body unmounts once it has closed. Reflected. */
     collapsible: boolean;
-    /** 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. */
     collapsed: boolean;
     /** Ground of the header band: `brand` paints it on the brand fill under the inverse ink, for
      *  ledger groups and grouped sections; unset leaves the sunken surface header. The word the rails

package/dist/types/components/sui-pick-list/sui-pick-list.d.ts

@@ -36,7 +36,7 @@ export declare class SuiPickList {
      *  keyboard lift remain. Reflected. */
     dragOnly: boolean;
     /** `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. */
+     *  select-all header, and the transfer controls carry the whole checked set at once. Reflected. */
     selectionMode: SuiListSelectionMode;
     /** Shows a filter box over each pane. It narrows what a pane draws (by label, description and
      *  meta), never the `source` and `target` arrays. Transfers still run while a pane is filtered,

package/dist/types/components/sui-save-status/sui-save-status.d.ts

@@ -1,15 +1,20 @@
-export type SuiSaveState = 'saved' | 'saving' | 'dirty' | 'error';
+export type SuiSaveState = 'idle' | 'saved' | 'saving' | 'dirty' | 'error';
 /**
- * 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.
  */
 export declare class SuiSaveStatus {
-    /** Which line to show. */
+    /**
+     * 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.
+     */
     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".
+     * "Saved 2 min ago"; without it, "Saved just now". Read on the saved line only.
      */
     time?: string;
     private text;

package/dist/types/components/sui-select/sui-select.d.ts

@@ -11,7 +11,7 @@ export interface SuiSelectOption {
     /** What `value` holds, as given: a number stays a number through `value`, `suiChange` and a
      *  framework binding. The form posts its text. */
     value: SuiKey;
-    /** Greys the row out; the arrows step over it. */
+    /** Grays the row out; the arrows step over it. */
     disabled?: boolean;
     /** Font Awesome class drawn before the label, in the row and in the trigger. */
     icon?: string;
@@ -113,7 +113,7 @@ export declare class SuiSelect {
     variant: 'default' | 'quiet';
     /**
      * 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
+     * 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.
      */

package/dist/types/components/sui-select-button/sui-select-button.d.ts

@@ -10,7 +10,7 @@ export interface SuiSelectButtonOption {
     value: SuiKey;
     /** Font Awesome class drawn before the label. */
     icon?: string;
-    /** Keeps the segment in the track but greys it out; the keyboard skips it. */
+    /** Keeps the segment in the track but grays it out; the keyboard skips it. */
     disabled?: boolean;
     /** Makes the segment a real link, for a view switch that is also a route: a middle or a modified
      *  click opens it in a new tab, and a plain click still picks it and emits `suiChange`. A host

package/dist/types/components/sui-side-nav/sui-side-nav.d.ts

@@ -190,7 +190,7 @@ export declare class SuiSideNav {
     private openKeys;
     private holdsActive;
     /** Opens the group holding the active item, so a page that routes straight to a child never draws
-     *  a rail with no active row. The load and `sections` passes are initialisation and stay quiet;
+     *  a rail with no active row. The load and `sections` passes are initialization and stay quiet;
      *  a later `active` move reports through `suiExpandedChange`. */
     private openActiveGroup;
     private toggleGroup;

package/dist/types/components/sui-speed-dial/sui-speed-dial.d.ts

@@ -3,7 +3,7 @@ import { SuiCloseReason } from '../../utils/overlay.js';
 /** One satellite action. `label` is the accessible name and the hover capsule text. */
 export interface SuiSpeedDialItem {
     label: string;
-    /** Greys the satellite and blocks its press. */
+    /** Grays the satellite and blocks its press. */
     disabled?: boolean;
     /** Font Awesome class, e.g. "fa-regular fa-file-lines". */
     icon: string;
@@ -38,7 +38,7 @@ export declare class SuiSpeedDial {
      */
     iconOpen?: string;
     /** 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`. */
+     *  launcher. An unrecognized value falls back to `up`. */
     direction: 'up' | 'down' | 'left' | 'right';
     /**
      * Fanned out. Mutable: the launcher toggles it, and Escape, an outside pointer, Tabbing out and
@@ -75,7 +75,7 @@ export declare class SuiSpeedDial {
     private exit;
     private pendingFocus?;
     private get fanned();
-    /** The direction actually drawn: an unrecognised value falls back to the documented default. */
+    /** The direction actually drawn: an unrecognized value falls back to the documented default. */
     private get fanDirection();
     connectedCallback(): void;
     componentDidLoad(): void;

package/dist/types/components/sui-splitter/sui-splitter.d.ts

@@ -10,7 +10,7 @@ import { EventEmitter } from '../../stencil-public-runtime.js';
  */
 export declare class SuiSplitter {
     host: HTMLElement;
-    /** 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. */
     ratio: number;
     /** Smallest share either pane may shrink to. Values above 0.5 clamp to 0.5. With `collapsible`, a pane pushed past half of this snaps shut instead. */
     minRatio: number;

package/dist/types/components/sui-stat-card/sui-stat-card.d.ts

@@ -27,7 +27,7 @@ export declare class SuiStatCard {
      *  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
+     *  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. */
     severity: SuiTrendSeverity;

package/dist/types/components/sui-stepper/sui-stepper.d.ts

@@ -16,7 +16,7 @@ export declare class SuiStepper {
     host: HTMLElement;
     /** Steps in order (`{ label, description? }`). Property, not attribute. */
     steps: SuiStep[];
-    /** 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. */
     active: number;
     /** Rail direction. `vertical` stacks the steps with the body under the current one's label.
      *  Reflected, as on every other element that carries it. */

package/dist/types/components/sui-tab/sui-tab.d.ts

@@ -13,7 +13,7 @@ export declare class SuiTab {
     badge?: string | number;
     /** Font Awesome class drawn before the label, e.g. "fa-regular fa-user". */
     icon?: string;
-    /** Greys the tab and blocks activation. */
+    /** Grays the tab and blocks activation. */
     disabled: boolean;
     protected notifyParent(): void;
     render(): any;

package/dist/types/components/sui-tabs/sui-tabs.d.ts

@@ -9,7 +9,7 @@ import { EventEmitter } from '../../stencil-public-runtime.js';
  */
 export declare class SuiTabs {
     host: HTMLElement;
-    /** 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. */
     active: number;
     /** underline for in-page sections, pills for view switchers. */
     variant: 'underline' | 'pills';