@eifi1/ui-kit 0.12.0 → 0.13.0

package/dist/rhf/fields.js

@@ -43,6 +43,7 @@ function RhfField({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   render,
   asControl = true,
@@ -55,10 +56,18 @@ function RhfField({
       control,
       name,
       rules,
-      disabled,
+      disabled: excludeWhenDisabled ? disabled : void 0,
       render: ({ field, fieldState }) => /* @__PURE__ */ jsxs(FormItem, { className, children: [
         showLabel && hasContent(label) && /* @__PURE__ */ jsx(RhfLabel, { required, children: label }),
-        /* @__PURE__ */ jsx(ControlSlot, { field, fieldState, render, asControl }),
+        /* @__PURE__ */ jsx(
+          ControlSlot,
+          {
+            field: disabled && !field.disabled ? { ...field, disabled: true } : field,
+            fieldState,
+            render,
+            asControl
+          }
+        ),
         hasContent(hint) && /* @__PURE__ */ jsx(FormDescription, { children: hint }),
         message && /* @__PURE__ */ jsx(FormMessage, {})
       ] })
@@ -82,13 +91,14 @@ function RhfTextField({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   ...inputProps
 }) {
   return /* @__PURE__ */ jsx(
     RhfField,
     {
-      ...{ name, control, rules, label, hint, required, disabled, className },
+      ...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className },
       render: ({ field, invalid }) => /* @__PURE__ */ jsx(
         Input,
         {
@@ -114,6 +124,7 @@ function RhfTextarea({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   inputClassName,
   ...areaProps
@@ -121,7 +132,7 @@ function RhfTextarea({
   return /* @__PURE__ */ jsx(
     RhfField,
     {
-      ...{ name, control, rules, label, hint, required, disabled, className },
+      ...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className },
       render: ({ field, invalid }) => /* @__PURE__ */ jsx(
         Textarea,
         {
@@ -153,6 +164,7 @@ function RhfNumberField({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   emptyValue = null,
   nullable = true,
@@ -161,7 +173,7 @@ function RhfNumberField({
   return /* @__PURE__ */ jsx(
     RhfField,
     {
-      ...{ name, control, rules, label, hint, required, disabled, className },
+      ...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className },
       render: ({ field, invalid, id }) => (
         // FormControl clones this element with `id` / `aria-describedby` /
         // `aria-invalid`, which NumberControl hands on to the field.
@@ -211,6 +223,17 @@ function NumberControl({
     }
   );
 }
+function RhfIntegerField(props) {
+  return /* @__PURE__ */ jsx(
+    RhfNumberField,
+    {
+      ...props,
+      digits: props.digits ?? 0,
+      calculator: props.calculator ?? false,
+      emptyValue: props.emptyValue === void 0 ? "" : props.emptyValue
+    }
+  );
+}
 function parseAmount(text) {
   const trimmed = text.trim();
   if (trimmed === "") return null;
@@ -281,13 +304,14 @@ function RhfMoneyField({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   ...amountProps
 }) {
   return /* @__PURE__ */ jsx(
     RhfField,
     {
-      ...{ name, control, rules, label, hint, required, disabled, className },
+      ...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className },
       asControl: false,
       render: ({ field, invalid, id, describedBy }) => /* @__PURE__ */ jsx(
         MoneyControl,
@@ -341,6 +365,7 @@ function RhfDateField({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   inputClassName,
   emptyValue = "",
@@ -349,7 +374,7 @@ function RhfDateField({
   return /* @__PURE__ */ jsx(
     RhfField,
     {
-      ...{ name, control, rules, label, hint, required, disabled, className },
+      ...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className },
       render: ({ field, invalid, id }) => (
         // FormControl clones this element with `aria-describedby` / `aria-invalid`,
         // which DateControl hands on to the picker's trigger.
@@ -377,6 +402,7 @@ function RhfSelect({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   options,
   children,
@@ -388,7 +414,7 @@ function RhfSelect({
   return /* @__PURE__ */ jsx(
     RhfField,
     {
-      ...{ name, control, rules, label, hint, required, disabled, className },
+      ...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className },
       render: ({ field, invalid }) => /* @__PURE__ */ jsxs(
         Select,
         {
@@ -422,13 +448,14 @@ function RhfCheckbox({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   ...boxProps
 }) {
   return /* @__PURE__ */ jsx(
     RhfField,
     {
-      ...{ name, control, rules, required, disabled, className },
+      ...{ name, control, rules, required, disabled, excludeWhenDisabled, className },
       showLabel: false,
       render: ({ field, invalid }) => /* @__PURE__ */ jsx(
         Checkbox,
@@ -495,6 +522,7 @@ function RhfCombobox({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   clearValue = null,
   comboClassName,
@@ -503,7 +531,7 @@ function RhfCombobox({
   return /* @__PURE__ */ jsx(
     RhfField,
     {
-      ...{ name, control, rules, label, hint, required, disabled, className },
+      ...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className },
       asControl: false,
       message: false,
       render: ({ field, invalid, error, id, describedBy }) => /* @__PURE__ */ jsx(
@@ -531,6 +559,7 @@ function RhfTextCombobox({
   hint,
   required,
   disabled,
+  excludeWhenDisabled,
   className,
   comboClassName,
   ...comboProps
@@ -538,7 +567,7 @@ function RhfTextCombobox({
   return /* @__PURE__ */ jsx(
     RhfField,
     {
-      ...{ name, control, rules, label, hint, required, disabled, className },
+      ...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className },
       asControl: false,
       message: false,
       render: ({ field, invalid, error, id, describedBy }) => /* @__PURE__ */ jsx(
@@ -591,6 +620,7 @@ export {
   RhfCombobox,
   RhfDateField,
   RhfField,
+  RhfIntegerField,
   RhfMoneyField,
   RhfNumberField,
   RhfSelect,

package/dist/rhf/fields.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/rhf/fields.tsx"],"sourcesContent":["/**\n * Bound fields: one line per field of a react-hook-form form. `@eifi1/ui-kit/rhf`.\n *\n * ```tsx\n * <Form {...form}>\n *   <RhfTextField name=\"name\" label=\"Name\" hint=\"As on the lease\" required\n *     rules={{ required: \"Enter a name\" }} />\n *   <RhfMoneyField name=\"rent\" label=\"Net rent\" currency=\"CHF\" />\n *   <RhfDateField name=\"start\" label=\"Start\" />\n *   <RhfSelect name=\"type\" label=\"Type\" options={TYPES} />\n *   <RhfCombobox name=\"tenantId\" label=\"Tenant\" options={tenants} clearable />\n *   <RhfCheckbox name=\"isDefault\" label=\"Default account\" />\n * </Form>\n * ```\n *\n * Each folds the `FormField → FormItem → FormLabel → FormControl → field →\n * FormDescription → FormMessage` scaffold (see ./form) into one element, the way\n * kastlan's shared/components/form/fields.tsx does for its forms — with what that file\n * left out:\n *\n *  - **The red border.** Every field gets `invalid` from the field state, so an errored\n *    field PAINTS as well as announces. kastlan's number, money, date and entity fields\n *    passed only `aria-invalid` through `FormControl`, or nothing, and `Input`, `Select`\n *    and `Textarea` paint only from the prop (see the note in ./form).\n *  - **Focus on error.** `field.ref` reaches the focusable element — the element itself\n *    where the kit field forwards a ref, a focus handle on it where it does not (the\n *    number field, the pickers) — so `handleSubmit` and `trigger(…, { shouldFocus })`\n *    land the caret on the first field in error.\n *  - **`control` is optional**: under `<Form {...form}>` the fields find the form\n *    through react-hook-form's context. Pass it for the field's value types\n *    (`control={form.control}` checks `name` against the form's values).\n *\n * The common props: `name`, `control`, `label` (a {@link FormLabel} above the field;\n * omitted, none — then give the field an `aria-label`), `hint` (standing advice under\n * the field, attached to it with `aria-describedby`), `required` (the label's mark,\n * and `aria-required` where the control takes it — validation is `rules`' or the\n * resolver's), `rules`, `disabled`, and `className` for the item's box.\n *\n * {@link RhfField} is the shell they are all built on, for a control the kit does not\n * ship (an address autocomplete): it takes a `render` and wires the rest.\n */\nimport { useLayoutEffect, useRef, useState, type ReactElement, type ReactNode } from \"react\";\nimport type {\n  ControllerFieldState,\n  ControllerProps,\n  ControllerRenderProps,\n  FieldPath,\n  FieldValues,\n} from \"react-hook-form\";\nimport { FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, useFormField } from \"./form\";\nimport { Input, Select, Textarea, type InputProps, type SelectProps, type TextareaProps } from \"../components/ui\";\nimport { NumberField, type NumberFieldProps } from \"../components/number-field\";\nimport { AmountInput } from \"../components/amount-input\";\nimport { DatePicker, type DatePickerProps } from \"../components/date-picker\";\nimport { Checkbox, type CheckboxProps } from \"../components/checkbox\";\nimport { EntityCombobox, type EntityComboboxProps } from \"../components/entity-combobox\";\nimport { Combobox, type ComboboxProps } from \"../components/combobox\";\nimport type { ComboClearValue } from \"../components/combobox-core\";\nimport { cn } from \"../lib/cn\";\n\n// ── the shell ────────────────────────────────────────────────────────────────\n\n/** What every bound field takes. */\nexport interface RhfFieldBaseProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> {\n  name: TName;\n  /** `form.control`. Optional under `<Form {...form}>`; pass it to type-check `name`. */\n  control?: ControllerProps<TFieldValues, TName, TTransformed>[\"control\"];\n  /** react-hook-form's `rules` (`required`, `min`, `validate` …). */\n  rules?: ControllerProps<TFieldValues, TName, TTransformed>[\"rules\"];\n  /** A {@link FormLabel} above the field. Omitted: no label — name the control with\n   *  an `aria-label` instead. */\n  label?: ReactNode;\n  /** Standing advice under the field (\"As printed on the card\"), attached to the\n   *  control with `aria-describedby`. */\n  hint?: ReactNode;\n  /** Draws the label's required mark and sets `aria-required` where the control\n   *  takes it. Whether the field IS required is `rules`' or the resolver's to say. */\n  required?: boolean;\n  /** Disables the field — through react-hook-form, so its value is left out of the\n   *  submitted values as a disabled input's would be. */\n  disabled?: boolean;\n  /** Classes for the item's box (a `grid gap-1`). */\n  className?: string;\n}\n\n/** What {@link RhfField}'s `render` receives. */\nexport interface RhfFieldRenderContext<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n> {\n  field: ControllerRenderProps<TFieldValues, TName>;\n  fieldState: ControllerFieldState;\n  /** The field has an error: pass it to the control's `invalid` so it paints. */\n  invalid: boolean;\n  /** The error's message, if any. */\n  error: string | undefined;\n  /** The control's id, which the label points at. `FormControl` sets it on the\n   *  rendered element already; this is for a control that routes it elsewhere. */\n  id: string;\n  /** The label's id, for a control that is named with `aria-labelledby`. */\n  labelId: string;\n  /** The ids of the rendered hint and message, if any. */\n  describedBy: string | undefined;\n}\n\nexport interface RhfFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> extends RhfFieldBaseProps<TFieldValues, TName, TTransformed> {\n  /** The control. Wrapped in {@link FormControl} (its `id`, `aria-describedby` and\n   *  `aria-invalid`) unless `asControl` is false. */\n  render: (ctx: RhfFieldRenderContext<TFieldValues, TName>) => ReactElement;\n  /** `false`: render the control as is, for one that wires its own ids from the\n   *  context. Default `true`. */\n  asControl?: boolean;\n  /** `false`: no {@link FormMessage}, for a control that renders its own error (its\n   *  `error` prop). Default `true`. */\n  message?: boolean;\n  /** `false`: no {@link FormLabel}, for a control that carries its label itself (a\n   *  checkbox). Default `true`. */\n  showLabel?: boolean;\n}\n\nfunction hasContent(node: ReactNode): boolean {\n  return node !== undefined && node !== null && node !== false && node !== \"\";\n}\n\n/** The label, with an id the control can be named by. Inside the item, so it can read\n *  the item's id. */\nfunction RhfLabel({ required, children }: { required?: boolean; children: ReactNode }) {\n  const { id } = useFormField();\n  return (\n    <FormLabel id={`${id}-label`} required={required}>\n      {children}\n    </FormLabel>\n  );\n}\n\nfunction ControlSlot<TFieldValues extends FieldValues, TName extends FieldPath<TFieldValues>>({\n  field,\n  fieldState,\n  render,\n  asControl,\n}: {\n  field: ControllerRenderProps<TFieldValues, TName>;\n  fieldState: ControllerFieldState;\n  render: RhfFieldProps<TFieldValues, TName>[\"render\"];\n  asControl: boolean;\n}) {\n  const { id, formItemId, describedBy } = useFormField();\n  const element = render({\n    field,\n    fieldState,\n    invalid: fieldState.invalid,\n    error: fieldState.error?.message,\n    id: formItemId,\n    labelId: `${id}-label`,\n    describedBy,\n  });\n  return asControl ? <FormControl>{element}</FormControl> : element;\n}\n\n/**\n * The shell every bound field is built on: label, control, hint and message around\n * a `render` of your own.\n *\n * ```tsx\n * <RhfField name=\"address\" label=\"Address\" render={({ field, invalid }) => (\n *   <AddressAutocomplete value={field.value ?? \"\"} onChange={field.onChange} invalid={invalid} />\n * )} />\n * ```\n */\nexport function RhfField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  render,\n  asControl = true,\n  message = true,\n  showLabel = true,\n}: RhfFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <FormField\n      control={control}\n      name={name}\n      rules={rules}\n      disabled={disabled}\n      render={({ field, fieldState }) => (\n        <FormItem className={className}>\n          {showLabel && hasContent(label) && <RhfLabel required={required}>{label}</RhfLabel>}\n          <ControlSlot field={field} fieldState={fieldState} render={render} asControl={asControl} />\n          {hasContent(hint) && <FormDescription>{hint}</FormDescription>}\n          {message && <FormMessage />}\n        </FormItem>\n      )}\n    />\n  );\n}\n\n/**\n * Hands react-hook-form a focus handle for a control that forwards no ref: its\n * `shouldFocusError` calls `focus()` on whatever `field.ref` was given. `find` runs at\n * focus time, so it sees the element as it is then.\n */\nfunction useFocusHandle(ref: ControllerRenderProps[\"ref\"], find: () => HTMLElement | null | undefined) {\n  const findRef = useRef(find);\n  useLayoutEffect(() => {\n    findRef.current = find;\n  });\n  useLayoutEffect(() => {\n    ref({ focus: () => findRef.current()?.focus() });\n  }, [ref]);\n}\n\n// ── text ─────────────────────────────────────────────────────────────────────\n\ntype OwnInputProps = Omit<\n  InputProps,\n  \"name\" | \"value\" | \"defaultValue\" | \"onChange\" | \"onBlur\" | \"ref\" | \"label\" | \"error\" | \"invalid\" | \"className\" | \"disabled\" | \"required\"\n>;\n\nexport type RhfTextFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> & OwnInputProps;\n\n/** A text {@link Input} — `type` for email, tel, password, url. Stores the string. */\nexport function RhfTextField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  ...inputProps\n}: RhfTextFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, className }}\n      render={({ field, invalid }) => (\n        <Input\n          aria-required={required || undefined}\n          {...inputProps}\n          name={field.name}\n          ref={field.ref}\n          value={(field.value ?? \"\") as string}\n          onChange={field.onChange}\n          onBlur={field.onBlur}\n          disabled={field.disabled}\n          invalid={invalid}\n        />\n      )}\n    />\n  );\n}\n\ntype OwnTextareaProps = Omit<\n  TextareaProps,\n  \"name\" | \"value\" | \"defaultValue\" | \"onChange\" | \"onBlur\" | \"ref\" | \"label\" | \"error\" | \"invalid\" | \"className\" | \"disabled\" | \"required\"\n> & {\n  /** Classes for the `<textarea>`. */\n  inputClassName?: string;\n};\n\nexport type RhfTextareaProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> & OwnTextareaProps;\n\n/** A multi-line {@link Textarea}; takes `rows`. Stores the string. */\nexport function RhfTextarea<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  inputClassName,\n  ...areaProps\n}: RhfTextareaProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, className }}\n      render={({ field, invalid }) => (\n        <Textarea\n          aria-required={required || undefined}\n          {...areaProps}\n          className={inputClassName}\n          name={field.name}\n          ref={field.ref}\n          value={(field.value ?? \"\") as string}\n          onChange={field.onChange}\n          onBlur={field.onBlur}\n          disabled={field.disabled}\n          invalid={invalid}\n        />\n      )}\n    />\n  );\n}\n\n// ── numbers ──────────────────────────────────────────────────────────────────\n\n/** A form value → the number field's `number | null`. Defaults hold `\"\"`, `null`, a\n *  number, or a numeric string. */\nfunction toNumber(value: unknown): number | null {\n  if (value === null || value === undefined || value === \"\") return null;\n  const n = typeof value === \"number\" ? value : Number(String(value).replace(\",\", \".\"));\n  return Number.isFinite(n) ? n : null;\n}\n\nexport type RhfNumberFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<\n    NumberFieldProps,\n    | \"digits\"\n    | \"min\"\n    | \"max\"\n    | \"step\"\n    | \"calculator\"\n    | \"unit\"\n    | \"unitPlacement\"\n    | \"placeholder\"\n    | \"inputClassName\"\n    | \"locale\"\n    | \"ariaLabel\"\n    | \"autoFocus\"\n  > & {\n    /** What an emptied field stores. Default `null`; `\"\"` for a schema written\n     *  against a native number input (`z.coerce.number()` over `\"\"`). */\n    emptyValue?: null | \"\";\n    /** `false`: an emptied field snaps back to its last number instead of storing\n     *  `emptyValue`. Default `true`. */\n    nullable?: boolean;\n  };\n\n/**\n * The kit's {@link NumberField}: a parsed, rounded (`digits`) and clamped (`min` /\n * `max`) number, committed on blur or Enter in the locale's decimal mark. Stores a\n * number, or `emptyValue` when emptied.\n */\nexport function RhfNumberField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  emptyValue = null,\n  nullable = true,\n  ...numberProps\n}: RhfNumberFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, className }}\n      render={({ field, invalid, id }) => (\n        // FormControl clones this element with `id` / `aria-describedby` /\n        // `aria-invalid`, which NumberControl hands on to the field.\n        <NumberControl\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          id={id}\n          emptyValue={emptyValue}\n          nullable={nullable}\n          numberProps={numberProps}\n        />\n      )}\n    />\n  );\n}\n\nfunction NumberControl({\n  field,\n  invalid,\n  required,\n  id,\n  emptyValue,\n  nullable,\n  numberProps,\n  ...aria\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  id: string;\n  emptyValue: null | \"\";\n  nullable: boolean;\n  numberProps: Omit<RhfNumberFieldProps, keyof RhfFieldBaseProps | \"emptyValue\" | \"nullable\">;\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: NumberFieldProps[\"aria-invalid\"];\n}) {\n  // NumberField forwards no ref; it routes `id` to its <input>, where the handle\n  // finds it.\n  useFocusHandle(field.ref, () => document.getElementById(id));\n  return (\n    <NumberField\n      {...numberProps}\n      aria-describedby={aria[\"aria-describedby\"]}\n      aria-invalid={aria[\"aria-invalid\"]}\n      aria-required={required || undefined}\n      id={id}\n      value={toNumber(field.value)}\n      onCommit={(n) => {\n        field.onChange(n ?? emptyValue);\n        field.onBlur();\n      }}\n      nullable={nullable}\n      disabled={field.disabled}\n      invalid={invalid}\n    />\n  );\n}\n\n// ── money ────────────────────────────────────────────────────────────────────\n\nexport type RhfMoneyFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> & {\n  placeholder?: string;\n  /** The currency chip's code (\"CHF\"). */\n  currency?: string;\n  /** Makes the chip a currency picker. Bind it to another field with\n   *  `useController`, or to state. */\n  onCurrencyChange?: (code: string) => void;\n  /** Colours the figure for the direction of money. */\n  tone?: \"neutral\" | \"outflow\" | \"inflow\";\n  align?: \"start\" | \"center\";\n  ariaLabel?: string;\n  autoFocus?: boolean;\n  /**\n   * What the form stores: `\"number\"` (default) — `12.5`, or `emptyValue` while the\n   * field is empty — or `\"string\"`, the field's own text (\"12.50\") for a schema that\n   * parses it itself. A half-typed sum (\"12+\") leaves the stored number as it was\n   * until it resolves.\n   */\n  valueAs?: \"number\" | \"string\";\n  /** What an emptied field stores when `valueAs` is `\"number\"`. Default `null`. */\n  emptyValue?: null | \"\";\n};\n\n/** The amount a text reads as, or `undefined` for a draft that is not one yet. */\nfunction parseAmount(text: string): number | null | undefined {\n  const trimmed = text.trim();\n  if (trimmed === \"\") return null;\n  if (!/^-?\\d*[.,]?\\d*$/.test(trimmed)) return undefined;\n  const n = Number(trimmed.replace(\",\", \".\"));\n  return Number.isFinite(n) ? n : undefined;\n}\n\nfunction MoneyControl({\n  field,\n  invalid,\n  required,\n  id,\n  describedBy,\n  props,\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  id: string;\n  describedBy: string | undefined;\n  props: Omit<RhfMoneyFieldProps, keyof RhfFieldBaseProps>;\n}) {\n  const { valueAs = \"number\", emptyValue = null, ariaLabel, ...amountProps } = props;\n  const value: unknown = field.value;\n  const external = value === null || value === undefined ? \"\" : String(value);\n  // The text being typed. A stored NUMBER cannot hold \"12.\" or \"12+5\", so the draft\n  // lives here and is re-read from the form only when the form's value moves away\n  // from what the draft already says (a reset, a setValue).\n  const [draft, setDraft] = useState(external);\n  const [seen, setSeen] = useState<unknown>(value);\n  if (seen !== value) {\n    setSeen(value);\n    const current = valueAs === \"string\" ? draft : parseAmount(draft);\n    const same = valueAs === \"string\" ? current === external : current === toNumber(value);\n    if (!same) setDraft(external);\n  }\n  const input = useRef<HTMLInputElement | null>(null);\n  // AmountInput reports no blur, and react-hook-form needs one to mark the field\n  // touched: listen on its <input>.\n  const onBlur = field.onBlur;\n  useLayoutEffect(() => {\n    const el = input.current;\n    if (!el) return;\n    el.addEventListener(\"blur\", onBlur);\n    return () => el.removeEventListener(\"blur\", onBlur);\n  }, [onBlur]);\n  return (\n    <div>\n      <AmountInput\n        {...amountProps}\n        ariaLabel={ariaLabel}\n        id={id}\n        aria-describedby={describedBy}\n        aria-required={required || undefined}\n        ref={(el) => {\n          input.current = el;\n          field.ref(el);\n        }}\n        value={draft}\n        disabled={field.disabled}\n        invalid={invalid}\n        onChange={(text) => {\n          setDraft(text);\n          if (valueAs === \"string\") {\n            field.onChange(text);\n            return;\n          }\n          const parsed = parseAmount(text);\n          if (parsed === undefined) return;\n          field.onChange(parsed ?? emptyValue);\n        }}\n      />\n    </div>\n  );\n}\n\n/**\n * The kit's {@link AmountInput}: a money figure with its currency chip and the\n * calculator (\"1200+80\" resolves on blur or Enter). Stores a number by default — see\n * `valueAs`.\n */\nexport function RhfMoneyField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  ...amountProps\n}: RhfMoneyFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, className }}\n      asControl={false}\n      render={({ field, invalid, id, describedBy }) => (\n        <MoneyControl\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          id={id}\n          describedBy={describedBy}\n          props={amountProps}\n        />\n      )}\n    />\n  );\n}\n\n// ── date ─────────────────────────────────────────────────────────────────────\n\nexport type RhfDateFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Omit<DatePickerProps, \"value\" | \"onChange\" | \"label\" | \"invalid\" | \"disabled\" | \"className\" | \"id\"> & {\n    /** Classes for the picker. Default `w-full`. */\n    inputClassName?: string;\n    /** What a cleared date stores. Default `\"\"`, the empty ISO string; `null` for a\n     *  nullable schema. */\n    emptyValue?: \"\" | null;\n  };\n\nfunction DateControl({\n  field,\n  invalid,\n  required,\n  id,\n  emptyValue,\n  inputClassName,\n  pickerProps,\n  ...aria\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  id: string;\n  emptyValue: \"\" | null;\n  inputClassName?: string;\n  pickerProps: Omit<DatePickerProps, \"value\" | \"onChange\" | \"label\" | \"invalid\" | \"disabled\" | \"className\" | \"id\">;\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: DatePickerProps[\"aria-invalid\"];\n}) {\n  useFocusHandle(field.ref, () => document.getElementById(id));\n  const value: unknown = field.value;\n  return (\n    <DatePicker\n      {...pickerProps}\n      {...aria}\n      aria-required={required || undefined}\n      id={id}\n      value={typeof value === \"string\" ? value : \"\"}\n      onChange={(iso) => {\n        field.onChange(iso === \"\" ? emptyValue : iso);\n        field.onBlur();\n      }}\n      disabled={field.disabled}\n      invalid={invalid}\n      className={inputClassName ?? \"w-full\"}\n    />\n  );\n}\n\n/** The kit's {@link DatePicker}, holding an ISO `\"YYYY-MM-DD\"` string. */\nexport function RhfDateField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  inputClassName,\n  emptyValue = \"\",\n  ...pickerProps\n}: RhfDateFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, className }}\n      render={({ field, invalid, id }) => (\n        // FormControl clones this element with `aria-describedby` / `aria-invalid`,\n        // which DateControl hands on to the picker's trigger.\n        <DateControl\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          id={id}\n          emptyValue={emptyValue}\n          inputClassName={inputClassName}\n          pickerProps={pickerProps}\n        />\n      )}\n    />\n  );\n}\n\n// ── select ───────────────────────────────────────────────────────────────────\n\nexport interface RhfSelectOption {\n  value: string | number;\n  label: ReactNode;\n  disabled?: boolean;\n}\n\nexport type RhfSelectProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<SelectProps, \"size\" | \"autoFocus\" | \"aria-label\"> & {\n    /** The options, as data. Or pass `<option>` children. */\n    options?: readonly RhfSelectOption[];\n    children?: ReactNode;\n    /** A first, empty option (\"Choose…\"), selected while the value is empty. */\n    placeholder?: string;\n    /** Store `Number(value)` rather than the option's string. An empty choice still\n     *  stores `\"\"`. */\n    valueAsNumber?: boolean;\n    /** Classes for the select. Default `w-full`. */\n    selectClassName?: string;\n  };\n\n/** A native {@link Select}, from `options` or `<option>` children. */\nexport function RhfSelect<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  options,\n  children,\n  placeholder,\n  valueAsNumber,\n  selectClassName,\n  ...selectProps\n}: RhfSelectProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, className }}\n      render={({ field, invalid }) => (\n        <Select\n          aria-required={required || undefined}\n          {...selectProps}\n          className={cn(\"w-full\", selectClassName)}\n          name={field.name}\n          ref={field.ref}\n          value={(field.value ?? \"\") as string | number}\n          onChange={(e) => {\n            const raw = e.target.value;\n            field.onChange(valueAsNumber && raw !== \"\" ? Number(raw) : raw);\n          }}\n          onBlur={field.onBlur}\n          disabled={field.disabled}\n          invalid={invalid}\n        >\n          {placeholder !== undefined && <option value=\"\">{placeholder}</option>}\n          {options\n            ? options.map((o) => (\n                <option key={String(o.value)} value={o.value} disabled={o.disabled}>\n                  {o.label}\n                </option>\n              ))\n            : children}\n        </Select>\n      )}\n    />\n  );\n}\n\n// ── checkbox ─────────────────────────────────────────────────────────────────\n\nexport type RhfCheckboxProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<CheckboxProps, \"inputClassName\" | \"autoFocus\" | \"aria-label\">;\n\n/**\n * The kit's {@link Checkbox}, label beside the box and `hint` under it (the\n * checkbox's own `description`). Stores a boolean. `required` is the native one here\n * — see Checkbox — so a `<form>` refuses to submit it unticked.\n */\nexport function RhfCheckbox<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  ...boxProps\n}: RhfCheckboxProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, required, disabled, className }}\n      showLabel={false}\n      render={({ field, invalid }) => (\n        <Checkbox\n          {...boxProps}\n          ref={field.ref}\n          name={field.name}\n          checked={Boolean(field.value)}\n          onCheckedChange={field.onChange}\n          onBlur={field.onBlur}\n          disabled={field.disabled}\n          required={required}\n          invalid={invalid}\n          label={label}\n          description={hint}\n        />\n      )}\n    />\n  );\n}\n\n// ── comboboxes ───────────────────────────────────────────────────────────────\n\nexport type RhfComboboxProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  V extends string | number = string | number,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<\n    EntityComboboxProps<V>,\n    | \"options\"\n    | \"loadOptions\"\n    | \"loading\"\n    | \"placeholder\"\n    | \"searchPlaceholder\"\n    | \"emptyLabel\"\n    | \"clearable\"\n    | \"clearLabel\"\n    | \"onCreate\"\n    | \"createLabel\"\n    | \"filter\"\n    | \"minChars\"\n    | \"debounceMs\"\n  > & {\n    /** What a clear stores — the picker's `clearValue`. Default `null`; `\"\"` for a\n     *  schema that spells \"no choice\" as an empty string. */\n    clearValue?: ComboClearValue;\n    /** Classes for the picker. */\n    comboClassName?: string;\n  };\n\nfunction EntityControl<V extends string | number>({\n  field,\n  invalid,\n  required,\n  error,\n  id,\n  describedBy,\n  clearValue,\n  comboClassName,\n  comboProps,\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  error: string | undefined;\n  id: string;\n  describedBy: string | undefined;\n  clearValue: ComboClearValue;\n  comboClassName?: string;\n  comboProps: Omit<RhfComboboxProps<FieldValues, string, V>, keyof RhfFieldBaseProps | \"clearValue\" | \"comboClassName\">;\n}) {\n  const box = useRef<HTMLDivElement>(null);\n  // EntityCombobox puts `id` and the ARIA below on its trigger, so the label's\n  // `htmlFor` names it, the hint describes it and the focus handle finds it by id.\n  useFocusHandle(field.ref, () => document.getElementById(id));\n  // EntityCombobox reports no blur: focus leaving the picker marks the field touched.\n  const onBlur = field.onBlur;\n  useLayoutEffect(() => {\n    const el = box.current;\n    if (!el) return;\n    el.addEventListener(\"focusout\", onBlur);\n    return () => el.removeEventListener(\"focusout\", onBlur);\n  }, [onBlur]);\n  const value: unknown = field.value;\n  return (\n    <div ref={box}>\n      <EntityCombobox<V, ComboClearValue>\n        {...comboProps}\n        className={comboClassName}\n        id={id}\n        aria-describedby={describedBy}\n        aria-required={required || undefined}\n        value={(value ?? null) as V | ComboClearValue | null}\n        clearValue={clearValue}\n        onChange={(v) => field.onChange(v)}\n        disabled={field.disabled}\n        invalid={invalid}\n        // Its own message, which it merges into the trigger's aria-describedby after\n        // the hint.\n        error={error}\n      />\n    </div>\n  );\n}\n\n/**\n * The kit's {@link EntityCombobox}: an id-keyed pick from `options` or `loadOptions`.\n * Stores the option's `value`, or `clearValue` on a clear (only offered with\n * `clearable`).\n */\nexport function RhfCombobox<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  V extends string | number = string | number,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  clearValue = null,\n  comboClassName,\n  ...comboProps\n}: RhfComboboxProps<TFieldValues, TName, V, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, className }}\n      asControl={false}\n      message={false}\n      render={({ field, invalid, error, id, describedBy }) => (\n        <EntityControl<V>\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          error={error}\n          id={id}\n          describedBy={describedBy}\n          clearValue={clearValue}\n          comboClassName={comboClassName}\n          comboProps={comboProps}\n        />\n      )}\n    />\n  );\n}\n\nexport type RhfTextComboboxProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<\n    ComboboxProps,\n    | \"options\"\n    | \"placeholder\"\n    | \"groupBy\"\n    | \"maxSuggestions\"\n    | \"searchPlaceholder\"\n    | \"createLabel\"\n    | \"optionAdornment\"\n    | \"autoFocus\"\n    | \"aria-label\"\n  > & {\n    /** Classes for the combobox. */\n    comboClassName?: string;\n  };\n\n/**\n * The kit's free-text {@link Combobox}: type anything, or pick one of `options`.\n * Stores the string.\n */\nexport function RhfTextCombobox<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  className,\n  comboClassName,\n  ...comboProps\n}: RhfTextComboboxProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, className }}\n      asControl={false}\n      message={false}\n      render={({ field, invalid, error, id, describedBy }) => (\n        <TextComboControl\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          error={error}\n          id={id}\n          describedBy={describedBy}\n          className={comboClassName}\n          comboProps={comboProps}\n        />\n      )}\n    />\n  );\n}\n\nfunction TextComboControl({\n  field,\n  invalid,\n  required,\n  error,\n  id,\n  describedBy,\n  className,\n  comboProps,\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  error: string | undefined;\n  id: string;\n  describedBy: string | undefined;\n  className?: string;\n  comboProps: Omit<RhfTextComboboxProps, keyof RhfFieldBaseProps | \"comboClassName\">;\n}) {\n  // The combobox routes `id` and its ARIA to its <input>, so the label's `htmlFor`\n  // names it, the hint describes it and the focus handle finds it; the error is its\n  // own `error` prop, which it merges in after the hint.\n  useFocusHandle(field.ref, () => document.getElementById(id));\n  const value: unknown = field.value;\n  return (\n    <Combobox\n      {...comboProps}\n      id={id}\n      aria-describedby={describedBy}\n      aria-required={required || undefined}\n      className={className}\n      value={typeof value === \"string\" ? value : value == null ? \"\" : String(value)}\n      onChange={field.onChange}\n      onBlur={field.onBlur}\n      disabled={field.disabled}\n      invalid={invalid}\n      error={error}\n    />\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/rhf/fields.tsx"],"sourcesContent":["/**\n * Bound fields: one line per field of a react-hook-form form. `@eifi1/ui-kit/rhf`.\n *\n * ```tsx\n * <Form {...form}>\n *   <RhfTextField name=\"name\" label=\"Name\" hint=\"As on the lease\" required\n *     rules={{ required: \"Enter a name\" }} />\n *   <RhfMoneyField name=\"rent\" label=\"Net rent\" currency=\"CHF\" />\n *   <RhfDateField name=\"start\" label=\"Start\" />\n *   <RhfSelect name=\"type\" label=\"Type\" options={TYPES} />\n *   <RhfCombobox name=\"tenantId\" label=\"Tenant\" options={tenants} clearable />\n *   <RhfCheckbox name=\"isDefault\" label=\"Default account\" />\n * </Form>\n * ```\n *\n * Each folds the `FormField → FormItem → FormLabel → FormControl → field →\n * FormDescription → FormMessage` scaffold (see ./form) into one element, the way\n * kastlan's shared/components/form/fields.tsx does for its forms — with what that file\n * left out:\n *\n *  - **The red border.** Every field gets `invalid` from the field state, so an errored\n *    field PAINTS as well as announces. kastlan's number, money, date and entity fields\n *    passed only `aria-invalid` through `FormControl`, or nothing, and `Input`, `Select`\n *    and `Textarea` paint only from the prop (see the note in ./form).\n *  - **Focus on error.** `field.ref` reaches the focusable element — the element itself\n *    where the kit field forwards a ref, a focus handle on it where it does not (the\n *    number field, the pickers) — so `handleSubmit` and `trigger(…, { shouldFocus })`\n *    land the caret on the first field in error.\n *  - **`control` is optional**: under `<Form {...form}>` the fields find the form\n *    through react-hook-form's context. Pass it for the field's value types\n *    (`control={form.control}` checks `name` against the form's values).\n *\n * The common props: `name`, `control`, `label` (a {@link FormLabel} above the field;\n * omitted, none — then give the field an `aria-label`), `hint` (standing advice under\n * the field, attached to it with `aria-describedby`), `required` (the label's mark,\n * and `aria-required` where the control takes it — validation is `rules`' or the\n * resolver's), `rules`, `disabled` (the control only — the value is still submitted;\n * `excludeWhenDisabled` for react-hook-form's drop-the-value semantics), and\n * `className` for the item's box.\n *\n * {@link RhfField} is the shell they are all built on, for a control the kit does not\n * ship (an address autocomplete): it takes a `render` and wires the rest.\n */\nimport { useLayoutEffect, useRef, useState, type ReactElement, type ReactNode } from \"react\";\nimport type {\n  ControllerFieldState,\n  ControllerProps,\n  ControllerRenderProps,\n  FieldPath,\n  FieldValues,\n} from \"react-hook-form\";\nimport { FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, useFormField } from \"./form\";\nimport { Input, Select, Textarea, type InputProps, type SelectProps, type TextareaProps } from \"../components/ui\";\nimport { NumberField, type NumberFieldProps } from \"../components/number-field\";\nimport { AmountInput } from \"../components/amount-input\";\nimport { DatePicker, type DatePickerProps } from \"../components/date-picker\";\nimport { Checkbox, type CheckboxProps } from \"../components/checkbox\";\nimport { EntityCombobox, type EntityComboboxProps } from \"../components/entity-combobox\";\nimport { Combobox, type ComboboxProps } from \"../components/combobox\";\nimport type { ComboClearValue } from \"../components/combobox-core\";\nimport { cn } from \"../lib/cn\";\n\n// ── the shell ────────────────────────────────────────────────────────────────\n\n/** What every bound field takes. */\nexport interface RhfFieldBaseProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> {\n  name: TName;\n  /** `form.control`. Optional under `<Form {...form}>`; pass it to type-check `name`. */\n  control?: ControllerProps<TFieldValues, TName, TTransformed>[\"control\"];\n  /** react-hook-form's `rules` (`required`, `min`, `validate` …). */\n  rules?: ControllerProps<TFieldValues, TName, TTransformed>[\"rules\"];\n  /** A {@link FormLabel} above the field. Omitted: no label — name the control with\n   *  an `aria-label` instead. */\n  label?: ReactNode;\n  /** Standing advice under the field (\"As printed on the card\"), attached to the\n   *  control with `aria-describedby`. */\n  hint?: ReactNode;\n  /** Draws the label's required mark and sets `aria-required` where the control\n   *  takes it. Whether the field IS required is `rules`' or the resolver's to say. */\n  required?: boolean;\n  /** Disables the control and KEEPS the value: a field locked to a preset (a lease's\n   *  preselected unit, a fixed period) still submits it, and `rules` still run.\n   *  react-hook-form's own Controller `disabled` drops the value from `handleSubmit`'s\n   *  data instead, which a locked preset must never do (kastlan, 0.12). To get that,\n   *  add `excludeWhenDisabled`. A form-wide `useForm({ disabled })` still disables\n   *  every field the RHF way. */\n  disabled?: boolean;\n  /** With `disabled`: disable through react-hook-form, so the value is left out of\n   *  the submitted data and validation skips it, like a disabled native input in a\n   *  plain form post. Default `false`. */\n  excludeWhenDisabled?: boolean;\n  /** Classes for the item's box (a `grid gap-1`). */\n  className?: string;\n}\n\n/** What {@link RhfField}'s `render` receives. */\nexport interface RhfFieldRenderContext<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n> {\n  field: ControllerRenderProps<TFieldValues, TName>;\n  fieldState: ControllerFieldState;\n  /** The field has an error: pass it to the control's `invalid` so it paints. */\n  invalid: boolean;\n  /** The error's message, if any. */\n  error: string | undefined;\n  /** The control's id, which the label points at. `FormControl` sets it on the\n   *  rendered element already; this is for a control that routes it elsewhere. */\n  id: string;\n  /** The label's id, for a control that is named with `aria-labelledby`. */\n  labelId: string;\n  /** The ids of the rendered hint and message, if any. */\n  describedBy: string | undefined;\n}\n\nexport interface RhfFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> extends RhfFieldBaseProps<TFieldValues, TName, TTransformed> {\n  /** The control. Wrapped in {@link FormControl} (its `id`, `aria-describedby` and\n   *  `aria-invalid`) unless `asControl` is false. */\n  render: (ctx: RhfFieldRenderContext<TFieldValues, TName>) => ReactElement;\n  /** `false`: render the control as is, for one that wires its own ids from the\n   *  context. Default `true`. */\n  asControl?: boolean;\n  /** `false`: no {@link FormMessage}, for a control that renders its own error (its\n   *  `error` prop). Default `true`. */\n  message?: boolean;\n  /** `false`: no {@link FormLabel}, for a control that carries its label itself (a\n   *  checkbox). Default `true`. */\n  showLabel?: boolean;\n}\n\nfunction hasContent(node: ReactNode): boolean {\n  return node !== undefined && node !== null && node !== false && node !== \"\";\n}\n\n/** The label, with an id the control can be named by. Inside the item, so it can read\n *  the item's id. */\nfunction RhfLabel({ required, children }: { required?: boolean; children: ReactNode }) {\n  const { id } = useFormField();\n  return (\n    <FormLabel id={`${id}-label`} required={required}>\n      {children}\n    </FormLabel>\n  );\n}\n\nfunction ControlSlot<TFieldValues extends FieldValues, TName extends FieldPath<TFieldValues>>({\n  field,\n  fieldState,\n  render,\n  asControl,\n}: {\n  field: ControllerRenderProps<TFieldValues, TName>;\n  fieldState: ControllerFieldState;\n  render: RhfFieldProps<TFieldValues, TName>[\"render\"];\n  asControl: boolean;\n}) {\n  const { id, formItemId, describedBy } = useFormField();\n  const element = render({\n    field,\n    fieldState,\n    invalid: fieldState.invalid,\n    error: fieldState.error?.message,\n    id: formItemId,\n    labelId: `${id}-label`,\n    describedBy,\n  });\n  return asControl ? <FormControl>{element}</FormControl> : element;\n}\n\n/**\n * The shell every bound field is built on: label, control, hint and message around\n * a `render` of your own.\n *\n * ```tsx\n * <RhfField name=\"address\" label=\"Address\" render={({ field, invalid }) => (\n *   <AddressAutocomplete value={field.value ?? \"\"} onChange={field.onChange} invalid={invalid} />\n * )} />\n * ```\n */\nexport function RhfField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  render,\n  asControl = true,\n  message = true,\n  showLabel = true,\n}: RhfFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <FormField\n      control={control}\n      name={name}\n      rules={rules}\n      disabled={excludeWhenDisabled ? disabled : undefined}\n      render={({ field, fieldState }) => (\n        <FormItem className={className}>\n          {showLabel && hasContent(label) && <RhfLabel required={required}>{label}</RhfLabel>}\n          <ControlSlot\n            field={disabled && !field.disabled ? { ...field, disabled: true } : field}\n            fieldState={fieldState}\n            render={render}\n            asControl={asControl}\n          />\n          {hasContent(hint) && <FormDescription>{hint}</FormDescription>}\n          {message && <FormMessage />}\n        </FormItem>\n      )}\n    />\n  );\n}\n\n/**\n * Hands react-hook-form a focus handle for a control that forwards no ref: its\n * `shouldFocusError` calls `focus()` on whatever `field.ref` was given. `find` runs at\n * focus time, so it sees the element as it is then.\n */\nfunction useFocusHandle(ref: ControllerRenderProps[\"ref\"], find: () => HTMLElement | null | undefined) {\n  const findRef = useRef(find);\n  useLayoutEffect(() => {\n    findRef.current = find;\n  });\n  useLayoutEffect(() => {\n    ref({ focus: () => findRef.current()?.focus() });\n  }, [ref]);\n}\n\n// ── text ─────────────────────────────────────────────────────────────────────\n\ntype OwnInputProps = Omit<\n  InputProps,\n  \"name\" | \"value\" | \"defaultValue\" | \"onChange\" | \"onBlur\" | \"ref\" | \"label\" | \"error\" | \"invalid\" | \"className\" | \"disabled\" | \"required\" | \"inputClassName\"\n> & {\n  /**\n   * Classes for the `<input>` — `className` is the item's box (kastlan 42: a\n   * `font-mono` IBAN, a `tabular-nums` reference number). {@link RhfTextarea} and\n   * {@link RhfNumberField} had it; this one only reached `Input`'s prop of the same\n   * name by accident of the rest-spread, undocumented and one refactor from being\n   * dropped. Declared, it is part of the contract the three share.\n   */\n  inputClassName?: string;\n};\n\nexport type RhfTextFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> & OwnInputProps;\n\n/** A text {@link Input} — `type` for email, tel, password, url. Stores the string. */\nexport function RhfTextField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  ...inputProps\n}: RhfTextFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className }}\n      render={({ field, invalid }) => (\n        <Input\n          aria-required={required || undefined}\n          {...inputProps}\n          name={field.name}\n          ref={field.ref}\n          value={(field.value ?? \"\") as string}\n          onChange={field.onChange}\n          onBlur={field.onBlur}\n          disabled={field.disabled}\n          invalid={invalid}\n        />\n      )}\n    />\n  );\n}\n\ntype OwnTextareaProps = Omit<\n  TextareaProps,\n  \"name\" | \"value\" | \"defaultValue\" | \"onChange\" | \"onBlur\" | \"ref\" | \"label\" | \"error\" | \"invalid\" | \"className\" | \"disabled\" | \"required\"\n> & {\n  /** Classes for the `<textarea>`. */\n  inputClassName?: string;\n};\n\nexport type RhfTextareaProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> & OwnTextareaProps;\n\n/** A multi-line {@link Textarea}; takes `rows`. Stores the string. */\nexport function RhfTextarea<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  inputClassName,\n  ...areaProps\n}: RhfTextareaProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className }}\n      render={({ field, invalid }) => (\n        <Textarea\n          aria-required={required || undefined}\n          {...areaProps}\n          className={inputClassName}\n          name={field.name}\n          ref={field.ref}\n          value={(field.value ?? \"\") as string}\n          onChange={field.onChange}\n          onBlur={field.onBlur}\n          disabled={field.disabled}\n          invalid={invalid}\n        />\n      )}\n    />\n  );\n}\n\n// ── numbers ──────────────────────────────────────────────────────────────────\n\n/** A form value → the number field's `number | null`. Defaults hold `\"\"`, `null`, a\n *  number, or a numeric string. */\nfunction toNumber(value: unknown): number | null {\n  if (value === null || value === undefined || value === \"\") return null;\n  const n = typeof value === \"number\" ? value : Number(String(value).replace(\",\", \".\"));\n  return Number.isFinite(n) ? n : null;\n}\n\nexport type RhfNumberFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<\n    NumberFieldProps,\n    | \"digits\"\n    | \"min\"\n    | \"max\"\n    | \"step\"\n    | \"calculator\"\n    | \"unit\"\n    | \"unitPlacement\"\n    | \"placeholder\"\n    | \"inputClassName\"\n    | \"locale\"\n    | \"ariaLabel\"\n    | \"autoFocus\"\n  > & {\n    /** What an emptied field stores. Default `null`; `\"\"` for a schema written\n     *  against a native number input (`z.coerce.number()` over `\"\"`). */\n    emptyValue?: null | \"\";\n    /** `false`: an emptied field snaps back to its last number instead of storing\n     *  `emptyValue`. Default `true`. */\n    nullable?: boolean;\n  };\n\n/**\n * The kit's {@link NumberField}: a parsed, rounded (`digits`) and clamped (`min` /\n * `max`) number, committed on blur or Enter in the locale's decimal mark. Stores a\n * number, or `emptyValue` when emptied.\n */\nexport function RhfNumberField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  emptyValue = null,\n  nullable = true,\n  ...numberProps\n}: RhfNumberFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className }}\n      render={({ field, invalid, id }) => (\n        // FormControl clones this element with `id` / `aria-describedby` /\n        // `aria-invalid`, which NumberControl hands on to the field.\n        <NumberControl\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          id={id}\n          emptyValue={emptyValue}\n          nullable={nullable}\n          numberProps={numberProps}\n        />\n      )}\n    />\n  );\n}\n\nfunction NumberControl({\n  field,\n  invalid,\n  required,\n  id,\n  emptyValue,\n  nullable,\n  numberProps,\n  ...aria\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  id: string;\n  emptyValue: null | \"\";\n  nullable: boolean;\n  numberProps: Omit<RhfNumberFieldProps, keyof RhfFieldBaseProps | \"emptyValue\" | \"nullable\">;\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: NumberFieldProps[\"aria-invalid\"];\n}) {\n  // NumberField forwards no ref; it routes `id` to its <input>, where the handle\n  // finds it.\n  useFocusHandle(field.ref, () => document.getElementById(id));\n  return (\n    <NumberField\n      {...numberProps}\n      aria-describedby={aria[\"aria-describedby\"]}\n      aria-invalid={aria[\"aria-invalid\"]}\n      aria-required={required || undefined}\n      id={id}\n      value={toNumber(field.value)}\n      onCommit={(n) => {\n        field.onChange(n ?? emptyValue);\n        field.onBlur();\n      }}\n      nullable={nullable}\n      disabled={field.disabled}\n      invalid={invalid}\n    />\n  );\n}\n\nexport type RhfIntegerFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfNumberFieldProps<TFieldValues, TName, TTransformed>;\n\n/**\n * {@link RhfNumberField} for a whole number — a floor, a room count, a year, a\n * notice period in months. Every such call site in kastlan (item 41) spelled out the\n * same three props, `digits={0} calculator={false} emptyValue=\"\"`, and a preset\n * written thirty times is one that is eventually written wrong once:\n *\n *  - `digits={0}`: rounds on commit, so \"2.5\" rooms settles to 3 instead of reaching\n *    an `Integer` column and failing server-side;\n *  - `calculator={false}`: a count is typed, not worked out — the trigger is noise\n *    beside a two-digit field;\n *  - `emptyValue=\"\"`: kastlan's integer schemas are `z.coerce.number()` over `\"\"`,\n *    written against the native number inputs these fields replaced.\n *\n * Each is only a default: pass the prop to override it (`emptyValue={null}` for a\n * nullable column). Everything else is {@link RhfNumberField}'s.\n */\nexport function RhfIntegerField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>(props: RhfIntegerFieldProps<TFieldValues, TName, TTransformed>) {\n  // `??` / `=== undefined` rather than a spread over the defaults, so a caller\n  // forwarding its own optional prop (`digits={props.digits}`) still gets the preset,\n  // while an explicit `emptyValue={null}` keeps its null.\n  return (\n    <RhfNumberField\n      {...props}\n      digits={props.digits ?? 0}\n      calculator={props.calculator ?? false}\n      emptyValue={props.emptyValue === undefined ? \"\" : props.emptyValue}\n    />\n  );\n}\n\n// ── money ────────────────────────────────────────────────────────────────────\n\nexport type RhfMoneyFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> & {\n  placeholder?: string;\n  /** The currency chip's code (\"CHF\"). */\n  currency?: string;\n  /** Makes the chip a currency picker. Bind it to another field with\n   *  `useController`, or to state. */\n  onCurrencyChange?: (code: string) => void;\n  /** Colours the figure for the direction of money. */\n  tone?: \"neutral\" | \"outflow\" | \"inflow\";\n  align?: \"start\" | \"center\";\n  ariaLabel?: string;\n  autoFocus?: boolean;\n  /**\n   * What the form stores: `\"number\"` (default) — `12.5`, or `emptyValue` while the\n   * field is empty — or `\"string\"`, the field's own text (\"12.50\") for a schema that\n   * parses it itself. A half-typed sum (\"12+\") leaves the stored number as it was\n   * until it resolves.\n   */\n  valueAs?: \"number\" | \"string\";\n  /** What an emptied field stores when `valueAs` is `\"number\"`. Default `null`. */\n  emptyValue?: null | \"\";\n  /** Decimals the amount settles to on blur, Enter or a calculator result. Default:\n   *  the currency's minor unit (CHF 2, JPY 0). See {@link AmountInput}'s `digits`. */\n  digits?: number;\n  /** Clamp the settled amount (a release capped at the deposit's balance). Validate\n   *  with `rules` as well if a clamp needs explaining. */\n  min?: number;\n  max?: number;\n};\n\n/** The amount a text reads as, or `undefined` for a draft that is not one yet. */\nfunction parseAmount(text: string): number | null | undefined {\n  const trimmed = text.trim();\n  if (trimmed === \"\") return null;\n  if (!/^-?\\d*[.,]?\\d*$/.test(trimmed)) return undefined;\n  const n = Number(trimmed.replace(\",\", \".\"));\n  return Number.isFinite(n) ? n : undefined;\n}\n\nfunction MoneyControl({\n  field,\n  invalid,\n  required,\n  id,\n  describedBy,\n  props,\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  id: string;\n  describedBy: string | undefined;\n  props: Omit<RhfMoneyFieldProps, keyof RhfFieldBaseProps>;\n}) {\n  const { valueAs = \"number\", emptyValue = null, ariaLabel, ...amountProps } = props;\n  const value: unknown = field.value;\n  const external = value === null || value === undefined ? \"\" : String(value);\n  // The text being typed. A stored NUMBER cannot hold \"12.\" or \"12+5\", so the draft\n  // lives here and is re-read from the form only when the form's value moves away\n  // from what the draft already says (a reset, a setValue).\n  const [draft, setDraft] = useState(external);\n  const [seen, setSeen] = useState<unknown>(value);\n  if (seen !== value) {\n    setSeen(value);\n    const current = valueAs === \"string\" ? draft : parseAmount(draft);\n    const same = valueAs === \"string\" ? current === external : current === toNumber(value);\n    if (!same) setDraft(external);\n  }\n  const input = useRef<HTMLInputElement | null>(null);\n  // AmountInput reports no blur, and react-hook-form needs one to mark the field\n  // touched: listen on its <input>.\n  const onBlur = field.onBlur;\n  useLayoutEffect(() => {\n    const el = input.current;\n    if (!el) return;\n    el.addEventListener(\"blur\", onBlur);\n    return () => el.removeEventListener(\"blur\", onBlur);\n  }, [onBlur]);\n  return (\n    <div>\n      <AmountInput\n        {...amountProps}\n        ariaLabel={ariaLabel}\n        id={id}\n        aria-describedby={describedBy}\n        aria-required={required || undefined}\n        ref={(el) => {\n          input.current = el;\n          field.ref(el);\n        }}\n        value={draft}\n        disabled={field.disabled}\n        invalid={invalid}\n        onChange={(text) => {\n          setDraft(text);\n          if (valueAs === \"string\") {\n            field.onChange(text);\n            return;\n          }\n          const parsed = parseAmount(text);\n          if (parsed === undefined) return;\n          field.onChange(parsed ?? emptyValue);\n        }}\n      />\n    </div>\n  );\n}\n\n/**\n * The kit's {@link AmountInput}: a money figure with its currency chip and the\n * calculator (\"1200+80\" resolves on blur or Enter). Stores a number by default — see\n * `valueAs`.\n */\nexport function RhfMoneyField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  ...amountProps\n}: RhfMoneyFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className }}\n      asControl={false}\n      render={({ field, invalid, id, describedBy }) => (\n        <MoneyControl\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          id={id}\n          describedBy={describedBy}\n          props={amountProps}\n        />\n      )}\n    />\n  );\n}\n\n// ── date ─────────────────────────────────────────────────────────────────────\n\nexport type RhfDateFieldProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Omit<DatePickerProps, \"value\" | \"onChange\" | \"label\" | \"invalid\" | \"disabled\" | \"className\" | \"id\"> & {\n    /** Classes for the picker. Default `w-full`. */\n    inputClassName?: string;\n    /** What a cleared date stores. Default `\"\"`, the empty ISO string; `null` for a\n     *  nullable schema. */\n    emptyValue?: \"\" | null;\n  };\n\nfunction DateControl({\n  field,\n  invalid,\n  required,\n  id,\n  emptyValue,\n  inputClassName,\n  pickerProps,\n  ...aria\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  id: string;\n  emptyValue: \"\" | null;\n  inputClassName?: string;\n  pickerProps: Omit<DatePickerProps, \"value\" | \"onChange\" | \"label\" | \"invalid\" | \"disabled\" | \"className\" | \"id\">;\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: DatePickerProps[\"aria-invalid\"];\n}) {\n  useFocusHandle(field.ref, () => document.getElementById(id));\n  const value: unknown = field.value;\n  return (\n    <DatePicker\n      {...pickerProps}\n      {...aria}\n      aria-required={required || undefined}\n      id={id}\n      value={typeof value === \"string\" ? value : \"\"}\n      onChange={(iso) => {\n        field.onChange(iso === \"\" ? emptyValue : iso);\n        field.onBlur();\n      }}\n      disabled={field.disabled}\n      invalid={invalid}\n      className={inputClassName ?? \"w-full\"}\n    />\n  );\n}\n\n/** The kit's {@link DatePicker}, holding an ISO `\"YYYY-MM-DD\"` string. */\nexport function RhfDateField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  inputClassName,\n  emptyValue = \"\",\n  ...pickerProps\n}: RhfDateFieldProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className }}\n      render={({ field, invalid, id }) => (\n        // FormControl clones this element with `aria-describedby` / `aria-invalid`,\n        // which DateControl hands on to the picker's trigger.\n        <DateControl\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          id={id}\n          emptyValue={emptyValue}\n          inputClassName={inputClassName}\n          pickerProps={pickerProps}\n        />\n      )}\n    />\n  );\n}\n\n// ── select ───────────────────────────────────────────────────────────────────\n\nexport interface RhfSelectOption {\n  value: string | number;\n  label: ReactNode;\n  disabled?: boolean;\n}\n\nexport type RhfSelectProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<SelectProps, \"size\" | \"autoFocus\" | \"aria-label\"> & {\n    /** The options, as data. Or pass `<option>` children. */\n    options?: readonly RhfSelectOption[];\n    children?: ReactNode;\n    /** A first, empty option (\"Choose…\"), selected while the value is empty. */\n    placeholder?: string;\n    /** Store `Number(value)` rather than the option's string. An empty choice still\n     *  stores `\"\"`. */\n    valueAsNumber?: boolean;\n    /** Classes for the select. Default `w-full`. */\n    selectClassName?: string;\n  };\n\n/** A native {@link Select}, from `options` or `<option>` children. */\nexport function RhfSelect<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  options,\n  children,\n  placeholder,\n  valueAsNumber,\n  selectClassName,\n  ...selectProps\n}: RhfSelectProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className }}\n      render={({ field, invalid }) => (\n        <Select\n          aria-required={required || undefined}\n          {...selectProps}\n          className={cn(\"w-full\", selectClassName)}\n          name={field.name}\n          ref={field.ref}\n          value={(field.value ?? \"\") as string | number}\n          onChange={(e) => {\n            const raw = e.target.value;\n            field.onChange(valueAsNumber && raw !== \"\" ? Number(raw) : raw);\n          }}\n          onBlur={field.onBlur}\n          disabled={field.disabled}\n          invalid={invalid}\n        >\n          {placeholder !== undefined && <option value=\"\">{placeholder}</option>}\n          {options\n            ? options.map((o) => (\n                <option key={String(o.value)} value={o.value} disabled={o.disabled}>\n                  {o.label}\n                </option>\n              ))\n            : children}\n        </Select>\n      )}\n    />\n  );\n}\n\n// ── checkbox ─────────────────────────────────────────────────────────────────\n\nexport type RhfCheckboxProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<CheckboxProps, \"inputClassName\" | \"autoFocus\" | \"aria-label\">;\n\n/**\n * The kit's {@link Checkbox}, label beside the box and `hint` under it (the\n * checkbox's own `description`). Stores a boolean. `required` is the native one here\n * — see Checkbox — so a `<form>` refuses to submit it unticked.\n */\nexport function RhfCheckbox<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  ...boxProps\n}: RhfCheckboxProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, required, disabled, excludeWhenDisabled, className }}\n      showLabel={false}\n      render={({ field, invalid }) => (\n        <Checkbox\n          {...boxProps}\n          ref={field.ref}\n          name={field.name}\n          checked={Boolean(field.value)}\n          onCheckedChange={field.onChange}\n          onBlur={field.onBlur}\n          disabled={field.disabled}\n          required={required}\n          invalid={invalid}\n          label={label}\n          description={hint}\n        />\n      )}\n    />\n  );\n}\n\n// ── comboboxes ───────────────────────────────────────────────────────────────\n\nexport type RhfComboboxProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  V extends string | number = string | number,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<\n    EntityComboboxProps<V>,\n    | \"options\"\n    | \"loadOptions\"\n    | \"loading\"\n    | \"placeholder\"\n    | \"searchPlaceholder\"\n    | \"emptyLabel\"\n    | \"clearable\"\n    | \"clearLabel\"\n    | \"onCreate\"\n    | \"createLabel\"\n    | \"filter\"\n    | \"minChars\"\n    | \"debounceMs\"\n  > & {\n    /** What a clear stores — the picker's `clearValue`. Default `null`; `\"\"` for a\n     *  schema that spells \"no choice\" as an empty string. */\n    clearValue?: ComboClearValue;\n    /** Classes for the picker. */\n    comboClassName?: string;\n  };\n\nfunction EntityControl<V extends string | number>({\n  field,\n  invalid,\n  required,\n  error,\n  id,\n  describedBy,\n  clearValue,\n  comboClassName,\n  comboProps,\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  error: string | undefined;\n  id: string;\n  describedBy: string | undefined;\n  clearValue: ComboClearValue;\n  comboClassName?: string;\n  comboProps: Omit<RhfComboboxProps<FieldValues, string, V>, keyof RhfFieldBaseProps | \"clearValue\" | \"comboClassName\">;\n}) {\n  const box = useRef<HTMLDivElement>(null);\n  // EntityCombobox puts `id` and the ARIA below on its trigger, so the label's\n  // `htmlFor` names it, the hint describes it and the focus handle finds it by id.\n  useFocusHandle(field.ref, () => document.getElementById(id));\n  // EntityCombobox reports no blur: focus leaving the picker marks the field touched.\n  const onBlur = field.onBlur;\n  useLayoutEffect(() => {\n    const el = box.current;\n    if (!el) return;\n    el.addEventListener(\"focusout\", onBlur);\n    return () => el.removeEventListener(\"focusout\", onBlur);\n  }, [onBlur]);\n  const value: unknown = field.value;\n  return (\n    <div ref={box}>\n      <EntityCombobox<V, ComboClearValue>\n        {...comboProps}\n        className={comboClassName}\n        id={id}\n        aria-describedby={describedBy}\n        aria-required={required || undefined}\n        value={(value ?? null) as V | ComboClearValue | null}\n        clearValue={clearValue}\n        onChange={(v) => field.onChange(v)}\n        disabled={field.disabled}\n        invalid={invalid}\n        // Its own message, which it merges into the trigger's aria-describedby after\n        // the hint.\n        error={error}\n      />\n    </div>\n  );\n}\n\n/**\n * The kit's {@link EntityCombobox}: an id-keyed pick from `options` or `loadOptions`.\n * Stores the option's `value`, or `clearValue` on a clear (only offered with\n * `clearable`).\n */\nexport function RhfCombobox<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  V extends string | number = string | number,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  clearValue = null,\n  comboClassName,\n  ...comboProps\n}: RhfComboboxProps<TFieldValues, TName, V, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className }}\n      asControl={false}\n      message={false}\n      render={({ field, invalid, error, id, describedBy }) => (\n        <EntityControl<V>\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          error={error}\n          id={id}\n          describedBy={describedBy}\n          clearValue={clearValue}\n          comboClassName={comboClassName}\n          comboProps={comboProps}\n        />\n      )}\n    />\n  );\n}\n\nexport type RhfTextComboboxProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> = RhfFieldBaseProps<TFieldValues, TName, TTransformed> &\n  Pick<\n    ComboboxProps,\n    | \"options\"\n    | \"placeholder\"\n    | \"groupBy\"\n    | \"maxSuggestions\"\n    | \"searchPlaceholder\"\n    | \"createLabel\"\n    | \"optionAdornment\"\n    | \"autoFocus\"\n    | \"aria-label\"\n  > & {\n    /** Classes for the combobox. */\n    comboClassName?: string;\n  };\n\n/**\n * The kit's free-text {@link Combobox}: type anything, or pick one of `options`.\n * Stores the string.\n */\nexport function RhfTextCombobox<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  label,\n  hint,\n  required,\n  disabled,\n  excludeWhenDisabled,\n  className,\n  comboClassName,\n  ...comboProps\n}: RhfTextComboboxProps<TFieldValues, TName, TTransformed>) {\n  return (\n    <RhfField\n      {...{ name, control, rules, label, hint, required, disabled, excludeWhenDisabled, className }}\n      asControl={false}\n      message={false}\n      render={({ field, invalid, error, id, describedBy }) => (\n        <TextComboControl\n          field={field as unknown as ControllerRenderProps}\n          invalid={invalid}\n          required={required}\n          error={error}\n          id={id}\n          describedBy={describedBy}\n          className={comboClassName}\n          comboProps={comboProps}\n        />\n      )}\n    />\n  );\n}\n\nfunction TextComboControl({\n  field,\n  invalid,\n  required,\n  error,\n  id,\n  describedBy,\n  className,\n  comboProps,\n}: {\n  field: ControllerRenderProps;\n  invalid: boolean;\n  required?: boolean;\n  error: string | undefined;\n  id: string;\n  describedBy: string | undefined;\n  className?: string;\n  comboProps: Omit<RhfTextComboboxProps, keyof RhfFieldBaseProps | \"comboClassName\">;\n}) {\n  // The combobox routes `id` and its ARIA to its <input>, so the label's `htmlFor`\n  // names it, the hint describes it and the focus handle finds it; the error is its\n  // own `error` prop, which it merges in after the hint.\n  useFocusHandle(field.ref, () => document.getElementById(id));\n  const value: unknown = field.value;\n  return (\n    <Combobox\n      {...comboProps}\n      id={id}\n      aria-describedby={describedBy}\n      aria-required={required || undefined}\n      className={className}\n      value={typeof value === \"string\" ? value : value == null ? \"\" : String(value)}\n      onChange={field.onChange}\n      onBlur={field.onBlur}\n      disabled={field.disabled}\n      invalid={invalid}\n      error={error}\n    />\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/rhf/form.d.ts

@@ -2,7 +2,7 @@ import * as react from 'react';
 import { ReactElement, ComponentProps } from 'react';
 import * as react_hook_form from 'react-hook-form';
 import { FieldValues, FieldPath, ControllerProps } from 'react-hook-form';
-import { aB as LabelProps } from '../kit-labels-v3biUF1L.js';
+import { aD as LabelProps } from '../kit-labels-Mz8zZHIF.js';
 import '../components/data-table-labels.js';
 import '../components/mini-calendar.js';
 import '../components/calendar-heatmap.js';

package/dist/rhf.d.ts

@@ -1,10 +1,10 @@
 export { Form, FormControl, FormControlProps, FormDescription, FormDescriptionProps, FormField, FormItem, FormItemProps, FormLabel, FormLabelProps, FormMessage, FormMessageProps, useFormField } from './rhf/form.js';
 export { RhfWizardStepOptions, useRhfWizardStep } from './rhf/use-rhf-wizard-step.js';
-export { RhfCheckbox, RhfCheckboxProps, RhfCombobox, RhfComboboxProps, RhfDateField, RhfDateFieldProps, RhfField, RhfFieldBaseProps, RhfFieldProps, RhfFieldRenderContext, RhfMoneyField, RhfMoneyFieldProps, RhfNumberField, RhfNumberFieldProps, RhfSelect, RhfSelectOption, RhfSelectProps, RhfTextCombobox, RhfTextComboboxProps, RhfTextField, RhfTextFieldProps, RhfTextarea, RhfTextareaProps } from './rhf/fields.js';
+export { RhfCheckbox, RhfCheckboxProps, RhfCombobox, RhfComboboxProps, RhfDateField, RhfDateFieldProps, RhfField, RhfFieldBaseProps, RhfFieldProps, RhfFieldRenderContext, RhfIntegerField, RhfIntegerFieldProps, RhfMoneyField, RhfMoneyFieldProps, RhfNumberField, RhfNumberFieldProps, RhfSelect, RhfSelectOption, RhfSelectProps, RhfTextCombobox, RhfTextComboboxProps, RhfTextField, RhfTextFieldProps, RhfTextarea, RhfTextareaProps } from './rhf/fields.js';
 export { RhfLineItemCellContext, RhfLineItems, RhfLineItemsColumn, RhfLineItemsProps } from './rhf/line-items.js';
 import 'react';
 import 'react-hook-form';
-import './kit-labels-v3biUF1L.js';
+import './kit-labels-Mz8zZHIF.js';
 import './components/data-table-labels.js';
 import './components/mini-calendar.js';
 import './components/calendar-heatmap.js';

package/dist/rhf.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/rhf.ts"],"sourcesContent":["// `@eifi1/ui-kit/rhf` — the react-hook-form adapter: Form, FormField, FormItem,\n// FormLabel, FormControl, FormDescription, FormMessage and useFormField.\n//\n// The only entry point in the package that requires `react-hook-form`, and an optional\n// peer for that reason: an app without a form library installs nothing for it. NOT\n// re-exported from the main barrel, which would make the peer everyone's — the reason\n// the barrel dropped its last react-hook-form import (see the wizard section of\n// src/index.ts). The packaging contract test holds that line.\nexport * from \"./rhf/form\";\n// The react-hook-form bridge to the wizard's Next gate (useWizard lives in /wizard).\nexport * from \"./rhf/use-rhf-wizard-step\";\n// Bound fields — one line per field (RhfTextField, RhfNumberField, RhfMoneyField,\n// RhfDateField, RhfTextarea, RhfSelect, RhfCheckbox, RhfCombobox, RhfTextCombobox)\n// and RhfField, the shell they are built on.\nexport * from \"./rhf/fields\";\n// LineItems over useFieldArray.\nexport * from \"./rhf/line-items\";\n"],"mappings":";AAQA,cAAc;AAEd,cAAc;AAId,cAAc;AAEd,cAAc;","names":[]}
+{"version":3,"sources":["../src/rhf.ts"],"sourcesContent":["// `@eifi1/ui-kit/rhf` — the react-hook-form adapter: Form, FormField, FormItem,\n// FormLabel, FormControl, FormDescription, FormMessage and useFormField.\n//\n// The only entry point in the package that requires `react-hook-form`, and an optional\n// peer for that reason: an app without a form library installs nothing for it. NOT\n// re-exported from the main barrel, which would make the peer everyone's — the reason\n// the barrel dropped its last react-hook-form import (see the wizard section of\n// src/index.ts). The packaging contract test holds that line.\nexport * from \"./rhf/form\";\n// The react-hook-form bridge to the wizard's Next gate (useWizard lives in /wizard).\nexport * from \"./rhf/use-rhf-wizard-step\";\n// Bound fields — one line per field (RhfTextField, RhfNumberField, RhfIntegerField, RhfMoneyField,\n// RhfDateField, RhfTextarea, RhfSelect, RhfCheckbox, RhfCombobox, RhfTextCombobox)\n// and RhfField, the shell they are built on.\nexport * from \"./rhf/fields\";\n// LineItems over useFieldArray.\nexport * from \"./rhf/line-items\";\n"],"mappings":";AAQA,cAAc;AAEd,cAAc;AAId,cAAc;AAEd,cAAc;","names":[]}

package/dist/search/command-palette.js

@@ -1,6 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useId, useMemo, useRef, useState } from "react";
+import { useEffect, useEffectEvent, useId, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
 import { CornerDownLeft, Search, X } from "lucide-react";
 import { cn } from "../lib/cn.js";
@@ -20,9 +20,12 @@ function groupItems(items) {
     }
     byGroup.get(item.group).push(item);
   }
+  const flat = order.flatMap((g) => byGroup.get(g)).filter((item) => item.kind !== "status");
   return {
     groups: order.map((g) => ({ group: g, items: byGroup.get(g) })),
-    flat: order.flatMap((g) => byGroup.get(g)).filter((item) => item.kind !== "status")
+    flat,
+    /** Each selectable item's position in `flat` — its `data-index` and keyboard slot. */
+    flatIndex: new Map(flat.map((item, index) => [item, index]))
   };
 }
 const DEFAULT_COMMAND_PALETTE_LABELS = {
@@ -96,8 +99,7 @@ function CommandPalette({
   const dialogRef = useRef(null);
   const inputRef = useRef(null);
   const listRef = useRef(null);
-  const searchRef = useRef(search);
-  searchRef.current = search;
+  const runSearch = useEffectEvent((q) => search(q));
   const reqId = useRef(0);
   const syncRef = useRef(void 0);
   const shownQuery = useRef(null);
@@ -105,12 +107,17 @@ function CommandPalette({
   useOverlayHistory(open, onClose);
   useFocusTrap(dialogRef, { active: open, initialFocus: () => inputRef.current });
   useBodyScrollLock(open);
+  const [wasOpen, setWasOpen] = useState(false);
+  if (open !== wasOpen) {
+    setWasOpen(open);
+    if (open) {
+      if (!controlled) setOwnQuery("");
+      setDraft(controlled ? query : "");
+      setActive(0);
+    }
+  }
   useEffect(() => {
-    if (!open) return;
-    if (!controlled) setOwnQuery("");
-    setDraft(controlled ? query : "");
-    setActive(0);
-    shownQuery.current = null;
+    if (open) shownQuery.current = null;
   }, [open]);
   useEffect(() => {
     if (!open) return;
@@ -118,7 +125,7 @@ function CommandPalette({
     if (syncRef.current === false) setLoading(true);
     const run = async () => {
       try {
-        const answer = searchRef.current(query);
+        const answer = runSearch(query);
         syncRef.current = !isThenable(answer);
         if (!syncRef.current) setLoading(true);
         const r = await answer;
@@ -145,7 +152,7 @@ function CommandPalette({
     const t = setTimeout(run, query ? 150 : 0);
     return () => clearTimeout(t);
   }, [query, open, revision]);
-  const { groups, flat } = useMemo(() => groupItems(results), [results]);
+  const { groups, flat, flatIndex } = useMemo(() => groupItems(results), [results]);
   useEffect(() => {
     activeIdRef.current = flat[active]?.id;
   });
@@ -179,8 +186,8 @@ function CommandPalette({
   }, [active]);
   if (!open) return null;
   const comfortable = density === "comfortable";
-  let flatIndex = -1;
   return createPortal(
+    // eslint-disable-next-line jsx-a11y/no-static-element-interactions -- pointer-only backdrop dismiss; Escape is the keyboard path
     /* @__PURE__ */ jsx(
       "div",
       {
@@ -301,8 +308,7 @@ function CommandPalette({
                       item.id
                     );
                   }
-                  flatIndex += 1;
-                  const idx = flatIndex;
+                  const idx = flatIndex.get(item) ?? -1;
                   const isActive = idx === active;
                   const redact = item.redact ?? redactLabels;
                   const shared = {