@digiform/wizard 0.1.7 → 0.2.2

package/features/state-management/machines/performance.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Performance optimization utilities for form machine
+ * Provides conditional imports and optimizations based on environment
+ */
+export declare const isDevelopment: boolean;
+export declare const isProduction: boolean;
+export declare const devOnlyLogger: {
+    log: {
+        (...data: any[]): void;
+        (message?: any, ...optionalParams: any[]): void;
+    };
+    warn: {
+        (...data: any[]): void;
+        (message?: any, ...optionalParams: any[]): void;
+    };
+    error: {
+        (...data: any[]): void;
+        (message?: any, ...optionalParams: any[]): void;
+    };
+    group: {
+        (...data: any[]): void;
+        (...label: any[]): void;
+    };
+    groupEnd: {
+        (): void;
+        (): void;
+    };
+};
+export declare const performanceMonitor: {
+    mark: (name: string) => PerformanceMark;
+    measure: (name: string, start: string, end?: string) => PerformanceMeasure;
+    now: () => number;
+} | {
+    mark: () => void;
+    measure: () => void;
+    now: () => number;
+};
+export declare const memoryUtils: {
+    /**
+     * Efficient object comparison for React optimization
+     */
+    shallowEqual<T extends Record<string, any>>(obj1: T, obj2: T): boolean;
+    /**
+     * Deep object comparison with depth limit for performance
+     */
+    deepEqual(obj1: any, obj2: any, maxDepth?: number): boolean;
+    /**
+     * Optimized object merging
+     */
+    fastMerge<T extends Record<string, any>>(target: T, source: Partial<T>): T;
+    /**
+     * Create optimized cache key
+     */
+    createCacheKey(...parts: (string | number | boolean | null | undefined)[]): string;
+};
+export declare const lazyUtils: {
+    /**
+     * Memoized lazy loading
+     */
+    memoizedImport<T>(importFn: () => Promise<T>): () => Promise<T>;
+    /**
+     * Conditional import based on feature flags
+     */
+    conditionalImport<T>(condition: boolean, importFn: () => Promise<T>, fallback: T): Promise<T>;
+};
+export declare const features: {
+    advancedTriggers: boolean;
+    complexValidation: boolean;
+    debugging: boolean;
+    monitoring: boolean;
+};
+export declare const optimizationConstants: {
+    readonly TRIGGER_CACHE_TTL: 1000;
+    readonly GUARD_CACHE_TTL: 500;
+    readonly CONFIG_CACHE_TTL: 5000;
+    readonly MAX_CACHE_SIZE: 100;
+    readonly MAX_EXECUTION_TIME: 1000;
+    readonly GC_INTERVAL: 30000;
+    readonly MAX_RETAINED_OBJECTS: 50;
+};

package/features/state-management/machines/types.d.ts

@@ -0,0 +1,315 @@
+import { ActionExecution, ActionTrigger, ComponentAction, DialogConfig, FieldChangeState, FieldValidationState, FieldWarning, FormData, FormErrors, FormFieldValue, FormWizardConfig, VerificationConfig, VerificationStatus } from '../../../../../core/src/index.ts';
+import { ContextExecutionPlan, TriggerExecution } from './componentTriggerEngine';
+export interface MinimalFormApi {
+    getFieldValue: (id: string) => unknown;
+    resetField: (id: string) => void;
+    setFieldValue: (id: string, value: unknown, options?: {
+        dontUpdateMeta?: boolean;
+    }) => void;
+    state?: {
+        isDirty?: boolean;
+    };
+    getFieldMeta?: (id: string) => unknown;
+}
+export type { FormFieldValue, FieldValidationState, VerificationStatus };
+export interface ComponentTriggerState {
+    componentId: string;
+    triggerId: string;
+    lastEvaluated?: number;
+    lastTriggered?: number;
+    isActive: boolean;
+    originalValue?: unknown;
+}
+export interface ComponentOriginalValue {
+    value: unknown;
+    timestamp: number;
+    source: "initialized" | "api_populated" | "user_reset" | "user_verified" | "dialog_verified" | "edit_start";
+    isPopulated: boolean;
+}
+export interface ComponentActionExecution {
+    actionId: string;
+    componentId: string;
+    status: "pending" | "executing" | "completed" | "failed";
+    startTime: number;
+    endTime?: number;
+    result?: unknown;
+    error?: Error;
+}
+export interface ComponentAlert {
+    id: string;
+    componentId: string;
+    message: string;
+    type: "info" | "warning" | "error" | "success";
+    position: "inline" | "tooltip" | "sidebar";
+    dismissible: boolean;
+    timestamp: number;
+    autoHide?: boolean;
+    autoHideDelay?: number;
+}
+export interface FormMachineContext {
+    config: FormWizardConfig;
+    currentStepId: string;
+    currentStepIndex: number;
+    data: FormData;
+    errors: FormErrors;
+    dirtyFields: Record<string, boolean>;
+    touchedFields: Record<string, boolean>;
+    isValid: boolean;
+    isSubmitting: boolean;
+    fieldStates: Record<string, {
+        value: unknown;
+        error: string | null;
+        isDirty: boolean;
+        isTouched: boolean;
+        isValidating: boolean;
+    }>;
+    sectionBackups: Record<string, Record<string, FormFieldValue>>;
+    activeActions: Record<string, ActionExecution>;
+    actionResults: Record<string, unknown>;
+    activeDialog: DialogConfig | null;
+    executingTrigger: ActionTrigger | null;
+    pendingNavigation: {
+        type: "next" | "previous" | "step";
+        stepId?: string;
+    } | null;
+    canNavigate: boolean;
+    waitingForActions: boolean;
+    fieldChangeState: Record<string, FieldChangeState>;
+    fieldValidationState: FieldValidationState;
+    componentTriggerState: Record<string, ComponentTriggerState>;
+    activeComponentActions: Record<string, ComponentActionExecution[]>;
+    componentAlerts: Record<string, ComponentAlert[]>;
+    componentOriginalValues: Record<string, ComponentOriginalValue>;
+    activeExecutionPlan: ContextExecutionPlan | null;
+    executionResults: Record<string, unknown>;
+    contextActionCompletions: Record<string, {
+        componentId: string;
+        actionId: string;
+        result: unknown;
+        timestamp: number;
+    }>;
+    saveState: {
+        saveInProgress: boolean;
+        saveInitiator: "sectionButton" | "navigation" | null;
+        savingSection: string | null;
+        executionPlan: ContextExecutionPlan | null;
+        pendingVerifications: string[];
+        completedVerifications: string[];
+        validationErrors: Record<string, string[]>;
+        saveStartTimestamp: number | null;
+    };
+}
+export type FormMachineEvents = {
+    type: "SET_DATA";
+    key: string;
+    value: FormFieldValue;
+} | {
+    type: "SET_FIELD_STATE";
+    componentId: string;
+    state: Partial<FormMachineContext["fieldStates"][string]>;
+} | {
+    type: "VALIDATE_FIELD";
+    componentId: string;
+} | {
+    type: "VALIDATE_SECTION";
+    sectionId: string;
+} | {
+    type: "VALIDATE_STEP";
+    stepId: string;
+} | {
+    type: "VALIDATE_FORM";
+} | {
+    type: "START_SECTION_EDIT";
+    sectionId: string;
+    componentIds: string[];
+} | {
+    type: "CANCEL_SECTION_EDIT";
+    sectionId: string;
+} | {
+    type: "NEXT";
+} | {
+    type: "PREVIOUS";
+} | {
+    type: "GO_TO_STEP";
+    stepId: string;
+} | {
+    type: "REQUEST_NAVIGATION";
+    navigationType: "next" | "previous" | "step";
+    stepId?: string;
+} | {
+    type: "SUBMIT";
+} | {
+    type: "SUBMIT_SUCCESS";
+} | {
+    type: "SUBMIT_ERROR";
+    error: Error;
+} | {
+    type: "RESET";
+} | {
+    type: "EXECUTE_ACTIONS";
+    trigger: ActionTrigger;
+} | {
+    type: "EXECUTE_TRIGGER";
+    trigger: ActionTrigger;
+} | {
+    type: "ACTION_START";
+    actionId: string;
+} | {
+    type: "ACTION_SUCCESS";
+    actionId: string;
+    result: unknown;
+} | {
+    type: "ACTION_ERROR";
+    actionId: string;
+    error: Error;
+} | {
+    type: "ACTIONS_COMPLETED";
+    results: Record<string, unknown>;
+} | {
+    type: "SHOW_ACTION_DIALOG";
+    dialogConfig: DialogConfig;
+} | {
+    type: "HIDE_ACTION_DIALOG";
+} | {
+    type: "DIALOG_BUTTON_CLICK";
+    buttonAction: string;
+} | {
+    type: "FIELD_CHANGED";
+    fieldId: string;
+    oldValue: unknown;
+    newValue: unknown;
+} | {
+    type: "TRIGGER_FIELD_WARNING";
+    fieldId: string;
+    warning: FieldWarning;
+} | {
+    type: "DISMISS_FIELD_WARNING";
+    fieldId: string;
+    warningId?: string;
+} | {
+    type: "SHOW_FIELD_WARNING";
+    fieldId: string;
+    warningId: string;
+    message: string;
+    warningType?: "warning" | "error" | "info";
+} | {
+    type: "START_FIELD_VERIFICATION";
+    fieldId: string;
+    config: VerificationConfig;
+} | {
+    type: "FIELD_VERIFICATION_COMPLETE";
+    fieldId: string;
+    result: unknown;
+    success: boolean;
+} | {
+    type: "CLEAR_FIELD_CHANGES";
+    fieldId?: string;
+} | {
+    type: "EVALUATE_COMPONENT_TRIGGERS";
+    componentId: string;
+    eventType: "valueChange" | "focus" | "blur";
+    value?: unknown;
+} | {
+    type: "TRIGGER_COMPONENT_ACTION";
+    componentId: string;
+    triggerId: string;
+    actionId: string;
+    eventType?: "valueChange" | "focus" | "blur" | "navigationAttempt" | "sectionSave";
+} | {
+    type: "COMPONENT_ACTION_START";
+    componentId: string;
+    actionId: string;
+} | {
+    type: "COMPONENT_ACTION_COMPLETE";
+    componentId: string;
+    actionId: string;
+    result?: unknown;
+} | {
+    type: "COMPONENT_ACTION_FAILED";
+    componentId: string;
+    actionId: string;
+    error: Error;
+} | {
+    type: "SHOW_COMPONENT_ALERT";
+    componentId: string;
+    alert: ComponentAlert;
+} | {
+    type: "DISMISS_COMPONENT_ALERT";
+    componentId: string;
+    alertId?: string;
+} | {
+    type: "CLEAR_COMPONENT_ALERT";
+    componentId: string;
+} | {
+    type: "SET_COMPONENT_ORIGINAL_VALUE";
+    componentId: string;
+    value: unknown;
+    source?: "initialized" | "api_populated" | "user_reset" | "user_verified" | "edit_start";
+} | {
+    type: "MARK_COMPONENT_AS_POPULATED";
+    componentId: string;
+    value: unknown;
+} | {
+    type: "EXECUTE_CONTEXT_ACTION";
+    execution: TriggerExecution;
+    action: ComponentAction;
+} | {
+    type: "CONTEXT_ACTION_COMPLETE";
+    componentId: string;
+    actionId: string;
+    result: unknown;
+} | {
+    type: "CONTEXT_ACTIONS_COMPLETE";
+    results?: Record<string, unknown>;
+} | {
+    type: "EXECUTE_CONTEXT_ACTIONS";
+    executionPlan: ContextExecutionPlan;
+} | {
+    type: "EXECUTE_FIELD_CHANGE_ACTIONS";
+    executionPlan: ContextExecutionPlan;
+    componentId: string;
+    eventType: string;
+    value: unknown;
+} | {
+    type: "SHOW_DIALOG";
+    dialog: DialogConfig;
+} | {
+    type: "TRIGGER_ACTIONS_COMPLETE";
+} | {
+    type: "DIALOG_VERIFIED";
+} | {
+    type: "DIALOG_CANCELLED";
+} | {
+    type: "RESET_FIELD_TANSTACK_STATE";
+    componentId: string;
+    form?: MinimalFormApi;
+} | {
+    type: "UPDATE_COMPONENT_ORIGINAL_VALUE";
+    componentId: string;
+} | {
+    type: "COMPONENT_ACTION_ERROR";
+    componentId: string;
+    actionId: string;
+    error: Error;
+} | {
+    type: "START_SAVE";
+    initiator: "sectionButton" | "navigation";
+    sectionId: string;
+} | {
+    type: "SAVE_VALIDATION_SUCCESS";
+    sectionId: string;
+    executionPlan: ContextExecutionPlan;
+} | {
+    type: "SAVE_VALIDATION_FAILED";
+    sectionId: string;
+    errors: Record<string, string[]>;
+} | {
+    type: "SAVE_DIALOG_SHOWN";
+    componentId: string;
+    actionId: string;
+    dialogId: string;
+} | {
+    type: "SAVE_ACTIONS_COMPLETE";
+    sectionId: string;
+    results: Record<string, unknown>;
+};