@12-apps/ui 6.40.0 → 6.41.1

package/dist/types/components/form/Autocomplete/useAutocomplete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAutocomplete.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Autocomplete/useAutocomplete.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,KAAK,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzD,8DAA8D;AAC9D,UAAU,iBAAiB,CAAC,CAAC;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,EAAE,CAAC,EAAE,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAClD,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAClD;AAoND,gEAAgE;AAChE,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC5B,kBAAkB,EAAE,CAAC,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,kBAAkB,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC9D,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAChE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAiE/E"}
+{"version":3,"file":"useAutocomplete.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Autocomplete/useAutocomplete.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,KAAK,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzD,8DAA8D;AAC9D,UAAU,iBAAiB,CAAC,CAAC;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,EAAE,CAAC,EAAE,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC;;;;;;;OAOG;IACH,qBAAqB,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAChD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAClD,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAClD;AAyOD,gEAAgE;AAChE,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC5B,kBAAkB,EAAE,CAAC,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,kBAAkB,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC9D,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAChE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAiE/E"}

package/dist/types/components/form/Input/Input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAyGhD,eAAO,MAAM,KAAK,qFAsEjB,CAAC"}
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAyGhD,eAAO,MAAM,KAAK,qFAwEjB,CAAC"}

package/dist/types/components/form/Input/Input.types.d.ts

@@ -1,3 +1,4 @@
+import type { InputBaseComponentProps } from '@mui/material/InputBase/index.js';
 import type { InputLabelProps as MuiInputLabelProps } from '@mui/material/InputLabel/index.js';
 import type { InputHTMLAttributes } from 'react';
 import type React from 'react';
@@ -26,5 +27,14 @@ export interface InputProps extends InputBaseProps, Omit<InputHTMLAttributes<HTM
      * the TYPE was missing, so it failed to compile. FUT-729.
      */
     InputLabelProps?: Partial<MuiInputLabelProps>;
+    /**
+     * Attributes for the `<input>` element itself. Anything else this component
+     * does not recognise lands on the text field's ROOT `<div>`, where
+     * `inputMode`, `pattern`, `role` and `aria-value*` do nothing. Merged, not
+     * spread over: the field's own `data-testid` stays the default a caller can
+     * override, and the ARIA it builds from `aria-label` / `aria-describedby` /
+     * `aria-busy` still lands last.
+     */
+    inputProps?: InputBaseComponentProps;
 }
 //# sourceMappingURL=Input.types.d.ts.map

package/dist/types/components/form/Input/Input.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Input.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,WAAW,UACf,SAAQ,cAAc,EACpB,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,cAAc,CAAC;IACtF,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/C"}
+{"version":3,"file":"Input.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,WAAW,UACf,SAAQ,cAAc,EACpB,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,cAAc,CAAC;IACtF,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9C;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC"}

package/dist/types/components/form/NumberField/NumberField.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { NumberFieldProps } from './NumberField.types';
+/**
+ * A digits-only number input whose value is a `number | null`.
+ *
+ * - `inputMode="numeric"` on the `<input>` itself, so a phone opens its number
+ *   pad (the attribute does nothing anywhere else — see `Input.types.ts`).
+ * - A non-digit keystroke never reaches the field, and a paste keeps only its
+ *   digits: `"1.500 min"` pastes as `1500`.
+ * - `suffix` is drawn inside the field's border, and read as its description.
+ * - ArrowUp / ArrowDown move by `step`, never past `min` / `max`. Typing may go
+ *   out of bounds for a moment (typing `5` on the way to `50` must not snap to a
+ *   minimum of 10); the blur brings it back inside.
+ * - Clearing the field reports `null`, not `0` and not `NaN`.
+ *
+ * `role="spinbutton"` with `aria-valuenow` / `-min` / `-max`, because that is
+ * what the arrow keys make it — a screen reader then says so, and says where
+ * in the range the value sits.
+ */
+export declare const NumberField: React.ForwardRefExoticComponent<NumberFieldProps & React.RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=NumberField.d.ts.map

package/dist/types/components/form/NumberField/NumberField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberField.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/NumberField/NumberField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6B,MAAM,OAAO,CAAC;AAKlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,2FA6DtB,CAAC"}

package/dist/types/components/form/NumberField/NumberField.helpers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The pure half of `NumberField`: what a keystroke may add, what a string of
+ * digits is worth, and where an arrow key lands. Kept apart from the component
+ * so every rule is a plain function a unit test can hold.
+ */
+/**
+ * The most digits the field keeps. Fifteen is the longest run that is always
+ * a safe integer (`Number.MAX_SAFE_INTEGER` has sixteen, but not every
+ * sixteen-digit number is below it), so a pasted serial number can never turn
+ * into a rounded float.
+ */
+export declare const MAX_DIGITS = 15;
+export interface NumberBounds {
+    min?: number;
+    max?: number;
+}
+/** Everything that is not a digit, removed; then cut to {@link MAX_DIGITS}. */
+export declare function digitsOf(raw: string): string;
+/**
+ * What the field's text is worth. An empty field is `null` — never `0`, and
+ * never `NaN` — so "cleared" and "zero" stay two different answers.
+ */
+export declare function parseDigits(raw: string): number | null;
+/** The text a value shows as. */
+export declare function formatValue(value: number | null): string;
+/** `value`, held inside whichever bounds are set. */
+export declare function clamp(value: number, { min, max }: NumberBounds): number;
+/**
+ * Where ArrowUp (`+1`) or ArrowDown (`-1`) takes the value.
+ *
+ * From empty, either arrow lands on the floor (`min`, else 0) rather than
+ * stepping past it: the first press says "give me a number", and the floor is
+ * the only one both directions agree on.
+ */
+export declare function stepValue(value: number | null, direction: 1 | -1, step: number, bounds: NumberBounds): number;
+/**
+ * A key that would type a character the field refuses. Shortcuts (Ctrl/Cmd +
+ * a letter — copy, paste, select all) and the named keys (`Backspace`,
+ * `ArrowLeft`, `Tab`) are left alone: only a single printable character that
+ * is not a digit is blocked.
+ */
+export declare function isRefusedKey(event: {
+    key: string;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    altKey: boolean;
+}): boolean;
+//# sourceMappingURL=NumberField.helpers.d.ts.map

package/dist/types/components/form/NumberField/NumberField.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberField.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/NumberField/NumberField.helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtD;AAED,iCAAiC;AACjC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAExD;AAED,qDAAqD;AACrD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,YAAY,GAAG,MAAM,CAIvE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,GACnB,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAGV"}

package/dist/types/components/form/NumberField/NumberField.types.d.ts

@@ -0,0 +1,31 @@
+import type { ReactNode } from 'react';
+import type { InputProps } from '../Input/Input.types';
+/**
+ * What `NumberField` takes over from `Input`: the value and its change are
+ * numbers here, not strings, and the element's type, keyboard and trailing
+ * slot are the field's own.
+ */
+type OwnedInputProps = 'value' | 'defaultValue' | 'onChange' | 'type' | 'inputMode' | 'pattern' | 'min' | 'max' | 'step' | 'endAdornment' | 'maxLength';
+export interface NumberFieldProps extends Omit<InputProps, OwnedInputProps> {
+    /** The value. `null` is an empty field — never `0`, never `NaN`. */
+    value: number | null;
+    /** Every edit, as the number it now reads, or `null` once cleared. */
+    onChange: (value: number | null) => void;
+    /**
+     * The lowest value ArrowDown reaches, and what a blur raises a smaller one
+     * to. Digits only, so the field never holds a negative number whatever this
+     * says.
+     */
+    min?: number;
+    /** The highest value ArrowUp reaches, and what a blur lowers a larger one to. */
+    max?: number;
+    /** How far one ArrowUp / ArrowDown moves the value. Defaults to 1. */
+    step?: number;
+    /**
+     * The unit, drawn INSIDE the field's border at its end — "min", "%", "kg".
+     * Also read to screen readers as part of the field's description.
+     */
+    suffix?: ReactNode;
+}
+export {};
+//# sourceMappingURL=NumberField.types.d.ts.map

package/dist/types/components/form/NumberField/NumberField.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberField.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/NumberField/NumberField.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;GAIG;AACH,KAAK,eAAe,GAChB,OAAO,GACP,cAAc,GACd,UAAU,GACV,MAAM,GACN,WAAW,GACX,SAAS,GACT,KAAK,GACL,KAAK,GACL,MAAM,GACN,cAAc,GACd,WAAW,CAAC;AAEhB,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;IACzE,oEAAoE;IACpE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sEAAsE;IACtE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB"}

package/dist/types/components/form/NumberField/index.d.ts

@@ -0,0 +1,3 @@
+export { NumberField } from './NumberField';
+export type { NumberFieldProps } from './NumberField.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/form/NumberField/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/NumberField/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types/components/form/index.d.ts

@@ -12,6 +12,7 @@ export * from './Input';
 export * from './InputOTP';
 export * from './Label';
 export * from './Menubar';
+export * from './NumberField';
 export * from './PasswordStrength';
 export * from './PhoneInput';
 export * from './RadioGroup';

package/dist/types/components/form/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/form/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/form/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/types/components/layout/SettingCard/SettingCard.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { SettingCardProps } from './SettingCard.types';
+/**
+ * A setting, summarised while closed and edited in place.
+ *
+ * Closed: title, status pill, a one-line summary and Edit. Edit opens the card
+ * where it is — no dialog, no route — around the host's form, a "learn more"
+ * disclosure and Cancel / Save. Save may be async: the card holds its saving
+ * state while the promise is pending, closes when it resolves, and stays open
+ * with the error when it rejects. Focus moves into the card as it opens and
+ * back to Edit as it closes.
+ */
+export declare const SettingCard: React.ForwardRefExoticComponent<SettingCardProps & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=SettingCard.d.ts.map

package/dist/types/components/layout/SettingCard/SettingCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingCard.d.ts","sourceRoot":"","sources":["../../../../../src/components/layout/SettingCard/SettingCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAQjD,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA+G7E;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,sFAgEtB,CAAC"}

package/dist/types/components/layout/SettingCard/SettingCard.hooks.d.ts

@@ -0,0 +1,79 @@
+import { type RefObject } from 'react';
+import type { SettingCardProps, SettingErrorFormatter, SettingSaveResult } from './SettingCard.types';
+/** The sentence a rejected save shows: the host's, else the copy's fallback. */
+export declare function saveErrorMessage(error: unknown, formatError: SettingErrorFormatter | undefined, fallback: string): string;
+/**
+ * Open state that is controlled when `open` is passed and uncontrolled
+ * otherwise — the shape MUI's own `useControlled` has, without its dev-only
+ * warnings reaching into this package's surface.
+ */
+export declare function useControllableOpen(open: boolean | undefined, defaultOpen: boolean, onOpenChange: ((open: boolean) => void) | undefined): [boolean, (next: boolean) => void];
+/**
+ * Runs a save that may or may not be async and reports how it went.
+ *
+ * `Promise.resolve().then(save)` rather than `await save()`: it also catches a
+ * handler that throws SYNCHRONOUSLY, which an `await` inside `try` would too —
+ * but it keeps the pending state visible for one tick even when the handler
+ * returns nothing, so a save never "succeeds" in the middle of the click that
+ * started it. A sequence id drops the outcome of a run the card has since
+ * abandoned (closed, or started again).
+ */
+export declare function useSaveRunner(formatError: SettingErrorFormatter | undefined, fallback: string): {
+    saving: boolean;
+    error: string | null;
+    run: (save: () => SettingSaveResult) => Promise<boolean>;
+    reset: () => void;
+};
+/**
+ * A switch that saves the moment it flips.
+ *
+ * It shows the flip at once (`pending`) and holds it while the save runs; a
+ * success hands back to the host's `checked`, which by then says the same
+ * thing, and a failure drops `pending` so the switch returns to what is
+ * actually saved. A flip while one is in flight is ignored rather than queued:
+ * two racing writes of a boolean have no right answer.
+ */
+export declare function useAsyncSwitch(options: {
+    checked: boolean;
+    onChange: (checked: boolean) => SettingSaveResult;
+    formatError: SettingErrorFormatter | undefined;
+    fallback: string;
+}): {
+    shown: boolean;
+    saving: boolean;
+    error: string | null;
+    flip: (next: boolean) => Promise<void>;
+};
+/**
+ * Focus follows the card: into it when it opens, back to the trigger when it
+ * closes.
+ *
+ * Inward, it is the Dialog's own rule (`focusFirstTabbable`, FUT-2696): the
+ * first tabbable descendant, and a caller's `autoFocus` keeps winning. The
+ * card is NOT a trap — it is inline, the rest of the page is still there, and
+ * locking Tab inside it would strand a keyboard user who wants to leave
+ * mid-edit. What it owes them is the round trip: the Edit trigger unmounts
+ * while the card is open, so without the return focus would fall to <body>
+ * and the reader would start again from the top of the page.
+ *
+ * Only a TRANSITION moves focus: a card mounted open (or closed) leaves focus
+ * where the page put it.
+ */
+export declare function useFocusHandoff(open: boolean, body: RefObject<HTMLElement | null>, trigger: RefObject<HTMLElement | null>): void;
+/**
+ * Everything an editable card DOES, apart from how it looks: its open state,
+ * the save and its outcome, Cancel, and where focus goes.
+ */
+export declare function useSettingCard(props: SettingCardProps): {
+    open: boolean;
+    disabled: boolean;
+    saveDisabled: boolean;
+    saving: boolean;
+    error: string | null;
+    bodyRef: RefObject<HTMLDivElement | null>;
+    editRef: RefObject<HTMLButtonElement | null>;
+    openCard: () => void;
+    cancel: () => void;
+    save: () => void;
+};
+//# sourceMappingURL=SettingCard.hooks.d.ts.map

package/dist/types/components/layout/SettingCard/SettingCard.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingCard.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/components/layout/SettingCard/SettingCard.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlG,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEtG,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,WAAW,EAAE,OAAO,EACpB,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,GAClD,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,CAcpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM;;;gBAc7E,MAAM,iBAAiB,KAAG,OAAO,CAAC,OAAO,CAAC;;EA0B1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,iBAAiB,CAAC;IAClD,WAAW,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;;;;iBAMgB,OAAO;EAUvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACnC,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GACrC,IAAI,CASN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB;;;;;;;;;;;EAgCrD"}

package/dist/types/components/layout/SettingCard/SettingCard.metrics.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The setting-card family's lengths, in design px. The web reads every one
+ * through `rem(theme, n)`, so they scale with the host's type scale.
+ */
+export declare const SETTING_CARD: {
+    /** Between the icon and the title. */
+    readonly iconGap: 12;
+    /** The spinner beside a switch while its flip is saving. */
+    readonly spinnerSize: 16;
+    /** How far a group's dependent rows sit in from its main switch. */
+    readonly groupIndent: 24;
+    /** The rule down the left of a group's dependent rows. */
+    readonly groupRuleWidth: 2;
+    /** The narrowest a grid column gets by default. */
+    readonly gridMinColumnWidth: 320;
+};
+/** The grid's default gap, in theme SPACING units (not px): what `sx`'s `gap: 2` means. */
+export declare const SETTING_GRID_GAP_UNITS = 2;
+/** How faded a group's dependent rows are while the main switch is off. */
+export declare const SETTING_GROUP_INACTIVE_OPACITY = 0.5;
+//# sourceMappingURL=SettingCard.metrics.d.ts.map

package/dist/types/components/layout/SettingCard/SettingCard.metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingCard.metrics.d.ts","sourceRoot":"","sources":["../../../../../src/components/layout/SettingCard/SettingCard.metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,sCAAsC;;IAEtC,4DAA4D;;IAE5D,oEAAoE;;IAEpE,0DAA0D;;IAE1D,mDAAmD;;CAE3C,CAAC;AAEX,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,2EAA2E;AAC3E,eAAO,MAAM,8BAA8B,MAAM,CAAC"}

package/dist/types/components/layout/SettingCard/SettingCard.parts.d.ts

@@ -0,0 +1,49 @@
+import React from 'react';
+import type { SettingHeadingLevel, SettingStatus } from './SettingCard.types';
+/** `<root>-<part>` when the host gave a root test id, else nothing. */
+export declare const partTestId: (root: string | undefined, part: string) => string | undefined;
+interface HeaderProps {
+    titleId: string;
+    title: string;
+    headingLevel: SettingHeadingLevel;
+    icon?: React.ReactNode;
+    status?: SettingStatus;
+    /** Rendered at the row's far end — the Edit trigger, or a switch. */
+    trailing?: React.ReactNode;
+    /** Renders the title as a `<label>` for this control instead of a heading. */
+    labelFor?: string;
+    dataTestId?: string;
+}
+/**
+ * Icon, title, status pill, and whatever the row ends with.
+ *
+ * A switch card's title is the switch's `<label>`, so the words are both its
+ * accessible name and a tap target far larger than the track. An editable
+ * card's title is a heading, so the page outline lists every setting.
+ */
+export declare const SettingHeader: React.FC<HeaderProps>;
+/**
+ * The failure line. `role="alert"` so it is announced the moment it appears,
+ * without anyone having to move focus to find it.
+ */
+export declare const SaveError: React.FC<{
+    id: string;
+    message: string | null;
+    dataTestId?: string;
+}>;
+/** The spinner that rides beside a pending control; decorative — the words are announced separately. */
+export declare const PendingSpinner: React.FC<{
+    dataTestId?: string;
+}>;
+/**
+ * The "learn more" disclosure: a text button that owns `aria-expanded`, and
+ * the collapsible region it controls. Closed by default — it is the longer
+ * explanation, and the form is what the reader came for.
+ */
+export declare const LearnMore: React.FC<{
+    label: string;
+    children: React.ReactNode;
+    dataTestId?: string;
+}>;
+export {};
+//# sourceMappingURL=SettingCard.parts.d.ts.map

package/dist/types/components/layout/SettingCard/SettingCard.parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingCard.parts.d.ts","sourceRoot":"","sources":["../../../../../src/components/layout/SettingCard/SettingCard.parts.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA0B,MAAM,OAAO,CAAC;AAW/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,uEAAuE;AACvE,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SACvC,CAAC;AAEvC,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,mBAAmB,CAAC;IAClC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAyC/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAY3F,CAAC;AAEF,wGAAwG;AACxG,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAU5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAsCA,CAAC"}

package/dist/types/components/layout/SettingCard/SettingCard.styles.d.ts

@@ -0,0 +1,48 @@
+import type { CSSObject, SxProps, Theme } from '@mui/material/styles/index.js';
+/**
+ * The attribute an open `SettingCard` carries, which `SettingGrid` reads to
+ * give it the whole row. An attribute rather than a class so a host's wrapper
+ * around the card can be matched with `:has()` as well.
+ */
+export declare const SETTING_CARD_OPEN_ATTR = "data-setting-card-open";
+/** `sx` as MUI documents it for composition: the component's own first, the caller's after. */
+export declare const withCallerSx: (own: SxProps<Theme>, sx: SxProps<Theme> | undefined) => SxProps<Theme>;
+/**
+ * The card surface — `Card`'s outlined hairline and medium radius, so a
+ * settings screen and a content screen are drawn with one kit.
+ *
+ * `height: 100%` is what turns the grid's per-row stretch into equal-height
+ * cards: a grid item stretches, but a card that sized itself to its content
+ * would not fill the item it sits in.
+ *
+ * `gridColumn: 1 / -1` while open is the full-row span. It lives on the card,
+ * not only in the grid's CSS, so it also holds when the card sits in a host's
+ * own grid. Outside a grid the property does nothing.
+ */
+export declare const surfaceStyles: (theme: Theme, open: boolean) => CSSObject;
+/** A `row` toggle: the card's content with none of its surface. */
+export declare const flatStyles: (theme: Theme) => CSSObject;
+export declare const headerStyles: (theme: Theme) => CSSObject;
+/**
+ * The title names its colour rather than inheriting it: a card rendered under
+ * a theme other than the page's (a dark panel on a light page) would otherwise
+ * take the page's text colour onto its own surface.
+ */
+export declare const titleStyles: (theme: Theme) => CSSObject;
+/** The one line a closed card shows. Long values end in an ellipsis, not a second line. */
+export declare const summaryStyles: (theme: Theme) => CSSObject;
+/** A switch card's explanation, which may wrap: it is read, not scanned. */
+export declare const descriptionStyles: (theme: Theme) => CSSObject;
+/** The inactive group's hint: a glyph and the sentence, so it does not read as a second summary. */
+export declare const hintStyles: (theme: Theme) => CSSObject;
+export declare const errorStyles: (theme: Theme) => CSSObject;
+export declare const actionsStyles: (theme: Theme) => CSSObject;
+export declare const iconStyles: (theme: Theme) => CSSObject;
+/**
+ * A group's dependent rows: indented under the main switch, with a rule down
+ * their left edge so the "belongs to" reads without words. While the main
+ * switch is off they fade — and `inert` (set by the component) is what makes
+ * them unreachable; opacity alone would only make them look it.
+ */
+export declare const dependentsStyles: (theme: Theme, active: boolean) => CSSObject;
+//# sourceMappingURL=SettingCard.styles.d.ts.map

package/dist/types/components/layout/SettingCard/SettingCard.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingCard.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/layout/SettingCard/SettingCard.styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAO/E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,+FAA+F;AAC/F,eAAO,MAAM,YAAY,GACvB,KAAK,OAAO,CAAC,KAAK,CAAC,EACnB,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,KAC7B,OAAO,CAAC,KAAK,CAAgE,CAAC;AAEjF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,EAAE,MAAM,OAAO,KAAG,SAgB1D,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,KAAG,SAMxC,CAAC;AAEH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,KAAG,SAK1C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,KAAG,SAOzC,CAAC;AAEH,2FAA2F;AAC3F,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAO3C,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,GAAI,OAAO,KAAK,KAAG,SAI/C,CAAC;AAEH,oGAAoG;AACpG,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,KAAG,SAOxC,CAAC;AAEH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,KAAG,SAIzC,CAAC;AAEH,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAM3C,CAAC;AAEH,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,KAAG,SAIxC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,KAAK,EAAE,QAAQ,OAAO,KAAG,SAQ/D,CAAC"}

package/dist/types/components/layout/SettingCard/SettingCard.types.d.ts

@@ -0,0 +1,127 @@
+import type { SxProps, Theme } from '@mui/material/styles/index.js';
+import type { ReactNode } from 'react';
+import type { SettingCardCopy, SettingSwitchCopy } from '../../../copy';
+import type { ColorValue } from '../../../tokens/vocabulary';
+export type { SettingCardCopy, SettingSwitchCopy } from '../../../copy';
+/**
+ * What a save handler may return. A promise holds the card in its saving
+ * state until it settles; a rejection is the failure path. A plain return is
+ * a synchronous success.
+ */
+export type SettingSaveResult = void | Promise<unknown>;
+/**
+ * Turns whatever a rejected save threw into the sentence the card shows.
+ * Return `undefined` to fall back to the copy's `saveFailed`. The card never
+ * renders an `Error.message` on its own: that string is usually written for a
+ * developer, in the developer's language.
+ */
+export type SettingErrorFormatter = (error: unknown) => string | undefined;
+/** The heading level a card's title renders at, so it fits the page outline. */
+export type SettingHeadingLevel = 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+/** The pill beside a closed card's title: the setting's current state, in words. */
+export interface SettingStatus {
+    /** What the state IS, in the host's language: "On", "Not configured". */
+    label: string;
+    /** A house colour. Colour is never the only carrier: `label` is always shown. Defaults to `neutral`. */
+    color?: ColorValue;
+}
+/** What every card in the family shares. */
+interface SettingSurfaceProps {
+    /** The setting's name. Also the accessible name of the card's region. */
+    title: string;
+    /** The heading level of `title`. Defaults to `h3`. */
+    headingLevel?: SettingHeadingLevel;
+    /** A decorative glyph before the title. */
+    icon?: ReactNode;
+    /** Maps a rejected save to the sentence shown; see {@link SettingErrorFormatter}. */
+    formatError?: SettingErrorFormatter;
+    /** Root test id. Parts derive theirs from it (`<id>-edit`, `<id>-save`, …). */
+    dataTestId?: string;
+    className?: string;
+    sx?: SxProps<Theme>;
+}
+export interface SettingCardProps extends SettingSurfaceProps {
+    /** The chrome words (Edit, Cancel, Save, …). REQUIRED — no default copy. */
+    copy: SettingCardCopy;
+    /** The one line a closed card shows under its title: the setting's current value. */
+    summary?: ReactNode;
+    /** The pill beside the title. Omit for none. */
+    status?: SettingStatus;
+    /** The form, rendered only while the card is open (so an uncontrolled draft is discarded on close). */
+    children: ReactNode;
+    /** Longer explanation behind a "learn more" disclosure in the open card. Omit for no disclosure. */
+    learnMore?: ReactNode;
+    /**
+     * Persist the draft. The card stays in its saving state while a returned
+     * promise is pending, closes when it resolves, and STAYS OPEN showing the
+     * error when it rejects.
+     */
+    onSave: () => SettingSaveResult;
+    /** The card closed without saving — reset the host's draft here. */
+    onCancel?: () => void;
+    /** Controlled open state. Pair with `onOpenChange`. */
+    open?: boolean;
+    /** Uncontrolled initial open state. */
+    defaultOpen?: boolean;
+    /** Every open/close request: Edit, Cancel, Escape, and a successful save. */
+    onOpenChange?: (open: boolean) => void;
+    /** Disables Edit on a closed card (the setting cannot be changed from here). */
+    disabled?: boolean;
+    /** Disables Save — for a draft the host knows is invalid. */
+    saveDisabled?: boolean;
+}
+interface SettingSwitchProps extends SettingSurfaceProps {
+    /** The saving and failure words. REQUIRED — no default copy. */
+    copy: SettingSwitchCopy;
+    /** Explanation under the title. Read to screen readers as the switch's description. */
+    summary?: ReactNode;
+    /** The persisted value. The switch shows the flip optimistically while it saves, then this again. */
+    checked: boolean;
+    /**
+     * Persist a flip. The switch shows the new value and a saving state while a
+     * returned promise is pending; a rejection reverts it and shows the error.
+     */
+    onChange: (checked: boolean) => SettingSaveResult;
+    /** Disables the switch. */
+    disabled?: boolean;
+}
+/**
+ * `card` draws the surface; `row` draws the same content flat, for a
+ * dependent row inside a `SettingGroup` (a card inside a card reads as two
+ * subjects).
+ */
+export type SettingToggleVariant = 'card' | 'row';
+export interface SettingToggleProps extends SettingSwitchProps {
+    /** Defaults to `card`. */
+    variant?: SettingToggleVariant;
+}
+export interface SettingGroupProps extends SettingSwitchProps {
+    /**
+     * Why the dependent rows are inactive while the main switch is off —
+     * "Turn on notifications to choose which ones you get". Shown only then.
+     */
+    inactiveHint: string;
+    /** The dependent rows. Stay rendered while the main switch is off, dimmed and inert. */
+    children: ReactNode;
+}
+/** The most columns a `SettingGrid` lays out. */
+export type SettingGridColumns = 1 | 2 | 3;
+export interface SettingGridProps {
+    children: ReactNode;
+    /**
+     * The narrowest a column may get, in design px (scaled with the type
+     * scale). The grid adds a column each time its OWN width fits one more.
+     * Defaults to 320.
+     */
+    minColumnWidth?: number;
+    /** Defaults to 3. */
+    maxColumns?: SettingGridColumns;
+    /** Gap between cards, in theme spacing units. Defaults to 2. */
+    gap?: number;
+    /** Accessible name. When set the grid renders as a labelled `region`. */
+    'aria-label'?: string;
+    dataTestId?: string;
+    className?: string;
+    sx?: SxProps<Theme>;
+}
+//# sourceMappingURL=SettingCard.types.d.ts.map

package/dist/types/components/layout/SettingCard/SettingCard.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingCard.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/layout/SettingCard/SettingCard.types.ts"],"names":[],"mappings":"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"}

package/dist/types/components/layout/SettingCard/SettingGrid.d.ts

@@ -0,0 +1,33 @@
+import { type CSSObject, type Theme } from '@mui/material/styles/index.js';
+import type { SettingGridColumns, SettingGridProps } from './SettingCard.types';
+/** The container the grid's own queries are asked of. Named, so a nested grid answers to its own. */
+export declare const SETTING_GRID_CONTAINER = "setting-grid";
+/**
+ * The grid itself.
+ *
+ * - Columns come from CONTAINER queries, not viewport ones: a settings grid
+ *   lives beside a rail, inside a drawer, in half a split view, and the
+ *   viewport says nothing about how wide any of those are.
+ * - `grid-auto-rows: auto` with `align-items: stretch` is the equal-height
+ *   rule: each row is as tall as its tallest card and every card in it
+ *   stretches to match. Not `1fr` rows — those would make EVERY row as tall as
+ *   the tallest, so one open card would inflate the whole page.
+ * - An open card spans the row. The card sets `grid-column` on itself; the
+ *   `:has()` rule covers a card the host wrapped in an element of its own.
+ */
+export interface SettingGridLayout {
+    /** The narrowest column, in DESIGN px (drawn through `rem`). */
+    minColumnPx: number;
+    maxColumns: SettingGridColumns;
+    /** The gap, in theme SPACING units. */
+    gapUnits: number;
+}
+export declare function settingGridStyles(theme: Theme, { minColumnPx, maxColumns, gapUnits }: SettingGridLayout): CSSObject;
+/**
+ * Lays setting cards out in one, two or three columns by the width it is
+ * GIVEN — see {@link settingGridStyles}. Two elements, because a container
+ * query is answered by an ANCESTOR: the outer one is the container, the inner
+ * one the grid.
+ */
+export declare const SettingGrid: import("react").ForwardRefExoticComponent<SettingGridProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=SettingGrid.d.ts.map

package/dist/types/components/layout/SettingCard/SettingGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingGrid.d.ts","sourceRoot":"","sources":["../../../../../src/components/layout/SettingCard/SettingGrid.tsx"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAQrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAarD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAgBnH;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,6GAgCtB,CAAC"}

package/dist/types/components/layout/SettingCard/SettingGroup.context.d.ts

@@ -0,0 +1,13 @@
+/**
+ * What a `SettingGroup` tells the rows inside it: whether its main switch is
+ * off. `inert` on the rows' container already makes every descendant
+ * unreachable; this is for the family's own rows (`SettingToggle`) to ALSO
+ * draw and announce themselves as disabled, which `inert` does not do.
+ */
+export declare const SettingGroupContext: import("react").Context<{
+    inactive: boolean;
+}>;
+export declare const useSettingGroup: () => {
+    inactive: boolean;
+};
+//# sourceMappingURL=SettingGroup.context.d.ts.map

package/dist/types/components/layout/SettingCard/SettingGroup.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingGroup.context.d.ts","sourceRoot":"","sources":["../../../../../src/components/layout/SettingCard/SettingGroup.context.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;cAA6B,OAAO;EAAwB,CAAC;AAE7F,eAAO,MAAM,eAAe,QAAO;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAqC,CAAC"}