@vuecs/forms 4.0.1 → 5.0.1

package/dist/components/form-group/FormGroup.vue.d.ts

@@ -1,7 +1,7 @@
-import type { ComponentDefaultValues, ComponentThemeDefinition, ThemeClassesOverride, ThemeElementDefinition, VariantValues } from '@vuecs/core';
+import type { ComponentThemeDefinition, ThemeClassesOverride, ThemeElementDefinition, VariantValues } from '@vuecs/core';
 import type { ExtractPublicPropTypes, PropType, SlotsType } from 'vue';
 import { ValidationSeverity } from '../constants';
-import type { ValidationMessages } from '../type';
+import type { FieldValidation, ValidationMessages } from '../type';
 import { type ValidationGroupDefaultSlotProps, type ValidationGroupItemSlotProps } from '../validation-group';
 export type FormGroupThemeClasses = {
     root: string;
@@ -10,16 +10,10 @@ export type FormGroupThemeClasses = {
     validationError: string;
     validationWarning: string;
 };
-export type FormGroupDefaults = {
-    validation: boolean;
-};
 declare module '@vuecs/core' {
     interface ThemeElements {
         formGroup?: ThemeElementDefinition<FormGroupThemeClasses>;
     }
-    interface ComponentDefaults {
-        formGroup?: ComponentDefaultValues<FormGroupDefaults>;
-    }
 }
 export declare const formGroupThemeDefaults: ComponentThemeDefinition<FormGroupThemeClasses>;
 declare const formGroupProps: {
@@ -53,17 +47,35 @@ declare const formGroupProps: {
         type: StringConstructor;
         default: any;
     };
-    /** When `true`, render the validation messages section. Falls back to the global `formGroup.validation` default. */
+    /**
+     * Bundle prop accepting a `FieldValidation` (`{ severity, messages }`)
+     * — wins over `validationSeverity` + `validationMessages` when set.
+     *
+     * Canonical use is with `@ilingo/validup-vue`'s `useFieldValidation`:
+     * `<VCFormGroup :validation="useFieldValidation($v.fields.email)">`.
+     * Structural typing — vuecs and `@ilingo/validup-vue` declare matching
+     * shapes without either importing the other.
+     *
+     * Pass `null` / `undefined` to fall through to the legacy props.
+     */
     validation: {
-        type: BooleanConstructor;
+        type: PropType<FieldValidation | null>;
         default: any;
     };
-    /** Severity used to colour the validation messages (`error` / `warning`). */
+    /**
+     * @deprecated Pass a `FieldValidation` via `:validation` instead.
+     * Severity used to colour the validation messages (`error` /
+     * `warning`). Ignored when `:validation` is set.
+     */
     validationSeverity: {
         type: PropType<`${ValidationSeverity}` | undefined>;
         default: any;
     };
-    /** Validation messages — keyed object or ordered array of `{ key, value }`. */
+    /**
+     * @deprecated Pass a `FieldValidation` via `:validation` instead.
+     * Validation messages — keyed object or ordered array of
+     * `{ key, value }`. Ignored when `:validation` is set.
+     */
     validationMessages: {
         type: PropType<ValidationMessages>;
         default: any;
@@ -113,17 +125,35 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         type: StringConstructor;
         default: any;
     };
-    /** When `true`, render the validation messages section. Falls back to the global `formGroup.validation` default. */
+    /**
+     * Bundle prop accepting a `FieldValidation` (`{ severity, messages }`)
+     * — wins over `validationSeverity` + `validationMessages` when set.
+     *
+     * Canonical use is with `@ilingo/validup-vue`'s `useFieldValidation`:
+     * `<VCFormGroup :validation="useFieldValidation($v.fields.email)">`.
+     * Structural typing — vuecs and `@ilingo/validup-vue` declare matching
+     * shapes without either importing the other.
+     *
+     * Pass `null` / `undefined` to fall through to the legacy props.
+     */
     validation: {
-        type: BooleanConstructor;
+        type: PropType<FieldValidation | null>;
         default: any;
     };
-    /** Severity used to colour the validation messages (`error` / `warning`). */
+    /**
+     * @deprecated Pass a `FieldValidation` via `:validation` instead.
+     * Severity used to colour the validation messages (`error` /
+     * `warning`). Ignored when `:validation` is set.
+     */
     validationSeverity: {
         type: PropType<`${ValidationSeverity}` | undefined>;
         default: any;
     };
-    /** Validation messages — keyed object or ordered array of `{ key, value }`. */
+    /**
+     * @deprecated Pass a `FieldValidation` via `:validation` instead.
+     * Validation messages — keyed object or ordered array of
+     * `{ key, value }`. Ignored when `:validation` is set.
+     */
     validationMessages: {
         type: PropType<ValidationMessages>;
         default: any;
@@ -171,17 +201,35 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         type: StringConstructor;
         default: any;
     };
-    /** When `true`, render the validation messages section. Falls back to the global `formGroup.validation` default. */
+    /**
+     * Bundle prop accepting a `FieldValidation` (`{ severity, messages }`)
+     * — wins over `validationSeverity` + `validationMessages` when set.
+     *
+     * Canonical use is with `@ilingo/validup-vue`'s `useFieldValidation`:
+     * `<VCFormGroup :validation="useFieldValidation($v.fields.email)">`.
+     * Structural typing — vuecs and `@ilingo/validup-vue` declare matching
+     * shapes without either importing the other.
+     *
+     * Pass `null` / `undefined` to fall through to the legacy props.
+     */
     validation: {
-        type: BooleanConstructor;
+        type: PropType<FieldValidation | null>;
         default: any;
     };
-    /** Severity used to colour the validation messages (`error` / `warning`). */
+    /**
+     * @deprecated Pass a `FieldValidation` via `:validation` instead.
+     * Severity used to colour the validation messages (`error` /
+     * `warning`). Ignored when `:validation` is set.
+     */
     validationSeverity: {
         type: PropType<`${ValidationSeverity}` | undefined>;
         default: any;
     };
-    /** Validation messages — keyed object or ordered array of `{ key, value }`. */
+    /**
+     * @deprecated Pass a `FieldValidation` via `:validation` instead.
+     * Validation messages — keyed object or ordered array of
+     * `{ key, value }`. Ignored when `:validation` is set.
+     */
     validationMessages: {
         type: PropType<ValidationMessages>;
         default: any;
@@ -205,7 +253,7 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     labelTag: string;
     hintTag: string;
     hintContent: string;
-    validation: boolean;
+    validation: FieldValidation;
     validationSeverity: "error" | "warning";
     validationMessages: ValidationMessages;
 }, SlotsType<{

package/dist/components/form-group/FormGroup.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormGroup.vue.d.ts","sourceRoot":"","sources":["../../../src/components/form-group/FormGroup.vue"],"names":[],"mappings":"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"}
+{"version":3,"file":"FormGroup.vue.d.ts","sourceRoot":"","sources":["../../../src/components/form-group/FormGroup.vue"],"names":[],"mappings":"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"}

package/dist/components/form-group/index.d.ts

@@ -1,5 +1,5 @@
 import FormGroup from './FormGroup.vue';
 export { FormGroup as VCFormGroup };
 export { formGroupThemeDefaults } from './FormGroup.vue';
-export type { FormGroupProps, FormGroupThemeClasses, FormGroupDefaults } from './FormGroup.vue';
+export type { FormGroupProps, FormGroupThemeClasses } from './FormGroup.vue';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/form-group/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/form-group/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,iBAAiB,CAAC;AAExC,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/form-group/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,iBAAiB,CAAC;AAExC,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/components/form-input/FormInput.vue.d.ts

@@ -17,9 +17,9 @@ export type FormInputGroupSlotProps = {
     tag: string;
 };
 declare const formInputProps: {
-    /** Controlled string value (v-model). */
+    /** Controlled string value (v-model). `null` is the documented "unset" value. */
     modelValue: {
-        type: StringConstructor;
+        type: PropType<string | null | undefined>;
         default: string;
     };
     /** Native `<input type>` attribute. */
@@ -72,9 +72,9 @@ export type FormInputProps = ExtractPublicPropTypes<typeof formInputProps>;
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    /** Controlled string value (v-model). */
+    /** Controlled string value (v-model). `null` is the documented "unset" value. */
     modelValue: {
-        type: StringConstructor;
+        type: PropType<string | null | undefined>;
         default: string;
     };
     /** Native `<input type>` attribute. */
@@ -125,9 +125,9 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
 }>, () => string | number | boolean | void | import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
 }> | import("vue").VNodeArrayChildren, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "update:modelValue"[], "update:modelValue", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    /** Controlled string value (v-model). */
+    /** Controlled string value (v-model). `null` is the documented "unset" value. */
     modelValue: {
-        type: StringConstructor;
+        type: PropType<string | null | undefined>;
         default: string;
     };
     /** Native `<input type>` attribute. */

package/dist/components/form-input/FormInput.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormInput.vue.d.ts","sourceRoot":"","sources":["../../../src/components/form-input/FormInput.vue"],"names":[],"mappings":"AA6JA,OAAO,KAAK,EACR,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EAChB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACR,sBAAsB,EACtB,QAAQ,EACR,SAAS,EAEZ,MAAM,KAAK,CAAC;AASb,MAAM,MAAM,qBAAqB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,OAAO,QAAQ,aAAa,CAAC;IACzB,UAAU,aAAa;QACnB,SAAS,CAAC,EAAE,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;KAC7D;CACJ;AAED,eAAO,MAAM,sBAAsB,EAAE,wBAAwB,CAAC,qBAAqB,CAOlF,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,QAAA,MAAM,cAAc;IAChB,yCAAyC;;;;;IAEzC,uCAAuC;;;;;IAEvC,gFAAgF;;;;;IAEhF,8GAA8G;;;;;IAE9G,0DAA0D;;;;;IAE1D,4GAA4G;;;;;IAE5G,yDAAyD;;;;;IAEzD,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;;;IACnF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;CAC1D,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC,OAAO,cAAc,CAAC,CAAC;wBAEtD,OAAO,YAAY;AAAxC,wBAAyC;AAQzC,QAAA,MAAM,YAAY;IAhCd,yCAAyC;;;;;IAEzC,uCAAuC;;;;;IAEvC,gFAAgF;;;;;IAEhF,8GAA8G;;;;;IAE9G,0DAA0D;;;;;IAE1D,4GAA4G;;;;;IAE5G,yDAAyD;;;;;IAEzD,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;;;IACnF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;IAnBvD,yCAAyC;;;;;IAEzC,uCAAuC;;;;;IAEvC,gFAAgF;;;;;IAEhF,8GAA8G;;;;;IAE9G,0DAA0D;;;;;IAE1D,4GAA4G;;;;;IAE5G,yDAAyD;;;;;IAEzD,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;;;IACnF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;;;iBAuBtC,uBAAuB;kBACtB,uBAAuB;yEAiE3C,CAAC"}
+{"version":3,"file":"FormInput.vue.d.ts","sourceRoot":"","sources":["../../../src/components/form-input/FormInput.vue"],"names":[],"mappings":"AA6JA,OAAO,KAAK,EACR,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EAChB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACR,sBAAsB,EACtB,QAAQ,EACR,SAAS,EAEZ,MAAM,KAAK,CAAC;AASb,MAAM,MAAM,qBAAqB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,OAAO,QAAQ,aAAa,CAAC;IACzB,UAAU,aAAa;QACnB,SAAS,CAAC,EAAE,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;KAC7D;CACJ;AAED,eAAO,MAAM,sBAAsB,EAAE,wBAAwB,CAAC,qBAAqB,CAOlF,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,QAAA,MAAM,cAAc;IAChB,iFAAiF;;cAC3C,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;;;IACzE,uCAAuC;;;;;IAEvC,gFAAgF;;;;;IAEhF,8GAA8G;;;;;IAE9G,0DAA0D;;;;;IAE1D,4GAA4G;;;;;IAE5G,yDAAyD;;;;;IAEzD,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;;;IACnF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;CAC1D,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC,OAAO,cAAc,CAAC,CAAC;wBAEtD,OAAO,YAAY;AAAxC,wBAAyC;AAQzC,QAAA,MAAM,YAAY;IAhCd,iFAAiF;;cAC3C,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;;;IACzE,uCAAuC;;;;;IAEvC,gFAAgF;;;;;IAEhF,8GAA8G;;;;;IAE9G,0DAA0D;;;;;IAE1D,4GAA4G;;;;;IAE5G,yDAAyD;;;;;IAEzD,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;;;IACnF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;IAnBvD,iFAAiF;;cAC3C,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;;;IACzE,uCAAuC;;;;;IAEvC,gFAAgF;;;;;IAEhF,8GAA8G;;;;;IAE9G,0DAA0D;;;;;IAE1D,4GAA4G;;;;;IAE5G,yDAAyD;;;;;IAEzD,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;;;IACnF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;;;iBAuBtC,uBAAuB;kBACtB,uBAAuB;yEAiE3C,CAAC"}

package/dist/components/form-textarea/FormTextarea.vue.d.ts

@@ -10,9 +10,9 @@ declare module '@vuecs/core' {
 }
 export declare const formTextareaThemeDefaults: ComponentThemeDefinition<FormTextareaThemeClasses>;
 declare const formTextareaProps: {
-    /** Controlled string value (v-model). */
+    /** Controlled string value (v-model). `null` is the documented "unset" value. */
     modelValue: {
-        type: StringConstructor;
+        type: PropType<string | null | undefined>;
         default: string;
     };
     /** Debounce window (ms) for `update:modelValue` emissions. `0` disables debouncing. */
@@ -35,9 +35,9 @@ export type FormTextareaProps = ExtractPublicPropTypes<typeof formTextareaProps>
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    /** Controlled string value (v-model). */
+    /** Controlled string value (v-model). `null` is the documented "unset" value. */
     modelValue: {
-        type: StringConstructor;
+        type: PropType<string | null | undefined>;
         default: string;
     };
     /** Debounce window (ms) for `update:modelValue` emissions. `0` disables debouncing. */
@@ -58,9 +58,9 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "update:modelValue"[], "update:modelValue", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    /** Controlled string value (v-model). */
+    /** Controlled string value (v-model). `null` is the documented "unset" value. */
     modelValue: {
-        type: StringConstructor;
+        type: PropType<string | null | undefined>;
         default: string;
     };
     /** Debounce window (ms) for `update:modelValue` emissions. `0` disables debouncing. */

package/dist/components/form-textarea/FormTextarea.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormTextarea.vue.d.ts","sourceRoot":"","sources":["../../../src/components/form-textarea/FormTextarea.vue"],"names":[],"mappings":"AAqFA,OAAO,KAAK,EACR,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EAChB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAS5D,MAAM,MAAM,wBAAwB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,OAAO,QAAQ,aAAa,CAAC;IACzB,UAAU,aAAa;QACnB,YAAY,CAAC,EAAE,sBAAsB,CAAC,wBAAwB,CAAC,CAAC;KACnE;CACJ;AAED,eAAO,MAAM,yBAAyB,EAAE,wBAAwB,CAAC,wBAAwB,CAA6B,CAAC;AAEvH,QAAA,MAAM,iBAAiB;IACnB,yCAAyC;;;;;IAEzC,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;;;IACtF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;CAC1D,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,OAAO,iBAAiB,CAAC,CAAC;wBAE5D,OAAO,YAAY;AAAxC,wBAAyC;AAQzC,QAAA,MAAM,YAAY;IApBd,yCAAyC;;;;;IAEzC,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;;;IACtF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;IAPvD,yCAAyC;;;;;IAEzC,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;;;IACtF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;4EAiDzD,CAAC"}
+{"version":3,"file":"FormTextarea.vue.d.ts","sourceRoot":"","sources":["../../../src/components/form-textarea/FormTextarea.vue"],"names":[],"mappings":"AAqFA,OAAO,KAAK,EACR,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EAChB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAS5D,MAAM,MAAM,wBAAwB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,OAAO,QAAQ,aAAa,CAAC;IACzB,UAAU,aAAa;QACnB,YAAY,CAAC,EAAE,sBAAsB,CAAC,wBAAwB,CAAC,CAAC;KACnE;CACJ;AAED,eAAO,MAAM,yBAAyB,EAAE,wBAAwB,CAAC,wBAAwB,CAA6B,CAAC;AAEvH,QAAA,MAAM,iBAAiB;IACnB,iFAAiF;;cAC3C,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;;;IACzE,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;;;IACtF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;CAC1D,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,OAAO,iBAAiB,CAAC,CAAC;wBAE5D,OAAO,YAAY;AAAxC,wBAAyC;AAQzC,QAAA,MAAM,YAAY;IApBd,iFAAiF;;cAC3C,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;;;IACzE,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;;;IACtF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;IAPvD,iFAAiF;;cAC3C,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;;;IACzE,uFAAuF;;;;;IAEvF,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;;;IACtF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;4EAiDzD,CAAC"}

package/dist/components/type.d.ts

@@ -14,4 +14,31 @@ export type ValidationMessagesArrayStyle = {
     value: string;
 }[];
 export type ValidationMessages = ValidationMessagesArrayStyle | ValidationMessagesRecordStyle;
+/**
+ * Single-prop bundle a `<VCFormGroup>` host consumes via `:validation`.
+ *
+ * Structurally identical to `@ilingo/validup-vue`'s exported
+ * `FieldValidation` (and the return shape of `useFieldValidation`), so
+ * the canonical bridge usage —
+ * `<VCFormGroup :validation="useFieldValidation($v.fields.email)">` —
+ * type-checks without either package importing the other (cross-package
+ * structural compatibility; vuecs stays neutral about validation
+ * libraries).
+ *
+ * `severity` accepts `'success'` for forward compatibility with
+ * validation bridges that surface a "passed" state; vuecs currently
+ * renders no class for it (the `:validation-success` theme slot is not
+ * yet defined), so `'success'` behaves like `undefined` at the DOM
+ * level. `error` and `warning` apply the matching `validationError` /
+ * `validationWarning` theme class on the root.
+ *
+ * `messages` is array-style only (the `{ key, value }[]` shape vuecs
+ * already renders inside `<VCValidationGroup>`). Producers using the
+ * legacy record shape (`Record<string, string>`) keep using
+ * `:validation-messages` directly.
+ */
+export type FieldValidation = {
+    severity?: 'error' | 'warning' | 'success';
+    messages: ValidationMessagesArrayStyle;
+};
 //# sourceMappingURL=type.d.ts.map

package/dist/components/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/components/type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI;IACxC,MAAM,EAAE,CAAC,CAAC;IAEV,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,4BAA4B,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC;AAE5E,MAAM,MAAM,kBAAkB,GAAG,4BAA4B,GAAG,6BAA6B,CAAC"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/components/type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI;IACxC,MAAM,EAAE,CAAC,CAAC;IAEV,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,4BAA4B,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC;AAE5E,MAAM,MAAM,kBAAkB,GAAG,4BAA4B,GAAG,6BAA6B,CAAC;AAE9F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,QAAQ,EAAE,4BAA4B,CAAC;CAC1C,CAAC"}

package/dist/components/validation-group/ValidationGroup.vue.d.ts

@@ -11,9 +11,18 @@ declare module '@vuecs/core' {
     }
 }
 export declare const validationGroupThemeDefaults: ComponentThemeDefinition<ValidationGroupThemeClasses>;
+/**
+ * Severity union the slot props expose. Wider than `ValidationSeverity`
+ * (`error` / `warning`) so a `<VCFormGroup :validation>` bundle whose
+ * `severity` is `'success'` or `undefined` flows through to slot
+ * consumers as-is — instead of being collapsed back to `'error'` by
+ * the prop default, which would mislead the slot rendering on
+ * pristine / valid fields.
+ */
+export type ValidationGroupSeverity = `${ValidationSeverity}` | 'success' | undefined;
 export type ValidationGroupDefaultSlotProps = {
     data: ValidationMessagesArrayStyle;
-    severity: `${ValidationSeverity}`;
+    severity: ValidationGroupSeverity;
     itemClass: string;
     itemTag: string;
 };
@@ -22,13 +31,25 @@ export type ValidationGroupItemSlotProps = {
     value: string;
     class: string;
     tag: string;
-    severity: `${ValidationSeverity}`;
+    severity: ValidationGroupSeverity;
 };
 declare const validationGroupProps: {
-    /** Severity used to colour the rendered messages (`error` / `warning`). */
+    /**
+     * Severity used to colour the rendered messages. Accepts
+     * `'error' | 'warning'` (the vuecs-native vocabulary) plus
+     * `'success'` for forward-compat with validation bridges that
+     * surface a "passed" state (see `<VCFormGroup>`'s `:validation`
+     * bundle).
+     *
+     * Default is `undefined` — slot consumers receive the actual
+     * value passed by the host. The previous default of
+     * `ValidationSeverity.ERROR` is gone; if a slot template needs an
+     * error fallback when none is supplied, do it at the call site
+     * (`severity ?? 'error'`).
+     */
     severity: {
-        type: PropType<`${ValidationSeverity}`>;
-        default: ValidationSeverity;
+        type: PropType<ValidationGroupSeverity>;
+        default: any;
     };
     /** Validation messages — keyed object or ordered array of `{ key, value }`. */
     messages: {
@@ -55,10 +76,22 @@ export type ValidationGroupProps = ExtractPublicPropTypes<typeof validationGroup
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    /** Severity used to colour the rendered messages (`error` / `warning`). */
+    /**
+     * Severity used to colour the rendered messages. Accepts
+     * `'error' | 'warning'` (the vuecs-native vocabulary) plus
+     * `'success'` for forward-compat with validation bridges that
+     * surface a "passed" state (see `<VCFormGroup>`'s `:validation`
+     * bundle).
+     *
+     * Default is `undefined` — slot consumers receive the actual
+     * value passed by the host. The previous default of
+     * `ValidationSeverity.ERROR` is gone; if a slot template needs an
+     * error fallback when none is supplied, do it at the call site
+     * (`severity ?? 'error'`).
+     */
     severity: {
-        type: PropType<`${ValidationSeverity}`>;
-        default: ValidationSeverity;
+        type: PropType<ValidationGroupSeverity>;
+        default: any;
     };
     /** Validation messages — keyed object or ordered array of `{ key, value }`. */
     messages: {
@@ -81,10 +114,22 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         default: any;
     };
 }>, () => VNodeChild, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    /** Severity used to colour the rendered messages (`error` / `warning`). */
+    /**
+     * Severity used to colour the rendered messages. Accepts
+     * `'error' | 'warning'` (the vuecs-native vocabulary) plus
+     * `'success'` for forward-compat with validation bridges that
+     * surface a "passed" state (see `<VCFormGroup>`'s `:validation`
+     * bundle).
+     *
+     * Default is `undefined` — slot consumers receive the actual
+     * value passed by the host. The previous default of
+     * `ValidationSeverity.ERROR` is gone; if a slot template needs an
+     * error fallback when none is supplied, do it at the call site
+     * (`severity ?? 'error'`).
+     */
     severity: {
-        type: PropType<`${ValidationSeverity}`>;
-        default: ValidationSeverity;
+        type: PropType<ValidationGroupSeverity>;
+        default: any;
     };
     /** Validation messages — keyed object or ordered array of `{ key, value }`. */
     messages: {
@@ -109,7 +154,7 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
 }>> & Readonly<{}>, {
     themeClass: ThemeClassesOverride<ValidationGroupThemeClasses>;
     themeVariant: VariantValues;
-    severity: "error" | "warning";
+    severity: ValidationGroupSeverity;
     messages: ValidationMessages;
     itemTag: string;
 }, SlotsType<{

package/dist/components/validation-group/ValidationGroup.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ValidationGroup.vue.d.ts","sourceRoot":"","sources":["../../../src/components/validation-group/ValidationGroup.vue"],"names":[],"mappings":"AAuHA,OAAO,KAAK,EACR,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACR,sBAAsB,EACtB,QAAQ,EACR,SAAS,EAET,UAAU,EACb,MAAM,KAAK,CAAC;AAEb,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEhF,MAAM,MAAM,2BAA2B,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,OAAO,QAAQ,aAAa,CAAC;IACzB,UAAU,aAAa;QACnB,eAAe,CAAC,EAAE,sBAAsB,CAAC,2BAA2B,CAAC,CAAC;KACzE;CACJ;AAED,eAAO,MAAM,4BAA4B,EAAE,wBAAwB,CAAC,2BAA2B,CAA2D,CAAC;AAE3J,MAAM,MAAM,+BAA+B,GAAG;IAC1C,IAAI,EAAE,4BAA4B,CAAC;IACnC,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAAC;CACrC,CAAC;AAEF,QAAA,MAAM,oBAAoB;IACtB,2EAA2E;;cAC/C,QAAQ,CAAC,GAAG,kBAAkB,EAAE,CAAC;;;IAC7D,+EAA+E;;cAC1C,QAAQ,CAAC,kBAAkB,CAAC;;;IACjE,+CAA+C;;;;;IAE/C,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;;;IACzF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;CAC1D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,OAAO,oBAAoB,CAAC,CAAC;wBAElE,OAAO,YAAY;AAAxC,wBAAyC;AAQzC,QAAA,MAAM,YAAY;IAtBd,2EAA2E;;cAC/C,QAAQ,CAAC,GAAG,kBAAkB,EAAE,CAAC;;;IAC7D,+EAA+E;;cAC1C,QAAQ,CAAC,kBAAkB,CAAC;;;IACjE,+CAA+C;;;;;IAE/C,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;;;IACzF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;IATvD,2EAA2E;;cAC/C,QAAQ,CAAC,GAAG,kBAAkB,EAAE,CAAC;;;IAC7D,+EAA+E;;cAC1C,QAAQ,CAAC,kBAAkB,CAAC;;;IACjE,+CAA+C;;;;;IAE/C,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;;;IACzF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;aAiB1C,+BAA+B;UAClC,4BAA4B;yEA+CxC,CAAC"}
+{"version":3,"file":"ValidationGroup.vue.d.ts","sourceRoot":"","sources":["../../../src/components/validation-group/ValidationGroup.vue"],"names":[],"mappings":"AA6IA,OAAO,KAAK,EACR,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACR,sBAAsB,EACtB,QAAQ,EACR,SAAS,EAET,UAAU,EACb,MAAM,KAAK,CAAC;AAEb,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEhF,MAAM,MAAM,2BAA2B,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,OAAO,QAAQ,aAAa,CAAC;IACzB,UAAU,aAAa;QACnB,eAAe,CAAC,EAAE,sBAAsB,CAAC,2BAA2B,CAAC,CAAC;KACzE;CACJ;AAED,eAAO,MAAM,4BAA4B,EAAE,wBAAwB,CAAC,2BAA2B,CAA2D,CAAC;AAE3J;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,GAAG,kBAAkB,EAAE,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtF,MAAM,MAAM,+BAA+B,GAAG;IAC1C,IAAI,EAAE,4BAA4B,CAAC;IACnC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,uBAAuB,CAAC;CACrC,CAAC;AAEF,QAAA,MAAM,oBAAoB;IACtB;;;;;;;;;;;;OAYG;;cACyB,QAAQ,CAAC,uBAAuB,CAAC;;;IAC7D,+EAA+E;;cAC1C,QAAQ,CAAC,kBAAkB,CAAC;;;IACjE,+CAA+C;;;;;IAE/C,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;;;IACzF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;CAC1D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,OAAO,oBAAoB,CAAC,CAAC;wBAElE,OAAO,YAAY;AAAxC,wBAAyC;AAQzC,QAAA,MAAM,YAAY;IAlCd;;;;;;;;;;;;OAYG;;cACyB,QAAQ,CAAC,uBAAuB,CAAC;;;IAC7D,+EAA+E;;cAC1C,QAAQ,CAAC,kBAAkB,CAAC;;;IACjE,+CAA+C;;;;;IAE/C,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;;;IACzF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;IArBvD;;;;;;;;;;;;OAYG;;cACyB,QAAQ,CAAC,uBAAuB,CAAC;;;IAC7D,+EAA+E;;cAC1C,QAAQ,CAAC,kBAAkB,CAAC;;;IACjE,+CAA+C;;;;;IAE/C,yDAAyD;;cAC3B,QAAQ,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;;;IACzF,wDAAwD;;cACxB,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;aAiB1C,+BAA+B;UAClC,4BAA4B;yEA+CxC,CAAC"}

package/dist/index.mjs

@@ -9,7 +9,7 @@ const formCheckboxThemeDefaults = { classes: {
 	label: "vc-form-checkbox-label",
 	group: "vc-form-checkbox-wrapper"
 } };
-const behavioralDefaults$4 = { labelContent: "Input" };
+const behavioralDefaults$3 = { labelContent: "Input" };
 //#endregion
 //#region src/components/form-checkbox/FormCheckbox.vue
 var FormCheckbox_default = defineComponent({
@@ -80,7 +80,7 @@ var FormCheckbox_default = defineComponent({
 	slots: Object,
 	setup(props, { attrs, emit, slots }) {
 		const theme = useComponentTheme("formCheckbox", props, formCheckboxThemeDefaults);
-		const defaults = useComponentDefaults("formCheckbox", props, behavioralDefaults$4);
+		const defaults = useComponentDefaults("formCheckbox", props, behavioralDefaults$3);
 		const fallbackId = useId(void 0, "vc-form-checkbox");
 		return () => {
 			const resolved = theme.value;
@@ -194,10 +194,22 @@ const validationGroupThemeDefaults = { classes: { item: "form-group-hint group-r
 var ValidationGroup_default = defineComponent({
 	name: "VCValidationGroup",
 	props: {
-		/** Severity used to colour the rendered messages (`error` / `warning`). */
+		/**
+		* Severity used to colour the rendered messages. Accepts
+		* `'error' | 'warning'` (the vuecs-native vocabulary) plus
+		* `'success'` for forward-compat with validation bridges that
+		* surface a "passed" state (see `<VCFormGroup>`'s `:validation`
+		* bundle).
+		*
+		* Default is `undefined` — slot consumers receive the actual
+		* value passed by the host. The previous default of
+		* `ValidationSeverity.ERROR` is gone; if a slot template needs an
+		* error fallback when none is supplied, do it at the call site
+		* (`severity ?? 'error'`).
+		*/
 		severity: {
 			type: String,
-			default: "error"
+			default: void 0
 		},
 		/** Validation messages — keyed object or ordered array of `{ key, value }`. */
 		messages: {
@@ -263,7 +275,6 @@ const formGroupThemeDefaults = { classes: {
 	validationError: "",
 	validationWarning: ""
 } };
-const behavioralDefaults$3 = { validation: true };
 //#endregion
 //#region src/components/form-group/FormGroup.vue
 var FormGroup_default = defineComponent({
@@ -300,17 +311,35 @@ var FormGroup_default = defineComponent({
 			type: String,
 			default: void 0
 		},
-		/** When `true`, render the validation messages section. Falls back to the global `formGroup.validation` default. */
+		/**
+		* Bundle prop accepting a `FieldValidation` (`{ severity, messages }`)
+		* — wins over `validationSeverity` + `validationMessages` when set.
+		*
+		* Canonical use is with `@ilingo/validup-vue`'s `useFieldValidation`:
+		* `<VCFormGroup :validation="useFieldValidation($v.fields.email)">`.
+		* Structural typing — vuecs and `@ilingo/validup-vue` declare matching
+		* shapes without either importing the other.
+		*
+		* Pass `null` / `undefined` to fall through to the legacy props.
+		*/
 		validation: {
-			type: Boolean,
+			type: [Object, null],
 			default: void 0
 		},
-		/** Severity used to colour the validation messages (`error` / `warning`). */
+		/**
+		* @deprecated Pass a `FieldValidation` via `:validation` instead.
+		* Severity used to colour the validation messages (`error` /
+		* `warning`). Ignored when `:validation` is set.
+		*/
 		validationSeverity: {
 			type: String,
 			default: void 0
 		},
-		/** Validation messages — keyed object or ordered array of `{ key, value }`. */
+		/**
+		* @deprecated Pass a `FieldValidation` via `:validation` instead.
+		* Validation messages — keyed object or ordered array of
+		* `{ key, value }`. Ignored when `:validation` is set.
+		*/
 		validationMessages: {
 			type: [Object, Array],
 			default: void 0
@@ -329,19 +358,23 @@ var FormGroup_default = defineComponent({
 	slots: Object,
 	setup(props, { attrs, slots }) {
 		const theme = useComponentTheme("formGroup", props, formGroupThemeDefaults);
-		const defaults = useComponentDefaults("formGroup", props, behavioralDefaults$3);
 		return () => {
 			const resolved = theme.value;
-			const resolvedDefaults = defaults.value;
 			const children = [];
 			if (typeof props.label === "boolean" ? props.label : !!props.labelContent || !!slots.label) {
 				if (slots.label) children.push(h(props.labelTag, { class: resolved.label || void 0 }, slots.label({})));
 				else if (props.labelContent) children.push(h(props.labelTag, { class: resolved.label || void 0 }, [props.labelContent]));
 			}
 			if (slots.default) children.push(slots.default({}));
-			if (resolvedDefaults.validation) children.push(h(ValidationGroup_default, {
-				severity: props.validationSeverity,
-				messages: props.validationMessages || {}
+			const usingBundle = props.validation != null;
+			const bundleSeverity = usingBundle ? props.validation.severity : void 0;
+			const effectiveSeverity = usingBundle ? bundleSeverity : props.validationSeverity;
+			const effectiveMessages = usingBundle ? props.validation.messages : props.validationMessages;
+			const hasMessages = !!effectiveMessages && (Array.isArray(effectiveMessages) ? effectiveMessages.length > 0 : Object.keys(effectiveMessages).length > 0);
+			const hasValidationSlot = !!slots.validationGroup || !!slots.validationItem;
+			if (hasMessages || hasValidationSlot) children.push(h(ValidationGroup_default, {
+				severity: effectiveSeverity,
+				messages: effectiveMessages || {}
 			}, {
 				...slots.validationGroup ? { default: slots.validationGroup } : {},
 				...slots.validationItem ? { item: slots.validationItem } : {}
@@ -351,8 +384,10 @@ var FormGroup_default = defineComponent({
 				else if (props.hintContent) children.push(h(props.hintTag, { class: resolved.hint || void 0 }, [props.hintContent]));
 			}
 			let validationClass;
-			if (resolvedDefaults.validation && props.validationMessages) {
-				if (Array.isArray(props.validationMessages) ? props.validationMessages.length > 0 : Object.keys(props.validationMessages).length > 0) validationClass = props.validationSeverity === "warning" ? resolved.validationWarning : resolved.validationError;
+			if (hasMessages) {
+				if (effectiveSeverity === "warning") validationClass = resolved.validationWarning;
+				else if (effectiveSeverity === "error") validationClass = resolved.validationError;
+				else if (!usingBundle) validationClass = resolved.validationError;
 			}
 			return h("div", mergeProps(attrs, { class: [resolved.root || void 0, validationClass || void 0] }), children);
 		};
@@ -372,9 +407,9 @@ var FormInput_default = defineComponent({
 	name: "VCFormInput",
 	inheritAttrs: false,
 	props: {
-		/** Controlled string value (v-model). */
+		/** Controlled string value (v-model). `null` is the documented "unset" value. */
 		modelValue: {
-			type: String,
+			type: [String, null],
 			default: ""
 		},
 		/** Native `<input type>` attribute. */
@@ -1636,9 +1671,9 @@ const formTextareaThemeDefaults = { classes: { root: "" } };
 var FormTextarea_default = defineComponent({
 	name: "VCFormTextarea",
 	props: {
-		/** Controlled string value (v-model). */
+		/** Controlled string value (v-model). `null` is the documented "unset" value. */
 		modelValue: {
-			type: String,
+			type: [String, null],
 			default: ""
 		},
 		/** Debounce window (ms) for `update:modelValue` emissions. `0` disables debouncing. */