@bach.software/vue-dynamic-form 0.6.0 → 0.8.0

package/dist/src/components/__tests__/DynamicFormItem.formApi.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/__tests__/DynamicFormItem.test-helpers.d.ts

@@ -9,6 +9,12 @@ export declare function renderCount(wrapper: ReturnType<typeof mount>, path: str
 export declare function setupState(wrapper: ReturnType<typeof mount>, path: string): Record<string, any> | undefined;
 /** Reads the number of times `combinedValidation` was recomputed for a given field. Returns -1 if the field is not found. */
 export declare function constructValidationCount(wrapper: ReturnType<typeof mount>, path: string): number;
+/**
+ * Reads the current `combinedValidation` rules array reference for a given field, for
+ * reference-identity assertions. `vm.$.setupState` is `proxyRefs(...)`, which already unwraps
+ * the ref on access, so no trailing `.value` is needed here.
+ */
+export declare function combinedValidationRules(wrapper: ReturnType<typeof mount>, path: string): unknown;
 /** Reads the number of times `computedField` was recomputed for a given field. Returns -1 if the field is not found. */
 export declare function fieldComputeCount(wrapper: ReturnType<typeof mount>, path: string): number;
 /** Reads the number of times the `field` computed (bound to `props.fieldMetadata`) was recomputed. Returns -1 if the field is not found. */
@@ -17,5 +23,7 @@ export declare function fieldChangedCount(wrapper: ReturnType<typeof mount>, pat
 export declare function valueChangedCount(wrapper: ReturnType<typeof mount>, path: string): number;
 /** Reads the number of times the notify value change fired for a given field. Returns -1 if the field is not found. */
 export declare function notifyValueUpdateCount(wrapper: ReturnType<typeof mount>, path: string): number;
+/** Reads the number of times the non-input subtree silent-validate watcher actually ran (not suppressed) for a given field. Returns -1 if the field is not found. */
+export declare function subtreeValidateCount(wrapper: ReturnType<typeof mount>, path: string): number;
 /** Returns the current vee-validate form values from the TestForm wrapper. */
 export declare function formValues(wrapper: ReturnType<typeof mount>): Record<string, any>;

package/dist/src/components/__tests__/DynamicFormItemArray.formApi.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/__tests__/DynamicFormItemArray.test-helpers.d.ts

@@ -7,3 +7,5 @@ import type { mount } from '@vue/test-utils';
 export declare function setupState(wrapper: ReturnType<typeof mount>, path: string): Record<string, any> | undefined;
 /** Reads how many times the array's `combinedValidation` computed has run. Returns -1 if the array is not found. */
 export declare function arrayConstructValidationCount(wrapper: ReturnType<typeof mount>, path: string): number;
+/** Reads the array's own `meta.valid`, kept live by the silent validate in the values watcher. Returns undefined if the array is not found. */
+export declare function arrayMetaValid(wrapper: ReturnType<typeof mount>, path: string): boolean | undefined;

package/dist/src/components/__tests__/DynamicFormItemChoice.formApi.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/__tests__/DynamicFormItemChoice.test-helpers.d.ts

@@ -62,6 +62,15 @@ export declare function canAddChoiceOccurrence(wrapper: ReturnType<typeof mount>
 export declare function usedChoiceOccurrences(wrapper: ReturnType<typeof mount>, choicePath: string): number | undefined;
 /** Reads the number of rules currently present in `combinedValidation` for the choice at `path`. */
 export declare function combinedValidationCount(wrapper: ReturnType<typeof mount>, path: string): number;
+/**
+ * Reads a branch's own raw form value directly off the choice's `branchValueRefs`, resolving
+ * `branchKey` to its internal numeric index via the choice's own metadata. Unlike the fixture's
+ * rendered input, this reads the value even when the branch isn't mounted (e.g. before any
+ * `addChoiceOccurrence` call).
+ */
+export declare function branchValue(wrapper: ReturnType<typeof mount>, choicePath: string, branchKey: string): unknown;
+/** Reads the `effectiveValuesCount` computed (feeding `xsd_choiceMinOccurs`) for the choice at `path`. */
+export declare function effectiveValuesCount(wrapper: ReturnType<typeof mount>, path: string): number | undefined;
 /** Reads the `maxOccursTotalBreach` computed (the offending branch's cap, or undefined) for the choice at `path`. */
 export declare function maxOccursTotalBreach(wrapper: ReturnType<typeof mount>, path: string): number | undefined;
 /**

package/dist/src/components/__tests__/DynamicFormItemWizard.formApi.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/core/__tests__/useIsResetPending.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/core/__tests__/useIsValidationSuppressed.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/core/useIsResetPending.d.ts

@@ -0,0 +1,13 @@
+import type { MaybeRefOrGetter } from 'vue';
+/**
+ * While `resetForm()` / `resetField()` flushes, vee-validate marks every affected path state
+ * with a private `pendingReset` flag (cleared again on the next tick) so that its own value
+ * watchers skip validation during the reset. Our components own their validation timing through
+ * custom value watchers, so they must honour the same flag; otherwise the reset-triggered value
+ * change would validate the freshly reset value and write the just-cleared errors straight back.
+ *
+ * `getPathState` and `__flags` are deliberately left off vee-validate's public FormContext type,
+ * so they are read through a loosely typed access (the same way DynamicFormItem reads
+ * `keepValuesOnUnmount`).
+ */
+export declare function useIsResetPending(path: MaybeRefOrGetter<string>): () => boolean;

package/dist/src/core/useIsValidationSuppressed.d.ts

@@ -0,0 +1,20 @@
+import type { MaybeRefOrGetter } from 'vue';
+/**
+ * Makes a form context's `shouldValidate: false` argument actually stick: wraps `setFieldValue`
+ * and `setValues` so that writes which ask to skip validation are remembered until their flush
+ * settles. vee-validate only skips its *own* validation for such writes; our components run their
+ * validation from custom value watchers, which would otherwise fire regardless.
+ *
+ * Mutates the context in place (vee-validate provides the very object it returns from `useForm`),
+ * so the consumer's handle and every injected `useFormContext()` share the wrapped functions.
+ * Safe to call multiple times on the same form.
+ */
+export declare function trackNonValidatingWrites(form: unknown): void;
+/**
+ * True while the field's value is changing through a programmatic write that asked not to
+ * validate: a `resetForm()`/`resetField()` flush (vee-validate's `pendingReset` window) or a
+ * `setFieldValue`/`setValues` call with `shouldValidate: false` on a form wrapped by
+ * `trackNonValidatingWrites`. Value watchers that own validation timing must skip validation
+ * while this returns true, otherwise they would override the caller's explicit intent.
+ */
+export declare function useIsValidationSuppressed(path: MaybeRefOrGetter<string>): () => boolean;

package/dist/src/examples/ProgrammaticWritesTestCase.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/src/examples/TestForm.vue.d.ts

@@ -9,5 +9,10 @@ export interface Props {
     initialValues?: GenericObject;
     keepValuesOnUnmount?: boolean;
 }
-declare const _default: import("vue").DefineComponent<Props, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: import("vue").DefineComponent<Props, {
+    setFieldValue: <T extends string>(field: T, value: T extends `${infer K}.${infer R}` ? K extends string ? R extends string ? R extends infer T_1 ? T_1 extends R ? T_1 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? R extends infer T_2 ? T_2 extends R ? T_2 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? R extends infer T_3 ? T_3 extends R ? T_3 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? R extends infer T_4 ? T_4 extends R ? T_4 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? R extends infer T_5 ? T_5 extends R ? T_5 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? R extends infer T_6 ? T_6 extends R ? T_6 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? R extends infer T_7 ? T_7 extends R ? T_7 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? R extends infer T_8 ? T_8 extends R ? T_8 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? R extends infer T_9 ? T_9 extends R ? T_9 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? R extends infer T_10 ? T_10 extends R ? T_10 extends `${infer K}.${infer R}` ? K extends string | number | symbol ? R extends string ? /*elided*/ any : never : K extends `${number}` ? /*elided*/ any : never : T_10 extends string | number | symbol ? any : T_10 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? R & "" extends infer T_11 ? T_11 extends R & "" ? T_11 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? /*elided*/ any : never : K extends `${number}` ? never : never : T_11 extends never ? unknown : T_11 extends `${number}` ? never : never : never : never : never : T_9 extends string | number | symbol ? any : T_9 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? R & "" extends infer T_12 ? T_12 extends R & "" ? T_12 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_13 ? T_13 extends R ? T_13 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? /*elided*/ any : never : K extends `${number}` ? never : never : T_13 extends never ? unknown : T_13 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_12 extends never ? unknown : T_12 extends `${number}` ? never : never : never : never : never : T_8 extends string | number | symbol ? any : T_8 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? R & "" extends infer T_14 ? T_14 extends R & "" ? T_14 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_15 ? T_15 extends R ? T_15 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_16 ? T_16 extends R ? T_16 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? /*elided*/ any : never : K extends `${number}` ? never : never : T_16 extends never ? unknown : T_16 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_15 extends never ? unknown : T_15 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_14 extends never ? unknown : T_14 extends `${number}` ? never : never : never : never : never : T_7 extends string | number | symbol ? any : T_7 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? R & "" extends infer T_17 ? T_17 extends R & "" ? T_17 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_18 ? T_18 extends R ? T_18 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_19 ? T_19 extends R ? T_19 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_20 ? T_20 extends R ? T_20 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? /*elided*/ any : never : K extends `${number}` ? never : never : T_20 extends never ? unknown : T_20 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_19 extends never ? unknown : T_19 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_18 extends never ? unknown : T_18 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_17 extends never ? unknown : T_17 extends `${number}` ? never : never : never : never : never : T_6 extends string | number | symbol ? any : T_6 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? R & "" extends infer T_21 ? T_21 extends R & "" ? T_21 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_22 ? T_22 extends R ? T_22 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_23 ? T_23 extends R ? T_23 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_24 ? T_24 extends R ? T_24 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_25 ? T_25 extends R ? T_25 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? /*elided*/ any : never : K extends `${number}` ? never : never : T_25 extends never ? unknown : T_25 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_24 extends never ? unknown : T_24 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_23 extends never ? unknown : T_23 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_22 extends never ? unknown : T_22 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_21 extends never ? unknown : T_21 extends `${number}` ? never : never : never : never : never : T_5 extends string | number | symbol ? any : T_5 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? R & "" extends infer T_26 ? T_26 extends R & "" ? T_26 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_27 ? T_27 extends R ? T_27 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_28 ? T_28 extends R ? T_28 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_29 ? T_29 extends R ? T_29 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_30 ? T_30 extends R ? T_30 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_31 ? T_31 extends R ? T_31 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? /*elided*/ any : never : K extends `${number}` ? never : never : T_31 extends never ? unknown : T_31 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_30 extends never ? unknown : T_30 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_29 extends never ? unknown : T_29 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_28 extends never ? unknown : T_28 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_27 extends never ? unknown : T_27 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_26 extends never ? unknown : T_26 extends `${number}` ? never : never : never : never : never : T_4 extends string | number | symbol ? any : T_4 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? R & "" extends infer T_32 ? T_32 extends R & "" ? T_32 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_33 ? T_33 extends R ? T_33 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_34 ? T_34 extends R ? T_34 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_35 ? T_35 extends R ? T_35 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_36 ? T_36 extends R ? T_36 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_37 ? T_37 extends R ? T_37 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_38 ? T_38 extends R ? T_38 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? /*elided*/ any : never : K extends `${number}` ? never : never : T_38 extends never ? unknown : T_38 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_37 extends never ? unknown : T_37 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_36 extends never ? unknown : T_36 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_35 extends never ? unknown : T_35 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_34 extends never ? unknown : T_34 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_33 extends never ? unknown : T_33 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_32 extends never ? unknown : T_32 extends `${number}` ? never : never : never : never : never : T_3 extends string | number | symbol ? any : T_3 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? R & "" extends infer T_39 ? T_39 extends R & "" ? T_39 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_40 ? T_40 extends R ? T_40 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_41 ? T_41 extends R ? T_41 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_42 ? T_42 extends R ? T_42 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_43 ? T_43 extends R ? T_43 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_44 ? T_44 extends R ? T_44 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_45 ? T_45 extends R ? T_45 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_46 ? T_46 extends R ? T_46 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? /*elided*/ any : never : K extends `${number}` ? never : never : T_46 extends never ? unknown : T_46 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_45 extends never ? unknown : T_45 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_44 extends never ? unknown : T_44 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_43 extends never ? unknown : T_43 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_42 extends never ? unknown : T_42 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_41 extends never ? unknown : T_41 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_40 extends never ? unknown : T_40 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_39 extends never ? unknown : T_39 extends `${number}` ? never : never : never : never : never : T_2 extends string | number | symbol ? any : T_2 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? R & "" extends infer T_47 ? T_47 extends R & "" ? T_47 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_48 ? T_48 extends R ? T_48 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_49 ? T_49 extends R ? T_49 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_50 ? T_50 extends R ? T_50 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_51 ? T_51 extends R ? T_51 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_52 ? T_52 extends R ? T_52 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_53 ? T_53 extends R ? T_53 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_54 ? T_54 extends R ? T_54 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? R extends infer T_55 ? T_55 extends R ? T_55 extends `${infer K}.${infer R}` ? K extends never ? R extends "" ? /*elided*/ any : never : K extends `${number}` ? never : never : T_55 extends never ? unknown : T_55 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_54 extends never ? unknown : T_54 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_53 extends never ? unknown : T_53 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_52 extends never ? unknown : T_52 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_51 extends never ? unknown : T_51 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_50 extends never ? unknown : T_50 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_49 extends never ? unknown : T_49 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_48 extends never ? unknown : T_48 extends `${number}` ? never : never : never : never : never : K extends `${number}` ? never : never : T_47 extends never ? unknown : T_47 extends `${number}` ? never : never : never : never : never : T_1 extends string | number | symbol ? any : T_1 extends `${number}` ? unknown : never : never : never : never : K extends `${number}` ? never : never : T extends string ? any : T extends `${number}` ? never : never, shouldValidate?: boolean) => void;
+    setValues: (fields: {
+        [x: string]: any;
+    }, shouldValidate?: boolean) => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;