@behivetech/forms.form-field-managed 0.1.5 → 0.1.6

package/README.md

@@ -3,6 +3,8 @@
 `FormField` with its react-hook-form wiring already done — the control's
 value/onChange/onBlur/ref, the label association, and the error message.
 
+Docs: https://bht-galaxy.vercel.app/behivetech/forms/form-field-managed
+
 Use plain [`FormField`](../form-field) when you are managing state yourself;
 use this when the field belongs to a react-hook-form form.
 

package/docs.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://github.com/behivetech/bht-component-registry/docs.schema.json",
+  "version": 2,
+  "generatedAt": "2026-10-23T19:01:35.918Z",
+  "docs": [
+    {
+      "displayName": "FormFieldManaged",
+      "description": "`FormField` with its react-hook-form wiring already done: the control's\nvalue/onChange/onBlur/ref, the label association, and the error message.\n\nUses `useController` rather than `register` because `register` only works on\ncontrols that render a native input. `TextField` and `Textarea` do;\n`Checkbox`, `Toggle` and `Select` are Radix-backed, where the ref would land\non the trigger button and the change callback is `onCheckedChange` /\n`onValueChange`, so `register` binds nothing and the field silently keeps its\ndefault. `useController` works for all of them.\n\nThe control is supplied through a render prop rather than cloned, because the\nprop a control listens on is the one thing that genuinely differs between\nthem — worth seeing at the call site, and impossible to type if hidden.\n\nPass `control` and both type parameters infer, so `field.value` is the type\nof that one field and spreads onto a control without a cast:\n\n```tsx\n<FormFieldManaged control={methods.control} name=\"email\" label=\"Email\">\n  {(field) => <TextField {...field} />}\n</FormFieldManaged>\n```\n\nTaking `control` from context instead means naming both parameters. Supplying\nonly the first — `<FormFieldManaged<Values> name=\"email\">` — leaves `TName` at\nits default and widens `field.value` to a union of every field in the form,\nbecause TypeScript stops inferring the rest once any type argument is given\nexplicitly:\n\n```tsx\n<FormFieldManaged<Values, \"email\"> name=\"email\" label=\"Email\">\n  {(field) => <TextField {...field} />}\n</FormFieldManaged>\n```",
+      "extendsNative": true,
+      "props": [
+        {
+          "name": "children",
+          "type": "(field: ManagedField<TFieldValues, TName>, fieldState: ControllerFieldState) => ReactNode",
+          "required": true,
+          "defaultValue": null,
+          "description": "Renders the control from the wired field"
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "required": true,
+          "defaultValue": null,
+          "description": "Field path in the form values; infers the field's value type"
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false,
+          "defaultValue": null,
+          "description": "Additional class names to merge with the component root element"
+        },
+        {
+          "name": "control",
+          "type": "Control<TFieldValues>",
+          "required": false,
+          "defaultValue": null,
+          "description": "Form control; falls back to the surrounding `useFormContext()` when omitted"
+        },
+        {
+          "name": "hint",
+          "type": "ReactNode",
+          "required": false,
+          "defaultValue": null,
+          "description": "Supporting hint text; hidden while `error` is present"
+        },
+        {
+          "name": "label",
+          "type": "ReactNode",
+          "required": false,
+          "defaultValue": null,
+          "description": "Field label"
+        },
+        {
+          "name": "required",
+          "type": "boolean",
+          "required": false,
+          "defaultValue": null,
+          "description": "Shows a required marker next to the label"
+        },
+        {
+          "name": "rules",
+          "type": "RegisterOptions<TFieldValues, TName>",
+          "required": false,
+          "defaultValue": null,
+          "description": "Validation rules passed through to react-hook-form"
+        }
+      ]
+    },
+    {
+      "displayName": "PartialArgsStillWiden",
+      "description": "Supplying only `TFieldValues` leaves `TName` at its default, so `value` stays\nthe union — TypeScript stops inferring the remaining parameters as soon as\none is given explicitly. This is a language rule, not something the component\ncan type its way around, which is why the docstring steers callers to\n`control` or to naming both arguments.\n\nThe expected error is the guard: if a future TypeScript infers partial type\narguments, this line stops erroring and the comment above needs revisiting.",
+      "extendsNative": false,
+      "props": []
+    }
+  ],
+  "functions": []
+}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@behivetech/forms.form-field-managed",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "license": "MIT",
+  "description": "`FormField` with its react-hook-form wiring already done — the control's value/onChange/onBlur/ref, the label association, and the error message.",
   "type": "module",
   "private": false,
   "exports": {
@@ -25,8 +26,8 @@
     "tags": []
   },
   "dependencies": {
-    "@behivetech/forms.form-field": "0.3.3",
-    "@behivetech/forms.form-provider": "0.1.5"
+    "@behivetech/forms.form-field": "0.3.4",
+    "@behivetech/forms.form-provider": "0.1.6"
   },
   "peerDependencies": {
     "react": "^19.2.7",
@@ -39,9 +40,9 @@
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "@behivetech/atoms.select": "0.4.3",
-    "@behivetech/atoms.text-field": "0.3.3",
-    "@behivetech/atoms.toggle": "0.4.3",
+    "@behivetech/atoms.select": "0.4.4",
+    "@behivetech/atoms.text-field": "0.3.4",
+    "@behivetech/atoms.toggle": "0.4.4",
     "@bht-component-registry/env": "0.1.0"
   },
   "repository": {
@@ -49,6 +50,7 @@
     "url": "https://github.com/behivetech/bht-galaxy.git",
     "directory": "registry/behivetech/forms/form-field-managed"
   },
+  "homepage": "https://bht-galaxy.vercel.app/behivetech/forms/form-field-managed",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",