rhf-dynamic-forms 1.1.0 → 1.2.0

package/README.md

@@ -50,17 +50,17 @@ Dynamic Forms enables rapid deployment of data collection forms by defining form
 ## Installation
 
 ```bash
-npm install dynamic-forms
+npm install rhf-dynamic-forms
 # or
-pnpm add dynamic-forms
+pnpm add rhf-dynamic-forms
 # or
-yarn add dynamic-forms
+yarn add rhf-dynamic-forms
 ```
 
 **Peer Dependencies:**
 
 ```bash
-npm install react react-dom
+npm install react@^19 react-dom@^19
 ```
 
 ## Quick Start
@@ -407,9 +407,6 @@ interface DynamicFormProps {
   fieldComponents: FieldComponentRegistry;      // Component implementations
   onSubmit: (data: FormData) => void;          // Submit handler
 
-  // Optional - Validation (priority order: resolver > schema > config-driven)
-  resolver?: Resolver<FormData>;                // Custom react-hook-form resolver (Yup, Joi, etc.)
-  schema?: ZodSchema;                           // External Zod schema (wrapped with visibility-aware resolver)
 
   // Optional - Components
   initialData?: FormData;                       // Pre-fill form values
@@ -432,6 +429,7 @@ interface DynamicFormProps {
   style?: CSSProperties;
   id?: string;
   children?: React.ReactNode;                   // Submit button, etc.
+  ref?: React.Ref<DynamicFormRef>;
 }
 ```
 
@@ -479,31 +477,42 @@ interface BaseFieldProps {
 ### Exports
 
 ```typescript
-// Components
-export { DynamicForm } from 'dynamic-forms';
+// Components & Context
+export { DynamicForm, DynamicFormContext } from 'rhf-dynamic-forms';
 
 // Hooks
-export { useDynamicFormContext, useDynamicFormContextSafe } from 'dynamic-forms';
+export { useDynamicFormContext, useDynamicFormContextSafe } from 'rhf-dynamic-forms';
 
 // Custom Components
 export {
   defineCustomComponent,        // Type-safe component definition helper
+} from 'rhf-dynamic-forms';
+
+// Parser
+export {
+  parseConfiguration,
+  safeParseConfiguration,
   ConfigurationError,           // Error class for invalid configurations
-} from 'dynamic-forms';
+} from 'rhf-dynamic-forms';
 
 // Types
 export type {
+  // Core configuration types
   FormConfiguration,
   FormElement,
   FieldElement,
   ContainerElement,
   ColumnElement,
   ValidationConfig,
+  FormData,
+  // Component props
+  DynamicFormProps,
+  DynamicFormRef,
+  DynamicFormContextValue,
+  // Registry types
   FieldComponentRegistry,
   CustomComponentRegistry,
   CustomContainerRegistry,
-  FormData,
-  ZodSchema,
   // Custom component types
   CustomComponentDefinition,
   CustomComponentRenderProps,
@@ -520,26 +529,27 @@ export type {
   SelectFieldElement,
   ArrayFieldElement,
   SelectOption,
-} from 'dynamic-forms';
+} from 'rhf-dynamic-forms';
 
 // Utilities
 export {
-  parseConfiguration,
-  safeParseConfiguration,
   generateZodSchema,
   createVisibilityAwareResolver,
   calculateVisibility,
   flattenFields,
   getFieldNames,
   mergeDefaults,
+  getNestedValue,
+  setNestedValue,
   applyJsonLogic,
   evaluateCondition,
+  // Type guards
   isFieldElement,
   isContainerElement,
   isColumnElement,
   isCustomFieldElement,
   isArrayFieldElement,
-} from 'dynamic-forms';
+} from 'rhf-dynamic-forms';
 ```
 
 ## Creating Field Components

package/dist/index.cjs

@@ -641,12 +641,13 @@ const columnElementSchema = zod.z.object({
 });
 /**
 * Container element schema (for Phase 2).
+* Uses passthrough() to preserve custom properties like containerMeta.
 */
 const containerElementSchema = zod.z.object({
 	type: zod.z.literal("container"),
 	columns: zod.z.array(columnElementSchema),
 	visible: jsonLogicRuleSchema.optional()
-});
+}).passthrough();
 /**
 * Custom component definition schema.
 */
@@ -1364,16 +1365,16 @@ const setNestedSchema = (shape, path, schema) => {
 	}
 	const [first, ...rest] = parts;
 	const remainingPath = rest.join(".");
-	if (!shape[first]) shape[first] = zod.z.object({});
+	if (!shape[first]) shape[first] = zod.z.looseObject({});
 	const existingSchema = shape[first];
 	if (existingSchema instanceof zod.ZodObject) {
 		const innerShape = { ...existingSchema.shape };
 		setNestedSchema(innerShape, remainingPath, schema);
-		shape[first] = zod.z.object(innerShape);
+		shape[first] = zod.z.looseObject(innerShape);
 	} else {
 		const innerShape = {};
 		setNestedSchema(innerShape, remainingPath, schema);
-		shape[first] = zod.z.object(innerShape);
+		shape[first] = zod.z.looseObject(innerShape);
 	}
 };
 
@@ -1439,7 +1440,7 @@ const generateZodSchema = (config) => {
 		const fieldSchema = buildFieldSchema(field);
 		setNestedSchema(schemaShape, field.name, fieldSchema);
 	}
-	let schema = zod.z.object(schemaShape);
+	let schema = zod.z.looseObject(schemaShape);
 	const conditions = collectConditions(fields);
 	if (conditions.length > 0) schema = schema.superRefine((data, ctx) => {
 		for (const { fieldPath, condition, message } of conditions) if (!evaluateCondition(condition, data)) ctx.addIssue({

package/dist/index.mjs

@@ -612,12 +612,13 @@ const columnElementSchema = z.object({
 });
 /**
 * Container element schema (for Phase 2).
+* Uses passthrough() to preserve custom properties like containerMeta.
 */
 const containerElementSchema = z.object({
 	type: z.literal("container"),
 	columns: z.array(columnElementSchema),
 	visible: jsonLogicRuleSchema.optional()
-});
+}).passthrough();
 /**
 * Custom component definition schema.
 */
@@ -1335,16 +1336,16 @@ const setNestedSchema = (shape, path, schema) => {
 	}
 	const [first, ...rest] = parts;
 	const remainingPath = rest.join(".");
-	if (!shape[first]) shape[first] = z.object({});
+	if (!shape[first]) shape[first] = z.looseObject({});
 	const existingSchema = shape[first];
 	if (existingSchema instanceof ZodObject) {
 		const innerShape = { ...existingSchema.shape };
 		setNestedSchema(innerShape, remainingPath, schema);
-		shape[first] = z.object(innerShape);
+		shape[first] = z.looseObject(innerShape);
 	} else {
 		const innerShape = {};
 		setNestedSchema(innerShape, remainingPath, schema);
-		shape[first] = z.object(innerShape);
+		shape[first] = z.looseObject(innerShape);
 	}
 };
 
@@ -1410,7 +1411,7 @@ const generateZodSchema = (config) => {
 		const fieldSchema = buildFieldSchema(field);
 		setNestedSchema(schemaShape, field.name, fieldSchema);
 	}
-	let schema = z.object(schemaShape);
+	let schema = z.looseObject(schemaShape);
 	const conditions = collectConditions(fields);
 	if (conditions.length > 0) schema = schema.superRefine((data, ctx) => {
 		for (const { fieldPath, condition, message } of conditions) if (!evaluateCondition(condition, data)) ctx.addIssue({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rhf-dynamic-forms",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Configuration-driven form generation library for React",
   "author": "Oleh Krachun",
   "license": "MIT",