extended-dynamic-forms 0.3.13 → 0.4.0

package/dist/widgets/date/DateTimeWidget.d.ts

@@ -1,26 +1,7 @@
 import { FC } from 'react';
 import { WidgetProps } from '@rjsf/utils';
 
-/**
- * DateTime Widget for date and time selection
- *
- * Can be configured to use either:
- * 1. Ant Design DatePicker with showTime option (default)
- * 2. Native HTML datetime-local input (when useNativeInput is true)
- *
- * Supports Ant Design DatePicker API properties through uiSchema options:
- * - useNativeInput: Use HTML datetime-local input instead of DatePicker
- * - format: DateTime format (default: 'YYYY-MM-DD HH:mm:ss')
- * - showTime: Time picker options (true or object with time picker config)
- * - placeholder: Input placeholder text
- * - placement: Dropdown placement
- * - size: Component size ('small', 'middle', 'large')
- * - bordered: Show border
- * - status: Validation status ('error', 'warning')
- * - style: Custom CSS styles
- * - className: Custom CSS class
- * - And all other Ant Design DatePicker props
- */
-declare const DateTimeWidget: FC<WidgetProps>;
+/** Browser-local wall-clock entry/display; accepted answers are UTC instants. */
+declare const DateTimeWidget: FC<WidgetProps<unknown>>;
 export default DateTimeWidget;
 export { DateTimeWidget };

package/dist/widgets/date/calendarConstraints.d.ts

@@ -0,0 +1,5 @@
+import { DatePickerProps } from 'antd';
+import { AntDatePickerOptions } from '../base/types';
+
+/** Calendar-label constraints for UTC-mode picker carriers. Shared by selection and validation. */
+export declare function getCalendarDatePickerProps(options?: AntDatePickerOptions): Partial<DatePickerProps>;

package/dist/widgets/date/dateRangeValue.d.ts

@@ -0,0 +1,20 @@
+import { Dayjs } from 'dayjs';
+import { RJSFSchema, UiSchema } from '@rjsf/utils';
+import { SchemaSelections } from '../../components/SchemaSelectionContext';
+
+type RangeOptions = {
+    [key: string]: unknown;
+    range?: unknown;
+    showTime?: unknown;
+    withTime?: unknown;
+    allowEmpty?: unknown;
+};
+/** Explicit time ranges retain their separate, existing formatted-value contract. */
+export declare function isCalendarRange(options: RangeOptions): boolean;
+/** UTC mode is a calendar container only: never convert these values to/from local instants. */
+export declare function parseCalendarDate(value: unknown): Dayjs | undefined;
+export declare function parseCalendarInput(text: string, format: unknown): Dayjs | undefined;
+export declare function calendarRangeError(value: unknown, options: RangeOptions, required: boolean): string | undefined;
+/** Validate restored and edited calendar ranges even in native schemas without date item formats. */
+export declare function validateDateRangeValues(data: unknown, errors: unknown, schema: RJSFSchema | boolean, uiSchema?: UiSchema, rootSchema?: RJSFSchema, selections?: SchemaSelections, id?: string, idSeparator?: string, required?: boolean): void;
+export {};

package/dist/widgets/date/dateTimeValue.d.ts

@@ -0,0 +1,15 @@
+import { Dayjs } from 'dayjs';
+import { RJSFSchema, UiSchema } from '@rjsf/utils';
+import { SchemaSelections } from '../../components/SchemaSelectionContext';
+
+export declare const DATE_TIME_REENTRY = "Re-enter a valid date and time with a time zone; saved local text is not an instant.";
+export declare const DATE_TIME_CONSTRAINT = "Select a date allowed by the date and time constraints.";
+export declare const LOCAL_DATE_TIME_FORMAT = "YYYY-MM-DDTHH:mm:ss.SSS";
+/** Read an explicit RFC3339 instant, never infer a zone for saved wall-clock text. */
+export declare function parseDateTimeInstant(value: unknown): Dayjs | undefined;
+/** UTC-mode Dayjs is only a calendar container here: it must never be serialized as an instant. */
+export declare function parseLocalDateTime(text: string, formats: unknown): Dayjs | undefined;
+/** Enumerate real instants whose browser-local calendar tuple equals the requested wall clock. */
+export declare function localDateTimeInstants(wall: Dayjs): string[];
+/** Scope the UTC contract to DateTime widgets, including RJSF's format-selected default. */
+export declare function validateDateTimeValues(data: unknown, errors: unknown, schema: RJSFSchema | boolean, uiSchema?: UiSchema, rootSchema?: RJSFSchema, selections?: SchemaSelections, id?: string, idSeparator?: string): void;

package/dist/widgets/file/FileUploadWidget.d.ts

@@ -2,38 +2,9 @@ import { FC } from 'react';
 import { WidgetProps } from '@rjsf/utils';
 
 /**
- * File Upload Widget with support for both native input and Ant Design Upload
- *
- * @description
- * This widget provides two modes for file upload:
- * 1. Native HTML input[type="file"] (default)
- * 2. Ant Design Upload component (when ui:options.useAntUpload is true)
- *
- * Both modes convert files to base64 data URLs for storage in form data.
- *
- * @example
- * // In uiSchema for native input
- * {
- *   myFileField: {
- *     'ui:widget': 'fileUpload',
- *     'ui:options': {
- *       accept: 'image/*'
- *     }
- *   }
- * }
- *
- * @example
- * // In uiSchema for Ant Design Upload
- * {
- *   myFileField: {
- *     'ui:widget': 'fileUpload',
- *     'ui:options': {
- *       useAntUpload: true,
- *       accept: '.pdf,.doc,.docx',
- *       maxSize: 5 // in MB
- *     }
- *   }
- * }
+ * Local file reader, not a network upload. Single mode preserves the published
+ * data-URL/undefined contract; explicit multiple mode emits data-URL arrays.
+ * Enhanced list/drag/button settings require useAntUpload: true.
  */
 declare const FileUploadWidget: FC<WidgetProps>;
 export default FileUploadWidget;

package/dist/widgets/index.d.ts

@@ -33,10 +33,10 @@ export declare const customWidgets: {
     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>>;
     NumberWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
-    tel: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
-    telephone: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
-    TelWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
-    TelephoneWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
+    tel: import('react').FC<import('@rjsf/utils').WidgetProps<unknown, import('@rjsf/utils').RJSFSchema, any>>;
+    telephone: import('react').FC<import('@rjsf/utils').WidgetProps<unknown, import('@rjsf/utils').RJSFSchema, any>>;
+    TelWidget: import('react').FC<import('@rjsf/utils').WidgetProps<unknown, import('@rjsf/utils').RJSFSchema, any>>;
+    TelephoneWidget: import('react').FC<import('@rjsf/utils').WidgetProps<unknown, import('@rjsf/utils').RJSFSchema, any>>;
     email: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     EmailWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     url: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
@@ -61,8 +61,8 @@ export declare const customWidgets: {
     DividerWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     date: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     DateWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
-    'datetime-local': import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
-    DateTimeWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
+    'datetime-local': import('react').FC<import('@rjsf/utils').WidgetProps<unknown, import('@rjsf/utils').RJSFSchema, any>>;
+    DateTimeWidget: import('react').FC<import('@rjsf/utils').WidgetProps<unknown, import('@rjsf/utils').RJSFSchema, any>>;
     time: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     TimeWidget: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;
     file: import('react').FC<import('@rjsf/utils').WidgetProps<any, import('@rjsf/utils').RJSFSchema, any>>;

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

@@ -29,6 +29,6 @@ import { WidgetProps } from '@rjsf/utils';
  *   }
  * }
  */
-declare const TelephoneWidget: FC<WidgetProps>;
+declare const TelephoneWidget: FC<WidgetProps<unknown>>;
 export default TelephoneWidget;
 export { TelephoneWidget };

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

@@ -0,0 +1,7 @@
+import { RJSFSchema, UiSchema } from '@rjsf/utils';
+import { SchemaSelections } from '../../components/SchemaSelectionContext';
+
+/** Validate without changing saved values; required/type/schema constraints remain schema-owned. */
+export declare function emailValidationError(value: unknown, options: Record<string, unknown>): string | undefined;
+/** Enforce Email options for restored data, submission, and wizard navigation as well as input feedback. */
+export declare function validateEmailValues(data: unknown, errors: unknown, schema: RJSFSchema | boolean, uiSchema?: UiSchema, rootSchema?: RJSFSchema, selections?: SchemaSelections, id?: string, idSeparator?: string, formContext?: unknown): void;

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

@@ -0,0 +1,7 @@
+/** A mask changes presentation only. Letter slots never become phoneword digits. */
+export declare function telephoneMask(value: unknown): string;
+export declare function applyTelephoneMask(input: string, mask: string, code?: string, fromCanonical?: boolean): {
+    display: string;
+    canonical: string;
+    positions: number[];
+};

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

@@ -0,0 +1,14 @@
+import { RJSFSchema } from '@rjsf/utils';
+
+export interface PhoneCountry {
+    code: string;
+    name: string;
+    pattern?: unknown;
+}
+export declare function countryCode(value: unknown): string;
+export declare function phoneCountries(value: unknown): PhoneCountry[];
+export declare function numberCountry(value: string, countries: PhoneCountry[]): string;
+export declare function withCountryCode(value: string, code: string): string;
+export declare function internationalPhone(value: string): string;
+/** Mirror explicit string constraints for immediate feedback; RJSF remains the submit validator. */
+export declare function phoneError(value: unknown, schema: RJSFSchema, options: Record<string, unknown>, required?: boolean): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "extended-dynamic-forms",
-  "version": "0.3.13",
+  "version": "0.4.0",
   "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",
@@ -34,6 +34,7 @@
     "preview": "vite preview",
     "test": "vitest",
     "test:ui": "vitest --ui",
+    "test:browser": "npm run build && vitest run --config vitest.browser.config.ts",
     "lint": "eslint src --ext ts,tsx --report-unused-disable-directives --max-warnings 10",
     "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json,css,md}\"",
     "format:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx,json,css,md}\"",
@@ -74,6 +75,7 @@
     "@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",
     "@types/node": "^24.0.1",
     "@types/react": "^18.2.43",
     "@types/react-dom": "^18.2.17",
@@ -81,7 +83,7 @@
     "@typescript-eslint/parser": "^6.14.0",
     "@vitejs/plugin-react": "^4.2.1",
     "@vitest/coverage-v8": "^2.1.9",
-    "antd": "^5.26.0",
+    "antd": "5.26.0",
     "clsx": "^2.1.1",
     "dotenv": "^16.3.1",
     "eslint": "^8.55.0",
@@ -89,6 +91,7 @@
     "eslint-plugin-prettier": "^5.4.1",
     "eslint-plugin-react-hooks": "^4.6.0",
     "eslint-plugin-react-refresh": "^0.4.5",
+    "jsdom": "^24.1.1",
     "plop": "^4.0.1",
     "prettier": "^3.5.3",
     "react": "^18.2.0",
@@ -100,12 +103,15 @@
     "vitest": "^2.1.9"
   },
   "dependencies": {
+    "@rc-component/mini-decimal": "^1.0.1",
     "@types/json-logic-js": "^2.0.8",
     "date-fns": "^4.1.0",
+    "handlebars": "^4.7.8",
     "json-logic-js": "^2.0.5",
     "json-rules-engine-simplified": "^0.2.0",
+    "libphonenumber-js": "^1.13.15",
     "lucide-react": "^0.452.0",
-    "handlebars": "^4.7.8"
+    "markdown-to-jsx": "^7.7.13"
   },
   "type": "module"
 }