extended-dynamic-forms 0.4.2 → 0.5.1

package/dist/types/index.d.ts

@@ -1,7 +1,12 @@
-import { FormProps } from '@rjsf/core';
+import { FormProps, IChangeEvent } from '@rjsf/core';
 import { RJSFSchema, UiSchema } from '@rjsf/utils';
 
 export type WebhookEventType = 'focus' | 'blur' | 'change' | 'submit' | 'stepChange' | 'validationError';
+/** Submit-time field state, expressed as RFC 6901 pointers relative to the answers. */
+export interface SubmissionMeta {
+    hiddenFields: string[];
+    disabledFields: string[];
+}
 export interface FormEventHandlers {
     beforeSubmit?: (data: any) => Promise<any> | any;
     afterSubmit?: (data: any) => Promise<void> | void;
@@ -17,6 +22,9 @@ export interface FormFieldEvent {
     timestamp: number;
     fieldPath?: string[];
 }
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
 export interface WebhookConfig {
     url: string;
     method?: 'POST' | 'PUT' | 'PATCH';
@@ -25,13 +33,25 @@ export interface WebhookConfig {
     debounceMs?: number;
     retries?: number;
     timeout?: number;
+    /** Static extra root properties. Reserved event properties are ignored. */
+    body?: Record<string, JsonValue>;
+    /** Static URL query pairs, appended in order without replacing existing keys. */
+    query?: Array<{
+        key: string;
+        value: string;
+    }>;
+    /** Literal top-level answer keys; this does not redact fieldValue or errors. */
+    formDataFields?: string[];
 }
 export interface FieldEventHandlers {
     onFieldFocus?: (event: FormFieldEvent) => Promise<void> | void;
     onFieldBlur?: (event: FormFieldEvent) => Promise<void> | void;
     onFieldChange?: (event: FormFieldEvent) => Promise<void> | void;
 }
-export interface ExtendedFormProps extends Omit<FormProps, 'validator'>, FormEventHandlers, FieldEventHandlers {
+export interface ExtendedFormProps extends Omit<FormProps, 'validator' | 'onSubmit'>, FormEventHandlers, FieldEventHandlers {
+    onSubmit?: (data: IChangeEvent & {
+        meta?: SubmissionMeta;
+    }, event: Parameters<NonNullable<FormProps['onSubmit']>>[1]) => void;
     schema: RJSFSchema;
     uiSchema?: UiSchema;
     webhooks?: WebhookConfig[];

package/dist/utils/debounce.d.ts

@@ -0,0 +1,5 @@
+/** Trailing-only debounce for dropdown search; cancel discards pending work. */
+export declare function debounce<Args extends unknown[]>(callback: (...args: Args) => void, wait: number): {
+    (...args: Args): void;
+    cancel: () => void;
+};

package/dist/utils/nullContractValidator.d.ts

@@ -0,0 +1,6 @@
+import { ValidatorType } from '@rjsf/utils';
+
+/** Treat null object properties as absent for AJV, without changing answers or array slots. */
+export declare function omitNullProperties(data: unknown): unknown;
+/** RJSF validator for EDF's null-answer contract, including native host-owned Forms. */
+export declare const nullContractValidator: ValidatorType;

package/dist/utils/submittedData.d.ts

@@ -0,0 +1,18 @@
+import { RJSFSchema, UiSchema } from '@rjsf/utils';
+import { SubmissionMeta } from '../types';
+import { UiEffect, Rule } from '../conditionals/v2/types';
+
+/** Hidden and disabled fields remain exempt from validation. */
+export declare function isOmittedField(uiSchema?: UiSchema): boolean;
+/** Use RJSF's resolved property metadata, including dependency and reference expansion. */
+export declare function propertyUi(schema: RJSFSchema, key: string, uiSchema?: UiSchema): UiSchema;
+/** Preserve valued answers; only inactive nulls are absent from submission. */
+export declare function omitInactiveNulls<T>(data: T, schema: RJSFSchema | boolean, uiSchema?: UiSchema, context?: unknown, rootSchema?: RJSFSchema, inheritedInactive?: boolean): T;
+/** Restrict flags, never answers, after host transformations or webhook selection. */
+export declare function restrictSubmissionMeta(meta: SubmissionMeta, data: unknown): SubmissionMeta;
+/** Read effective field state, retaining authored rule targets as visibility provenance. */
+export declare function submissionMeta(data: unknown, schema: RJSFSchema, uiSchema: UiSchema, rules?: Rule<UiEffect[]>[], context?: unknown): SubmissionMeta;
+/** ErrorSchema uses numeric object keys, not arrays; dynamic UI still receives real answers. */
+export declare function omitInactiveErrors<T>(errors: T, data: unknown, schema: RJSFSchema | boolean, uiSchema?: UiSchema, context?: unknown, rootSchema?: RJSFSchema): T;
+/** Exempt inactive constraints; schema predicates use the null contract's absent-property view. */
+export declare function activeValidationSchema(schema: RJSFSchema, data: unknown, uiSchema?: UiSchema, context?: unknown, rootSchema?: RJSFSchema): RJSFSchema;

package/dist/utils/transformErrors.d.ts

@@ -0,0 +1,4 @@
+import { ErrorTransformer } from '@rjsf/utils';
+
+/** Fold redundant conditional wrappers before the host customizes validation feedback. */
+export declare function createErrorTransformer(hostTransform?: ErrorTransformer): ErrorTransformer;

package/dist/widgets/base/utils.d.ts

@@ -120,7 +120,7 @@ export declare const getValue: (value: any, options: any, defaultValue?: any) =>
 /**
  * Handle change event and return the appropriate value
  */
-export declare const handleChangeValue: (value: any, options: any, defaultEmptyValue?: any) => any;
+export declare const handleChangeValue: (value: any, options: any, defaultEmptyValue?: unknown) => any;
 /**
  * Common props for Ant Design form components
  */

package/dist/widgets/index.d.ts

@@ -5,6 +5,7 @@ import { NumberWidget } from './input/NumberWidget';
 import { TelephoneWidget } from './input/TelephoneWidget';
 import { EmailWidget } from './input/EmailWidget';
 import { URLWidget } from './input/URLWidget';
+import { HiddenWidget } from './input/HiddenWidget';
 import { TextWidget } from './text/TextWidget';
 import { TextareaWidget } from './text/TextareaWidget';
 import { PasswordWidget } from './text/PasswordWidget';
@@ -29,6 +30,8 @@ export declare const customWidgets: {
     TextareaWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     password: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     PasswordWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
+    hidden: typeof HiddenWidget;
+    HiddenWidget: typeof HiddenWidget;
     UpDownWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     updown: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     number: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
@@ -70,4 +73,4 @@ export declare const customWidgets: {
     fileUpload: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     FileUploadWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
 };
-export { ChoiceWidget, ColorWidget, RangeWidget, RatingWidget, TextWidget, TextareaWidget, PasswordWidget, NumberWidget, TelephoneWidget, EmailWidget, URLWidget, DateWidget, EnhancedDateWidget, DateTimeWidget, FileWidget, FileUploadWidget, TitleWidget, HtmlWidget, SpacerWidget, DividerWidget, };
+export { ChoiceWidget, ColorWidget, RangeWidget, RatingWidget, TextWidget, TextareaWidget, PasswordWidget, HiddenWidget, NumberWidget, TelephoneWidget, EmailWidget, URLWidget, DateWidget, EnhancedDateWidget, DateTimeWidget, FileWidget, FileUploadWidget, TitleWidget, HtmlWidget, SpacerWidget, DividerWidget, };

package/dist/widgets/input/HiddenWidget.d.ts

@@ -0,0 +1,3 @@
+import { WidgetProps } from '@rjsf/utils';
+
+export declare function HiddenWidget(props: WidgetProps): import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "extended-dynamic-forms",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "Extended React JSON Schema Form (RJSF) v6 with custom components, widgets, templates, layouts, and form events",
   "main": "dist/index.umd.js",
   "module": "dist/index.es.js",
@@ -63,11 +63,11 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@rjsf/antd": "6.0.0-beta.17",
-    "@rjsf/core": "6.0.0-beta.17",
-    "@rjsf/utils": "6.0.0-beta.17",
-    "@rjsf/validator-ajv8": "6.0.0-beta.17",
-    "@types/lodash": "^4.17.20",
+    "@ant-design/icons": "^6",
+    "@rjsf/antd": "6.11.0",
+    "@rjsf/core": "6.11.0",
+    "@rjsf/utils": "6.11.0",
+    "@rjsf/validator-ajv8": "6.11.0",
     "@types/node": "^24.0.1",
     "@types/react": "^18.2.43",
     "@types/react-dom": "^18.2.17",