reactaform 1.0.0

package/dist/templates/conditionalAddress.d.ts

@@ -0,0 +1,3 @@
+import type { ReactaDefinition } from "../core/reactaFormTypes";
+declare const conditionalAddress: ReactaDefinition;
+export default conditionalAddress;

package/dist/templates/contactForm.d.ts

@@ -0,0 +1,3 @@
+import type { ReactaDefinition } from "../core/reactaFormTypes";
+declare const contactForm: ReactaDefinition;
+export default contactForm;

package/dist/templates/optionsAndParents.d.ts

@@ -0,0 +1,3 @@
+import type { ReactaDefinition } from "../core/reactaFormTypes";
+declare const optionsAndParents: ReactaDefinition;
+export default optionsAndParents;

package/dist/templates/surveyForm.d.ts

@@ -0,0 +1,3 @@
+import type { ReactaDefinition } from "../core/reactaFormTypes";
+declare const surveyForm: ReactaDefinition;
+export default surveyForm;

package/dist/utils/cssClasses.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CSS class constants and helpers
+ */
+export declare const CSS_CLASSES: {
+    readonly field: "reactaform-field";
+    readonly label: "reactaform-label";
+    readonly input: "reactaform-input";
+    readonly textInput: "reactaform-input--text";
+    readonly inputNumber: "reactaform-input--number";
+    readonly inputSelect: "reactaform-select";
+    readonly rangeInput: "reactaform-input--range";
+    readonly button: "reactaform-button";
+};
+export declare const combineClasses: (...classes: (string | undefined | null | false | Record<string, boolean>)[]) => string;

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/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,8 @@
+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;
+}>>;

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "reactaform",
+  "version": "1.0.0",
+  "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",
+    "i18n",
+    "react-form",
+    "form-library",
+    "conditional-fields"
+  ],
+  "author": "yanggmtl",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yanggmtl/reactaform.git",
+    "directory": "packages/reactaform"
+  },
+  "homepage": "https://github.com/yanggmtl/reactaform#readme",
+  "bugs": {
+    "url": "https://github.com/yanggmtl/reactaform/issues"
+  },
+  "main": "dist/reactaform.cjs.js",
+  "module": "dist/reactaform.es.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/reactaform.es.js",
+      "require": "./dist/reactaform.cjs.js"
+    },
+    "./style.css": "./dist/reactaform.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "scripts": {
+    "build:lib": "vite build --config vite.lib.config.ts && tsc -p tsconfig.build.json",
+    "pack:staging": "node ./scripts/pack-staging.cjs",
+    "test": "vitest run --config ./vitest.config.ts",
+    "typecheck": "tsc -p tsconfig.app.json --noEmit"
+  }
+}