@nxgt/material 3.54.0 → 3.56.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @nxgt/material
 
+## 3.56.0
+
+### Minor Changes
+
+- [#1952](https://github.com/softistx/nxgt-material/pull/1952) [`1f3d75d`](https://github.com/softistx/nxgt-material/commit/1f3d75dc6fec114442c911b57de69b5c882cd37e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - New `LinkComponentProvider` in `@nxgt/material/components`: set your router's link once (`<LinkComponentProvider component={RouterLink}>`) and `LinkButton`, `IconLinkButton`, `ResponsiveLinkButton`, the sidebar and app shell, `AccountMenu`, `Pager`, `SeeAlso`, `Toc`, `PeriodCards`, `NotificationRow`, `Doc`, `DataTable`, `ServerTable`, `ListEmpty`, `Switcher`, `ListTile`, `PageFooter`, `Notifications`, `Breadcrumb`, `Pagination`, `LinkCard` and `QuestionNavigator` render their links with it. A component's own `linkComponent` prop still wins, and nothing changes without the provider. `LinkComponent` and `LinkComponentProps` are now exported, and `useLinkComponent()` reads the provider's link in your own components. The link buttons gain a `linkComponent` prop. Fixes [#1950](https://github.com/softistx/nxgt-material/issues/1950).
+
+- [#1936](https://github.com/softistx/nxgt-material/pull/1936) [`4078fc4`](https://github.com/softistx/nxgt-material/commit/4078fc456d91eafdb4622b6edd3762adb1f89fcc) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `QuestionCard`: a server-given `verdict` (`'correct' | 'incorrect' | 'pending'`) is shown as given, with no comparison against `question.correct` in the browser (the correct choices can still be passed to highlight them). `points` (`{ awarded, possible }`) and `feedback` fill the verdict banner, and `pending` reads "Awaiting grading" with a clock icon. `question.media` also accepts audio (an `AudioPlayer`) and a document link (a `FilePreview`) through `kind` or a MIME `type` and a `name` as text alternative. New types `QuestionMedia`, `QuestionMediaKind`, `QuestionVerdict`, `QuestionPoints`. `revealed` without `verdict` is unchanged ([#1933](https://github.com/softistx/nxgt-material/issues/1933)).
+
+- [#1949](https://github.com/softistx/nxgt-material/pull/1949) [`1a1b722`](https://github.com/softistx/nxgt-material/commit/1a1b722b7fe8091ac811611d2dd32797f25c484c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - New `QuestionNavigator` in `@nxgt/material/widgets/education`: the numbered questions of a quiz or exam player, with `count`, `current` (from 1), `answered` and `flagged` (arrays or Sets), and `onSelect(n)` or `getHref(n)` for a link variant. Targets are at least 44px, the current one has `aria-current="step"`, answered and flagged show an icon and are named in the accessible label, and it stays one scrolling row that keeps the current number in view. Labels under `material.question-navigator.*` (en, fr). Fixes [#1947](https://github.com/softistx/nxgt-material/issues/1947).
+
+- [#1939](https://github.com/softistx/nxgt-material/pull/1939) [`1693f0f`](https://github.com/softistx/nxgt-material/commit/1693f0fb28053603a02bb101473b63b239770f81) Thanks [@SteveGT96](https://github.com/SteveGT96)! - New `SecretCard`: a card whose secret (`back`) is not rendered, so it is not in the markup, read out or copied, until a deliberate click or tap on its reveal button, a disclosure with one name and `aria-expanded` (and `aria-controls`). Hide it again with the same button, or let `autoHideMs` do it. `revealed` with `onRevealedChange` controls it, `defaultRevealed` starts it open; the two never go together. `title`, `description` (a hint shown while hidden), `icon`, `tone`, `front` (the hidden face), `actions` and `labels` shape it. Changes a click does not explain (auto-hide, the parent) are announced through a polite live region, focus moves to the button when the face that held it is swapped, the flip runs only after a change and without reduced motion, and it is full width up to 28rem with a 44px button. New `material.secret-card.*` keys in English and French. Closes [#1912](https://github.com/softistx/nxgt-material/issues/1912).
+
+- [#1946](https://github.com/softistx/nxgt-material/pull/1946) [`5e2b8c9`](https://github.com/softistx/nxgt-material/commit/5e2b8c99c3e95cf08c5ce29baaaa1afc3f14f44a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `useCountdown` is public, from `@nxgt/material/hooks`: the clock behind `CountdownTimer`, for a button or a message that waits (a rate limit's `retryAfter`, a resend delay). `useCountdown(duration, { paused, onExpire, key })` returns the seconds left, ticking on the client only; a new `duration` **or a new `key`** starts over, so the same duration twice restarts it. `CountdownTimer` is unchanged.
+
+- [#1942](https://github.com/softistx/nxgt-material/pull/1942) [`803afd5`](https://github.com/softistx/nxgt-material/commit/803afd57f5215b7d48081799015549b61632da16) Thanks [@SteveGT96](https://github.com/SteveGT96)! - New `VoteTally`: a live ranked tally of a vote, poll or ballot. One row per option with its count and share written as text ("Ada Example, 3 votes, 60%"), a decorative bar, and who voted for it as an avatar group or a line of names. `sort` ranks by count (equal counts share a rank), a single top option is marked "Leader" and several are each marked "Tie" (never an arbitrary leader), `selectedId` marks "Your vote", and `abstainCount` shows abstentions beneath the bars. Bars ease only without `prefers-reduced-motion` (`animated` turns it off); a polite, debounced live status (`announceDelay`) says where the vote stands after live changes. `renderOption`, `renderVoters`, `header` and `footer` replace the defaults. Bar widths are SVG attributes, so server markup carries no `style`. New `material.vote-tally.*` keys in English and French. Closes [#1913](https://github.com/softistx/nxgt-material/issues/1913).
+
+## 3.55.0
+
+### Minor Changes
+
+- [#1930](https://github.com/softistx/nxgt-material/pull/1930) [`ea953b1`](https://github.com/softistx/nxgt-material/commit/ea953b15b2d0878c065d4df29d8d5e9e2e5e94cd) Thanks [@SteveGT96](https://github.com/SteveGT96)! - New `SeatRing`: participants as seats around a circle, or in a two-column grid when its own box is narrow (a container query, so it follows a column or a dialog, not the window). Each seat takes an avatar (default: the label's initials), a label, a status written in words with a tone, a badge and `disabled` / `empty` flags; `renderAvatar`, `renderStatus`, `renderBadge`, `renderEmptySeat` and `centerSlot` replace the defaults, `highlightedId` marks whose turn it is, and `size` is `sm`, `md` or `lg`. Without `selectionMode` it is a `list`; with `selectionMode="single"` or `"multiple"` (`value`, `defaultValue`, `onValueChange`) it is a `listbox` of `option`s with a roving tab stop: arrows, Home and End move, Space or Enter picks, and the selection is shown with a check as well as a tint. New `material.seat-ring.empty` key in English and French. Closes [#1911](https://github.com/softistx/nxgt-material/issues/1911).
+
 ## 3.54.0
 
 ### Minor Changes

package/README.md

@@ -19,7 +19,8 @@ drag-and-drop, i18n, and `Icon`. Tailwind CSS v4 + Base UI.
 - **Helpers** ([helpers guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/helpers.md)): `cn`, `clientOnly`,
   date, number, storage and URL utilities, a Zod error map, and Redux Toolkit
   slice factories in `/lib`. Theme, i18n-aware formatting, option, focus
-  (`useFocusOnMount`) and one-submit (`useSubmitOnce`) hooks are in `/hooks`.
+  (`useFocusOnMount`), countdown (`useCountdown`) and one-submit
+  (`useSubmitOnce`) hooks are in `/hooks`.
 - **i18n** ([i18n guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/i18n.md)): an `I18nProvider` with ICU
   messages and shipped `en` / `fr` strings. Your app merges in its own
   resources.
@@ -217,7 +218,7 @@ reads `duotone.svg`, the file that exists (it used to ask for the missing
 | `@nxgt/material/draw/png` | `drawingToPng(sceneOrSvg, { scale?, background?, colorsFrom? })` and `downloadDrawingPng(source, fileName)` — a drawing (a scene, or a live `<svg>` such as `svgRef.current` of a `<Drawing ref={svgRef}>`) as a PNG `Blob` in the browser, with the page's theme colours resolved, `data:` images inlined and CORS errors named; its own entry, DOM only when called ([drawing guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/drawing.md#png), [reference](https://cdn.jsdelivr.net/npm/@nxgt/material-core@0/docs/draw.md#png-nxgtmaterial-coredrawpng)) |
 | `@nxgt/material/vite` | build-time helpers for consumers: `nxgtMaterial()` (a strict CSP by hash or nonce, self-hosted fonts, a styles check, serves the pdf.js worker on the Vite 5–7 dev server, generates your app themes' stylesheets with `nxgtMaterial({ themes })` and the `nxgt-theme` bin: [Themes guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/themes.md), a reduced backdrop icon sprite from your Font Awesome install with `nxgtMaterial({ backdropSprite })` and the `nxgt-backdrop-sprite` bin, PDFs on a bundled server with `nxgtMaterial({ pdf: { bundle: true } })`: [Vite plugin guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/vite-plugin.md)), `pdfkitStandardFonts()` ([printing guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/printing.md)), `cspAssetsInlineLimit`, a `build.assetsInlineLimit` that never inlines a font ([CSP guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/csp.md#katex-fonts)) |
 | `@nxgt/material/next` | `withNxgtPrint(nextConfig)`: the `next.config.ts` a Next.js route handler that imports `/print` needs, `output: 'standalone'` included. Node only, no dependency on `next` ([printing guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/printing.md#nextjs-serverexternalpackages-and-output-standalone)) |
-| `@nxgt/material/hooks` | `useTheme`, `useIsClient`, `useIsMobile`, `useLocalizedDate`, `useCspNonce`, `useFocusOnMount`, `useSubmitOnce`, … ([helpers](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/helpers.md#nxgtmaterialhooks)) |
+| `@nxgt/material/hooks` | `useTheme`, `useIsClient`, `useIsMobile`, `useLocalizedDate`, `useCspNonce`, `useFocusOnMount`, `useCountdown`, `useSubmitOnce`, … ([helpers](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/helpers.md#nxgtmaterialhooks)) |
 | `@nxgt/material/dnd` | `@dnd-kit` primitives ([helpers](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/helpers.md#nxgtmaterialdnd)) |
 | `@nxgt/material/i18n` | `I18nProvider`, `mergeResources`, `createTranslator`, `translateMaterial`, `formatMessage` ([i18n guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/i18n.md)) |
 | `@nxgt/material/lib` | `cn`, `clientOnly`, date, number and storage utilities, `useSliceReducer`, `getCspNonce` / `setCspNonce`, the server-side CSP helpers (`createCspNonce`, `cspPolicy`, `cspHash`, `applyCspNonce`, `CSP_NONCE_PLACEHOLDER`, `ZOD_JITLESS_SCRIPT`, `zodJitlessTag`: [CSP, SSR](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/csp.md#ssr)) ([helpers](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/helpers.md#nxgtmateriallib)) |
@@ -500,6 +501,7 @@ Not components: what the stylesheet gives any element.
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/primitives-togglegroup.webp" width="120" alt="ToggleGroup"> | [`ToggleGroup`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/primitives.md#togglegroup), `ToggleGroupItem`, `ToggleGroupSeparator` | Toggle group in three looks: connected (pill morph), segmented (sliding pill), separate; sizes sm, md, lg; horizontal or vertical. | `ToggleGroup`, `ToggleGroupItem` |
 | — | [`Activity`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/primitives.md#activity) | React `<Activity>` switched by a boolean `visible`. | `Activity` |
 | — | [`NonceProvider`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/primitives.md#nonceprovider) | Gives the page's CSP nonce to every component below; `useCspNonce()` reads it ([CSP guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/csp.md#nonceprovider)). | `NonceProvider` |
+| — | [`LinkComponentProvider`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/primitives.md#linkcomponentprovider) | Sets, once, the link component (your router's `Link`) of the components that render a link (buttons, shell, tables, pager, notifications, doc); `LinkComponentProps` types the adapter and `useLinkComponent()` reads it. | `LinkComponentProvider`, `useLinkComponent`, `LinkComponent`, `LinkComponentProps` |
 
 ### Buttons & actions
 
@@ -599,6 +601,8 @@ Not components: what the stylesheet gives any element.
 | --- | --- | --- | --- |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-avatar.webp" width="120" alt="Avatar"> | [`Avatar`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#avatar), `AvatarImage`, `AvatarFallback`, `AvatarBase` | Image with a fallback and an optional online / offline dot; `shape` clips it to an expressive shape; the initials scale with the size (40 % of the diameter); `tone` colours the fallback. | `Avatar`, `AvatarImage`, `AvatarFallback` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-avatargroup.webp" width="120" alt="AvatarGroup"> | [`AvatarGroup`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#avatargroup) | Overlapping avatars with a `+N` overflow. | `AvatarGroup` |
+| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-seatring.webp" width="120" alt="SeatRing"> | [`SeatRing`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#seatring) | Participants as seats around a circle, or in a grid on a narrow box; avatar, name, status, badge and centre slots; optionally a listbox to pick one or several (`selectionMode`). | — |
+| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-secretcard.webp" width="120" alt="SecretCard"> | [`SecretCard`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#secretcard) | A card whose secret is not rendered until a deliberate tap or click reveals it (a role, a one-time code, a recovery key); hide again, optional `autoHideMs`, controlled or not, polite announcement. | — |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-shape.webp" width="120" alt="Shape"> | [`Shape`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#shape) | Material 3 Expressive's 35 shapes and a squircle as a backdrop, an icon container or a mask for a photo, with a morph; eight tones or an app tone. | — |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-badge.webp" width="120" alt="Badge"> | [`Badge`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#badge) | Status pill, 20 px: default, secondary, error, success, info, warning, `soft` (tonal, for states), outlined; an optional decorative `icon` before the words. | `Badge` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-countbadge.webp" width="120" alt="CountBadge"> | [`CountBadge`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#countbadge) | Count in the corner of its children, capped at `99+` and hidden at 0; `animated` pops it in when it changes. | `CountBadge` |
@@ -618,6 +622,7 @@ Not components: what the stylesheet gives any element.
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-timeline.webp" width="120" alt="Timeline"> | [`Timeline`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#timeline), `TimelineItem`, `RelativeTime` | Vertical event timeline with shaped, toned markers, cards, alternating sides in a wide container, optional day groups and relative times. | `Timeline`, `TimelineItem`, `RelativeTime` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-changehistory.webp" width="120" alt="ChangeHistory"> | [`ChangeHistory`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#changehistory) | History of the changes made to anything (a document, a project's settings, a file): a rail of toned dots or tinted cards with a Before / After block, a heading per day (sticky on the rail), long entries collapsed behind "N fields changed", redacted values shown as "Hidden", the exact time on hover and focus, load more. | — (later, #1626) |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-zonedtime.webp" width="120" alt="ZonedTime"> | [`ZonedTime`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#zonedtime) | A moment in a named IANA zone, with the zone as a computed offset (`Mar 12, 2026, 4:04 PM UTC+1`), identical on the server and the client (no hydration warning): the date and the time are formatted apart, `seconds` and `dateStyle` are optional, in a `<time dateTime>`. | — |
+| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-votetally.webp" width="120" alt="VoteTally"> | [`VoteTally`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#votetally) | A live ranked tally of a vote: one row per option with its count and share as text, a decorative bar, and who voted for it (avatars or names); marks the leader, a tie and the viewer's own vote in words, counts abstentions, eases bars only without reduced motion, and announces changes through a debounced polite status. | — |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-eventchip.webp" width="120" alt="EventChip"> | [`EventChip`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#eventchip) | Calendar event pill — soft, solid or outlined — with its times, all-day and continuation edges. | `EventChip` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-codeblock.webp" width="120" alt="CodeBlock"> | [`CodeBlock`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#codeblock), `JsonViewer`, `CodeGroup` | Highlighted code with line numbers and copy, a collapsible JSON tree, and tabbed samples (`Tabs`, underlined). `CodeDiff` is under Rich widgets. | `CodeBlock`, `JsonViewer`, `CodeGroup` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-display-markdown.webp" width="120" alt="Markdown"> | [`Markdown`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-display.md#markdown), `MermaidDiagram` | GFM markdown with KaTeX math and mermaid diagrams (`clientOnly`). Fences reuse `CodeBlock`. `ChatMarkdown` renders through it. | `Markdown`, `MermaidDiagram` |
@@ -758,7 +763,7 @@ Not components: what the stylesheet gives any element.
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/rich-widgets-richtextviewer.webp" width="120" alt="RichTextViewer"> | [`RichTextViewer`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/rich-widgets.md#richtextviewer) | Read-only view of a saved document (HTML, JSON or Markdown) with the editor's typography; sanitised, server-safe, no editor. From `@nxgt/material/editor/viewer`. | — (a `vue` issue, not a port) |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/rich-widgets-codeeditor.webp" width="120" alt="CodeEditor"> | [`CodeEditor`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/rich-widgets.md#codeeditor) · `CodeEditorFormField` | Monaco code field in theme presets (App, Moonlight, Soft, or your own `defineCodeTheme`), with a floating tool pill, a status bar, `markers` for your own problems, a `readOnly` reader look, view props, a `ref` handle, file tabs (`files`) and full screen. From `@nxgt/material/code-editor`. | `CodeEditor`, `CodeEditorFormField` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/rich-widgets-codeeditor-diff.webp" width="120" alt="CodeDiff"> | [`CodeDiff`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/rich-widgets.md#codediff) | A Monaco diff in the code editor's frame and themes: side by side or inline (always inline on a phone), previous/next change, `+N −M` counts and copy. From `@nxgt/material/code-editor`. | `CodeDiff` |
-| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/rich-widgets-quiz.webp" width="120" alt="Quiz"> | [`Quiz`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/rich-widgets.md#quiz), `QuestionCard` | Exam or practice quizzes: step progress, instant feedback with explanations and hints, a time limit, keyboard shortcuts, and a results screen with a score ring, a breakdown and a retry of the misses. Container queries. | `Quiz`, `QuestionCard` (modes and results: React only for now) |
+| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/rich-widgets-quiz.webp" width="120" alt="Quiz"> | [`Quiz`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/rich-widgets.md#quiz), `QuestionCard` · [`QuestionNavigator`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/rich-widgets.md#questionnavigator) | Exam or practice quizzes: step progress, instant feedback with explanations and hints, a time limit, keyboard shortcuts, and a results screen with a score ring, a breakdown and a retry of the misses. Container queries. | `Quiz`, `QuestionCard` (modes and results: React only for now); `QuestionNavigator` React only for now |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/rich-widgets-drawing.webp" width="120" alt="Drawing"> | [`Drawing`, `Rect`, `Ellipse`, `Circle`, `Line`, `Polygon`, `Path`, `Text`, `Group`, `Image`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/rich-widgets.md#drawing) from `@nxgt/material/draw` | Vector drawings from a scene of plain data or from JSX: theme-role colours that follow light and dark, no inline style (strict CSP), a `title` or `decorative` enforced by the type, focusable nodes with `onClick` and a focus ring, text that wraps with Inter's metrics and is refined by the browser. Client-only entry. | React only for now |
 
 `RadioGroupField`, `SliderField` and `SwitchField` are aliases of the

package/dist/{async-slice-DDSsekfm.js → async-slice-CORlM_wu.js}

@@ -1,5 +1,5 @@
-import { i as e, r as t, t as n } from "./stored-language-B1lJMPbR.js";
-import { r } from "./translator-BU1o3_l9.js";
+import { i as e, r as t, t as n } from "./stored-language-_OGPBCn0.js";
+import { r } from "./translator-BIVSiq4X.js";
 import { t as i } from "./_baseIsEqual-C6ksIHya.js";
 import { useMemo as a } from "react";
 import { asyncThunkCreator as o, buildCreateSlice as s } from "@reduxjs/toolkit";

package/dist/{button-Ct8DSLVv.js → button-CdpVEza0.js}

@@ -1,7 +1,7 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { t } from "./is-production-GLw59WU8.js";
 import { n, t as r } from "./dist-DVRQkaTK.js";
-import { n as i, r as a, t as o } from "./spinner-Rg4PnBPH.js";
+import { n as i, r as a, t as o } from "./spinner-BmUXTzvJ.js";
 import { a as s, i as c, n as l, o as u, s as d, t as f } from "./use-click-lock-BZYtTmVt.js";
 import { t as p } from "./button-group-context-CaP0X5p_.js";
 import { t as m } from "./has-text-content-Ds2dkHX_.js";

package/dist/charts.js

@@ -1,12 +1,12 @@
 import { t as e } from "./ui.utils-CAnKTCw5.js";
 import { t } from "./utils-BLfntITJ.js";
 import { t as n } from "./warn-once-C_e47JM8.js";
-import { t as r } from "./use-material-translation-nNF8fUXz.js";
-import { t as i } from "./button-Ct8DSLVv.js";
+import { t as r } from "./use-material-translation-C_bAxfvp.js";
+import { t as i } from "./button-CdpVEza0.js";
 import { t as a } from "./use-ssr-media-query-C6M5m8sf.js";
 import { i as o, n as s, r as c, t as l } from "./util-4heV2LPI.js";
 import { t as u } from "./useIsomorphicLayoutEffect-DfgAhWcH.js";
-import { t as d } from "./chip-BzoNsd-W.js";
+import { t as d } from "./chip-C0yNYz9m.js";
 import { c as f, d as p, f as m, i as h, o as g, p as _, s as v, t as y } from "./line-path-C5pZGC49.js";
 import { t as b } from "./live-status-BGPaN8r8.js";
 import { t as x } from "./linear-G97mfnKF.js";

package/dist/{chip-BzoNsd-W.js → chip-C0yNYz9m.js}

@@ -1,7 +1,7 @@
 import { t as e } from "./utils-BLfntITJ.js";
-import { r as t } from "./spinner-Rg4PnBPH.js";
+import { r as t } from "./spinner-BmUXTzvJ.js";
 import { s as n } from "./use-click-lock-BZYtTmVt.js";
-import { t as r } from "./use-material-translation-nNF8fUXz.js";
+import { t as r } from "./use-material-translation-C_bAxfvp.js";
 import { t as i } from "./react-node-text-Crkpfpco.js";
 import { cloneElement as a, isValidElement as o } from "react";
 import { Fragment as s, jsx as c, jsxs as l } from "react/jsx-runtime";

package/dist/{code-editor-DsLQeiZc.js → code-editor-Bwzp2038.js}

@@ -2,13 +2,13 @@ import { r as e } from "./rolldown-runtime-BFFgcFxR.js";
 import { t } from "./utils-BLfntITJ.js";
 import { t as n } from "./is-production-GLw59WU8.js";
 import { a as r } from "./dist-lmHmz_bu.js";
-import { c as i, d as a, f as o, n as s, t as c } from "./dropdown-menu-CDN6Nqx6.js";
-import { a as l, i as u, n as d } from "./field-blur-context-Dg1nwWOV.js";
-import { a as f, d as p, r as m, t as h, u as g } from "./toolbar-items-BFY_hns5.js";
-import { t as _ } from "./use-material-translation-nNF8fUXz.js";
-import { i as v, n as y, o as b, t as x } from "./code-language-items-4zXlIEZ0.js";
+import { c as i, d as a, f as o, n as s, t as c } from "./dropdown-menu-C8PBmMIa.js";
+import { a as l, i as u, n as d } from "./field-blur-context-DxdIuHAY.js";
+import { a as f, d as p, r as m, t as h, u as g } from "./toolbar-items-DKfY_6AG.js";
+import { t as _ } from "./use-material-translation-C_bAxfvp.js";
+import { i as v, n as y, o as b, t as x } from "./code-language-items-nP-pF7yH.js";
 import { t as S } from "./useIsomorphicLayoutEffect-DfgAhWcH.js";
-import { n as C, t as w } from "./escape-owner-DI_lg2ID.js";
+import { n as C, t as w } from "./escape-owner-CYnfySUl.js";
 import { t as T } from "./skeleton-DSdtr2qc.js";
 import { t as E } from "./react-node-text-Crkpfpco.js";
 import D, { memo as O, useCallback as ee, useEffect as k, useId as A, useImperativeHandle as j, useMemo as M, useRef as N, useState as P } from "react";

package/dist/code-editor.js

@@ -1,14 +1,14 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { a as t } from "./dist-lmHmz_bu.js";
-import { d as n, r, t as i, u as a } from "./toolbar-items-BFY_hns5.js";
-import { t as o } from "./use-material-translation-nNF8fUXz.js";
-import { i as s, n as c, o as l } from "./code-language-items-4zXlIEZ0.js";
-import { r as u, t as d } from "./field-blur-BcJH8H9B.js";
+import { d as n, r, t as i, u as a } from "./toolbar-items-DKfY_6AG.js";
+import { t as o } from "./use-material-translation-C_bAxfvp.js";
+import { i as s, n as c, o as l } from "./code-language-items-nP-pF7yH.js";
+import { r as u, t as d } from "./field-blur-Nid7-bt_.js";
 import { t as f } from "./skeleton-DSdtr2qc.js";
 import { t as p } from "./live-status-BGPaN8r8.js";
 import { t as m } from "./use-mobile-BDro060N.js";
 import { t as h } from "./react-node-text-Crkpfpco.js";
-import { a as g, c as _, d as v, f as y, i as b, l as x, m as S, o as C, p as w, r as T, s as E, t as D, u as O } from "./code-editor-DsLQeiZc.js";
+import { a as g, c as _, d as v, f as y, i as b, l as x, m as S, o as C, p as w, r as T, s as E, t as D, u as O } from "./code-editor-Bwzp2038.js";
 import { useEffect as k, useRef as A, useState as j } from "react";
 import { Fragment as M, jsx as N, jsxs as P } from "react/jsx-runtime";
 import { ChevronDown as F, ChevronUp as I, Columns2 as L } from "lucide-react";

package/dist/{code-language-items-4zXlIEZ0.js → code-language-items-nP-pF7yH.js}

@@ -1,5 +1,5 @@
-import { d as e, f as t } from "./dropdown-menu-CDN6Nqx6.js";
-import { t as n } from "./use-material-translation-nNF8fUXz.js";
+import { d as e, f as t } from "./dropdown-menu-C8PBmMIa.js";
+import { t as n } from "./use-material-translation-C_bAxfvp.js";
 import { t as r } from "./live-status-BGPaN8r8.js";
 import { useEffect as i, useRef as a, useState as o } from "react";
 import { jsx as s } from "react/jsx-runtime";

package/dist/components/components.css

@@ -134,6 +134,14 @@
 @import "./ui/display/period-cards/period-cards.css";
 @import "./ui/layout/sidebar/sidebar-tokens.css";
 @import "./ui/display/avatar/avatar.css";
+/* SeatRing: seats as a grid or on a circle by its own width. */
+@import "./ui/display/seat-ring/seat-ring.css";
+@import "./ui/display/seat-ring/seat-ring-index.css";
+@import "./ui/display/seat-ring/seat-ring-ring.css";
+/* VoteTally: ranked bars with counts, shares and voters. */
+@import "./ui/display/vote-tally/vote-tally.css";
+/* SecretCard: a face that is not rendered until it is revealed. */
+@import "./ui/display/secret-card/secret-card.css";
 /* Alert and Banner span the row in the form grids (#1497). */
 @import "./ui/feedback/alert/alert.css";
 @import "./ui/display/stat-card/stat-card.css";

package/dist/components/ui/display/seat-ring/seat-ring-index.css

@@ -0,0 +1,125 @@
+/* SeatRing: the seat count `--n` and the seat's index `--i`, from data
+ * attributes, for the circle's trigonometry (seat-ring-ring.css). Server
+ * markup carries no `style`. Up to 10 seats (RING_LIMIT); more is a grid. */
+@layer components {
+	.nxgt-seat-ring[data-count="1"] {
+		--n: 1;
+	}
+	.nxgt-seat-ring[data-count="2"] {
+		--n: 2;
+	}
+	.nxgt-seat-ring[data-count="3"] {
+		--n: 3;
+	}
+	.nxgt-seat-ring[data-count="4"] {
+		--n: 4;
+	}
+	.nxgt-seat-ring[data-count="5"] {
+		--n: 5;
+	}
+	.nxgt-seat-ring[data-count="6"] {
+		--n: 6;
+	}
+	.nxgt-seat-ring[data-count="7"] {
+		--n: 7;
+	}
+	.nxgt-seat-ring[data-count="8"] {
+		--n: 8;
+	}
+	.nxgt-seat-ring[data-count="9"] {
+		--n: 9;
+	}
+	.nxgt-seat-ring[data-count="10"] {
+		--n: 10;
+	}
+	.nxgt-seat-ring[data-count="11"] {
+		--n: 11;
+	}
+	.nxgt-seat-ring[data-count="12"] {
+		--n: 12;
+	}
+	.nxgt-seat-ring[data-count="13"] {
+		--n: 13;
+	}
+	.nxgt-seat-ring[data-count="14"] {
+		--n: 14;
+	}
+	.nxgt-seat-ring[data-count="15"] {
+		--n: 15;
+	}
+	.nxgt-seat-ring[data-count="16"] {
+		--n: 16;
+	}
+	.nxgt-seat-ring[data-count="17"] {
+		--n: 17;
+	}
+	.nxgt-seat-ring[data-count="18"] {
+		--n: 18;
+	}
+	.nxgt-seat-ring[data-count="19"] {
+		--n: 19;
+	}
+	.nxgt-seat-ring[data-count="20"] {
+		--n: 20;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="0"] {
+		--i: 0;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="1"] {
+		--i: 1;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="2"] {
+		--i: 2;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="3"] {
+		--i: 3;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="4"] {
+		--i: 4;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="5"] {
+		--i: 5;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="6"] {
+		--i: 6;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="7"] {
+		--i: 7;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="8"] {
+		--i: 8;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="9"] {
+		--i: 9;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="10"] {
+		--i: 10;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="11"] {
+		--i: 11;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="12"] {
+		--i: 12;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="13"] {
+		--i: 13;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="14"] {
+		--i: 14;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="15"] {
+		--i: 15;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="16"] {
+		--i: 16;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="17"] {
+		--i: 17;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="18"] {
+		--i: 18;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"][data-index="19"] {
+		--i: 19;
+	}
+}

package/dist/components/ui/display/seat-ring/seat-ring-ring.css

@@ -0,0 +1,87 @@
+/* SeatRing's circle: CSS trigonometry on `--i`, `--n` (seat-ring-index.css)
+ * and `--seat-dir` (-1 in a right-to-left box, so the ring is mirrored). The
+ * three container queries only switch `--ring-k` on the orbit once the box
+ * fits the seat size (32rem small, 38rem medium, 46rem large); every rule
+ * below reads it, as 0 (the grid of seat-ring.css) or 1 (the circle), so the
+ * circle's rules are written once. */
+@layer components {
+	@container seat-ring (min-width: 32rem) {
+		.nxgt-seat-ring[data-layout="ring"][data-size="sm"]
+			[data-slot="seat-ring-orbit"] {
+			--ring-k: 1;
+			--ring-abs: absolute;
+			--ring-block: block;
+			--ring-ratio: 1;
+			--ring-margin: auto;
+			--ring-size: min(
+				100%,
+				max(calc(var(--seat) * 3.2), calc(var(--seat) * (var(--n) * 0.6 + 1))),
+				56rem
+			);
+			--ring-w: var(--seat);
+		}
+	}
+	@container seat-ring (min-width: 38rem) {
+		.nxgt-seat-ring[data-layout="ring"][data-size="md"]
+			[data-slot="seat-ring-orbit"] {
+			--ring-k: 1;
+			--ring-abs: absolute;
+			--ring-block: block;
+			--ring-ratio: 1;
+			--ring-margin: auto;
+			--ring-size: min(
+				100%,
+				max(calc(var(--seat) * 3.2), calc(var(--seat) * (var(--n) * 0.6 + 1))),
+				56rem
+			);
+			--ring-w: var(--seat);
+		}
+	}
+	@container seat-ring (min-width: 46rem) {
+		.nxgt-seat-ring[data-layout="ring"][data-size="lg"]
+			[data-slot="seat-ring-orbit"] {
+			--ring-k: 1;
+			--ring-abs: absolute;
+			--ring-block: block;
+			--ring-ratio: 1;
+			--ring-margin: auto;
+			--ring-size: min(
+				100%,
+				max(calc(var(--seat) * 3.2), calc(var(--seat) * (var(--n) * 0.6 + 1))),
+				56rem
+			);
+			--ring-w: var(--seat);
+		}
+	}
+
+	.nxgt-seat-ring [data-slot="seat-ring-orbit"] {
+		position: relative;
+		display: var(--ring-block, flex);
+		inline-size: var(--ring-size, auto);
+		aspect-ratio: var(--ring-ratio, auto);
+		margin-inline: var(--ring-margin, 0);
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-list"] {
+		position: var(--ring-abs, static);
+		inset: 0;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-seat"] {
+		--a: calc(360deg * var(--i, 0) / var(--n, 1));
+		position: var(--ring-abs, relative);
+		inline-size: var(--ring-w, auto);
+		left: calc(
+			var(--ring-k, 0) *
+			(50% + (50% - var(--seat) / 2) * sin(var(--a)) * var(--seat-dir))
+		);
+		top: calc(
+			var(--ring-k, 0) *
+			(50% - (50% - var(--seat) / 2) * cos(var(--a)))
+		);
+		translate: calc(var(--ring-k, 0) * -50%) calc(var(--ring-k, 0) * -50%);
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-center"] {
+		position: var(--ring-abs, static);
+		/* The square inside the circle of seats: the orbit's radius less a seat and a half. */
+		inset: calc(50% - 0.5 * max(0px, 50% - 1.1 * var(--seat)));
+	}
+}

package/dist/components/ui/display/seat-ring/seat-ring.css

@@ -0,0 +1,139 @@
+/* SeatRing: seats as a grid of cards, or on a circle when the box is wide
+ * enough. The component is a size container, so the switch follows its own
+ * width (a column, a dialog, a phone), never the window. The ring is pure CSS
+ * (trigonometry on `--i`, the seat's index, and `--n`, their count, both set by
+ * the attribute rules below, so server markup carries no `style`). It holds up
+ * to 10 seats (RING_LIMIT); more is a grid. Selected: the primary tint, a
+ * border and a check mark, so colour is never the only cue. */
+@layer components {
+	.nxgt-seat-ring {
+		--seat: 6rem;
+		--seat-avatar: 2.5rem;
+		--seat-dir: 1;
+		container: seat-ring / inline-size;
+	}
+	.nxgt-seat-ring:dir(rtl) {
+		--seat-dir: -1;
+	}
+	.nxgt-seat-ring[data-size="sm"] {
+		--seat: 4.75rem;
+		--seat-avatar: 2rem;
+	}
+	.nxgt-seat-ring[data-size="lg"] {
+		--seat: 8rem;
+		--seat-avatar: 3.5rem;
+	}
+
+	.nxgt-seat-ring [data-slot="seat-ring-orbit"] {
+		display: flex;
+		flex-direction: column;
+		gap: 0.75rem;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-center"] {
+		order: -1;
+		display: grid;
+		place-items: center;
+		text-align: center;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-list"] {
+		display: grid;
+		grid-template-columns: repeat(
+				auto-fill,
+				minmax(min(var(--seat), 100%), 1fr)
+			);
+		gap: 0.5rem;
+		margin: 0;
+		padding: 0;
+		list-style: none;
+	}
+	@container seat-ring (max-width: 30rem) {
+		.nxgt-seat-ring [data-slot="seat-ring-list"] {
+			grid-template-columns: repeat(2, minmax(0, 1fr));
+		}
+	}
+
+	.nxgt-seat-ring [data-slot="seat-ring-seat"] {
+		position: relative;
+		display: flex;
+		flex-direction: column;
+		align-items: center;
+		gap: 0.25rem;
+		min-inline-size: 0;
+		min-block-size: 2.75rem;
+		padding: 0.5rem 0.375rem;
+		border: 1px solid var(--border);
+		border-radius: var(--radius-lg, 0.75rem);
+		background: var(--card, var(--background));
+		color: var(--foreground);
+		text-align: center;
+		transition:
+			background-color 150ms,
+			border-color 150ms;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-label"] {
+		max-inline-size: 100%;
+		overflow-wrap: anywhere;
+		font-size: 0.875rem;
+		font-weight: 500;
+		line-height: 1.25;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-badge"] {
+		position: absolute;
+		inset-block-start: -0.5rem;
+		inset-inline-end: 0.25rem;
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-mark"] {
+		position: absolute;
+		inset-block-start: 0.25rem;
+		inset-inline-start: 0.25rem;
+		display: grid;
+		inline-size: 1rem;
+		block-size: 1rem;
+		color: var(--primary-text, var(--primary));
+	}
+	.nxgt-seat-ring [data-slot="seat-ring-empty-circle"] {
+		inline-size: var(--seat-avatar);
+		block-size: var(--seat-avatar);
+		border: 2px dashed var(--border);
+		border-radius: 9999px;
+	}
+	.nxgt-seat-ring [data-empty] {
+		border-style: dashed;
+		background: transparent;
+	}
+	.nxgt-seat-ring [data-highlighted] {
+		border-color: var(--primary-indicator, var(--primary));
+		box-shadow: 0 0 0 2px var(--primary-indicator, var(--primary));
+	}
+	.nxgt-seat-ring [role="option"]:not([aria-disabled="true"]) {
+		cursor: pointer;
+	}
+	.nxgt-seat-ring [role="option"]:not([aria-disabled="true"]):hover {
+		background: color-mix(
+			in oklab,
+			var(--primary-text, var(--primary)) 8%,
+			var(--card, var(--background))
+		);
+	}
+	.nxgt-seat-ring [role="option"][aria-selected="true"] {
+		border-color: var(--primary-text, var(--primary));
+		background: color-mix(
+			in oklab,
+			var(--primary-text, var(--primary)) 12%,
+			var(--card, var(--background))
+		);
+	}
+	.nxgt-seat-ring [role="option"][aria-disabled="true"],
+	.nxgt-seat-ring [aria-disabled="true"] {
+		opacity: 0.6;
+	}
+	.nxgt-seat-ring [role="option"]:focus-visible {
+		outline: 2px solid var(--ring);
+		outline-offset: 2px;
+	}
+	@media (prefers-reduced-motion: reduce) {
+		.nxgt-seat-ring [data-slot="seat-ring-seat"] {
+			transition: none;
+		}
+	}
+}

package/dist/components/ui/display/secret-card/secret-card.css

@@ -0,0 +1,65 @@
+/* SecretCard: a card whose secret face is not rendered until it is revealed.
+ * It carries `data-tone`, so the tone's tokens resolve on it. The hidden face
+ * is a quiet diagonal pattern in the tone's ring colour. The card's border is
+ * that colour too (set by a utility class on the Card, which wins over the
+ * Card's own). A change flips the face in, never on mount, and only when the person has not asked for reduced motion. The card is
+ * full width up to a reading width and keeps the reveal button a 44px target
+ * on a phone. */
+@layer components {
+	.nxgt-secret-card {
+		width: 100%;
+		max-width: 28rem;
+		margin-inline: auto;
+		--secret-card-line: var(--nxgt-tone-ring, var(--border));
+		border-color: var(--secret-card-line);
+		perspective: 60rem;
+	}
+	.nxgt-secret-card [data-slot="secret-card-title"] {
+		display: flex;
+		align-items: center;
+		gap: 0.5rem;
+		color: var(--nxgt-tone-text, inherit);
+	}
+	.nxgt-secret-card [data-slot="secret-card-pattern"] {
+		min-height: 6rem;
+		border-radius: 0.5rem;
+		border: 1px dashed var(--secret-card-line);
+		background-image: repeating-linear-gradient(
+			45deg,
+			color-mix(in oklab, var(--secret-card-line) 25%, transparent) 0 0.5rem,
+			transparent 0.5rem 1rem
+		);
+	}
+	.nxgt-secret-card [data-slot="secret-card-back"] {
+		min-height: 6rem;
+		display: grid;
+		place-items: center;
+		text-align: center;
+		overflow-wrap: anywhere;
+		font-size: 1.25rem;
+		font-weight: 600;
+		user-select: text;
+	}
+	.nxgt-secret-card [data-slot="secret-card-actions"] {
+		flex-wrap: wrap;
+		gap: 0.5rem;
+	}
+	.nxgt-secret-card [data-slot="secret-card-actions"] > button {
+		min-height: 44px;
+	}
+	@media (prefers-reduced-motion: no-preference) {
+		.nxgt-secret-card [data-slot="secret-card-face"][data-changed] {
+			animation: nxgt-secret-flip 0.35s ease-out;
+		}
+	}
+	@keyframes nxgt-secret-flip {
+		from {
+			opacity: 0;
+			transform: rotateY(90deg);
+		}
+		to {
+			opacity: 1;
+			transform: rotateY(0);
+		}
+	}
+}