@vuehookform/core 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,290 @@
+import { ComputedRef, Ref } from 'vue';
+import { ZodType, z } from 'zod';
+/**
+ * Validation mode determines when validation occurs
+ */
+export type ValidationMode = 'onSubmit' | 'onBlur' | 'onChange' | 'onTouched';
+/**
+ * Extract the inferred type from a Zod schema
+ */
+export type InferSchema<T extends ZodType> = z.infer<T>;
+/**
+ * Generate all possible paths for a nested object type
+ * e.g., { user: { name: string } } => 'user' | 'user.name'
+ */
+export type Path<T> = T extends object ? {
+    [K in keyof T & (string | number)]: K extends string | number ? `${K}` | `${K}.${Path<T[K]>}` : never;
+}[keyof T & (string | number)] : never;
+/**
+ * Get the type at a given path
+ * e.g., PathValue<{ user: { name: string } }, 'user.name'> => string
+ */
+export type PathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? Rest extends Path<T[K]> ? PathValue<T[K], Rest> : never : never : P extends keyof T ? T[P] : never;
+/**
+ * Single field error with type and message
+ */
+export interface FieldError {
+    /** Error type identifier (e.g., 'required', 'minLength', 'custom') */
+    type: string;
+    /** Error message to display */
+    message: string;
+    /** Additional error types when multiple validations fail */
+    types?: Record<string, string | string[]>;
+}
+/**
+ * Field error value - can be a simple string (backward compatible) or structured error
+ */
+export type FieldErrorValue = string | FieldError;
+/**
+ * Field error structure matching the form data structure
+ */
+export type FieldErrors<T> = {
+    [K in keyof T]?: T[K] extends Array<infer U> ? Array<FieldErrors<U>> | FieldErrorValue : T[K] extends object ? FieldErrors<T[K]> | FieldErrorValue : FieldErrorValue;
+} & {
+    /** Root-level form errors */
+    root?: FieldError;
+};
+/**
+ * Form state tracking
+ */
+export interface FormState<T> {
+    /** Field validation errors */
+    errors: FieldErrors<T>;
+    /** Whether form has been modified from default values */
+    isDirty: boolean;
+    /** Whether form is currently valid (no errors) */
+    isValid: boolean;
+    /** Whether form is currently submitting */
+    isSubmitting: boolean;
+    /** Whether async default values are loading */
+    isLoading: boolean;
+    /** Record of touched field paths */
+    touchedFields: Record<string, boolean>;
+    /** Record of dirty field paths */
+    dirtyFields: Record<string, boolean>;
+    /** Number of times form has been submitted */
+    submitCount: number;
+}
+/**
+ * State of an individual field
+ */
+export interface FieldState {
+    /** Whether field value differs from default */
+    isDirty: boolean;
+    /** Whether field has been blurred */
+    isTouched: boolean;
+    /** Whether field has a validation error */
+    invalid: boolean;
+    /** The error (string for backward compatibility, or FieldError for structured errors) */
+    error?: string | FieldError;
+}
+/**
+ * Error option for setError()
+ */
+export interface ErrorOption {
+    /** Error type identifier */
+    type?: string;
+    /** Error message to display */
+    message: string;
+}
+/**
+ * Options for setFocus()
+ */
+export interface SetFocusOptions {
+    /** Whether to select the text in the input */
+    shouldSelect?: boolean;
+}
+/**
+ * Options for reset()
+ */
+export interface ResetOptions {
+    /** Keep validation errors after reset */
+    keepErrors?: boolean;
+    /** Keep dirty state after reset */
+    keepDirty?: boolean;
+    /** Keep touched state after reset */
+    keepTouched?: boolean;
+    /** Keep submit count after reset */
+    keepSubmitCount?: boolean;
+    /** Keep current default values (don't update with new values) */
+    keepDefaultValues?: boolean;
+    /** Keep isSubmitting state after reset */
+    keepIsSubmitting?: boolean;
+}
+/**
+ * Options for registering a field
+ */
+export interface RegisterOptions {
+    /** Use controlled mode (v-model) instead of uncontrolled (ref) */
+    controlled?: boolean;
+    /** Disable validation for this field */
+    disabled?: boolean;
+    /** Custom validation function */
+    validate?: (value: unknown) => string | undefined | Promise<string | undefined>;
+    /** Debounce time in ms for async validation (default: 0 = no debounce) */
+    validateDebounce?: number;
+    /** Remove field data when unmounted (overrides global shouldUnregister option) */
+    shouldUnregister?: boolean;
+}
+/**
+ * Return value from register() for binding to inputs
+ */
+export interface RegisterReturn {
+    /** Field name for form data */
+    name: string;
+    /** Ref callback for uncontrolled inputs - accepts HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement, or null */
+    ref: (el: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | null | unknown) => void;
+    /** Input handler (fires on every keystroke) */
+    onInput: (e: Event) => void;
+    /** Blur handler */
+    onBlur: (e: Event) => void;
+    /** Current value (for controlled mode) - only present when controlled: true */
+    value?: Ref<unknown>;
+}
+/**
+ * Field metadata for dynamic arrays
+ */
+export interface FieldArrayItem {
+    /** Stable key for v-for */
+    key: string;
+    /** Current index in array */
+    index: number;
+    /** Remove this item */
+    remove: () => void;
+}
+/**
+ * API for managing dynamic field arrays
+ */
+export interface FieldArray {
+    /** Current field items with metadata */
+    value: FieldArrayItem[];
+    /** Append item to end of array */
+    append: (value: unknown) => void;
+    /** Prepend item to beginning of array */
+    prepend: (value: unknown) => void;
+    /** Remove item at index */
+    remove: (index: number) => void;
+    /** Insert item at index */
+    insert: (index: number, value: unknown) => void;
+    /** Swap two items */
+    swap: (indexA: number, indexB: number) => void;
+    /** Move item from one index to another */
+    move: (from: number, to: number) => void;
+    /** Update item at index (preserves key/identity) */
+    update: (index: number, value: unknown) => void;
+}
+/**
+ * Async default values function type
+ */
+export type AsyncDefaultValues<T> = () => Promise<Partial<T>>;
+/**
+ * Options for useForm composable
+ */
+export interface UseFormOptions<TSchema extends ZodType> {
+    /** Zod schema for validation */
+    schema: TSchema;
+    /** Default form values (can be a sync object or async function) */
+    defaultValues?: Partial<InferSchema<TSchema>> | AsyncDefaultValues<InferSchema<TSchema>>;
+    /** When to run validation */
+    mode?: ValidationMode;
+    /** Revalidate on change after first submit */
+    reValidateMode?: ValidationMode;
+    /** Remove field data when unmounted (default: false) */
+    shouldUnregister?: boolean;
+}
+/**
+ * Return value from useForm composable
+ */
+export interface UseFormReturn<TSchema extends ZodType> {
+    /**
+     * Register an input field
+     * @param name - Field path (e.g., 'email' or 'user.address.street')
+     * @param options - Registration options
+     */
+    register: <TPath extends Path<InferSchema<TSchema>>>(name: TPath, options?: RegisterOptions) => RegisterReturn;
+    /**
+     * Unregister a field to clean up refs and options
+     * Call this when a field is unmounted to prevent memory leaks
+     * @param name - Field path to unregister
+     */
+    unregister: <TPath extends Path<InferSchema<TSchema>>>(name: TPath) => void;
+    /**
+     * Handle form submission
+     * @param onValid - Callback called with valid data
+     * @param onInvalid - Optional callback called with errors
+     */
+    handleSubmit: (onValid: (data: InferSchema<TSchema>) => void | Promise<void>, onInvalid?: (errors: FieldErrors<InferSchema<TSchema>>) => void) => (e: Event) => Promise<void>;
+    /** Reactive form state */
+    formState: ComputedRef<FormState<InferSchema<TSchema>>>;
+    /**
+     * Manage dynamic field arrays
+     * @param name - Array field path
+     */
+    fields: <TPath extends Path<InferSchema<TSchema>>>(name: TPath) => FieldArray;
+    /**
+     * Set field value programmatically
+     * @param name - Field path
+     * @param value - New value
+     */
+    setValue: <TPath extends Path<InferSchema<TSchema>>>(name: TPath, value: PathValue<InferSchema<TSchema>, TPath>) => void;
+    /**
+     * Get field value
+     * @param name - Field path
+     */
+    getValue: <TPath extends Path<InferSchema<TSchema>>>(name: TPath) => PathValue<InferSchema<TSchema>, TPath> | undefined;
+    /**
+     * Reset form to default values
+     * @param values - Optional new default values
+     * @param options - Optional reset options
+     */
+    reset: (values?: Partial<InferSchema<TSchema>>, options?: ResetOptions) => void;
+    /**
+     * Watch field value(s) reactively
+     * @param name - Field path or array of paths (optional - watches all if not provided)
+     */
+    watch: <TPath extends Path<InferSchema<TSchema>>>(name?: TPath | TPath[]) => ComputedRef<unknown>;
+    /**
+     * Manually trigger validation
+     * @param name - Optional field path (validates all if not provided)
+     */
+    validate: <TPath extends Path<InferSchema<TSchema>>>(name?: TPath) => Promise<boolean>;
+    /**
+     * Clear errors for specified fields or all errors
+     * @param name - Optional field path or array of paths
+     */
+    clearErrors: <TPath extends Path<InferSchema<TSchema>>>(name?: TPath | TPath[]) => void;
+    /**
+     * Set an error for a specific field
+     * @param name - Field path or root error
+     * @param error - Error option with message
+     */
+    setError: <TPath extends Path<InferSchema<TSchema>>>(name: TPath | 'root' | `root.${string}`, error: ErrorOption) => void;
+    /**
+     * Get all form values, a single value, or multiple values
+     * @overload Get all form values
+     * @overload Get single field value by path
+     * @overload Get multiple field values by paths array
+     */
+    getValues: {
+        (): InferSchema<TSchema>;
+        <TPath extends Path<InferSchema<TSchema>>>(name: TPath): PathValue<InferSchema<TSchema>, TPath>;
+        <TPath extends Path<InferSchema<TSchema>>>(names: TPath[]): Partial<InferSchema<TSchema>>;
+    };
+    /**
+     * Get the state of an individual field
+     * @param name - Field path
+     */
+    getFieldState: <TPath extends Path<InferSchema<TSchema>>>(name: TPath) => FieldState;
+    /**
+     * Manually trigger validation for specific fields or entire form
+     * @param name - Optional field path or array of paths
+     */
+    trigger: <TPath extends Path<InferSchema<TSchema>>>(name?: TPath | TPath[]) => Promise<boolean>;
+    /**
+     * Programmatically focus a field
+     * @param name - Field path
+     * @param options - Focus options
+     */
+    setFocus: <TPath extends Path<InferSchema<TSchema>>>(name: TPath, options?: SetFocusOptions) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/useController.d.ts

@@ -0,0 +1,64 @@
+import { ComputedRef, Ref } from 'vue';
+import { ZodType } from 'zod';
+import { UseFormReturn, Path, PathValue, InferSchema, FieldState } from './types';
+/**
+ * Options for useController composable
+ */
+export interface UseControllerOptions<TSchema extends ZodType, TPath extends Path<InferSchema<TSchema>>> {
+    /** Field name/path */
+    name: TPath;
+    /** Form control from useForm (uses context if not provided) */
+    control?: UseFormReturn<TSchema>;
+    /** Default value for the field */
+    defaultValue?: PathValue<InferSchema<TSchema>, TPath>;
+}
+/**
+ * Field props returned by useController
+ */
+export interface ControllerFieldProps<TValue> {
+    /** Current field value */
+    value: Ref<TValue>;
+    /** Field name */
+    name: string;
+    /** Change handler - call with new value */
+    onChange: (value: TValue) => void;
+    /** Blur handler */
+    onBlur: () => void;
+    /** Ref callback for the input element */
+    ref: (el: HTMLElement | null) => void;
+}
+/**
+ * Return value from useController
+ */
+export interface UseControllerReturn<TValue> {
+    /** Field props for binding to input components */
+    field: ControllerFieldProps<TValue>;
+    /** Current field state (errors, dirty, touched) */
+    fieldState: ComputedRef<FieldState>;
+}
+/**
+ * Hook for controlled components that need fine-grained control over field state
+ *
+ * This composable is useful for integrating with custom input components or
+ * third-party UI libraries that don't work with the standard register() approach.
+ *
+ * @example
+ * ```ts
+ * // Basic usage with context
+ * const { field, fieldState } = useController({ name: 'email' })
+ *
+ * // With explicit control
+ * const { control } = useForm({ schema })
+ * const { field, fieldState } = useController({ control, name: 'email' })
+ *
+ * // In template:
+ * // <CustomInput
+ * //   :value="field.value.value"
+ * //   @update:modelValue="field.onChange"
+ * //   @blur="field.onBlur"
+ * // />
+ * // <span v-if="fieldState.value.error">{{ fieldState.value.error }}</span>
+ * ```
+ */
+export declare function useController<TSchema extends ZodType, TPath extends Path<InferSchema<TSchema>>>(options: UseControllerOptions<TSchema, TPath>): UseControllerReturn<PathValue<InferSchema<TSchema>, TPath>>;
+//# sourceMappingURL=useController.d.ts.map

package/dist/useController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useController.d.ts","sourceRoot":"","sources":["../src/lib/useController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAItF;;GAEG;AACH,MAAM,WAAW,oBAAoB,CACnC,OAAO,SAAS,OAAO,EACvB,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAExC,sBAAsB;IACtB,IAAI,EAAE,KAAK,CAAA;IACX,+DAA+D;IAC/D,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAChC,kCAAkC;IAClC,YAAY,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAA;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,MAAM;IAC1C,0BAA0B;IAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,mBAAmB;IACnB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,yCAAyC;IACzC,GAAG,EAAE,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,MAAM;IACzC,kDAAkD;IAClD,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACnC,mDAAmD;IACnD,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,SAAS,OAAO,EACvB,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAExC,OAAO,EAAE,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,GAC5C,mBAAmB,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,CAyD7D"}

package/dist/useForm.d.ts

@@ -0,0 +1,21 @@
+import { ZodType } from 'zod';
+import { UseFormOptions, UseFormReturn } from './types';
+/**
+ * Main form management composable
+ *
+ * @example
+ * ```ts
+ * const schema = z.object({
+ *   email: z.email(),
+ *   name: z.string().min(2)
+ * })
+ *
+ * const { register, handleSubmit, formState } = useForm({ schema })
+ *
+ * const onSubmit = (data) => {
+ *   console.log(data) // { email: '...', name: '...' }
+ * }
+ * ```
+ */
+export declare function useForm<TSchema extends ZodType>(options: UseFormOptions<TSchema>): UseFormReturn<TSchema>;
+//# sourceMappingURL=useForm.d.ts.map

package/dist/useForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForm.d.ts","sourceRoot":"","sources":["../src/lib/useForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAClC,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAUd,MAAM,SAAS,CAAA;AAOhB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,OAAO,SAAS,OAAO,EAC7C,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,GAC/B,aAAa,CAAC,OAAO,CAAC,CAuWxB"}

package/dist/useFormState.d.ts

@@ -0,0 +1,40 @@
+import { ComputedRef } from 'vue';
+import { ZodType } from 'zod';
+import { UseFormReturn, FormState, InferSchema } from './types';
+/**
+ * Keys of FormState that can be subscribed to
+ */
+export type FormStateKey = keyof FormState<unknown>;
+/**
+ * Options for useFormState composable
+ */
+export interface UseFormStateOptions<TSchema extends ZodType> {
+    /** Form control from useForm (uses context if not provided) */
+    control?: UseFormReturn<TSchema>;
+    /** Specific state keys to subscribe to (subscribes to all if not provided) */
+    name?: FormStateKey | FormStateKey[];
+}
+/**
+ * Subscribe to specific form state properties
+ *
+ * This composable allows you to efficiently subscribe to only the form state
+ * properties you need, reducing unnecessary re-renders.
+ *
+ * @example
+ * ```ts
+ * // Subscribe to all form state
+ * const formState = useFormState({})
+ *
+ * // Subscribe to specific properties
+ * const { isSubmitting, errors } = useFormState({ name: ['isSubmitting', 'errors'] })
+ *
+ * // Subscribe to single property
+ * const isDirty = useFormState({ name: 'isDirty' })
+ *
+ * // With explicit control
+ * const { control } = useForm({ schema })
+ * const formState = useFormState({ control })
+ * ```
+ */
+export declare function useFormState<TSchema extends ZodType>(options?: UseFormStateOptions<TSchema>): ComputedRef<Partial<FormState<InferSchema<TSchema>>>>;
+//# sourceMappingURL=useFormState.d.ts.map

package/dist/useFormState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormState.d.ts","sourceRoot":"","sources":["../src/lib/useFormState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,KAAK,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAGpE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,OAAO;IAC1D,+DAA+D;IAC/D,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAChC,8EAA8E;IAC9E,IAAI,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAA;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,OAAO,SAAS,OAAO,EAClD,OAAO,GAAE,mBAAmB,CAAC,OAAO,CAAM,GACzC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CA0BvD"}

package/dist/useWatch.d.ts

@@ -0,0 +1,41 @@
+import { ComputedRef } from 'vue';
+import { ZodType } from 'zod';
+import { UseFormReturn, Path, InferSchema } from './types';
+/**
+ * Options for useWatch composable
+ */
+export interface UseWatchOptions<TSchema extends ZodType, TPath extends Path<InferSchema<TSchema>>> {
+    /** Form control from useForm (uses context if not provided) */
+    control?: UseFormReturn<TSchema>;
+    /** Field path or array of paths to watch (watches all if not provided) */
+    name?: TPath | TPath[];
+    /** Default value when field is undefined */
+    defaultValue?: unknown;
+}
+/**
+ * Watch form field values reactively without the full form instance
+ *
+ * This composable allows you to subscribe to form value changes from any component
+ * in the tree, as long as the form context is provided via provideForm().
+ *
+ * @example
+ * ```ts
+ * // Watch a single field
+ * const email = useWatch({ name: 'email' })
+ *
+ * // Watch multiple fields
+ * const fields = useWatch({ name: ['firstName', 'lastName'] })
+ *
+ * // Watch all form values
+ * const allValues = useWatch({})
+ *
+ * // With explicit control
+ * const { control } = useForm({ schema })
+ * const email = useWatch({ control, name: 'email' })
+ *
+ * // With default value
+ * const status = useWatch({ name: 'status', defaultValue: 'pending' })
+ * ```
+ */
+export declare function useWatch<TSchema extends ZodType, TPath extends Path<InferSchema<TSchema>> = Path<InferSchema<TSchema>>>(options?: UseWatchOptions<TSchema, TPath>): ComputedRef<unknown>;
+//# sourceMappingURL=useWatch.d.ts.map

package/dist/useWatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWatch.d.ts","sourceRoot":"","sources":["../src/lib/useWatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,KAAK,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAI/D;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,OAAO,EAAE,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAChG,+DAA+D;IAC/D,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAChC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,CAAA;IACtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,CACtB,OAAO,SAAS,OAAO,EACvB,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EACrE,OAAO,GAAE,eAAe,CAAC,OAAO,EAAE,KAAK,CAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CA0BrE"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Get value from object using dot notation path
+ * @example get({ user: { name: 'John' } }, 'user.name') => 'John'
+ */
+export declare function get(obj: Record<string, unknown>, path: string): unknown;
+/**
+ * Set value in object using dot notation path
+ * @example set({}, 'user.name', 'John') => { user: { name: 'John' } }
+ */
+export declare function set(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Delete value from object using dot notation path
+ * @example unset({ user: { name: 'John' } }, 'user.name') => { user: {} }
+ */
+export declare function unset(obj: Record<string, unknown>, path: string): void;
+/**
+ * Check if path exists in object
+ */
+export declare function has(obj: Record<string, unknown>, path: string): boolean;
+export declare function generateId(): string;
+/**
+ * Check if a path represents an array index
+ * @example isArrayPath('users.0') => true
+ * @example isArrayPath('users.name') => false
+ */
+export declare function isArrayPath(path: string): boolean;
+/**
+ * Get parent path
+ * @example getParentPath('user.addresses.0.street') => 'user.addresses.0'
+ */
+export declare function getParentPath(path: string): string | undefined;
+/**
+ * Get field name from path
+ * @example getFieldName('user.addresses.0.street') => 'street'
+ */
+export declare function getFieldName(path: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAcvE;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAsBpF;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAatE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvE;AAMD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD"}