@form-engine-ts/react 4.1.0 → 4.2.0

package/dist/index.cjs

@@ -169,6 +169,61 @@ function defaultCreateOption(field, id) {
 function defaultCreatePage(id, questionIds) {
   return { id, title: "New page", questionIds };
 }
+function applyFieldConstraintDefaults(field, policy) {
+  const constraint = policy?.fieldConstraints?.[field.type];
+  if (constraint === void 0) return field;
+  const required = constraint.fixedRequired ?? constraint.defaultRequired ?? field.required;
+  if (field.type === "rating") {
+    const ratingConstraint = "defaultMin" in constraint || "defaultMax" in constraint || "fixedMin" in constraint || "fixedMax" in constraint ? constraint : void 0;
+    const min = ratingConstraint !== void 0 && "fixedMin" in ratingConstraint ? ratingConstraint.fixedMin : ratingConstraint !== void 0 && "defaultMin" in ratingConstraint ? ratingConstraint.defaultMin : field.min;
+    const max = ratingConstraint !== void 0 && "fixedMax" in ratingConstraint ? ratingConstraint.fixedMax : ratingConstraint !== void 0 && "defaultMax" in ratingConstraint ? ratingConstraint.defaultMax : field.max;
+    return {
+      ...field,
+      required,
+      ...min === void 0 ? {} : { min },
+      ...max === void 0 ? {} : { max }
+    };
+  }
+  if ((field.type === "text" || field.type === "textarea") && "defaultMaxLength" in constraint) {
+    return {
+      ...field,
+      required,
+      ...constraint.defaultMaxLength === void 0 ? {} : { maxLength: constraint.defaultMaxLength }
+    };
+  }
+  return { ...field, required };
+}
+function fieldConstraintError(updated, policy) {
+  const constraint = policy?.fieldConstraints?.[updated.type];
+  if (constraint === void 0) return void 0;
+  if (constraint.fixedRequired !== void 0 && updated.required !== constraint.fixedRequired) {
+    return { type: "field_constraint_immutable" };
+  }
+  if (updated.type === "rating") {
+    if ("fixedMin" in constraint && constraint.fixedMin !== void 0 && updated.min !== constraint.fixedMin) {
+      return { type: "field_constraint_immutable" };
+    }
+    if ("fixedMax" in constraint && constraint.fixedMax !== void 0 && updated.max !== constraint.fixedMax) {
+      return { type: "field_constraint_immutable" };
+    }
+    if ("allowedMinRange" in constraint && constraint.allowedMinRange !== void 0 && typeof updated.min === "number" && (updated.min < constraint.allowedMinRange[0] || updated.min > constraint.allowedMinRange[1])) {
+      return { type: "field_constraint_violation", property: "min", expected: constraint.allowedMinRange[0] };
+    }
+    if ("allowedMaxRange" in constraint && constraint.allowedMaxRange !== void 0 && typeof updated.max === "number" && (updated.max < constraint.allowedMaxRange[0] || updated.max > constraint.allowedMaxRange[1])) {
+      return { type: "field_constraint_violation", property: "max", expected: constraint.allowedMaxRange[1] };
+    }
+  }
+  if ((updated.type === "text" || updated.type === "textarea") && "maxMaxLength" in constraint && constraint.maxMaxLength !== void 0 && updated.maxLength !== void 0 && updated.maxLength > constraint.maxMaxLength) {
+    return { type: "field_constraint_violation", property: "maxLength", expected: constraint.maxMaxLength };
+  }
+  if ((updated.type === "select" || updated.type === "radio" || updated.type === "multi-select") && "minOptions" in constraint && constraint.minOptions !== void 0 && updated.options.length < constraint.minOptions) {
+    return { type: "field_constraint_violation", property: "options", expected: constraint.minOptions };
+  }
+  if ((updated.type === "select" || updated.type === "radio" || updated.type === "multi-select") && "maxOptions" in constraint && constraint.maxOptions !== void 0 && updated.options.length > constraint.maxOptions) {
+    return { type: "field_constraint_violation", property: "options", expected: constraint.maxOptions };
+  }
+  return void 0;
+}
 function move(items, sourceIndex, targetIndex) {
   if (sourceIndex < 0 || targetIndex < 0 || targetIndex >= items.length || sourceIndex === targetIndex)
     return void 0;
@@ -224,6 +279,8 @@ function useFormBuilder({
       const updated = updater(current);
       if (updated.id !== fieldId)
         return { success: false, error: { type: "invalid_id", kind: "field", id: updated.id } };
+      const constraintError = fieldConstraintError(updated, policy);
+      if (constraintError !== void 0) return { success: false, error: constraintError };
       if (policy?.allowedFieldTypes !== void 0 && !policy.allowedFieldTypes.includes(updated.type))
         return { success: false, error: { type: "disallowed_field_type", fieldType: updated.type } };
       for (const text of [updated.title, updated.description]) {
@@ -235,7 +292,7 @@ function useFormBuilder({
       onChange({ ...schema, fields: schema.fields.map((field) => field.id === fieldId ? updated : field) });
       return { success: true };
     },
-    [onChange, policy?.allowedFieldTypes, schema, textPolicyError]
+    [onChange, policy, schema, textPolicyError]
   );
   const updateOption = (0, import_react.useCallback)(
     (fieldId, optionId, updater) => {
@@ -308,6 +365,7 @@ function useFormBuilder({
           return { success: false, error: { type: "invalid_id", kind: "option", id: option.id } };
         field = { ...field, options: [option] };
       }
+      field = applyFieldConstraintDefaults(field, policy);
       const pages = schema.pages?.map((page, index) => ({
         ...page,
         questionIds: page.id === pageId || pageId === void 0 && index === (schema.pages?.length ?? 0) - 1 ? [...page.questionIds, field.id] : page.questionIds
@@ -360,6 +418,12 @@ function useFormBuilder({
         return { success: false, error: { type: "invalid_operation", message: `Field ${fieldId} has no options.` } };
       if (policy?.maxOptionsPerField !== void 0 && field.options.length >= policy.maxOptionsPerField)
         return { success: false, error: { type: "max_options_exceeded", max: policy.maxOptionsPerField } };
+      const constraint = policy?.fieldConstraints?.[field.type];
+      if (constraint !== void 0 && "maxOptions" in constraint && constraint.maxOptions !== void 0 && field.options.length >= constraint.maxOptions)
+        return {
+          success: false,
+          error: { type: "field_constraint_violation", property: "options", expected: constraint.maxOptions }
+        };
       const ids = new Set(
         schema.fields.flatMap((item) => "options" in item ? item.options.map((option2) => option2.id) : [])
       );
@@ -376,7 +440,7 @@ function useFormBuilder({
       });
       return { success: true };
     },
-    [createId, factories.createOption, onChange, policy?.maxOptionsPerField, schema]
+    [createId, factories.createOption, onChange, policy, policy?.maxOptionsPerField, schema]
   );
   const removeOption = (0, import_react.useCallback)(
     (fieldId, optionId) => {
@@ -386,6 +450,12 @@ function useFormBuilder({
         return { success: false, error: { type: "node_not_found", kind: "option", id: optionId } };
       if (field.options.length <= 1)
         return { success: false, error: { type: "invalid_operation", message: "A choice field needs one option." } };
+      const constraint = policy?.fieldConstraints?.[field.type];
+      if (constraint !== void 0 && "minOptions" in constraint && constraint.minOptions !== void 0 && field.options.length <= constraint.minOptions)
+        return {
+          success: false,
+          error: { type: "field_constraint_violation", property: "options", expected: constraint.minOptions }
+        };
       onChange({
         ...schema,
         fields: schema.fields.map(
@@ -394,7 +464,7 @@ function useFormBuilder({
       });
       return { success: true };
     },
-    [onChange, schema]
+    [onChange, policy, schema]
   );
   const moveOption = (0, import_react.useCallback)(
     (fieldId, optionId, targetIndex) => {
@@ -425,7 +495,9 @@ function useFormBuilder({
       if (field === void 0) return { success: false, error: { type: "node_not_found", kind: "field", id: fieldId } };
       if (policy?.allowedFieldTypes !== void 0 && !policy.allowedFieldTypes.includes(type))
         return { success: false, error: { type: "disallowed_field_type", fieldType: type } };
-      let transformed = (0, import_core.transformFieldType)(field, type);
+      let transformed = applyFieldConstraintDefaults((0, import_core.transformFieldType)(field, type), policy);
+      const constraintError = fieldConstraintError(transformed, policy);
+      if (constraintError !== void 0) return { success: false, error: constraintError };
       if (CHOICE_TYPES.includes(type) && !("options" in field) && "options" in transformed) {
         const ids = new Set(
           schema.fields.flatMap((item) => "options" in item ? item.options.map((option2) => option2.id) : [])
@@ -440,7 +512,7 @@ function useFormBuilder({
       onChange({ ...schema, fields: schema.fields.map((item) => item.id === fieldId ? transformed : item) });
       return { success: true };
     },
-    [createId, factories.createOption, onChange, policy?.allowedFieldTypes, schema]
+    [createId, factories.createOption, onChange, policy, policy?.allowedFieldTypes, schema]
   );
   const addPage = (0, import_react.useCallback)(
     (questionId) => {

package/dist/index.d.cts

@@ -60,6 +60,12 @@ type BuilderActionError = {
 } | {
     readonly type: "max_locales_exceeded";
     readonly max: number;
+} | {
+    readonly type: "field_constraint_immutable";
+} | {
+    readonly type: "field_constraint_violation";
+    readonly property: string;
+    readonly expected: number;
 } | {
     readonly type: "node_not_found";
     readonly kind: BuilderTextTarget["kind"];

package/dist/index.d.ts

@@ -60,6 +60,12 @@ type BuilderActionError = {
 } | {
     readonly type: "max_locales_exceeded";
     readonly max: number;
+} | {
+    readonly type: "field_constraint_immutable";
+} | {
+    readonly type: "field_constraint_violation";
+    readonly property: string;
+    readonly expected: number;
 } | {
     readonly type: "node_not_found";
     readonly kind: BuilderTextTarget["kind"];

package/dist/index.js

@@ -133,6 +133,61 @@ function defaultCreateOption(field, id) {
 function defaultCreatePage(id, questionIds) {
   return { id, title: "New page", questionIds };
 }
+function applyFieldConstraintDefaults(field, policy) {
+  const constraint = policy?.fieldConstraints?.[field.type];
+  if (constraint === void 0) return field;
+  const required = constraint.fixedRequired ?? constraint.defaultRequired ?? field.required;
+  if (field.type === "rating") {
+    const ratingConstraint = "defaultMin" in constraint || "defaultMax" in constraint || "fixedMin" in constraint || "fixedMax" in constraint ? constraint : void 0;
+    const min = ratingConstraint !== void 0 && "fixedMin" in ratingConstraint ? ratingConstraint.fixedMin : ratingConstraint !== void 0 && "defaultMin" in ratingConstraint ? ratingConstraint.defaultMin : field.min;
+    const max = ratingConstraint !== void 0 && "fixedMax" in ratingConstraint ? ratingConstraint.fixedMax : ratingConstraint !== void 0 && "defaultMax" in ratingConstraint ? ratingConstraint.defaultMax : field.max;
+    return {
+      ...field,
+      required,
+      ...min === void 0 ? {} : { min },
+      ...max === void 0 ? {} : { max }
+    };
+  }
+  if ((field.type === "text" || field.type === "textarea") && "defaultMaxLength" in constraint) {
+    return {
+      ...field,
+      required,
+      ...constraint.defaultMaxLength === void 0 ? {} : { maxLength: constraint.defaultMaxLength }
+    };
+  }
+  return { ...field, required };
+}
+function fieldConstraintError(updated, policy) {
+  const constraint = policy?.fieldConstraints?.[updated.type];
+  if (constraint === void 0) return void 0;
+  if (constraint.fixedRequired !== void 0 && updated.required !== constraint.fixedRequired) {
+    return { type: "field_constraint_immutable" };
+  }
+  if (updated.type === "rating") {
+    if ("fixedMin" in constraint && constraint.fixedMin !== void 0 && updated.min !== constraint.fixedMin) {
+      return { type: "field_constraint_immutable" };
+    }
+    if ("fixedMax" in constraint && constraint.fixedMax !== void 0 && updated.max !== constraint.fixedMax) {
+      return { type: "field_constraint_immutable" };
+    }
+    if ("allowedMinRange" in constraint && constraint.allowedMinRange !== void 0 && typeof updated.min === "number" && (updated.min < constraint.allowedMinRange[0] || updated.min > constraint.allowedMinRange[1])) {
+      return { type: "field_constraint_violation", property: "min", expected: constraint.allowedMinRange[0] };
+    }
+    if ("allowedMaxRange" in constraint && constraint.allowedMaxRange !== void 0 && typeof updated.max === "number" && (updated.max < constraint.allowedMaxRange[0] || updated.max > constraint.allowedMaxRange[1])) {
+      return { type: "field_constraint_violation", property: "max", expected: constraint.allowedMaxRange[1] };
+    }
+  }
+  if ((updated.type === "text" || updated.type === "textarea") && "maxMaxLength" in constraint && constraint.maxMaxLength !== void 0 && updated.maxLength !== void 0 && updated.maxLength > constraint.maxMaxLength) {
+    return { type: "field_constraint_violation", property: "maxLength", expected: constraint.maxMaxLength };
+  }
+  if ((updated.type === "select" || updated.type === "radio" || updated.type === "multi-select") && "minOptions" in constraint && constraint.minOptions !== void 0 && updated.options.length < constraint.minOptions) {
+    return { type: "field_constraint_violation", property: "options", expected: constraint.minOptions };
+  }
+  if ((updated.type === "select" || updated.type === "radio" || updated.type === "multi-select") && "maxOptions" in constraint && constraint.maxOptions !== void 0 && updated.options.length > constraint.maxOptions) {
+    return { type: "field_constraint_violation", property: "options", expected: constraint.maxOptions };
+  }
+  return void 0;
+}
 function move(items, sourceIndex, targetIndex) {
   if (sourceIndex < 0 || targetIndex < 0 || targetIndex >= items.length || sourceIndex === targetIndex)
     return void 0;
@@ -188,6 +243,8 @@ function useFormBuilder({
       const updated = updater(current);
       if (updated.id !== fieldId)
         return { success: false, error: { type: "invalid_id", kind: "field", id: updated.id } };
+      const constraintError = fieldConstraintError(updated, policy);
+      if (constraintError !== void 0) return { success: false, error: constraintError };
       if (policy?.allowedFieldTypes !== void 0 && !policy.allowedFieldTypes.includes(updated.type))
         return { success: false, error: { type: "disallowed_field_type", fieldType: updated.type } };
       for (const text of [updated.title, updated.description]) {
@@ -199,7 +256,7 @@ function useFormBuilder({
       onChange({ ...schema, fields: schema.fields.map((field) => field.id === fieldId ? updated : field) });
       return { success: true };
     },
-    [onChange, policy?.allowedFieldTypes, schema, textPolicyError]
+    [onChange, policy, schema, textPolicyError]
   );
   const updateOption = useCallback(
     (fieldId, optionId, updater) => {
@@ -272,6 +329,7 @@ function useFormBuilder({
           return { success: false, error: { type: "invalid_id", kind: "option", id: option.id } };
         field = { ...field, options: [option] };
       }
+      field = applyFieldConstraintDefaults(field, policy);
       const pages = schema.pages?.map((page, index) => ({
         ...page,
         questionIds: page.id === pageId || pageId === void 0 && index === (schema.pages?.length ?? 0) - 1 ? [...page.questionIds, field.id] : page.questionIds
@@ -324,6 +382,12 @@ function useFormBuilder({
         return { success: false, error: { type: "invalid_operation", message: `Field ${fieldId} has no options.` } };
       if (policy?.maxOptionsPerField !== void 0 && field.options.length >= policy.maxOptionsPerField)
         return { success: false, error: { type: "max_options_exceeded", max: policy.maxOptionsPerField } };
+      const constraint = policy?.fieldConstraints?.[field.type];
+      if (constraint !== void 0 && "maxOptions" in constraint && constraint.maxOptions !== void 0 && field.options.length >= constraint.maxOptions)
+        return {
+          success: false,
+          error: { type: "field_constraint_violation", property: "options", expected: constraint.maxOptions }
+        };
       const ids = new Set(
         schema.fields.flatMap((item) => "options" in item ? item.options.map((option2) => option2.id) : [])
       );
@@ -340,7 +404,7 @@ function useFormBuilder({
       });
       return { success: true };
     },
-    [createId, factories.createOption, onChange, policy?.maxOptionsPerField, schema]
+    [createId, factories.createOption, onChange, policy, policy?.maxOptionsPerField, schema]
   );
   const removeOption = useCallback(
     (fieldId, optionId) => {
@@ -350,6 +414,12 @@ function useFormBuilder({
         return { success: false, error: { type: "node_not_found", kind: "option", id: optionId } };
       if (field.options.length <= 1)
         return { success: false, error: { type: "invalid_operation", message: "A choice field needs one option." } };
+      const constraint = policy?.fieldConstraints?.[field.type];
+      if (constraint !== void 0 && "minOptions" in constraint && constraint.minOptions !== void 0 && field.options.length <= constraint.minOptions)
+        return {
+          success: false,
+          error: { type: "field_constraint_violation", property: "options", expected: constraint.minOptions }
+        };
       onChange({
         ...schema,
         fields: schema.fields.map(
@@ -358,7 +428,7 @@ function useFormBuilder({
       });
       return { success: true };
     },
-    [onChange, schema]
+    [onChange, policy, schema]
   );
   const moveOption = useCallback(
     (fieldId, optionId, targetIndex) => {
@@ -389,7 +459,9 @@ function useFormBuilder({
       if (field === void 0) return { success: false, error: { type: "node_not_found", kind: "field", id: fieldId } };
       if (policy?.allowedFieldTypes !== void 0 && !policy.allowedFieldTypes.includes(type))
         return { success: false, error: { type: "disallowed_field_type", fieldType: type } };
-      let transformed = transformFieldType(field, type);
+      let transformed = applyFieldConstraintDefaults(transformFieldType(field, type), policy);
+      const constraintError = fieldConstraintError(transformed, policy);
+      if (constraintError !== void 0) return { success: false, error: constraintError };
       if (CHOICE_TYPES.includes(type) && !("options" in field) && "options" in transformed) {
         const ids = new Set(
           schema.fields.flatMap((item) => "options" in item ? item.options.map((option2) => option2.id) : [])
@@ -404,7 +476,7 @@ function useFormBuilder({
       onChange({ ...schema, fields: schema.fields.map((item) => item.id === fieldId ? transformed : item) });
       return { success: true };
     },
-    [createId, factories.createOption, onChange, policy?.allowedFieldTypes, schema]
+    [createId, factories.createOption, onChange, policy, policy?.allowedFieldTypes, schema]
   );
   const addPage = useCallback(
     (questionId) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/react",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -42,8 +42,8 @@
     "typescript"
   ],
   "dependencies": {
-    "@form-engine-ts/core": "4.1.0",
-    "@form-engine-ts/privacy": "4.1.0"
+    "@form-engine-ts/core": "4.2.0",
+    "@form-engine-ts/privacy": "4.2.0"
   },
   "peerDependencies": {
     "react": ">=18.2 <20",