reactaform 1.4.4 → 1.8.0

package/dist/utils/definitionSerializers.d.ts

@@ -0,0 +1,62 @@
+import type { ReactaDefinition, DefinitionPropertyField } from "../core/reactaFormTypes";
+export declare function isDefinitionPropertyField(obj: unknown): obj is DefinitionPropertyField;
+export declare function isReactaDefinition(obj: unknown): obj is ReactaDefinition;
+/**
+ * Enhanced serialization options for better control over the process
+ */
+export interface SerializationOptions {
+    includeMetadata?: boolean;
+    dateFormat?: 'iso' | 'timestamp' | 'locale';
+    fileHandling?: 'metadata' | 'skip' | 'base64';
+    prettify?: boolean;
+    excludeFields?: string[];
+    includeOnlyFields?: string[];
+}
+/**
+ * Enhanced deserialization options
+ */
+export interface DeserializationOptions {
+    strict?: boolean;
+    validateTypes?: boolean;
+    preserveUnknownFields?: boolean;
+    dateFormat?: 'auto' | 'iso' | 'timestamp';
+}
+/**
+ * Serialization result with metadata
+ */
+export interface SerializationResult {
+    success: boolean;
+    data?: string;
+    error?: string;
+    metadata?: {
+        fieldCount: number;
+        excludedFields: string[];
+        warnings: string[];
+    };
+}
+/**
+ * Deserialization result with validation info
+ */
+export interface DeserializationResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    warnings?: string[];
+    validationErrors?: string[];
+}
+/**
+ * Enhanced instance serialization with comprehensive options and error handling
+ */
+export declare function serializeInstance(instance: Record<string, unknown>, definition?: ReactaDefinition | Record<string, unknown>, options?: SerializationOptions): SerializationResult;
+/**
+ * Enhanced instance deserialization with comprehensive validation and error handling
+ */
+export declare function deserializeInstance(serialized: string, definition?: ReactaDefinition | Record<string, unknown>, options?: DeserializationOptions): DeserializationResult<Record<string, unknown>>;
+/**
+ * Enhanced definition serialization with validation and metadata
+ */
+export declare function serializeDefinition(definition: ReactaDefinition | Record<string, unknown>, options?: SerializationOptions): SerializationResult;
+/**
+ * Enhanced definition deserialization with comprehensive validation
+ */
+export declare function deserializeDefinition(input: string | Record<string, unknown>, options?: DeserializationOptions): DeserializationResult<ReactaDefinition>;

package/dist/utils/groupingHelpers.d.ts

@@ -0,0 +1,24 @@
+import type { DefinitionPropertyField } from "../core/reactaFormTypes";
+/**
+ * Enhanced rename duplicated groups with better conflict resolution
+ * For example: g1, g1, g2, g1 becomes g1, g1, g2, g1(1)
+ * This mutates the provided nameToField map so downstream code sees the
+ * renamed group values.
+ */
+export declare const renameDuplicatedGroups: (properties: DefinitionPropertyField[], nameToField: Record<string, DefinitionPropertyField>) => number;
+/**
+ * Enhanced consecutive field grouping with metadata
+ */
+export declare const groupConsecutiveFields: (items: DefinitionPropertyField[], options?: {
+    includeEmpty?: boolean;
+}) => {
+    groups: Array<{
+        name: string | null;
+        fields: DefinitionPropertyField[];
+    }>;
+    metadata: {
+        totalGroups: number;
+        emptyGroups: number;
+        largestGroup: number;
+    };
+};

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ReactaForm Utils - Comprehensive utility functions
+ *
+ * This module provides enhanced utility functions for form building,
+ * styling, serialization, translation, and component management.
+ */
+export { combineClasses, CSS_CLASSES, } from './cssClasses';
+export { serializeInstance, deserializeInstance, serializeDefinition, deserializeDefinition, type SerializationOptions, type DeserializationOptions, type SerializationResult, type DeserializationResult } from './definitionSerializers';
+export { renameDuplicatedGroups, groupConsecutiveFields } from './groupingHelpers';
+export { loadCommonTranslation, loadUserTranslation, createTranslationFunction, } from './translationCache';
+export * from './unitValueMapper';

package/dist/utils/themeUtils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Utility functions for theme detection and management
+ */
+/**
+ * Determines if a theme is dark-themed based on naming convention.
+ *
+ * Convention: Theme names containing "dark" are considered dark themes.
+ *
+ * When creating custom themes:
+ * - Include "dark" in the theme name for dark themes (e.g., "my-theme-dark")
+ * - Or rely on CSS variables only and avoid theme-specific logic
+ *
+ * @param themeName - The theme name from the `theme` prop
+ * @returns true if the theme is dark-themed
+ *
+ * @example
+ * isDarkTheme('material-dark') // true
+ * isDarkTheme('dark') // true
+ * isDarkTheme('midnight-dark') // true
+ * isDarkTheme('my-custom-dark') // true
+ * isDarkTheme('material') // false
+ */
+export declare function isDarkTheme(themeName: string): boolean;
+/**
+ * Determines if a color string represents a dark color.
+ * Supports hex (3, 4, 6, 8 digits) and rgb/rgba formats.
+ *
+ * @param color - The color string to check
+ * @returns true if the color is considered dark (luminance < 128)
+ */
+export declare function isDarkColor(color: string): boolean;

package/dist/utils/translationCache.d.ts

@@ -0,0 +1,43 @@
+import type { TranslationMap, TranslationCache } from "../core/reactaFormTypes";
+/**
+ * Translation loading result
+ */
+export interface TranslationLoadResult {
+    success: boolean;
+    translations: TranslationMap;
+    error?: string;
+    fromCache?: boolean;
+}
+export declare const userTranslationCache: TranslationCache;
+export declare const userFailedSet: Set<string>;
+/**
+ * Enhanced common translation loader with better error handling
+ */
+export declare const loadCommon: (language: string) => Promise<TranslationLoadResult>;
+/**
+ * Enhanced common translation loading with caching and metadata
+ */
+export declare const loadCommonTranslation: (language: string) => Promise<TranslationLoadResult>;
+/**
+ * Enhanced user translation loading with better error handling and caching
+ */
+export declare const loadUserTranslation: (language: string, localizeName: string) => Promise<TranslationLoadResult>;
+/**
+ * Return whether translation subsystem should run in debug mode.
+ * Checks multiple env sources (Vite, webpack, Next.js, etc.) for dev/debug mode.
+ */
+export declare function isDebugMode(): boolean;
+/**
+ * Create a translation function using provided maps
+ * @returns A translation function
+ * This function processes text using only dictionary lookups and basic string interpolation.
+ * Note: handling pluralization is not supported now
+ * @example
+ * const t = createTranslationFunction('fr', commonMap, userMap);
+ * const translated = t("Hello, {{1}}!", "world");
+ */
+export declare const createTranslationFunction: (language: string, commonMap: TranslationMap, userMap: TranslationMap) => (defaultText: string, ...args: unknown[]) => string;
+/**
+ * Clear all caches
+ */
+export declare function clearTranslationCaches(): void;

package/dist/utils/unitValueMapper.d.ts

@@ -0,0 +1,14 @@
+export declare const dimensionUnitsMap: Record<string, string[]>;
+export declare const dimensionUnitDisplayMap: Record<string, Record<string, string>>;
+export declare const dimensonUnitFactorsMap: Record<string, Record<string, number>>;
+export declare const unitsByDimension: Record<string, Record<string, {
+    name: string;
+    shortName: string;
+    factor?: number;
+}>>;
+export declare function convertTemperature(fromUnit: string, toUnit: string, value: number): number;
+export declare function getUnitFactors(dimension: string): {
+    default: string;
+    units: string[];
+    factors: Record<string, number>;
+} | null;

package/dist/validation/index.d.ts

@@ -0,0 +1,13 @@
+import './validateIntegerField';
+import './validateFloatField';
+import './validateTextField';
+import './validateEmailField';
+import './validateDateField';
+import './validateTimeField';
+import './validateUnitValueField';
+import './validateRatingField';
+import './validateUrlField';
+import './validatePhoneField';
+import './validateSelectionFields';
+import './validateColorField';
+export {};

package/dist/validation/validateColorField.d.ts

@@ -0,0 +1,2 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateColorField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateDateField.d.ts

@@ -0,0 +1,2 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateDateField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateEmailField.d.ts

@@ -0,0 +1,2 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateEmailField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateFieldPattern.d.ts

@@ -0,0 +1,3 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateFieldPattern(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction, fallbackMessage?: string, ...args: unknown[]): string | null;
+export default validateFieldPattern;

package/dist/validation/validateFloatField.d.ts

@@ -0,0 +1,3 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateFloatField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;
+export declare function validateFloatArrayField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateIntegerField.d.ts

@@ -0,0 +1,3 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare const validateIntegerField: (field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction) => string | null;
+export declare function validateIntegerArrayField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validatePhoneField.d.ts

@@ -0,0 +1,2 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validatePhoneField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateRatingField.d.ts

@@ -0,0 +1,2 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateRatingField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateSelectionFields.d.ts

@@ -0,0 +1,3 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateDropdownField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;
+export declare function validateMultiSelectionField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateTextField.d.ts

@@ -0,0 +1,2 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateTextField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateTimeField.d.ts

@@ -0,0 +1,2 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateTimeField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateUnitValueField.d.ts

@@ -0,0 +1,2 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateUnitValueField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validateUrlField.d.ts

@@ -0,0 +1,2 @@
+import { DefinitionPropertyField, FieldValueType, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateUrlField(field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;

package/dist/validation/validation.d.ts

@@ -0,0 +1,12 @@
+import type { ReactaDefinition, FieldValueType, DefinitionPropertyField, TranslationFunction } from "../core/reactaFormTypes";
+export declare function validateFieldWithHandler(definitionName: string, field: DefinitionPropertyField, value: FieldValueType, t: TranslationFunction): string | null;
+export declare function validateFieldValue(definitionName: string, field: DefinitionPropertyField, value: FieldValueType | unknown, t: TranslationFunction): string | null;
+export declare function validateField(definitionName: string, field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction): string | null;
+export declare function validateFormValues(definition: ReactaDefinition | null, valuesMap: Record<string, FieldValueType | unknown>, t: (key: string) => string): Promise<string[] | null>;
+export declare function clearValidationCache(): void;
+declare const _default: {
+    validateFieldValue: typeof validateFieldValue;
+    validateFormValues: typeof validateFormValues;
+    clearValidationCache: typeof clearValidationCache;
+};
+export default _default;

package/dist/validation/validationHandlerRegistry.d.ts

@@ -0,0 +1,19 @@
+import type { DefinitionPropertyField, FieldValidationHandler, FieldValueType, FormValidationHandler, TranslationFunction } from "../core/reactaFormTypes";
+export type BuiltinFieldValidationHandler = (field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction) => string | null;
+export declare function registerFormValidationHandler(name: string, fn: FormValidationHandler): void;
+export declare function registerFieldValidationHandler(category: string, name: string, fn: FieldValidationHandler): void;
+export declare function registerBuiltinFieldValidationHandler(name: string, fn: BuiltinFieldValidationHandler): void;
+export declare function getFieldValidationHandler(category: string, name: string): FieldValidationHandler | null;
+export declare function getFormValidationHandler(name: string): FormValidationHandler | null;
+export declare function getBuiltinFieldValidationHandler(name: string): BuiltinFieldValidationHandler | null;
+export declare function listFieldValidationHandlers(category?: string): string[];
+export declare function listFormValidationHandlers(): string[];
+declare const _default: {
+    registerFormValidationHandler: typeof registerFormValidationHandler;
+    registerFieldValidationHandler: typeof registerFieldValidationHandler;
+    getFieldValidationHandler: typeof getFieldValidationHandler;
+    getFormValidationHandler: typeof getFormValidationHandler;
+    listFieldValidationHandlers: typeof listFieldValidationHandlers;
+    listFormValidationHandlers: typeof listFormValidationHandlers;
+};
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reactaform",
-  "version": "1.4.4",
+  "version": "1.8.0",
   "description": "A powerful, type-safe React form builder library with dynamic field rendering, conditional visibility, multi-language support, and extensible validation",
   "keywords": [
     "react",
@@ -34,27 +34,29 @@
       "import": "./dist/reactaform.es.js",
       "require": "./dist/reactaform.cjs.js"
     },
-    "./style.css": "./dist/reactaform.css"
+    "./style.css": "./dist/reactaform.css",
+    "./themes/*.css": "./dist/themes/*.css"
   },
   "files": [
-    "dist/*.js",
-    "dist/*.mjs",
-    "dist/*.cjs.js",
-    "dist/*.es.js",
-    "dist/*.css",
-    "dist/*.map",
-    "dist/*.d.ts",
+    "dist",
     "README.md",
     "LICENSE"
   ],
+  "sideEffects": [
+    "*.css",
+    "dist/**/*.css"
+  ],
   "peerDependencies": {
     "react": ">=18.0.0 <20",
     "react-dom": ">=18.0.0 <20"
   },
   "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist', {recursive: true, force: true})\"",
     "build:types": "tsc -p tsconfig.build.json --noEmit false",
-    "build:lib": "vite build --config vite.lib.config.ts && npm run build:types",
-    "build:pack": "npm run build:lib && npm pack",
+    "build:lib": "cross-env NODE_ENV=development vite build --mode development --config vite.lib.config.ts && npm run build:types && node scripts/copy-themes.js",
+    "build:prod": "cross-env NODE_ENV=production vite build --config vite.lib.config.ts && npm run build:types && node scripts/copy-themes.js",
+    "build:pack": "npm run build:prod && npm pack",
+    "prepublishOnly": "npm run build:prod",
     "test": "vitest run --config ./vitest.config.ts",
     "typecheck": "tsc -p tsconfig.build.json --noEmit",
     "lint": "eslint -c eslint.config.mjs \"src/**/*.{ts,tsx}\" \"tests/**/*.{ts,tsx}\" --max-warnings=0"
@@ -71,6 +73,7 @@
     "@typescript-eslint/parser": "^8.49.0",
     "@vitejs/plugin-react": "^5.1.2",
     "c8": "^10.1.3",
+    "cross-env": "^7.0.3",
     "eslint": "^9.39.1",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",
@@ -79,8 +82,7 @@
     "typescript": "^5.9.3",
     "vite": "^7.2.7",
     "vitest": "^4.0.15"
-  }
-  ,
+  },
   "optionalDependencies": {},
   "engines": {
     "node": ">=18"