@dmitryvim/form-builder 0.5.2 → 0.5.4

package/dist/esm/index.js

@@ -15,6 +15,69 @@ function t(key, state, params) {
   return text;
 }
 
+// src/utils/helpers.ts
+function isElementReadonly(element, state, ctx) {
+  return element.readonly === true || state.config.readonly === true || ctx?.inheritedReadonly === true;
+}
+function isPlainObject(obj) {
+  return obj && typeof obj === "object" && obj.constructor === Object;
+}
+function escapeHtml(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function getElementLookupKey(element, state) {
+  if (element.key) {
+    return element.key;
+  }
+  const cached = state.syntheticElementIds.get(element);
+  if (cached !== void 0) {
+    return cached;
+  }
+  const id = `fb-synthetic-${state.syntheticElementIdCounter++}`;
+  state.syntheticElementIds.set(element, id);
+  return id;
+}
+function pathJoin(base, key) {
+  return base ? `${base}.${key}` : key;
+}
+function findDirectContainerRows(scopeRoot, containerPath) {
+  if (!containerPath) return [];
+  const all = scopeRoot.querySelectorAll("[data-container-item]");
+  return Array.from(all).filter((el) => {
+    const attr = el.getAttribute("data-container-item") || "";
+    if (!attr.startsWith(`${containerPath}[`)) return false;
+    return /^\[\d+\]$/.test(attr.slice(containerPath.length));
+  });
+}
+function clear(node) {
+  while (node.firstChild) node.removeChild(node.firstChild);
+}
+function formatFileSize(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function serializeHiddenValue(value) {
+  if (value === null || value === void 0) return "";
+  return JSON.stringify(value);
+}
+function deserializeHiddenValue(raw) {
+  if (raw === "") return null;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+}
+function createHiddenInput(name, value) {
+  const input = document.createElement("input");
+  input.type = "hidden";
+  input.name = name;
+  input.setAttribute("data-hidden-field", "true");
+  input.value = serializeHiddenValue(value);
+  return input;
+}
+
 // src/utils/validation.ts
 function addLengthHint(element, parts, state) {
   if (element.minLength != null || element.maxLength != null) {
@@ -184,6 +247,64 @@ function validateSchema(schema) {
       }
     }
   }
+  function validateCountBounds(element, elementPath, errors2) {
+    const el = element;
+    if (el.type === "group") {
+      if (!isPlainObject(el.repeat)) return;
+      checkBounds(
+        elementPath,
+        el.repeat?.min,
+        el.repeat?.max,
+        "repeat.min",
+        "repeat.max",
+        el.required === true,
+        errors2
+      );
+      return;
+    }
+    const isMultiple = el.multiple === true || el.type === "files";
+    if (!isMultiple) return;
+    checkBounds(
+      elementPath,
+      el.minCount,
+      el.maxCount,
+      "minCount",
+      "maxCount",
+      el.required === true,
+      errors2
+    );
+  }
+  function checkBounds(elementPath, minCount, maxCount, minName, maxName, requiredImpliesFloor, errors2) {
+    for (const [name, bound] of [
+      [minName, minCount],
+      [maxName, maxCount]
+    ]) {
+      if (bound !== void 0 && typeof bound !== "number") {
+        errors2.push(
+          `${elementPath}: ${name} must be a number (got ${typeof bound})`
+        );
+      }
+    }
+    const min = typeof minCount === "number" ? minCount : void 0;
+    const max = typeof maxCount === "number" ? maxCount : void 0;
+    if (max !== void 0 && (max < 0 || Number.isNaN(max))) {
+      errors2.push(
+        `${elementPath}: ${maxName} must be a non-negative number or Infinity (got ${max})`
+      );
+    }
+    if (min !== void 0 && (min < 0 || !Number.isFinite(min))) {
+      errors2.push(
+        `${elementPath}: ${minName} must be a finite non-negative number (got ${min})`
+      );
+    }
+    const effectiveMin = min ?? (requiredImpliesFloor ? 1 : void 0);
+    if (effectiveMin !== void 0 && max !== void 0 && effectiveMin > max) {
+      const shown = min !== void 0 ? `${minName} (${min})` : `required: true (implies ${minName} 1)`;
+      errors2.push(
+        `${elementPath}: ${shown} cannot be greater than ${maxName} (${max})`
+      );
+    }
+  }
   function validateElements(elements, path) {
     elements.forEach((element, index) => {
       const elementPath = `${path}[${index}]`;
@@ -193,6 +314,15 @@ function validateSchema(schema) {
       if (!element.key && element.type !== "markdown") {
         errors.push(`${elementPath}: missing key`);
       }
+      validateCountBounds(element, elementPath, errors);
+      if (element.type === "number" && "decimals" in element) {
+        const decimals = element.decimals;
+        if (decimals !== void 0 && (!Number.isInteger(decimals) || decimals < 0)) {
+          errors.push(
+            `${elementPath}: decimals must be a non-negative integer (got ${JSON.stringify(decimals)})`
+          );
+        }
+      }
       if (element.type === "markdown") {
         const content = element.content;
         if (typeof content !== "string") {
@@ -273,71 +403,6 @@ function validateSchema(schema) {
   return errors;
 }
 
-// src/utils/helpers.ts
-function isElementReadonly(element, state, ctx) {
-  return element.readonly === true || state.config.readonly === true || ctx?.inheritedReadonly === true;
-}
-function isPlainObject(obj) {
-  return obj && typeof obj === "object" && obj.constructor === Object;
-}
-function escapeHtml(text) {
-  const div = document.createElement("div");
-  div.textContent = text;
-  return div.innerHTML;
-}
-function getElementLookupKey(element, state) {
-  if (element.key) {
-    return element.key;
-  }
-  const cached = state.syntheticElementIds.get(element);
-  if (cached !== void 0) {
-    return cached;
-  }
-  const id = `fb-synthetic-${state.syntheticElementIdCounter++}`;
-  state.syntheticElementIds.set(element, id);
-  return id;
-}
-function pathJoin(base, key) {
-  return base ? `${base}.${key}` : key;
-}
-function findDirectContainerRows(scopeRoot, containerPath) {
-  if (!containerPath) return [];
-  const all = scopeRoot.querySelectorAll("[data-container-item]");
-  return Array.from(all).filter((el) => {
-    const attr = el.getAttribute("data-container-item") || "";
-    if (!attr.startsWith(`${containerPath}[`)) return false;
-    return /^\[\d+\]$/.test(attr.slice(containerPath.length));
-  });
-}
-function clear(node) {
-  while (node.firstChild) node.removeChild(node.firstChild);
-}
-function formatFileSize(bytes) {
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
-function serializeHiddenValue(value) {
-  if (value === null || value === void 0) return "";
-  return typeof value === "object" ? JSON.stringify(value) : String(value);
-}
-function deserializeHiddenValue(raw) {
-  if (raw === "") return null;
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return raw;
-  }
-}
-function createHiddenInput(name, value) {
-  const input = document.createElement("input");
-  input.type = "hidden";
-  input.name = name;
-  input.setAttribute("data-hidden-field", "true");
-  input.value = serializeHiddenValue(value);
-  return input;
-}
-
 // src/utils/enable-conditions.ts
 function getValueByPath(data, path) {
   if (!data || typeof data !== "object") {
@@ -884,7 +949,7 @@ function renderTextElement(element, ctx, wrapper, pathKey) {
     overflow-wrap: anywhere;
   `;
   textInput.name = pathKey;
-  textInput.placeholder = element.placeholder ?? "\u0412\u0432\u0435\u0434\u0438\u0442\u0435 \u0442\u0435\u043A\u0441\u0442";
+  textInput.placeholder = element.placeholder ?? t("placeholderText", state);
   textInput.value = ctx.prefill[element.key] || element.default || "";
   textInput.readOnly = readonly;
   applySingleLineMode(textInput);
@@ -996,6 +1061,7 @@ function renderMultipleTextElement(element, ctx, wrapper, pathKey) {
         updateIndices();
         updateAddButton();
         updateRemoveButtons();
+        ctx.instance?.triggerOnChange(pathKey);
       };
       chip.appendChild(rem);
     }
@@ -1020,6 +1086,7 @@ function renderMultipleTextElement(element, ctx, wrapper, pathKey) {
         addChip(element.default || "");
         updateAddButton();
         updateRemoveButtons();
+        ctx.instance?.triggerOnChange(pathKey);
       },
       { label: element.addLabel }
     );
@@ -1133,7 +1200,7 @@ function validateTextElement(element, key, context) {
     }
     return { value: values, errors };
   } else {
-    const input = scopeRoot.querySelector(`[name$="${key}"]`);
+    const input = scopeRoot.querySelector(`[name="${key}"]`);
     const val = input?.value ?? "";
     if (!skipValidation && element.required && val === "") {
       const msg = t("required", context.state);
@@ -1303,6 +1370,7 @@ function renderMultipleTextareaElement(element, ctx, wrapper, pathKey) {
             updateIndices();
             updateAddButton();
             updateRemoveButtons();
+            ctx.instance?.triggerOnChange(pathKey);
           }
         };
         item.appendChild(removeBtn);
@@ -1322,6 +1390,7 @@ function renderMultipleTextareaElement(element, ctx, wrapper, pathKey) {
         addTextareaItem(element.default || "");
         updateAddButton();
         updateRemoveButtons();
+        ctx.instance?.triggerOnChange(pathKey);
       },
       { label: element.addLabel }
     );
@@ -1613,6 +1682,7 @@ function renderMultipleNumberElement(element, ctx, wrapper, pathKey) {
             updateIndices();
             updateAddButton();
             updateRemoveButtons();
+            ctx.instance?.triggerOnChange(pathKey);
           }
         };
         item.appendChild(removeBtn);
@@ -1632,6 +1702,7 @@ function renderMultipleNumberElement(element, ctx, wrapper, pathKey) {
         addNumberItem(element.default || "");
         updateAddButton();
         updateRemoveButtons();
+        ctx.instance?.triggerOnChange(pathKey);
       },
       { label: element.addLabel }
     );
@@ -1720,8 +1791,7 @@ function validateNumberElement(element, key, context) {
         return;
       }
       validateNumberInput(input, v, `${key}[${index}]`);
-      const d = Number.isInteger(element.decimals ?? 0) ? element.decimals ?? 0 : 0;
-      values.push(Number(v.toFixed(d)));
+      values.push(applyDecimals(v, element.decimals));
     });
     if (!skipValidation) {
       const { state } = context;
@@ -1740,7 +1810,7 @@ function validateNumberElement(element, key, context) {
     }
     return { value: values, errors };
   } else {
-    const input = scopeRoot.querySelector(`[name$="${key}"]`);
+    const input = scopeRoot.querySelector(`[name="${key}"]`);
     const raw = input?.value ?? "";
     const { state } = context;
     if (!skipValidation && element.required && raw === "") {
@@ -1761,10 +1831,13 @@ function validateNumberElement(element, key, context) {
       return { value: null, errors };
     }
     validateNumberInput(input, v, key);
-    const d = Number.isInteger(element.decimals ?? 0) ? element.decimals ?? 0 : 0;
-    return { value: Number(v.toFixed(d)), errors };
+    return { value: applyDecimals(v, element.decimals), errors };
   }
 }
+function applyDecimals(v, decimals) {
+  if (!Number.isInteger(decimals) || decimals < 0) return v;
+  return Number(v.toFixed(decimals));
+}
 function updateNumberField(element, fieldPath, value, context) {
   const { scopeRoot } = context;
   if (element.multiple) {
@@ -1917,6 +1990,7 @@ function renderMultipleSelectElement(element, ctx, wrapper, pathKey) {
             updateIndices();
             updateAddButton();
             updateRemoveButtons();
+            ctx.instance?.triggerOnChange(pathKey);
           }
         };
         item.appendChild(removeBtn);
@@ -1937,6 +2011,7 @@ function renderMultipleSelectElement(element, ctx, wrapper, pathKey) {
         addSelectItem(defaultValue);
         updateAddButton();
         updateRemoveButtons();
+        ctx.instance?.triggerOnChange(pathKey);
       },
       { label: element.addLabel }
     );
@@ -2022,7 +2097,7 @@ function validateSelectElement(element, key, context) {
     return { value: values, errors };
   } else {
     const input = scopeRoot.querySelector(
-      `[name$="${key}"]`
+      `[name="${key}"]`
     );
     const val = input?.value ?? "";
     if (!skipValidation && element.required && val === "") {
@@ -2354,6 +2429,7 @@ function renderMultipleSwitcherElement(element, ctx, wrapper, pathKey) {
             updateIndices();
             updateAddButton();
             updateRemoveButtons();
+            ctx.instance?.triggerOnChange(pathKey);
           }
         };
         item.appendChild(removeBtn);
@@ -2374,6 +2450,7 @@ function renderMultipleSwitcherElement(element, ctx, wrapper, pathKey) {
         addSwitcherItem(defaultValue);
         updateAddButton();
         updateRemoveButtons();
+        ctx.instance?.triggerOnChange(pathKey);
       },
       { label: element.addLabel }
     );
@@ -2468,7 +2545,7 @@ function validateSwitcherElement(element, key, context) {
     return { value: values, errors };
   } else {
     const input = scopeRoot.querySelector(
-      `input[type="hidden"][name$="${key}"]`
+      `input[type="hidden"][name="${key}"]`
     );
     const val = input?.value ?? "";
     if (!skipValidation && element.required && val === "") {
@@ -5510,7 +5587,7 @@ function validateSingleFile(element, key, context) {
   const { scopeRoot, skipValidation, state } = context;
   const errors = [];
   const input = scopeRoot.querySelector(
-    `input[name$="${key}"][type="hidden"]`
+    `input[name="${key}"][type="hidden"]`
   );
   const rid = input?.value ?? "";
   if (!skipValidation && element.required && rid === "") {
@@ -5942,6 +6019,7 @@ function renderMultipleColourElement(element, ctx, wrapper, pathKey) {
             updateIndices();
             updateAddButton();
             updateRemoveButtons();
+            ctx.instance?.triggerOnChange(pathKey);
           }
         };
         item.appendChild(removeBtn);
@@ -5962,6 +6040,7 @@ function renderMultipleColourElement(element, ctx, wrapper, pathKey) {
         addColourItem(defaultColour);
         updateAddButton();
         updateRemoveButtons();
+        ctx.instance?.triggerOnChange(pathKey);
       },
       { label: element.addLabel }
     );
@@ -6398,6 +6477,7 @@ function renderMultipleSliderElement(element, ctx, wrapper, pathKey) {
             updateIndices();
             updateAddButton();
             updateRemoveButtons();
+            ctx.instance?.triggerOnChange(pathKey);
           }
         };
         item.appendChild(removeBtn);
@@ -6417,6 +6497,7 @@ function renderMultipleSliderElement(element, ctx, wrapper, pathKey) {
         addSliderItem(defaultValue);
         updateAddButton();
         updateRemoveButtons();
+        ctx.instance?.triggerOnChange(pathKey);
       },
       { label: element.addLabel }
     );
@@ -6684,6 +6765,8 @@ function extractRootFormData(formRoot) {
           if (input.checked) {
             data[fieldName] = input.value;
           }
+        } else if (input.dataset.hiddenField) {
+          data[fieldName] = deserializeHiddenValue(input.value);
         } else {
           data[fieldName] = input.value;
         }
@@ -6772,11 +6855,14 @@ function getChildWrapperClass(columns) {
   const cols = columns || 1;
   return cols === 1 ? "fb-row" : `grid grid-cols-${cols} gap-2`;
 }
-function mountRemoveButton(item, onRemove, state) {
+function mountRemoveButton(item, onRemove, state, containerLabel) {
   const rem = document.createElement("button");
   rem.type = "button";
   rem.className = "fb-item-remove";
-  rem.setAttribute("aria-label", t("removeElement", state));
+  rem.setAttribute(
+    "aria-label",
+    containerLabel ? t("removeRowFrom", state, { label: containerLabel }) : t("removeRow", state)
+  );
   rem.style.cssText = `
     width: 24px;
     height: 24px;
@@ -6799,7 +6885,7 @@ function mountRemoveButton(item, onRemove, state) {
   item.classList.add("fb-row-removable");
   item.insertBefore(rem, item.firstChild);
 }
-function renderMultipleContainerElement(element, ctx, wrapper, _pathKey) {
+function renderMultipleContainerElement(element, ctx, wrapper, pathKey) {
   const state = ctx.state;
   const containerIsReadonly = isElementReadonly(element, state, ctx);
   const childInheritedReadonly = containerIsReadonly || ctx.inheritedReadonly;
@@ -6832,6 +6918,7 @@ function renderMultipleContainerElement(element, ctx, wrapper, _pathKey) {
     if (countItems() <= min) return;
     item.remove();
     updateAddButton();
+    ctx.instance?.triggerOnChange(pathKey);
   };
   const createContainerItem = (idx, rowPrefill, formData) => {
     const subCtx = {
@@ -6864,7 +6951,12 @@ function renderMultipleContainerElement(element, ctx, wrapper, _pathKey) {
     });
     item.appendChild(childWrapper);
     if (!containerIsReadonly) {
-      mountRemoveButton(item, () => handleRemoveItem(item), state);
+      mountRemoveButton(
+        item,
+        () => handleRemoveItem(item),
+        state,
+        element.label
+      );
     }
     return item;
   };
@@ -6883,6 +6975,7 @@ function renderMultipleContainerElement(element, ctx, wrapper, _pathKey) {
       itemsWrap.appendChild(item);
     }
     updateAddButton();
+    ctx.instance?.triggerOnChange(pathKey);
   };
   let slideAddTile = null;
   let slideAddUpdate = null;
@@ -7027,7 +7120,7 @@ function validateContainerElement(element, key, context) {
         );
         if (childResult.spread && childResult.value !== null && typeof childResult.value === "object") {
           Object.assign(itemData, childResult.value);
-        } else {
+        } else if (!childResult.skip && child.key) {
           itemData[child.key] = childResult.value;
         }
       });
@@ -7068,7 +7161,7 @@ function validateContainerElement(element, key, context) {
         );
         if (childResult.spread && childResult.value !== null && typeof childResult.value === "object") {
           Object.assign(containerData, childResult.value);
-        } else {
+        } else if (!childResult.skip && child.key) {
           containerData[child.key] = childResult.value;
         }
       }
@@ -7088,11 +7181,13 @@ function updateContainerField(element, fieldPath, value, context) {
       );
       return;
     }
+    const rows = findDirectContainerRows(scopeRoot, fieldPath);
     value.forEach((itemValue, index) => {
-      if (isPlainObject(itemValue)) {
+      const rowPath = rows[index]?.getAttribute("data-container-item");
+      if (isPlainObject(itemValue) && rowPath) {
         element.elements.forEach((childElement) => {
           if (childElement.type === "markdown" || !childElement.key) return;
-          const childPath = `${fieldPath}[${index}].${childElement.key}`;
+          const childPath = `${rowPath}.${childElement.key}`;
           if (childElement.type === "richinput" && childElement.flatOutput) {
             const richChild = childElement;
             const textKey = richChild.textKey ?? "text";
@@ -7115,10 +7210,9 @@ function updateContainerField(element, fieldPath, value, context) {
         });
       }
     });
-    const existingContainers = findDirectContainerRows(scopeRoot, fieldPath);
-    if (value.length !== existingContainers.length) {
+    if (value.length !== rows.length) {
       console.warn(
-        `updateContainerField: Multiple container field "${fieldPath}" item count mismatch. Consider re-rendering for add/remove.`
+        `updateContainerField: Multiple container field "${fieldPath}" received ${value.length} items for ${rows.length} rendered rows. Rows are not added or removed here \u2014 re-render for add/remove.`
       );
     }
   } else {
@@ -7175,7 +7269,7 @@ function renderGroupElement(element, ctx, wrapper, pathKey) {
     maxCount: element.repeat?.max
   };
   if (containerElement.multiple) {
-    renderMultipleContainerElement(containerElement, ctx, wrapper);
+    renderMultipleContainerElement(containerElement, ctx, wrapper, pathKey);
   } else {
     renderSingleContainerElement(containerElement, ctx, wrapper, pathKey);
   }
@@ -10172,15 +10266,19 @@ var componentRegistry = {
 function getComponentOperations(elementType) {
   return componentRegistry[elementType] || null;
 }
+function resolveOperations(element) {
+  const isHiddenField = element.type !== "markdown" && (element.type === "hidden" || Boolean(element.hidden));
+  return isHiddenField ? componentRegistry.hidden : getComponentOperations(element.type);
+}
 function validateElementWithComponent(element, key, context) {
-  const ops = getComponentOperations(element.type);
+  const ops = resolveOperations(element);
   if (ops && ops.validate) {
     return ops.validate(element, key, context);
   }
   return null;
 }
 function updateElementWithComponent(element, fieldPath, value, context) {
-  const ops = getComponentOperations(element.type);
+  const ops = resolveOperations(element);
   if (ops && ops.update) {
     ops.update(element, fieldPath, value, context);
     return true;
@@ -10192,6 +10290,10 @@ function updateElementWithComponent(element, fieldPath, value, context) {
 function showTooltip(tooltipId, button) {
   const tooltip = document.getElementById(tooltipId);
   if (!tooltip) return;
+  if (!button.isConnected) {
+    tooltip.remove();
+    return;
+  }
   const isCurrentlyVisible = !tooltip.classList.contains("hidden");
   document.querySelectorAll('[id^="tooltip-"]').forEach((t2) => {
     t2.classList.add("hidden");
@@ -10281,6 +10383,8 @@ function extractDOMValue(fieldPath, formRoot) {
         `[name="${fieldPath}"]:checked`
       );
       return checked ? checked.value : void 0;
+    } else if (input.dataset.hiddenField) {
+      return deserializeHiddenValue(input.value);
     } else {
       return input.value;
     }
@@ -10416,7 +10520,7 @@ function createFieldLabel(element) {
   }
   return title;
 }
-function createInfoButton(element) {
+function createInfoButton(element, state) {
   const infoBtn = document.createElement("button");
   infoBtn.type = "button";
   infoBtn.className = "ml-2 text-gray-400 hover:text-gray-600";
@@ -10428,6 +10532,7 @@ function createInfoButton(element) {
   tooltip.style.position = "fixed";
   tooltip.textContent = element.description || element.hint || "Field information";
   document.body.appendChild(tooltip);
+  state.tooltipElements.add(tooltip);
   infoBtn.onclick = (e) => {
     e.preventDefault();
     e.stopPropagation();
@@ -10435,7 +10540,7 @@ function createInfoButton(element) {
   };
   return infoBtn;
 }
-function createLabelContainer(element) {
+function createLabelContainer(element, state) {
   const label = document.createElement("div");
   label.className = "flex items-center";
   label.style.marginBottom = "var(--fb-label-margin-bottom, 2px)";
@@ -10443,7 +10548,7 @@ function createLabelContainer(element) {
   const title = createFieldLabel(element);
   label.appendChild(title);
   if (element.description || element.hint) {
-    const infoBtn = createInfoButton(element);
+    const infoBtn = createInfoButton(element, state);
     label.appendChild(infoBtn);
   }
   return label;
@@ -10518,7 +10623,7 @@ function dispatchToRenderer(element, ctx, wrapper, pathKey) {
       break;
     case "container":
       if (isMultiple) {
-        renderMultipleContainerElement(element, ctx, wrapper);
+        renderMultipleContainerElement(element, ctx, wrapper, pathKey);
       } else {
         renderSingleContainerElement(element, ctx, wrapper, pathKey);
       }
@@ -10571,7 +10676,7 @@ function renderElement2(element, ctx) {
   wrapper.setAttribute("data-fb-width", element.width || "full");
   const ops = getComponentOperations(element.type);
   if (!ops?.ownsLabel) {
-    const label = createLabelContainer(element);
+    const label = createLabelContainer(element, ctx.state);
     wrapper.appendChild(label);
   }
   const pathKey = pathJoin(ctx.path, element.key);
@@ -10610,6 +10715,8 @@ var defaultConfig = {
     en: {
       // UI texts
       removeElement: "Remove",
+      removeRow: "Remove row",
+      removeRowFrom: "Remove row from {label}",
       clickDragText: "Click or drag file",
       clickDragTextMultiple: "Click or drag files",
       noFileSelected: "No file selected",
@@ -10683,6 +10790,8 @@ var defaultConfig = {
     ru: {
       // UI texts
       removeElement: "\u0423\u0434\u0430\u043B\u0438\u0442\u044C",
+      removeRow: "\u0423\u0434\u0430\u043B\u0438\u0442\u044C \u0441\u0442\u0440\u043E\u043A\u0443",
+      removeRowFrom: "\u0423\u0434\u0430\u043B\u0438\u0442\u044C \u0441\u0442\u0440\u043E\u043A\u0443 \u0438\u0437 \xAB{label}\xBB",
       clickDragText: "\u041D\u0430\u0436\u043C\u0438\u0442\u0435 \u0438\u043B\u0438 \u043F\u0435\u0440\u0435\u0442\u0430\u0449\u0438\u0442\u0435 \u0444\u0430\u0439\u043B",
       clickDragTextMultiple: "\u041D\u0430\u0436\u043C\u0438\u0442\u0435 \u0438\u043B\u0438 \u043F\u0435\u0440\u0435\u0442\u0430\u0449\u0438\u0442\u0435 \u0444\u0430\u0439\u043B\u044B",
       noFileSelected: "\u0424\u0430\u0439\u043B \u043D\u0435 \u0432\u044B\u0431\u0440\u0430\u043D",
@@ -10785,7 +10894,8 @@ function createInstanceState(config) {
     prefill: {},
     syntheticElementIds: /* @__PURE__ */ new WeakMap(),
     syntheticElementIdCounter: 0,
-    enableIfObservers: /* @__PURE__ */ new Set()
+    enableIfObservers: /* @__PURE__ */ new Set(),
+    tooltipElements: /* @__PURE__ */ new Set()
   };
 }
 function generateInstanceId() {
@@ -11072,6 +11182,18 @@ var exampleThemes = {
 };
 
 // src/instance/FormBuilderInstance.ts
+function findOwnField(scope, lookupKey, ownBoundary) {
+  const matches = scope.querySelectorAll(
+    `[data-field-key="${lookupKey}"]`
+  );
+  for (const el of Array.from(matches)) {
+    const boundary = el.closest(
+      "[data-container-item], [data-container]"
+    );
+    if (boundary === ownBoundary) return el;
+  }
+  return null;
+}
 var FormBuilderInstance = class {
   constructor(config) {
     this.instanceId = generateInstanceId();
@@ -11153,7 +11275,11 @@ var FormBuilderInstance = class {
   /**
    * Trigger onChange callbacks with debouncing
    * @param fieldPath - Optional field path for field-specific change events
-   * @param fieldValue - Optional field value for field-specific change events
+   * @param fieldValue - Optional field value for field-specific change events.
+   *   When omitted while fieldPath is given, the value is read from the
+   *   freshly extracted form data at debounce time — used by structural
+   *   changes (multi-item add/remove), where the handler has no cheap
+   *   current value but the array is trivially derivable after the fact.
    */
   triggerOnChange(fieldPath, fieldValue) {
     if (this.state.config.readonly) return;
@@ -11166,12 +11292,49 @@ var FormBuilderInstance = class {
       if (this.state.config.onChange) {
         this.state.config.onChange(formData);
       }
-      if (this.state.config.onFieldChange && fieldPath !== void 0 && fieldValue !== void 0) {
-        this.state.config.onFieldChange(fieldPath, fieldValue, formData);
+      if (this.state.config.onFieldChange && fieldPath !== void 0) {
+        const resolvedValue = fieldValue !== void 0 ? fieldValue : this.resolveDomPathValue(formData.data, fieldPath);
+        this.state.config.onFieldChange(fieldPath, resolvedValue, formData);
       }
       this.state.debounceTimer = null;
     }, this.state.config.debounceMs);
   }
+  /**
+   * Resolve a DOM field path against the extracted form data.
+   *
+   * A plain getValueByPath is wrong for paths inside a multiple container:
+   * row markers keep gaps after a deletion (`s[2]` may be the first surviving
+   * row) while the extracted array is re-packed contiguously — the naive
+   * lookup would read a different row, or nothing. Each `[N]` segment is
+   * mapped from its marker to the row's position among the container's
+   * rendered rows, the same DOM order extraction used to build the array.
+   * A bracketed segment that is not a container marker (a multi-value leaf
+   * like `tags[1]`, whose indices are contiguous) falls back to the index.
+   */
+  resolveDomPathValue(data, domPath) {
+    let cur = data;
+    let domPrefix = "";
+    for (const seg of domPath.split(".")) {
+      if (cur === null || cur === void 0) return void 0;
+      const marker = seg.match(/^(.+)\[(\d+)\]$/);
+      if (!marker) {
+        domPrefix = domPrefix ? `${domPrefix}.${seg}` : seg;
+        cur = cur[seg];
+        continue;
+      }
+      const key = marker[1];
+      domPrefix = domPrefix ? `${domPrefix}.${key}` : key;
+      const arr = cur[key];
+      if (!Array.isArray(arr)) return void 0;
+      const rows = this.state.formRoot ? findDirectContainerRows(this.state.formRoot, domPrefix) : [];
+      domPrefix = `${domPrefix}[${marker[2]}]`;
+      const pos = rows.findIndex(
+        (row) => row.getAttribute("data-container-item") === domPrefix
+      );
+      cur = pos >= 0 ? arr[pos] : arr[parseInt(marker[2], 10)];
+    }
+    return cur;
+  }
   /**
    * Register an external action that will be displayed as a button
    * External actions can be form-level (no related_field) or field-level (with related_field)
@@ -11211,21 +11374,10 @@ var FormBuilderInstance = class {
    */
   findFormElementByFieldPath(fieldPath) {
     if (!this.state.formRoot) return null;
-    let element = this.state.formRoot.querySelector(
+    const element = this.state.formRoot.querySelector(
       `[name="${fieldPath}"]`
     );
     if (element) return element;
-    const variations = [
-      fieldPath,
-      fieldPath.replace(/\[(\d+)\]/g, "[$1]"),
-      fieldPath.replace(/\./g, "[") + "]".repeat((fieldPath.match(/\./g) || []).length)
-    ];
-    for (const variation of variations) {
-      element = this.state.formRoot.querySelector(
-        `[name="${variation}"]`
-      );
-      if (element) return element;
-    }
     const schemaElement = this.findSchemaElement(fieldPath);
     if (!schemaElement) return null;
     const fieldWrappers = this.state.formRoot.querySelectorAll(".fb-field-wrapper");
@@ -11475,6 +11627,7 @@ var FormBuilderInstance = class {
       return;
     }
     this.disconnectEnableIfObservers();
+    this.removeTooltipElements();
     this.state.formRoot = root;
     this.state.schema = schema;
     this.state.externalActions = actions || null;
@@ -11574,24 +11727,12 @@ var FormBuilderInstance = class {
       if (element.type === "markdown") {
         return;
       }
-      if (element.hidden || element.type === "hidden") {
-        const hiddenInput = this.state.formRoot.querySelector(
-          `input[type="hidden"][data-hidden-field="true"][name="${element.key}"]`
-        );
-        const raw = hiddenInput?.value ?? "";
-        if (raw !== "") {
-          data[element.key] = deserializeHiddenValue(raw);
-        } else {
-          data[element.key] = element.default !== void 0 ? element.default : null;
-        }
-      } else {
-        const result = validateElement2(element, { path: "" });
-        if (result.skip) return;
-        if (result.spread && result.value !== null && typeof result.value === "object") {
-          Object.assign(data, result.value);
-        } else if (element.key) {
-          data[element.key] = result.value;
-        }
+      const result = validateElement2(element, { path: "" });
+      if (result.skip) return;
+      if (result.spread && result.value !== null && typeof result.value === "object") {
+        Object.assign(data, result.value);
+      } else if (element.key) {
+        data[element.key] = result.value;
       }
     });
     return {
@@ -11794,28 +11935,28 @@ var FormBuilderInstance = class {
     const formRoot = this.state.formRoot;
     const lookupKey = getElementLookupKey(element, this.state);
     if (!currentPath) {
-      return formRoot.querySelector(`[data-field-key="${lookupKey}"]`);
+      return findOwnField(formRoot, lookupKey, null);
     }
     const pathMatch = currentPath.match(/^(.+)\[(\d+)\]$/);
     if (pathMatch) {
       const containerEl2 = formRoot.querySelector(
         `[data-container-item="${pathMatch[1]}[${pathMatch[2]}]"]`
       );
-      return containerEl2 ? containerEl2.querySelector(`[data-field-key="${lookupKey}"]`) : null;
+      return containerEl2 ? findOwnField(containerEl2, lookupKey, containerEl2) : null;
     }
     const containerEl = formRoot.querySelector(
       `[data-container="${currentPath}"]`
     );
-    return containerEl ? containerEl.querySelector(`[data-field-key="${lookupKey}"]`) : null;
+    return containerEl ? findOwnField(containerEl, lookupKey, containerEl) : null;
   }
   /**
    * Apply enableIf show/hide logic to a single field wrapper.
    * Extracted to reduce cyclomatic complexity of checkElements.
    */
-  applyEnableIfVisibility(element, wrapper, currentPath, fullPath, formData) {
+  applyEnableIfVisibility(element, wrapper, domPath, dataPath, fullDomPath, formData) {
     try {
       const scope = element.enableIf.scope ?? "relative";
-      const containerData = scope === "relative" && currentPath ? getValueByPath(formData, currentPath) : void 0;
+      const containerData = scope === "relative" && dataPath ? getValueByPath(formData, dataPath) : void 0;
       const shouldEnable = evaluateEnableCondition(
         element.enableIf,
         formData,
@@ -11823,10 +11964,12 @@ var FormBuilderInstance = class {
       );
       const isCurrentlyDisabled = wrapper.getAttribute("data-conditionally-disabled") === "true";
       if (shouldEnable && isCurrentlyDisabled) {
-        const containerPrefill = currentPath ? getValueByPath(formData, currentPath) : formData;
+        const containerPrefill = dataPath ? getValueByPath(formData, dataPath) : formData;
         const prefillContext = containerPrefill && typeof containerPrefill === "object" ? containerPrefill : {};
         const newWrapper = renderElement2(element, {
-          path: currentPath,
+          // DOM path: the re-rendered control's `name` must match the row it
+          // lives in, not the row's position in the extracted array.
+          path: domPath,
           prefill: prefillContext,
           formData,
           state: this.state,
@@ -11846,7 +11989,7 @@ var FormBuilderInstance = class {
       }
     } catch (error) {
       console.error(
-        `Error re-evaluating enableIf for field "${element.key ?? "<no key>"}" at path "${fullPath}":`,
+        `Error re-evaluating enableIf for field "${element.key ?? "<no key>"}" at path "${fullDomPath}":`,
         error
       );
     }
@@ -11858,39 +12001,46 @@ var FormBuilderInstance = class {
   reevaluateConditionalFields() {
     if (!this.state.schema || !this.state.formRoot) return;
     const formData = this.validateForm(true).data;
-    const checkElements = (elements, currentPath) => {
+    const checkElements = (elements, domPath, dataPath) => {
       elements.forEach((element) => {
-        const fullPath = currentPath ? `${currentPath}.${element.key ?? ""}` : element.key ?? "";
+        const key = element.key ?? "";
+        const fullDomPath = domPath ? `${domPath}.${key}` : key;
+        const fullDataPath = dataPath ? `${dataPath}.${key}` : key;
         if (element.enableIf) {
-          const fieldWrapper = this.findFieldWrapper(element, currentPath);
+          const fieldWrapper = this.findFieldWrapper(element, domPath);
           if (fieldWrapper) {
             this.applyEnableIfVisibility(
               element,
               fieldWrapper,
-              currentPath,
-              fullPath,
+              domPath,
+              dataPath,
+              fullDomPath,
               formData
             );
           }
         }
         if ((element.type === "container" || element.type === "group") && "elements" in element && element.elements) {
-          const containerData = element.key ? getValueByPath(formData, fullPath) : void 0;
+          const containerData = element.key ? getValueByPath(formData, fullDataPath) : void 0;
           if (Array.isArray(containerData)) {
             const directItems = findDirectContainerRows(
               this.state.formRoot,
-              fullPath
+              fullDomPath
             );
-            directItems.forEach((el) => {
-              const attr = el.getAttribute("data-container-item") || "";
-              checkElements(element.elements, attr);
+            directItems.forEach((el, rowIndex) => {
+              const marker = el.getAttribute("data-container-item") || "";
+              checkElements(
+                element.elements,
+                marker,
+                `${fullDataPath}[${rowIndex}]`
+              );
             });
           } else {
-            checkElements(element.elements, fullPath);
+            checkElements(element.elements, fullDomPath, fullDataPath);
           }
         }
       });
     };
-    checkElements(this.state.schema.elements, "");
+    checkElements(this.state.schema.elements, "", "");
   }
   /**
    * Destroy instance and clean up resources
@@ -11901,6 +12051,7 @@ var FormBuilderInstance = class {
       this.state.debounceTimer = null;
     }
     this.disconnectEnableIfObservers();
+    this.removeTooltipElements();
     this.state.resourceIndex.clear();
     if (this.state.formRoot) {
       clear(this.state.formRoot);
@@ -11918,6 +12069,12 @@ var FormBuilderInstance = class {
     }
     this.state.enableIfObservers.clear();
   }
+  removeTooltipElements() {
+    for (const tooltip of this.state.tooltipElements) {
+      tooltip.remove();
+    }
+    this.state.tooltipElements.clear();
+  }
 };
 
 // src/index.ts