@slotted/react 0.1.0-beta.7 → 0.1.0-beta.9

package/dist/docs/code-block.md

@@ -44,45 +44,45 @@ Excerpt — not a complete module
 
 | Name | Type | Default | Applies to | Description |
 | --- | --- | --- | --- | --- |
-| `code` | `string` | — | CodeBlock | A fonte, como texto. Nunca HTML |
-| `language` | `string` | text | CodeBlock | data-language e class="language-<x>" |
-| `highlight` | `CodeHighlighter \| null` | — | CodeBlock | O motor; null recusa o do provider |
-| `tokens` | `CodeLine[]` | — | CodeBlock | Linhas já tokenizadas pelo consumidor |
-| `title` | `ReactNode` | — | CodeBlock | O nome do ficheiro no cabeçalho, e o nome da região |
-| `fileName` | `string` | — | CodeBlock | O nome para o glifo, quando title não é uma string |
-| `lineNumbers` | `boolean` | false | CodeBlock | O contador na goteira |
-| `start` | `number` | 1 | CodeBlock | O número da primeira linha |
-| `marks` | `CodeMarks` | — | CodeBlock | highlight, add, remove, focus, error, warning — intervalos "1,4-6" ou listas |
-| `wrap` | `boolean` | — | CodeBlock | Presente é controlado |
-| `defaultWrap` | `boolean` | false | CodeBlock | Onde começa, lido uma vez |
-| `collapseAfter` | `number` | — | CodeBlock | Linhas visíveis antes do controle de revelar |
-| `revealed` | `boolean` | — | CodeBlock | Presente é controlado |
-| `defaultRevealed` | `boolean` | false | CodeBlock | Onde começa, lido uma vez |
-| `maxLines` | `number` | — | CodeBlock | Linhas antes de o corpo rolar |
-| `copy` | `boolean` | true | CodeBlock | O controle de cópia |
-| `copyRemoved` | `boolean` | false | CodeBlock | Mantém as linhas removidas na cópia |
-| `loading` | `boolean` | false | CodeBlock | Skeletons na altura de seis linhas, aria-busy, sem cópia |
-| `tabSize` | `number` | 2 | CodeBlock | Largura de um tab, para o indent da continuação |
-| `messages` | `PartialMessages<CodeBlockMessages>` | — | CodeBlock | As palavras da família sobre o idioma em vigor, chave a chave |
-| `renderLine` | `(props) => ReactNode` | — | CodeBlock | Substitui a corrida de tokens de uma linha |
-| `renderToken` | `(token, index, line) => ReactNode` | — | CodeBlock | Substitui um token |
-| `actions` | `ReactNode` | — | CodeBlock | Controles do consumidor ao lado de copy e wrap |
-| `preProps` | `ComponentProps<'pre'>` | — | CodeBlock | Chegam ao pre |
+| `code` | `string` | — | CodeBlock | The source, as text. Never HTML |
+| `language` | `string` | text | CodeBlock | data-language and class="language-<x>" |
+| `highlight` | `CodeHighlighter \| null` | — | CodeBlock | The engine; null refuses the provider’s |
+| `tokens` | `CodeLine[]` | — | CodeBlock | Lines the consumer already tokenized |
+| `title` | `ReactNode` | — | CodeBlock | The file name in the header, and the region name |
+| `fileName` | `string` | — | CodeBlock | The name for the glyph, when title is not a string |
+| `lineNumbers` | `boolean` | false | CodeBlock | The counter in the gutter |
+| `start` | `number` | 1 | CodeBlock | The number of the first line |
+| `marks` | `CodeMarks` | — | CodeBlock | highlight, add, remove, focus, error, warning — ranges "1,4-6" or lists |
+| `wrap` | `boolean` | — | CodeBlock | Present means controlled |
+| `defaultWrap` | `boolean` | false | CodeBlock | Where it starts, read once |
+| `collapseAfter` | `number` | — | CodeBlock | Visible lines before the reveal control |
+| `revealed` | `boolean` | — | CodeBlock | Present means controlled |
+| `defaultRevealed` | `boolean` | false | CodeBlock | Where it starts, read once |
+| `maxLines` | `number` | — | CodeBlock | Lines before the body scrolls |
+| `copy` | `boolean` | true | CodeBlock | The copy control |
+| `copyRemoved` | `boolean` | false | CodeBlock | Keeps the removed lines in the copy |
+| `loading` | `boolean` | false | CodeBlock | Skeletons at the height of six lines, aria-busy, no copy |
+| `tabSize` | `number` | 2 | CodeBlock | Width of a tab, for the continuation indent |
+| `messages` | `PartialMessages<CodeBlockMessages>` | — | CodeBlock | The family’s words over the current locale, key by key |
+| `renderLine` | `(props) => ReactNode` | — | CodeBlock | Replaces the token run of one line |
+| `renderToken` | `(token, index, line) => ReactNode` | — | CodeBlock | Replaces one token |
+| `actions` | `ReactNode` | — | CodeBlock | Consumer controls next to copy and wrap |
+| `preProps` | `ComponentProps<'pre'>` | — | CodeBlock | Reach the pre |
 | `ref` | `Ref<CodeBlockHandle>` | — | CodeBlock | copy(), scrollToLine(n), root |
-| `renderLine, renderToken` | `funções` | — | CodeBlock | A linha ou o token à maneira da aplicação; a goteira fica da família |
-| `actions` | `ReactNode` | — | CodeBlock | Um "Run" ou um "Open in editor" ao lado dos controles |
-| `CodeBlockDefaultsProvider` | `highlight \| lineNumbers \| copy` | — | Aplicação | O motor carregado uma vez, para todos os blocos por baixo; uma prop no bloco ganha |
-| `Tabs` | `composição` | — | em volta | Vários ficheiros: um CodeBlock por Tabs.Panel |
-| `onKeyDown, id, aria-*, data-*` | `props nativas` | — | CodeBlock | Chegam à raiz; o handler do consumidor corre antes |
+| `renderLine, renderToken` | `functions` | — | CodeBlock | The line or the token the application’s way; the gutter stays the family’s |
+| `actions` | `ReactNode` | — | CodeBlock | A "Run" or an "Open in editor" next to the controls |
+| `CodeBlockDefaultsProvider` | `highlight \| lineNumbers \| copy` | — | Application | The engine loaded once, for every block below; a prop on the block wins |
+| `Tabs` | `composition` | — | around | Several files: one CodeBlock per Tabs.Panel |
+| `onKeyDown, id, aria-*, data-*` | `native props` | — | CodeBlock | Reach the root; the consumer’s handler runs first |
 
 ## Events
 
 | Name | Payload | When |
 | --- | --- | --- |
-| `onWrapChange` | `(wrap: boolean, request)` | Antes de as linhas quebrarem ou desquebrarem: pointer, keyboard ou programmatic; cancelar não move nada. |
-| `onRevealedChange` | `(revealed: boolean, request)` | Antes de o bloco revelar ou dobrar as linhas escondidas: pointer, keyboard, escape ou programmatic. |
-| `onCopy` | `({ value, copied, reason, source })` | Depois de o controle, ou o handle, escrever na área de transferência. copied é false quando a plataforma recusou. |
-| `onHighlightError` | `(error: unknown)` | Quando o motor rejeita. O texto puro fica. |
+| `onWrapChange` | `(wrap: boolean, request)` | Before the lines wrap or unwrap: pointer, keyboard or programmatic; cancelling moves nothing. |
+| `onRevealedChange` | `(revealed: boolean, request)` | Before the block reveals or folds the hidden lines: pointer, keyboard, escape or programmatic. |
+| `onCopy` | `({ value, copied, reason, source })` | After the control, or the handle, writes to the clipboard. copied is false when the platform refused. |
+| `onHighlightError` | `(error: unknown)` | When the engine rejects. The plain text stays. |
 
 ## Axes and defaults
 
@@ -94,11 +94,11 @@ Excerpt — not a complete module
 
 ## Rules
 
-- O bloco não tem papel: é texto, lido como texto. O role="textbox" com aria-readonly do Carbon num bloco que ninguém edita é recusado por escrito no contrato.
-- O corpo é um scroll-area: role="region", tabindex="0" e um nome — o título, depois aria-label, depois "Code" — só enquanto o código transborda, que é o que SC 2.1.1 e scrollable-region-focusable pedem. As teclas de rolar são as da plataforma; a família não escreve nenhuma.
-- A goteira dos números e dos sinais é aria-hidden e user-select: none: um leitor de ecrã ouve o código e não uma contagem, e uma seleção pelo bloco copia código e nada mais.
-- O controle de cópia anuncia "Copied" ou "Copy failed" pelo live-announcer partilhado e troca o glifo além da cor; o de wrap é aria-pressed; o de revelar leva aria-expanded e aria-controls para o corpo.
-- Um HTML de motor nunca entra: os tokens são texto em spans, e um <script> numa amostra são os seis caracteres que é.
+- The block has no role: it is text, read as text. Carbon’s role="textbox" with aria-readonly on a block nobody edits is refused in writing in the contract.
+- The body is a scroll-area: role="region", tabindex="0" and a name — the title, then aria-label, then "Code" — only while the code overflows, which is what SC 2.1.1 and scrollable-region-focusable ask for. The scroll keys are the platform’s; the family writes none.
+- The gutter of numbers and signs is aria-hidden and user-select: none: a screen reader hears the code and not a count, and a selection across the block copies code and nothing else.
+- The copy control announces "Copied" or "Copy failed" through the shared live-announcer and swaps the glyph as well as the color; the wrap control is aria-pressed; the reveal control carries aria-expanded and aria-controls pointing to the body.
+- Engine HTML never enters: the tokens are text in spans, and a <script> in a sample is the six characters it is.
 
 ## Tokens
 
@@ -106,9 +106,9 @@ Excerpt — not a complete module
 
 ## Examples
 
-### Texto primeiro, tokens quando chegam
+### Text first, tokens when they arrive
 
-O bloco desenha o texto puro no primeiro paint e troca os tokens linha a linha quando o motor responde: a altura não muda, porque cada linha é uma fila da grelha. As cores são a escala --slotted-code-* do tema, e mudam com o esquema.
+The block draws the plain text on the first paint and swaps in the tokens line by line when the engine answers: the height does not change, because each line is a row of the grid. The colors are the theme’s --slotted-code-* scale, and change with the scheme.
 
 Excerpt — not a complete module
 
@@ -120,9 +120,9 @@ Excerpt — not a complete module
 />;
 ```
 
-### Prism e Shiki entram pelos mapeamentos
+### Prism and Shiki come in through the mappings
 
-A família não carrega gramática nenhuma. fromPrismTokens dobra os nomes padrão do Prism sobre os doze escopos; fromShikiTokens lê o último escopo TextMate de cada token. Um HTML de motor nunca entra: o que chega é texto em spans.
+The family loads no grammar. fromPrismTokens folds the standard Prism names onto the twelve scopes; fromShikiTokens reads the last TextMate scope of each token. Engine HTML never enters: what arrives is text in spans.
 
 Excerpt — not a complete module
 
@@ -134,9 +134,9 @@ const shiki = async (code, lang) =>
   );
 ```
 
-### Números de linha
+### Line numbers
 
-lineNumbers desenha um contador numa goteira larga o bastante para o último número, medida em ch; start diz por onde começa. A goteira é aria-hidden e user-select: none, por isso uma seleção pelo bloco copia código e nada mais.
+lineNumbers draws a counter in a gutter wide enough for the last number, measured in ch; start says where it begins. The gutter is aria-hidden and user-select: none, so a selection across the block copies code and nothing else.
 
 Excerpt — not a complete module
 
@@ -144,9 +144,9 @@ Excerpt — not a complete module
 <CodeBlock code={source} language="ts" lineNumbers start={98} />;
 ```
 
-### Linhas marcadas
+### Marked lines
 
-marks toma intervalos "1,4-6" ou listas de números: highlight tinge com o acento e uma barra na ponta; error e warning com danger e warning. A tinta é do texto do tom a 7,5%, para nenhum escopo cair abaixo de 4,5:1.
+marks takes ranges "1,4-6" or lists of numbers: highlight tints with the accent and a bar at the edge; error and warning with danger and warning. The tint is the tone’s text color at 7.5%, so no scope falls below 4.5:1.
 
 Excerpt — not a complete module
 
@@ -154,9 +154,9 @@ Excerpt — not a complete module
 <CodeBlock code={source} language="sh" marks={{ error: '3', highlight: '1', warning: [4] }} />;
 ```
 
-### Um diff
+### A diff
 
-add e remove tingem com success e danger e escrevem + e − na goteira, por CSS. O controle de cópia deixa as linhas removidas de fora, porque o código depois da mudança é o que se cola; copyRemoved mantém-nas.
+add and remove tint with success and danger and write + and − in the gutter, by CSS. The copy control leaves the removed lines out, because the code after the change is what gets pasted; copyRemoved keeps them.
 
 Excerpt — not a complete module
 
@@ -164,9 +164,9 @@ Excerpt — not a complete module
 <CodeBlock code={source} language="css" lineNumbers marks={{ add: '4-6', remove: '2-3' }} />;
 ```
 
-### Foco numa parte do bloco
+### Focus on one part of the block
 
-focus esmaece e desfoca as linhas fora do intervalo; o bloco levanta o véu com o ponteiro em cima ou o foco dentro, por isso quem quer o resto tem-no. Sob reduced-motion o desfoque sai e o esmaecer fica, porque é a informação.
+focus dims and blurs the lines outside the range; the block lifts the veil with the pointer over it or focus inside, so whoever wants the rest gets it. Under reduced-motion the blur goes and the dimming stays, because the dimming is the information.
 
 Excerpt — not a complete module
 
@@ -174,9 +174,9 @@ Excerpt — not a complete module
 <CodeBlock code={source} language="json" marks={{ focus: '3-6' }} />;
 ```
 
-### Quebrar linhas longas
+### Wrapping long lines
 
-O controle de wrap só aparece enquanto uma linha transborda — a regra do Docusaurus — e é um botão pressionado. A continuação de uma linha quebrada indenta-se ao próprio indent do código, medido uma vez por linha em ch.
+The wrap control appears only while a line overflows — the Docusaurus rule — and is a pressed button. The continuation of a wrapped line indents to the code’s own indent, measured once per line in ch.
 
 Excerpt — not a complete module
 
@@ -189,9 +189,9 @@ Excerpt — not a complete module
 />;
 ```
 
-### Um ficheiro com nome
+### A named file
 
-title põe o cabeçalho com o nome em mono, o glifo da espécie do ficheiro — uma folha de texto para um .ts, uma folha de tabela para um .csv — e a linguagem no fim. O título é também o nome da região de rolagem.
+title puts up the header with the name in mono, the glyph of the file kind — a text sheet for a .ts, a table sheet for a .csv — and the language at the end. The title is also the name of the scroll region.
 
 Excerpt — not a complete module
 
@@ -199,9 +199,9 @@ Excerpt — not a complete module
 <CodeBlock code={rows} language="csv" title="orders-2026-09.csv" />;
 ```
 
-### Dobrado atrás de "Show more"
+### Folded behind "Show more"
 
-collapseAfter esconde o que passa de n linhas atrás de um controle; a última linha visível desvanece-se nele. revealed é o modelo de estado; Escape dentro do bloco revelado dobra-o e mantém o foco. As linhas escondidas ficam no DOM e numa seleção.
+collapseAfter hides what goes past n lines behind a control; the last visible line fades into it. revealed is the state model; Escape inside the revealed block folds it and keeps focus. The hidden lines stay in the DOM and in a selection.
 
 Excerpt — not a complete module
 
@@ -214,9 +214,9 @@ Excerpt — not a complete module
 />;
 ```
 
-### Rolar além de um máximo
+### Scrolling past a maximum
 
-maxLines limita a altura do corpo e o scroll-area rola o resto, com a região nomeada e alcançável por Tab. Compõe com collapseAfter: um bloco dobrado a oito e, revelado, rolando além de quarenta.
+maxLines limits the body height and the scroll-area scrolls the rest, with the region named and reachable by Tab. It composes with collapseAfter: a block folded at eight and, revealed, scrolling past forty.
 
 Excerpt — not a complete module
 
@@ -224,19 +224,19 @@ Excerpt — not a complete module
 <CodeBlock code={log} language="text" lineNumbers maxLines={12} />;
 ```
 
-### Copiar
+### Copying
 
-O controle escreve o código que o consumidor deu, nunca o texto do DOM: nem números, nem sinais, nem quebras. Terminado, o check fica dois segundos no lugar das folhas e "Copied" é anunciado; copy={false} tira o controle; o handle copia sem ele.
+The control writes the code the consumer gave, never the DOM text: no numbers, no signs, no wraps. When done, the check stays two seconds in place of the sheets and "Copied" is announced; copy={false} removes the control; the handle copies without it.
 
 Excerpt — not a complete module
 
 ```tsx
-<CodeBlock code={source} onCopy={(request) => request.copied && toast('Copiado')} />;
+<CodeBlock code={source} onCopy={(request) => request.copied && toast('Copied')} />;
 ```
 
-### Código a caminho, e nenhum código
+### Code on the way, and no code
 
-loading desenha a moldura à altura de seis linhas com skeletons dentro e aria-busy, sem controle de cópia — não um spinner, que é para uma região que já tem conteúdo. Uma string vazia é uma linha vazia com o seu número.
+loading draws the frame at the height of six lines with skeletons inside and aria-busy, without a copy control — not a spinner, which is for a region that already has content. An empty string is an empty line with its number.
 
 Excerpt — not a complete module
 
@@ -244,9 +244,9 @@ Excerpt — not a complete module
 <CodeBlock code="" loading title="deploy.log" />;
 ```
 
-### Conteúdo que a família não escolheu
+### Content the family did not choose
 
-Uma linha de 400 caracteres rola e, sob wrap, parte-se num token indivisível em vez de escapar da caixa; código árabe numa página RTL lê-se da esquerda para a direita; um <script> na amostra são seis caracteres.
+A 400-character line scrolls and, under wrap, breaks inside an indivisible token instead of escaping the box; Arabic code on an RTL page reads from left to right; a <script> in the sample is six characters.
 
 Excerpt — not a complete module
 
@@ -254,9 +254,9 @@ Excerpt — not a complete module
 <CodeBlock code={'<script>alert(1)</script>'} language="html" />;
 ```
 
-### Composição
+### Composition
 
-Vários ficheiros são tabs com um CodeBlock por painel; uma ação do consumidor entra em actions ao lado do copy; renderToken desenha um token à maneira da aplicação; CodeBlockDefaultsProvider entrega o motor uma vez a todos os blocos da página.
+Several files are tabs with one CodeBlock per panel; a consumer action goes in actions next to copy; renderToken draws a token the application’s way; CodeBlockDefaultsProvider hands the engine once to every block on the page.
 
 Excerpt — not a complete module
 
@@ -267,14 +267,14 @@ Excerpt — not a complete module
 </CodeBlockDefaultsProvider>;
 ```
 
-### Teclado
+### Keyboard
 
-Tab: copy, wrap, reveal, e o corpo quando transborda. No corpo as setas, Page, Home, End e Space são os da plataforma; Enter e Space nos controles; Escape num bloco revelado dobra-o e mantém o foco.
+Tab: copy, wrap, reveal, and the body when it overflows. In the body the arrows, Page, Home, End and Space are the platform’s; Enter and Space on the controls; Escape in a revealed block folds it and keeps focus.
 
 Excerpt — not a complete module
 
 ```tsx
-// "group.ts, region" — o título, porque o corpo só é uma região com nome
-// enquanto o código transborda.
+// "group.ts, region" — the title, because the body is a named region only
+// while the code overflows.
 <CodeBlock code={wide} language="ts" title="group.ts" />;
 ```

package/dist/docs/currency-field.json

@@ -240,6 +240,13 @@
           "appliesTo": "CurrencyField",
           "description": "Overrides how many fraction digits the amount is written with, for a unit price quoted finer than the currency’s cent"
         },
+        {
+          "name": "unit",
+          "type": "'major' | 'minor'",
+          "defaultValue": "major",
+          "appliesTo": "CurrencyField, CurrencyFieldDefaultsProvider",
+          "description": "The unit value, defaultValue, min, max, the steps, stepFrom, onValueChange and the submitted amount are in: major is 12.34, minor the integer 1234 of the currency’s minor unit, which fractionDigits decides when set"
+        },
         {
           "name": "min",
           "type": "number",

package/dist/docs/currency-field.md

@@ -50,6 +50,7 @@ Excerpt — not a complete module
 | `locale` | `string` | the language in force | CurrencyField | BCP 47. It decides the separators, where the symbol goes and the numbering system — never the symbol itself, which is the currency’s |
 | `format` | `Intl.NumberFormatOptions` | — | CurrencyField | Any other Intl option: currencySign for accounting parentheses, signDisplay, useGrouping, roundingMode. Every key here wins over the family’s own; style and currency are the family’s |
 | `fractionDigits` | `number` | the currency’s minor units | CurrencyField | Overrides how many fraction digits the amount is written with, for a unit price quoted finer than the currency’s cent |
+| `unit` | `'major' \| 'minor'` | major | CurrencyField, CurrencyFieldDefaultsProvider | The unit value, defaultValue, min, max, the steps, stepFrom, onValueChange and the submitted amount are in: major is 12.34, minor the integer 1234 of the currency’s minor unit, which fractionDigits decides when set |
 | `min` | `number` | — | CurrencyField | The smallest amount the control holds, in major units. It disables the decrement button at the bound, gives Home somewhere to go, and is the one thing that refuses a debit: min={0} is why there is no allowNegative |
 | `max` | `number` | — | CurrencyField | The largest amount the control holds. It disables the increment button at the bound and gives End somewhere to go |
 | `step` | `number` | 1 | CurrencyField | What the arrows and the two buttons move by, in major units: one real, not one centavo |

package/dist/docs/data-grid.examples.md

@@ -2109,7 +2109,7 @@ Excerpt — not a complete module
 
 ### Load more
 
-With an unknown total the footer states the range without one and offers Load more; when the grid windows its rows, onLoadMore is called on its own as the window nears the end.
+With an unknown total the footer states the range without one. onLoadMore is called on its own as the reader nears the end, and the footer says a page is loading; it offers a control only to retry a page that failed (loadMoreFailed). loadMoreTrigger="button" asks only from a Load more control, "both" does the two.
 
 Excerpt — not a complete module
 

package/dist/docs/data-grid.json

@@ -98,6 +98,7 @@
         "skeletonRows": 8,
         "filterDebounce": 300,
         "loadMoreThreshold": 20,
+        "loadMoreTrigger": "scroll",
         "pageSizes": [
           25,
           50,
@@ -496,7 +497,7 @@
           "type": "GridColumn<Row>[]",
           "defaultValue": "—",
           "appliesTo": "DataGrid",
-          "description": "The column model: id, label, description, kind, accessor, format, compare, width, minWidth, maxWidth, flex, priority, sortable, filterable, searchable, editable, resizable, reorderable, hideable, rowHeader, options, aggregate, validate, parse — and help, a node for the column’s help popover."
+          "description": "The column model: id, label, description, kind, accessor, format, compare, width, minWidth, maxWidth, flex, priority, sortable, filterable, searchable, editable, resizable, reorderable, hideable, rowHeader, pinned (end by default for kind actions), options, aggregate, validate, parse — and help, a node for the column’s help popover."
         },
         {
           "name": "description",
@@ -552,7 +553,7 @@
           "type": "boolean",
           "defaultValue": "—",
           "appliesTo": "DataGrid",
-          "description": "Whether a page past this one exists when the total is unknown; the footer offers Load more."
+          "description": "Whether a page past this one exists when the total is unknown; loadMoreTrigger decides what asks for it."
         },
         {
           "name": "loading",
@@ -904,6 +905,20 @@
           "appliesTo": "DataGrid",
           "description": "Asked for the next page when hasMore is true."
         },
+        {
+          "name": "loadMoreTrigger",
+          "type": "'scroll' | 'button' | 'both'",
+          "defaultValue": "scroll",
+          "appliesTo": "DataGrid",
+          "description": "What asks for the next page: nearing the end, with a loading status in the footer; a Load more control; or both."
+        },
+        {
+          "name": "loadMoreFailed",
+          "type": "boolean",
+          "defaultValue": "false",
+          "appliesTo": "DataGrid",
+          "description": "The last page asked for failed: the automatic request stops and the footer offers Try again."
+        },
         {
           "name": "onRetry",
           "type": "() => void",
@@ -1086,7 +1101,7 @@
           "type": "component",
           "defaultValue": "—",
           "appliesTo": "Application",
-          "description": "Sets variant, striped, stickyHeader, stickyTo, selectionMode, editMode, filterRow, virtualize, rowHeight, columnOverflow, overscan, pageSizes, filterDebounce, loadMoreThreshold and skeletonRows once for a subtree. A grid that states one itself still wins. Its words and its locale come from the language in force (SlottedProvider)."
+          "description": "Sets variant, striped, stickyHeader, stickyTo, selectionMode, editMode, filterRow, virtualize, rowHeight, columnOverflow, overscan, pageSizes, filterDebounce, loadMoreThreshold, loadMoreTrigger and skeletonRows once for a subtree. A grid that states one itself still wins. Its words and its locale come from the language in force (SlottedProvider)."
         },
         {
           "name": "@slotted/core/grid",
@@ -1207,7 +1222,9 @@
     "--slotted-control-font-size-md",
     "--slotted-control-font-size-sm",
     "--slotted-control-gap-md",
+    "--slotted-control-height-lg",
     "--slotted-control-height-md",
+    "--slotted-control-height-sm",
     "--slotted-control-icon-size-md",
     "--slotted-control-inner-size-sm",
     "--slotted-control-invalid-edge-width",
@@ -1526,7 +1543,7 @@
     {
       "id": "load-more",
       "title": "Load more",
-      "note": "With an unknown total the footer states the range without one and offers Load more; when the grid windows its rows, onLoadMore is called on its own as the window nears the end.",
+      "note": "With an unknown total the footer states the range without one. onLoadMore is called on its own as the reader nears the end, and the footer says a page is loading; it offers a control only to retry a page that failed (loadMoreFailed). loadMoreTrigger=\"button\" asks only from a Load more control, \"both\" does the two.",
       "language": "tsx",
       "source": "<DataGrid\n  hasMore={hasMore}\n  onLoadMore={fetchMore}\n  query={{ ...emptyQuery(), page: { cursor, size: 50 } }}\n  rows={rows}\n/>;\n",
       "verdict": "excerpt"

package/dist/docs/data-grid.md

@@ -208,7 +208,7 @@ See [data-grid.props.md](./data-grid.props.md).
 
 ## Tokens
 
-`--slotted-border-strong`, `--slotted-border-subtle`, `--slotted-border-width-thick`, `--slotted-border-width-thin`, `--slotted-control-font-family`, `--slotted-control-font-size-md`, `--slotted-control-font-size-sm`, `--slotted-control-gap-md`, `--slotted-control-height-md`, `--slotted-control-icon-size-md`, `--slotted-control-inner-size-sm`, `--slotted-control-invalid-edge-width`, `--slotted-control-padding-inline-md`, `--slotted-control-padding-inline-sm`, `--slotted-control-transition-duration`, `--slotted-control-transition-easing`, `--slotted-data-grid-band-surface`, `--slotted-data-grid-block-size`, `--slotted-data-grid-border-color`, `--slotted-data-grid-border-color-strong`, `--slotted-data-grid-border-width`, `--slotted-data-grid-cell-padding-block`, `--slotted-data-grid-cell-padding-inline`, `--slotted-data-grid-changed-surface`, `--slotted-data-grid-color`, `--slotted-data-grid-color-muted`, `--slotted-data-grid-control-radius`, `--slotted-data-grid-cursor-color`, `--slotted-data-grid-filter-operator-size`, `--slotted-data-grid-filter-panel-size`, `--slotted-data-grid-filter-panel-size-date`, `--slotted-data-grid-filter-panel-size-datetime`, `--slotted-data-grid-font-family`, `--slotted-data-grid-font-size`, `--slotted-data-grid-gap`, `--slotted-data-grid-head-block-size`, `--slotted-data-grid-header-surface`, `--slotted-data-grid-header-surface-hover`, `--slotted-data-grid-icon-size`, `--slotted-data-grid-indent`, `--slotted-data-grid-pin-shadow-color`, `--slotted-data-grid-pin-shadow-size`, `--slotted-data-grid-radius`, `--slotted-data-grid-range-surface`, `--slotted-data-grid-row-block-size`, `--slotted-data-grid-row-color-selected`, `--slotted-data-grid-row-max-block-size`, `--slotted-data-grid-row-surface-hover`, `--slotted-data-grid-row-surface-selected`, `--slotted-data-grid-row-surface-selected-hover`, `--slotted-data-grid-row-surface-stripe`, `--slotted-data-grid-shadow`, `--slotted-data-grid-sticky-offset`, `--slotted-data-grid-sticky-offset-end`, `--slotted-data-grid-surface`, `--slotted-disabled-foreground`, `--slotted-duration-long`, `--slotted-duration-loop`, `--slotted-duration-short`, `--slotted-easing-standard`, `--slotted-focus-ring-color`, `--slotted-focus-ring-color-invalid`, `--slotted-focus-ring-offset`, `--slotted-focus-ring-width`, `--slotted-font-size-xs`, `--slotted-font-weight-medium`, `--slotted-font-weight-regular`, `--slotted-font-weight-semibold`, `--slotted-ground`, `--slotted-line-height-md`, `--slotted-popover-gap`, `--slotted-popover-padding-block-sm`, `--slotted-popover-padding-inline-sm`, `--slotted-radius-md`, `--slotted-radius-sm`, `--slotted-scrim`, `--slotted-shadow-xs`, `--slotted-space-1`, `--slotted-space-2`, `--slotted-space-3`, `--slotted-space-4`, `--slotted-space-5`, `--slotted-space-6`, `--slotted-space-8`, `--slotted-surface`, `--slotted-surface-sunken`, `--slotted-target-comfortable`, `--slotted-target-min`, `--slotted-text`, `--slotted-text-muted`, `--slotted-tone-accent-border`, `--slotted-tone-accent-solid`, `--slotted-tone-accent-subtle-hover`, `--slotted-tone-accent-surface`, `--slotted-tone-accent-text`, `--slotted-tone-danger-border`, `--slotted-tone-secondary-subtle-hover`, `--slotted-z-index-sticky`
+`--slotted-border-strong`, `--slotted-border-subtle`, `--slotted-border-width-thick`, `--slotted-border-width-thin`, `--slotted-control-font-family`, `--slotted-control-font-size-md`, `--slotted-control-font-size-sm`, `--slotted-control-gap-md`, `--slotted-control-height-lg`, `--slotted-control-height-md`, `--slotted-control-height-sm`, `--slotted-control-icon-size-md`, `--slotted-control-inner-size-sm`, `--slotted-control-invalid-edge-width`, `--slotted-control-padding-inline-md`, `--slotted-control-padding-inline-sm`, `--slotted-control-transition-duration`, `--slotted-control-transition-easing`, `--slotted-data-grid-band-surface`, `--slotted-data-grid-block-size`, `--slotted-data-grid-border-color`, `--slotted-data-grid-border-color-strong`, `--slotted-data-grid-border-width`, `--slotted-data-grid-cell-padding-block`, `--slotted-data-grid-cell-padding-inline`, `--slotted-data-grid-changed-surface`, `--slotted-data-grid-color`, `--slotted-data-grid-color-muted`, `--slotted-data-grid-control-radius`, `--slotted-data-grid-cursor-color`, `--slotted-data-grid-filter-operator-size`, `--slotted-data-grid-filter-panel-size`, `--slotted-data-grid-filter-panel-size-date`, `--slotted-data-grid-filter-panel-size-datetime`, `--slotted-data-grid-font-family`, `--slotted-data-grid-font-size`, `--slotted-data-grid-gap`, `--slotted-data-grid-head-block-size`, `--slotted-data-grid-header-surface`, `--slotted-data-grid-header-surface-hover`, `--slotted-data-grid-icon-size`, `--slotted-data-grid-indent`, `--slotted-data-grid-pin-shadow-color`, `--slotted-data-grid-pin-shadow-size`, `--slotted-data-grid-radius`, `--slotted-data-grid-range-surface`, `--slotted-data-grid-row-block-size`, `--slotted-data-grid-row-color-selected`, `--slotted-data-grid-row-max-block-size`, `--slotted-data-grid-row-surface-hover`, `--slotted-data-grid-row-surface-selected`, `--slotted-data-grid-row-surface-selected-hover`, `--slotted-data-grid-row-surface-stripe`, `--slotted-data-grid-shadow`, `--slotted-data-grid-sticky-offset`, `--slotted-data-grid-sticky-offset-end`, `--slotted-data-grid-surface`, `--slotted-disabled-foreground`, `--slotted-duration-long`, `--slotted-duration-loop`, `--slotted-duration-short`, `--slotted-easing-standard`, `--slotted-focus-ring-color`, `--slotted-focus-ring-color-invalid`, `--slotted-focus-ring-offset`, `--slotted-focus-ring-width`, `--slotted-font-size-xs`, `--slotted-font-weight-medium`, `--slotted-font-weight-regular`, `--slotted-font-weight-semibold`, `--slotted-ground`, `--slotted-line-height-md`, `--slotted-popover-gap`, `--slotted-popover-padding-block-sm`, `--slotted-popover-padding-inline-sm`, `--slotted-radius-md`, `--slotted-radius-sm`, `--slotted-scrim`, `--slotted-shadow-xs`, `--slotted-space-1`, `--slotted-space-2`, `--slotted-space-3`, `--slotted-space-4`, `--slotted-space-5`, `--slotted-space-6`, `--slotted-space-8`, `--slotted-surface`, `--slotted-surface-sunken`, `--slotted-target-comfortable`, `--slotted-target-min`, `--slotted-text`, `--slotted-text-muted`, `--slotted-tone-accent-border`, `--slotted-tone-accent-solid`, `--slotted-tone-accent-subtle-hover`, `--slotted-tone-accent-surface`, `--slotted-tone-accent-text`, `--slotted-tone-danger-border`, `--slotted-tone-secondary-subtle-hover`, `--slotted-z-index-sticky`
 
 ## Examples
 

package/dist/docs/data-grid.props.md

@@ -9,7 +9,7 @@
 | --- | --- | --- | --- | --- |
 | `rows` | `readonly Row[]` | — | DataGrid | The records; the grid never mutates them. Left out when a dataSource answers for them. |
 | `rowKey` | `keyof Row \| (row) => string` | — | DataGrid | A field name or a function: the key every state model names a row by. |
-| `columns` | `GridColumn<Row>[]` | — | DataGrid | The column model: id, label, description, kind, accessor, format, compare, width, minWidth, maxWidth, flex, priority, sortable, filterable, searchable, editable, resizable, reorderable, hideable, rowHeader, options, aggregate, validate, parse — and help, a node for the column’s help popover. |
+| `columns` | `GridColumn<Row>[]` | — | DataGrid | The column model: id, label, description, kind, accessor, format, compare, width, minWidth, maxWidth, flex, priority, sortable, filterable, searchable, editable, resizable, reorderable, hideable, rowHeader, pinned (end by default for kind actions), options, aggregate, validate, parse — and help, a node for the column’s help popover. |
 | `description` | `string` | — | DataGridColumn | What the column is: the header’s accessible description, the caption atop its menu and the first line of its help popover. |
 | `help` | `ReactNode` | — | DataGridColumn | The column’s own help, under the description in the popover the column-help button opens. Its presence alone draws the button. |
 | `priority` | `number` | — | DataGridColumn | The lower, the longer the column stays when the frame is too narrow. A column without one leaves before every numbered one; the identity column and an actions column never leave. |
@@ -17,7 +17,7 @@
 | `columnGroups` | `GridColumnGroup[]` | — | DataGrid | Headings spanning columns, drawn as a row above the names. |
 | `mode` | `'client' \| 'server'` | inferred | DataGrid | client applies the query to rows; server draws rows as given. server when totalCount or hasMore is present. |
 | `totalCount` | `number` | — | DataGrid | The whole set’s size in server mode; aria-rowcount and the range read it. |
-| `hasMore` | `boolean` | — | DataGrid | Whether a page past this one exists when the total is unknown; the footer offers Load more. |
+| `hasMore` | `boolean` | — | DataGrid | Whether a page past this one exists when the total is unknown; loadMoreTrigger decides what asks for it. |
 | `loading` | `boolean` | false | DataGrid | Skeleton rows with no rows to keep; aria-busy and a dimmed body over rows already shown. |
 | `error` | `string \| null` | — | DataGrid | The message of a failed load; draws the error state with Try again when onRetry is set. |
 | `disabledKeys` | `string[]` | — | DataGrid | Rows that are neither selectable nor editable, drawn with data-disabled. |
@@ -68,6 +68,8 @@
 | `highlightChanges` | `boolean \| number` | false | DataGrid | Marks a mounted cell whose value changed between two rows, for the stated milliseconds (true is 1200). |
 | `loadMoreThreshold` | `number` | 20 | DataGrid | Rows left below the window before onLoadMore is called. |
 | `onLoadMore` | `() => void` | — | DataGrid | Asked for the next page when hasMore is true. |
+| `loadMoreTrigger` | `'scroll' \| 'button' \| 'both'` | scroll | DataGrid | What asks for the next page: nearing the end, with a loading status in the footer; a Load more control; or both. |
+| `loadMoreFailed` | `boolean` | false | DataGrid | The last page asked for failed: the automatic request stops and the footer offers Try again. |
 | `onRetry` | `() => void` | — | DataGrid | The error state’s Try again. |
 | `skeletonRows` | `number` | 8 | DataGrid | Rows the first load draws. |
 | `pageSizes` | `number[]` | 25,50,100 | DataGrid | The sizes a page-size control in the footer offers, read through useDataGridDefaults. |
@@ -93,7 +95,7 @@
 | `align` | `'start' \| 'center' \| 'end'` | start | GridColumn | Where the value sits; a number column sits at the end unless told otherwise. |
 | `numeric` | `boolean` | false | GridColumn | Tabular figures and end alignment; true for kind number. |
 | `text` | `'wrap' \| 'truncate' \| 'nowrap'` | truncate | GridColumn | What a long value does. |
-| `DataGridDefaultsProvider` | `component` | — | Application | Sets variant, striped, stickyHeader, stickyTo, selectionMode, editMode, filterRow, virtualize, rowHeight, columnOverflow, overscan, pageSizes, filterDebounce, loadMoreThreshold and skeletonRows once for a subtree. A grid that states one itself still wins. Its words and its locale come from the language in force (SlottedProvider). |
+| `DataGridDefaultsProvider` | `component` | — | Application | Sets variant, striped, stickyHeader, stickyTo, selectionMode, editMode, filterRow, virtualize, rowHeight, columnOverflow, overscan, pageSizes, filterDebounce, loadMoreThreshold, loadMoreTrigger and skeletonRows once for a subtree. A grid that states one itself still wins. Its words and its locale come from the language in force (SlottedProvider). |
 | `@slotted/core/grid` | `module` | — | Application | applyQuery, emptyQuery, withSortPress, withColumnFilter, withSearch, withPageIndex, withGroup, toGridParams, fromGridParams, normalizeColumnState, serializeColumnState, parseColumnState: the engine the grid runs on, for a server mock, a URL and a saved view. |
 | `renderCell, renderEditor, renderHeader, renderDetail, renderGroup, renderEmpty, renderFilterOperand` | `render props` | — | DataGrid | Every surface a consumer replaces, per grid or per column through cellRenderers and editorRenderers. row, cell, head and body are fixed: the layout and the roles are theirs. |
 | `footer` | `ReactNode` | — | DataGrid | Pagination, a page-size select, a count: the consumer’s own controls in the bar the grid draws. |