@tanstack/form-core 0.21.1 → 0.23.0

package/dist/cjs/formOptions.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function formOptions(defaultOpts) {
+  return defaultOpts;
+}
+exports.formOptions = formOptions;
+//# sourceMappingURL=formOptions.cjs.map

package/dist/cjs/formOptions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formOptions.cjs","sources":["../../src/formOptions.ts"],"sourcesContent":["import type { Validator } from './types'\nimport type { FormOptions } from './FormApi'\n\nexport function formOptions<\n  TFormData,\n  TFormValidator extends Validator<TFormData, unknown> | undefined = undefined,\n>(defaultOpts?: FormOptions<TFormData, TFormValidator>) {\n  return defaultOpts\n}\n"],"names":[],"mappings":";;AAGO,SAAS,YAGd,aAAsD;AAC/C,SAAA;AACT;;"}

package/dist/cjs/formOptions.d.cts

@@ -0,0 +1,4 @@
+import { Validator } from './types.cjs';
+import { FormOptions } from './FormApi.cjs';
+
+export declare function formOptions<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined>(defaultOpts?: FormOptions<TFormData, TFormValidator>): FormOptions<TFormData, TFormValidator> | undefined;

package/dist/cjs/index.cjs

@@ -4,6 +4,7 @@ const FormApi = require("./FormApi.cjs");
 const FieldApi = require("./FieldApi.cjs");
 const utils = require("./utils.cjs");
 const mergeForm = require("./mergeForm.cjs");
+const formOptions = require("./formOptions.cjs");
 exports.FormApi = FormApi.FormApi;
 exports.FieldApi = FieldApi.FieldApi;
 exports.deleteBy = utils.deleteBy;
@@ -16,4 +17,5 @@ exports.makePathArray = utils.makePathArray;
 exports.setBy = utils.setBy;
 exports.mergeForm = mergeForm.mergeForm;
 exports.mutateMergeDeep = mergeForm.mutateMergeDeep;
+exports.formOptions = formOptions.formOptions;
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/index.d.cts

@@ -4,3 +4,4 @@ export * from './utils.cjs';
 export * from './util-types.cjs';
 export * from './types.cjs';
 export * from './mergeForm.cjs';
+export * from './formOptions.cjs';

package/dist/cjs/mergeForm.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mergeForm.cjs","sources":["../../src/mergeForm.ts"],"sourcesContent":["import type { FormApi } from './FormApi'\nimport type { Validator } from './types'\n\nexport function mutateMergeDeep(target: object, source: object): object {\n  const targetKeys = Object.keys(target)\n  const sourceKeys = Object.keys(source)\n  const keySet = new Set([...targetKeys, ...sourceKeys])\n  for (const key of keySet) {\n    const targetKey = key as never as keyof typeof target\n    const sourceKey = key as never as keyof typeof source\n    if (Array.isArray(target[targetKey]) && Array.isArray(source[sourceKey])) {\n      target[targetKey] = [\n        ...(target[targetKey] as []),\n        ...(source[sourceKey] as []),\n      ] as never\n    } else if (\n      typeof target[targetKey] === 'object' &&\n      typeof source[sourceKey] === 'object'\n    ) {\n      mutateMergeDeep(target[targetKey] as {}, source[sourceKey] as {})\n    } else {\n      // Prevent assigning undefined to target, only if undefined is not explicitly set on source\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!(sourceKey in source) && source[sourceKey] === undefined) {\n        continue\n      }\n      target[targetKey] = source[sourceKey] as never\n    }\n  }\n  return target\n}\n\nexport function mergeForm<\n  TFormData,\n  TFormValidator extends Validator<TFormData, unknown> | undefined = undefined,\n>(\n  baseForm: FormApi<TFormData, TFormValidator>,\n  state: Partial<FormApi<TFormData, TFormValidator>['state']>,\n) {\n  mutateMergeDeep(baseForm.state, state)\n  return baseForm\n}\n"],"names":[],"mappings":";;AAGgB,SAAA,gBAAgB,QAAgB,QAAwB;AAChE,QAAA,aAAa,OAAO,KAAK,MAAM;AAC/B,QAAA,aAAa,OAAO,KAAK,MAAM;AAC/B,QAAA,6BAAa,IAAI,CAAC,GAAG,YAAY,GAAG,UAAU,CAAC;AACrD,aAAW,OAAO,QAAQ;AACxB,UAAM,YAAY;AAClB,UAAM,YAAY;AACd,QAAA,MAAM,QAAQ,OAAO,SAAS,CAAC,KAAK,MAAM,QAAQ,OAAO,SAAS,CAAC,GAAG;AACxE,aAAO,SAAS,IAAI;AAAA,QAClB,GAAI,OAAO,SAAS;AAAA,QACpB,GAAI,OAAO,SAAS;AAAA,MAAA;AAAA,IACtB,WAEA,OAAO,OAAO,SAAS,MAAM,YAC7B,OAAO,OAAO,SAAS,MAAM,UAC7B;AACA,sBAAgB,OAAO,SAAS,GAAS,OAAO,SAAS,CAAO;AAAA,IAAA,OAC3D;AAGL,UAAI,EAAE,aAAa,WAAW,OAAO,SAAS,MAAM,QAAW;AAC7D;AAAA,MACF;AACO,aAAA,SAAS,IAAI,OAAO,SAAS;AAAA,IACtC;AAAA,EACF;AACO,SAAA;AACT;AAEgB,SAAA,UAId,UACA,OACA;AACgB,kBAAA,SAAS,OAAO,KAAK;AAC9B,SAAA;AACT;;;"}
+{"version":3,"file":"mergeForm.cjs","sources":["../../src/mergeForm.ts"],"sourcesContent":["import type { FormApi } from './FormApi'\nimport type { Validator } from './types'\nimport type { NoInfer } from './util-types'\n\nexport function mutateMergeDeep(target: object, source: object): object {\n  const targetKeys = Object.keys(target)\n  const sourceKeys = Object.keys(source)\n  const keySet = new Set([...targetKeys, ...sourceKeys])\n  for (const key of keySet) {\n    const targetKey = key as never as keyof typeof target\n    const sourceKey = key as never as keyof typeof source\n    if (Array.isArray(target[targetKey]) && Array.isArray(source[sourceKey])) {\n      target[targetKey] = [\n        ...(target[targetKey] as []),\n        ...(source[sourceKey] as []),\n      ] as never\n    } else if (\n      typeof target[targetKey] === 'object' &&\n      typeof source[sourceKey] === 'object'\n    ) {\n      mutateMergeDeep(target[targetKey] as {}, source[sourceKey] as {})\n    } else {\n      // Prevent assigning undefined to target, only if undefined is not explicitly set on source\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!(sourceKey in source) && source[sourceKey] === undefined) {\n        continue\n      }\n      target[targetKey] = source[sourceKey] as never\n    }\n  }\n  return target\n}\n\nexport function mergeForm<\n  TFormData,\n  TFormValidator extends Validator<TFormData, unknown> | undefined = undefined,\n>(\n  baseForm: FormApi<NoInfer<TFormData>, NoInfer<TFormValidator>>,\n  state: Partial<FormApi<TFormData, TFormValidator>['state']>,\n) {\n  mutateMergeDeep(baseForm.state, state)\n  return baseForm\n}\n"],"names":[],"mappings":";;AAIgB,SAAA,gBAAgB,QAAgB,QAAwB;AAChE,QAAA,aAAa,OAAO,KAAK,MAAM;AAC/B,QAAA,aAAa,OAAO,KAAK,MAAM;AAC/B,QAAA,6BAAa,IAAI,CAAC,GAAG,YAAY,GAAG,UAAU,CAAC;AACrD,aAAW,OAAO,QAAQ;AACxB,UAAM,YAAY;AAClB,UAAM,YAAY;AACd,QAAA,MAAM,QAAQ,OAAO,SAAS,CAAC,KAAK,MAAM,QAAQ,OAAO,SAAS,CAAC,GAAG;AACxE,aAAO,SAAS,IAAI;AAAA,QAClB,GAAI,OAAO,SAAS;AAAA,QACpB,GAAI,OAAO,SAAS;AAAA,MAAA;AAAA,IACtB,WAEA,OAAO,OAAO,SAAS,MAAM,YAC7B,OAAO,OAAO,SAAS,MAAM,UAC7B;AACA,sBAAgB,OAAO,SAAS,GAAS,OAAO,SAAS,CAAO;AAAA,IAAA,OAC3D;AAGL,UAAI,EAAE,aAAa,WAAW,OAAO,SAAS,MAAM,QAAW;AAC7D;AAAA,MACF;AACO,aAAA,SAAS,IAAI,OAAO,SAAS;AAAA,IACtC;AAAA,EACF;AACO,SAAA;AACT;AAEgB,SAAA,UAId,UACA,OACA;AACgB,kBAAA,SAAS,OAAO,KAAK;AAC9B,SAAA;AACT;;;"}

package/dist/cjs/mergeForm.d.cts

@@ -1,5 +1,6 @@
 import { FormApi } from './FormApi.cjs';
 import { Validator } from './types.cjs';
+import { NoInfer } from './util-types.cjs';
 
 export declare function mutateMergeDeep(target: object, source: object): object;
-export declare function mergeForm<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined>(baseForm: FormApi<TFormData, TFormValidator>, state: Partial<FormApi<TFormData, TFormValidator>['state']>): FormApi<TFormData, TFormValidator>;
+export declare function mergeForm<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined>(baseForm: FormApi<NoInfer<TFormData>, NoInfer<TFormValidator>>, state: Partial<FormApi<TFormData, TFormValidator>['state']>): FormApi<NoInfer<TFormData>, NoInfer<TFormValidator>>;

package/dist/esm/formOptions.d.ts

@@ -0,0 +1,4 @@
+import { Validator } from './types.js';
+import { FormOptions } from './FormApi.js';
+
+export declare function formOptions<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined>(defaultOpts?: FormOptions<TFormData, TFormValidator>): FormOptions<TFormData, TFormValidator> | undefined;

package/dist/esm/formOptions.js

@@ -0,0 +1,7 @@
+function formOptions(defaultOpts) {
+  return defaultOpts;
+}
+export {
+  formOptions
+};
+//# sourceMappingURL=formOptions.js.map

package/dist/esm/formOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formOptions.js","sources":["../../src/formOptions.ts"],"sourcesContent":["import type { Validator } from './types'\nimport type { FormOptions } from './FormApi'\n\nexport function formOptions<\n  TFormData,\n  TFormValidator extends Validator<TFormData, unknown> | undefined = undefined,\n>(defaultOpts?: FormOptions<TFormData, TFormValidator>) {\n  return defaultOpts\n}\n"],"names":[],"mappings":"AAGO,SAAS,YAGd,aAAsD;AAC/C,SAAA;AACT;"}

package/dist/esm/index.d.ts

@@ -4,3 +4,4 @@ export * from './utils.js';
 export * from './util-types.js';
 export * from './types.js';
 export * from './mergeForm.js';
+export * from './formOptions.js';

package/dist/esm/index.js

@@ -2,10 +2,12 @@ import { FormApi } from "./FormApi.js";
 import { FieldApi } from "./FieldApi.js";
 import { deleteBy, functionalUpdate, getAsyncValidatorArray, getBy, getSyncValidatorArray, isNonEmptyArray, makePathArray, setBy } from "./utils.js";
 import { mergeForm, mutateMergeDeep } from "./mergeForm.js";
+import { formOptions } from "./formOptions.js";
 export {
   FieldApi,
   FormApi,
   deleteBy,
+  formOptions,
   functionalUpdate,
   getAsyncValidatorArray,
   getBy,

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/esm/mergeForm.d.ts

@@ -1,5 +1,6 @@
 import { FormApi } from './FormApi.js';
 import { Validator } from './types.js';
+import { NoInfer } from './util-types.js';
 
 export declare function mutateMergeDeep(target: object, source: object): object;
-export declare function mergeForm<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined>(baseForm: FormApi<TFormData, TFormValidator>, state: Partial<FormApi<TFormData, TFormValidator>['state']>): FormApi<TFormData, TFormValidator>;
+export declare function mergeForm<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined>(baseForm: FormApi<NoInfer<TFormData>, NoInfer<TFormValidator>>, state: Partial<FormApi<TFormData, TFormValidator>['state']>): FormApi<NoInfer<TFormData>, NoInfer<TFormValidator>>;

package/dist/esm/mergeForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"mergeForm.js","sources":["../../src/mergeForm.ts"],"sourcesContent":["import type { FormApi } from './FormApi'\nimport type { Validator } from './types'\n\nexport function mutateMergeDeep(target: object, source: object): object {\n  const targetKeys = Object.keys(target)\n  const sourceKeys = Object.keys(source)\n  const keySet = new Set([...targetKeys, ...sourceKeys])\n  for (const key of keySet) {\n    const targetKey = key as never as keyof typeof target\n    const sourceKey = key as never as keyof typeof source\n    if (Array.isArray(target[targetKey]) && Array.isArray(source[sourceKey])) {\n      target[targetKey] = [\n        ...(target[targetKey] as []),\n        ...(source[sourceKey] as []),\n      ] as never\n    } else if (\n      typeof target[targetKey] === 'object' &&\n      typeof source[sourceKey] === 'object'\n    ) {\n      mutateMergeDeep(target[targetKey] as {}, source[sourceKey] as {})\n    } else {\n      // Prevent assigning undefined to target, only if undefined is not explicitly set on source\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!(sourceKey in source) && source[sourceKey] === undefined) {\n        continue\n      }\n      target[targetKey] = source[sourceKey] as never\n    }\n  }\n  return target\n}\n\nexport function mergeForm<\n  TFormData,\n  TFormValidator extends Validator<TFormData, unknown> | undefined = undefined,\n>(\n  baseForm: FormApi<TFormData, TFormValidator>,\n  state: Partial<FormApi<TFormData, TFormValidator>['state']>,\n) {\n  mutateMergeDeep(baseForm.state, state)\n  return baseForm\n}\n"],"names":[],"mappings":"AAGgB,SAAA,gBAAgB,QAAgB,QAAwB;AAChE,QAAA,aAAa,OAAO,KAAK,MAAM;AAC/B,QAAA,aAAa,OAAO,KAAK,MAAM;AAC/B,QAAA,6BAAa,IAAI,CAAC,GAAG,YAAY,GAAG,UAAU,CAAC;AACrD,aAAW,OAAO,QAAQ;AACxB,UAAM,YAAY;AAClB,UAAM,YAAY;AACd,QAAA,MAAM,QAAQ,OAAO,SAAS,CAAC,KAAK,MAAM,QAAQ,OAAO,SAAS,CAAC,GAAG;AACxE,aAAO,SAAS,IAAI;AAAA,QAClB,GAAI,OAAO,SAAS;AAAA,QACpB,GAAI,OAAO,SAAS;AAAA,MAAA;AAAA,IACtB,WAEA,OAAO,OAAO,SAAS,MAAM,YAC7B,OAAO,OAAO,SAAS,MAAM,UAC7B;AACA,sBAAgB,OAAO,SAAS,GAAS,OAAO,SAAS,CAAO;AAAA,IAAA,OAC3D;AAGL,UAAI,EAAE,aAAa,WAAW,OAAO,SAAS,MAAM,QAAW;AAC7D;AAAA,MACF;AACO,aAAA,SAAS,IAAI,OAAO,SAAS;AAAA,IACtC;AAAA,EACF;AACO,SAAA;AACT;AAEgB,SAAA,UAId,UACA,OACA;AACgB,kBAAA,SAAS,OAAO,KAAK;AAC9B,SAAA;AACT;"}
+{"version":3,"file":"mergeForm.js","sources":["../../src/mergeForm.ts"],"sourcesContent":["import type { FormApi } from './FormApi'\nimport type { Validator } from './types'\nimport type { NoInfer } from './util-types'\n\nexport function mutateMergeDeep(target: object, source: object): object {\n  const targetKeys = Object.keys(target)\n  const sourceKeys = Object.keys(source)\n  const keySet = new Set([...targetKeys, ...sourceKeys])\n  for (const key of keySet) {\n    const targetKey = key as never as keyof typeof target\n    const sourceKey = key as never as keyof typeof source\n    if (Array.isArray(target[targetKey]) && Array.isArray(source[sourceKey])) {\n      target[targetKey] = [\n        ...(target[targetKey] as []),\n        ...(source[sourceKey] as []),\n      ] as never\n    } else if (\n      typeof target[targetKey] === 'object' &&\n      typeof source[sourceKey] === 'object'\n    ) {\n      mutateMergeDeep(target[targetKey] as {}, source[sourceKey] as {})\n    } else {\n      // Prevent assigning undefined to target, only if undefined is not explicitly set on source\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!(sourceKey in source) && source[sourceKey] === undefined) {\n        continue\n      }\n      target[targetKey] = source[sourceKey] as never\n    }\n  }\n  return target\n}\n\nexport function mergeForm<\n  TFormData,\n  TFormValidator extends Validator<TFormData, unknown> | undefined = undefined,\n>(\n  baseForm: FormApi<NoInfer<TFormData>, NoInfer<TFormValidator>>,\n  state: Partial<FormApi<TFormData, TFormValidator>['state']>,\n) {\n  mutateMergeDeep(baseForm.state, state)\n  return baseForm\n}\n"],"names":[],"mappings":"AAIgB,SAAA,gBAAgB,QAAgB,QAAwB;AAChE,QAAA,aAAa,OAAO,KAAK,MAAM;AAC/B,QAAA,aAAa,OAAO,KAAK,MAAM;AAC/B,QAAA,6BAAa,IAAI,CAAC,GAAG,YAAY,GAAG,UAAU,CAAC;AACrD,aAAW,OAAO,QAAQ;AACxB,UAAM,YAAY;AAClB,UAAM,YAAY;AACd,QAAA,MAAM,QAAQ,OAAO,SAAS,CAAC,KAAK,MAAM,QAAQ,OAAO,SAAS,CAAC,GAAG;AACxE,aAAO,SAAS,IAAI;AAAA,QAClB,GAAI,OAAO,SAAS;AAAA,QACpB,GAAI,OAAO,SAAS;AAAA,MAAA;AAAA,IACtB,WAEA,OAAO,OAAO,SAAS,MAAM,YAC7B,OAAO,OAAO,SAAS,MAAM,UAC7B;AACA,sBAAgB,OAAO,SAAS,GAAS,OAAO,SAAS,CAAO;AAAA,IAAA,OAC3D;AAGL,UAAI,EAAE,aAAa,WAAW,OAAO,SAAS,MAAM,QAAW;AAC7D;AAAA,MACF;AACO,aAAA,SAAS,IAAI,OAAO,SAAS;AAAA,IACtC;AAAA,EACF;AACO,SAAA;AACT;AAEgB,SAAA,UAId,UACA,OACA;AACgB,kBAAA,SAAS,OAAO,KAAK;AAC9B,SAAA;AACT;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/form-core",
-  "version": "0.21.1",
+  "version": "0.23.0",
   "description": "Powerful, type-safe, framework agnostic forms.",
   "author": "tannerlinsley",
   "license": "MIT",

package/src/formOptions.ts

@@ -0,0 +1,9 @@
+import type { Validator } from './types'
+import type { FormOptions } from './FormApi'
+
+export function formOptions<
+  TFormData,
+  TFormValidator extends Validator<TFormData, unknown> | undefined = undefined,
+>(defaultOpts?: FormOptions<TFormData, TFormValidator>) {
+  return defaultOpts
+}

package/src/index.ts

@@ -4,3 +4,4 @@ export * from './utils'
 export * from './util-types'
 export * from './types'
 export * from './mergeForm'
+export * from './formOptions'

package/src/mergeForm.ts

@@ -1,5 +1,6 @@
 import type { FormApi } from './FormApi'
 import type { Validator } from './types'
+import type { NoInfer } from './util-types'
 
 export function mutateMergeDeep(target: object, source: object): object {
   const targetKeys = Object.keys(target)
@@ -34,7 +35,7 @@ export function mergeForm<
   TFormData,
   TFormValidator extends Validator<TFormData, unknown> | undefined = undefined,
 >(
-  baseForm: FormApi<TFormData, TFormValidator>,
+  baseForm: FormApi<NoInfer<TFormData>, NoInfer<TFormValidator>>,
   state: Partial<FormApi<TFormData, TFormValidator>['state']>,
 ) {
   mutateMergeDeep(baseForm.state, state)

package/src/tests/formOptions.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, it } from 'vitest'
+import { FormApi, formOptions } from '../index'
+
+describe('formOptions', () => {
+  it('should allow default values to be set', async () => {
+    type Person = {
+      firstName: string
+      lastName: string
+    }
+
+    const formOpts = formOptions<Person>({
+      defaultValues: {
+        firstName: 'FirstName',
+        lastName: 'LastName',
+      },
+    })
+
+    const form = new FormApi({
+      ...formOpts,
+    })
+
+    expect(form.state.values['firstName']).toBe('FirstName')
+    expect(form.state.values['lastName']).toBe('LastName')
+  })
+})