@formitiva/react 0.9.0

package/dist/themes/shadcn.css

@@ -0,0 +1,40 @@
+[data-formitiva-theme="shadcn"] {
+  /* Surfaces */
+  --formitiva-primary-bg: #ffffff;
+  --formitiva-secondary-bg: #ffffff;
+  --formitiva-input-bg: #f5f6f8;
+
+  /* Text */
+  --formitiva-text-color: #242424;
+  --formitiva-text-muted: #616161;
+
+  /* Borders */
+  --formitiva-border-color: #d1d1d6;
+  --formitiva-border-hover: #bdbdbd;
+  --formitiva-border-focus: #0078d4;
+
+  /* Accent */
+  --formitiva-success-color: #107c10;
+  --formitiva-error-color: #d13438;
+
+  /* Interaction */
+  --formitiva-option-menu-hover-bg: #000000;
+
+  /* Shape */
+  --formitiva-border-radius: 6px;
+
+  /* Shadow */
+  --formitiva-shadow:
+    0 4px 12px #000000;
+
+  /* Buttons */
+  --formitiva-button-bg: #0078d4;
+  --formitiva-button-text: white;
+  --formitiva-button-border-radius: 6px;
+
+  --formitiva-input-padding: 10px 12px;
+
+  /* Tooltip */
+  --formitiva-tooltip-color-bg: #3c3c3c;
+  --formitiva-tooltip-color: #ffffff;
+}

package/dist/themes/soft-pastel.css

@@ -0,0 +1,24 @@
+[data-formitiva-theme="pastel"] {
+  --formitiva-primary-bg: #fafafa;
+  --formitiva-secondary-bg: #ffffff;
+  --formitiva-input-bg: #ffffff;
+
+  --formitiva-text-color: #374151;
+  --formitiva-text-muted: #6b7280;
+
+  --formitiva-border-color: #e5e7eb;
+  --formitiva-border-hover: #cbd5e1;
+  --formitiva-border-focus: #a78bfa;
+
+  --formitiva-error-color: #fb7185;
+  --formitiva-success-color: #4ade80;
+
+  --formitiva-option-menu-hover-bg: #f4f4ff;
+
+  --formitiva-border-radius: 10px;
+  --formitiva-shadow: 0 10px 28px #636cf1;
+
+  /* Tooltip */
+  --formitiva-tooltip-color-bg: #3c3c3c;
+  --formitiva-tooltip-color: #ffffff;
+}

package/dist/themes/spacious-variant.css

@@ -0,0 +1,9 @@
+[data-formitiva-size="spacious"] {
+  --formitiva-input-padding: 14px 16px;
+  --formitiva-font-size: 15px;
+  --formitiva-space: 14px;
+  --formitiva-space-lg: 18px;
+  --formitiva-field-gap: 18px;
+  --formitiva-column-gap: 14px;
+  --formitiva-border-radius: 10px;
+}

package/dist/themes/tailwind-dark.css

@@ -0,0 +1,30 @@
+[data-formitiva-theme="tailwind-dark"] {
+  --formitiva-primary-bg: #0f172a; /* slate-900 */
+  --formitiva-secondary-bg: #020617; /* slate-950 */
+  --formitiva-input-bg: #020617;
+
+  --formitiva-text-color: #f9fafb;  /* slate-50 */
+  --formitiva-text-muted: #9ca3af;  /* gray-400 */
+  --formitiva-field-text-color: #e5e7eb;
+
+  --formitiva-border-color: #334155; /* slate-600 */
+  --formitiva-border-hover: #475569; /* slate-500 */
+  --formitiva-border-focus: #818cf8; /* indigo-400 */
+
+  --formitiva-error-color: #fb7185;  /* rose-400 */
+  --formitiva-success-color: #34d399; /* emerald-400 */
+
+  --formitiva-option-menu-hover-bg: #ffffff;
+
+  --formitiva-border-radius: 0.5rem;
+
+  --formitiva-shadow:
+      0 2px 8px #000000;
+
+  --formitiva-button-bg: #4f46e5; /* indigo-600 */
+  --formitiva-button-text: #ffffff;
+
+  /* Tooltip */
+  --formitiva-tooltip-color-bg: #282828;
+  --formitiva-tooltip-color: #F5F5F5;
+}

package/dist/themes/tailwind.css

@@ -0,0 +1,50 @@
+[data-formitiva-theme="tailwind"] {
+  /* Backgrounds */
+  --formitiva-primary-bg: #f9fafb; /* slate-50 */
+  --formitiva-secondary-bg: #ffffff; /* white */
+  --formitiva-input-bg: #ffffff;
+
+  /* Text */
+  --formitiva-text-color: #111827; /* gray-900 */
+  --formitiva-text-muted: #6b7280; /* gray-500 */
+  --formitiva-field-text-color: #1f2937; /* gray-800 */
+
+  /* Borders */
+  --formitiva-border-color: #d1d5db; /* gray-300 */
+  --formitiva-border-hover: #9ca3af; /* gray-400 */
+  --formitiva-border-focus: #6366f1; /* indigo-500 */
+
+  /* Status colors */
+  --formitiva-error-color: #f43f5e; /* rose-500 */
+  --formitiva-success-color: #10b981; /* emerald-500 */
+
+  /* Hover */
+  --formitiva-option-menu-hover-bg: #f3f4f6; /* gray-100 */
+
+  /* Radii */
+  --formitiva-border-radius: 0.5rem; /* rounded-lg */
+
+  /* Shadows (Tailwind style) */
+  --formitiva-shadow:
+      0 1px 2px #000000,
+      0 1px 3px #000000;
+
+  /* Typography */
+  --formitiva-font-size: 14px;
+  --formitiva-font-weight: 500;
+
+  /* Spacing (Tailwind scale) */
+  --formitiva-space: 0.5rem;     /* 2 = 8px */
+  --formitiva-space-lg: 0.75rem; /* 3 = 12px */
+
+  /* Buttons */
+  --formitiva-button-bg: #4f46e5; /* indigo-600 */
+  --formitiva-button-text: #ffffff;
+  --formitiva-button-border-radius: 0.5rem;
+  --formitiva-button-shadow:
+      0 2px 4px #4f46e5;
+
+  /* Tooltip */
+  --formitiva-tooltip-color-bg: #3c3c3c;
+  --formitiva-tooltip-color: #ffffff;
+}

package/dist/utils/definitionSerializers.d.ts

@@ -0,0 +1,62 @@
+import type { FormitivaDefinition, DefinitionPropertyField } from "../core/formitivaTypes";
+export declare function isDefinitionPropertyField(obj: unknown): obj is DefinitionPropertyField;
+export declare function isFormitivaDefinition(obj: unknown): obj is FormitivaDefinition;
+/**
+ * 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?: FormitivaDefinition | Record<string, unknown>, options?: SerializationOptions): SerializationResult;
+/**
+ * Enhanced instance deserialization with comprehensive validation and error handling
+ */
+export declare function deserializeInstance(serialized: string, definition?: FormitivaDefinition | Record<string, unknown>, options?: DeserializationOptions): DeserializationResult<Record<string, unknown>>;
+/**
+ * Enhanced definition serialization with validation and metadata
+ */
+export declare function serializeDefinition(definition: FormitivaDefinition | Record<string, unknown>, options?: SerializationOptions): SerializationResult;
+/**
+ * Enhanced definition deserialization with comprehensive validation
+ */
+export declare function deserializeDefinition(input: string | Record<string, unknown>, options?: DeserializationOptions): DeserializationResult<FormitivaDefinition>;

package/dist/utils/groupingHelpers.d.ts

@@ -0,0 +1,24 @@
+import type { DefinitionPropertyField } from "../core/formitivaTypes";
+/**
+ * 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/translationUtils.d.ts

@@ -0,0 +1,52 @@
+export type TranslationMap = Record<string, string>;
+export type TranslationCache = Map<string, TranslationMap>;
+export declare const supportedLanguages: Record<string, {
+    name: string;
+    nativeName: string;
+}>;
+export declare const getSupportedLanguages: () => Record<string, {
+    name: string;
+    nativeName: string;
+}>;
+/**
+ * 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/registerBuiltinTypeValidators.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Built-in validator registration
+ * @description Imports all validator modules for side-effect registration.
+ * Re-exports all validators to ensure bundlers don't tree-shake them.
+ */
+/**
+ * Ensures all built-in field validators are registered.
+ * This function references all validators to prevent tree-shaking.
+ * Safe to call multiple times as handlers are keyed.
+ */
+export declare function ensureBuiltinFieldTypeValidatorsRegistered(): void;

package/dist/validation/validation.d.ts

@@ -0,0 +1,12 @@
+import type { FormitivaDefinition, FieldValueType, DefinitionPropertyField, TranslationFunction } from "../core/formitivaTypes";
+export declare function validateFieldWithCustomHandler(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: FormitivaDefinition | 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/validators/validateColorField.d.ts

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

package/dist/validation/validators/validateDateField.d.ts

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

package/dist/validation/validators/validateEmailField.d.ts

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

package/dist/validation/validators/validateFieldPattern.d.ts

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

package/dist/validation/validators/validateFileField.d.ts

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

package/dist/validation/validators/validateFloatField.d.ts

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

package/dist/validation/validators/validateIntegerField.d.ts

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

package/dist/validation/validators/validatePhoneField.d.ts

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

package/dist/validation/validators/validateRatingField.d.ts

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

package/dist/validation/validators/validateSelectionFields.d.ts

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

package/dist/validation/validators/validateSliderField.d.ts

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

package/dist/validation/validators/validateTextField.d.ts

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

package/dist/validation/validators/validateTimeField.d.ts

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

package/dist/validation/validators/validateUnitValueField.d.ts

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

package/dist/validation/validators/validateUrlField.d.ts

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

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@formitiva/react",
+  "version": "0.9.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "A powerful, type-safe React form builder library with dynamic field rendering, conditional visibility, multi-language support, and extensible validation",
+  "keywords": [
+    "react",
+    "form",
+    "form-builder",
+    "typescript",
+    "validation",
+    "dynamic-forms",
+    "formitiva",
+    "react-form",
+    "form-library"
+  ],
+  "author": "Formitiva",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/formitiva/react.git",
+    "directory": "packages/formitiva"
+  },
+  "homepage": "https://github.com/formitiva/react#readme",
+  "bugs": {
+    "url": "https://github.com/formitiva/react/issues"
+  },
+  "main": "dist/formitiva.cjs.js",
+  "module": "dist/formitiva.es.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/formitiva.es.js",
+      "require": "./dist/formitiva.cjs.js"
+    },
+    "./style.css": "./dist/formitiva.css",
+    "./themes/*.css": "./dist/themes/*.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.full.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": "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"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^20.8.4",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@typescript-eslint/eslint-plugin": "^8.49.0",
+    "@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",
+    "globals": "^16.5.0",
+    "jsdom": "^27.3.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.7",
+    "vitest": "^4.0.15"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}