@illinois-grad/grad-vue 2.2.0 → 2.3.0

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

@@ -11,14 +11,12 @@ type Props = {
      * Disabled
      */
     disabled?: boolean;
-    /**
-     * Error message
-     */
-    error?: string;
+    errors?: string[];
     /**
      * Instructions
      */
     instructions?: string;
+    name?: string;
 };
 type __VLS_Props = Props;
 type __VLS_ModelProps = {
@@ -30,10 +28,11 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | null | undefined) => any) | undefined;
 }>, {
+    name: string;
+    errors: string[];
     label: string;
     placeholder: string;
     disabled: boolean;
-    error: string;
     instructions: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

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

@@ -11,14 +11,12 @@ type Props = {
      * Disabled
      */
     disabled?: boolean;
-    /**
-     * Error message
-     */
-    error?: string;
+    errors?: string[];
     /**
      * Instructions
      */
     instructions?: string;
+    name?: string;
 };
 type __VLS_Props = Props;
 type __VLS_ModelProps = {
@@ -30,10 +28,11 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | null | undefined) => any) | undefined;
 }>, {
+    name: string;
+    errors: string[];
     label: string;
     placeholder: string;
     disabled: boolean;
-    error: string;
     instructions: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

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

@@ -15,14 +15,12 @@ type Props = {
      * Disabled
      */
     disabled?: boolean;
-    /**
-     * Error message
-     */
-    error?: string;
+    errors?: string[];
     /**
      * Instructions
      */
     instructions?: string;
+    name?: string;
 };
 type __VLS_Props = Props;
 type DateRange = {
@@ -38,9 +36,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: DateRange) => any) | undefined;
 }>, {
+    name: string;
+    errors: string[];
     label: string;
     disabled: boolean;
-    error: string;
     instructions: string;
     startLabel: string;
     endLabel: string;

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

@@ -11,14 +11,12 @@ type Props = {
      * Disabled
      */
     disabled?: boolean;
-    /**
-     * Error message
-     */
-    error?: string;
+    errors?: string[];
     /**
      * Instructions
      */
     instructions?: string;
+    name?: string;
 };
 type __VLS_Props = Props;
 type __VLS_ModelProps = {
@@ -30,10 +28,11 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | null | undefined) => any) | undefined;
 }>, {
+    name: string;
+    errors: string[];
     label: string;
     placeholder: string;
     disabled: boolean;
-    error: string;
     instructions: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

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

@@ -0,0 +1,42 @@
+interface Props {
+    /**
+     * Action URL (optional, for native form submission)
+     */
+    action?: string;
+    /**
+     * HTTP method (optional, for native form submission)
+     */
+    method?: string;
+}
+type __VLS_Props = Props;
+type __VLS_ModelProps = {
+    modelValue?: Record<string, any>;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_1: {
+    isSubmitting: boolean;
+    hasErrors: boolean;
+    values: Record<string, any>;
+    errors: Record<string, string[]>;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: Record<string, any>) => any;
+    submit: (values: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: Record<string, any>) => any) | undefined;
+    onSubmit?: ((values: Record<string, any>) => any) | undefined;
+}>, {
+    action: string;
+    method: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -28,8 +28,8 @@ declare const __VLS_export: <T extends {
     } & {
         modelValue?: string | null;
     }) & {
-        "onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
         onSelect?: ((...args: any[]) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
         onSubmit?: ((...args: any[]) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;

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

@@ -22,9 +22,6 @@ interface Props {
      * Disabled
      */
     disabled?: boolean;
-    /**
-     * Name
-     */
     name?: string;
     /**
      * Searchable
@@ -38,6 +35,7 @@ interface Props {
      * Compact
      */
     compact?: boolean;
+    errors?: string[];
 }
 type __VLS_Props = Props;
 type __VLS_ModelProps = {
@@ -59,8 +57,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     onChange?: ((...args: any[]) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string | number | null | undefined) => any) | undefined;
 }>, {
-    disabled: boolean;
     name: string;
+    errors: string[];
+    disabled: boolean;
     searchable: boolean;
     compact: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -12,14 +12,12 @@ interface Props {
      * Size
      */
     size?: "small" | "medium" | "large";
-    /**
-     * Name
-     */
     name?: string;
     /**
      * Disabled
      */
     disabled?: boolean;
+    errors?: string[];
 }
 type __VLS_Props = Props;
 type __VLS_ModelProps = {
@@ -34,8 +32,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
     "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
 }>, {
     size: "small" | "medium" | "large";
-    disabled: boolean;
     name: string;
+    errors: string[];
+    disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -0,0 +1,31 @@
+interface Props {
+    /**
+     * Disabled state
+     */
+    disabled?: boolean;
+    /**
+     * Loading text to show during submission
+     */
+    loadingText?: string;
+    /**
+     * Variant
+     */
+    variant?: "primary" | "secondary" | "danger";
+}
+declare var __VLS_8: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    disabled: boolean;
+    variant: "primary" | "secondary" | "danger";
+    loadingText: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -11,10 +11,7 @@ type Props = {
      * Disabled
      */
     disabled?: boolean;
-    /**
-     * Error message
-     */
-    error?: string;
+    errors?: string[];
     /**
      * Instructions
      */
@@ -31,6 +28,7 @@ type Props = {
      * Debounce in milliseconds
      */
     debounce?: number;
+    name?: string;
 };
 type __VLS_Props = Props;
 type __VLS_ModelProps = {
@@ -54,10 +52,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     }) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string | null | undefined) => any) | undefined;
 }>, {
+    name: string;
+    errors: string[];
     label: string;
     placeholder: string;
     disabled: boolean;
-    error: string;
     instructions: string;
     prefix: string;
     suffix: string;

package/dist/components/form/GFormErrorMessages.vue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Internal component for displaying form field error messages.
+ * This component is used by form input components to display validation errors
+ * in a consistent way across all form fields.
+ */
+interface Props {
+    /**
+     * Array of error messages to display
+     */
+    errors: string[];
+    /**
+     * ID for the error container (used for aria-describedby)
+     */
+    id: string;
+}
+declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/compose/useForm.d.ts

@@ -0,0 +1,21 @@
+import { Ref, ComputedRef } from "vue";
+export interface FormField {
+    name: string;
+    value: Ref<any>;
+    errors: Ref<string[]> | ComputedRef<string[]>;
+}
+export interface UseFormReturn {
+    fields: Record<string, FormField>;
+    values: Ref<Record<string, any>>;
+    errors: Ref<Record<string, string[]>>;
+    isSubmitting: Ref<boolean>;
+    hasErrors: Ref<boolean>;
+    registerField: (name: string, field: FormField) => void;
+    unregisterField: (name: string) => void;
+    submit: (handler: (values: Record<string, any>) => Promise<void> | void) => Promise<void>;
+}
+/**
+ * Composable to manage form state and link form inputs together.
+ * Uses reactive state pattern - errors are provided as reactive props to input components.
+ */
+export declare function useForm(): UseFormReturn;

package/dist/compose/useFormField.d.ts

@@ -0,0 +1,29 @@
+import { Ref, ComputedRef } from "vue";
+export interface UseFormFieldOptions {
+    /**
+     * The name of the field (required for form registration)
+     */
+    name?: string;
+    /**
+     * The model value ref to register with the form
+     */
+    value: Ref<any>;
+    /**
+     * Error messages from props (optional) - should be a reactive reference
+     */
+    errors?: Ref<string[]> | ComputedRef<string[]>;
+}
+export interface UseFormFieldReturn {
+    /**
+     * Combined filtered errors array
+     */
+    displayErrors: Ref<string[]>;
+    /**
+     * Whether the field has any errors
+     */
+    hasErrors: Ref<boolean>;
+}
+/**
+ * Composable to handle form field registration and error management.
+ */
+export declare function useFormField(options: UseFormFieldOptions): UseFormFieldReturn;