@teamnovu/kit-vue-forms 0.2.17 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.0] - 2026-05-19
+
+### Added
+
+- `setInitialData` now accepts an options argument:
+  - `{ replace: true }` replaces the subtree wholesale instead of deep-merging with the external `initialData`.
+  - `{ scope: 'subtree' }` anchors the new baseline only for the targeted path and its descendants, so ancestors keep reading the external `initialData` and stay dirty when the override changes the tree shape (e.g. a new array item). `scope: 'tree'` (default) preserves the previous global-baseline behavior.
+- `useFieldArray` now exposes `pushPristine(item)` — like `push`, but anchors the new index's subtree as its own baseline so the new item's subfields start non-dirty while the array field itself stays dirty.
+
+### Changed
+
+- Initial-data resolution moved from a per-field local baseline into a form-level override layer (`useInitialDataOverride`). Overrides set via `setInitialData` on a parent path now propagate down to subfields, deep-merging with the external `initialData` by default.
+- `form.reset()` rebuilds `data` from the merged tree (external `initialData` + active overrides), so prior `setInitialData` calls survive a reset and act as the new programmatic baseline.
+- Reassigning the external `initialData` ref passed to `useForm` clears all active overrides.
+- Calling `setInitialData` on a path drops any existing override on that path or below before applying the new one.
+
+## [0.2.18] - 2025-03-03
+
+### Fixed
+
+- Correctly pass `validationState` to subForm creation instead of `formOptions`
+- Fix build error through type on `FormFieldWrapper`
+
+## [0.2.17] - 2025-01-22
+
+### Fixed
+
+- `keepValuesOnUnmount` was `false` instead of `true` by default
+
+## [0.1.27] - 2025-01-22
+
+### Fixed
+
+- `keepValuesOnUnmount` was `false` instead of `true` by default

package/dist/components/Field.vue.d.ts

@@ -19,7 +19,10 @@ declare const _default: <TData extends object, TPath extends Paths<TData>, TData
             touched: boolean;
             dirty: boolean;
             setData: (newData: PickProps<TData, TPath>) => void;
-            setInitialData: (newData: PickProps<TData, TPath>) => void;
+            setInitialData: (newData: PickProps<TData, TPath>, options?: {
+                replace?: boolean;
+                scope?: "tree" | "subtree";
+            }) => void;
             onBlur: () => void;
             onFocus: () => void;
             reset: () => void;

package/dist/components/FormFieldWrapper.vue.d.ts

@@ -12,9 +12,7 @@ declare const _default: <TData extends FormDataDefault, TPath extends Paths<TDat
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{} & VNodeProps & AllowedComponentProps & ComponentCustomProps, never>, never> & FormFieldWrapperProps<TData, TPath, TComponent, TDataOut> & Partial<{}>> & PublicProps;
     expose(exposed: ShallowUnwrapRef<{}>): void;
     attrs: any;
-    slots: Partial<Record<number, (_: any) => any>> & {
-        default?(_: {}): any;
-    };
+    slots: Readonly<Record<string, (props: any) => any>> & Record<string, (props: any) => any>;
     emit: {};
 }>) => VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;

package/dist/composables/useFieldRegistry.d.ts

@@ -3,6 +3,7 @@ import { MaybeRef, ComputedRef } from 'vue';
 import { FieldsTuple, FormDataDefault, FormField } from '../types/form';
 import { Paths, PickProps } from '../types/util';
 import { UseFieldOptions } from './useField';
+import { InitialDataOverride } from './useInitialDataOverride';
 import { ValidationState } from './useValidation';
 export type ResolvedFormField<T, K extends Paths<T>> = FormField<PickProps<T, K>, K>;
 export type DefineFieldOptions<F, K extends string> = Pick<UseFieldOptions<F, K>, 'path'> & {
@@ -21,7 +22,7 @@ interface FieldRegistryOptions {
     onChange?: <T>(path: string, value: T) => Awaitable<void>;
     onRegistered?: <T>(path: string, value: T) => Awaitable<void>;
 }
-export declare function useFieldRegistry<T extends FormDataDefault, TOut = T>(formState: FormState<T>, validationState: ValidationState<T, TOut>, fieldRegistryOptions?: FieldRegistryOptions): {
+export declare function useFieldRegistry<T extends FormDataDefault, TOut = T>(formState: FormState<T>, validationState: ValidationState<T, TOut>, initialDataOverride: InitialDataOverride<T>, fieldRegistryOptions?: FieldRegistryOptions): {
     fields: ComputedRef<FieldsTuple<T>>;
     getField: <P extends Paths<T>>(path: P) => ResolvedFormField<T, P>;
     registerField: <K extends Paths<T>>(field: ResolvedFormField<T, K>) => void;

package/dist/composables/useInitialDataOverride.d.ts

@@ -0,0 +1,13 @@
+import { ComputedRef, Ref } from 'vue';
+import { FormDataDefault } from '../types/form';
+export type InitialDataOverrideScope = 'tree' | 'subtree';
+export interface InitialDataOverrideSetOptions {
+    replace?: boolean;
+    scope?: InitialDataOverrideScope;
+}
+export interface InitialDataOverride<T extends FormDataDefault> {
+    effectiveInitialData: ComputedRef<T>;
+    resolveAt: (path: string) => unknown;
+    set: (path: string, value: unknown, options?: InitialDataOverrideSetOptions) => void;
+}
+export declare function useInitialDataOverride<T extends FormDataDefault>(initialData: Ref<T> | ComputedRef<T>): InitialDataOverride<T>;

package/dist/composables/useSubform.d.ts

@@ -1,6 +1,6 @@
 import { Form, FormDataDefault } from '../types/form';
 import { EntityPaths, PickEntity } from '../types/util';
-import { UseFormOptions } from './useForm';
+import { ValidationState } from './useValidation';
 export interface SubformOptions<_T extends FormDataDefault> {
 }
-export declare function createSubformInterface<T extends FormDataDefault, K extends EntityPaths<T>, TOut = T>(mainForm: Form<T, TOut>, path: K, formOptions?: UseFormOptions<T, TOut>, _options?: SubformOptions<PickEntity<T, K>>): Form<PickEntity<T, K>, PickEntity<TOut, K>>;
+export declare function createSubformInterface<T extends FormDataDefault, K extends EntityPaths<T>, TOut = T>(mainForm: Form<T, TOut>, path: K, validationState: ValidationState<T, TOut>, _options?: SubformOptions<PickEntity<T, K>>): Form<PickEntity<T, K>, PickEntity<TOut, K>>;