form-builder-pro 1.3.6 → 1.3.8

package/dist/index.css

@@ -105,7 +105,7 @@
   --tw-contain-paint:  ;
   --tw-contain-style:  ;
 }/*
-! tailwindcss v3.4.18 | MIT License | https://tailwindcss.com
+! tailwindcss v3.4.19 | MIT License | https://tailwindcss.com
 *//*
 1. Prevent padding and border from affecting element width. (https://github.com/mozdevs/cssremedy/issues/4)
 2. Allow adding a border to an element by just adding a border-width. (https://github.com/tailwindcss/tailwindcss/pull/116)

package/dist/index.d.mts

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 import * as zustand_vanilla from 'zustand/vanilla';
 
-type FieldType = 'text' | 'textarea' | 'number' | 'date' | 'datetime' | 'select' | 'checkbox' | 'radio' | 'toggle' | 'binary_choice' | 'repeater' | 'file' | 'image' | 'email' | 'phone';
+type FieldType = 'text' | 'textarea' | 'number' | 'date' | 'datetime' | 'select' | 'checkbox' | 'radio' | 'toggle' | 'binary_choice' | 'repeater' | 'file' | 'image' | 'email' | 'phone' | 'name_generator';
+/** Name generator format options for name_generator field type */
+type NameGeneratorFormat = 'TEXT_HYPHEN_ID' | 'TEXT_UNDERSCORE_ID' | 'TEXT_SLASH_ID' | 'TEXT_ID' | 'ID_HYPHEN_TEXT' | 'ID_UNDERSCORE_TEXT' | 'TEXT_YEAR_ID' | 'TEXT_MONTH_ID' | 'TEXT_YEAR_MONTH_ID' | 'TEXT_ACCOUNT_CODE_ID' | 'TEXT_BRANCH_ID' | 'PREFIX_TEXT_ID' | 'TEXT_ID_SUFFIX' | 'TEXT_RANDOM_4' | 'TEXT_YEAR_MONTH_DAY_ID' | 'TEXT_HYPHEN_USER_INPUT' | 'TEXT_UNDERSCORE_USER_INPUT' | 'TEXT_SLASH_USER_INPUT' | 'USER_INPUT_HYPHEN_TEXT' | 'USER_INPUT_UNDERSCORE_TEXT';
 type FieldWidth = '25%' | '33%' | '50%' | '66%' | '75%' | '100%' | number;
 declare function parseWidth(width: FieldWidth): number;
 declare function getColSpanFromWidth(width: FieldWidth): string;
@@ -62,6 +64,8 @@ interface AsyncOptionSource {
     labelKey: string;
     valueKey: string;
 }
+/** Lookup (Entity Fields) — source category for optionSource LOOKUP */
+type LookupSourceType = 'MODULE' | 'MASTER_TYPE' | 'SETTINGS';
 interface FormField {
     id: string;
     type: FieldType;
@@ -96,6 +100,8 @@ interface FormField {
     masterTypeName?: string;
     enabled?: boolean;
     visible?: boolean;
+    /** When true, host/backend may enforce uniqueness for this field’s value */
+    isUnique?: boolean;
     order?: number;
     css?: {
         class?: string;
@@ -105,10 +111,11 @@ interface FormField {
     multiselect?: boolean;
     multiSelect?: boolean;
     optionSource?: 'STATIC' | 'MASTER' | 'LOOKUP';
-    lookupSourceType?: 'MODULE' | 'MASTER_TYPE';
+    lookupSourceType?: LookupSourceType;
     lookupSource?: string;
     lookupValueField?: string;
     lookupLabelField?: string;
+    lookupParentFieldName?: string | null;
     isd?: ISDConfig;
     imageUrl?: string;
     valueSource?: 'manual' | 'formula';
@@ -123,6 +130,11 @@ interface FormField {
     repeatItemLabel?: string;
     repeatIncrementEnabled?: boolean;
     dateConstraints?: DateConstraint;
+    nameGeneratorFormat?: NameGeneratorFormat;
+    nameGeneratorText?: string;
+    nameGeneratorPrefix?: string;
+    nameGeneratorSuffix?: string;
+    nameGeneratorIdPadding?: number;
 }
 /**
  * Conditional date constraint — evaluated at runtime against the current date or another field's value.
@@ -209,6 +221,12 @@ declare const FormSchemaValidation: z.ZodObject<{
     }[];
 }>;
 
+/** Labels for Lookup Source Type (Entity Fields) — values are the API `sourceType` strings */
+declare const LOOKUP_SOURCE_TYPE_OPTIONS: {
+    value: LookupSourceType;
+    label: string;
+}[];
+
 interface MasterType {
     id: string;
     name: string;
@@ -296,6 +314,11 @@ interface FormBuilderOptions {
         }[];
     };
     moduleList?: string[];
+    /** Settings entity registry (sourceKey + display label) — same list the host uses for Legal Entities, Operating Units, User Groups, etc. */
+    settingsEntities?: {
+        label: string;
+        value: string;
+    }[];
     lookupFieldOptionsMap?: {
         [lookupSource: string]: string[];
     };
@@ -309,7 +332,7 @@ interface FormBuilderOptions {
     }) => void;
     onLookupSourceChange?: (event: {
         fieldId: string;
-        lookupSourceType: 'MODULE' | 'MASTER_TYPE';
+        lookupSourceType: LookupSourceType;
         lookupSource: string;
     }) => void;
     onProfileClick?: () => void;
@@ -454,8 +477,17 @@ declare function getNumericFieldsForFormula(schema: FormSchema, excludeFieldId?:
     label: string;
 }[];
 
+/** Reset counter (for testing or new form load) */
+declare function resetNameGeneratorCounter(): void;
+/**
+ * Generate a name based on field configuration.
+ * Uses format, prefix, suffix, static text, and padded ID.
+ * For USER_INPUT formats, uses empty string as placeholder (caller should pass userInput).
+ */
+declare function generateName(fieldConfig: Pick<FormField, 'nameGeneratorFormat' | 'nameGeneratorText' | 'nameGeneratorPrefix' | 'nameGeneratorSuffix' | 'nameGeneratorIdPadding'>, userInput?: string): string;
+
 declare const initFormBuilder: (options: FormBuilderOptions & {
     containerId: string;
 }) => FormBuilder;
 
-export { AsyncOptionSource, DateConstraint, FieldType, FieldValidations, FieldWidth, FormBuilder, FormBuilderOptions, FormField, FormRenderer, FormSchema, FormSchemaValidation, FormSection, ISDConfig, MasterType, ValidationObject, ValidationRule, builderToPlatform, cleanFormSchema, convertValidationObjectToArray, detectCircularDependency, evaluateFormula, formStore, getColSpanFromWidth, getNumericFieldsForFormula, getValidationConfigForAngular, initFormBuilder, parseFormulaDependencies, parseWidth, platformToBuilder, validateFormula };
+export { type AsyncOptionSource, type DateConstraint, type FieldType, type FieldValidations, type FieldWidth, FormBuilder, type FormBuilderOptions, type FormField, FormRenderer, type FormSchema, FormSchemaValidation, type FormSection, type ISDConfig, LOOKUP_SOURCE_TYPE_OPTIONS, type LookupSourceType, type MasterType, type NameGeneratorFormat, type ValidationObject, type ValidationRule, builderToPlatform, cleanFormSchema, convertValidationObjectToArray, detectCircularDependency, evaluateFormula, formStore, generateName, getColSpanFromWidth, getNumericFieldsForFormula, getValidationConfigForAngular, initFormBuilder, parseFormulaDependencies, parseWidth, platformToBuilder, resetNameGeneratorCounter, validateFormula };

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 import * as zustand_vanilla from 'zustand/vanilla';
 
-type FieldType = 'text' | 'textarea' | 'number' | 'date' | 'datetime' | 'select' | 'checkbox' | 'radio' | 'toggle' | 'binary_choice' | 'repeater' | 'file' | 'image' | 'email' | 'phone';
+type FieldType = 'text' | 'textarea' | 'number' | 'date' | 'datetime' | 'select' | 'checkbox' | 'radio' | 'toggle' | 'binary_choice' | 'repeater' | 'file' | 'image' | 'email' | 'phone' | 'name_generator';
+/** Name generator format options for name_generator field type */
+type NameGeneratorFormat = 'TEXT_HYPHEN_ID' | 'TEXT_UNDERSCORE_ID' | 'TEXT_SLASH_ID' | 'TEXT_ID' | 'ID_HYPHEN_TEXT' | 'ID_UNDERSCORE_TEXT' | 'TEXT_YEAR_ID' | 'TEXT_MONTH_ID' | 'TEXT_YEAR_MONTH_ID' | 'TEXT_ACCOUNT_CODE_ID' | 'TEXT_BRANCH_ID' | 'PREFIX_TEXT_ID' | 'TEXT_ID_SUFFIX' | 'TEXT_RANDOM_4' | 'TEXT_YEAR_MONTH_DAY_ID' | 'TEXT_HYPHEN_USER_INPUT' | 'TEXT_UNDERSCORE_USER_INPUT' | 'TEXT_SLASH_USER_INPUT' | 'USER_INPUT_HYPHEN_TEXT' | 'USER_INPUT_UNDERSCORE_TEXT';
 type FieldWidth = '25%' | '33%' | '50%' | '66%' | '75%' | '100%' | number;
 declare function parseWidth(width: FieldWidth): number;
 declare function getColSpanFromWidth(width: FieldWidth): string;
@@ -62,6 +64,8 @@ interface AsyncOptionSource {
     labelKey: string;
     valueKey: string;
 }
+/** Lookup (Entity Fields) — source category for optionSource LOOKUP */
+type LookupSourceType = 'MODULE' | 'MASTER_TYPE' | 'SETTINGS';
 interface FormField {
     id: string;
     type: FieldType;
@@ -96,6 +100,8 @@ interface FormField {
     masterTypeName?: string;
     enabled?: boolean;
     visible?: boolean;
+    /** When true, host/backend may enforce uniqueness for this field’s value */
+    isUnique?: boolean;
     order?: number;
     css?: {
         class?: string;
@@ -105,10 +111,11 @@ interface FormField {
     multiselect?: boolean;
     multiSelect?: boolean;
     optionSource?: 'STATIC' | 'MASTER' | 'LOOKUP';
-    lookupSourceType?: 'MODULE' | 'MASTER_TYPE';
+    lookupSourceType?: LookupSourceType;
     lookupSource?: string;
     lookupValueField?: string;
     lookupLabelField?: string;
+    lookupParentFieldName?: string | null;
     isd?: ISDConfig;
     imageUrl?: string;
     valueSource?: 'manual' | 'formula';
@@ -123,6 +130,11 @@ interface FormField {
     repeatItemLabel?: string;
     repeatIncrementEnabled?: boolean;
     dateConstraints?: DateConstraint;
+    nameGeneratorFormat?: NameGeneratorFormat;
+    nameGeneratorText?: string;
+    nameGeneratorPrefix?: string;
+    nameGeneratorSuffix?: string;
+    nameGeneratorIdPadding?: number;
 }
 /**
  * Conditional date constraint — evaluated at runtime against the current date or another field's value.
@@ -209,6 +221,12 @@ declare const FormSchemaValidation: z.ZodObject<{
     }[];
 }>;
 
+/** Labels for Lookup Source Type (Entity Fields) — values are the API `sourceType` strings */
+declare const LOOKUP_SOURCE_TYPE_OPTIONS: {
+    value: LookupSourceType;
+    label: string;
+}[];
+
 interface MasterType {
     id: string;
     name: string;
@@ -296,6 +314,11 @@ interface FormBuilderOptions {
         }[];
     };
     moduleList?: string[];
+    /** Settings entity registry (sourceKey + display label) — same list the host uses for Legal Entities, Operating Units, User Groups, etc. */
+    settingsEntities?: {
+        label: string;
+        value: string;
+    }[];
     lookupFieldOptionsMap?: {
         [lookupSource: string]: string[];
     };
@@ -309,7 +332,7 @@ interface FormBuilderOptions {
     }) => void;
     onLookupSourceChange?: (event: {
         fieldId: string;
-        lookupSourceType: 'MODULE' | 'MASTER_TYPE';
+        lookupSourceType: LookupSourceType;
         lookupSource: string;
     }) => void;
     onProfileClick?: () => void;
@@ -454,8 +477,17 @@ declare function getNumericFieldsForFormula(schema: FormSchema, excludeFieldId?:
     label: string;
 }[];
 
+/** Reset counter (for testing or new form load) */
+declare function resetNameGeneratorCounter(): void;
+/**
+ * Generate a name based on field configuration.
+ * Uses format, prefix, suffix, static text, and padded ID.
+ * For USER_INPUT formats, uses empty string as placeholder (caller should pass userInput).
+ */
+declare function generateName(fieldConfig: Pick<FormField, 'nameGeneratorFormat' | 'nameGeneratorText' | 'nameGeneratorPrefix' | 'nameGeneratorSuffix' | 'nameGeneratorIdPadding'>, userInput?: string): string;
+
 declare const initFormBuilder: (options: FormBuilderOptions & {
     containerId: string;
 }) => FormBuilder;
 
-export { AsyncOptionSource, DateConstraint, FieldType, FieldValidations, FieldWidth, FormBuilder, FormBuilderOptions, FormField, FormRenderer, FormSchema, FormSchemaValidation, FormSection, ISDConfig, MasterType, ValidationObject, ValidationRule, builderToPlatform, cleanFormSchema, convertValidationObjectToArray, detectCircularDependency, evaluateFormula, formStore, getColSpanFromWidth, getNumericFieldsForFormula, getValidationConfigForAngular, initFormBuilder, parseFormulaDependencies, parseWidth, platformToBuilder, validateFormula };
+export { type AsyncOptionSource, type DateConstraint, type FieldType, type FieldValidations, type FieldWidth, FormBuilder, type FormBuilderOptions, type FormField, FormRenderer, type FormSchema, FormSchemaValidation, type FormSection, type ISDConfig, LOOKUP_SOURCE_TYPE_OPTIONS, type LookupSourceType, type MasterType, type NameGeneratorFormat, type ValidationObject, type ValidationRule, builderToPlatform, cleanFormSchema, convertValidationObjectToArray, detectCircularDependency, evaluateFormula, formStore, generateName, getColSpanFromWidth, getNumericFieldsForFormula, getValidationConfigForAngular, initFormBuilder, parseFormulaDependencies, parseWidth, platformToBuilder, resetNameGeneratorCounter, validateFormula };