extended-dynamic-forms 0.4.1 → 0.5.0

package/README.md

@@ -18,8 +18,10 @@ npm install 'react@^18.0.0' 'react-dom@^18.0.0' 'antd@^5.24.0' 'dayjs@^1.11.13'
 ```
 
 React and React DOM 19 are also supported by the peer ranges. Keep their major
-versions aligned. RJSF and the AJV validator are included in the library bundle;
-you do not need a sibling RJSF checkout.
+versions aligned. EDF 0.5.0 bundles RJSF 6.11.0 and the AJV validator;
+you do not need a sibling RJSF checkout. Before upgrading, read the
+[0.5.0 migration guide](docs/migration-0.5.md), including the breaking host-template,
+cleared-value and one-step Wizard contracts.
 
 Use ESM imports and include the exported stylesheet. TypeScript declarations are
 provided; use an ESNext/Bundler-compatible module configuration.
@@ -118,9 +120,12 @@ export default function RegistrationForm() {
 }
 ```
 
-Conditions use flat answer paths without the `STEP_` prefix. Initial answers may
+Conditions use flat answer paths without the `STEP_` prefix. One-step forms take
+flat initial answers only. With two or more configured steps, initial answers may
 be flat or nested under step keys; explicit nested snapshots take precedence.
-Use distinct answer keys across steps when working with flat data.
+Use distinct answer keys across steps when working with flat data. See the
+[0.5.0 migration guide](docs/migration-0.5.md#d13-one-step-wizards-use-the-shared-step-runtime)
+for the one-step payload contract and the configured-step boundary.
 
 Step visibility rules use `x-edf:stepRules`. Hidden steps are skipped in navigation
 and excluded from structured submissions unless `includeHiddenStepsInSubmit` is
@@ -304,6 +309,27 @@ Custom widgets can import `useFieldEventHandlers` from the root package alongsid
 other event exports. Call the RJSF `onChange` to update the answer and the field
 event handler to participate in EDF events.
 
+### RJSF 6.11 native integration in 0.5.0
+
+For native hosts that register EDF's `TelephoneWidget` on their own RJSF 6.11
+`Form`, wrap that Form in the exported `RJSF611ErrorStateAdapter`, inside
+`FormEventProvider`. It preserves the native ref and real change notifications
+while clearing only widget-owned stale feedback. `ExtendedForm` and Wizard steps
+install this boundary internally. Earlier beta-based consumers remain unchanged
+until they explicitly adopt 0.5.0.
+See [Telephone integration](docs/custom-widgets-configuration.md#rjsf-611-native-error-state-compatibility-050)
+for the native example and the version-specific boundary.
+
+Unwrapped native 6.11 hosts retain upstream stale Telephone feedback; migrate to
+the wrapper before adoption. Non-live forms do not acquire schema-only errors
+from the adapter before Submit. Existing post-submit feedback can still clear
+when corrected.
+
+`ExtendedForm` defaults `experimental_defaultFormStateBehavior.requiredBooleanDefault`
+to `'skip'`: an unanswered required boolean stays absent. An explicit host value
+(for example `'populateFalse'`) overrides that default. Authored boolean defaults
+are preserved.
+
 ## Known limitations
 
 - CommonJS `require` is unsupported; use ESM imports. NodeNext declaration

package/dist/components/RJSF611ErrorStateAdapter.d.ts

@@ -0,0 +1,20 @@
+import { default as React } from 'react';
+import { FormProps } from '@rjsf/core';
+
+type ErrorOwner = {
+    setError: (id: string, message: string) => void;
+    remove: (id: string) => void;
+};
+export declare const useRJSF611WidgetErrorOwner: () => ErrorOwner | undefined;
+export interface RJSF611ErrorStateAdapterProps {
+    children: React.ReactElement<FormProps>;
+    /** Same constraints as the child's customValidate, without lifecycle notifications. */
+    customValidate?: FormProps['customValidate'];
+}
+/**
+ * RJSF 6.11 compatibility boundary for EDF widget-owned errors in native Forms.
+ * Keeps its error list/tree consistent without changing RJSF or liveValidate.
+ * Reproduction: T6/out/evidence/upstream-only-error-reset.{tsx,log}.
+ */
+export declare function RJSF611ErrorStateAdapter({ children, customValidate }: RJSF611ErrorStateAdapterProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/arrays/ArrayFieldItemTemplate.d.ts

@@ -1,3 +1,3 @@
-import { ArrayFieldItemTemplateType } from '@rjsf/utils';
+import { ArrayFieldItemTemplateProps } from '@rjsf/utils';
 
-export declare const ArrayFieldItemTemplate: (props: ArrayFieldItemTemplateType) => import("react/jsx-runtime").JSX.Element;
+export declare const ArrayFieldItemTemplate: (props: ArrayFieldItemTemplateProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/fields/TextChangeScope.d.ts

@@ -3,9 +3,8 @@ import { FieldProps } from '@rjsf/utils';
 type Path = (string | number)[];
 export type TextChangeScope = {
     parent?: TextChangeScope;
-    key: string | number;
+    path: Path;
     name: string;
-    index?: number;
     live: boolean;
     widgets: Set<object>;
     children: Set<TextChangeScope>;
@@ -17,12 +16,12 @@ export declare const TextChangeContext: import('react').Context<{
     scope: TextChangeScope;
     onChange: FieldProps["onChange"];
 } | undefined>;
-/** Public callbacks, not DOM ids or answer equality, identify same-field delegation. */
+/** Public paths and callbacks, not DOM ids or answer equality, identify same-field delegation. */
 export declare function useTextChangeScope(props: FieldProps, item?: boolean): TextChangeScope;
 /** Presence belongs to this committed field scope, never a form-wide widget-id set. */
 export declare function useTextChangeRegistration(name: string, emptyValue: unknown): void;
 /** The actual originating leaf must match the complete public path to this boundary. */
 export declare function textChangeTargets(origin: TextChangeScope | undefined, boundary: TextChangeScope, path: Path): boolean;
 /** Preserve origin only during matching synchronous public callback forwarding. */
-export declare function useTextChangeCallback(onChange: FieldProps['onChange'], scope: TextChangeScope, calls: TextChangeCalls): (newValue: any, path?: (number | string)[], es?: import('@rjsf/utils').ErrorSchema<any> | undefined, id?: string) => void;
+export declare function useTextChangeCallback(onChange: FieldProps['onChange'], scope: TextChangeScope, calls: TextChangeCalls): (newValue: any, path: import('@rjsf/utils').FieldPathList, es?: import('@rjsf/utils').ErrorSchema<any> | undefined, id?: string) => void;
 export {};

package/dist/components/index.d.ts

@@ -19,11 +19,11 @@ export declare const customTemplates: {
     FieldTemplate: React.FC<import('@rjsf/utils').FieldTemplateProps>;
     ObjectFieldTemplate: React.FC<import('@rjsf/utils').ObjectFieldTemplateProps>;
     ArrayFieldTemplate: (props: import('@rjsf/utils').ArrayFieldTemplateProps) => import("react/jsx-runtime").JSX.Element;
-    ArrayFieldItemTemplate: (props: import('@rjsf/utils').ArrayFieldItemTemplateType) => import("react/jsx-runtime").JSX.Element;
+    ArrayFieldItemTemplate: (props: import('@rjsf/utils').ArrayFieldItemTemplateProps) => import("react/jsx-runtime").JSX.Element;
     WizardObjectFieldTemplate: React.FC<import('@rjsf/utils').ObjectFieldTemplateProps>;
     WizardSectionTemplate: React.FC<import('../layouts/wizard/WizardSectionTemplate').WizardSectionTemplateProps>;
     ButtonTemplates: {
-        SubmitButton: React.FC<import('@rjsf/utils').SubmitButtonProps>;
+        SubmitButton: React.FC<import('@rjsf/utils').SubmitButtonProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     };
 };
 export { AddressField, PhoneField, CurrencyField, LayoutGridField, FieldTemplate, ArrayFieldTemplate, ArrayFieldItemTemplate, WizardObjectFieldTemplate, WizardSectionTemplate, SubmitButton, };

package/dist/index.d.ts

@@ -13,3 +13,5 @@ export { default as validator } from '@rjsf/validator-ajv8';
 export { ExtendedForm } from './ExtendedForm';
 export { WizardForm } from './WizardForm';
 export type { WizardFormProps, WizardStep } from './WizardForm';
+export { RJSF611ErrorStateAdapter } from './components/RJSF611ErrorStateAdapter';
+export type { RJSF611ErrorStateAdapterProps } from './components/RJSF611ErrorStateAdapter';