@eifi1/ui-kit 0.33.1 → 0.35.0

package/dist/rhf/form.js

@@ -1,143 +1,6 @@
 "use client";
-import { jsx } from "react/jsx-runtime";
-import {
-  Children,
-  cloneElement,
-  createContext,
-  isValidElement,
-  useCallback,
-  useContext,
-  useId,
-  useLayoutEffect,
-  useMemo,
-  useState
-} from "react";
-import {
-  Controller,
-  FormProvider,
-  useFormContext,
-  useFormState
-} from "react-hook-form";
-import { Label } from "../components/ui.js";
-import { cn } from "../lib/cn.js";
-const Form = FormProvider;
-const FormFieldContext = createContext(null);
-const FormItemContext = createContext(null);
-function FormField(props) {
-  const value = useMemo(() => ({ name: props.name }), [props.name]);
-  return /* @__PURE__ */ jsx(FormFieldContext.Provider, { value, children: /* @__PURE__ */ jsx(Controller, { ...props }) });
-}
-function useFormField() {
-  const field = useContext(FormFieldContext);
-  const item = useContext(FormItemContext);
-  if (!field) throw new Error("useFormField must be used inside <FormField>.");
-  if (!item) throw new Error("useFormField must be used inside <FormItem>.");
-  const { getFieldState } = useFormContext();
-  const formState = useFormState({ name: field.name });
-  const state = getFieldState(field.name, formState);
-  const formDescriptionId = `${item.id}-description`;
-  const formMessageId = `${item.id}-message`;
-  const describedBy = [
-    item.mounted.description && formDescriptionId,
-    item.mounted.message && formMessageId
-  ].filter(Boolean).join(" ");
-  return {
-    id: item.id,
-    name: field.name,
-    formItemId: `${item.id}-control`,
-    formDescriptionId,
-    formMessageId,
-    /** The ids of the description and message that are actually rendered, or
-     *  `undefined` when neither is. */
-    describedBy: describedBy || void 0,
-    ...state
-  };
-}
-function FormItem({ className, ...rest }) {
-  const id = useId();
-  const [mounted, setMounted] = useState({
-    description: false,
-    message: false
-  });
-  const mark = useCallback(
-    (slot, on) => setMounted((prev) => prev[slot] === on ? prev : { ...prev, [slot]: on }),
-    []
-  );
-  const value = useMemo(() => ({ id, mounted, mark }), [id, mounted, mark]);
-  return /* @__PURE__ */ jsx(FormItemContext.Provider, { value, children: /* @__PURE__ */ jsx("div", { "data-slot": "form-item", ...rest, className: cn("grid content-start gap-1", className) }) });
-}
-function useDescribes(slot, on) {
-  const item = useContext(FormItemContext);
-  const mark = item?.mark;
-  useLayoutEffect(() => {
-    if (!on || !mark) return;
-    mark(slot, true);
-    return () => mark(slot, false);
-  }, [slot, on, mark]);
-}
-function FormLabel({ className, ...rest }) {
-  const { error, formItemId } = useFormField();
-  return /* @__PURE__ */ jsx(
-    Label,
-    {
-      "data-slot": "form-label",
-      "data-error": error ? true : void 0,
-      htmlFor: formItemId,
-      ...rest,
-      className: cn("data-[error=true]:text-[var(--danger)]", className)
-    }
-  );
-}
-function FormControl({ children }) {
-  const { invalid, formItemId, describedBy } = useFormField();
-  const child = Children.only(children);
-  if (!isValidElement(child)) return child;
-  const own = child.props;
-  const merged = [own["aria-describedby"], describedBy].filter(Boolean).join(" ");
-  return cloneElement(child, {
-    id: own.id ?? formItemId,
-    "aria-describedby": merged || void 0,
-    "aria-invalid": own["aria-invalid"] ?? (invalid || void 0)
-  });
-}
-function FormDescription({ className, ...rest }) {
-  const { formDescriptionId } = useFormField();
-  useDescribes("description", true);
-  return /* @__PURE__ */ jsx(
-    "p",
-    {
-      "data-slot": "form-description",
-      ...rest,
-      id: formDescriptionId,
-      className: cn("text-caption leading-tight text-[var(--text-muted)]", className)
-    }
-  );
-}
-function FormMessage({ className, children, ...rest }) {
-  const { error, formMessageId } = useFormField();
-  const body = error ? String(error.message ?? "") : children;
-  const shown = body !== void 0 && body !== null && body !== false && body !== "";
-  useDescribes("message", shown);
-  if (!shown) return null;
-  return /* @__PURE__ */ jsx(
-    "p",
-    {
-      "data-slot": "form-message",
-      ...rest,
-      id: formMessageId,
-      className: cn("text-caption leading-tight text-[var(--danger)]", className),
-      children: body
-    }
-  );
-}
+import { Form } from "./form-core.js";
 export {
-  Form,
-  FormControl,
-  FormDescription,
-  FormField,
-  FormItem,
-  FormLabel,
-  FormMessage,
-  useFormField
+  Form
 };
 //# sourceMappingURL=form.js.map

package/dist/rhf/form.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/rhf/form.tsx"],"sourcesContent":["/**\n * The react-hook-form adapter: the five parts every form is built from, and the hook\n * they share. `@eifi1/ui-kit/rhf`.\n *\n * ```tsx\n * <Form {...form}>\n *   <FormField control={form.control} name=\"amount\" render={({ field }) => (\n *     <FormItem>\n *       <FormLabel required>Amount</FormLabel>\n *       <FormControl>\n *         <NumberField value={field.value} onCommit={field.onChange} />\n *       </FormControl>\n *       <FormMessage />\n *     </FormItem>\n *   )} />\n * </Form>\n * ```\n *\n * The shape is shadcn's `form.tsx`, on purpose: Kastlan builds every form from that\n * file, so moving onto this one is an import line rather than a rewrite. What differs\n * is what the shadcn file gets wrong:\n *\n *  - **`aria-describedby` names only what is on screen.** shadcn always points the\n *    control at a description id, rendered or not, and at the message id whenever the\n *    field has an error, whether a message was rendered for it or not. A reference to\n *    a node that does not exist describes the field as nothing. Here the description\n *    and the message say when they are mounted, and the control points at exactly\n *    those.\n *  - **Merged, never replaced.** A control that already carries its own\n *    `aria-describedby` keeps it, first — the same rule as the kit's `error` prop\n *    (see `useFieldError` in components/ui.tsx).\n *  - **No Radix.** `FormControl` is a one-child `cloneElement`, not `Slot`, and the\n *    label is the kit's own `Label` — the kit carries no Radix dependency and this\n *    entry is not the place to start.\n *\n * ## Why this is its own entry\n *\n * The main barrel once shipped a react-hook-form hook (`use-rhf-wizard-step`) and\n * removed it: it made react-hook-form an install every consumer's typecheck paid for,\n * for a hook nobody called (see the wizard section of src/index.ts). This is the\n * answer to that, not a reversal of it. Nothing outside `src/rhf*` imports\n * react-hook-form — `__tests__/packaging-contract.test.ts` holds that — and the peer is\n * optional, so an app that does not use it installs nothing and imports nothing.\n *\n * ## Painting the field\n *\n * `FormControl` sets `aria-invalid` on its child. `NumberField` and the pickers paint\n * from that attribute; `Input`, `Select` and `Textarea` paint only from their\n * `invalid` prop (see its note in components/ui.tsx: a bare attribute announces but\n * does not paint), so pass it from the render prop —\n * `<Input {...field} invalid={fieldState.invalid} />`. `FormControl` does not inject\n * `invalid` itself because its child may be a native element, which would print it\n * into the DOM as an unknown attribute.\n *\n * ## Clearing a picker: `null`, unless the picker is told otherwise\n *\n * Nothing here touches a value. `FormField` is `Controller`, so what a control hands\n * `field.onChange` is exactly what lands in the form — and what the entity pickers\n * hand it on a clear is `null`: `EntityCombobox`'s \"×\", `InlineEntityCombobox`'s \"×\"\n * and its emptied text. (`MultiEntityCombobox` and `MultiSelect` clear to `[]`.)\n *\n * A zod schema that spells \"no choice\" as `\"\"` (`z.string()`, or `z.literal(\"\")` in a\n * union) then fails on the `null`. Say so on the PICKER, not here:\n *\n * ```tsx\n * <EntityCombobox clearValue=\"\" value={field.value} onChange={field.onChange} … />\n * ```\n *\n * `clearValue` also types `onChange` (`(v: V | \"\") => void` rather than\n * `V | null`) and reads `\"\"` back as \"nothing selected\", so an initial `defaultValues`\n * of `\"\"` shows the placeholder rather than an unresolvable id. The adapter does not\n * coerce because it cannot see the schema: mapping `null` to `\"\"` for every field\n * would break every schema that wants `null` (`z.string().nullable()`), which is the\n * pickers' default for a reason — it is the one value no option can have.\n */\nimport {\n  Children,\n  cloneElement,\n  createContext,\n  isValidElement,\n  useCallback,\n  useContext,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useState,\n  type ComponentProps,\n  type ReactElement,\n} from \"react\";\nimport {\n  Controller,\n  FormProvider,\n  useFormContext,\n  useFormState,\n  type ControllerProps,\n  type FieldPath,\n  type FieldValues,\n} from \"react-hook-form\";\nimport { Label, type LabelProps } from \"../components/ui\";\nimport { cn } from \"../lib/cn\";\n\n/** The form's `useForm()` return, spread in: `<Form {...form}>`. react-hook-form's own\n *  `FormProvider`, under the name the shadcn file gave it. */\nexport const Form = FormProvider;\n\n// ── contexts ─────────────────────────────────────────────────────────────────\n\nconst FormFieldContext = createContext<{ name: string } | null>(null);\n\n/** The two optional nodes a control can be described by. */\ntype Described = \"description\" | \"message\";\n\ninterface FormItemContextValue {\n  id: string;\n  mounted: Record<Described, boolean>;\n  mark: (slot: Described, on: boolean) => void;\n}\n\nconst FormItemContext = createContext<FormItemContextValue | null>(null);\n\n// ── FormField ────────────────────────────────────────────────────────────────\n\n/**\n * react-hook-form's `Controller`, with the field's name put in context for the parts\n * below it. Takes exactly `Controller`'s props.\n */\nexport function FormField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformedValues = TFieldValues,\n>(props: ControllerProps<TFieldValues, TName, TTransformedValues>) {\n  const value = useMemo(() => ({ name: props.name as string }), [props.name]);\n  return (\n    <FormFieldContext.Provider value={value}>\n      <Controller {...props} />\n    </FormFieldContext.Provider>\n  );\n}\n\n// ── useFormField ─────────────────────────────────────────────────────────────\n\n/**\n * The ids and the state of the field around the caller: for a part of your own that\n * sits beside the kit's (a character counter that belongs in `aria-describedby`, a\n * label with a different look).\n *\n * Throws outside a `FormField` + `FormItem` pair. shadcn's version answered there with\n * ids like `undefined-form-item`, which label nothing and fail nowhere.\n */\nexport function useFormField() {\n  const field = useContext(FormFieldContext);\n  const item = useContext(FormItemContext);\n  if (!field) throw new Error(\"useFormField must be used inside <FormField>.\");\n  if (!item) throw new Error(\"useFormField must be used inside <FormItem>.\");\n  const { getFieldState } = useFormContext();\n  // Subscribes this part to the field's state, so a label or message re-renders when\n  // the field's error changes without the whole form doing so.\n  const formState = useFormState({ name: field.name });\n  const state = getFieldState(field.name, formState);\n  const formDescriptionId = `${item.id}-description`;\n  const formMessageId = `${item.id}-message`;\n  const describedBy = [\n    item.mounted.description && formDescriptionId,\n    item.mounted.message && formMessageId,\n  ]\n    .filter(Boolean)\n    .join(\" \");\n  return {\n    id: item.id,\n    name: field.name,\n    formItemId: `${item.id}-control`,\n    formDescriptionId,\n    formMessageId,\n    /** The ids of the description and message that are actually rendered, or\n     *  `undefined` when neither is. */\n    describedBy: describedBy || undefined,\n    ...state,\n  };\n}\n\n// ── FormItem ─────────────────────────────────────────────────────────────────\n\nexport type FormItemProps = ComponentProps<\"div\">;\n\n/** One field's box: mints the id its label, control, description and message share. */\nexport function FormItem({ className, ...rest }: FormItemProps) {\n  const id = useId();\n  const [mounted, setMounted] = useState<Record<Described, boolean>>({\n    description: false,\n    message: false,\n  });\n  const mark = useCallback(\n    (slot: Described, on: boolean) =>\n      setMounted((prev) => (prev[slot] === on ? prev : { ...prev, [slot]: on })),\n    [],\n  );\n  const value = useMemo(() => ({ id, mounted, mark }), [id, mounted, mark]);\n  return (\n    <FormItemContext.Provider value={value}>\n      {/* `content-start`: stretched to a taller neighbour's height in a grid row, the\n          item gave the extra to its rows and its control sat lower (showcase audit). */}\n      <div data-slot=\"form-item\" {...rest} className={cn(\"grid content-start gap-1\", className)} />\n    </FormItemContext.Provider>\n  );\n}\n\n/** Report a describing node's presence to the item, so the control points at it only\n *  while it is on screen. A layout effect, so the reference lands before paint. */\nfunction useDescribes(slot: Described, on: boolean) {\n  const item = useContext(FormItemContext);\n  const mark = item?.mark;\n  useLayoutEffect(() => {\n    if (!on || !mark) return;\n    mark(slot, true);\n    return () => mark(slot, false);\n  }, [slot, on, mark]);\n}\n\n// ── FormLabel ────────────────────────────────────────────────────────────────\n\nexport type FormLabelProps = LabelProps;\n\n/**\n * The kit's {@link Label}, bound to the control by `htmlFor` and turned to the danger\n * colour while the field is invalid. `required` draws the kit's `aria-hidden` mark:\n * whether the field is required is the control's to announce.\n */\nexport function FormLabel({ className, ...rest }: FormLabelProps) {\n  const { error, formItemId } = useFormField();\n  return (\n    <Label\n      data-slot=\"form-label\"\n      data-error={error ? true : undefined}\n      htmlFor={formItemId}\n      {...rest}\n      className={cn(\"data-[error=true]:text-[var(--danger)]\", className)}\n    />\n  );\n}\n\n// ── FormControl ──────────────────────────────────────────────────────────────\n\nexport interface FormControlProps {\n  /** Exactly one element: the kit field, or a native one. It receives `id`,\n   *  `aria-describedby` and `aria-invalid`. */\n  children: ReactElement;\n}\n\ntype AriaProps = {\n  id?: string;\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: ComponentProps<\"input\">[\"aria-invalid\"];\n};\n\n/**\n * Wires its one child to the item: the `id` the label points at, `aria-describedby`\n * naming the rendered description and message, and `aria-invalid` while the field has\n * an error.\n *\n * The child's own values win where it has them (an explicit `id`, a set\n * `aria-invalid`), as they did under Radix `Slot`; its own `aria-describedby` is\n * merged in front of the item's rather than replaced.\n */\nexport function FormControl({ children }: FormControlProps) {\n  const { invalid, formItemId, describedBy } = useFormField();\n  const child = Children.only(children);\n  if (!isValidElement<AriaProps>(child)) return child;\n  const own = child.props;\n  const merged = [own[\"aria-describedby\"], describedBy].filter(Boolean).join(\" \");\n  return cloneElement(child, {\n    id: own.id ?? formItemId,\n    \"aria-describedby\": merged || undefined,\n    \"aria-invalid\": own[\"aria-invalid\"] ?? (invalid || undefined),\n  });\n}\n\n// ── FormDescription / FormMessage ────────────────────────────────────────────\n\nexport type FormDescriptionProps = ComponentProps<\"p\">;\n\n/** Standing advice under the field (\"at least twelve characters\"). */\nexport function FormDescription({ className, ...rest }: FormDescriptionProps) {\n  const { formDescriptionId } = useFormField();\n  useDescribes(\"description\", true);\n  return (\n    <p\n      data-slot=\"form-description\"\n      {...rest}\n      id={formDescriptionId}\n      className={cn(\"text-caption leading-tight text-[var(--text-muted)]\", className)}\n    />\n  );\n}\n\nexport type FormMessageProps = ComponentProps<\"p\">;\n\n/**\n * The field's error message, from the form — the kit renders no string of its own\n * here; the schema or the `rules` carry the words. Without an error it renders its\n * `children`, if any, and otherwise nothing.\n *\n * Deliberately NOT `role=\"alert\"`, for the reason the kit's `error` prop gives: the\n * message is read when focus reaches the control, which is where a field's own error\n * is wanted, and an alert would interrupt on every keystroke of a form that\n * re-validates as you type.\n */\nexport function FormMessage({ className, children, ...rest }: FormMessageProps) {\n  const { error, formMessageId } = useFormField();\n  const body = error ? String(error.message ?? \"\") : children;\n  const shown = body !== undefined && body !== null && body !== false && body !== \"\";\n  useDescribes(\"message\", shown);\n  if (!shown) return null;\n  return (\n    <p\n      data-slot=\"form-message\"\n      {...rest}\n      id={formMessageId}\n      className={cn(\"text-caption leading-tight text-[var(--danger)]\", className)}\n    >\n      {body}\n    </p>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/rhf/form.tsx"],"sourcesContent":["/**\n * `Form` — the public face of ./form-core, where the shadcn scaffold the bound fields are\n * built from lives (its header has the whole story: what differs from shadcn's file, why\n * /rhf is its own entry, how a picker clears).\n *\n * The scaffold itself (`FormField`, `useFormField`, `FormItem`, `FormLabel`, `FormControl`,\n * `FormDescription`, `FormMessage` and five props types) was public until 0.35 (refactor\n * audit 2026-10, API-6f; deprecated in 0.34): no app builds a form from it any more.\n * kastlan, the one /rhf consumer, uses `Form`, the bound `Rhf*` fields and `RhfField` for\n * a control of its own — the same parts, folded into one element.\n */\nexport { Form } from \"./form-core\";\n"],"mappings":";AAWA,SAAS,YAAY;","names":[]}

package/dist/rhf/line-items.d.ts

@@ -1,18 +1,49 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import { FieldValues, FieldArrayPath, FieldArrayWithId, UseFieldArrayProps, FieldArray } from 'react-hook-form';
-import { LineItemCellContext, LineItemsProps, LineItemsColumn } from '../components/line-items.js';
-
+/**
+ * {@link LineItems} over react-hook-form's `useFieldArray`. `@eifi1/ui-kit/rhf`.
+ *
+ * ```tsx
+ * <RhfLineItems
+ *   name="components"
+ *   newItem={() => ({ type: "net_rent", amount: null, validFrom: "" })}
+ *   minItems={1}
+ *   columns={[
+ *     { key: "type", header: "Type", render: ({ name, label }) => (
+ *       <RhfSelect name={`${name}.type`} options={TYPES} aria-label={label} />
+ *     ) },
+ *     { key: "amount", header: "Amount", width: "8rem", align: "end", render: ({ name, label }) => (
+ *       <RhfMoneyField name={`${name}.amount`} aria-label={label} />
+ *     ) },
+ *   ]}
+ *   totals={{ amount: formatMoney(total) }}
+ * />
+ * ```
+ *
+ * The rows are the array's `fields` (keyed by their `id`, as react-hook-form asks),
+ * Add appends `newItem()`, remove is `remove(index)`, and an error on the array
+ * itself — the `rules` here, or a resolver's `lines: "At least two lines"` — is the
+ * list's `error`. Each cell's `render` gets `name`, the row's path
+ * (`"components.2"`), to bind its field to.
+ *
+ * `summary`, `fieldLabels`, `narrowColumns`, `removePlacement` and `removeAlign` pass
+ * through to {@link LineItems}. With
+ * `fieldLabels="floating"` a cell's `fieldLabel` is the column's name; the bound
+ * fields' own `label` is a label ABOVE the control, so for the floating
+ * one render the kit field through `RhfField`:
+ * `render={({ field, invalid }) => <Input label={fieldLabel} aria-label={label} {...field} invalid={invalid} />}`.
+ */
+import type { ReactNode } from "react";
+import { type FieldArray, type FieldArrayPath, type FieldArrayWithId, type FieldValues, type UseFieldArrayProps } from "react-hook-form";
+import { type LineItemCellContext, type LineItemsColumn, type LineItemsProps } from "../components/line-items.js";
 /** A cell's context, with the row's path in the form. */
-interface RhfLineItemCellContext<TItem, TArrayName extends string> extends LineItemCellContext<TItem> {
+export interface RhfLineItemCellContext<TItem, TArrayName extends string> extends LineItemCellContext<TItem> {
     /** The row's path: `${name}.${index}` — bind the cell's field to
      *  `` `${name}.amount` ``. */
     name: `${TArrayName}.${number}`;
 }
-interface RhfLineItemsColumn<TItem, TArrayName extends string> extends Omit<LineItemsColumn<TItem>, "render"> {
+export interface RhfLineItemsColumn<TItem, TArrayName extends string> extends Omit<LineItemsColumn<TItem>, "render"> {
     render: (ctx: RhfLineItemCellContext<TItem, TArrayName>) => ReactNode;
 }
-interface RhfLineItemsProps<TFieldValues extends FieldValues = FieldValues, TArrayName extends FieldArrayPath<TFieldValues> = FieldArrayPath<TFieldValues>, TTransformed = TFieldValues> extends Omit<LineItemsProps<FieldArrayWithId<TFieldValues, TArrayName, "id">>, "items" | "columns" | "onAdd" | "onRemove" | "getKey"> {
+export interface RhfLineItemsProps<TFieldValues extends FieldValues = FieldValues, TArrayName extends FieldArrayPath<TFieldValues> = FieldArrayPath<TFieldValues>, TTransformed = TFieldValues> extends Omit<LineItemsProps<FieldArrayWithId<TFieldValues, TArrayName, "id">>, "items" | "columns" | "onAdd" | "onRemove" | "getKey"> {
     name: TArrayName;
     /** `form.control`. Optional under `<Form {...form}>`. */
     control?: UseFieldArrayProps<TFieldValues, TArrayName, "id", TTransformed>["control"];
@@ -26,6 +57,4 @@ interface RhfLineItemsProps<TFieldValues extends FieldValues = FieldValues, TArr
     removable?: boolean;
 }
 /** {@link LineItems} bound to a field array. See the module note. */
-declare function RhfLineItems<TFieldValues extends FieldValues = FieldValues, TArrayName extends FieldArrayPath<TFieldValues> = FieldArrayPath<TFieldValues>, TTransformed = TFieldValues>({ name, control, rules, columns, newItem, removable, error, ...rest }: RhfLineItemsProps<TFieldValues, TArrayName, TTransformed>): react.JSX.Element;
-
-export { type RhfLineItemCellContext, RhfLineItems, type RhfLineItemsColumn, type RhfLineItemsProps };
+export declare function RhfLineItems<TFieldValues extends FieldValues = FieldValues, TArrayName extends FieldArrayPath<TFieldValues> = FieldArrayPath<TFieldValues>, TTransformed = TFieldValues>({ name, control, rules, columns, newItem, removable, error, ...rest }: RhfLineItemsProps<TFieldValues, TArrayName, TTransformed>): import("react").JSX.Element;

package/dist/rhf/line-items.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/rhf/line-items.tsx"],"sourcesContent":["/**\n * {@link LineItems} over react-hook-form's `useFieldArray`. `@eifi1/ui-kit/rhf`.\n *\n * ```tsx\n * <RhfLineItems\n *   name=\"components\"\n *   newItem={() => ({ type: \"net_rent\", amount: null, validFrom: \"\" })}\n *   minItems={1}\n *   columns={[\n *     { key: \"type\", header: \"Type\", render: ({ name, label }) => (\n *       <RhfSelect name={`${name}.type`} options={TYPES} aria-label={label} />\n *     ) },\n *     { key: \"amount\", header: \"Amount\", width: \"8rem\", align: \"end\", render: ({ name, label }) => (\n *       <RhfMoneyField name={`${name}.amount`} ariaLabel={label} />\n *     ) },\n *   ]}\n *   totals={{ amount: formatMoney(total) }}\n * />\n * ```\n *\n * The rows are the array's `fields` (keyed by their `id`, as react-hook-form asks),\n * Add appends `newItem()`, remove is `remove(index)`, and an error on the array\n * itself — the `rules` here, or a resolver's `lines: \"At least two lines\"` — is the\n * list's `error`. Each cell's `render` gets `name`, the row's path\n * (`\"components.2\"`), to bind its field to.\n *\n * `summary`, `fieldLabels`, `narrowColumns`, `removePlacement` and `removeAlign` pass\n * through to {@link LineItems}. With\n * `fieldLabels=\"floating\"` a cell's `fieldLabel` is the column's name; the bound\n * fields' own `label` is a `FormLabel` ABOVE the control, so for the floating\n * one render the kit field through `RhfField`:\n * `render={({ field, invalid }) => <Input label={fieldLabel} aria-label={label} {...field} invalid={invalid} />}`.\n */\nimport type { ReactNode } from \"react\";\nimport {\n  useFieldArray,\n  useFormState,\n  type FieldArray,\n  type FieldArrayPath,\n  type FieldArrayWithId,\n  type FieldValues,\n  type UseFieldArrayProps,\n} from \"react-hook-form\";\nimport {\n  LineItems,\n  type LineItemCellContext,\n  type LineItemsColumn,\n  type LineItemsProps,\n} from \"../components/line-items\";\n\n/** A cell's context, with the row's path in the form. */\nexport interface RhfLineItemCellContext<TItem, TArrayName extends string>\n  extends LineItemCellContext<TItem> {\n  /** The row's path: `${name}.${index}` — bind the cell's field to\n   *  `` `${name}.amount` ``. */\n  name: `${TArrayName}.${number}`;\n}\n\nexport interface RhfLineItemsColumn<TItem, TArrayName extends string>\n  extends Omit<LineItemsColumn<TItem>, \"render\"> {\n  render: (ctx: RhfLineItemCellContext<TItem, TArrayName>) => ReactNode;\n}\n\nexport interface RhfLineItemsProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TArrayName extends FieldArrayPath<TFieldValues> = FieldArrayPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> extends Omit<\n    LineItemsProps<FieldArrayWithId<TFieldValues, TArrayName, \"id\">>,\n    \"items\" | \"columns\" | \"onAdd\" | \"onRemove\" | \"getKey\"\n  > {\n  name: TArrayName;\n  /** `form.control`. Optional under `<Form {...form}>`. */\n  control?: UseFieldArrayProps<TFieldValues, TArrayName, \"id\", TTransformed>[\"control\"];\n  /** `useFieldArray`'s `rules` (`minLength`, `validate` …); its message is the list's\n   *  error. */\n  rules?: UseFieldArrayProps<TFieldValues, TArrayName, \"id\", TTransformed>[\"rules\"];\n  columns: readonly RhfLineItemsColumn<FieldArrayWithId<TFieldValues, TArrayName, \"id\">, TArrayName>[];\n  /** A new row's values. Omitted: no add button. */\n  newItem?: () => FieldArray<TFieldValues, TArrayName>;\n  /** `false`: no remove buttons. Default `true`. */\n  removable?: boolean;\n}\n\n/** The message of an error at `path` in react-hook-form's errors tree: the array's\n *  own (`root`, from `rules`) or one a resolver put on the array. */\nfunction arrayError(errors: unknown, path: string): string | undefined {\n  let node: unknown = errors;\n  for (const key of path.split(\".\")) {\n    if (node === null || typeof node !== \"object\") return undefined;\n    node = (node as Record<string, unknown>)[key];\n  }\n  if (node === null || typeof node !== \"object\") return undefined;\n  const { root, message } = node as { root?: { message?: unknown }; message?: unknown };\n  const text = root?.message ?? message;\n  return typeof text === \"string\" && text !== \"\" ? text : undefined;\n}\n\n/** {@link LineItems} bound to a field array. See the module note. */\nexport function RhfLineItems<\n  TFieldValues extends FieldValues = FieldValues,\n  TArrayName extends FieldArrayPath<TFieldValues> = FieldArrayPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  columns,\n  newItem,\n  removable = true,\n  error,\n  ...rest\n}: RhfLineItemsProps<TFieldValues, TArrayName, TTransformed>) {\n  const { fields, append, remove } = useFieldArray<TFieldValues, TArrayName, \"id\", TTransformed>({\n    control,\n    name,\n    rules,\n  });\n  const { errors } = useFormState({ control, name: name as never });\n  const bound: LineItemsColumn<FieldArrayWithId<TFieldValues, TArrayName, \"id\">>[] = columns.map(\n    ({ render, ...column }) => ({\n      ...column,\n      render: (ctx) => render({ ...ctx, name: `${name}.${ctx.index}` as `${TArrayName}.${number}` }),\n    }),\n  );\n  return (\n    <LineItems\n      {...rest}\n      items={fields}\n      columns={bound}\n      getKey={(field) => field.id}\n      onAdd={newItem ? () => append(newItem()) : undefined}\n      onRemove={removable ? (index) => remove(index) : undefined}\n      error={error ?? arrayError(errors, name)}\n    />\n  );\n}\n"],"mappings":";AA8HI;AA5FJ;AAAA,EACE;AAAA,EACA;AAAA,OAMK;AACP;AAAA,EACE;AAAA,OAIK;AAsCP,SAAS,WAAW,QAAiB,MAAkC;AACrE,MAAI,OAAgB;AACpB,aAAW,OAAO,KAAK,MAAM,GAAG,GAAG;AACjC,QAAI,SAAS,QAAQ,OAAO,SAAS,SAAU,QAAO;AACtD,WAAQ,KAAiC,GAAG;AAAA,EAC9C;AACA,MAAI,SAAS,QAAQ,OAAO,SAAS,SAAU,QAAO;AACtD,QAAM,EAAE,MAAM,QAAQ,IAAI;AAC1B,QAAM,OAAO,MAAM,WAAW;AAC9B,SAAO,OAAO,SAAS,YAAY,SAAS,KAAK,OAAO;AAC1D;AAGO,SAAS,aAId;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA,GAAG;AACL,GAA8D;AAC5D,QAAM,EAAE,QAAQ,QAAQ,OAAO,IAAI,cAA4D;AAAA,IAC7F;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,EAAE,OAAO,IAAI,aAAa,EAAE,SAAS,KAAoB,CAAC;AAChE,QAAM,QAA6E,QAAQ;AAAA,IACzF,CAAC,EAAE,QAAQ,GAAG,OAAO,OAAO;AAAA,MAC1B,GAAG;AAAA,MACH,QAAQ,CAAC,QAAQ,OAAO,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,IAAI,IAAI,KAAK,GAAgC,CAAC;AAAA,IAC/F;AAAA,EACF;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,OAAO;AAAA,MACP,SAAS;AAAA,MACT,QAAQ,CAAC,UAAU,MAAM;AAAA,MACzB,OAAO,UAAU,MAAM,OAAO,QAAQ,CAAC,IAAI;AAAA,MAC3C,UAAU,YAAY,CAAC,UAAU,OAAO,KAAK,IAAI;AAAA,MACjD,OAAO,SAAS,WAAW,QAAQ,IAAI;AAAA;AAAA,EACzC;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/rhf/line-items.tsx"],"sourcesContent":["/**\n * {@link LineItems} over react-hook-form's `useFieldArray`. `@eifi1/ui-kit/rhf`.\n *\n * ```tsx\n * <RhfLineItems\n *   name=\"components\"\n *   newItem={() => ({ type: \"net_rent\", amount: null, validFrom: \"\" })}\n *   minItems={1}\n *   columns={[\n *     { key: \"type\", header: \"Type\", render: ({ name, label }) => (\n *       <RhfSelect name={`${name}.type`} options={TYPES} aria-label={label} />\n *     ) },\n *     { key: \"amount\", header: \"Amount\", width: \"8rem\", align: \"end\", render: ({ name, label }) => (\n *       <RhfMoneyField name={`${name}.amount`} aria-label={label} />\n *     ) },\n *   ]}\n *   totals={{ amount: formatMoney(total) }}\n * />\n * ```\n *\n * The rows are the array's `fields` (keyed by their `id`, as react-hook-form asks),\n * Add appends `newItem()`, remove is `remove(index)`, and an error on the array\n * itself — the `rules` here, or a resolver's `lines: \"At least two lines\"` — is the\n * list's `error`. Each cell's `render` gets `name`, the row's path\n * (`\"components.2\"`), to bind its field to.\n *\n * `summary`, `fieldLabels`, `narrowColumns`, `removePlacement` and `removeAlign` pass\n * through to {@link LineItems}. With\n * `fieldLabels=\"floating\"` a cell's `fieldLabel` is the column's name; the bound\n * fields' own `label` is a label ABOVE the control, so for the floating\n * one render the kit field through `RhfField`:\n * `render={({ field, invalid }) => <Input label={fieldLabel} aria-label={label} {...field} invalid={invalid} />}`.\n */\nimport type { ReactNode } from \"react\";\nimport {\n  useFieldArray,\n  useFormState,\n  type FieldArray,\n  type FieldArrayPath,\n  type FieldArrayWithId,\n  type FieldValues,\n  type UseFieldArrayProps,\n} from \"react-hook-form\";\nimport {\n  LineItems,\n  type LineItemCellContext,\n  type LineItemsColumn,\n  type LineItemsProps,\n} from \"../components/line-items\";\n\n/** A cell's context, with the row's path in the form. */\nexport interface RhfLineItemCellContext<TItem, TArrayName extends string>\n  extends LineItemCellContext<TItem> {\n  /** The row's path: `${name}.${index}` — bind the cell's field to\n   *  `` `${name}.amount` ``. */\n  name: `${TArrayName}.${number}`;\n}\n\nexport interface RhfLineItemsColumn<TItem, TArrayName extends string>\n  extends Omit<LineItemsColumn<TItem>, \"render\"> {\n  render: (ctx: RhfLineItemCellContext<TItem, TArrayName>) => ReactNode;\n}\n\nexport interface RhfLineItemsProps<\n  TFieldValues extends FieldValues = FieldValues,\n  TArrayName extends FieldArrayPath<TFieldValues> = FieldArrayPath<TFieldValues>,\n  TTransformed = TFieldValues,\n> extends Omit<\n    LineItemsProps<FieldArrayWithId<TFieldValues, TArrayName, \"id\">>,\n    \"items\" | \"columns\" | \"onAdd\" | \"onRemove\" | \"getKey\"\n  > {\n  name: TArrayName;\n  /** `form.control`. Optional under `<Form {...form}>`. */\n  control?: UseFieldArrayProps<TFieldValues, TArrayName, \"id\", TTransformed>[\"control\"];\n  /** `useFieldArray`'s `rules` (`minLength`, `validate` …); its message is the list's\n   *  error. */\n  rules?: UseFieldArrayProps<TFieldValues, TArrayName, \"id\", TTransformed>[\"rules\"];\n  columns: readonly RhfLineItemsColumn<FieldArrayWithId<TFieldValues, TArrayName, \"id\">, TArrayName>[];\n  /** A new row's values. Omitted: no add button. */\n  newItem?: () => FieldArray<TFieldValues, TArrayName>;\n  /** `false`: no remove buttons. Default `true`. */\n  removable?: boolean;\n}\n\n/** The message of an error at `path` in react-hook-form's errors tree: the array's\n *  own (`root`, from `rules`) or one a resolver put on the array. */\nfunction arrayError(errors: unknown, path: string): string | undefined {\n  let node: unknown = errors;\n  for (const key of path.split(\".\")) {\n    if (node === null || typeof node !== \"object\") return undefined;\n    node = (node as Record<string, unknown>)[key];\n  }\n  if (node === null || typeof node !== \"object\") return undefined;\n  const { root, message } = node as { root?: { message?: unknown }; message?: unknown };\n  const text = root?.message ?? message;\n  return typeof text === \"string\" && text !== \"\" ? text : undefined;\n}\n\n/** {@link LineItems} bound to a field array. See the module note. */\nexport function RhfLineItems<\n  TFieldValues extends FieldValues = FieldValues,\n  TArrayName extends FieldArrayPath<TFieldValues> = FieldArrayPath<TFieldValues>,\n  TTransformed = TFieldValues,\n>({\n  name,\n  control,\n  rules,\n  columns,\n  newItem,\n  removable = true,\n  error,\n  ...rest\n}: RhfLineItemsProps<TFieldValues, TArrayName, TTransformed>) {\n  const { fields, append, remove } = useFieldArray<TFieldValues, TArrayName, \"id\", TTransformed>({\n    control,\n    name,\n    rules,\n  });\n  const { errors } = useFormState({ control, name: name as never });\n  const bound: LineItemsColumn<FieldArrayWithId<TFieldValues, TArrayName, \"id\">>[] = columns.map(\n    ({ render, ...column }) => ({\n      ...column,\n      render: (ctx) => render({ ...ctx, name: `${name}.${ctx.index}` as `${TArrayName}.${number}` }),\n    }),\n  );\n  return (\n    <LineItems\n      {...rest}\n      items={fields}\n      columns={bound}\n      getKey={(field) => field.id}\n      onAdd={newItem ? () => append(newItem()) : undefined}\n      onRemove={removable ? (index) => remove(index) : undefined}\n      error={error ?? arrayError(errors, name)}\n    />\n  );\n}\n"],"mappings":";AA8HI;AA5FJ;AAAA,EACE;AAAA,EACA;AAAA,OAMK;AACP;AAAA,EACE;AAAA,OAIK;AAsCP,SAAS,WAAW,QAAiB,MAAkC;AACrE,MAAI,OAAgB;AACpB,aAAW,OAAO,KAAK,MAAM,GAAG,GAAG;AACjC,QAAI,SAAS,QAAQ,OAAO,SAAS,SAAU,QAAO;AACtD,WAAQ,KAAiC,GAAG;AAAA,EAC9C;AACA,MAAI,SAAS,QAAQ,OAAO,SAAS,SAAU,QAAO;AACtD,QAAM,EAAE,MAAM,QAAQ,IAAI;AAC1B,QAAM,OAAO,MAAM,WAAW;AAC9B,SAAO,OAAO,SAAS,YAAY,SAAS,KAAK,OAAO;AAC1D;AAGO,SAAS,aAId;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA,GAAG;AACL,GAA8D;AAC5D,QAAM,EAAE,QAAQ,QAAQ,OAAO,IAAI,cAA4D;AAAA,IAC7F;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,EAAE,OAAO,IAAI,aAAa,EAAE,SAAS,KAAoB,CAAC;AAChE,QAAM,QAA6E,QAAQ;AAAA,IACzF,CAAC,EAAE,QAAQ,GAAG,OAAO,OAAO;AAAA,MAC1B,GAAG;AAAA,MACH,QAAQ,CAAC,QAAQ,OAAO,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,IAAI,IAAI,KAAK,GAAgC,CAAC;AAAA,IAC/F;AAAA,EACF;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,OAAO;AAAA,MACP,SAAS;AAAA,MACT,QAAQ,CAAC,UAAU,MAAM;AAAA,MACzB,OAAO,UAAU,MAAM,OAAO,QAAQ,CAAC,IAAI;AAAA,MAC3C,UAAU,YAAY,CAAC,UAAU,OAAO,KAAK,IAAI;AAAA,MACjD,OAAO,SAAS,WAAW,QAAQ,IAAI;AAAA;AAAA,EACzC;AAEJ;","names":[]}

package/dist/rhf/use-rhf-wizard-step.d.ts

@@ -1,6 +1,5 @@
-import { FieldValues, FieldPath, UseFormReturn } from 'react-hook-form';
-
-type RhfWizardStepOptions<TFieldValues extends FieldValues, TTransformed = TFieldValues> = {
+import type { FieldPath, FieldValues, UseFormReturn } from "react-hook-form";
+export type RhfWizardStepOptions<TFieldValues extends FieldValues, TTransformed = TFieldValues> = {
     /** Validate only these fields — the step's share of a form that spans steps. */
     fields: readonly FieldPath<TFieldValues>[];
     /** Called with `form.getValues()` when the fields pass, before the wizard
@@ -17,6 +16,4 @@ type RhfWizardStepOptions<TFieldValues extends FieldValues, TTransformed = TFiel
  * Connects `form` to the wizard's step validation and returns the step's validator.
  * See the module note for the two modes.
  */
-declare function useRhfWizardStep<TFieldValues extends FieldValues, TContext = unknown, TTransformed = TFieldValues>(form: UseFormReturn<TFieldValues, TContext, TTransformed>, options?: RhfWizardStepOptions<TFieldValues, TTransformed> | ((values: TTransformed) => void)): () => Promise<boolean>;
-
-export { type RhfWizardStepOptions, useRhfWizardStep };
+export declare function useRhfWizardStep<TFieldValues extends FieldValues, TContext = unknown, TTransformed = TFieldValues>(form: UseFormReturn<TFieldValues, TContext, TTransformed>, options?: RhfWizardStepOptions<TFieldValues, TTransformed> | ((values: TTransformed) => void)): () => Promise<boolean>;

package/dist/rhf/use-rhf-wizard-step.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/rhf/use-rhf-wizard-step.ts"],"sourcesContent":["/**\n * The bridge between a react-hook-form step and the wizard's Next gate.\n * `@eifi1/ui-kit/rhf`.\n *\n * ```tsx\n * function AddressStep({ onUpdate }: { onUpdate: (v: Address) => void }) {\n *   const form = useForm<Address>({ defaultValues });\n *   useRhfWizardStep(form, { onValid: onUpdate });\n *   return <Form {...form}>…</Form>;\n * }\n * ```\n *\n * Inside a `<StepperNav>` the hook registers the step's validator with the wizard, so\n * Next (and Finish on a form-bearing last step) runs it: on success the values go to\n * `onValid` and the wizard advances; on failure react-hook-form shows its own inline\n * `<FormMessage>`s, focuses the first field in error, and the wizard stays put — and,\n * since the result carries no per-field errors, says its \"fill in the required\n * fields\" line so the button did not seem to do nothing. It also RETURNS the\n * validator, for a nav of your own outside `<StepperNav>` (where there is no wizard\n * context to register with, so nothing is registered).\n *\n * Two modes:\n *\n *  - **The whole form** (no `fields`): `form.handleSubmit`, exactly as kastlan's\n *    `use-rhf-wizard-step.ts` — every rule and the resolver run, `onValid` receives\n *    the TRANSFORMED values (a zod `.transform()` included), and focus follows the\n *    form's own `shouldFocusError` (on by default).\n *  - **Some fields** (`fields: [\"iban\", \"bic\"]`): `form.trigger(fields)`, for a wizard\n *    that keeps one form across several steps, each of which validates only what it\n *    shows. The first of those fields in error is focused (`shouldFocus`; the control\n *    has to take `field.ref`), errors on fields of later steps are not raised, and\n *    `onValid` receives `form.getValues()` — the untransformed values, because a\n *    resolver's output is only produced for the whole form.\n *\n * Both callbacks are read through refs, so the validator is registered once per form\n * however the caller writes them (an inline `(v) => onUpdate(v)` is the usual case).\n *\n * The positional `useRhfWizardStep(form, onValid)` of the hook kastlan kept is the\n * whole-form mode, and still accepted.\n *\n * Why it lives here and not in `@eifi1/ui-kit/wizard`: it imports react-hook-form,\n * which only this entry may (see packaging-contract).\n */\nimport { useCallback, useEffect, useRef } from \"react\";\nimport type { FieldPath, FieldValues, UseFormReturn } from \"react-hook-form\";\nimport { useOptionalWizardContext } from \"../wizard/wizard-context\";\n\nexport type RhfWizardStepOptions<\n  TFieldValues extends FieldValues,\n  TTransformed = TFieldValues,\n> =\n  | {\n      /** Validate only these fields — the step's share of a form that spans steps. */\n      fields: readonly FieldPath<TFieldValues>[];\n      /** Called with `form.getValues()` when the fields pass, before the wizard\n       *  advances. */\n      onValid?: (values: TFieldValues) => void;\n    }\n  | {\n      /** Omitted: validate the whole form through `handleSubmit`. */\n      fields?: undefined;\n      /** Called with the form's (transformed) values when it passes, before the\n       *  wizard advances. */\n      onValid?: (values: TTransformed) => void;\n    };\n\n/**\n * Connects `form` to the wizard's step validation and returns the step's validator.\n * See the module note for the two modes.\n */\nexport function useRhfWizardStep<\n  TFieldValues extends FieldValues,\n  TContext = unknown,\n  TTransformed = TFieldValues,\n>(\n  form: UseFormReturn<TFieldValues, TContext, TTransformed>,\n  options?:\n    | RhfWizardStepOptions<TFieldValues, TTransformed>\n    | ((values: TTransformed) => void),\n): () => Promise<boolean> {\n  const opts = typeof options === \"function\" ? { onValid: options } : (options ?? {});\n  const optsRef = useRef(opts);\n  useEffect(() => {\n    optsRef.current = opts;\n  });\n\n  const validate = useCallback(async (): Promise<boolean> => {\n    const current = optsRef.current;\n    if (current.fields) {\n      const ok = await form.trigger([...current.fields], { shouldFocus: true });\n      if (ok) current.onValid?.(form.getValues());\n      return ok;\n    }\n    const onValid = current.onValid as ((values: TTransformed) => void) | undefined;\n    let ok = false;\n    await form.handleSubmit(\n      (values) => {\n        ok = true;\n        onValid?.(values);\n      },\n      () => {\n        ok = false;\n      },\n    )();\n    return ok;\n  }, [form]);\n\n  const wizard = useOptionalWizardContext();\n  const register = wizard?.registerStepValidate;\n  useEffect(() => register?.(validate), [register, validate]);\n\n  return validate;\n}\n"],"mappings":";AA2CA,SAAS,aAAa,WAAW,cAAc;AAE/C,SAAS,gCAAgC;AAyBlC,SAAS,iBAKd,MACA,SAGwB;AACxB,QAAM,OAAO,OAAO,YAAY,aAAa,EAAE,SAAS,QAAQ,IAAK,WAAW,CAAC;AACjF,QAAM,UAAU,OAAO,IAAI;AAC3B,YAAU,MAAM;AACd,YAAQ,UAAU;AAAA,EACpB,CAAC;AAED,QAAM,WAAW,YAAY,YAA8B;AACzD,UAAM,UAAU,QAAQ;AACxB,QAAI,QAAQ,QAAQ;AAClB,YAAMA,MAAK,MAAM,KAAK,QAAQ,CAAC,GAAG,QAAQ,MAAM,GAAG,EAAE,aAAa,KAAK,CAAC;AACxE,UAAIA,IAAI,SAAQ,UAAU,KAAK,UAAU,CAAC;AAC1C,aAAOA;AAAA,IACT;AACA,UAAM,UAAU,QAAQ;AACxB,QAAI,KAAK;AACT,UAAM,KAAK;AAAA,MACT,CAAC,WAAW;AACV,aAAK;AACL,kBAAU,MAAM;AAAA,MAClB;AAAA,MACA,MAAM;AACJ,aAAK;AAAA,MACP;AAAA,IACF,EAAE;AACF,WAAO;AAAA,EACT,GAAG,CAAC,IAAI,CAAC;AAET,QAAM,SAAS,yBAAyB;AACxC,QAAM,WAAW,QAAQ;AACzB,YAAU,MAAM,WAAW,QAAQ,GAAG,CAAC,UAAU,QAAQ,CAAC;AAE1D,SAAO;AACT;","names":["ok"]}
+{"version":3,"sources":["../../src/rhf/use-rhf-wizard-step.ts"],"sourcesContent":["/**\n * The bridge between a react-hook-form step and the wizard's Next gate.\n * `@eifi1/ui-kit/rhf`.\n *\n * ```tsx\n * function AddressStep({ onUpdate }: { onUpdate: (v: Address) => void }) {\n *   const form = useForm<Address>({ defaultValues });\n *   useRhfWizardStep(form, { onValid: onUpdate });\n *   return <Form {...form}>…</Form>;\n * }\n * ```\n *\n * Inside a `<StepperNav>` the hook registers the step's validator with the wizard, so\n * Next (and Finish on a form-bearing last step) runs it: on success the values go to\n * `onValid` and the wizard advances; on failure the bound fields show their inline\n * messages, react-hook-form focuses the first field in error, and the wizard stays\n * put — and, since the result carries no per-field errors, says its \"fill in the\n * required fields\" line so the button did not seem to do nothing. It also RETURNS the\n * validator, for a nav of your own outside `<StepperNav>` (where there is no wizard\n * context to register with, so nothing is registered).\n *\n * Two modes:\n *\n *  - **The whole form** (no `fields`): `form.handleSubmit`, exactly as kastlan's\n *    `use-rhf-wizard-step.ts` — every rule and the resolver run, `onValid` receives\n *    the TRANSFORMED values (a zod `.transform()` included), and focus follows the\n *    form's own `shouldFocusError` (on by default).\n *  - **Some fields** (`fields: [\"iban\", \"bic\"]`): `form.trigger(fields)`, for a wizard\n *    that keeps one form across several steps, each of which validates only what it\n *    shows. The first of those fields in error is focused (`shouldFocus`; the control\n *    has to take `field.ref`), errors on fields of later steps are not raised, and\n *    `onValid` receives `form.getValues()` — the untransformed values, because a\n *    resolver's output is only produced for the whole form.\n *\n * Both callbacks are read through refs, so the validator is registered once per form\n * however the caller writes them (an inline `(v) => onUpdate(v)` is the usual case).\n *\n * The positional `useRhfWizardStep(form, onValid)` of the hook kastlan kept is the\n * whole-form mode, and still accepted.\n *\n * Why it lives here and not in `@eifi1/ui-kit/wizard`: it imports react-hook-form,\n * which only this entry may (see packaging-contract).\n */\nimport { useCallback, useEffect, useRef } from \"react\";\nimport type { FieldPath, FieldValues, UseFormReturn } from \"react-hook-form\";\nimport { useOptionalWizardContext } from \"../wizard/wizard-context\";\n\nexport type RhfWizardStepOptions<\n  TFieldValues extends FieldValues,\n  TTransformed = TFieldValues,\n> =\n  | {\n      /** Validate only these fields — the step's share of a form that spans steps. */\n      fields: readonly FieldPath<TFieldValues>[];\n      /** Called with `form.getValues()` when the fields pass, before the wizard\n       *  advances. */\n      onValid?: (values: TFieldValues) => void;\n    }\n  | {\n      /** Omitted: validate the whole form through `handleSubmit`. */\n      fields?: undefined;\n      /** Called with the form's (transformed) values when it passes, before the\n       *  wizard advances. */\n      onValid?: (values: TTransformed) => void;\n    };\n\n/**\n * Connects `form` to the wizard's step validation and returns the step's validator.\n * See the module note for the two modes.\n */\nexport function useRhfWizardStep<\n  TFieldValues extends FieldValues,\n  TContext = unknown,\n  TTransformed = TFieldValues,\n>(\n  form: UseFormReturn<TFieldValues, TContext, TTransformed>,\n  options?:\n    | RhfWizardStepOptions<TFieldValues, TTransformed>\n    | ((values: TTransformed) => void),\n): () => Promise<boolean> {\n  const opts = typeof options === \"function\" ? { onValid: options } : (options ?? {});\n  const optsRef = useRef(opts);\n  useEffect(() => {\n    optsRef.current = opts;\n  });\n\n  const validate = useCallback(async (): Promise<boolean> => {\n    const current = optsRef.current;\n    if (current.fields) {\n      const ok = await form.trigger([...current.fields], { shouldFocus: true });\n      if (ok) current.onValid?.(form.getValues());\n      return ok;\n    }\n    const onValid = current.onValid as ((values: TTransformed) => void) | undefined;\n    let ok = false;\n    await form.handleSubmit(\n      (values) => {\n        ok = true;\n        onValid?.(values);\n      },\n      () => {\n        ok = false;\n      },\n    )();\n    return ok;\n  }, [form]);\n\n  const wizard = useOptionalWizardContext();\n  const register = wizard?.registerStepValidate;\n  useEffect(() => register?.(validate), [register, validate]);\n\n  return validate;\n}\n"],"mappings":";AA2CA,SAAS,aAAa,WAAW,cAAc;AAE/C,SAAS,gCAAgC;AAyBlC,SAAS,iBAKd,MACA,SAGwB;AACxB,QAAM,OAAO,OAAO,YAAY,aAAa,EAAE,SAAS,QAAQ,IAAK,WAAW,CAAC;AACjF,QAAM,UAAU,OAAO,IAAI;AAC3B,YAAU,MAAM;AACd,YAAQ,UAAU;AAAA,EACpB,CAAC;AAED,QAAM,WAAW,YAAY,YAA8B;AACzD,UAAM,UAAU,QAAQ;AACxB,QAAI,QAAQ,QAAQ;AAClB,YAAMA,MAAK,MAAM,KAAK,QAAQ,CAAC,GAAG,QAAQ,MAAM,GAAG,EAAE,aAAa,KAAK,CAAC;AACxE,UAAIA,IAAI,SAAQ,UAAU,KAAK,UAAU,CAAC;AAC1C,aAAOA;AAAA,IACT;AACA,UAAM,UAAU,QAAQ;AACxB,QAAI,KAAK;AACT,UAAM,KAAK;AAAA,MACT,CAAC,WAAW;AACV,aAAK;AACL,kBAAU,MAAM;AAAA,MAClB;AAAA,MACA,MAAM;AACJ,aAAK;AAAA,MACP;AAAA,IACF,EAAE;AACF,WAAO;AAAA,EACT,GAAG,CAAC,IAAI,CAAC;AAET,QAAM,SAAS,yBAAyB;AACxC,QAAM,WAAW,QAAQ;AACzB,YAAU,MAAM,WAAW,QAAQ,GAAG,CAAC,UAAU,QAAQ,CAAC;AAE1D,SAAO;AACT;","names":["ok"]}

package/dist/rhf.d.ts

@@ -1,118 +1,4 @@
-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, RhfCountrySelect, RhfCountrySelectProps, RhfDateField, RhfDateFieldProps, RhfDateRangePicker, RhfDateRangePickerProps, RhfField, RhfFieldBaseProps, RhfFieldProps, RhfFieldRenderContext, RhfIbanInput, RhfIbanInputProps, RhfInlineEntityCombobox, RhfInlineEntityComboboxProps, RhfIntegerField, RhfIntegerFieldProps, RhfMoneyField, RhfMoneyFieldProps, RhfMonthPicker, RhfMonthPickerProps, RhfNumberField, RhfNumberFieldProps, RhfPhoneInput, RhfPhoneInputProps, RhfSelect, RhfSelectOption, RhfSelectProps, RhfTextCombobox, RhfTextComboboxProps, RhfTextField, RhfTextFieldProps, RhfTextarea, RhfTextareaProps, RhfTimeInput, RhfTimeInputProps, RhfToggleGroup, RhfToggleGroupProps } from './rhf/fields.js';
-export { RhfLineItemCellContext, RhfLineItems, RhfLineItemsColumn, RhfLineItemsProps } from './rhf/line-items.js';
-import 'react';
-import 'react-hook-form';
-import './delete-account-setting-DAgGBrbn.js';
-import './components/tooltip.js';
-import './hooks/use-anchored-rect.js';
-import './lib/clipping.js';
-import './data-table-labels-BJ5JE_X2.js';
-import './components/data-table-sort.js';
-import './components/swipeable-row.js';
-import './components/status-dot.js';
-import './components/progress-bar.js';
-import './components/signed-amount.js';
-import './components/stat-tile.js';
-import './components/chip.js';
-import 'lucide-react';
-import './components/field-parts.js';
-import './components/write-lock.js';
-import './components/mini-calendar.js';
-import './components/calendar-heatmap.js';
-import './components/popover.js';
-import './hooks/use-breakpoint.js';
-import './components/field-sync.js';
-import './wizard/types.js';
-import './tour/tour.js';
-import './search/command-palette.js';
-import './search/global-search.js';
-import './search/search-index.js';
-import './components/month-picker.js';
-import './components/page-contents.js';
-import './components/series-chart-labels.js';
-import './components/pie-chart-labels.js';
-import './components/sparkline.js';
-import './components/signature-pad.js';
-import './components/password-strength.js';
-import './components/swatch-picker.js';
-import './components/tile-radio.js';
-import './components/icon-picker.js';
-import './components/dialog-frame.js';
-import './components/modal.js';
-import './hooks/use-search-param-state.js';
-import './components/measured-grid.js';
-import './components/user-avatar.js';
-import './lib/person-name.js';
-import './shell/topbar-action-menu.js';
-import './components/menu-item.js';
-import './components/floating-panel.js';
-import './hooks/use-authed-src.js';
-import './components/account-settings-labels.js';
-import './components/bulk-action-bar.js';
-import './components/list.js';
-import './components/breadcrumbs.js';
-import './components/toast.js';
-import './components/description-list.js';
-import './components/line-items.js';
-import './components/error-boundary.js';
-import './components/authed-image.js';
-import './components/image-grid.js';
-import './components/lightbox.js';
-import './auth/sign-in-form.js';
-import './landing/access.js';
-import './landing/landing-labels.js';
-import './shell/topbar-controls.js';
-import './theme/palette-presets.js';
-import './theme/chart-palette.js';
-import './theme/theme-store.js';
-import 'zustand/middleware';
-import 'zustand';
-import './auth/complete-name-dialog.js';
-import './auth/forgot-password-form.js';
-import './auth/status-parts.js';
-import './auth/reset-password-form.js';
-import './auth/verify-email.js';
-import './auth/not-found-page.js';
-import './auth/accept-invitation.js';
-import './shell/company-switcher.js';
-import './account/email-change-setting.js';
-import './account/sessions-setting.js';
-import './lib/format.js';
-import './account/data-export-setting.js';
-import './components/account-chips.js';
-import './admin/admin-parts.js';
-import './admin/admin-action-log.js';
-import './settings/settings-labels.js';
-import './demo/demo-labels.js';
-import './i18n/plurals.js';
-import './components/appearance-labels.js';
-import './theme/contrast.js';
-import './theme/text-size.js';
-import './components/reauth-dialog.js';
-import './components/server-wake.js';
-import './lib/server-wake.js';
-import './components/translation-review-labels.js';
-import './lib/translation-review.js';
-import './components/country-select.js';
-import './components/inline-edit-field.js';
-import './lib/iban.js';
-import './lib/phone.js';
-import './components/sign-chip.js';
-import './components/column-mapper.js';
-import './lib/column-mapping.js';
-import './lib/table-text.js';
-import './components/focus-ring.js';
-import './components/number-field.js';
-import './components/number-input.js';
-import './components/calculator.js';
-import './components/numpad-sheet.js';
-import './components/date-picker.js';
-import './components/time-input.js';
-import './components/toggle-group.js';
-import './components/checkbox.js';
-import './components/entity-combobox.js';
-import './components/combobox-core.js';
-import './hooks/use-anchored-panel.js';
-import './components/combobox.js';
+export * from "./rhf/form.js";
+export * from "./rhf/use-rhf-wizard-step.js";
+export * from "./rhf/fields.js";
+export * from "./rhf/line-items.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, RhfIntegerField, RhfMoneyField,\n// RhfDateField, RhfTextarea, RhfSelect, RhfCheckbox, RhfCombobox, RhfTextCombobox; 0.22: RhfTimeInput,\n// RhfDateRangePicker, RhfToggleGroup, RhfIbanInput, RhfPhoneInput; 0.23: RhfCountrySelect,\n// RhfMonthPicker; 0.24: RhfInlineEntityCombobox)\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;AAMd,cAAc;AAEd,cAAc;","names":[]}
+{"version":3,"sources":["../src/rhf.ts"],"sourcesContent":["// `@eifi1/ui-kit/rhf` — the react-hook-form adapter: Form and the bound Rhf* fields (and\n// RhfField as the escape hatch). The shadcn scaffold they are built from (FormField,\n// FormItem, FormLabel, FormControl, FormDescription, FormMessage, useFormField) left the\n// surface in 0.35 (refactor audit 2026-10, API-6f; deprecated in 0.34).\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; 0.22: RhfTimeInput,\n// RhfDateRangePicker, RhfToggleGroup, RhfIbanInput, RhfPhoneInput; 0.23: RhfCountrySelect,\n// RhfMonthPicker; 0.24: RhfInlineEntityCombobox)\n// and RhfField, the shell they are built on.\nexport * from \"./rhf/fields\";\n// LineItems over useFieldArray.\nexport * from \"./rhf/line-items\";\n"],"mappings":";AAUA,cAAc;AAEd,cAAc;AAMd,cAAc;AAEd,cAAc;","names":[]}

package/dist/search/command-palette-labels.d.ts

@@ -0,0 +1,2 @@
+import type { CommandPaletteLabels } from "./command-palette.js";
+export declare const DEFAULT_COMMAND_PALETTE_LABELS: CommandPaletteLabels;

package/dist/search/command-palette-labels.js

@@ -0,0 +1,15 @@
+"use client";
+const DEFAULT_COMMAND_PALETTE_LABELS = {
+  placeholder: "Search\u2026",
+  empty: "No results",
+  loading: "Searching\u2026",
+  dialog: "Search",
+  error: "Search failed. Try again.",
+  clear: "Clear search",
+  submit: "Search",
+  close: "Close"
+};
+export {
+  DEFAULT_COMMAND_PALETTE_LABELS
+};
+//# sourceMappingURL=command-palette-labels.js.map

package/dist/search/command-palette-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/search/command-palette-labels.ts"],"sourcesContent":["// The English words of ./command-palette, in a module with no component code: the English\n// catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one\n// chunk like the other languages (0.34, KS U8). ./command-palette re-exports them.\n\nimport type { CommandPaletteLabels } from \"./command-palette\";\n\nexport const DEFAULT_COMMAND_PALETTE_LABELS: CommandPaletteLabels = {\n  placeholder: \"Search…\",\n  empty: \"No results\",\n  loading: \"Searching…\",\n  dialog: \"Search\",\n  error: \"Search failed. Try again.\",\n  clear: \"Clear search\",\n  submit: \"Search\",\n  close: \"Close\",\n};\n"],"mappings":";AAMO,MAAM,iCAAuD;AAAA,EAClE,aAAa;AAAA,EACb,OAAO;AAAA,EACP,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AACT;","names":[]}

package/dist/search/command-palette.d.ts

@@ -1,7 +1,7 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-
-interface CommandItem {
+import type { ReactNode } from "react";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import { DEFAULT_COMMAND_PALETTE_LABELS } from "./command-palette-labels.js";
+export interface CommandItem {
     id: string;
     /** Primary text. */
     label: string;
@@ -33,7 +33,7 @@ interface CommandItem {
      */
     kind?: "option" | "status";
 }
-interface CommandPaletteLabels {
+export interface CommandPaletteLabels {
     placeholder: string;
     empty: string;
     loading: string;
@@ -61,14 +61,14 @@ interface CommandPaletteLabels {
      *  backdrop to tap and, on a phone, no Escape key. */
     close?: string;
 }
-declare const DEFAULT_COMMAND_PALETTE_LABELS: CommandPaletteLabels;
+export { DEFAULT_COMMAND_PALETTE_LABELS };
 /**
  * How tall the palette's rows are. `"compact"` (the default) is the desktop list the
  * palette always drew, 36px a row; `"comfortable"` gives every row the kit's 44px touch
  * target (`min-h-11`) and body-size text — keksdose's phone search, where a 36px row
  * under a thumb picks its neighbour.
  */
-type CommandPaletteDensity = "compact" | "comfortable";
+export type CommandPaletteDensity = "compact" | "comfortable";
 interface CommandPaletteProps {
     open: boolean;
     onClose: () => void;
@@ -150,16 +150,13 @@ interface CommandPaletteProps {
     fullScreenOnPhone?: boolean;
     /** Row height — see {@link CommandPaletteDensity}. Default `"compact"`. */
     density?: CommandPaletteDensity;
-    labels?: Partial<CommandPaletteLabels>;
+    labels?: LabelOverride<CommandPaletteLabels>;
 }
-/** Registers a global ⌘K / Ctrl-K shortcut that calls `onOpen`. */
-declare function useCommandKey(onOpen: () => void): void;
+export { useCommandKey } from "./use-command-key.js";
 /**
  * A ⌘K-style command palette: a top-centred modal with a search field and a
  * grouped, keyboard-navigable result list. Domain-free — the app supplies
  * results via the `search` provider (pages, actions, records, …); each result
  * carries its own `onSelect`.
  */
-declare function CommandPalette({ open, onClose, search, revision, query: queryProp, onQueryChange, searchOn, redactLabels, fullScreenOnPhone, density, labels, }: CommandPaletteProps): react.ReactPortal | null;
-
-export { type CommandItem, CommandPalette, type CommandPaletteDensity, type CommandPaletteLabels, DEFAULT_COMMAND_PALETTE_LABELS, useCommandKey };
+export declare function CommandPalette({ open, onClose, search, revision, query: queryProp, onQueryChange, searchOn, redactLabels, fullScreenOnPhone, density, labels, }: CommandPaletteProps): import("react").ReactPortal | null;