@dmitryvim/form-builder 0.2.9 → 0.2.10

package/dist/types/instance/FormBuilderInstance.d.ts

@@ -83,6 +83,10 @@ export declare class FormBuilderInstance {
      * Handle prefill hint click - updates container fields with hint values
      */
     private handlePrefillHintClick;
+    /**
+     * Create root-level prefill hints UI
+     */
+    private createRootPrefillHints;
     /**
      * Render form from schema
      */
@@ -133,7 +137,7 @@ export declare class FormBuilderInstance {
      */
     private updateFieldValue;
     /**
-     * Re-evaluate all conditional fields (displayIf) based on current form data
+     * Re-evaluate all conditional fields (enableIf) based on current form data
      * This is called automatically when form data changes (via onChange events)
      */
     private reevaluateConditionalFields;

package/dist/types/types/index.d.ts

@@ -1,4 +1,4 @@
-export type { SelectOption, ElementAction, DisplayCondition, BaseElement, TextElement, TextareaElement, NumberElement, SelectElement, FileElement, FilesElement, ColourElement, SliderElement, ContainerElement, GroupElement, Element, Schema, ExternalAction, FormData, RenderContext, } from "./schema.js";
+export type { SelectOption, ElementAction, EnableCondition, BaseElement, TextElement, TextareaElement, NumberElement, SelectElement, FileElement, FilesElement, ColourElement, SliderElement, ContainerElement, GroupElement, Element, Schema, ExternalAction, FormData, RenderContext, } from "./schema.js";
 export type { Translations, Locale, Config, ResourceMetadata, } from "./config.js";
 export type { State } from "./state.js";
 export type { ComponentContext, ValidationResult, ComponentValidator, ComponentUpdater, ComponentOperations, } from "./component-operations.js";

package/dist/types/types/schema.d.ts

@@ -14,12 +14,13 @@ export interface PrefillHint {
     values: Record<string, any>;
 }
 /**
- * Conditional display configuration for elements
+ * Conditional enable configuration for elements
  * Initially supports equals operator, designed for extensibility
  */
-export interface DisplayCondition {
+export interface EnableCondition {
     key: string;
     equals?: any;
+    scope?: "relative" | "absolute";
 }
 export interface BaseElement {
     type: string;
@@ -31,7 +32,7 @@ export interface BaseElement {
     hidden?: boolean;
     default?: any;
     actions?: ElementAction[];
-    displayIf?: DisplayCondition;
+    enableIf?: EnableCondition;
 }
 export interface TextElement extends BaseElement {
     type: "text";
@@ -130,6 +131,8 @@ export type Element = TextElement | TextareaElement | NumberElement | SelectElem
 export interface Schema {
     version?: string;
     elements: Element[];
+    columns?: 1 | 2 | 3 | 4;
+    prefillHints?: PrefillHint[];
 }
 export interface ExternalAction {
     key: string;

package/dist/types/utils/enable-conditions.d.ts

@@ -0,0 +1,18 @@
+import type { EnableCondition } from "../types/index.js";
+/**
+ * Get value from nested object path
+ * Supports nested paths: "address.city"
+ * Supports array indices: "items[0].name", "contacts[1].email"
+ * @param data - Form data object
+ * @param path - Dot notation path with optional array indices
+ * @returns The value at the path, or undefined if not found
+ */
+export declare function getValueByPath(data: any, path: string): any;
+/**
+ * Evaluate an enable condition against form data
+ * @param condition - Enable condition to evaluate
+ * @param formData - Root form data (for absolute scope)
+ * @param containerData - Container instance data (for relative scope, optional)
+ * @returns true if condition is met (field should be enabled), false otherwise
+ */
+export declare function evaluateEnableCondition(condition: EnableCondition, formData: Record<string, any>, containerData?: Record<string, any>): boolean;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "A reusable JSON schema form builder library",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",