@rilaykit/core 0.1.1-alpha.1

package/dist/index.d.mts

@@ -0,0 +1,636 @@
+import React from 'react';
+import { z } from 'zod';
+
+/**
+ * Main configuration class for Rilay form components and workflows
+ * Manages component registration, retrieval, and configuration
+ */
+declare class ril {
+    private components;
+    private formRenderConfig;
+    private workflowRenderConfig;
+    static create(): ril;
+    /**
+     * Add a component to the configuration
+     * @param subType - The component subtype (e.g., 'text', 'email', 'heading')
+     * @param config - Component configuration without id and subType
+     * @returns The ril instance for chaining
+     */
+    addComponent<TProps = any>(subType: InputType | LayoutType, config: Omit<ComponentConfig<TProps>, 'id' | 'subType'> & {
+        id?: string;
+    }): this;
+    /**
+     * Set custom row renderer
+     * @param renderer - Custom row renderer function
+     * @returns The ril instance for chaining
+     */
+    setRowRenderer(renderer: FormRowRenderer): this;
+    /**
+     * Set custom body renderer
+     * @param renderer - Custom body renderer function
+     * @returns The ril instance for chaining
+     */
+    setBodyRenderer(renderer: FormBodyRenderer): this;
+    /**
+     * Set custom submit button renderer
+     * @param renderer - Custom submit button renderer function
+     * @returns The ril instance for chaining
+     */
+    setSubmitButtonRenderer(renderer: FormSubmitButtonRenderer): this;
+    /**
+     * Set complete form render configuration
+     * @param config - Form render configuration
+     * @returns The ril instance for chaining
+     */
+    setFormRenderConfig(config: FormRenderConfig): this;
+    /**
+     * Get current form render configuration
+     * @returns Current form render configuration
+     */
+    getFormRenderConfig(): FormRenderConfig;
+    /**
+     * Set custom stepper renderer for workflows
+     * @param renderer - Custom stepper renderer function
+     * @returns The ril instance for chaining
+     */
+    setStepperRenderer(renderer: WorkflowStepperRenderer): this;
+    /**
+     * Set custom workflow navigation renderer
+     * @param renderer - Custom workflow navigation renderer function
+     * @returns The ril instance for chaining
+     */
+    setWorkflowNavigationRenderer(renderer: WorkflowNavigationRenderer): this;
+    /**
+     * Set complete workflow render configuration
+     * @param config - Workflow render configuration
+     * @returns The ril instance for chaining
+     */
+    setWorkflowRenderConfig(config: WorkflowRenderConfig): this;
+    /**
+     * Get current workflow render configuration
+     * @returns Current workflow render configuration
+     */
+    getWorkflowRenderConfig(): WorkflowRenderConfig;
+    /**
+     * @deprecated Use setFormRenderConfig() instead
+     */
+    setRenderConfig(config: FormRenderConfig): this;
+    /**
+     * Get a component by its ID
+     * @param id - Component ID
+     * @returns Component configuration or undefined
+     */
+    getComponent(id: string): ComponentConfig | undefined;
+    /**
+     * List components by type (input or layout)
+     * @param type - Component type
+     * @returns Array of matching components
+     */
+    getComponentsByType(type: ComponentType): ComponentConfig[];
+    /**
+     * List components by sub-type
+     * @param subType - Component sub-type
+     * @returns Array of matching components
+     */
+    getComponentsBySubType(subType: InputType | LayoutType): ComponentConfig[];
+    /**
+     * Get components by category
+     * @param category - Component category
+     * @returns Array of matching components
+     */
+    getComponentsByCategory(category: string): ComponentConfig[];
+    /**
+     * List all registered components
+     * @returns Array of all components
+     */
+    getAllComponents(): ComponentConfig[];
+    /**
+     * Check if a component exists
+     * @param id - Component ID
+     * @returns True if component exists
+     */
+    hasComponent(id: string): boolean;
+    /**
+     * Remove a component from the configuration
+     * @param id - Component ID
+     * @returns True if component was removed
+     */
+    removeComponent(id: string): boolean;
+    /**
+     * Clear all components
+     */
+    clear(): void;
+    /**
+     * Export configuration as a plain object
+     * @returns Object with component configurations
+     */
+    export(): Record<string, ComponentConfig>;
+    /**
+     * Import configuration from a plain object
+     * @param config - Object with component configurations
+     * @returns The ril instance for chaining
+     */
+    import(config: Record<string, ComponentConfig>): this;
+    /**
+     * Get statistics about registered components and renderers
+     * @returns Object with comprehensive statistics
+     */
+    getStats(): {
+        total: number;
+        byType: Record<ComponentType, number>;
+        bySubType: Record<string, number>;
+        byCategory: Record<string, number>;
+        hasCustomRenderers: {
+            row: boolean;
+            body: boolean;
+            submitButton: boolean;
+            stepper: boolean;
+            workflowNavigation: boolean;
+        };
+    };
+    /**
+     * Validate the configuration
+     * @returns Array of validation errors
+     */
+    validate(): string[];
+}
+
+interface RilayLicenseConfig {
+    readonly licenseKey?: string;
+    readonly environment?: 'development' | 'production';
+    readonly allowTrial?: boolean;
+}
+type ComponentType = 'input' | 'layout';
+type InputType = 'text' | 'email' | 'password' | 'number' | 'select' | 'checkbox' | 'textarea' | 'file' | 'date';
+type LayoutType = 'heading' | 'paragraph' | 'container' | 'divider' | 'spacer' | 'alert';
+interface ValidationResult {
+    readonly isValid: boolean;
+    readonly errors: ValidationError[];
+    readonly warnings?: ValidationWarning[];
+}
+interface ValidationError {
+    readonly code: string;
+    readonly message: string;
+    readonly path?: string[];
+}
+interface ValidationWarning {
+    readonly code: string;
+    readonly message: string;
+    readonly path?: string[];
+}
+interface ValidationContext {
+    readonly fieldId: string;
+    readonly formData: Record<string, any>;
+    readonly fieldProps: Record<string, any>;
+    readonly touched: boolean;
+    readonly dirty: boolean;
+}
+type ValidatorFunction<TProps = any> = (value: any, context: ValidationContext, props: TProps) => ValidationResult | Promise<ValidationResult>;
+interface ValidationConfig<TProps = any> {
+    readonly validator?: ValidatorFunction<TProps>;
+    readonly debounceMs?: number;
+    readonly validateOnChange?: boolean;
+    readonly validateOnBlur?: boolean;
+    readonly validateOnSubmit?: boolean;
+    readonly dependencies?: string[];
+}
+type ComponentRenderer<TProps = any> = (props: ComponentRenderProps<TProps>) => React.ReactElement;
+interface ComponentRenderProps<TProps = any> {
+    id: string;
+    props: TProps;
+    value?: any;
+    onChange?: (value: any) => void;
+    onBlur?: () => void;
+    error?: ValidationError[];
+    warnings?: ValidationWarning[];
+    touched?: boolean;
+    disabled?: boolean;
+    isValidating?: boolean;
+    [key: string]: any;
+}
+interface ComponentOptions<TProps = any> {
+    readonly configurable?: Array<{
+        key: keyof TProps;
+        type: 'string' | 'number' | 'boolean' | 'select' | 'array';
+        label: string;
+        options?: any[];
+        default?: any;
+    }>;
+    readonly previewProps?: Partial<TProps>;
+    readonly icon?: string;
+    readonly tags?: string[];
+}
+interface ComponentConfig<TProps = any> {
+    readonly id: string;
+    readonly type: ComponentType;
+    readonly subType: InputType | LayoutType;
+    readonly name: string;
+    readonly description?: string;
+    readonly category?: string;
+    readonly renderer: ComponentRenderer<TProps>;
+    readonly options?: ComponentOptions<TProps>;
+    readonly validation?: ValidationConfig<TProps>;
+    readonly defaultProps?: Partial<TProps>;
+}
+interface FormFieldConfig {
+    readonly id: string;
+    readonly componentId: string;
+    readonly props: Record<string, any>;
+    readonly validation?: ValidationConfig;
+    readonly conditional?: ConditionalConfig;
+}
+interface FormFieldRow {
+    readonly id: string;
+    readonly fields: FormFieldConfig[];
+    readonly maxColumns?: number;
+    readonly spacing?: 'tight' | 'normal' | 'loose';
+    readonly alignment?: 'start' | 'center' | 'end' | 'stretch';
+}
+interface ConditionalConfig {
+    readonly condition: (formData: Record<string, any>) => boolean;
+    readonly action: 'show' | 'hide' | 'disable' | 'require';
+}
+interface StepLifecycleHooks {
+    readonly onBeforeEnter?: (stepData: any, allData: any, context: WorkflowContext) => Promise<void>;
+    readonly onAfterLeave?: (stepData: any, allData: any, context: WorkflowContext) => Promise<boolean>;
+    readonly onValidate?: (stepData: any, context: WorkflowContext) => Promise<ValidationResult>;
+    readonly onTransform?: (stepData: any, context: WorkflowContext) => Promise<any>;
+    readonly onError?: (error: Error, context: WorkflowContext) => Promise<void>;
+}
+interface WorkflowContext {
+    readonly workflowId: string;
+    readonly currentStepIndex: number;
+    readonly totalSteps: number;
+    readonly allData: Record<string, any>;
+    readonly stepData: Record<string, any>;
+    readonly isFirstStep: boolean;
+    readonly isLastStep: boolean;
+    readonly visitedSteps: Set<string>;
+    readonly user?: any;
+}
+interface StepPermissions {
+    readonly requiredRoles?: string[];
+    readonly requiredPermissions?: string[];
+    readonly customGuard?: (user: any, context: WorkflowContext) => boolean | Promise<boolean>;
+}
+interface DynamicStepConfig {
+    readonly resolver: (previousData: any, context: WorkflowContext) => Promise<StepConfig[]>;
+    readonly cacheKey?: string;
+    readonly retryPolicy?: RetryPolicy;
+}
+interface RetryPolicy {
+    readonly maxRetries: number;
+    readonly delayMs: number;
+    readonly backoffMultiplier?: number;
+}
+interface ConditionalBranch {
+    readonly condition: (data: any, context: WorkflowContext) => boolean | Promise<boolean>;
+    readonly steps: StepConfig[];
+    readonly fallback?: StepConfig[];
+}
+interface StepConfig {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly formConfig: FormConfiguration;
+    readonly validation?: StepValidationConfig;
+    readonly conditional?: StepConditionalConfig;
+    readonly allowSkip?: boolean;
+    readonly requiredToComplete?: boolean;
+    readonly hooks?: StepLifecycleHooks;
+    readonly permissions?: StepPermissions;
+    readonly isDynamic?: boolean;
+    readonly dynamicConfig?: DynamicStepConfig;
+    readonly renderer?: CustomStepRenderer;
+}
+interface StepValidationConfig {
+    readonly validator?: (stepData: Record<string, any>, allFormData: Record<string, any>, context: WorkflowContext) => ValidationResult | Promise<ValidationResult>;
+    readonly validateOnStepChange?: boolean;
+    readonly blockNextIfInvalid?: boolean;
+}
+interface StepConditionalConfig {
+    readonly condition: (formData: Record<string, any>, context: WorkflowContext) => boolean;
+    readonly action: 'show' | 'hide' | 'skip';
+}
+type CustomStepRenderer = (props: StepConfig) => React.ReactElement;
+interface WorkflowPersistenceData {
+    readonly workflowId: string;
+    readonly currentStepIndex: number;
+    readonly allData: Record<string, any>;
+    readonly metadata: {
+        readonly timestamp: number;
+        readonly version?: string;
+        readonly userId?: string;
+        readonly sessionId?: string;
+    };
+}
+interface PersistenceAdapter {
+    readonly name: string;
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list?(pattern?: string): Promise<string[]>;
+}
+interface PersistenceConfig {
+    readonly adapter: PersistenceAdapter;
+    readonly key?: string;
+    readonly debounceMs?: number;
+    readonly autoSave?: boolean;
+    readonly saveOnStepChange?: boolean;
+    readonly encryptionKey?: string;
+    readonly maxRetries?: number;
+    readonly retryDelayMs?: number;
+    readonly onSave?: (data: WorkflowPersistenceData) => Promise<void> | void;
+    readonly onLoad?: (data: WorkflowPersistenceData) => Promise<void> | void;
+    readonly onError?: (error: Error, operation: 'save' | 'load' | 'remove') => Promise<void> | void;
+    readonly onRetry?: (attempt: number, maxRetries: number, error: Error) => Promise<void> | void;
+}
+interface WorkflowAnalytics {
+    readonly onWorkflowStart?: (workflowId: string, context: WorkflowContext) => void;
+    readonly onWorkflowComplete?: (workflowId: string, duration: number, data: any) => void;
+    readonly onWorkflowAbandon?: (workflowId: string, currentStep: string, data: any) => void;
+    readonly onStepStart?: (stepId: string, timestamp: number, context: WorkflowContext) => void;
+    readonly onStepComplete?: (stepId: string, duration: number, data: any, context: WorkflowContext) => void;
+    readonly onStepSkip?: (stepId: string, reason: string, context: WorkflowContext) => void;
+    readonly onValidationError?: (stepId: string, errors: ValidationError[], context: WorkflowContext) => void;
+    readonly onError?: (error: Error, context: WorkflowContext) => void;
+}
+interface WorkflowOptimizations {
+    readonly preloadNextStep?: boolean;
+    readonly cacheValidation?: boolean;
+    readonly virtualizeSteps?: boolean;
+    readonly lazyLoadComponents?: boolean;
+    readonly maxConcurrentRequests?: number;
+}
+interface WorkflowVersion {
+    readonly version: string;
+    readonly migrationStrategy?: (oldData: any, newConfig: any) => any;
+    readonly compatibilityMode?: boolean;
+}
+interface WorkflowHooks {
+    readonly onStepChange?: (from: string, to: string, context: WorkflowContext) => void;
+    readonly onDataChange?: (data: any, context: WorkflowContext) => void;
+    readonly onValidation?: (result: ValidationResult, context: WorkflowContext) => void;
+}
+interface WorkflowPlugin {
+    readonly name: string;
+    readonly version?: string;
+    readonly install: (workflow: any) => void;
+    readonly hooks?: WorkflowHooks;
+    readonly dependencies?: string[];
+}
+interface WorkflowConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly steps: StepConfig[];
+    readonly branches?: ConditionalBranch[];
+    readonly navigation?: NavigationConfig;
+    readonly persistence?: PersistenceConfig;
+    readonly completion?: CompletionConfig;
+    readonly analytics?: WorkflowAnalytics;
+    readonly optimizations?: WorkflowOptimizations;
+    readonly version?: WorkflowVersion;
+    readonly plugins?: WorkflowPlugin[];
+    readonly renderConfig?: WorkflowRenderConfig;
+}
+interface NavigationConfig {
+    readonly allowBackNavigation?: boolean;
+    readonly allowStepSkipping?: boolean;
+    readonly showProgress?: boolean;
+    readonly customNavigation?: boolean;
+}
+interface CompletionConfig {
+    readonly onComplete?: (formData: Record<string, any>) => void | Promise<void>;
+    readonly confirmBeforeSubmit?: boolean;
+    readonly customCompletionStep?: any;
+}
+interface WorkflowStepperRendererProps {
+    readonly steps: StepConfig[];
+    readonly currentStepIndex: number;
+    readonly visitedSteps: Set<string>;
+    readonly onStepClick?: (stepIndex: number) => void;
+    readonly className?: string;
+}
+interface WorkflowNavigationRendererProps {
+    readonly currentStep: StepConfig;
+    readonly context: WorkflowContext;
+    readonly canGoNext: boolean;
+    readonly canGoPrevious: boolean;
+    readonly canSkip: boolean;
+    readonly isSubmitting: boolean;
+    readonly onNext: (event?: React.FormEvent) => void;
+    readonly onPrevious: (event?: React.FormEvent) => void;
+    readonly onSkip: (event?: React.FormEvent) => void;
+    readonly onSubmit: (event?: React.FormEvent) => void;
+    readonly className?: string;
+}
+type WorkflowStepperRenderer = (props: WorkflowStepperRendererProps) => React.ReactElement;
+type WorkflowNavigationRenderer = (props: WorkflowNavigationRendererProps) => React.ReactElement;
+interface WorkflowRenderConfig {
+    readonly stepperRenderer?: WorkflowStepperRenderer;
+    readonly navigationRenderer?: WorkflowNavigationRenderer;
+}
+interface FormRowRendererProps {
+    row: FormFieldRow;
+    children: React.ReactNode;
+    className?: string;
+    spacing?: 'tight' | 'normal' | 'loose';
+    alignment?: 'start' | 'center' | 'end' | 'stretch';
+}
+interface FormBodyRendererProps {
+    formConfig: FormConfiguration;
+    children: React.ReactNode;
+    className?: string;
+}
+interface FormSubmitButtonRendererProps {
+    isSubmitting: boolean;
+    isValid: boolean;
+    isDirty: boolean;
+    onSubmit: () => void;
+    className?: string;
+    children?: React.ReactNode;
+}
+type FormRowRenderer = (props: FormRowRendererProps) => React.ReactElement;
+type FormBodyRenderer = (props: FormBodyRendererProps) => React.ReactElement;
+type FormSubmitButtonRenderer = (props: FormSubmitButtonRendererProps) => React.ReactElement;
+interface FormRenderConfig {
+    readonly rowRenderer?: FormRowRenderer;
+    readonly bodyRenderer?: FormBodyRenderer;
+    readonly submitButtonRenderer?: FormSubmitButtonRenderer;
+}
+interface FormConfiguration {
+    readonly id: string;
+    readonly schema?: any;
+    readonly config: ril;
+    readonly rows: FormFieldRow[];
+    readonly allFields: FormFieldConfig[];
+    readonly renderConfig?: FormRenderConfig;
+}
+
+/**
+ * Create a Zod-based validator
+ * @param schema - Zod schema to validate against
+ * @returns Validator function
+ */
+declare const createZodValidator: <T>(schema: z.ZodSchema<T>) => ValidatorFunction;
+/**
+ * Create a custom validator from a validation function
+ * @param validationFn - Function that returns boolean, string, or Promise
+ * @returns Validator function
+ */
+declare const createCustomValidator: (validationFn: (value: any, context: ValidationContext) => boolean | string | Promise<boolean | string>) => ValidatorFunction;
+/**
+ * Combine multiple validators
+ * @param validators - Array of validators to combine
+ * @param mode - 'all' (all must pass) or 'any' (at least one must pass)
+ * @returns Combined validator function
+ */
+declare const combineValidators: (validators: ValidatorFunction[], mode?: "all" | "any") => ValidatorFunction;
+/**
+ * Create a conditional validator that only runs when condition is met
+ * @param condition - Function to determine if validation should run
+ * @param validator - Validator to run when condition is true
+ * @returns Conditional validator function
+ */
+declare const createConditionalValidator: (condition: (value: any, context: ValidationContext) => boolean, validator: ValidatorFunction) => ValidatorFunction;
+/**
+ * Common validation patterns
+ */
+declare const commonValidators: {
+    /**
+     * Required field validator
+     */
+    required: (message?: string) => ValidatorFunction;
+    /**
+     * Email validation
+     */
+    email: (message?: string) => ValidatorFunction;
+    /**
+     * Minimum length validation
+     */
+    minLength: (min: number, message?: string) => ValidatorFunction;
+    /**
+     * Maximum length validation
+     */
+    maxLength: (max: number, message?: string) => ValidatorFunction;
+    /**
+     * Pattern/regex validation
+     */
+    pattern: (regex: RegExp, message?: string) => ValidatorFunction;
+    /**
+     * Number range validation
+     */
+    numberRange: (min?: number, max?: number, message?: string) => ValidatorFunction;
+    /**
+     * URL validation
+     */
+    url: (message?: string) => ValidatorFunction;
+    /**
+     * Phone number validation (basic)
+     */
+    phoneNumber: (message?: string) => ValidatorFunction;
+    /**
+     * Custom async validation with debouncing
+     */
+    asyncValidation: (asyncFn: (value: any, context: ValidationContext) => Promise<boolean | string>, debounceMs?: number) => ValidatorFunction;
+};
+/**
+ * Utility to create validation result
+ * @param isValid - Whether validation passed
+ * @param errors - Array of errors (optional)
+ * @param warnings - Array of warnings (optional)
+ * @returns ValidationResult object
+ */
+declare const createValidationResult: (isValid: boolean, errors?: ValidationError[], warnings?: ValidationError[]) => ValidationResult;
+/**
+ * Utility to create validation error
+ * @param code - Error code
+ * @param message - Error message
+ * @param path - Error path (optional)
+ * @returns ValidationError object
+ */
+declare const createValidationError: (code: string, message: string, path?: string[]) => ValidationError;
+
+/**
+ * LocalStorage persistence adapter
+ * Perfect for client-side persistence across browser sessions
+ */
+declare class LocalStorageAdapter implements PersistenceAdapter {
+    readonly name = "localStorage";
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(pattern?: string): Promise<string[]>;
+}
+/**
+ * SessionStorage persistence adapter
+ * Perfect for temporary persistence within a single browser session
+ */
+declare class SessionStorageAdapter implements PersistenceAdapter {
+    readonly name = "sessionStorage";
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(pattern?: string): Promise<string[]>;
+}
+/**
+ * In-Memory persistence adapter
+ * Perfect for testing or temporary workflows
+ */
+declare class MemoryAdapter implements PersistenceAdapter {
+    readonly name = "memory";
+    private storage;
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(pattern?: string): Promise<string[]>;
+    clear(): void;
+}
+/**
+ * Composite adapter that can use multiple adapters with fallback
+ * Perfect for robust persistence with primary/backup strategies
+ */
+declare class CompositeAdapter implements PersistenceAdapter {
+    private primary;
+    private fallbacks;
+    readonly name = "composite";
+    constructor(primary: PersistenceAdapter, fallbacks?: PersistenceAdapter[]);
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(pattern?: string): Promise<string[]>;
+}
+
+/**
+ * Utility functions to create persistence configurations easily
+ */
+declare const persistence: {
+    /**
+     * Create a localStorage-based persistence configuration
+     */
+    localStorage(options?: Partial<PersistenceConfig>): PersistenceConfig;
+    /**
+     * Create a sessionStorage-based persistence configuration
+     */
+    sessionStorage(options?: Partial<PersistenceConfig>): PersistenceConfig;
+    /**
+     * Create an in-memory persistence configuration (for testing)
+     */
+    memory(options?: Partial<PersistenceConfig>): PersistenceConfig;
+    /**
+     * Create a custom persistence configuration
+     */
+    custom(adapter: PersistenceAdapter, options?: Partial<PersistenceConfig>): PersistenceConfig;
+};
+/**
+ * Utility to create persistence configurations with retry logic
+ */
+declare function createResilientPersistence(primary: PersistenceAdapter, fallback?: PersistenceAdapter, options?: Partial<PersistenceConfig>): PersistenceConfig;
+
+export { type CompletionConfig, type ComponentConfig, type ComponentOptions, type ComponentRenderProps, type ComponentRenderer, type ComponentType, CompositeAdapter, type ConditionalBranch, type ConditionalConfig, type CustomStepRenderer, type DynamicStepConfig, type FormBodyRenderer, type FormBodyRendererProps, type FormConfiguration, type FormFieldConfig, type FormFieldRow, type FormRenderConfig, type FormRowRenderer, type FormRowRendererProps, type FormSubmitButtonRenderer, type FormSubmitButtonRendererProps, type InputType, type LayoutType, LocalStorageAdapter, MemoryAdapter, type NavigationConfig, type PersistenceAdapter, type PersistenceConfig, type RetryPolicy, type RilayLicenseConfig, SessionStorageAdapter, type StepConditionalConfig, type StepConfig, type StepLifecycleHooks, type StepPermissions, type StepValidationConfig, type ValidationConfig, type ValidationContext, type ValidationError, type ValidationResult, type ValidationWarning, type ValidatorFunction, type WorkflowAnalytics, type WorkflowConfig, type WorkflowContext, type WorkflowHooks, type WorkflowNavigationRenderer, type WorkflowNavigationRendererProps, type WorkflowOptimizations, type WorkflowPersistenceData, type WorkflowPlugin, type WorkflowRenderConfig, type WorkflowStepperRenderer, type WorkflowStepperRendererProps, type WorkflowVersion, combineValidators, commonValidators, createConditionalValidator, createCustomValidator, createResilientPersistence, createValidationError, createValidationResult, createZodValidator, persistence, ril };

package/dist/index.d.ts

@@ -0,0 +1,636 @@
+import React from 'react';
+import { z } from 'zod';
+
+/**
+ * Main configuration class for Rilay form components and workflows
+ * Manages component registration, retrieval, and configuration
+ */
+declare class ril {
+    private components;
+    private formRenderConfig;
+    private workflowRenderConfig;
+    static create(): ril;
+    /**
+     * Add a component to the configuration
+     * @param subType - The component subtype (e.g., 'text', 'email', 'heading')
+     * @param config - Component configuration without id and subType
+     * @returns The ril instance for chaining
+     */
+    addComponent<TProps = any>(subType: InputType | LayoutType, config: Omit<ComponentConfig<TProps>, 'id' | 'subType'> & {
+        id?: string;
+    }): this;
+    /**
+     * Set custom row renderer
+     * @param renderer - Custom row renderer function
+     * @returns The ril instance for chaining
+     */
+    setRowRenderer(renderer: FormRowRenderer): this;
+    /**
+     * Set custom body renderer
+     * @param renderer - Custom body renderer function
+     * @returns The ril instance for chaining
+     */
+    setBodyRenderer(renderer: FormBodyRenderer): this;
+    /**
+     * Set custom submit button renderer
+     * @param renderer - Custom submit button renderer function
+     * @returns The ril instance for chaining
+     */
+    setSubmitButtonRenderer(renderer: FormSubmitButtonRenderer): this;
+    /**
+     * Set complete form render configuration
+     * @param config - Form render configuration
+     * @returns The ril instance for chaining
+     */
+    setFormRenderConfig(config: FormRenderConfig): this;
+    /**
+     * Get current form render configuration
+     * @returns Current form render configuration
+     */
+    getFormRenderConfig(): FormRenderConfig;
+    /**
+     * Set custom stepper renderer for workflows
+     * @param renderer - Custom stepper renderer function
+     * @returns The ril instance for chaining
+     */
+    setStepperRenderer(renderer: WorkflowStepperRenderer): this;
+    /**
+     * Set custom workflow navigation renderer
+     * @param renderer - Custom workflow navigation renderer function
+     * @returns The ril instance for chaining
+     */
+    setWorkflowNavigationRenderer(renderer: WorkflowNavigationRenderer): this;
+    /**
+     * Set complete workflow render configuration
+     * @param config - Workflow render configuration
+     * @returns The ril instance for chaining
+     */
+    setWorkflowRenderConfig(config: WorkflowRenderConfig): this;
+    /**
+     * Get current workflow render configuration
+     * @returns Current workflow render configuration
+     */
+    getWorkflowRenderConfig(): WorkflowRenderConfig;
+    /**
+     * @deprecated Use setFormRenderConfig() instead
+     */
+    setRenderConfig(config: FormRenderConfig): this;
+    /**
+     * Get a component by its ID
+     * @param id - Component ID
+     * @returns Component configuration or undefined
+     */
+    getComponent(id: string): ComponentConfig | undefined;
+    /**
+     * List components by type (input or layout)
+     * @param type - Component type
+     * @returns Array of matching components
+     */
+    getComponentsByType(type: ComponentType): ComponentConfig[];
+    /**
+     * List components by sub-type
+     * @param subType - Component sub-type
+     * @returns Array of matching components
+     */
+    getComponentsBySubType(subType: InputType | LayoutType): ComponentConfig[];
+    /**
+     * Get components by category
+     * @param category - Component category
+     * @returns Array of matching components
+     */
+    getComponentsByCategory(category: string): ComponentConfig[];
+    /**
+     * List all registered components
+     * @returns Array of all components
+     */
+    getAllComponents(): ComponentConfig[];
+    /**
+     * Check if a component exists
+     * @param id - Component ID
+     * @returns True if component exists
+     */
+    hasComponent(id: string): boolean;
+    /**
+     * Remove a component from the configuration
+     * @param id - Component ID
+     * @returns True if component was removed
+     */
+    removeComponent(id: string): boolean;
+    /**
+     * Clear all components
+     */
+    clear(): void;
+    /**
+     * Export configuration as a plain object
+     * @returns Object with component configurations
+     */
+    export(): Record<string, ComponentConfig>;
+    /**
+     * Import configuration from a plain object
+     * @param config - Object with component configurations
+     * @returns The ril instance for chaining
+     */
+    import(config: Record<string, ComponentConfig>): this;
+    /**
+     * Get statistics about registered components and renderers
+     * @returns Object with comprehensive statistics
+     */
+    getStats(): {
+        total: number;
+        byType: Record<ComponentType, number>;
+        bySubType: Record<string, number>;
+        byCategory: Record<string, number>;
+        hasCustomRenderers: {
+            row: boolean;
+            body: boolean;
+            submitButton: boolean;
+            stepper: boolean;
+            workflowNavigation: boolean;
+        };
+    };
+    /**
+     * Validate the configuration
+     * @returns Array of validation errors
+     */
+    validate(): string[];
+}
+
+interface RilayLicenseConfig {
+    readonly licenseKey?: string;
+    readonly environment?: 'development' | 'production';
+    readonly allowTrial?: boolean;
+}
+type ComponentType = 'input' | 'layout';
+type InputType = 'text' | 'email' | 'password' | 'number' | 'select' | 'checkbox' | 'textarea' | 'file' | 'date';
+type LayoutType = 'heading' | 'paragraph' | 'container' | 'divider' | 'spacer' | 'alert';
+interface ValidationResult {
+    readonly isValid: boolean;
+    readonly errors: ValidationError[];
+    readonly warnings?: ValidationWarning[];
+}
+interface ValidationError {
+    readonly code: string;
+    readonly message: string;
+    readonly path?: string[];
+}
+interface ValidationWarning {
+    readonly code: string;
+    readonly message: string;
+    readonly path?: string[];
+}
+interface ValidationContext {
+    readonly fieldId: string;
+    readonly formData: Record<string, any>;
+    readonly fieldProps: Record<string, any>;
+    readonly touched: boolean;
+    readonly dirty: boolean;
+}
+type ValidatorFunction<TProps = any> = (value: any, context: ValidationContext, props: TProps) => ValidationResult | Promise<ValidationResult>;
+interface ValidationConfig<TProps = any> {
+    readonly validator?: ValidatorFunction<TProps>;
+    readonly debounceMs?: number;
+    readonly validateOnChange?: boolean;
+    readonly validateOnBlur?: boolean;
+    readonly validateOnSubmit?: boolean;
+    readonly dependencies?: string[];
+}
+type ComponentRenderer<TProps = any> = (props: ComponentRenderProps<TProps>) => React.ReactElement;
+interface ComponentRenderProps<TProps = any> {
+    id: string;
+    props: TProps;
+    value?: any;
+    onChange?: (value: any) => void;
+    onBlur?: () => void;
+    error?: ValidationError[];
+    warnings?: ValidationWarning[];
+    touched?: boolean;
+    disabled?: boolean;
+    isValidating?: boolean;
+    [key: string]: any;
+}
+interface ComponentOptions<TProps = any> {
+    readonly configurable?: Array<{
+        key: keyof TProps;
+        type: 'string' | 'number' | 'boolean' | 'select' | 'array';
+        label: string;
+        options?: any[];
+        default?: any;
+    }>;
+    readonly previewProps?: Partial<TProps>;
+    readonly icon?: string;
+    readonly tags?: string[];
+}
+interface ComponentConfig<TProps = any> {
+    readonly id: string;
+    readonly type: ComponentType;
+    readonly subType: InputType | LayoutType;
+    readonly name: string;
+    readonly description?: string;
+    readonly category?: string;
+    readonly renderer: ComponentRenderer<TProps>;
+    readonly options?: ComponentOptions<TProps>;
+    readonly validation?: ValidationConfig<TProps>;
+    readonly defaultProps?: Partial<TProps>;
+}
+interface FormFieldConfig {
+    readonly id: string;
+    readonly componentId: string;
+    readonly props: Record<string, any>;
+    readonly validation?: ValidationConfig;
+    readonly conditional?: ConditionalConfig;
+}
+interface FormFieldRow {
+    readonly id: string;
+    readonly fields: FormFieldConfig[];
+    readonly maxColumns?: number;
+    readonly spacing?: 'tight' | 'normal' | 'loose';
+    readonly alignment?: 'start' | 'center' | 'end' | 'stretch';
+}
+interface ConditionalConfig {
+    readonly condition: (formData: Record<string, any>) => boolean;
+    readonly action: 'show' | 'hide' | 'disable' | 'require';
+}
+interface StepLifecycleHooks {
+    readonly onBeforeEnter?: (stepData: any, allData: any, context: WorkflowContext) => Promise<void>;
+    readonly onAfterLeave?: (stepData: any, allData: any, context: WorkflowContext) => Promise<boolean>;
+    readonly onValidate?: (stepData: any, context: WorkflowContext) => Promise<ValidationResult>;
+    readonly onTransform?: (stepData: any, context: WorkflowContext) => Promise<any>;
+    readonly onError?: (error: Error, context: WorkflowContext) => Promise<void>;
+}
+interface WorkflowContext {
+    readonly workflowId: string;
+    readonly currentStepIndex: number;
+    readonly totalSteps: number;
+    readonly allData: Record<string, any>;
+    readonly stepData: Record<string, any>;
+    readonly isFirstStep: boolean;
+    readonly isLastStep: boolean;
+    readonly visitedSteps: Set<string>;
+    readonly user?: any;
+}
+interface StepPermissions {
+    readonly requiredRoles?: string[];
+    readonly requiredPermissions?: string[];
+    readonly customGuard?: (user: any, context: WorkflowContext) => boolean | Promise<boolean>;
+}
+interface DynamicStepConfig {
+    readonly resolver: (previousData: any, context: WorkflowContext) => Promise<StepConfig[]>;
+    readonly cacheKey?: string;
+    readonly retryPolicy?: RetryPolicy;
+}
+interface RetryPolicy {
+    readonly maxRetries: number;
+    readonly delayMs: number;
+    readonly backoffMultiplier?: number;
+}
+interface ConditionalBranch {
+    readonly condition: (data: any, context: WorkflowContext) => boolean | Promise<boolean>;
+    readonly steps: StepConfig[];
+    readonly fallback?: StepConfig[];
+}
+interface StepConfig {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly formConfig: FormConfiguration;
+    readonly validation?: StepValidationConfig;
+    readonly conditional?: StepConditionalConfig;
+    readonly allowSkip?: boolean;
+    readonly requiredToComplete?: boolean;
+    readonly hooks?: StepLifecycleHooks;
+    readonly permissions?: StepPermissions;
+    readonly isDynamic?: boolean;
+    readonly dynamicConfig?: DynamicStepConfig;
+    readonly renderer?: CustomStepRenderer;
+}
+interface StepValidationConfig {
+    readonly validator?: (stepData: Record<string, any>, allFormData: Record<string, any>, context: WorkflowContext) => ValidationResult | Promise<ValidationResult>;
+    readonly validateOnStepChange?: boolean;
+    readonly blockNextIfInvalid?: boolean;
+}
+interface StepConditionalConfig {
+    readonly condition: (formData: Record<string, any>, context: WorkflowContext) => boolean;
+    readonly action: 'show' | 'hide' | 'skip';
+}
+type CustomStepRenderer = (props: StepConfig) => React.ReactElement;
+interface WorkflowPersistenceData {
+    readonly workflowId: string;
+    readonly currentStepIndex: number;
+    readonly allData: Record<string, any>;
+    readonly metadata: {
+        readonly timestamp: number;
+        readonly version?: string;
+        readonly userId?: string;
+        readonly sessionId?: string;
+    };
+}
+interface PersistenceAdapter {
+    readonly name: string;
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list?(pattern?: string): Promise<string[]>;
+}
+interface PersistenceConfig {
+    readonly adapter: PersistenceAdapter;
+    readonly key?: string;
+    readonly debounceMs?: number;
+    readonly autoSave?: boolean;
+    readonly saveOnStepChange?: boolean;
+    readonly encryptionKey?: string;
+    readonly maxRetries?: number;
+    readonly retryDelayMs?: number;
+    readonly onSave?: (data: WorkflowPersistenceData) => Promise<void> | void;
+    readonly onLoad?: (data: WorkflowPersistenceData) => Promise<void> | void;
+    readonly onError?: (error: Error, operation: 'save' | 'load' | 'remove') => Promise<void> | void;
+    readonly onRetry?: (attempt: number, maxRetries: number, error: Error) => Promise<void> | void;
+}
+interface WorkflowAnalytics {
+    readonly onWorkflowStart?: (workflowId: string, context: WorkflowContext) => void;
+    readonly onWorkflowComplete?: (workflowId: string, duration: number, data: any) => void;
+    readonly onWorkflowAbandon?: (workflowId: string, currentStep: string, data: any) => void;
+    readonly onStepStart?: (stepId: string, timestamp: number, context: WorkflowContext) => void;
+    readonly onStepComplete?: (stepId: string, duration: number, data: any, context: WorkflowContext) => void;
+    readonly onStepSkip?: (stepId: string, reason: string, context: WorkflowContext) => void;
+    readonly onValidationError?: (stepId: string, errors: ValidationError[], context: WorkflowContext) => void;
+    readonly onError?: (error: Error, context: WorkflowContext) => void;
+}
+interface WorkflowOptimizations {
+    readonly preloadNextStep?: boolean;
+    readonly cacheValidation?: boolean;
+    readonly virtualizeSteps?: boolean;
+    readonly lazyLoadComponents?: boolean;
+    readonly maxConcurrentRequests?: number;
+}
+interface WorkflowVersion {
+    readonly version: string;
+    readonly migrationStrategy?: (oldData: any, newConfig: any) => any;
+    readonly compatibilityMode?: boolean;
+}
+interface WorkflowHooks {
+    readonly onStepChange?: (from: string, to: string, context: WorkflowContext) => void;
+    readonly onDataChange?: (data: any, context: WorkflowContext) => void;
+    readonly onValidation?: (result: ValidationResult, context: WorkflowContext) => void;
+}
+interface WorkflowPlugin {
+    readonly name: string;
+    readonly version?: string;
+    readonly install: (workflow: any) => void;
+    readonly hooks?: WorkflowHooks;
+    readonly dependencies?: string[];
+}
+interface WorkflowConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly steps: StepConfig[];
+    readonly branches?: ConditionalBranch[];
+    readonly navigation?: NavigationConfig;
+    readonly persistence?: PersistenceConfig;
+    readonly completion?: CompletionConfig;
+    readonly analytics?: WorkflowAnalytics;
+    readonly optimizations?: WorkflowOptimizations;
+    readonly version?: WorkflowVersion;
+    readonly plugins?: WorkflowPlugin[];
+    readonly renderConfig?: WorkflowRenderConfig;
+}
+interface NavigationConfig {
+    readonly allowBackNavigation?: boolean;
+    readonly allowStepSkipping?: boolean;
+    readonly showProgress?: boolean;
+    readonly customNavigation?: boolean;
+}
+interface CompletionConfig {
+    readonly onComplete?: (formData: Record<string, any>) => void | Promise<void>;
+    readonly confirmBeforeSubmit?: boolean;
+    readonly customCompletionStep?: any;
+}
+interface WorkflowStepperRendererProps {
+    readonly steps: StepConfig[];
+    readonly currentStepIndex: number;
+    readonly visitedSteps: Set<string>;
+    readonly onStepClick?: (stepIndex: number) => void;
+    readonly className?: string;
+}
+interface WorkflowNavigationRendererProps {
+    readonly currentStep: StepConfig;
+    readonly context: WorkflowContext;
+    readonly canGoNext: boolean;
+    readonly canGoPrevious: boolean;
+    readonly canSkip: boolean;
+    readonly isSubmitting: boolean;
+    readonly onNext: (event?: React.FormEvent) => void;
+    readonly onPrevious: (event?: React.FormEvent) => void;
+    readonly onSkip: (event?: React.FormEvent) => void;
+    readonly onSubmit: (event?: React.FormEvent) => void;
+    readonly className?: string;
+}
+type WorkflowStepperRenderer = (props: WorkflowStepperRendererProps) => React.ReactElement;
+type WorkflowNavigationRenderer = (props: WorkflowNavigationRendererProps) => React.ReactElement;
+interface WorkflowRenderConfig {
+    readonly stepperRenderer?: WorkflowStepperRenderer;
+    readonly navigationRenderer?: WorkflowNavigationRenderer;
+}
+interface FormRowRendererProps {
+    row: FormFieldRow;
+    children: React.ReactNode;
+    className?: string;
+    spacing?: 'tight' | 'normal' | 'loose';
+    alignment?: 'start' | 'center' | 'end' | 'stretch';
+}
+interface FormBodyRendererProps {
+    formConfig: FormConfiguration;
+    children: React.ReactNode;
+    className?: string;
+}
+interface FormSubmitButtonRendererProps {
+    isSubmitting: boolean;
+    isValid: boolean;
+    isDirty: boolean;
+    onSubmit: () => void;
+    className?: string;
+    children?: React.ReactNode;
+}
+type FormRowRenderer = (props: FormRowRendererProps) => React.ReactElement;
+type FormBodyRenderer = (props: FormBodyRendererProps) => React.ReactElement;
+type FormSubmitButtonRenderer = (props: FormSubmitButtonRendererProps) => React.ReactElement;
+interface FormRenderConfig {
+    readonly rowRenderer?: FormRowRenderer;
+    readonly bodyRenderer?: FormBodyRenderer;
+    readonly submitButtonRenderer?: FormSubmitButtonRenderer;
+}
+interface FormConfiguration {
+    readonly id: string;
+    readonly schema?: any;
+    readonly config: ril;
+    readonly rows: FormFieldRow[];
+    readonly allFields: FormFieldConfig[];
+    readonly renderConfig?: FormRenderConfig;
+}
+
+/**
+ * Create a Zod-based validator
+ * @param schema - Zod schema to validate against
+ * @returns Validator function
+ */
+declare const createZodValidator: <T>(schema: z.ZodSchema<T>) => ValidatorFunction;
+/**
+ * Create a custom validator from a validation function
+ * @param validationFn - Function that returns boolean, string, or Promise
+ * @returns Validator function
+ */
+declare const createCustomValidator: (validationFn: (value: any, context: ValidationContext) => boolean | string | Promise<boolean | string>) => ValidatorFunction;
+/**
+ * Combine multiple validators
+ * @param validators - Array of validators to combine
+ * @param mode - 'all' (all must pass) or 'any' (at least one must pass)
+ * @returns Combined validator function
+ */
+declare const combineValidators: (validators: ValidatorFunction[], mode?: "all" | "any") => ValidatorFunction;
+/**
+ * Create a conditional validator that only runs when condition is met
+ * @param condition - Function to determine if validation should run
+ * @param validator - Validator to run when condition is true
+ * @returns Conditional validator function
+ */
+declare const createConditionalValidator: (condition: (value: any, context: ValidationContext) => boolean, validator: ValidatorFunction) => ValidatorFunction;
+/**
+ * Common validation patterns
+ */
+declare const commonValidators: {
+    /**
+     * Required field validator
+     */
+    required: (message?: string) => ValidatorFunction;
+    /**
+     * Email validation
+     */
+    email: (message?: string) => ValidatorFunction;
+    /**
+     * Minimum length validation
+     */
+    minLength: (min: number, message?: string) => ValidatorFunction;
+    /**
+     * Maximum length validation
+     */
+    maxLength: (max: number, message?: string) => ValidatorFunction;
+    /**
+     * Pattern/regex validation
+     */
+    pattern: (regex: RegExp, message?: string) => ValidatorFunction;
+    /**
+     * Number range validation
+     */
+    numberRange: (min?: number, max?: number, message?: string) => ValidatorFunction;
+    /**
+     * URL validation
+     */
+    url: (message?: string) => ValidatorFunction;
+    /**
+     * Phone number validation (basic)
+     */
+    phoneNumber: (message?: string) => ValidatorFunction;
+    /**
+     * Custom async validation with debouncing
+     */
+    asyncValidation: (asyncFn: (value: any, context: ValidationContext) => Promise<boolean | string>, debounceMs?: number) => ValidatorFunction;
+};
+/**
+ * Utility to create validation result
+ * @param isValid - Whether validation passed
+ * @param errors - Array of errors (optional)
+ * @param warnings - Array of warnings (optional)
+ * @returns ValidationResult object
+ */
+declare const createValidationResult: (isValid: boolean, errors?: ValidationError[], warnings?: ValidationError[]) => ValidationResult;
+/**
+ * Utility to create validation error
+ * @param code - Error code
+ * @param message - Error message
+ * @param path - Error path (optional)
+ * @returns ValidationError object
+ */
+declare const createValidationError: (code: string, message: string, path?: string[]) => ValidationError;
+
+/**
+ * LocalStorage persistence adapter
+ * Perfect for client-side persistence across browser sessions
+ */
+declare class LocalStorageAdapter implements PersistenceAdapter {
+    readonly name = "localStorage";
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(pattern?: string): Promise<string[]>;
+}
+/**
+ * SessionStorage persistence adapter
+ * Perfect for temporary persistence within a single browser session
+ */
+declare class SessionStorageAdapter implements PersistenceAdapter {
+    readonly name = "sessionStorage";
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(pattern?: string): Promise<string[]>;
+}
+/**
+ * In-Memory persistence adapter
+ * Perfect for testing or temporary workflows
+ */
+declare class MemoryAdapter implements PersistenceAdapter {
+    readonly name = "memory";
+    private storage;
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(pattern?: string): Promise<string[]>;
+    clear(): void;
+}
+/**
+ * Composite adapter that can use multiple adapters with fallback
+ * Perfect for robust persistence with primary/backup strategies
+ */
+declare class CompositeAdapter implements PersistenceAdapter {
+    private primary;
+    private fallbacks;
+    readonly name = "composite";
+    constructor(primary: PersistenceAdapter, fallbacks?: PersistenceAdapter[]);
+    save(key: string, data: WorkflowPersistenceData): Promise<void>;
+    load(key: string): Promise<WorkflowPersistenceData | null>;
+    remove(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(pattern?: string): Promise<string[]>;
+}
+
+/**
+ * Utility functions to create persistence configurations easily
+ */
+declare const persistence: {
+    /**
+     * Create a localStorage-based persistence configuration
+     */
+    localStorage(options?: Partial<PersistenceConfig>): PersistenceConfig;
+    /**
+     * Create a sessionStorage-based persistence configuration
+     */
+    sessionStorage(options?: Partial<PersistenceConfig>): PersistenceConfig;
+    /**
+     * Create an in-memory persistence configuration (for testing)
+     */
+    memory(options?: Partial<PersistenceConfig>): PersistenceConfig;
+    /**
+     * Create a custom persistence configuration
+     */
+    custom(adapter: PersistenceAdapter, options?: Partial<PersistenceConfig>): PersistenceConfig;
+};
+/**
+ * Utility to create persistence configurations with retry logic
+ */
+declare function createResilientPersistence(primary: PersistenceAdapter, fallback?: PersistenceAdapter, options?: Partial<PersistenceConfig>): PersistenceConfig;
+
+export { type CompletionConfig, type ComponentConfig, type ComponentOptions, type ComponentRenderProps, type ComponentRenderer, type ComponentType, CompositeAdapter, type ConditionalBranch, type ConditionalConfig, type CustomStepRenderer, type DynamicStepConfig, type FormBodyRenderer, type FormBodyRendererProps, type FormConfiguration, type FormFieldConfig, type FormFieldRow, type FormRenderConfig, type FormRowRenderer, type FormRowRendererProps, type FormSubmitButtonRenderer, type FormSubmitButtonRendererProps, type InputType, type LayoutType, LocalStorageAdapter, MemoryAdapter, type NavigationConfig, type PersistenceAdapter, type PersistenceConfig, type RetryPolicy, type RilayLicenseConfig, SessionStorageAdapter, type StepConditionalConfig, type StepConfig, type StepLifecycleHooks, type StepPermissions, type StepValidationConfig, type ValidationConfig, type ValidationContext, type ValidationError, type ValidationResult, type ValidationWarning, type ValidatorFunction, type WorkflowAnalytics, type WorkflowConfig, type WorkflowContext, type WorkflowHooks, type WorkflowNavigationRenderer, type WorkflowNavigationRendererProps, type WorkflowOptimizations, type WorkflowPersistenceData, type WorkflowPlugin, type WorkflowRenderConfig, type WorkflowStepperRenderer, type WorkflowStepperRendererProps, type WorkflowVersion, combineValidators, commonValidators, createConditionalValidator, createCustomValidator, createResilientPersistence, createValidationError, createValidationResult, createZodValidator, persistence, ril };

package/dist/index.js

@@ -0,0 +1 @@
+'use strict';var zod=require('zod');var y=class o{constructor(){this.components=new Map;this.formRenderConfig={};this.workflowRenderConfig={};}static create(){return new o}addComponent(e,r){let t=r.id||`${r.type}-${e}-${Date.now()}`,n={id:t,subType:e,...r};return this.components.set(t,n),this}setRowRenderer(e){return this.formRenderConfig={...this.formRenderConfig,rowRenderer:e},this}setBodyRenderer(e){return this.formRenderConfig={...this.formRenderConfig,bodyRenderer:e},this}setSubmitButtonRenderer(e){return this.formRenderConfig={...this.formRenderConfig,submitButtonRenderer:e},this}setFormRenderConfig(e){return this.formRenderConfig=e,this}getFormRenderConfig(){return {...this.formRenderConfig}}setStepperRenderer(e){return this.workflowRenderConfig={...this.workflowRenderConfig,stepperRenderer:e},this}setWorkflowNavigationRenderer(e){return this.workflowRenderConfig={...this.workflowRenderConfig,navigationRenderer:e},this}setWorkflowRenderConfig(e){return this.workflowRenderConfig=e,this}getWorkflowRenderConfig(){return {...this.workflowRenderConfig}}setRenderConfig(e){return this.setFormRenderConfig(e)}getComponent(e){return this.components.get(e)}getComponentsByType(e){return Array.from(this.components.values()).filter(r=>r.type===e)}getComponentsBySubType(e){return Array.from(this.components.values()).filter(r=>r.subType===e)}getComponentsByCategory(e){return Array.from(this.components.values()).filter(r=>r.category===e)}getAllComponents(){return Array.from(this.components.values())}hasComponent(e){return this.components.has(e)}removeComponent(e){return this.components.delete(e)}clear(){this.components.clear();}export(){return Object.fromEntries(this.components)}import(e){for(let[r,t]of Object.entries(e))this.components.set(r,t);return this}getStats(){let e=Array.from(this.components.values());return {total:e.length,byType:e.reduce((r,t)=>(r[t.type]=(r[t.type]||0)+1,r),{}),bySubType:e.reduce((r,t)=>(r[t.subType]=(r[t.subType]||0)+1,r),{}),byCategory:e.reduce((r,t)=>{let n=t.category||"uncategorized";return r[n]=(r[n]||0)+1,r},{}),hasCustomRenderers:{row:!!this.formRenderConfig.rowRenderer,body:!!this.formRenderConfig.bodyRenderer,submitButton:!!this.formRenderConfig.submitButtonRenderer,stepper:!!this.workflowRenderConfig.stepperRenderer,workflowNavigation:!!this.workflowRenderConfig.navigationRenderer}}}validate(){let e=[],r=Array.from(this.components.values()),t=r.map(s=>s.id),n=t.filter((s,i)=>t.indexOf(s)!==i);n.length>0&&e.push(`Duplicate component IDs found: ${n.join(", ")}`);let a=r.filter(s=>!s.renderer);return a.length>0&&e.push(`Components without renderer: ${a.map(s=>s.id).join(", ")}`),e}};var m=o=>async e=>{try{return await o.parseAsync(e),{isValid:!0,errors:[]}}catch(r){return r&&typeof r=="object"&&"errors"in r&&Array.isArray(r.errors)?{isValid:false,errors:r.errors.map(t=>({code:t.code,message:t.message,path:t.path?t.path.map(String):[]}))}:{isValid:false,errors:[{code:"unknown",message:r instanceof Error?r.message:"Unknown validation error"}]}}},w=o=>async(e,r,t)=>{try{let n=await o(e,r);return n===!0?{isValid:!0,errors:[]}:n===!1?{isValid:!1,errors:[{code:"validation_failed",message:"Validation failed"}]}:{isValid:!1,errors:[{code:"validation_failed",message:String(n)}]}}catch(n){return {isValid:false,errors:[{code:"validation_error",message:n instanceof Error?n.message:"Validation error"}]}}},b=(o,e="all")=>async(r,t,n)=>{let a=await Promise.all(o.map(l=>l(r,t,n)));if(e==="all"){let l=a.flatMap(u=>u.errors),c=a.flatMap(u=>u.warnings||[]);return {isValid:a.every(u=>u.isValid),errors:l,warnings:c.length>0?c:void 0}}if(a.some(l=>l.isValid)){let l=a.flatMap(c=>c.warnings||[]);return {isValid:true,errors:[],warnings:l.length>0?l:void 0}}return {isValid:false,errors:a.flatMap(l=>l.errors)}},v=(o,e)=>async(r,t,n)=>o(r,t)?e(r,t,n):{isValid:true,errors:[]},P={required:(o="This field is required")=>w(e=>e==null||e===""?o:!0),email:(o="Invalid email format")=>m(zod.z.string().email(o)),minLength:(o,e)=>m(zod.z.string().min(o,e||`Minimum ${o} characters required`)),maxLength:(o,e)=>m(zod.z.string().max(o,e||`Maximum ${o} characters allowed`)),pattern:(o,e="Invalid format")=>m(zod.z.string().regex(o,e)),numberRange:(o,e,r)=>{let t=zod.z.number();return o!==void 0&&(t=t.min(o,r||`Value must be at least ${o}`)),e!==void 0&&(t=t.max(e,r||`Value must be at most ${e}`)),m(t)},url:(o="Invalid URL format")=>m(zod.z.string().url(o)),phoneNumber:(o="Invalid phone number format")=>m(zod.z.string().regex(/^\+?[\d\s\-\(\)]+$/,o)),asyncValidation:(o,e=300)=>{let r=new Map;return (t,n,a)=>new Promise(s=>{let i=`${n.fieldId}-${JSON.stringify(t)}`;r.has(i)&&clearTimeout(r.get(i));let l=setTimeout(async()=>{try{let c=await o(t,n);s(c===!0?{isValid:!0,errors:[]}:{isValid:!1,errors:[{code:"async_validation_failed",message:typeof c=="string"?c:"Async validation failed"}]});}catch(c){s({isValid:false,errors:[{code:"async_validation_error",message:c instanceof Error?c.message:"Async validation error"}]});}finally{r.delete(i);}},e);r.set(i,l);})}},k=(o,e=[],r)=>({isValid:o,errors:e,warnings:r}),V=(o,e,r)=>({code:o,message:e,path:r});var g=class{constructor(){this.name="localStorage";}async save(e,r){try{localStorage.setItem(e,JSON.stringify(r));}catch(t){throw new Error(`Failed to save to localStorage: ${t}`)}}async load(e){try{let r=localStorage.getItem(e);return r?JSON.parse(r):null}catch(r){throw new Error(`Failed to load from localStorage: ${r}`)}}async remove(e){try{localStorage.removeItem(e);}catch(r){throw new Error(`Failed to remove from localStorage: ${r}`)}}async exists(e){return localStorage.getItem(e)!==null}async list(e){let r=[];for(let t=0;t<localStorage.length;t++){let n=localStorage.key(t);n&&(!e||n.includes(e))&&r.push(n);}return r}},p=class{constructor(){this.name="sessionStorage";}async save(e,r){try{sessionStorage.setItem(e,JSON.stringify(r));}catch(t){throw new Error(`Failed to save to sessionStorage: ${t}`)}}async load(e){try{let r=sessionStorage.getItem(e);return r?JSON.parse(r):null}catch(r){throw new Error(`Failed to load from sessionStorage: ${r}`)}}async remove(e){try{sessionStorage.removeItem(e);}catch(r){throw new Error(`Failed to remove from sessionStorage: ${r}`)}}async exists(e){return sessionStorage.getItem(e)!==null}async list(e){let r=[];for(let t=0;t<sessionStorage.length;t++){let n=sessionStorage.key(t);n&&(!e||n.includes(e))&&r.push(n);}return r}},f=class{constructor(){this.name="memory";this.storage=new Map;}async save(e,r){this.storage.set(e,{...r});}async load(e){let r=this.storage.get(e);return r?{...r}:null}async remove(e){this.storage.delete(e);}async exists(e){return this.storage.has(e)}async list(e){let r=Array.from(this.storage.keys());return e?r.filter(t=>t.includes(e)):r}clear(){this.storage.clear();}},h=class{constructor(e,r=[]){this.primary=e;this.fallbacks=r;this.name="composite";}async save(e,r){let t=[this.primary,...this.fallbacks];for(let n of t)try{await n.save(e,r);return}catch(a){console.warn(`Failed to save with ${n.name}:`,a);}throw new Error("All persistence adapters failed to save")}async load(e){let r=[this.primary,...this.fallbacks];for(let t of r)try{let n=await t.load(e);if(n)return n}catch(n){console.warn(`Failed to load with ${t.name}:`,n);}return null}async remove(e){let r=[this.primary,...this.fallbacks],t=[];for(let n of r)try{await n.remove(e);}catch(a){t.push(a);}if(t.length===r.length)throw new Error(`All adapters failed to remove: ${t.map(n=>n.message).join(", ")}`)}async exists(e){let r=[this.primary,...this.fallbacks];for(let t of r)try{if(await t.exists(e))return !0}catch(n){console.warn(`Failed to check existence with ${t.name}:`,n);}return  false}async list(e){try{return await this.primary.list?.(e)||[]}catch(r){console.warn("Failed to list with primary adapter:",r);for(let t of this.fallbacks)try{return await t.list?.(e)||[]}catch(n){console.warn(`Failed to list with fallback ${t.name}:`,n);}return []}}};var E={localStorage(o={}){return {adapter:new g,debounceMs:1e3,autoSave:true,saveOnStepChange:true,...o}},sessionStorage(o={}){return {adapter:new p,debounceMs:1e3,autoSave:true,saveOnStepChange:true,...o}},memory(o={}){return {adapter:new f,debounceMs:0,autoSave:true,saveOnStepChange:true,...o}},custom(o,e={}){return {adapter:o,debounceMs:1e3,autoSave:true,saveOnStepChange:true,...e}}};function T(o,e,r={}){let t=e||new f;return {adapter:{name:`resilient-${o.name}`,async save(a,s){try{await o.save(a,s);}catch(i){console.warn("Primary persistence failed, using fallback:",i),await t.save(a,s);}},async load(a){try{let s=await o.load(a);if(s)return s}catch(s){console.warn("Primary persistence load failed, trying fallback:",s);}return await t.load(a)},async remove(a){let s=[];try{await o.remove(a);}catch(i){s.push(i);}try{await t.remove(a);}catch(i){s.push(i);}if(s.length===2)throw new Error(`Both adapters failed: ${s.map(i=>i.message).join(", ")}`)},async exists(a){try{if(await o.exists(a))return !0}catch(s){console.warn("Primary persistence exists check failed:",s);}try{return await t.exists(a)}catch(s){return console.warn("Fallback persistence exists check failed:",s),false}},async list(a){try{return await o.list?.(a)||[]}catch(s){console.warn("Primary persistence list failed:",s);try{return await t.list?.(a)||[]}catch(i){return console.warn("Fallback persistence list failed:",i),[]}}}},debounceMs:1e3,autoSave:true,saveOnStepChange:true,maxRetries:3,retryDelayMs:1e3,...r}}exports.CompositeAdapter=h;exports.LocalStorageAdapter=g;exports.MemoryAdapter=f;exports.SessionStorageAdapter=p;exports.combineValidators=b;exports.commonValidators=P;exports.createConditionalValidator=v;exports.createCustomValidator=w;exports.createResilientPersistence=T;exports.createValidationError=V;exports.createValidationResult=k;exports.createZodValidator=m;exports.persistence=E;exports.ril=y;

package/dist/index.mjs

@@ -0,0 +1 @@
+import {z}from'zod';var y=class o{constructor(){this.components=new Map;this.formRenderConfig={};this.workflowRenderConfig={};}static create(){return new o}addComponent(e,r){let t=r.id||`${r.type}-${e}-${Date.now()}`,n={id:t,subType:e,...r};return this.components.set(t,n),this}setRowRenderer(e){return this.formRenderConfig={...this.formRenderConfig,rowRenderer:e},this}setBodyRenderer(e){return this.formRenderConfig={...this.formRenderConfig,bodyRenderer:e},this}setSubmitButtonRenderer(e){return this.formRenderConfig={...this.formRenderConfig,submitButtonRenderer:e},this}setFormRenderConfig(e){return this.formRenderConfig=e,this}getFormRenderConfig(){return {...this.formRenderConfig}}setStepperRenderer(e){return this.workflowRenderConfig={...this.workflowRenderConfig,stepperRenderer:e},this}setWorkflowNavigationRenderer(e){return this.workflowRenderConfig={...this.workflowRenderConfig,navigationRenderer:e},this}setWorkflowRenderConfig(e){return this.workflowRenderConfig=e,this}getWorkflowRenderConfig(){return {...this.workflowRenderConfig}}setRenderConfig(e){return this.setFormRenderConfig(e)}getComponent(e){return this.components.get(e)}getComponentsByType(e){return Array.from(this.components.values()).filter(r=>r.type===e)}getComponentsBySubType(e){return Array.from(this.components.values()).filter(r=>r.subType===e)}getComponentsByCategory(e){return Array.from(this.components.values()).filter(r=>r.category===e)}getAllComponents(){return Array.from(this.components.values())}hasComponent(e){return this.components.has(e)}removeComponent(e){return this.components.delete(e)}clear(){this.components.clear();}export(){return Object.fromEntries(this.components)}import(e){for(let[r,t]of Object.entries(e))this.components.set(r,t);return this}getStats(){let e=Array.from(this.components.values());return {total:e.length,byType:e.reduce((r,t)=>(r[t.type]=(r[t.type]||0)+1,r),{}),bySubType:e.reduce((r,t)=>(r[t.subType]=(r[t.subType]||0)+1,r),{}),byCategory:e.reduce((r,t)=>{let n=t.category||"uncategorized";return r[n]=(r[n]||0)+1,r},{}),hasCustomRenderers:{row:!!this.formRenderConfig.rowRenderer,body:!!this.formRenderConfig.bodyRenderer,submitButton:!!this.formRenderConfig.submitButtonRenderer,stepper:!!this.workflowRenderConfig.stepperRenderer,workflowNavigation:!!this.workflowRenderConfig.navigationRenderer}}}validate(){let e=[],r=Array.from(this.components.values()),t=r.map(s=>s.id),n=t.filter((s,i)=>t.indexOf(s)!==i);n.length>0&&e.push(`Duplicate component IDs found: ${n.join(", ")}`);let a=r.filter(s=>!s.renderer);return a.length>0&&e.push(`Components without renderer: ${a.map(s=>s.id).join(", ")}`),e}};var m=o=>async e=>{try{return await o.parseAsync(e),{isValid:!0,errors:[]}}catch(r){return r&&typeof r=="object"&&"errors"in r&&Array.isArray(r.errors)?{isValid:false,errors:r.errors.map(t=>({code:t.code,message:t.message,path:t.path?t.path.map(String):[]}))}:{isValid:false,errors:[{code:"unknown",message:r instanceof Error?r.message:"Unknown validation error"}]}}},w=o=>async(e,r,t)=>{try{let n=await o(e,r);return n===!0?{isValid:!0,errors:[]}:n===!1?{isValid:!1,errors:[{code:"validation_failed",message:"Validation failed"}]}:{isValid:!1,errors:[{code:"validation_failed",message:String(n)}]}}catch(n){return {isValid:false,errors:[{code:"validation_error",message:n instanceof Error?n.message:"Validation error"}]}}},b=(o,e="all")=>async(r,t,n)=>{let a=await Promise.all(o.map(l=>l(r,t,n)));if(e==="all"){let l=a.flatMap(u=>u.errors),c=a.flatMap(u=>u.warnings||[]);return {isValid:a.every(u=>u.isValid),errors:l,warnings:c.length>0?c:void 0}}if(a.some(l=>l.isValid)){let l=a.flatMap(c=>c.warnings||[]);return {isValid:true,errors:[],warnings:l.length>0?l:void 0}}return {isValid:false,errors:a.flatMap(l=>l.errors)}},v=(o,e)=>async(r,t,n)=>o(r,t)?e(r,t,n):{isValid:true,errors:[]},P={required:(o="This field is required")=>w(e=>e==null||e===""?o:!0),email:(o="Invalid email format")=>m(z.string().email(o)),minLength:(o,e)=>m(z.string().min(o,e||`Minimum ${o} characters required`)),maxLength:(o,e)=>m(z.string().max(o,e||`Maximum ${o} characters allowed`)),pattern:(o,e="Invalid format")=>m(z.string().regex(o,e)),numberRange:(o,e,r)=>{let t=z.number();return o!==void 0&&(t=t.min(o,r||`Value must be at least ${o}`)),e!==void 0&&(t=t.max(e,r||`Value must be at most ${e}`)),m(t)},url:(o="Invalid URL format")=>m(z.string().url(o)),phoneNumber:(o="Invalid phone number format")=>m(z.string().regex(/^\+?[\d\s\-\(\)]+$/,o)),asyncValidation:(o,e=300)=>{let r=new Map;return (t,n,a)=>new Promise(s=>{let i=`${n.fieldId}-${JSON.stringify(t)}`;r.has(i)&&clearTimeout(r.get(i));let l=setTimeout(async()=>{try{let c=await o(t,n);s(c===!0?{isValid:!0,errors:[]}:{isValid:!1,errors:[{code:"async_validation_failed",message:typeof c=="string"?c:"Async validation failed"}]});}catch(c){s({isValid:false,errors:[{code:"async_validation_error",message:c instanceof Error?c.message:"Async validation error"}]});}finally{r.delete(i);}},e);r.set(i,l);})}},k=(o,e=[],r)=>({isValid:o,errors:e,warnings:r}),V=(o,e,r)=>({code:o,message:e,path:r});var g=class{constructor(){this.name="localStorage";}async save(e,r){try{localStorage.setItem(e,JSON.stringify(r));}catch(t){throw new Error(`Failed to save to localStorage: ${t}`)}}async load(e){try{let r=localStorage.getItem(e);return r?JSON.parse(r):null}catch(r){throw new Error(`Failed to load from localStorage: ${r}`)}}async remove(e){try{localStorage.removeItem(e);}catch(r){throw new Error(`Failed to remove from localStorage: ${r}`)}}async exists(e){return localStorage.getItem(e)!==null}async list(e){let r=[];for(let t=0;t<localStorage.length;t++){let n=localStorage.key(t);n&&(!e||n.includes(e))&&r.push(n);}return r}},p=class{constructor(){this.name="sessionStorage";}async save(e,r){try{sessionStorage.setItem(e,JSON.stringify(r));}catch(t){throw new Error(`Failed to save to sessionStorage: ${t}`)}}async load(e){try{let r=sessionStorage.getItem(e);return r?JSON.parse(r):null}catch(r){throw new Error(`Failed to load from sessionStorage: ${r}`)}}async remove(e){try{sessionStorage.removeItem(e);}catch(r){throw new Error(`Failed to remove from sessionStorage: ${r}`)}}async exists(e){return sessionStorage.getItem(e)!==null}async list(e){let r=[];for(let t=0;t<sessionStorage.length;t++){let n=sessionStorage.key(t);n&&(!e||n.includes(e))&&r.push(n);}return r}},f=class{constructor(){this.name="memory";this.storage=new Map;}async save(e,r){this.storage.set(e,{...r});}async load(e){let r=this.storage.get(e);return r?{...r}:null}async remove(e){this.storage.delete(e);}async exists(e){return this.storage.has(e)}async list(e){let r=Array.from(this.storage.keys());return e?r.filter(t=>t.includes(e)):r}clear(){this.storage.clear();}},h=class{constructor(e,r=[]){this.primary=e;this.fallbacks=r;this.name="composite";}async save(e,r){let t=[this.primary,...this.fallbacks];for(let n of t)try{await n.save(e,r);return}catch(a){console.warn(`Failed to save with ${n.name}:`,a);}throw new Error("All persistence adapters failed to save")}async load(e){let r=[this.primary,...this.fallbacks];for(let t of r)try{let n=await t.load(e);if(n)return n}catch(n){console.warn(`Failed to load with ${t.name}:`,n);}return null}async remove(e){let r=[this.primary,...this.fallbacks],t=[];for(let n of r)try{await n.remove(e);}catch(a){t.push(a);}if(t.length===r.length)throw new Error(`All adapters failed to remove: ${t.map(n=>n.message).join(", ")}`)}async exists(e){let r=[this.primary,...this.fallbacks];for(let t of r)try{if(await t.exists(e))return !0}catch(n){console.warn(`Failed to check existence with ${t.name}:`,n);}return  false}async list(e){try{return await this.primary.list?.(e)||[]}catch(r){console.warn("Failed to list with primary adapter:",r);for(let t of this.fallbacks)try{return await t.list?.(e)||[]}catch(n){console.warn(`Failed to list with fallback ${t.name}:`,n);}return []}}};var E={localStorage(o={}){return {adapter:new g,debounceMs:1e3,autoSave:true,saveOnStepChange:true,...o}},sessionStorage(o={}){return {adapter:new p,debounceMs:1e3,autoSave:true,saveOnStepChange:true,...o}},memory(o={}){return {adapter:new f,debounceMs:0,autoSave:true,saveOnStepChange:true,...o}},custom(o,e={}){return {adapter:o,debounceMs:1e3,autoSave:true,saveOnStepChange:true,...e}}};function T(o,e,r={}){let t=e||new f;return {adapter:{name:`resilient-${o.name}`,async save(a,s){try{await o.save(a,s);}catch(i){console.warn("Primary persistence failed, using fallback:",i),await t.save(a,s);}},async load(a){try{let s=await o.load(a);if(s)return s}catch(s){console.warn("Primary persistence load failed, trying fallback:",s);}return await t.load(a)},async remove(a){let s=[];try{await o.remove(a);}catch(i){s.push(i);}try{await t.remove(a);}catch(i){s.push(i);}if(s.length===2)throw new Error(`Both adapters failed: ${s.map(i=>i.message).join(", ")}`)},async exists(a){try{if(await o.exists(a))return !0}catch(s){console.warn("Primary persistence exists check failed:",s);}try{return await t.exists(a)}catch(s){return console.warn("Fallback persistence exists check failed:",s),false}},async list(a){try{return await o.list?.(a)||[]}catch(s){console.warn("Primary persistence list failed:",s);try{return await t.list?.(a)||[]}catch(i){return console.warn("Fallback persistence list failed:",i),[]}}}},debounceMs:1e3,autoSave:true,saveOnStepChange:true,maxRetries:3,retryDelayMs:1e3,...r}}export{h as CompositeAdapter,g as LocalStorageAdapter,f as MemoryAdapter,p as SessionStorageAdapter,b as combineValidators,P as commonValidators,v as createConditionalValidator,w as createCustomValidator,T as createResilientPersistence,V as createValidationError,k as createValidationResult,m as createZodValidator,E as persistence,y as ril};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@rilaykit/core",
+  "version": "0.1.1-alpha.1",
+  "description": "Core types, configurations, and utilities for the RilayKit form library",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "react",
+    "forms",
+    "typescript",
+    "validation",
+    "builder-pattern"
+  ],
+  "author": "Rilay Team",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.23",
+    "react": "^19.1.0",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {
+    "zod": "^3.22.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:ui": "vitest --ui",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}