@shineuix/core 1.0.0 → 1.0.1

package/dist/types/theme/apply.d.ts

@@ -27,7 +27,7 @@ export interface SuiThemeOptions {
     preset?: SuiThemePreset;
     /** Primary hex: buttons, bars and the app chrome. */
     primary?: string;
-    /** Accent hex: calls to action and the logo spark, and the focus colour when it suits the pair better than the primary. */
+    /** Accent hex: calls to action and the logo spark, and the focus color when it suits the pair better than the primary. */
     accent?: string;
     /** Neutral family for canvases, borders and inks. */
     neutral?: SuiThemeNeutral;

package/dist/types/theme/derive.d.ts

@@ -53,7 +53,7 @@ export declare function overGround(fg: string, bg: string, a: number): string;
  *  is the neutral tone fitted until it reads this much on the worst of them, the muted tier at 7:1,
  *  the faint at 5.4:1 (4.8:1 in light), and the placeholder, a field's own ink rather than a text
  *  tier, at 4.5:1. A ladder rather than one floor, because fitting all three to 4.5 collapsed them
- *  into one grey (the visual gate caught it, 2026-09-05). */
+ *  into one gray (the visual gate caught it, 2026-09-05). */
 export declare const INK_MUTED_AA = 7, INK_FAINT_AA = 5.4, INK_PLACEHOLDER_AA = 4.5;
 /** In light faint sits at 4.8:1, since a washed row lifts its faint text to the muted ink and faint
  *  no longer needs headroom for the wash (wash-ink-audit.mjs finds no faint text on a wash that does
@@ -84,21 +84,21 @@ export declare const INK_WARM_C = 0.012;
 export declare const BRAND_DARK_L = 0.48, BRAND_DARK_PRESENCE = 3;
 export declare const BRAND_HOVER_STEP = 0.05, BRAND_HOVER_STEP_MIN = 0.03;
 export declare const FOCUS_RING_PRESENCE = 3;
-/** The focus colour's floor on every page ground: 3:1 in light, 4.5:1 in dark, where a mid tone that
+/** The focus color's floor on every page ground: 3:1 in light, 4.5:1 in dark, where a mid tone that
  *  passes 3:1 still reads as dim beside the ink. */
 export declare const FOCUS_LIGHT = 3, FOCUS_DARK = 4.5;
 /** A disabled field's fill in light: the lightness of the default theme's #E3E6EA, so a generated
- *  theme's disabled field reads as a grey slab, as the shipped ones do, and not as the near-white
+ *  theme's disabled field reads as a gray slab, as the shipped ones do, and not as the near-white
  *  of a read-only one. */
 export declare const DISABLED_BG_L = 0.924;
 /** The error red's chroma floor: it follows a vivid pair up to 0.17 but never mutes below this, so a
- *  navy or grey accent cannot turn errors into brick. */
+ *  navy or gray accent cannot turn errors into brick. */
 export declare const ALERT_C_MIN = 0.15;
-/** The halo around a focused control: the focus colour's own hue as a pale tint in light (the ring
- *  at an alpha greys it, since the ring is usually dark), and the ring at 35% over the card in dark.
- *  A near-grey ring keeps a grey halo. */
+/** The halo around a focused control: the focus color's own hue as a pale tint in light (the ring
+ *  at an alpha grays it, since the ring is usually dark), and the ring at 35% over the card in dark.
+ *  A near-gray ring keeps a gray halo. */
 export declare function focusHalo(ring: string, surface: string, dark: boolean): string;
-/** How near the focus colour may come to danger's hue before it would read as an error. */
+/** How near the focus color may come to danger's hue before it would read as an error. */
 export declare const FOCUS_DANGER_HUE = 30;
 export declare const VIZ_4_L = 0.8, VIZ_4_L_DARK = 0.35, VIZ_4_PRESENCE = 1.5;
 /** The fourth chart step on a dark card: a fourth series is a line or a bar that has to stand out
@@ -111,7 +111,7 @@ export declare const VIZ_4_PRESENCE_DARK = 2.5;
  *  own lightness, --viz-4 at the axis floor, and the two between at the same ratio, (viz-1 /
  *  viz-4)^(1/3) on the card, about 1.48 in dark and 1.63 in light. */
 export declare const VIZ_1_L_DARK = 0.81;
-/** The colour at hue H and chroma C that reads `target` against `ground`, on the side of the ground
+/** The color at hue H and chroma C that reads `target` against `ground`, on the side of the ground
  *  the ramp runs (darker on a light card, lighter on a dark one). */
 export declare function vizAt(H: number, C: number, ground: string, target: number, lighter: boolean): string;
 /** The hover wash: the ink laid over the ground a hovered row or control sits on. `--surface-hover`
@@ -137,7 +137,7 @@ export declare const MEDIA_DARK_L = 0.13, MEDIA_DARK_C = 0.07;
 /** How near, in hue, a brand-mode accent may come to the error red before attention stops wearing it
  *  and takes the amber: at 25 degrees a coral accent's "due today" read as the red's "overdue". */
 export declare const ATTENTION_DANGER_HUE = 35;
-/** The selected row: the primary's hue (grey when the primary has none), translucent like the wash,
+/** The selected row: the primary's hue (gray when the primary has none), translucent like the wash,
  *  at the alpha that outweighs the wash by this much over the card, so a row under the pointer never
  *  outweighs the row the user picked. The source is a mid tone in light and a light one in dark,
  *  chromatic enough that the tint reads as the brand and not as a deeper hover. */
@@ -154,7 +154,7 @@ export declare const SELECTED_SRC_L_MAX = 0.8;
 /** Yellow to olive hues read brown or khaki in any tone darker than their own light one, so a primary
  *  in this band (mustard, gold, olive) takes the light source whatever its own lightness. */
 export declare const SELECTED_WARM_HUES: [number, number];
-/** The primary hues (orange through yellow to olive) whose selection is capped in colour, and the
+/** The primary hues (orange through yellow to olive) whose selection is capped in color, and the
  *  cap: the painted wash on the card at most this OKLCH chroma in light and in dark. */
 export declare const SELECTED_WARM_CAP_HUES: [number, number];
 export declare const SELECTED_WARM_C = 0.06, SELECTED_WARM_C_DARK = 0.02;
@@ -196,9 +196,9 @@ export declare function fitOn(fg: string, bg: string, target: number): string;
 export declare function inkFor(bg: string, candidates: string[], target?: number): string;
 export declare function rgbaOf(hex: string, a: number): string;
 export declare function hueDist(a: number, b: number): number;
-/** The OKLab distance between two colours: how different they look, hue and lightness together. */
+/** The OKLab distance between two colors: how different they look, hue and lightness together. */
 export declare function oklDist(a: string, b: string): number;
-/** A focus colour from one source: the source's own hue and chroma at the lightness nearest its own
+/** A focus color from one source: the source's own hue and chroma at the lightness nearest its own
  *  that clears `target` on every page ground and, when `fill` is given, FOCUS_RING_PRESENCE against
  *  it (in dark the ring sits one dark pixel off a primary-filled button). */
 export declare function focusFrom(hex: string, grounds: string[], fill: string | null, target: number): string;

package/dist/types/utils/aria.d.ts

@@ -22,6 +22,21 @@ export declare function inheritAriaState(host: HTMLElement, set: (state: Record<
  *  page (a list reorder, a framework's keyed move, a slot relocation) is disconnected and connected
  *  again; armed once in `componentWillLoad`, it would stop following its host after the move. */
 export declare function inheritAriaLabel(host: HTMLElement, set: (value: string | undefined) => void): () => void;
+/** Reads whether the host says `aria-disabled` and keeps `set` in sync when it changes.
+ *  Returns a disposer. A button that reads it is the focusable disabled button: the inner control
+ *  reads as disabled, takes the disabled look and swallows its activation, and stays in the tab
+ *  order, so a keyboard or screen reader user reaches it and the reason beside it. Left on the host
+ *  alone it would sit on an element with no button role and announce nothing, as `inheritAriaState`
+ *  says. Armed in `connectedCallback`, as `inheritAriaLabel` says.
+ *
+ *  Present and anything but `false` holds it: React writes a boolean `aria-disabled` on a custom
+ *  element as an empty attribute, and an author who wrote the attribute meant it. The inner control
+ *  always reads the valid `aria-disabled="true"`. */
+export declare function inheritAriaDisabled(host: HTMLElement, set: (value: boolean) => void): () => void;
+/** Reads the host's `aria-describedby` and keeps `set` in sync when it changes, for a button that
+ *  hands it to its inner control: the reason a held button gives sits beside it, named by id. The
+ *  inner control is in the same tree as the page, so the id resolves. Returns a disposer. */
+export declare function inheritAriaDescribedby(host: HTMLElement, set: (value: string | undefined) => void): () => void;
 /** Reads the host's `aria-labelledby` and keeps `set` in sync when it changes. Returns a disposer.
  *  Armed in `connectedCallback`, as `inheritAriaLabel` says. */
 export declare function inheritAriaLabelledby(host: HTMLElement, set: (value: string | undefined) => void): () => void;

package/dist/types/utils/calendar-grid.d.ts

@@ -1,6 +1,6 @@
 import { addDays } from './datetime.js';
 export { addDays };
-/** The same day of the month `n` months on, clamped to the month's length, so 31 January plus one is 28 or 29 February. */
+/** The same day of the month `n` months on, clamped to the month's length, so January 31 plus one is February 28 or 29. */
 export declare const addMonths: (d: Date, n: number) => Date;
 /** True when both dates name the same calendar day. */
 export declare const sameDay: (a: Date | null | undefined, b: Date | null | undefined) => boolean;
@@ -11,7 +11,7 @@ export declare const startOfWeek: (d: Date, firstDay: number) => Date;
 /** The seven days of the week that holds `d`, starting on `firstDay`. */
 export declare const weekOf: (d: Date, firstDay: number) => Date[];
 /**
- * The month grid as rows of seven days, starting on `firstDay`, with the days of the neighbouring
+ * The month grid as rows of seven days, starting on `firstDay`, with the days of the neighboring
  * months filling the first and last rows. `weeks` fixes the row count so every month is the same
  * height and the grid never jumps on navigation; `0` draws only as many rows as the month needs
  * (four, five or six). `m` is 0-based.
@@ -21,7 +21,7 @@ export declare function monthGrid(y: number, m: number, firstDay: number, weeks?
  * The weekday a locale starts its week on, `0` Sunday to `6` Saturday. Asks the runtime's
  * `Intl.Locale` week info where it has one, and otherwise reads the region off the tag against
  * the CLDR table (Sunday in the United States, Canada, Japan, Brazil and India; Saturday in
- * Egypt and the Gulf; Monday nearly everywhere else). A tag with no region is maximised to its
+ * Egypt and the Gulf; Monday nearly everywhere else). A tag with no region is maximized to its
  * likely one, so `en` starts on Sunday and `de` on Monday.
  */
 export declare function localeFirstDay(locale?: string): number;

package/dist/types/utils/chart-core.d.ts

@@ -188,7 +188,7 @@ export interface SuiLegendItem extends SuiChartKeyStyle {
 }
 /** The sentence over a plot with nothing to draw. Every chart renders it inside its own
  *  `.sui-chart-plot`, so the frame, the axes and the legend keep their place on the page. It takes
- *  the direction of its own first letter, so a right-to-left page keeps its full stop at its end. */
+ *  the direction of its own first letter, so a right-to-left page keeps its period at its end. */
 export declare const ChartEmpty: FunctionalComponent<{
     text: string;
 }>;

package/dist/types/utils/chart-helpers.d.ts

@@ -2,7 +2,7 @@
 export declare function minMax(values: ArrayLike<number>, seed?: [number, number]): [number, number];
 /** "x,y x,y ..." polyline points for a series through the given scales; one string build, no closures. */
 export declare function polyPoints(data: ArrayLike<number>, x: (i: number) => number, y: (v: number) => number): string;
-/** Same as polyPoints but walking the data backwards (closes an envelope or stack polygon). */
+/** Same as polyPoints but walking the data backward (closes an envelope or stack polygon). */
 export declare function polyPointsReversed(data: ArrayLike<number>, x: (i: number) => number, y: (v: number) => number): string;
 /** Legend toggle: returns a new hidden list with `label` added or removed. */
 export declare function toggleLabel(hidden: string[], label: string): string[];
@@ -11,5 +11,5 @@ export declare function hasSlot(host: HTMLElement, name: string): boolean;
 /** Accessible name for a chart: the heading, when there is one, before what the chart shows
  *  ("Cash balance: line chart of 2026, 2025"). `body` is already in the page's language. */
 export declare function chartLabel(heading: string | undefined, body: string): string;
-/** Normalises a hover index from nearestIndex: NaN (zero-width rect) or out of range collapses to -1. */
+/** Normalizes a hover index from nearestIndex: NaN (zero-width rect) or out of range collapses to -1. */
 export declare function safeIndex(i: number, n: number): number;

package/dist/types/utils/format.d.ts

@@ -3,12 +3,18 @@
  * and EUR, none for JPY), in `locale` or else the page's locale (`setLocale()`, else
  * `<html lang>`), which also places the symbol and sets the grouping. A negative takes
  * parentheses, the ledger convention, or with `negative: 'minus'` a true minus in front:
- * `(1.890,00 €)`, `−$1,890.00`. An unknown currency code prints the bare figure with two decimals.
+ * `(1.890,00 €)`, `−$1,890.00`. With `symbol: false` the amount drops its currency sign and keeps
+ * the currency's decimals and the locale's grouping, `1,234.50` and `(1,890.00)`: a statement's
+ * body rows, which leave the sign to the first row and the totals. An unknown currency code prints
+ * the bare figure with two decimals. A negative that rounds to nothing is zero, `0.00`, not
+ * `(0.00)`; a value that is not a finite number prints as `String()` prints it, `NaN`, as every
+ * formatter here does, so a bad figure shows rather than passing for an amount.
  */
 export declare function money(value: number, opts?: {
     currency?: string;
     locale?: string;
     negative?: 'parens' | 'minus';
+    symbol?: boolean;
 }): string;
 /**
  * Chart money in `currency` (ISO 4217, USD by default), in the page's locale: exact for a tooltip,

package/dist/types/utils/grid/clipboard.d.ts

@@ -5,7 +5,7 @@
  * `escape` is right for an export or a copy a stranger will open, and is what the grid's copy and
  * its CSV export write by default. `preserve` is right where the reader wants the formulas as
  * written, where the apostrophe would be the corruption (`copy-formulas` on the grid).
- * A copy pasted back into a grid needs neither: it reads the private flavour, `GRID_CLIPBOARD_TYPE`.
+ * A copy pasted back into a grid needs neither: it reads the private flavor, `GRID_CLIPBOARD_TYPE`.
  * `reject` is right for a system that would rather fail an export than emit something it cannot
  * vouch for. A boolean can express two of those and forces the third caller to reimplement the
  * check.
@@ -51,7 +51,7 @@ export interface SuiGridClipboardOptions {
  */
 export declare function serializeRange(cells: readonly (readonly string[])[], opts?: SuiGridClipboardOptions): string;
 /**
- * The private clipboard flavour a grid's copy carries beside `text/plain`: the same rectangle as
+ * The private clipboard flavor a grid's copy carries beside `text/plain`: the same rectangle as
  * TSV with every cell exactly as it is, formulas unescaped. A ShineUI grid reads it on paste, so a
  * copy and paste between grids is lossless, while a spreadsheet, which knows nothing of the type,
  * reads the plain text and its escapes.
@@ -59,22 +59,22 @@ export declare function serializeRange(cells: readonly (readonly string[])[], op
 export declare const GRID_CLIPBOARD_TYPE = "application/x-shineui-grid";
 /** What `writeGridClipboard` did: the plain text it wrote, or tried to, and whether it landed. */
 export interface GridClipboardWrite {
-    /** The `text/plain` flavour: the rectangle as TSV under the formula policy. */
+    /** The `text/plain` flavor: the rectangle as TSV under the formula policy. */
     text: string;
     /** True when the clipboard took it. */
     ok: boolean;
 }
 /**
- * Puts a rectangle on the clipboard as two flavours: `text/plain` under `formulas`, which is what a
+ * Puts a rectangle on the clipboard as two flavors: `text/plain` under `formulas`, which is what a
  * spreadsheet and every other application reads, and `GRID_CLIPBOARD_TYPE` with the cells exactly.
- * Where the engine refuses the two-flavour write, the plain text goes through `copyText` alone, and
+ * Where the engine refuses the two-flavor write, the plain text goes through `copyText` alone, and
  * the rectangle is remembered for `gridPasteText`. Resolves the plain text and whether the clipboard
- * took it. Call it from the user's gesture: the two-flavour write happens before the first `await`.
+ * took it. Call it from the user's gesture: the two-flavor write happens before the first `await`.
  * `within` is the element the copy belongs to (see `throwawaySelection`).
  */
 export declare function writeGridClipboard(cells: readonly (readonly string[])[], formulas?: Exclude<SuiGridFormulaPolicy, 'reject'>, within?: Element | null): Promise<GridClipboardWrite>;
 /**
- * The text a paste into a grid reads: the private flavour when the clipboard carries one, else the
+ * The text a paste into a grid reads: the private flavor when the clipboard carries one, else the
  * plain text, swapped for the exact cells when it is the very text the last copy on this page wrote
  * (so the escape a spreadsheet needed does not land in the grid as an apostrophe). Plain text from
  * anywhere else is taken as it is, apostrophes included, because they may be real data.

package/dist/types/utils/grid/columns.d.ts

@@ -118,7 +118,7 @@ export declare function columnWindow(model: SuiGridColumnModel, scrollStart: num
  *
  * Written out in full rather than as a diff, because `resolveColumns` reads the order as a ranking
  * and a partial list leaves every unmentioned column behind the named ones. `all` is the current
- * resolved order, so dropping a column onto a neighbour moves it exactly one place rather than to
+ * resolved order, so dropping a column onto a neighbor moves it exactly one place rather than to
  * wherever it happens to sit in the declaration.
  */
 export declare function reorderColumns(all: readonly string[], from: string, onto: string): string[];

package/dist/types/utils/grid/editing.d.ts

@@ -44,7 +44,7 @@ export interface SuiGridDateEditorOptions {
  */
 export declare function dateEditor(opts?: SuiGridDateEditorOptions): SuiGridEditor;
 export interface SuiGridCheckboxEditorOptions {
-    /** Text committed when the box is ticked. Default `'true'`. */
+    /** Text committed when the box is checked. Default `'true'`. */
     checked?: string;
     /** Text committed when it is not. Default `'false'`. */
     unchecked?: string;

package/dist/types/utils/grid/filter.d.ts

@@ -115,12 +115,12 @@ export interface SuiGridFilterDraftCondition {
 export interface SuiGridFilterDraft {
     operator: 'and' | 'or';
     conditions: SuiGridFilterDraftCondition[];
-    /** The ticked values of a value-list column. */
+    /** The checked values of a value-list column. */
     values?: string[];
 }
 /**
  * The draft a filter menu opens on, read from the column's applied rule. A value-list column opens
- * with every value ticked when it has no rule, since that is what "not filtered" looks like in a
+ * with every value checked when it has no rule, since that is what "not filtered" looks like in a
  * list; any other column opens on one empty condition in its default mode.
  */
 export declare function filterDraft(rule: SuiGridFilterRule | undefined, column: SuiGridColumn): SuiGridFilterDraft;
@@ -129,7 +129,7 @@ export declare function blankCondition(column: SuiGridColumn): SuiGridFilterDraf
 /**
  * The rule a draft applies, or `undefined` when it filters nothing: a condition with no value is
  * dropped rather than kept to match nothing, the same reasoning as `setColumnRule`; a value list
- * with every value ticked is no filter at all. A value list with nothing ticked is not a rule the
+ * with every value checked is no filter at all. A value list with nothing checked is not a rule the
  * menu can apply (it would hide every row), so the menu disables Apply for it and this returns
  * `undefined` if asked anyway.
  */

package/dist/types/utils/grid/selection.d.ts

@@ -15,7 +15,7 @@ export interface SuiGridExcludeSelection {
  * `exclude` is not a convenience. It is the only honest way to express select-all over a dataset
  * whose total the client does not hold: a server-backed grid matching four million rows cannot
  * enumerate them, and an `allSelected` boolean beside a key set falls apart the moment the user
- * unticks three of them. "Everything except these three" survives that, survives paging, and is
+ * unchecks three of them. "Everything except these three" survives that, survives paging, and is
  * what a bulk action posts to a server as a predicate rather than as a list.
  */
 export type SuiGridRowSelection = SuiGridIncludeSelection | SuiGridExcludeSelection;
@@ -29,7 +29,7 @@ export declare function isRowSelected(sel: SuiGridRowSelection, key: SuiKey): bo
  * Sets a run of rows to one state.
  *
  * This is the primitive rather than `toggleRow`, because a Shift+click over a run has to *set* the
- * run, not flip it: flipping a range where half the rows were already ticked deselects that half,
+ * run, not flip it: flipping a range where half the rows were already checked deselects that half,
  * which is not what any grid does. Returns the selection unchanged when no membership moved.
  */
 export declare function setRowsSelected(sel: SuiGridRowSelection, keys: Iterable<SuiKey>, selected: boolean): SuiGridRowSelection;

package/dist/types/utils/grid/sort.d.ts

@@ -7,13 +7,15 @@ export declare function columnValue(row: SuiGridRow, column: SuiGridColumn): unk
  *  slightly different ways is how a copied column stops matching the column it was copied from. A
  *  cell shows `columnDisplay`, which differs only for a plain figure. */
 export declare function columnText(column: SuiGridColumn, row: SuiGridRow): string;
-/** What a cell without its own `render` shows: the column's `format`, or for a number column
- *  holding a plain figure that figure grouped and marked in the page's locale ("1,234.5" in
- *  English, "1.234,5" in German), or `columnText`'s text. The clipboard, an export, an editor and
+/** What a cell without its own `render` shows: the column's `format`; for a money column holding a
+ *  plain figure the amount ("1,234.50", "(1,890.00)"); for a number column that figure grouped and
+ *  marked in the page's locale ("1,234.5" in English, "1.234,5" in German); or `columnText`'s text. The clipboard, an export, an editor and
  *  an edit event keep the plain figure `columnText` gives, so a host parses one form on every
  *  page. */
 export declare function columnDisplay(column: SuiGridColumn, row: SuiGridRow): string;
-/** `columnDisplay` for a value already read, such as the one a group header names. */
+/** `columnDisplay` for a value already read, such as the one a group header names. A money column
+ *  shows an amount, `money()` with no symbol: two decimals, the locale's grouping and a negative in
+ *  parentheses, `1,234.50` and `(1,890.00)`, as a statement's body rows read. */
 export declare function valueDisplay(column: SuiGridColumn, raw: unknown, row: SuiGridRow): string;
 /**
  * The comparable projection of one value, or `null` when the value is empty *for its type*.

package/dist/types/utils/grid/tree.d.ts

@@ -60,14 +60,14 @@ export interface SuiGridTreeSelection {
 /**
  * Fills in what the ticks imply.
  *
- * A caller stores the keys a person actually ticked; everything else follows from the shape of the
+ * A caller stores the keys a person actually checked; everything else follows from the shape of the
  * tree, and recomputing it is cheaper and safer than storing it. A branch is selected when every
  * child is, partial when some are, and neither otherwise, all the way up. A leaf is whatever the
- * ticked set says.
+ * checked set says.
  */
 export declare function resolveTreeSelection(nodes: readonly SuiGridTreeNode[] | undefined, checked: ReadonlySet<SuiKey>): SuiGridTreeSelection;
 /**
- * Ticks or clears one node and everything under it.
+ * Checks or clears one node and everything under it.
  *
  * Only descendants are written. Ancestors are not stored at all: `resolveTreeSelection` derives
  * them, so there is no second copy of the answer to go stale when the tree changes shape under a

package/dist/types/utils/grid/types.d.ts

@@ -4,7 +4,7 @@ import { SuiKey } from '../key.js';
 export type SuiGridRow = Record<string, unknown>;
 export type SuiGridSortDir = 'asc' | 'desc';
 /** How a column's values are compared, formatted and filtered when the column does not say
- *  otherwise. `text` is the fallback for anything unrecognised. */
+ *  otherwise. `text` is the fallback for anything unrecognized. */
 export type SuiGridValueType = 'text' | 'number' | 'date' | 'boolean';
 /** Cell text alignment. A side named here is a side of the screen in either reading direction.
  *  Left unset, a money or number column sits at the inline end and everything else at the inline
@@ -43,8 +43,12 @@ export interface SuiGridColumn {
     /** A side of the screen to align to, in either reading direction. Leave it unset for reading
      *  order: text at the inline start, numbers and money at the inline end. */
     align?: SuiGridAlign;
-    /** Aligned to the inline end, tabular numerals, weight 640. Implies `type: 'number'` for
-     *  comparison unless the column says otherwise, because a money column holds an amount. */
+    /** Aligned to the inline end, tabular numerals, weight 640, and a figure shown as an amount:
+     *  two decimals, no currency sign and a negative in parentheses (`1,234.50`, `(1,890.00)`), the
+     *  body rows of a statement. The sign belongs on the totals (`footerTotals`, a group summary),
+     *  which a sort leaves in place; `format: (v) => money(v)` puts it on every row. Implies
+     *  `type: 'number'` for comparison unless the column says otherwise, because a money column
+     *  holds an amount. */
     money?: boolean;
     /** One line, clipped with an ellipsis, and the full value on the cell's `title`. */
     nowrap?: boolean;
@@ -65,9 +69,10 @@ export interface SuiGridColumn {
     /** Custom comparator; overrides `type`. Return negative, zero or positive. */
     compare?: (a: unknown, b: unknown) => number;
     /** Formats the value for text: the cell when there is no `render`, the export, and the clipboard.
-     *  Keep it cheap; it runs once per visible cell per render. Without it a number or money column
-     *  shows a plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`), while
-     *  the export, the clipboard and an edit keep the plain figure (`1234.5`). */
+     *  Keep it cheap; it runs once per visible cell per render. Without it a number column shows a
+     *  plain figure grouped and marked in the page's locale (`1,234.5`, `1.234,5`) and a money column
+     *  an amount (`1,234.50`, `1.234,50`), while the export, the clipboard and an edit keep the
+     *  plain figure (`1234.5`). */
     format?: (value: unknown, row: SuiGridRow) => string;
     /** Drawn in `--ink-muted`: a memo, an account type, anything secondary. */
     muted?: boolean;
@@ -196,8 +201,8 @@ export interface SuiGridMetrics {
     viewport: number;
     /** Distance scrolled past the top of the rows region. */
     scrollTop: number;
-    /** Rows kept mounted beyond each edge. Never zero: overscan is not an optimisation but the only
-     *  defence against the compositor moving the layer before the main thread has re-rendered. */
+    /** Rows kept mounted beyond each edge. Never zero: overscan is not an optimization but the only
+     *  defense against the compositor moving the layer before the main thread has re-rendered. */
     overscan: number;
     /** Signed pixels per second, positive downward. The window leans into the direction of travel. */
     velocity?: number;

package/dist/types/utils/held-focus.d.ts

@@ -2,7 +2,7 @@
 export interface SuiHeldFocusOptions {
     /** The elements whose focus is followed: the element, or the part of it that draws the focus,
      *  and any part it keeps outside itself. A function, because a component's parts are not there
-     *  yet while its fields initialise. */
+     *  yet while its fields initialize. */
     parts: () => (Element | null | undefined)[];
     /** Focus came in from outside every part and every panel they hold. */
     enter?: () => void;

package/dist/types/utils/motion.d.ts

@@ -11,7 +11,7 @@ export declare function reducedMotion(): boolean;
  *  is moving content a reader cannot stop and is what WCAG 2.2.2 is about. An element moved in the
  *  page subscribes again in `connectedCallback`, after disposing the last subscription. */
 export declare function onReducedMotionChange(fn: (reduced: boolean) => void): () => void;
-/** The scroll behaviour a scripted scroll may use: `smooth` unless the reader asked for less
+/** The scroll behavior a scripted scroll may use: `smooth` unless the reader asked for less
  *  motion, in which case the page jumps. Every `scrollTo` and `scrollIntoView` in the library
  *  reads it, so the token sheet's reduce block and the scripted scrolls answer the same query. */
 export declare function scrollBehavior(): ScrollBehavior;

package/dist/types/utils/overlay.d.ts

@@ -67,7 +67,7 @@ export declare function heldPopupContains(container: Element, node: Node): boole
  * opened inside a dialog takes it and the dialog stays, whichever of the two registered first;
  * an Escape something inside already handled (`defaultPrevented`, the way a select's trigger
  * marks it) is left alone, and a consumed one is marked handled the same way. The modal stack
- * and the document-level popups (popover, confirm popup, notification centre) arm through this.
+ * and the document-level popups (popover, confirm popup, notification center) arm through this.
  */
 export declare function onDocumentEscape(onEscape: () => void): () => void;
 /** An Escape handler a surface holds while it is open. See `escapeWhileOpen`. */
@@ -116,7 +116,7 @@ export declare function tabOutOfOverlay(e: KeyboardEvent, panel: HTMLElement | u
 export declare function matchWidth(anchor: HTMLElement, overlay: HTMLElement, min?: number): void;
 /** The leaving state of one surface. See `overlayExit`. */
 export interface SuiOverlayExit {
-    /** True from `begin` until the exit ends or is cancelled. */
+    /** True from `begin` until the exit ends or is canceled. */
     readonly active: boolean;
     /**
      * Starts the exit of `surface`: the element keeps rendering it with its `closing` class, whose

package/dist/types/utils/popup-surface.d.ts

@@ -1,7 +1,7 @@
 /** What `popupSurface` asks of the element that renders the surface. */
 export interface SuiPopupSurfaceOptions {
     /** The element whose render holds the surface. A function, because a component's host is not
-     *  there yet while its fields initialise. */
+     *  there yet while its fields initialize. */
     host: () => HTMLElement;
     /** Places the surface against its anchor. Runs once the surface is in the top layer, and on every
      *  scroll and resize while it is open. */

package/dist/types/utils/shiki-theme.d.ts

@@ -3,12 +3,12 @@ export declare const SHINEUI_SHIKI_THEME: ThemeRegistrationRaw;
 export declare const SHIKI_TOKEN_VARS: Record<string, string>;
 /**
  * The classes `sui-code-block` paints one token with: `t-key`, `t-str` and the rest, one per
- * colour of the family (named after its `--sui-code-*` token), plus `t-i`, `t-b`, `t-u` or `t-s` for
+ * color of the family (named after its `--sui-code-*` token), plus `t-i`, `t-b`, `t-u` or `t-s` for
  * the font style. Classes rather than a `style` attribute, because a page whose Content Security
  * Policy has no `'unsafe-inline'` for styles refuses every style attribute, and the block would
- * lose its colours there. A colour outside the family gets no class and takes the pane's ink.
+ * lose its colors there. A color outside the family gets no class and takes the pane's ink.
  */
 export declare function tokenClasses(color: string | undefined, fontStyle: number | undefined): string;
-/** Shiki's HTML with each family colour rewritten as its token, for the docs site's own code
+/** Shiki's HTML with each family color rewritten as its token, for the docs site's own code
  *  samples. `sui-code-block` renders Shiki's tokens as elements instead (`highlightTokens`). */
 export declare function tokenizeShikiHtml(html: string): string;

package/dist/types/utils/shiki.d.ts

@@ -16,7 +16,7 @@ export interface SuiCodeToken {
 }
 /**
  * Highlights `code` and resolves to its lines, each a list of tokens. The caller renders them as
- * text inside elements, so nothing reaches an HTML sink and no colour needs a `style` attribute.
+ * text inside elements, so nothing reaches an HTML sink and no color needs a `style` attribute.
  * Rejects when the engine or grammar cannot load; callers keep their plain-text fallback then.
  */
 export declare function highlightTokens(code: string, lang: SuiCodeLang, theme: ThemeRegistrationRaw): Promise<SuiCodeToken[][]>;

package/dist/types/utils/trusted-types.d.ts

@@ -9,7 +9,7 @@ export declare const TRUSTED_TYPES_POLICY = "shineui";
  * The policy adds no checking of its own, so it is called in two places only, each of which is
  * safe without it: `sanitizeEditorHtml`'s parse into a `DOMParser` document, which is never
  * attached, where no script runs and nothing loads (the pattern DOMPurify and ProseMirror's own
- * clipboard policy use), and `sui-edit-box` painting markup that sanitiser has already reduced to
+ * clipboard policy use), and `sui-edit-box` painting markup that sanitizer has already reduced to
  * its allowlist. Nothing a consumer passes reaches it any other way.
  *
  * The return type says `string` because that is what the DOM typings accept at both sinks; at run