@eifi1/ui-kit 0.33.0 → 0.34.0

package/dist/rhf/form-core.d.ts

@@ -0,0 +1,153 @@
+/**
+ * The react-hook-form adapter: the five parts every form is built from, and the hook
+ * they share. `@eifi1/ui-kit/rhf`.
+ *
+ * The kit's own module since 0.34 (refactor audit 2026-10, API-6f): the bound `Rhf*`
+ * fields build on these parts, and import them from here. ./form is the public face —
+ * `Form`, and until 0.35 the parts under their deprecated names, which no app imports.
+ *
+ * ```tsx
+ * <Form {...form}>
+ *   <FormField control={form.control} name="amount" render={({ field }) => (
+ *     <FormItem>
+ *       <FormLabel required>Amount</FormLabel>
+ *       <FormControl>
+ *         <NumberField value={field.value} onCommit={field.onChange} />
+ *       </FormControl>
+ *       <FormMessage />
+ *     </FormItem>
+ *   )} />
+ * </Form>
+ * ```
+ *
+ * The shape is shadcn's `form.tsx`, on purpose: Kastlan builds every form from that
+ * file, so moving onto this one is an import line rather than a rewrite. What differs
+ * is what the shadcn file gets wrong:
+ *
+ *  - **`aria-describedby` names only what is on screen.** shadcn always points the
+ *    control at a description id, rendered or not, and at the message id whenever the
+ *    field has an error, whether a message was rendered for it or not. A reference to
+ *    a node that does not exist describes the field as nothing. Here the description
+ *    and the message say when they are mounted, and the control points at exactly
+ *    those.
+ *  - **Merged, never replaced.** A control that already carries its own
+ *    `aria-describedby` keeps it, first — the same rule as the kit's `error` prop
+ *    (see `useFieldError` in components/field-parts.tsx).
+ *  - **No Radix.** `FormControl` is a one-child `cloneElement`, not `Slot`, and the
+ *    label is the kit's own `Label` — the kit carries no Radix dependency and this
+ *    entry is not the place to start.
+ *
+ * ## Why this is its own entry
+ *
+ * The main barrel once shipped a react-hook-form hook (`use-rhf-wizard-step`) and
+ * removed it: it made react-hook-form an install every consumer's typecheck paid for,
+ * for a hook nobody called (see the wizard section of src/index.ts). This is the
+ * answer to that, not a reversal of it. Nothing outside `src/rhf*` imports
+ * react-hook-form — `__tests__/packaging-contract.test.ts` holds that — and the peer is
+ * optional, so an app that does not use it installs nothing and imports nothing.
+ *
+ * ## Painting the field
+ *
+ * `FormControl` sets `aria-invalid` on its child. `NumberField` and the pickers paint
+ * from that attribute; `Input`, `Select` and `Textarea` paint only from their
+ * `invalid` prop (see its note in components/field-base.tsx: a bare attribute announces but
+ * does not paint), so pass it from the render prop —
+ * `<Input {...field} invalid={fieldState.invalid} />`. `FormControl` does not inject
+ * `invalid` itself because its child may be a native element, which would print it
+ * into the DOM as an unknown attribute.
+ *
+ * ## Clearing a picker: `null`, unless the picker is told otherwise
+ *
+ * Nothing here touches a value. `FormField` is `Controller`, so what a control hands
+ * `field.onChange` is exactly what lands in the form — and what the entity pickers
+ * hand it on a clear is `null`: `EntityCombobox`'s "×", `InlineEntityCombobox`'s "×"
+ * and its emptied text. (`MultiEntityCombobox` and `MultiSelect` clear to `[]`.)
+ *
+ * A zod schema that spells "no choice" as `""` (`z.string()`, or `z.literal("")` in a
+ * union) then fails on the `null`. Say so on the PICKER, not here:
+ *
+ * ```tsx
+ * <EntityCombobox clearValue="" value={field.value} onChange={field.onChange} … />
+ * ```
+ *
+ * `clearValue` also types `onChange` (`(v: V | "") => void` rather than
+ * `V | null`) and reads `""` back as "nothing selected", so an initial `defaultValues`
+ * of `""` shows the placeholder rather than an unresolvable id. The adapter does not
+ * coerce because it cannot see the schema: mapping `null` to `""` for every field
+ * would break every schema that wants `null` (`z.string().nullable()`), which is the
+ * pickers' default for a reason — it is the one value no option can have.
+ */
+import { type ComponentProps, type ReactElement } from "react";
+import { type ControllerProps, type FieldPath, type FieldValues } from "react-hook-form";
+import { type LabelProps } from "../components/field-base.js";
+/** The form's `useForm()` return, spread in: `<Form {...form}>`. react-hook-form's own
+ *  `FormProvider`, under the name the shadcn file gave it. */
+export declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getErrors, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, resetDefaultValues, handleSubmit, unregister, control, register, setFocus, subscribe, }: import("react-hook-form").FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+/**
+ * react-hook-form's `Controller`, with the field's name put in context for the parts
+ * below it. Takes exactly `Controller`'s props.
+ */
+export declare function FormField<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>, TTransformedValues = TFieldValues>(props: ControllerProps<TFieldValues, TName, TTransformedValues>): import("react").JSX.Element;
+/**
+ * The ids and the state of the field around the caller: for a part of your own that
+ * sits beside the kit's (a character counter that belongs in `aria-describedby`, a
+ * label with a different look).
+ *
+ * Throws outside a `FormField` + `FormItem` pair. shadcn's version answered there with
+ * ids like `undefined-form-item`, which label nothing and fail nowhere.
+ */
+export declare function useFormField(): {
+    invalid: boolean;
+    isDirty: boolean;
+    isTouched: boolean;
+    isValidating: boolean;
+    error?: import("react-hook-form").FieldError | undefined;
+    id: string;
+    name: string;
+    formItemId: string;
+    formDescriptionId: string;
+    formMessageId: string;
+    /** The ids of the description and message that are actually rendered, or
+     *  `undefined` when neither is. */
+    describedBy: string | undefined;
+};
+export type FormItemProps = ComponentProps<"div">;
+/** One field's box: mints the id its label, control, description and message share. */
+export declare function FormItem({ className, ...rest }: FormItemProps): import("react").JSX.Element;
+export type FormLabelProps = LabelProps;
+/**
+ * The kit's {@link Label}, bound to the control by `htmlFor` and turned to the danger
+ * colour while the field is invalid. `required` draws the kit's `aria-hidden` mark:
+ * whether the field is required is the control's to announce.
+ */
+export declare function FormLabel({ className, ...rest }: FormLabelProps): import("react").JSX.Element;
+export interface FormControlProps {
+    /** Exactly one element: the kit field, or a native one. It receives `id`,
+     *  `aria-describedby` and `aria-invalid`. */
+    children: ReactElement;
+}
+/**
+ * Wires its one child to the item: the `id` the label points at, `aria-describedby`
+ * naming the rendered description and message, and `aria-invalid` while the field has
+ * an error.
+ *
+ * The child's own values win where it has them (an explicit `id`, a set
+ * `aria-invalid`), as they did under Radix `Slot`; its own `aria-describedby` is
+ * merged in front of the item's rather than replaced.
+ */
+export declare function FormControl({ children }: FormControlProps): ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+export type FormDescriptionProps = ComponentProps<"p">;
+/** Standing advice under the field ("at least twelve characters"). */
+export declare function FormDescription({ className, ...rest }: FormDescriptionProps): import("react").JSX.Element;
+export type FormMessageProps = ComponentProps<"p">;
+/**
+ * The field's error message, from the form — the kit renders no string of its own
+ * here; the schema or the `rules` carry the words. Without an error it renders its
+ * `children`, if any, and otherwise nothing.
+ *
+ * Deliberately NOT `role="alert"`, for the reason the kit's `error` prop gives: the
+ * message is read when focus reaches the control, which is where a field's own error
+ * is wanted, and an alert would interrupt on every keystroke of a form that
+ * re-validates as you type.
+ */
+export declare function FormMessage({ className, children, ...rest }: FormMessageProps): import("react").JSX.Element | null;

package/dist/rhf/form-core.js

@@ -0,0 +1,143 @@
+"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/field-base.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-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-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-danger", className),
+      children: body
+    }
+  );
+}
+export {
+  Form,
+  FormControl,
+  FormDescription,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+  useFormField
+};
+//# sourceMappingURL=form-core.js.map

package/dist/rhf/form-core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/rhf/form-core.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 * The kit's own module since 0.34 (refactor audit 2026-10, API-6f): the bound `Rhf*`\n * fields build on these parts, and import them from here. ./form is the public face —\n * `Form`, and until 0.35 the parts under their deprecated names, which no app imports.\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/field-parts.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/field-base.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/field-base\";\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-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-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-danger\", className)}\n    >\n      {body}\n    </p>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/rhf/form.d.ts

@@ -1,177 +1,41 @@
-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 { e6 as LabelProps } from '../delete-account-setting-DiPX4Vue.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 '../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';
-
-/** The form's `useForm()` return, spread in: `<Form {...form}>`. react-hook-form's own
- *  `FormProvider`, under the name the shadcn file gave it. */
-declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getErrors, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, resetDefaultValues, handleSubmit, unregister, control, register, setFocus, subscribe, }: react_hook_form.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
 /**
- * react-hook-form's `Controller`, with the field's name put in context for the parts
- * below it. Takes exactly `Controller`'s props.
- */
-declare function FormField<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>, TTransformedValues = TFieldValues>(props: ControllerProps<TFieldValues, TName, TTransformedValues>): react.JSX.Element;
-/**
- * The ids and the state of the field around the caller: for a part of your own that
- * sits beside the kit's (a character counter that belongs in `aria-describedby`, a
- * label with a different look).
- *
- * Throws outside a `FormField` + `FormItem` pair. shadcn's version answered there with
- * ids like `undefined-form-item`, which label nothing and fail nowhere.
- */
-declare function useFormField(): {
-    invalid: boolean;
-    isDirty: boolean;
-    isTouched: boolean;
-    isValidating: boolean;
-    error?: react_hook_form.FieldError | undefined;
-    id: string;
-    name: string;
-    formItemId: string;
-    formDescriptionId: string;
-    formMessageId: string;
-    /** The ids of the description and message that are actually rendered, or
-     *  `undefined` when neither is. */
-    describedBy: string | undefined;
-};
-type FormItemProps = ComponentProps<"div">;
-/** One field's box: mints the id its label, control, description and message share. */
-declare function FormItem({ className, ...rest }: FormItemProps): react.JSX.Element;
-type FormLabelProps = LabelProps;
-/**
- * The kit's {@link Label}, bound to the control by `htmlFor` and turned to the danger
- * colour while the field is invalid. `required` draws the kit's `aria-hidden` mark:
- * whether the field is required is the control's to announce.
- */
-declare function FormLabel({ className, ...rest }: FormLabelProps): react.JSX.Element;
-interface FormControlProps {
-    /** Exactly one element: the kit field, or a native one. It receives `id`,
-     *  `aria-describedby` and `aria-invalid`. */
-    children: ReactElement;
-}
-/**
- * Wires its one child to the item: the `id` the label points at, `aria-describedby`
- * naming the rendered description and message, and `aria-invalid` while the field has
- * an error.
- *
- * The child's own values win where it has them (an explicit `id`, a set
- * `aria-invalid`), as they did under Radix `Slot`; its own `aria-describedby` is
- * merged in front of the item's rather than replaced.
- */
-declare function FormControl({ children }: FormControlProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
-type FormDescriptionProps = ComponentProps<"p">;
-/** Standing advice under the field ("at least twelve characters"). */
-declare function FormDescription({ className, ...rest }: FormDescriptionProps): react.JSX.Element;
-type FormMessageProps = ComponentProps<"p">;
-/**
- * The field's error message, from the form — the kit renders no string of its own
- * here; the schema or the `rules` carry the words. Without an error it renders its
- * `children`, if any, and otherwise nothing.
+ * `Form`, and until 0.35 the shadcn scaffold under its old public names — the public face
+ * of ./form-core, where the scaffold lives (its header has the whole story: what differs
+ * from shadcn's file, why /rhf is its own entry, how a picker clears).
  *
- * Deliberately NOT `role="alert"`, for the reason the kit's `error` prop gives: the
- * message is read when focus reaches the control, which is where a field's own error
- * is wanted, and an alert would interrupt on every keystroke of a form that
- * re-validates as you type.
+ * 0.34 (refactor audit 2026-10, API-6f): no app builds a form from the scaffold any more.
+ * kastlan, the one /rhf consumer, uses `Form`, the bound `Rhf*` fields and `RhfField` for
+ * a control of its own, so the seven names and their props types leave the public
+ * surface in 0.35. The bound fields import the parts from the core, so the removal is
+ * the block below.
  */
-declare function FormMessage({ className, children, ...rest }: FormMessageProps): react.JSX.Element | null;
-
-export { Form, FormControl, type FormControlProps, FormDescription, type FormDescriptionProps, FormField, FormItem, type FormItemProps, FormLabel, type FormLabelProps, FormMessage, type FormMessageProps, useFormField };
+import * as core from "./form-core.js";
+export { Form } from "./form-core.js";
+/** @deprecated 0.34 — the bound `Rhf*` fields, or `RhfField` for a control of your own;
+ *  removed in 0.35 (API-6f). */
+export declare const FormField: typeof core.FormField;
+/** @deprecated 0.34 — `RhfField`, which reads the field's ids itself; removed in 0.35
+ *  (API-6f). */
+export declare const useFormField: typeof core.useFormField;
+/** @deprecated 0.34 — the bound `Rhf*` fields, or `RhfField`; removed in 0.35 (API-6f). */
+export declare const FormItem: typeof core.FormItem;
+/** @deprecated 0.34 — the bound fields' and `RhfField`'s `label`; removed in 0.35 (API-6f). */
+export declare const FormLabel: typeof core.FormLabel;
+/** @deprecated 0.34 — `RhfField`, which wires its control the same way; removed in 0.35
+ *  (API-6f). */
+export declare const FormControl: typeof core.FormControl;
+/** @deprecated 0.34 — the bound fields' and `RhfField`'s `hint`; removed in 0.35 (API-6f). */
+export declare const FormDescription: typeof core.FormDescription;
+/** @deprecated 0.34 — the bound fields and `RhfField`, which show the error themselves;
+ *  removed in 0.35 (API-6f). */
+export declare const FormMessage: typeof core.FormMessage;
+/** @deprecated 0.34 — goes with `FormItem`; removed in 0.35 (API-6f). */
+export type FormItemProps = core.FormItemProps;
+/** @deprecated 0.34 — goes with `FormLabel`; removed in 0.35 (API-6f). */
+export type FormLabelProps = core.FormLabelProps;
+/** @deprecated 0.34 — goes with `FormControl`; removed in 0.35 (API-6f). */
+export type FormControlProps = core.FormControlProps;
+/** @deprecated 0.34 — goes with `FormDescription`; removed in 0.35 (API-6f). */
+export type FormDescriptionProps = core.FormDescriptionProps;
+/** @deprecated 0.34 — goes with `FormMessage`; removed in 0.35 (API-6f). */
+export type FormMessageProps = core.FormMessageProps;