extended-dynamic-forms 0.1.21 → 0.1.23

package/dist/conditionals/v2/types.d.ts

@@ -0,0 +1,47 @@
+import { ErrorSchema } from '@rjsf/utils';
+import { RulesLogic } from 'json-logic-js';
+
+export type JsonLogicRule = RulesLogic;
+export type ConditionPredicate = (formData: any) => boolean;
+export type Condition = ConditionPredicate | JsonLogicRule;
+export interface Rule<T> {
+    name: string;
+    condition: Condition;
+    effect: T;
+    order?: number;
+}
+export interface EngineConfig<T, C = any> {
+    applyEffects: (effects: T[], baseConfig: C, formData: any) => C;
+    defaultConfig: () => C;
+}
+export type ConditionalEngineHook<T, C = any> = (rules: Rule<T>[], baseConfig: C, formData: any) => C;
+export interface UiEffect {
+    op: 'add' | 'remove' | 'replace';
+    path: string;
+    value?: any;
+}
+export interface JsonPatchSchemaEffect {
+    op: 'add' | 'remove' | 'replace';
+    path: string;
+    value?: any;
+}
+export interface CustomSchemaEffect {
+    op: 'require' | 'optional';
+    path: string;
+    field: string;
+}
+export type SchemaEffect = JsonPatchSchemaEffect | CustomSchemaEffect;
+export interface ValidationEffect {
+    /**
+     * Name of the validation rule for debugging purposes
+     */
+    name: string;
+    /**
+     * Determines if this validation should be applied based on current form data
+     */
+    isActive: Condition;
+    /**
+     * Applies validation logic and adds errors to the ErrorSchema
+     */
+    validate: (errors: ErrorSchema, formData: any) => void;
+}

package/dist/conditionals/v2/utils/dynamicArrayItems.d.ts

@@ -0,0 +1,59 @@
+import { UiSchema } from '@rjsf/utils';
+
+/**
+ * Function type for dynamic uiSchema.items in RJSF fork
+ * This enables O(n) performance for array conditionals
+ */
+export type ArrayItemsFunction = (itemData: any, index: number, formContext?: any) => UiSchema;
+/**
+ * Function type for conditional logic applied to array items
+ */
+export type ArrayItemConditionalFn = (itemData: any, index: number, formContext?: any) => Partial<UiSchema>;
+/**
+ * Creates a dynamic uiSchema.items function for array fields
+ *
+ * @param baseItemUiSchema - Base UI schema applied to all array items
+ * @param conditionalLogic - Function that returns conditional UI schema modifications
+ * @returns Function compatible with RJSF fork's dynamic uiSchema.items
+ *
+ * @example
+ * ```typescript
+ * const directorsUiSchema = {
+ *   items: createDynamicArrayItemsUiSchema(
+ *     { 'ui:order': ['name', 'hasShareholding', 'shareholdingPercentage'] },
+ *     (itemData) => {
+ *       if (!itemData?.hasShareholding) {
+ *         return { shareholdingPercentage: { 'ui:widget': 'hidden' } };
+ *       }
+ *       return {};
+ *     }
+ *   )
+ * };
+ * ```
+ */
+export declare function createDynamicArrayItemsUiSchema(baseItemUiSchema: UiSchema, conditionalLogic: ArrayItemConditionalFn): ArrayItemsFunction;
+/**
+ * Safely merges UI schemas with proper handling of nested properties
+ *
+ * @param base - Base UI schema
+ * @param overrides - Conditional UI schema overrides
+ * @returns Merged UI schema
+ */
+export declare function mergeItemUiSchema(base: UiSchema, overrides: Partial<UiSchema>): UiSchema;
+/**
+ * Helper to create common conditional patterns
+ */
+export declare const arrayItemPatterns: {
+    /**
+     * Show/hide a field based on a condition
+     */
+    hideField: (fieldName: string, condition: (itemData: any) => boolean) => ArrayItemConditionalFn;
+    /**
+     * Make a field required based on a condition
+     */
+    requireField: (fieldName: string, condition: (itemData: any) => boolean) => ArrayItemConditionalFn;
+    /**
+     * Apply styles to first/last items
+     */
+    applyIndexStyles: (totalItems: number) => ArrayItemConditionalFn;
+};

package/dist/conditionals/v2/utils/jsonPatch.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Simple JSON Patch-like utility for applying operations to objects
+ * Supports add, remove, and replace operations with JSONPath-like syntax
+ */
+export declare function applyPatch(target: any, operations: Array<{
+    op: string;
+    path: string;
+    value?: any;
+}>): any;

package/dist/events/FormEventContext.d.ts

@@ -0,0 +1,19 @@
+import { default as React, ReactNode } from 'react';
+import { FormEventHub } from './FormEventHub';
+
+export interface FormEventContextType {
+    eventHub: FormEventHub;
+    formData?: any;
+}
+export interface FormEventProviderProps {
+    eventHub: FormEventHub;
+    formData?: any;
+    children: ReactNode;
+}
+export declare const FormEventProvider: React.FC<FormEventProviderProps>;
+export declare const useFormEventHub: () => FormEventContextType;
+export declare const useFieldEventHandlers: (fieldId: string, schema?: any, fieldPath?: string[]) => {
+    onFocus: (value: any) => Promise<void>;
+    onBlur: (value: any) => Promise<void>;
+    onChange: (value: any) => Promise<void>;
+};

package/dist/events/FormEventHub.d.ts

@@ -0,0 +1,27 @@
+import { FormEventHandlers, FieldEventHandlers, WebhookConfig } from '../types';
+
+export declare class FormEventHub {
+    private formHandlers;
+    private fieldHandlers;
+    private webhooks;
+    private debounceTimers;
+    private webhookQueue;
+    private isProcessingQueue;
+    constructor(formHandlers: FormEventHandlers, fieldHandlers?: FieldEventHandlers, webhooks?: WebhookConfig[]);
+    handleBeforeSubmit(data: any): Promise<any>;
+    handleAfterSubmit(data: any): Promise<void>;
+    handleBeforeValidation(data: any): Promise<any>;
+    handleAfterValidation(data: any, errors: any): Promise<void>;
+    handleFieldEvent(eventType: 'focus' | 'blur' | 'change', fieldId: string, fieldValue: any, schema?: any, formData?: any, fieldPath?: string[]): Promise<void>;
+    private processWebhooks;
+    private debounceWebhook;
+    private queueWebhook;
+    private processWebhookQueue;
+    private callWebhook;
+    createFieldEventHandlers(fieldId: string, schema?: any, formData?: any, fieldPath?: string[]): {
+        onFocus: (value: any) => Promise<void>;
+        onBlur: (value: any) => Promise<void>;
+        onChange: (value: any) => Promise<void>;
+    };
+    cleanup(): void;
+}

package/dist/events/FormEventManager.d.ts

@@ -0,0 +1,10 @@
+import { FormEventHandlers } from '../types';
+
+export declare class FormEventManager {
+    private handlers;
+    constructor(handlers: FormEventHandlers);
+    handleBeforeSubmit(data: any): Promise<any>;
+    handleAfterSubmit(data: any): Promise<void>;
+    handleBeforeValidation(data: any): Promise<any>;
+    handleAfterValidation(data: any, errors: any): Promise<void>;
+}

package/dist/events/index.d.ts

@@ -0,0 +1,4 @@
+export { FormEventManager } from './FormEventManager';
+export { FormEventHub } from './FormEventHub';
+export { FormEventProvider, useFormEventHub, useFieldEventHandlers, } from './FormEventContext';
+export type { FormEventHandlers, FieldEventHandlers, FormFieldEvent, WebhookConfig, } from '../types';

package/dist/hooks/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+
+export * from './components';
+export * from './widgets';
+export * from './layouts';
+export * from './events';
+export * from './conditionals';
+export * from './types';
+export * from './utils';
+export * from './hooks';
+export type { FormProps, IChangeEvent } from '@rjsf/core';
+export type { RJSFSchema, UiSchema, WidgetProps, FieldProps, ArrayFieldTemplateProps, ObjectFieldTemplateProps, FieldTemplateProps, ErrorSchema, RJSFValidationError, } from '@rjsf/utils';
+export { default as validator } from '@rjsf/validator-ajv8';
+export { ExtendedForm } from './ExtendedForm';
+export { WizardForm } from './WizardForm';
+export type { WizardFormProps, WizardStep } from './WizardForm';