npm - @form-engine-ts/react - Versions diffs - 4.0.0 → 4.2.0 - Mend

@form-engine-ts/react 4.0.0 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md CHANGED Viewed

@@ -72,6 +72,11 @@ controls `pages`, `localization`, and `conditions` authoring surfaces; each defa
 set, locale addition becomes a selector containing only unregistered allowed locales, and the action is disabled at
 `maxLocales`.
+`fieldEditorControls` makes the standard field editor's title, description, required flag, type selector, options,
+display conditions, text limits, rating bounds, and number limits independently `editable`, `readOnly`, or `hidden`.
+`fieldTypeOptions` can provide an explicit order, comparator, or transformation for generated type choices; the default
+choices are copied before they are changed.
 Visual Builder has two independent design-system extension layers. `components` replaces normalized primitives such as
 `Button`, `TextInput`, `TextArea`, `Select`, `Checkbox`, `Section`, and `Fieldset`. `slots` replaces complete authoring
 surfaces: `toolbar`, `fieldEditor`, `optionEditor`, `pages`, `localization`, or `translationActions`. Slot props expose

package/dist/index.cjs CHANGED Viewed

@@ -29,6 +29,8 @@ __export(index_exports, {
   createLocalStorageSubmissionAttemptStore: () => createLocalStorageSubmissionAttemptStore,
   createLocalStorageSubmissionReceiptStore: () => createLocalStorageSubmissionReceiptStore,
   isTranslationUnresolved: () => isTranslationUnresolved,
+  resolveFieldEditorControls: () => resolveFieldEditorControls,
+  resolveFieldTypeSelectOptions: () => resolveFieldTypeSelectOptions,
   resolveInitialFieldType: () => resolveInitialFieldType,
   resolveTranslation: () => resolveTranslation,
   submissionReceiptQueryKey: () => submissionReceiptQueryKey,
@@ -167,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;
@@ -222,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]) {
@@ -233,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) => {
@@ -306,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
@@ -358,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) : [])
       );
@@ -374,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) => {
@@ -384,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(
@@ -392,7 +464,7 @@ function useFormBuilder({
       });
       return { success: true };
     },
-    [onChange, schema]
+    [onChange, policy, schema]
   );
   const moveOption = (0, import_react.useCallback)(
     (fieldId, optionId, targetIndex) => {
@@ -423,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) : [])
@@ -438,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) => {
@@ -1291,6 +1365,34 @@ var FIELD_TYPES = [
   "checkbox",
   "radio"
 ];
+var DEFAULT_FIELD_EDITOR_CONTROL_MODE = "editable";
+function resolveFieldEditorControls(config = {}) {
+  return {
+    title: config.title ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    description: config.description ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    required: config.required ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    typeSelect: config.typeSelect ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    options: config.options ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    displayConditions: config.displayConditions ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    textLimits: config.textLimits ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    ratingBounds: config.ratingBounds ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    numberLimits: config.numberLimits ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE
+  };
+}
+function resolveFieldTypeSelectOptions(options, config, context) {
+  let resolved = [...options];
+  if (config?.transform !== void 0) resolved = [...config.transform(resolved, context)];
+  if (config?.order !== void 0) {
+    const ranks = new Map(config.order.map((type, index) => [type, index]));
+    resolved.sort((left, right) => {
+      const leftRank = ranks.get(left.value) ?? config.order?.length ?? 0;
+      const rightRank = ranks.get(right.value) ?? config.order?.length ?? 0;
+      return leftRank - rightRank;
+    });
+  }
+  if (config?.sort !== void 0) resolved.sort((left, right) => config.sort?.(left, right, context) ?? 0);
+  return resolved;
+}
 var BUILDER_DEFAULTS = {
   "builder.formBuilder": "Form builder",
   "builder.basicSettings": "Basic settings",
@@ -1309,6 +1411,10 @@ var BUILDER_DEFAULTS = {
   "builder.required": "Required",
   "builder.minimum": "Minimum",
   "builder.maximum": "Maximum",
+  "builder.minimumLength": "Minimum length",
+  "builder.maximumLength": "Maximum length",
+  "builder.pattern": "Pattern",
+  "builder.step": "Step",
   "builder.options": "Options",
   "builder.optionLabel": "\u9078\u629E\u80A2 / Option Label {{index}}",
   "builder.optionLabelPlaceholder": "Example: Very satisfied",
@@ -1566,6 +1672,8 @@ function FormBuilder({
   createManualTranslationMetadata,
   readOnly = false,
   features,
+  fieldEditorControls,
+  fieldTypeOptions,
   components: componentOverrides,
   slots,
   sectionOrder,
@@ -2330,6 +2438,7 @@ function FormBuilder({
               }
             ) : null }),
             /* @__PURE__ */ (0, import_jsx_runtime.jsx)(BuilderSectionGroup, { name: "questions", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__list"), children: schema.fields.map((field, index) => {
+              const controls = resolveFieldEditorControls(fieldEditorControls);
               const condition = field.displayCondition;
               const source = condition === void 0 ? void 0 : schema.fields.find((item) => item.id === condition.questionId);
               const availableSources = schema.fields.slice(0, index);
@@ -2345,6 +2454,8 @@ function FormBuilder({
                     ...slots === void 0 ? {} : { slots },
                     ...policy === void 0 ? {} : { policy },
                     ...features === void 0 ? {} : { features },
+                    ...fieldEditorControls === void 0 ? {} : { fieldEditorControls },
+                    ...fieldTypeOptions === void 0 ? {} : { fieldTypeOptions },
                     readOnly,
                     actions,
                     components
@@ -2406,7 +2517,7 @@ function FormBuilder({
                       }
                     ) }),
                     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: builderClass("form-engine-builder__grid"), children: [
-                      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                      controls.title === "hidden" ? null : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                         TextInput,
                         {
                           id: `builder-field-${field.id}-title`,
@@ -2418,34 +2529,56 @@ function FormBuilder({
                           "aria-describedby": field.title.trim().length === 0 ? `builder-field-${field.id}-title-error` : void 0,
                           value: field.title,
                           placeholder: translate("builder.questionTitlePlaceholder"),
+                          readOnly: controls.title === "readOnly",
                           onChange: (value) => updateField(field.id, (current) => ({
                             ...current,
                             title: value.trim().length === 0 ? current.title : value
                           }))
                         }
                       ) }),
-                      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                      controls.typeSelect === "hidden" ? null : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                         Select,
                         {
                           id: `builder-field-${field.id}-type`,
                           label: translate("builder.type"),
                           value: field.type,
+                          disabled: controls.typeSelect === "readOnly",
                           onChange: (value) => changeType(field.id, value),
-                          options: FIELD_TYPES.filter(
-                            (type) => policy?.allowedFieldTypes === void 0 || policy.allowedFieldTypes.includes(type)
-                          ).map((type) => ({ value: type, label: translate(fieldTypeKey(type)) }))
+                          options: resolveFieldTypeSelectOptions(
+                            FIELD_TYPES.filter(
+                              (type) => policy?.allowedFieldTypes === void 0 || policy.allowedFieldTypes.includes(type)
+                            ).map((type) => ({ value: type, label: translate(fieldTypeKey(type)) })),
+                            fieldTypeOptions,
+                            { currentType: field.type, allowedTypes: policy?.allowedFieldTypes ?? FIELD_TYPES }
+                          )
                         }
                       ) }),
-                      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                      controls.required === "hidden" ? null : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                         Checkbox,
                         {
                           className: builderClass("form-engine-builder__check"),
                           checked: field.required === true,
+                          disabled: controls.required === "readOnly",
                           onChange: (checked) => updateField(field.id, (current) => ({ ...current, required: checked })),
                           label: translate("builder.required")
                         }
                       )
                     ] }),
+                    controls.description === "hidden" ? null : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                      TextArea,
+                      {
+                        id: `builder-field-${field.id}-description`,
+                        name: `fields.${field.id}.description`,
+                        label: translate("builder.description"),
+                        value: field.description ?? "",
+                        readOnly: controls.description === "readOnly",
+                        onChange: (value) => updateField(field.id, (current) => {
+                          if (value.length > 0) return { ...current, description: value };
+                          const { description: _description, ...remaining } = current;
+                          return remaining;
+                        })
+                      }
+                    ) }),
                     !pagesEnabled || schema.pages === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                       Select,
                       {
@@ -2481,12 +2614,13 @@ function FormBuilder({
                             })
                           }
                         ) }),
-                        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                        controls.description === "hidden" ? null : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                           TextInput,
                           {
                             id: `builder-field-${field.id}-${editingLocale}-description`,
                             label: translate("builder.pageDescription"),
                             value: field.translations?.[editingLocale]?.description ?? "",
+                            readOnly: controls.description === "readOnly",
                             onChange: (value) => updateManualTranslation({
                               locale: editingLocale,
                               kind: "field",
@@ -2521,7 +2655,7 @@ function FormBuilder({
                         }
                       ) }, option.id)) : null
                     ] }),
-                    field.type === "rating" ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: builderClass("form-engine-builder__grid"), children: [
+                    field.type === "rating" && controls.ratingBounds !== "hidden" ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: builderClass("form-engine-builder__grid"), children: [
                       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                         TextInput,
                         {
@@ -2529,6 +2663,7 @@ function FormBuilder({
                           label: translate("builder.minimum"),
                           type: "number",
                           value: String(field.min ?? 1),
+                          readOnly: controls.ratingBounds === "readOnly",
                           onChange: (value) => {
                             const min = Number(value);
                             if (!Number.isInteger(min)) return;
@@ -2546,6 +2681,7 @@ function FormBuilder({
                           label: translate("builder.maximum"),
                           type: "number",
                           value: String(field.max ?? 5),
+                          readOnly: controls.ratingBounds === "readOnly",
                           onChange: (value) => {
                             const max = Number(value);
                             if (!Number.isInteger(max)) return;
@@ -2557,7 +2693,73 @@ function FormBuilder({
                         }
                       ) })
                     ] }) : null,
-                    "options" in field ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: builderClass("form-engine-builder__options"), children: [
+                    (field.type === "text" || field.type === "textarea") && controls.textLimits !== "hidden" ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: builderClass("form-engine-builder__grid"), children: [
+                      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                        TextInput,
+                        {
+                          id: `builder-field-${field.id}-min-length`,
+                          label: translate("builder.minimumLength"),
+                          type: "number",
+                          value: field.minLength === void 0 ? "" : String(field.minLength),
+                          readOnly: controls.textLimits === "readOnly",
+                          onChange: (value) => updateField(field.id, (current) => {
+                            if (current.type !== "text" && current.type !== "textarea") return current;
+                            const parsed = value.trim().length === 0 ? void 0 : Number(value);
+                            return parsed === void 0 || !Number.isInteger(parsed) || parsed < 0 ? current : { ...current, minLength: parsed };
+                          })
+                        }
+                      ) }),
+                      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                        TextInput,
+                        {
+                          id: `builder-field-${field.id}-max-length`,
+                          label: translate("builder.maximumLength"),
+                          type: "number",
+                          value: field.maxLength === void 0 ? "" : String(field.maxLength),
+                          readOnly: controls.textLimits === "readOnly",
+                          onChange: (value) => updateField(field.id, (current) => {
+                            if (current.type !== "text" && current.type !== "textarea") return current;
+                            const parsed = value.trim().length === 0 ? void 0 : Number(value);
+                            return parsed === void 0 || !Number.isInteger(parsed) || parsed < 0 ? current : { ...current, maxLength: parsed };
+                          })
+                        }
+                      ) }),
+                      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                        TextInput,
+                        {
+                          id: `builder-field-${field.id}-pattern`,
+                          label: translate("builder.pattern"),
+                          value: field.pattern ?? "",
+                          readOnly: controls.textLimits === "readOnly",
+                          onChange: (value) => updateField(field.id, (current) => {
+                            if (current.type !== "text" && current.type !== "textarea") return current;
+                            return value.length === 0 ? current : { ...current, pattern: value };
+                          })
+                        }
+                      ) })
+                    ] }) : null,
+                    field.type === "number" && controls.numberLimits !== "hidden" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__grid"), children: ["min", "max", "step"].map((property) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                      TextInput,
+                      {
+                        id: `builder-field-${field.id}-${property}`,
+                        label: translate(
+                          property === "step" ? "builder.step" : property === "min" ? "builder.minimum" : "builder.maximum"
+                        ),
+                        type: "number",
+                        value: field[property] === void 0 ? "" : String(field[property]),
+                        readOnly: controls.numberLimits === "readOnly",
+                        onChange: (value) => updateField(field.id, (current) => {
+                          if (current.type !== "number") return current;
+                          if (value.trim().length === 0) {
+                            const { [property]: _removed, ...remaining } = current;
+                            return remaining;
+                          }
+                          const parsed = Number(value);
+                          return Number.isFinite(parsed) ? { ...current, [property]: parsed } : current;
+                        })
+                      }
+                    ) }, property)) }) : null,
+                    "options" in field && controls.options !== "hidden" ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: builderClass("form-engine-builder__options"), children: [
                       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { children: translate("builder.options") }),
                       field.options.map(
                         (option, optionIndex) => OptionEditorSlot === void 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: builderClass("form-engine-builder__option"), children: [
@@ -2568,6 +2770,7 @@ function FormBuilder({
                               label: translate("builder.optionLabel", { index: optionIndex + 1 }),
                               value: option.label,
                               placeholder: translate("builder.optionLabelPlaceholder"),
+                              readOnly: controls.options === "readOnly",
                               onChange: (value) => value.trim().length === 0 ? void 0 : updateOption(field.id, option.id, value)
                             }
                           ),
@@ -2577,7 +2780,7 @@ function FormBuilder({
                               {
                                 actionType: "moveUp",
                                 title: translate("builder.moveUp", { title: option.label }),
-                                disabled: optionIndex === 0,
+                                disabled: controls.options === "readOnly" || optionIndex === 0,
                                 onClick: () => moveOption(field.id, option.id, optionIndex - 1)
                               }
                             ),
@@ -2586,7 +2789,7 @@ function FormBuilder({
                               {
                                 actionType: "moveDown",
                                 title: translate("builder.moveDown", { title: option.label }),
-                                disabled: optionIndex === field.options.length - 1,
+                                disabled: controls.options === "readOnly" || optionIndex === field.options.length - 1,
                                 onClick: () => moveOption(field.id, option.id, optionIndex + 1)
                               }
                             ),
@@ -2594,7 +2797,7 @@ function FormBuilder({
                               IconButton,
                               {
                                 actionType: "delete",
-                                disabled: field.options.length === 1,
+                                disabled: controls.options === "readOnly" || field.options.length === 1,
                                 onClick: () => removeOption(field.id, option.id),
                                 title: translate("builder.remove")
                               }
@@ -2612,7 +2815,7 @@ function FormBuilder({
                               onMoveUp: () => moveOption(field.id, option.id, optionIndex - 1),
                               onMoveDown: () => moveOption(field.id, option.id, optionIndex + 1),
                               onRemove: () => removeOption(field.id, option.id),
-                              readOnly,
+                              readOnly: readOnly || controls.options === "readOnly",
                               actions,
                               components
                             }
@@ -2626,7 +2829,7 @@ function FormBuilder({
                             index: optionIndex,
                             currentLocale: editingLocale,
                             translate,
-                            readOnly,
+                            readOnly: readOnly || controls.options === "readOnly",
                             actions,
                             components
                           },
@@ -2638,13 +2841,13 @@ function FormBuilder({
                         {
                           action: "addOption",
                           targetId: field.id,
-                          disabled: policy?.maxOptionsPerField !== void 0 && field.options.length >= policy.maxOptionsPerField,
+                          disabled: controls.options === "readOnly" || policy?.maxOptionsPerField !== void 0 && field.options.length >= policy.maxOptionsPerField,
                           onClick: () => addOption(field.id),
                           children: translate("builder.addOption")
                         }
                       )
                     ] }) : null,
-                    conditionsEnabled ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: builderClass("form-engine-builder__condition"), children: [
+                    conditionsEnabled && controls.displayConditions !== "hidden" ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: builderClass("form-engine-builder__condition"), children: [
                       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                         Select,
                         {
@@ -4001,6 +4204,8 @@ function FormRenderer(props) {
   createLocalStorageSubmissionAttemptStore,
   createLocalStorageSubmissionReceiptStore,
   isTranslationUnresolved,
+  resolveFieldEditorControls,
+  resolveFieldTypeSelectOptions,
   resolveInitialFieldType,
   resolveTranslation,
   submissionReceiptQueryKey,

package/dist/index.d.cts CHANGED Viewed

@@ -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"];
@@ -192,6 +198,32 @@ interface BuilderSelectOption<T extends string = string> {
     readonly kind?: string;
     readonly metadata?: Readonly<Record<string, unknown>>;
 }
+type FieldPropertyControlMode = "editable" | "readOnly" | "hidden";
+interface FieldEditorControlsConfig {
+    readonly title?: FieldPropertyControlMode;
+    readonly description?: FieldPropertyControlMode;
+    readonly required?: FieldPropertyControlMode;
+    readonly typeSelect?: FieldPropertyControlMode;
+    readonly options?: FieldPropertyControlMode;
+    readonly displayConditions?: FieldPropertyControlMode;
+    readonly textLimits?: FieldPropertyControlMode;
+    readonly ratingBounds?: FieldPropertyControlMode;
+    readonly numberLimits?: FieldPropertyControlMode;
+}
+interface FieldTypeSelectOptionsContext {
+    readonly currentType: QuestionType;
+    readonly allowedTypes: readonly QuestionType[];
+}
+type FieldTypeSelectOptionsTransformer = (options: readonly BuilderSelectOption<QuestionType>[], context: FieldTypeSelectOptionsContext) => readonly BuilderSelectOption<QuestionType>[];
+type FieldTypeSelectOptionsSorter = (left: BuilderSelectOption<QuestionType>, right: BuilderSelectOption<QuestionType>, context: FieldTypeSelectOptionsContext) => number;
+interface FieldTypeSelectOptionsConfig {
+    /** Transform the generated choices. The returned array is used as-is. */
+    readonly transform?: FieldTypeSelectOptionsTransformer;
+    /** Sort generated choices after transform. The source array is never mutated. */
+    readonly sort?: FieldTypeSelectOptionsSorter;
+    /** Optional explicit order applied before `sort`. */
+    readonly order?: readonly QuestionType[];
+}
 interface SelectComponentProps<T extends string = string> extends Omit<InputComponentProps, "value" | "onChange"> {
     readonly value: T;
     readonly onChange: (value: T) => void;
@@ -278,6 +310,8 @@ interface BuilderFieldEditorSlotProps extends BuilderSlotBaseProps {
         readonly localization?: boolean;
         readonly conditions?: boolean;
     };
+    readonly fieldEditorControls?: FieldEditorControlsConfig;
+    readonly fieldTypeOptions?: FieldTypeSelectOptionsConfig;
     readonly slots?: Pick<FormBuilderSlots, "fieldTypeSelect" | "fieldEditorHeader">;
 }
 interface FieldTypeSelectSlotProps {
@@ -524,6 +558,8 @@ interface SubmissionProtectionProps {
 }
 type BeforeSubmit = (values: Readonly<Record<string, unknown>>) => "continue" | "cancel" | Promise<"continue" | "cancel">;
+declare function resolveFieldEditorControls(config?: FieldEditorControlsConfig): Required<FieldEditorControlsConfig>;
+declare function resolveFieldTypeSelectOptions(options: readonly BuilderSelectOption<QuestionType>[], config: FieldTypeSelectOptionsConfig | undefined, context: FieldTypeSelectOptionsContext): readonly BuilderSelectOption<QuestionType>[];
 declare function resolveInitialFieldType(defaultType?: QuestionType, allowedTypes?: readonly QuestionType[]): QuestionType | null;
 interface FormBuilderFeatures {
     readonly pages?: boolean;
@@ -547,13 +583,15 @@ interface FormBuilderProps {
     readonly createManualTranslationMetadata?: (context: ManualTranslationContext) => Readonly<Record<string, JsonValue>> | undefined;
     readonly readOnly?: boolean;
     readonly features?: FormBuilderFeatures;
+    readonly fieldEditorControls?: FieldEditorControlsConfig;
+    readonly fieldTypeOptions?: FieldTypeSelectOptionsConfig;
     readonly components?: FormBuilderComponents;
     readonly slots?: FormBuilderSlots;
     readonly sectionOrder?: readonly FormBuilderSectionName[];
     readonly disableDefaultStyles?: boolean;
     readonly unstyled?: boolean;
 }
-declare function FormBuilder({ schema, onChange, locale, translator, translationAdapter, translationOptions, onTranslationReport, policy, idFactory, factories, className, defaultFieldType, onActionError, createManualTranslationMetadata, readOnly, features, components: componentOverrides, slots, sectionOrder, disableDefaultStyles, unstyled }: FormBuilderProps): react.JSX.Element;
+declare function FormBuilder({ schema, onChange, locale, translator, translationAdapter, translationOptions, onTranslationReport, policy, idFactory, factories, className, defaultFieldType, onActionError, createManualTranslationMetadata, readOnly, features, fieldEditorControls, fieldTypeOptions, components: componentOverrides, slots, sectionOrder, disableDefaultStyles, unstyled }: FormBuilderProps): react.JSX.Element;
 type SubmitStatus = "idle" | "submitting" | "success" | "error";
 interface FormContextValue {
@@ -659,4 +697,4 @@ interface StandaloneFormRendererProps extends FormRendererPresentationProps {
 type FormRendererProps = FormRendererPresentationProps | StandaloneFormRendererProps;
 declare function FormRenderer(props: FormRendererProps): react.JSX.Element;
-export { BUILDER_TRANSLATION_ALIASES, BUILDER_TRANSLATION_KEYS, type BeforeSubmit, type BuilderActionContext, type BuilderActionError, type BuilderActionIconType, type BuilderActionResult, type BuilderButtonProps, type BuilderCheckboxProps, type BuilderErrorMessageProps, type BuilderFactories, type BuilderFieldEditorSlotProps, type BuilderFieldsetProps, type BuilderIconButtonProps, type BuilderIdKind, type BuilderLocalizationSlotProps, type BuilderOptionEditorSlotProps, type BuilderPagesSlotProps, type BuilderPolicy, type BuilderSectionProps, type BuilderSelectOption, type BuilderSelectProps, type BuilderSlotActions, type BuilderTextAreaProps, type BuilderTextInputProps, type BuilderTextTarget, type BuilderToolbarSlotProps, type BuilderTranslationActionsSlotProps, type BuilderTranslationKey, type ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldEditorHeaderSlotProps, type FieldState, type FieldTypeSelectSlotProps, FormBuilder, type FormBuilderActions, type FormBuilderComponents, type FormBuilderFeatures, type FormBuilderOptions, type FormBuilderProps, type FormBuilderResult, type FormBuilderSectionName, type FormBuilderSlots, type FormCompletionSlotProps, type FormContextValue, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type LocalizationSummaryContext, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type SelectComponentProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitContext, type SubmitResponse, type SubmitResult, type SubmitStatus, type UseSubmissionReceiptsResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts };
+export { BUILDER_TRANSLATION_ALIASES, BUILDER_TRANSLATION_KEYS, type BeforeSubmit, type BuilderActionContext, type BuilderActionError, type BuilderActionIconType, type BuilderActionResult, type BuilderButtonProps, type BuilderCheckboxProps, type BuilderErrorMessageProps, type BuilderFactories, type BuilderFieldEditorSlotProps, type BuilderFieldsetProps, type BuilderIconButtonProps, type BuilderIdKind, type BuilderLocalizationSlotProps, type BuilderOptionEditorSlotProps, type BuilderPagesSlotProps, type BuilderPolicy, type BuilderSectionProps, type BuilderSelectOption, type BuilderSelectProps, type BuilderSlotActions, type BuilderTextAreaProps, type BuilderTextInputProps, type BuilderTextTarget, type BuilderToolbarSlotProps, type BuilderTranslationActionsSlotProps, type BuilderTranslationKey, type ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldEditorControlsConfig, type FieldEditorHeaderSlotProps, type FieldPropertyControlMode, type FieldState, type FieldTypeSelectOptionsConfig, type FieldTypeSelectOptionsContext, type FieldTypeSelectOptionsSorter, type FieldTypeSelectOptionsTransformer, type FieldTypeSelectSlotProps, FormBuilder, type FormBuilderActions, type FormBuilderComponents, type FormBuilderFeatures, type FormBuilderOptions, type FormBuilderProps, type FormBuilderResult, type FormBuilderSectionName, type FormBuilderSlots, type FormCompletionSlotProps, type FormContextValue, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type LocalizationSummaryContext, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type SelectComponentProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitContext, type SubmitResponse, type SubmitResult, type SubmitStatus, type UseSubmissionReceiptsResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts };

package/dist/index.d.ts CHANGED Viewed

@@ -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"];
@@ -192,6 +198,32 @@ interface BuilderSelectOption<T extends string = string> {
     readonly kind?: string;
     readonly metadata?: Readonly<Record<string, unknown>>;
 }
+type FieldPropertyControlMode = "editable" | "readOnly" | "hidden";
+interface FieldEditorControlsConfig {
+    readonly title?: FieldPropertyControlMode;
+    readonly description?: FieldPropertyControlMode;
+    readonly required?: FieldPropertyControlMode;
+    readonly typeSelect?: FieldPropertyControlMode;
+    readonly options?: FieldPropertyControlMode;
+    readonly displayConditions?: FieldPropertyControlMode;
+    readonly textLimits?: FieldPropertyControlMode;
+    readonly ratingBounds?: FieldPropertyControlMode;
+    readonly numberLimits?: FieldPropertyControlMode;
+}
+interface FieldTypeSelectOptionsContext {
+    readonly currentType: QuestionType;
+    readonly allowedTypes: readonly QuestionType[];
+}
+type FieldTypeSelectOptionsTransformer = (options: readonly BuilderSelectOption<QuestionType>[], context: FieldTypeSelectOptionsContext) => readonly BuilderSelectOption<QuestionType>[];
+type FieldTypeSelectOptionsSorter = (left: BuilderSelectOption<QuestionType>, right: BuilderSelectOption<QuestionType>, context: FieldTypeSelectOptionsContext) => number;
+interface FieldTypeSelectOptionsConfig {
+    /** Transform the generated choices. The returned array is used as-is. */
+    readonly transform?: FieldTypeSelectOptionsTransformer;
+    /** Sort generated choices after transform. The source array is never mutated. */
+    readonly sort?: FieldTypeSelectOptionsSorter;
+    /** Optional explicit order applied before `sort`. */
+    readonly order?: readonly QuestionType[];
+}
 interface SelectComponentProps<T extends string = string> extends Omit<InputComponentProps, "value" | "onChange"> {
     readonly value: T;
     readonly onChange: (value: T) => void;
@@ -278,6 +310,8 @@ interface BuilderFieldEditorSlotProps extends BuilderSlotBaseProps {
         readonly localization?: boolean;
         readonly conditions?: boolean;
     };
+    readonly fieldEditorControls?: FieldEditorControlsConfig;
+    readonly fieldTypeOptions?: FieldTypeSelectOptionsConfig;
     readonly slots?: Pick<FormBuilderSlots, "fieldTypeSelect" | "fieldEditorHeader">;
 }
 interface FieldTypeSelectSlotProps {
@@ -524,6 +558,8 @@ interface SubmissionProtectionProps {
 }
 type BeforeSubmit = (values: Readonly<Record<string, unknown>>) => "continue" | "cancel" | Promise<"continue" | "cancel">;
+declare function resolveFieldEditorControls(config?: FieldEditorControlsConfig): Required<FieldEditorControlsConfig>;
+declare function resolveFieldTypeSelectOptions(options: readonly BuilderSelectOption<QuestionType>[], config: FieldTypeSelectOptionsConfig | undefined, context: FieldTypeSelectOptionsContext): readonly BuilderSelectOption<QuestionType>[];
 declare function resolveInitialFieldType(defaultType?: QuestionType, allowedTypes?: readonly QuestionType[]): QuestionType | null;
 interface FormBuilderFeatures {
     readonly pages?: boolean;
@@ -547,13 +583,15 @@ interface FormBuilderProps {
     readonly createManualTranslationMetadata?: (context: ManualTranslationContext) => Readonly<Record<string, JsonValue>> | undefined;
     readonly readOnly?: boolean;
     readonly features?: FormBuilderFeatures;
+    readonly fieldEditorControls?: FieldEditorControlsConfig;
+    readonly fieldTypeOptions?: FieldTypeSelectOptionsConfig;
     readonly components?: FormBuilderComponents;
     readonly slots?: FormBuilderSlots;
     readonly sectionOrder?: readonly FormBuilderSectionName[];
     readonly disableDefaultStyles?: boolean;
     readonly unstyled?: boolean;
 }
-declare function FormBuilder({ schema, onChange, locale, translator, translationAdapter, translationOptions, onTranslationReport, policy, idFactory, factories, className, defaultFieldType, onActionError, createManualTranslationMetadata, readOnly, features, components: componentOverrides, slots, sectionOrder, disableDefaultStyles, unstyled }: FormBuilderProps): react.JSX.Element;
+declare function FormBuilder({ schema, onChange, locale, translator, translationAdapter, translationOptions, onTranslationReport, policy, idFactory, factories, className, defaultFieldType, onActionError, createManualTranslationMetadata, readOnly, features, fieldEditorControls, fieldTypeOptions, components: componentOverrides, slots, sectionOrder, disableDefaultStyles, unstyled }: FormBuilderProps): react.JSX.Element;
 type SubmitStatus = "idle" | "submitting" | "success" | "error";
 interface FormContextValue {
@@ -659,4 +697,4 @@ interface StandaloneFormRendererProps extends FormRendererPresentationProps {
 type FormRendererProps = FormRendererPresentationProps | StandaloneFormRendererProps;
 declare function FormRenderer(props: FormRendererProps): react.JSX.Element;
-export { BUILDER_TRANSLATION_ALIASES, BUILDER_TRANSLATION_KEYS, type BeforeSubmit, type BuilderActionContext, type BuilderActionError, type BuilderActionIconType, type BuilderActionResult, type BuilderButtonProps, type BuilderCheckboxProps, type BuilderErrorMessageProps, type BuilderFactories, type BuilderFieldEditorSlotProps, type BuilderFieldsetProps, type BuilderIconButtonProps, type BuilderIdKind, type BuilderLocalizationSlotProps, type BuilderOptionEditorSlotProps, type BuilderPagesSlotProps, type BuilderPolicy, type BuilderSectionProps, type BuilderSelectOption, type BuilderSelectProps, type BuilderSlotActions, type BuilderTextAreaProps, type BuilderTextInputProps, type BuilderTextTarget, type BuilderToolbarSlotProps, type BuilderTranslationActionsSlotProps, type BuilderTranslationKey, type ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldEditorHeaderSlotProps, type FieldState, type FieldTypeSelectSlotProps, FormBuilder, type FormBuilderActions, type FormBuilderComponents, type FormBuilderFeatures, type FormBuilderOptions, type FormBuilderProps, type FormBuilderResult, type FormBuilderSectionName, type FormBuilderSlots, type FormCompletionSlotProps, type FormContextValue, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type LocalizationSummaryContext, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type SelectComponentProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitContext, type SubmitResponse, type SubmitResult, type SubmitStatus, type UseSubmissionReceiptsResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts };
+export { BUILDER_TRANSLATION_ALIASES, BUILDER_TRANSLATION_KEYS, type BeforeSubmit, type BuilderActionContext, type BuilderActionError, type BuilderActionIconType, type BuilderActionResult, type BuilderButtonProps, type BuilderCheckboxProps, type BuilderErrorMessageProps, type BuilderFactories, type BuilderFieldEditorSlotProps, type BuilderFieldsetProps, type BuilderIconButtonProps, type BuilderIdKind, type BuilderLocalizationSlotProps, type BuilderOptionEditorSlotProps, type BuilderPagesSlotProps, type BuilderPolicy, type BuilderSectionProps, type BuilderSelectOption, type BuilderSelectProps, type BuilderSlotActions, type BuilderTextAreaProps, type BuilderTextInputProps, type BuilderTextTarget, type BuilderToolbarSlotProps, type BuilderTranslationActionsSlotProps, type BuilderTranslationKey, type ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldEditorControlsConfig, type FieldEditorHeaderSlotProps, type FieldPropertyControlMode, type FieldState, type FieldTypeSelectOptionsConfig, type FieldTypeSelectOptionsContext, type FieldTypeSelectOptionsSorter, type FieldTypeSelectOptionsTransformer, type FieldTypeSelectSlotProps, FormBuilder, type FormBuilderActions, type FormBuilderComponents, type FormBuilderFeatures, type FormBuilderOptions, type FormBuilderProps, type FormBuilderResult, type FormBuilderSectionName, type FormBuilderSlots, type FormCompletionSlotProps, type FormContextValue, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type LocalizationSummaryContext, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type SelectComponentProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitContext, type SubmitResponse, type SubmitResult, type SubmitStatus, type UseSubmissionReceiptsResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts };

package/dist/index.js CHANGED Viewed

@@ -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) => {
@@ -1257,6 +1329,34 @@ var FIELD_TYPES = [
   "checkbox",
   "radio"
 ];
+var DEFAULT_FIELD_EDITOR_CONTROL_MODE = "editable";
+function resolveFieldEditorControls(config = {}) {
+  return {
+    title: config.title ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    description: config.description ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    required: config.required ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    typeSelect: config.typeSelect ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    options: config.options ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    displayConditions: config.displayConditions ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    textLimits: config.textLimits ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    ratingBounds: config.ratingBounds ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE,
+    numberLimits: config.numberLimits ?? DEFAULT_FIELD_EDITOR_CONTROL_MODE
+  };
+}
+function resolveFieldTypeSelectOptions(options, config, context) {
+  let resolved = [...options];
+  if (config?.transform !== void 0) resolved = [...config.transform(resolved, context)];
+  if (config?.order !== void 0) {
+    const ranks = new Map(config.order.map((type, index) => [type, index]));
+    resolved.sort((left, right) => {
+      const leftRank = ranks.get(left.value) ?? config.order?.length ?? 0;
+      const rightRank = ranks.get(right.value) ?? config.order?.length ?? 0;
+      return leftRank - rightRank;
+    });
+  }
+  if (config?.sort !== void 0) resolved.sort((left, right) => config.sort?.(left, right, context) ?? 0);
+  return resolved;
+}
 var BUILDER_DEFAULTS = {
   "builder.formBuilder": "Form builder",
   "builder.basicSettings": "Basic settings",
@@ -1275,6 +1375,10 @@ var BUILDER_DEFAULTS = {
   "builder.required": "Required",
   "builder.minimum": "Minimum",
   "builder.maximum": "Maximum",
+  "builder.minimumLength": "Minimum length",
+  "builder.maximumLength": "Maximum length",
+  "builder.pattern": "Pattern",
+  "builder.step": "Step",
   "builder.options": "Options",
   "builder.optionLabel": "\u9078\u629E\u80A2 / Option Label {{index}}",
   "builder.optionLabelPlaceholder": "Example: Very satisfied",
@@ -1532,6 +1636,8 @@ function FormBuilder({
   createManualTranslationMetadata,
   readOnly = false,
   features,
+  fieldEditorControls,
+  fieldTypeOptions,
   components: componentOverrides,
   slots,
   sectionOrder,
@@ -2296,6 +2402,7 @@ function FormBuilder({
               }
             ) : null }),
             /* @__PURE__ */ jsx(BuilderSectionGroup, { name: "questions", children: /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__list"), children: schema.fields.map((field, index) => {
+              const controls = resolveFieldEditorControls(fieldEditorControls);
               const condition = field.displayCondition;
               const source = condition === void 0 ? void 0 : schema.fields.find((item) => item.id === condition.questionId);
               const availableSources = schema.fields.slice(0, index);
@@ -2311,6 +2418,8 @@ function FormBuilder({
                     ...slots === void 0 ? {} : { slots },
                     ...policy === void 0 ? {} : { policy },
                     ...features === void 0 ? {} : { features },
+                    ...fieldEditorControls === void 0 ? {} : { fieldEditorControls },
+                    ...fieldTypeOptions === void 0 ? {} : { fieldTypeOptions },
                     readOnly,
                     actions,
                     components
@@ -2372,7 +2481,7 @@ function FormBuilder({
                       }
                     ) }),
                     /* @__PURE__ */ jsxs("div", { className: builderClass("form-engine-builder__grid"), children: [
-                      /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
+                      controls.title === "hidden" ? null : /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
                         TextInput,
                         {
                           id: `builder-field-${field.id}-title`,
@@ -2384,34 +2493,56 @@ function FormBuilder({
                           "aria-describedby": field.title.trim().length === 0 ? `builder-field-${field.id}-title-error` : void 0,
                           value: field.title,
                           placeholder: translate("builder.questionTitlePlaceholder"),
+                          readOnly: controls.title === "readOnly",
                           onChange: (value) => updateField(field.id, (current) => ({
                             ...current,
                             title: value.trim().length === 0 ? current.title : value
                           }))
                         }
                       ) }),
-                      /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
+                      controls.typeSelect === "hidden" ? null : /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
                         Select,
                         {
                           id: `builder-field-${field.id}-type`,
                           label: translate("builder.type"),
                           value: field.type,
+                          disabled: controls.typeSelect === "readOnly",
                           onChange: (value) => changeType(field.id, value),
-                          options: FIELD_TYPES.filter(
-                            (type) => policy?.allowedFieldTypes === void 0 || policy.allowedFieldTypes.includes(type)
-                          ).map((type) => ({ value: type, label: translate(fieldTypeKey(type)) }))
+                          options: resolveFieldTypeSelectOptions(
+                            FIELD_TYPES.filter(
+                              (type) => policy?.allowedFieldTypes === void 0 || policy.allowedFieldTypes.includes(type)
+                            ).map((type) => ({ value: type, label: translate(fieldTypeKey(type)) })),
+                            fieldTypeOptions,
+                            { currentType: field.type, allowedTypes: policy?.allowedFieldTypes ?? FIELD_TYPES }
+                          )
                         }
                       ) }),
-                      /* @__PURE__ */ jsx(
+                      controls.required === "hidden" ? null : /* @__PURE__ */ jsx(
                         Checkbox,
                         {
                           className: builderClass("form-engine-builder__check"),
                           checked: field.required === true,
+                          disabled: controls.required === "readOnly",
                           onChange: (checked) => updateField(field.id, (current) => ({ ...current, required: checked })),
                           label: translate("builder.required")
                         }
                       )
                     ] }),
+                    controls.description === "hidden" ? null : /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
+                      TextArea,
+                      {
+                        id: `builder-field-${field.id}-description`,
+                        name: `fields.${field.id}.description`,
+                        label: translate("builder.description"),
+                        value: field.description ?? "",
+                        readOnly: controls.description === "readOnly",
+                        onChange: (value) => updateField(field.id, (current) => {
+                          if (value.length > 0) return { ...current, description: value };
+                          const { description: _description, ...remaining } = current;
+                          return remaining;
+                        })
+                      }
+                    ) }),
                     !pagesEnabled || schema.pages === void 0 ? null : /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
                       Select,
                       {
@@ -2447,12 +2578,13 @@ function FormBuilder({
                             })
                           }
                         ) }),
-                        /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
+                        controls.description === "hidden" ? null : /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
                           TextInput,
                           {
                             id: `builder-field-${field.id}-${editingLocale}-description`,
                             label: translate("builder.pageDescription"),
                             value: field.translations?.[editingLocale]?.description ?? "",
+                            readOnly: controls.description === "readOnly",
                             onChange: (value) => updateManualTranslation({
                               locale: editingLocale,
                               kind: "field",
@@ -2487,7 +2619,7 @@ function FormBuilder({
                         }
                       ) }, option.id)) : null
                     ] }),
-                    field.type === "rating" ? /* @__PURE__ */ jsxs("div", { className: builderClass("form-engine-builder__grid"), children: [
+                    field.type === "rating" && controls.ratingBounds !== "hidden" ? /* @__PURE__ */ jsxs("div", { className: builderClass("form-engine-builder__grid"), children: [
                       /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
                         TextInput,
                         {
@@ -2495,6 +2627,7 @@ function FormBuilder({
                           label: translate("builder.minimum"),
                           type: "number",
                           value: String(field.min ?? 1),
+                          readOnly: controls.ratingBounds === "readOnly",
                           onChange: (value) => {
                             const min = Number(value);
                             if (!Number.isInteger(min)) return;
@@ -2512,6 +2645,7 @@ function FormBuilder({
                           label: translate("builder.maximum"),
                           type: "number",
                           value: String(field.max ?? 5),
+                          readOnly: controls.ratingBounds === "readOnly",
                           onChange: (value) => {
                             const max = Number(value);
                             if (!Number.isInteger(max)) return;
@@ -2523,7 +2657,73 @@ function FormBuilder({
                         }
                       ) })
                     ] }) : null,
-                    "options" in field ? /* @__PURE__ */ jsxs("div", { className: builderClass("form-engine-builder__options"), children: [
+                    (field.type === "text" || field.type === "textarea") && controls.textLimits !== "hidden" ? /* @__PURE__ */ jsxs("div", { className: builderClass("form-engine-builder__grid"), children: [
+                      /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
+                        TextInput,
+                        {
+                          id: `builder-field-${field.id}-min-length`,
+                          label: translate("builder.minimumLength"),
+                          type: "number",
+                          value: field.minLength === void 0 ? "" : String(field.minLength),
+                          readOnly: controls.textLimits === "readOnly",
+                          onChange: (value) => updateField(field.id, (current) => {
+                            if (current.type !== "text" && current.type !== "textarea") return current;
+                            const parsed = value.trim().length === 0 ? void 0 : Number(value);
+                            return parsed === void 0 || !Number.isInteger(parsed) || parsed < 0 ? current : { ...current, minLength: parsed };
+                          })
+                        }
+                      ) }),
+                      /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
+                        TextInput,
+                        {
+                          id: `builder-field-${field.id}-max-length`,
+                          label: translate("builder.maximumLength"),
+                          type: "number",
+                          value: field.maxLength === void 0 ? "" : String(field.maxLength),
+                          readOnly: controls.textLimits === "readOnly",
+                          onChange: (value) => updateField(field.id, (current) => {
+                            if (current.type !== "text" && current.type !== "textarea") return current;
+                            const parsed = value.trim().length === 0 ? void 0 : Number(value);
+                            return parsed === void 0 || !Number.isInteger(parsed) || parsed < 0 ? current : { ...current, maxLength: parsed };
+                          })
+                        }
+                      ) }),
+                      /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
+                        TextInput,
+                        {
+                          id: `builder-field-${field.id}-pattern`,
+                          label: translate("builder.pattern"),
+                          value: field.pattern ?? "",
+                          readOnly: controls.textLimits === "readOnly",
+                          onChange: (value) => updateField(field.id, (current) => {
+                            if (current.type !== "text" && current.type !== "textarea") return current;
+                            return value.length === 0 ? current : { ...current, pattern: value };
+                          })
+                        }
+                      ) })
+                    ] }) : null,
+                    field.type === "number" && controls.numberLimits !== "hidden" ? /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__grid"), children: ["min", "max", "step"].map((property) => /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
+                      TextInput,
+                      {
+                        id: `builder-field-${field.id}-${property}`,
+                        label: translate(
+                          property === "step" ? "builder.step" : property === "min" ? "builder.minimum" : "builder.maximum"
+                        ),
+                        type: "number",
+                        value: field[property] === void 0 ? "" : String(field[property]),
+                        readOnly: controls.numberLimits === "readOnly",
+                        onChange: (value) => updateField(field.id, (current) => {
+                          if (current.type !== "number") return current;
+                          if (value.trim().length === 0) {
+                            const { [property]: _removed, ...remaining } = current;
+                            return remaining;
+                          }
+                          const parsed = Number(value);
+                          return Number.isFinite(parsed) ? { ...current, [property]: parsed } : current;
+                        })
+                      }
+                    ) }, property)) }) : null,
+                    "options" in field && controls.options !== "hidden" ? /* @__PURE__ */ jsxs("div", { className: builderClass("form-engine-builder__options"), children: [
                       /* @__PURE__ */ jsx("strong", { children: translate("builder.options") }),
                       field.options.map(
                         (option, optionIndex) => OptionEditorSlot === void 0 ? /* @__PURE__ */ jsxs("div", { className: builderClass("form-engine-builder__option"), children: [
@@ -2534,6 +2734,7 @@ function FormBuilder({
                               label: translate("builder.optionLabel", { index: optionIndex + 1 }),
                               value: option.label,
                               placeholder: translate("builder.optionLabelPlaceholder"),
+                              readOnly: controls.options === "readOnly",
                               onChange: (value) => value.trim().length === 0 ? void 0 : updateOption(field.id, option.id, value)
                             }
                           ),
@@ -2543,7 +2744,7 @@ function FormBuilder({
                               {
                                 actionType: "moveUp",
                                 title: translate("builder.moveUp", { title: option.label }),
-                                disabled: optionIndex === 0,
+                                disabled: controls.options === "readOnly" || optionIndex === 0,
                                 onClick: () => moveOption(field.id, option.id, optionIndex - 1)
                               }
                             ),
@@ -2552,7 +2753,7 @@ function FormBuilder({
                               {
                                 actionType: "moveDown",
                                 title: translate("builder.moveDown", { title: option.label }),
-                                disabled: optionIndex === field.options.length - 1,
+                                disabled: controls.options === "readOnly" || optionIndex === field.options.length - 1,
                                 onClick: () => moveOption(field.id, option.id, optionIndex + 1)
                               }
                             ),
@@ -2560,7 +2761,7 @@ function FormBuilder({
                               IconButton,
                               {
                                 actionType: "delete",
-                                disabled: field.options.length === 1,
+                                disabled: controls.options === "readOnly" || field.options.length === 1,
                                 onClick: () => removeOption(field.id, option.id),
                                 title: translate("builder.remove")
                               }
@@ -2578,7 +2779,7 @@ function FormBuilder({
                               onMoveUp: () => moveOption(field.id, option.id, optionIndex - 1),
                               onMoveDown: () => moveOption(field.id, option.id, optionIndex + 1),
                               onRemove: () => removeOption(field.id, option.id),
-                              readOnly,
+                              readOnly: readOnly || controls.options === "readOnly",
                               actions,
                               components
                             }
@@ -2592,7 +2793,7 @@ function FormBuilder({
                             index: optionIndex,
                             currentLocale: editingLocale,
                             translate,
-                            readOnly,
+                            readOnly: readOnly || controls.options === "readOnly",
                             actions,
                             components
                           },
@@ -2604,13 +2805,13 @@ function FormBuilder({
                         {
                           action: "addOption",
                           targetId: field.id,
-                          disabled: policy?.maxOptionsPerField !== void 0 && field.options.length >= policy.maxOptionsPerField,
+                          disabled: controls.options === "readOnly" || policy?.maxOptionsPerField !== void 0 && field.options.length >= policy.maxOptionsPerField,
                           onClick: () => addOption(field.id),
                           children: translate("builder.addOption")
                         }
                       )
                     ] }) : null,
-                    conditionsEnabled ? /* @__PURE__ */ jsxs("div", { className: builderClass("form-engine-builder__condition"), children: [
+                    conditionsEnabled && controls.displayConditions !== "hidden" ? /* @__PURE__ */ jsxs("div", { className: builderClass("form-engine-builder__condition"), children: [
                       /* @__PURE__ */ jsx("div", { className: builderClass("form-engine-builder__field"), children: /* @__PURE__ */ jsx(
                         Select,
                         {
@@ -3985,6 +4186,8 @@ export {
   createLocalStorageSubmissionAttemptStore,
   createLocalStorageSubmissionReceiptStore,
   isTranslationUnresolved,
+  resolveFieldEditorControls,
+  resolveFieldTypeSelectOptions,
   resolveInitialFieldType,
   resolveTranslation,
   submissionReceiptQueryKey,

package/package.json CHANGED Viewed

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