@macrulez/vue-form-schema 0.1.7 → 0.1.9

package/dist/ui-tailwind.d.ts

@@ -0,0 +1,397 @@
+import { Component } from 'vue';
+import { ComponentOptionsMixin } from 'vue';
+import { ComponentProvideOptions } from 'vue';
+import { ComputedRef } from 'vue';
+import { DefineComponent } from 'vue';
+import { ExtractPropTypes } from 'vue';
+import { PropType } from 'vue';
+import { PublicProps } from 'vue';
+import { Ref } from 'vue';
+
+declare const __VLS_component: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+form: UseFormReturn;
+components?: Partial<Record<FieldDefinition["type"], Component | string>>;
+submitLabel?: string;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+submit: () => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+form: UseFormReturn;
+components?: Partial<Record<FieldDefinition["type"], Component | string>>;
+submitLabel?: string;
+}>>> & Readonly<{
+onSubmit?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+declare type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_10<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_2<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_3<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_4<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_5<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_6<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_7<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_8<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_9<T> = T extends undefined ? never : T;
+
+declare function __VLS_template(): Partial<Record<`field-${string}`, (_: {
+    field: FieldDefinition;
+    value: unknown;
+    error: string[];
+    touched: boolean;
+    setValue: (v: unknown) => void;
+    touch: () => void;
+}) => any>> & {
+    submit?(_: {
+        isSubmitting: boolean;
+        isValid: boolean;
+    }): any;
+};
+
+declare type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_10<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_10<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_2<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_2<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_3<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_3<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_4<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_4<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_5<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_5<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_6<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_6<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_7<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_7<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_8<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_8<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_9<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_9<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+declare type AsyncValidatorFn = (value: unknown, values: Record<string, unknown>) => Promise<string | null>;
+
+declare interface FieldDefinition {
+    type: FieldType;
+    /** Dot-path for nested fields, e.g. "address.city" */
+    name: string;
+    label?: string;
+    placeholder?: string;
+    defaultValue?: unknown | ((values: Record<string, unknown>) => unknown);
+    required?: boolean;
+    /** Static or dynamic disabled state */
+    disabled?: boolean | ((values: Record<string, unknown>) => boolean);
+    /** Static or dynamic visibility; string is evaluated as expression */
+    visible?: boolean | string | ((values: Record<string, unknown>) => boolean);
+    validators?: ValidatorFn[];
+    asyncValidators?: AsyncValidatorFn[];
+    mask?: string | MaskConfig;
+    /** For select / radio — static list, sync function, or async function */
+    options?: FieldOption[] | ((values: Record<string, unknown>) => FieldOption[] | Promise<FieldOption[]>);
+    /**
+     * Field names whose values trigger re-fetching of async options.
+     * Only relevant when `options` is an async function.
+     */
+    optionsDeps?: string[];
+    /** Internal: set by useForm when async options are loading. Read-only for consumers. */
+    optionsLoading?: boolean;
+    /** For group and array */
+    fields?: FieldDefinition[];
+    /**
+     * Applied on every setField call before the value is stored.
+     * Use for trimming, type coercion, formatting, etc.
+     */
+    transform?: (value: unknown, values: Record<string, unknown>) => unknown;
+    /**
+     * Applied at submit time to produce the final payload value.
+     * Runs after all validation passes.
+     */
+    parse?: (raw: unknown) => unknown;
+    /**
+     * Custom Vue component to render this field.
+     * Receives FormFieldProps and must emit 'update:modelValue' and 'blur'.
+     */
+    component?: Component | string;
+    /** Accepted file types, e.g. "image/*,.pdf" — passed to <input accept> */
+    accept?: string;
+    /** Allow selecting multiple files */
+    multiple?: boolean;
+    /** Maximum file size in bytes */
+    maxSize?: number;
+    /** Maximum number of files (only relevant when multiple=true) */
+    maxFiles?: number;
+}
+
+declare interface FieldOption {
+    label: string;
+    value: unknown;
+}
+
+declare type FieldType = 'text' | 'number' | 'email' | 'select' | 'checkbox' | 'radio' | 'textarea' | 'date' | 'array' | 'group' | 'file';
+
+declare interface MaskConfig {
+    preset?: MaskPreset;
+    /** Custom mask pattern: '#' = digit, 'A' = letter, other chars are literals */
+    pattern?: string;
+}
+
+declare type MaskPreset = 'phone-ru' | 'phone-eu' | 'date' | 'inn' | 'iban';
+
+export declare const TailwindFormRenderer: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+
+export declare const TwArrayField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_10<{
+field: FieldDefinition;
+form: UseFormReturn;
+components?: Partial<Record<FieldDefinition["type"], Component | string>>;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_10<{
+field: FieldDefinition;
+form: UseFormReturn;
+components?: Partial<Record<FieldDefinition["type"], Component | string>>;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwCheckboxField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_6<{
+field: FieldDefinition;
+modelValue: boolean | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: boolean) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_6<{
+field: FieldDefinition;
+modelValue: boolean | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwDateField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_8<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: string) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_8<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwFileField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_9<{
+field: FieldDefinition;
+modelValue: File | File[] | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: File | File[] | null) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_9<{
+field: FieldDefinition;
+modelValue: File | File[] | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: File | File[] | null) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwNumberField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_3<{
+field: FieldDefinition;
+modelValue: number | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: number | null) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_3<{
+field: FieldDefinition;
+modelValue: number | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwRadioField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_7<{
+field: FieldDefinition;
+modelValue: unknown;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: unknown) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_7<{
+field: FieldDefinition;
+modelValue: unknown;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: unknown) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwSelectField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_5<{
+field: FieldDefinition;
+modelValue: unknown;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: unknown) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_5<{
+field: FieldDefinition;
+modelValue: unknown;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: unknown) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwTextareaField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_4<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: string) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_4<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwTextField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_2<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: string) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_2<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+declare interface UseFormReturn<T extends Record<string, unknown> = Record<string, unknown>> {
+    fields: ComputedRef<FieldDefinition[]>;
+    values: Ref<T>;
+    errors: Ref<Record<string, string[]>>;
+    touched: Ref<Record<string, boolean>>;
+    /** Per-field async options loading state */
+    optionsLoading: Ref<Record<string, boolean>>;
+    isDirty: ComputedRef<boolean>;
+    isValid: ComputedRef<boolean>;
+    isSubmitting: Ref<boolean>;
+    submit(): Promise<void>;
+    reset(values?: Partial<T>): void;
+    setField(path: string, value: unknown): void;
+    getField(path: string): unknown;
+}
+
+declare type ValidatorFn = (value: unknown, values: Record<string, unknown>) => string | null;
+
+export { }