@assistant-ui/react-hook-form 0.12.14 → 0.12.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,5 +1,39 @@
1
1
  # `@assistant-ui/react-hook-form`
2
2
 
3
- React Hook Form integration for `@assistant-ui/react`.
3
+ [React Hook Form](https://react-hook-form.com) integration for `@assistant-ui/react`. Replace `useForm` with `useAssistantForm` to give the assistant the ability to read and fill your form fields through tool calls.
4
4
 
5
- Simply replace `useForm` with `useAssistantForm` to give the chatbot the ability to interact with your form.
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install @assistant-ui/react @assistant-ui/react-hook-form react-hook-form
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```tsx
14
+ "use client";
15
+
16
+ import { useAssistantForm } from "@assistant-ui/react-hook-form";
17
+
18
+ export function SignupForm() {
19
+ const form = useAssistantForm({
20
+ defaultValues: { firstName: "", lastName: "", email: "" },
21
+ assistant: {
22
+ tools: {
23
+ set_form_field: { render: () => <FieldUpdated /> },
24
+ submit_form: { render: () => <FormSubmitted /> },
25
+ },
26
+ },
27
+ });
28
+
29
+ return <form onSubmit={form.handleSubmit(onSubmit)}>{/* fields */}</form>;
30
+ }
31
+ ```
32
+
33
+ The assistant gets two built-in tools: `set_form_field` to write values into fields and `submit_form` to call your submit handler.
34
+
35
+ ## See also
36
+
37
+ - `@assistant-ui/react-lexical` if you also want a rich-text composer with `@`-mention support inside the same chat.
38
+
39
+ Full API reference at [assistant-ui.com/docs/api-reference/integrations/react-hook-form](https://www.assistant-ui.com/docs/api-reference/integrations/react-hook-form). See [`examples/with-react-hook-form`](https://github.com/assistant-ui/assistant-ui/tree/main/examples/with-react-hook-form) for a complete app.
@@ -1,19 +1,23 @@
1
1
  import { z } from "zod";
2
- export declare const formTools: {
3
- set_form_field: {
4
- description: string;
5
- parameters: z.ZodObject<{
6
- name: z.ZodString;
7
- value: z.ZodString;
8
- }, z.core.$strip>;
9
- };
10
- submit_form: {
11
- description: string;
12
- parameters: z.ZodObject<{}, z.core.$strip>;
13
- };
14
- reset_form: {
15
- description: string;
16
- parameters: z.ZodObject<{}, z.core.$strip>;
17
- };
2
+
3
+ //#region src/formTools.d.ts
4
+ declare const formTools: {
5
+ set_form_field: {
6
+ description: string;
7
+ parameters: z.ZodObject<{
8
+ name: z.ZodString;
9
+ value: z.ZodString;
10
+ }, z.core.$strip>;
11
+ };
12
+ submit_form: {
13
+ description: string;
14
+ parameters: z.ZodObject<{}, z.core.$strip>;
15
+ };
16
+ reset_form: {
17
+ description: string;
18
+ parameters: z.ZodObject<{}, z.core.$strip>;
19
+ };
18
20
  };
21
+ //#endregion
22
+ export { formTools };
19
23
  //# sourceMappingURL=formTools.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"formTools.d.ts","sourceRoot":"","sources":["../src/formTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;CAkBrB,CAAC"}
1
+ {"version":3,"file":"formTools.d.ts","names":[],"sources":["../src/formTools.ts"],"mappings":";;;cAEa,SAAA"}
package/dist/formTools.js CHANGED
@@ -1,19 +1,23 @@
1
1
  import { z } from "zod";
2
- export const formTools = {
3
- set_form_field: {
4
- description: "Sets a form field. Call this function as soon as the user provides the data for each field.",
5
- parameters: z.object({
6
- name: z.string(),
7
- value: z.string(),
8
- }),
9
- },
10
- submit_form: {
11
- description: "Submits the form. Confirm with user before submitting.",
12
- parameters: z.object({}),
13
- },
14
- reset_form: {
15
- description: "Resets all form fields to their initial values. Confirm with user before resetting.",
16
- parameters: z.object({}),
17
- },
2
+ //#region src/formTools.ts
3
+ const formTools = {
4
+ set_form_field: {
5
+ description: "Sets a form field. Call this function as soon as the user provides the data for each field.",
6
+ parameters: z.object({
7
+ name: z.string(),
8
+ value: z.string()
9
+ })
10
+ },
11
+ submit_form: {
12
+ description: "Submits the form. Confirm with user before submitting.",
13
+ parameters: z.object({})
14
+ },
15
+ reset_form: {
16
+ description: "Resets all form fields to their initial values. Confirm with user before resetting.",
17
+ parameters: z.object({})
18
+ }
18
19
  };
20
+ //#endregion
21
+ export { formTools };
22
+
19
23
  //# sourceMappingURL=formTools.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"formTools.js","sourceRoot":"","sources":["../src/formTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,cAAc,EAAE;QACd,WAAW,EACT,6FAA6F;QAC/F,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SAClB,CAAC;KACH;IACD,WAAW,EAAE;QACX,WAAW,EAAE,wDAAwD;QACrE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KACzB;IACD,UAAU,EAAE;QACV,WAAW,EACT,qFAAqF;QACvF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KACzB;CACF,CAAC"}
1
+ {"version":3,"file":"formTools.js","names":[],"sources":["../src/formTools.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const formTools = {\n set_form_field: {\n description:\n \"Sets a form field. Call this function as soon as the user provides the data for each field.\",\n parameters: z.object({\n name: z.string(),\n value: z.string(),\n }),\n },\n submit_form: {\n description: \"Submits the form. Confirm with user before submitting.\",\n parameters: z.object({}),\n },\n reset_form: {\n description:\n \"Resets all form fields to their initial values. Confirm with user before resetting.\",\n parameters: z.object({}),\n },\n};\n"],"mappings":";;AAEA,MAAa,YAAY;CACvB,gBAAgB;EACd,aACE;EACF,YAAY,EAAE,OAAO;GACnB,MAAM,EAAE,OAAO;GACf,OAAO,EAAE,OAAO;EAClB,CAAC;CACH;CACA,aAAa;EACX,aAAa;EACb,YAAY,EAAE,OAAO,CAAC,CAAC;CACzB;CACA,YAAY;EACV,aACE;EACF,YAAY,EAAE,OAAO,CAAC,CAAC;CACzB;AACF"}
package/dist/index.d.ts CHANGED
@@ -1,3 +1,3 @@
1
- export { useAssistantForm, type UseAssistantFormProps, } from "./useAssistantForm.js";
2
- export { formTools } from "./formTools.js";
3
- //# sourceMappingURL=index.d.ts.map
1
+ import { formTools } from "./formTools.js";
2
+ import { UseAssistantFormProps, useAssistantForm } from "./useAssistantForm.js";
3
+ export { type UseAssistantFormProps, formTools, useAssistantForm };
package/dist/index.js CHANGED
@@ -1,3 +1,3 @@
1
- export { useAssistantForm, } from "./useAssistantForm.js";
2
- export { formTools } from "./formTools.js";
3
- //# sourceMappingURL=index.js.map
1
+ import { formTools } from "./formTools.js";
2
+ import { useAssistantForm } from "./useAssistantForm.js";
3
+ export { formTools, useAssistantForm };
@@ -1,21 +1,25 @@
1
- import { type ToolCallMessagePartComponent } from "@assistant-ui/core/react";
2
- import { type FieldValues, type UseFormProps, type UseFormReturn } from "react-hook-form";
3
- import type { z } from "zod";
4
1
  import { formTools } from "./formTools.js";
5
- export type UseAssistantFormProps<TFieldValues extends FieldValues, TContext, TTransformedValues> = UseFormProps<TFieldValues, TContext, TTransformedValues> & {
6
- assistant?: {
7
- tools?: {
8
- set_form_field?: {
9
- render?: ToolCallMessagePartComponent<z.infer<(typeof formTools.set_form_field)["parameters"]>, unknown> | undefined;
10
- } | undefined;
11
- submit_form?: {
12
- render?: ToolCallMessagePartComponent<z.infer<(typeof formTools.submit_form)["parameters"]>, unknown> | undefined;
13
- } | undefined;
14
- reset_form?: {
15
- render?: ToolCallMessagePartComponent<z.infer<(typeof formTools.reset_form)["parameters"]>, unknown> | undefined;
16
- } | undefined;
17
- } | undefined;
2
+ import { z } from "zod";
3
+ import { ToolCallMessagePartComponent } from "@assistant-ui/core/react";
4
+ import { FieldValues, UseFormProps, UseFormReturn } from "react-hook-form";
5
+
6
+ //#region src/useAssistantForm.d.ts
7
+ type UseAssistantFormProps<TFieldValues extends FieldValues, TContext, TTransformedValues> = UseFormProps<TFieldValues, TContext, TTransformedValues> & {
8
+ assistant?: {
9
+ tools?: {
10
+ set_form_field?: {
11
+ render?: ToolCallMessagePartComponent<z.infer<(typeof formTools.set_form_field)["parameters"]>, unknown> | undefined;
12
+ } | undefined;
13
+ submit_form?: {
14
+ render?: ToolCallMessagePartComponent<z.infer<(typeof formTools.submit_form)["parameters"]>, unknown> | undefined;
15
+ } | undefined;
16
+ reset_form?: {
17
+ render?: ToolCallMessagePartComponent<z.infer<(typeof formTools.reset_form)["parameters"]>, unknown> | undefined;
18
+ } | undefined;
18
19
  } | undefined;
20
+ } | undefined;
19
21
  };
20
- export declare const useAssistantForm: <TFieldValues extends FieldValues = FieldValues, TContext = any, TTransformedValues = TFieldValues>(props?: UseAssistantFormProps<TFieldValues, TContext, TTransformedValues>) => UseFormReturn<TFieldValues, TContext, TTransformedValues>;
22
+ declare const useAssistantForm: <TFieldValues extends FieldValues = FieldValues, TContext = any, TTransformedValues = TFieldValues>(props?: UseAssistantFormProps<TFieldValues, TContext, TTransformedValues>) => UseFormReturn<TFieldValues, TContext, TTransformedValues>;
23
+ //#endregion
24
+ export { UseAssistantFormProps, useAssistantForm };
21
25
  //# sourceMappingURL=useAssistantForm.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"useAssistantForm.d.ts","sourceRoot":"","sources":["../src/useAssistantForm.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,4BAA4B,EAElC,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,KAAK,WAAW,EAGhB,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,uBAAoB;AAExC,MAAM,MAAM,qBAAqB,CAC/B,YAAY,SAAS,WAAW,EAChC,QAAQ,EACR,kBAAkB,IAChB,YAAY,CAAC,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CAAC,GAAG;IAC7D,SAAS,CAAC,EACN;QACE,KAAK,CAAC,EACF;YACE,cAAc,CAAC,EACX;gBACE,MAAM,CAAC,EACH,4BAA4B,CAC1B,CAAC,CAAC,KAAK,CACL,CAAC,OAAO,SAAS,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAChD,EACD,OAAO,CACR,GACD,SAAS,CAAC;aACf,GACD,SAAS,CAAC;YACd,WAAW,CAAC,EACR;gBACE,MAAM,CAAC,EACH,4BAA4B,CAC1B,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,EACrD,OAAO,CACR,GACD,SAAS,CAAC;aACf,GACD,SAAS,CAAC;YACd,UAAU,CAAC,EACP;gBACE,MAAM,CAAC,EACH,4BAA4B,CAC1B,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,EACpD,OAAO,CACR,GACD,SAAS,CAAC;aACf,GACD,SAAS,CAAC;SACf,GACD,SAAS,CAAC;KACf,GACD,SAAS,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,QAAQ,GAAG,GAAG,EACd,kBAAkB,GAAG,YAAY,EAEjC,QAAQ,qBAAqB,CAAC,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CAAC,KACxE,aAAa,CAAC,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CA4G1D,CAAC"}
1
+ {"version":3,"file":"useAssistantForm.d.ts","names":[],"sources":["../src/useAssistantForm.ts"],"mappings":";;;;;;KAqBY,qBAAA,sBACW,WAAA,kCAGnB,YAAA,CAAa,YAAA,EAAc,QAAA,EAAU,kBAAA;EACvC,SAAA;IAEM,KAAA;MAEM,cAAA;QAEM,MAAA,GACI,4BAAA,CACE,CAAA,CAAE,KAAA,SACQ,SAAA,CAAU,cAAA;MAAA;MAOhC,WAAA;QAEM,MAAA,GACI,4BAAA,CACE,CAAA,CAAE,KAAA,SAAc,SAAA,CAAU,WAAA;MAAA;MAMtC,UAAA;QAEM,MAAA,GACI,4BAAA,CACE,CAAA,CAAE,KAAA,SAAc,SAAA,CAAU,UAAA;MAAA;IAAA;EAAA;AAAA;AAAA,cAYvC,gBAAA,wBACU,WAAA,GAAc,WAAA,uCAEd,YAAA,EAErB,KAAA,GAAQ,qBAAA,CAAsB,YAAA,EAAc,QAAA,EAAU,kBAAA,MACrD,aAAA,CAAc,YAAA,EAAc,QAAA,EAAU,kBAAA"}
@@ -1,91 +1,90 @@
1
1
  "use client";
2
+ import { formTools } from "./formTools.js";
2
3
  import { tool } from "@assistant-ui/core";
3
- import { useAssistantToolUI, } from "@assistant-ui/core/react";
4
+ import { useAssistantToolUI } from "@assistant-ui/core/react";
4
5
  import { useAui } from "@assistant-ui/store";
5
6
  import { useEffect } from "react";
6
- import { useForm, } from "react-hook-form";
7
- import { formTools } from "./formTools.js";
8
- export const useAssistantForm = (props) => {
9
- const form = useForm(props);
10
- const { control, getValues, setValue, reset, formState: { isSubmitting }, } = form;
11
- const aui = useAui();
12
- useEffect(() => {
13
- const value = {
14
- system: `Form State:\n${JSON.stringify(getValues())}`,
15
- tools: {
16
- set_form_field: tool({
17
- ...formTools.set_form_field,
18
- parameters: formTools.set_form_field.parameters,
19
- execute: async (args) => {
20
- setValue(args.name, args.value);
21
- return { success: true };
22
- },
23
- }),
24
- submit_form: tool({
25
- ...formTools.submit_form,
26
- execute: async () => {
27
- if (isSubmitting) {
28
- return {
29
- success: false,
30
- message: "The form is already submitting.",
31
- };
32
- }
33
- const { _names, _fields } = control;
34
- for (const name of _names.mount) {
35
- const field = _fields[name];
36
- if (field?._f && "refs" in field._f) {
37
- const fieldReference = Array.isArray(field._f.refs)
38
- ? field._f.refs[0]
39
- : field._f.ref;
40
- if (fieldReference instanceof HTMLElement) {
41
- const form = fieldReference.closest("form");
42
- if (form) {
43
- form.requestSubmit();
44
- return { success: true };
45
- }
46
- }
47
- }
48
- }
49
- return {
50
- success: false,
51
- message: "Unable retrieve the form element. This is a coding error.",
52
- };
53
- },
54
- }),
55
- reset_form: tool({
56
- ...formTools.reset_form,
57
- execute: async () => {
58
- reset();
59
- return { success: true };
60
- },
61
- }),
62
- },
63
- };
64
- return aui.modelContext().register({
65
- getModelContext: () => value,
66
- });
67
- }, [control, setValue, getValues, aui, reset, isSubmitting]);
68
- const renderFormFieldTool = props?.assistant?.tools?.set_form_field?.render;
69
- useAssistantToolUI(renderFormFieldTool
70
- ? {
71
- toolName: "set_form_field",
72
- render: renderFormFieldTool,
73
- }
74
- : null);
75
- const renderSubmitFormTool = props?.assistant?.tools?.submit_form?.render;
76
- useAssistantToolUI(renderSubmitFormTool
77
- ? {
78
- toolName: "submit_form",
79
- render: renderSubmitFormTool,
80
- }
81
- : null);
82
- const renderResetFormTool = props?.assistant?.tools?.reset_form?.render;
83
- useAssistantToolUI(renderResetFormTool
84
- ? {
85
- toolName: "reset_form",
86
- render: renderResetFormTool,
87
- }
88
- : null);
89
- return form;
7
+ import { useForm } from "react-hook-form";
8
+ //#region src/useAssistantForm.ts
9
+ const useAssistantForm = (props) => {
10
+ const form = useForm(props);
11
+ const { control, getValues, setValue, reset, formState: { isSubmitting } } = form;
12
+ const aui = useAui();
13
+ useEffect(() => {
14
+ const value = {
15
+ system: `Form State:\n${JSON.stringify(getValues())}`,
16
+ tools: {
17
+ set_form_field: tool({
18
+ ...formTools.set_form_field,
19
+ parameters: formTools.set_form_field.parameters,
20
+ execute: async (args) => {
21
+ setValue(args.name, args.value);
22
+ return { success: true };
23
+ }
24
+ }),
25
+ submit_form: tool({
26
+ ...formTools.submit_form,
27
+ execute: async () => {
28
+ if (isSubmitting) return {
29
+ success: false,
30
+ message: "The form is already submitting."
31
+ };
32
+ const { _names, _fields } = control;
33
+ for (const name of _names.mount) {
34
+ const field = _fields[name];
35
+ if (field?._f && "refs" in field._f) {
36
+ const fieldReference = Array.isArray(field._f.refs) ? field._f.refs[0] : field._f.ref;
37
+ if (fieldReference instanceof HTMLElement) {
38
+ const form = fieldReference.closest("form");
39
+ if (form) {
40
+ form.requestSubmit();
41
+ return { success: true };
42
+ }
43
+ }
44
+ }
45
+ }
46
+ return {
47
+ success: false,
48
+ message: "Unable retrieve the form element. This is a coding error."
49
+ };
50
+ }
51
+ }),
52
+ reset_form: tool({
53
+ ...formTools.reset_form,
54
+ execute: async () => {
55
+ reset();
56
+ return { success: true };
57
+ }
58
+ })
59
+ }
60
+ };
61
+ return aui.modelContext().register({ getModelContext: () => value });
62
+ }, [
63
+ control,
64
+ setValue,
65
+ getValues,
66
+ aui,
67
+ reset,
68
+ isSubmitting
69
+ ]);
70
+ const renderFormFieldTool = props?.assistant?.tools?.set_form_field?.render;
71
+ useAssistantToolUI(renderFormFieldTool ? {
72
+ toolName: "set_form_field",
73
+ render: renderFormFieldTool
74
+ } : null);
75
+ const renderSubmitFormTool = props?.assistant?.tools?.submit_form?.render;
76
+ useAssistantToolUI(renderSubmitFormTool ? {
77
+ toolName: "submit_form",
78
+ render: renderSubmitFormTool
79
+ } : null);
80
+ const renderResetFormTool = props?.assistant?.tools?.reset_form?.render;
81
+ useAssistantToolUI(renderResetFormTool ? {
82
+ toolName: "reset_form",
83
+ render: renderResetFormTool
84
+ } : null);
85
+ return form;
90
86
  };
87
+ //#endregion
88
+ export { useAssistantForm };
89
+
91
90
  //# sourceMappingURL=useAssistantForm.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"useAssistantForm.js","sourceRoot":"","sources":["../src/useAssistantForm.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"useAssistantForm.js","names":[],"sources":["../src/useAssistantForm.ts"],"sourcesContent":["\"use client\";\n\nimport { type ModelContext, tool } from \"@assistant-ui/core\";\nimport type {} from \"@assistant-ui/core/store\";\nimport {\n type ToolCallMessagePartComponent,\n useAssistantToolUI,\n} from \"@assistant-ui/core/react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport { useEffect } from \"react\";\nimport {\n type FieldValues,\n type Path,\n type PathValue,\n type UseFormProps,\n type UseFormReturn,\n useForm,\n} from \"react-hook-form\";\nimport type { z } from \"zod\";\nimport { formTools } from \"./formTools\";\n\nexport type UseAssistantFormProps<\n TFieldValues extends FieldValues,\n TContext,\n TTransformedValues,\n> = UseFormProps<TFieldValues, TContext, TTransformedValues> & {\n assistant?:\n | {\n tools?:\n | {\n set_form_field?:\n | {\n render?:\n | ToolCallMessagePartComponent<\n z.infer<\n (typeof formTools.set_form_field)[\"parameters\"]\n >,\n unknown\n >\n | undefined;\n }\n | undefined;\n submit_form?:\n | {\n render?:\n | ToolCallMessagePartComponent<\n z.infer<(typeof formTools.submit_form)[\"parameters\"]>,\n unknown\n >\n | undefined;\n }\n | undefined;\n reset_form?:\n | {\n render?:\n | ToolCallMessagePartComponent<\n z.infer<(typeof formTools.reset_form)[\"parameters\"]>,\n unknown\n >\n | undefined;\n }\n | undefined;\n }\n | undefined;\n }\n | undefined;\n};\n\nexport const useAssistantForm = <\n TFieldValues extends FieldValues = FieldValues,\n TContext = any,\n TTransformedValues = TFieldValues,\n>(\n props?: UseAssistantFormProps<TFieldValues, TContext, TTransformedValues>,\n): UseFormReturn<TFieldValues, TContext, TTransformedValues> => {\n const form = useForm<TFieldValues, TContext, TTransformedValues>(props);\n const {\n control,\n getValues,\n setValue,\n reset,\n formState: { isSubmitting },\n } = form;\n\n const aui = useAui();\n useEffect(() => {\n const value: ModelContext = {\n system: `Form State:\\n${JSON.stringify(getValues())}`,\n\n tools: {\n set_form_field: tool({\n ...formTools.set_form_field,\n parameters: formTools.set_form_field.parameters,\n execute: async (args) => {\n setValue(\n args.name as Path<TFieldValues>,\n args.value as PathValue<TFieldValues, Path<TFieldValues>>,\n );\n\n return { success: true };\n },\n }),\n submit_form: tool({\n ...formTools.submit_form,\n execute: async () => {\n if (isSubmitting) {\n return {\n success: false,\n message: \"The form is already submitting.\",\n };\n }\n const { _names, _fields } = control;\n for (const name of _names.mount) {\n const field = _fields[name];\n if (field?._f && \"refs\" in field._f) {\n const fieldReference = Array.isArray(field._f.refs)\n ? field._f.refs[0]\n : field._f.ref;\n\n if (fieldReference instanceof HTMLElement) {\n const form = fieldReference.closest(\"form\");\n if (form) {\n form.requestSubmit();\n\n return { success: true };\n }\n }\n }\n }\n\n return {\n success: false,\n message:\n \"Unable retrieve the form element. This is a coding error.\",\n };\n },\n }),\n reset_form: tool({\n ...formTools.reset_form,\n execute: async () => {\n reset();\n return { success: true };\n },\n }),\n },\n };\n return aui.modelContext().register({\n getModelContext: () => value,\n });\n }, [control, setValue, getValues, aui, reset, isSubmitting]);\n\n const renderFormFieldTool = props?.assistant?.tools?.set_form_field?.render;\n useAssistantToolUI(\n renderFormFieldTool\n ? {\n toolName: \"set_form_field\",\n render: renderFormFieldTool,\n }\n : null,\n );\n\n const renderSubmitFormTool = props?.assistant?.tools?.submit_form?.render;\n useAssistantToolUI(\n renderSubmitFormTool\n ? {\n toolName: \"submit_form\",\n render: renderSubmitFormTool,\n }\n : null,\n );\n\n const renderResetFormTool = props?.assistant?.tools?.reset_form?.render;\n useAssistantToolUI(\n renderResetFormTool\n ? {\n toolName: \"reset_form\",\n render: renderResetFormTool,\n }\n : null,\n );\n\n return form;\n};\n"],"mappings":";;;;;;;;AAoEA,MAAa,oBAKX,UAC8D;CAC9D,MAAM,OAAO,QAAoD,KAAK;CACtE,MAAM,EACJ,SACA,WACA,UACA,OACA,WAAW,EAAE,mBACX;CAEJ,MAAM,MAAM,OAAO;CACnB,gBAAgB;EACd,MAAM,QAAsB;GAC1B,QAAQ,gBAAgB,KAAK,UAAU,UAAU,CAAC;GAElD,OAAO;IACL,gBAAgB,KAAK;KACnB,GAAG,UAAU;KACb,YAAY,UAAU,eAAe;KACrC,SAAS,OAAO,SAAS;MACvB,SACE,KAAK,MACL,KAAK,KACP;MAEA,OAAO,EAAE,SAAS,KAAK;KACzB;IACF,CAAC;IACD,aAAa,KAAK;KAChB,GAAG,UAAU;KACb,SAAS,YAAY;MACnB,IAAI,cACF,OAAO;OACL,SAAS;OACT,SAAS;MACX;MAEF,MAAM,EAAE,QAAQ,YAAY;MAC5B,KAAK,MAAM,QAAQ,OAAO,OAAO;OAC/B,MAAM,QAAQ,QAAQ;OACtB,IAAI,OAAO,MAAM,UAAU,MAAM,IAAI;QACnC,MAAM,iBAAiB,MAAM,QAAQ,MAAM,GAAG,IAAI,IAC9C,MAAM,GAAG,KAAK,KACd,MAAM,GAAG;QAEb,IAAI,0BAA0B,aAAa;SACzC,MAAM,OAAO,eAAe,QAAQ,MAAM;SAC1C,IAAI,MAAM;UACR,KAAK,cAAc;UAEnB,OAAO,EAAE,SAAS,KAAK;SACzB;QACF;OACF;MACF;MAEA,OAAO;OACL,SAAS;OACT,SACE;MACJ;KACF;IACF,CAAC;IACD,YAAY,KAAK;KACf,GAAG,UAAU;KACb,SAAS,YAAY;MACnB,MAAM;MACN,OAAO,EAAE,SAAS,KAAK;KACzB;IACF,CAAC;GACH;EACF;EACA,OAAO,IAAI,aAAa,EAAE,SAAS,EACjC,uBAAuB,MACzB,CAAC;CACH,GAAG;EAAC;EAAS;EAAU;EAAW;EAAK;EAAO;CAAY,CAAC;CAE3D,MAAM,sBAAsB,OAAO,WAAW,OAAO,gBAAgB;CACrE,mBACE,sBACI;EACE,UAAU;EACV,QAAQ;CACV,IACA,IACN;CAEA,MAAM,uBAAuB,OAAO,WAAW,OAAO,aAAa;CACnE,mBACE,uBACI;EACE,UAAU;EACV,QAAQ;CACV,IACA,IACN;CAEA,MAAM,sBAAsB,OAAO,WAAW,OAAO,YAAY;CACjE,mBACE,sBACI;EACE,UAAU;EACV,QAAQ;CACV,IACA,IACN;CAEA,OAAO;AACT"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@assistant-ui/react-hook-form",
3
- "version": "0.12.14",
3
+ "version": "0.12.15",
4
4
  "description": "React Hook Form integration for assistant-ui",
5
5
  "keywords": [
6
6
  "react-hook-form",
@@ -29,8 +29,8 @@
29
29
  ],
30
30
  "sideEffects": false,
31
31
  "dependencies": {
32
- "@assistant-ui/core": "^0.2.0",
33
- "@assistant-ui/store": "^0.2.10",
32
+ "@assistant-ui/core": "^0.2.5",
33
+ "@assistant-ui/store": "^0.2.12",
34
34
  "zod": "^4.4.3"
35
35
  },
36
36
  "peerDependencies": {
@@ -44,10 +44,10 @@
44
44
  }
45
45
  },
46
46
  "devDependencies": {
47
- "@types/react": "^19.2.14",
48
- "react": "^19.2.5",
49
- "react-hook-form": "^7.75.0",
50
- "@assistant-ui/x-buildutils": "0.0.7"
47
+ "@types/react": "^19.2.15",
48
+ "react": "^19.2.6",
49
+ "react-hook-form": "^7.76.0",
50
+ "@assistant-ui/x-buildutils": "0.0.9"
51
51
  },
52
52
  "publishConfig": {
53
53
  "access": "public",
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,8BAA2B;AAC5B,OAAO,EAAE,SAAS,EAAE,uBAAoB"}
package/dist/index.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAEjB,8BAA2B;AAC5B,OAAO,EAAE,SAAS,EAAE,uBAAoB"}