strapi-plugin-bulk-updater 1.2.13 → 1.3.1

package/README.md

@@ -31,9 +31,14 @@ Strapi allows editing entries individually or applying bulk actions within a sin
 ## ✨ Features at a Glance
 
 - 🔍 **Dynamic Cross-Collection Discovery**: Introspects all registered content types and attributes in your Strapi v5 instance.
+- 🎯 **Separate Search vs Update Attributes**: Search and filter by one attribute, relation, or nested component in Section 2, while targeting a distinct attribute to update in Section 1. Side-by-side table columns display both searched and target values simultaneously.
+- 🌲 **Configurable Component Nesting Depth (Levels 1–5)**: User-controlled depth exploration in the UI (`L1` to `L5`), persistent across sessions. Fully supports recursive component schema introspection, deep population, query filtering, and safe leaf mutation preserving sibling component properties.
+- 🚀 **Direct Bulk Publishing & Auto-Publish Toggle**: Directly publish draft records in bulk across multiple collections without editing values, plus an auto-publish toggle that instantly publishes updated documents for draft-enabled content types.
+- 📑 **Excel-Safe Bulk CSV Export**: RFC-4180 compliant CSV export with UTF-8 BOM and CRLF line breaks for seamless opening in Microsoft Excel and Numbers, with full recursive nested component support.
+- 🔍 **Interactive Pre-Update Change Preview**: Inspect real-time before-and-after diffs with impact classification (`Will Update`, `Unchanged`, `Will Skip`) prior to executing batch updates.
 - 🔎 **Searchable Combobox Attribute & Entity Picker**:
   - Instant fuzzy and substring search across all scalar fields, relations, and nested component paths.
-  - Interactive visual badges for relation targets (`relation ➔ Target`) and components.
+  - Interactive visual badges for relation targets (`relation ➔ Target`) and component nesting levels (`L1 component`, `L2 component`).
 - 🔗 **Full Relational Field Support**:
   - Supports `manyToOne`, `oneToOne`, `oneToMany`, and `manyToMany` relations.
   - Interactive searchable target entity dropdown populated directly from target collection records.
@@ -57,9 +62,6 @@ Strapi allows editing entries individually or applying bulk actions within a sin
   - **Convention Auto-Discovery**: Seamlessly detects and mirrors custom app collections (`api::audit-log.audit-log`).
   - **Strapi Enterprise Bridge**: Bridges events directly to native Strapi Enterprise Audit Logs (`admin::audit-logs`).
   - **Deterministic Rollback**: Restores exact prior values and relationship links using Strapi v5 Document Service.
-- 🧩 **Deep Nested Component Support**:
-  - Full dot-notation introspection (e.g. `metaFields.metaDescription`, `defaultSeo.metaTitle`) in attribute dropdown and table views.
-  - Non-destructive deep merging preserves sibling component properties during bulk updates and rollbacks.
 - ⚡ **Server-Side Filter & Full-Text Search Pushdown**:
   - Pushes text searches and attribute filters (`equals`, `contains`, `empty`, `starts_with`) directly to the database.
   - Automatically hides non-matching records and pre-selects matching rows with real-time match counters.
@@ -246,6 +248,10 @@ All routes are mounted under `/bulk-updater` and protected by Strapi Admin authe
 | `DELETE` | `/bulk-updater/validation-rules/:id` | Deletes a validation rule. |
 | `POST` | `/bulk-updater/validation-rules/:id/toggle` | Toggles rule active status. |
 | `POST` | `/bulk-updater/validation-rules/:id/scan` | Scans all existing records in target content types for violations. |
+| `POST` | `/bulk-updater/preview` | Generates a dry-run diff preview across target entries before update. |
+| `POST` | `/bulk-updater/publish` | Bulk publishes selected draft entries across multiple collections. |
+| `POST` | `/bulk-updater/export-selected` | Exports selected entries across collections to Excel-compatible CSV. |
+| `GET` | `/bulk-updater/collections/:uid/entries` | Paginated and filtered collection entries with search attribute pushdown. |
 | `GET` | `/bulk-updater/csv/template/:uid` | Generates a blank CSV template with content type headers. |
 | `GET` | `/bulk-updater/csv/export/:uid` | Exports all records for a collection type as CSV. |
 | `GET` | `/bulk-updater/csv/export-violations/:ruleId` | Exports only records violating the specified rule as CSV. |

package/dist/_chunks/{BulkUpdater-CWJYmuGU.js → BulkUpdater-CRvwX326.js}

@@ -1458,7 +1458,7 @@ function getNestedValue(obj, path) {
   if (!path.includes(".")) return obj[path];
   return path.split(".").reduce((acc, part) => acc && typeof acc === "object" ? acc[part] : void 0, obj);
 }
-function getAvailableColumnsForCollection(col, selectedAttribute) {
+function getAvailableColumnsForCollection(col, selectedAttribute, searchAttribute) {
   const cols = [
     {
       key: "select",
@@ -1475,7 +1475,7 @@ function getAvailableColumnsForCollection(col, selectedAttribute) {
   ];
   const candidateAttrs = col.attributes || [];
   candidateAttrs.forEach((attr) => {
-    if (attr === "name" || attr === "title" || attr === selectedAttribute) {
+    if (attr === "name" || attr === "title" || attr === selectedAttribute || searchAttribute && attr === searchAttribute) {
       return;
     }
     const formattedLabel = attr.includes(".") ? attr.split(".").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" > ") : attr.charAt(0).toUpperCase() + attr.slice(1);
@@ -1486,9 +1486,19 @@ function getAvailableColumnsForCollection(col, selectedAttribute) {
       defaultVisible: ["department", "email", "location"].includes(attr)
     });
   });
+  if (searchAttribute && searchAttribute !== selectedAttribute) {
+    const formattedSearchLabel = searchAttribute.includes(".") ? searchAttribute.split(".").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" > ") : searchAttribute;
+    cols.push({
+      key: "search_attr",
+      label: `Search: "${formattedSearchLabel}"`,
+      sortable: !col.isSingleType && col.attributes.includes(searchAttribute),
+      defaultVisible: true
+    });
+  }
+  const targetLabel = searchAttribute && searchAttribute !== selectedAttribute ? `Update Target: "${selectedAttribute}"` : `Current "${selectedAttribute}"`;
   cols.push({
     key: "target_attr",
-    label: `Current "${selectedAttribute}"`,
+    label: targetLabel,
     sortable: !col.isSingleType && col.attributes.includes(selectedAttribute),
     defaultVisible: true
   });
@@ -1500,17 +1510,19 @@ function getAvailableColumnsForCollection(col, selectedAttribute) {
   });
   return cols;
 }
-function renderHeaderCell(colDef, col, currentSort, selectedAttribute, onSort) {
+function renderHeaderCell(colDef, col, currentSort, selectedAttribute, searchAttribute, onSort) {
   if (colDef.key === "select") {
     return /* @__PURE__ */ jsxRuntime.jsx(designSystem.Th, { style: { width: 48 }, children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "sigma", children: "Select" }) }, "select");
   }
-  const isCurrentSorted = colDef.key === "identifier" && (currentSort.field === "name" || currentSort.field === "title") || colDef.key === "target_attr" && currentSort.field === selectedAttribute || colDef.key.startsWith("attr_") && currentSort.field === colDef.key.replace("attr_", "");
+  const isCurrentSorted = colDef.key === "identifier" && (currentSort.field === "name" || currentSort.field === "title") || colDef.key === "search_attr" && currentSort.field === searchAttribute || colDef.key === "target_attr" && currentSort.field === selectedAttribute || colDef.key.startsWith("attr_") && currentSort.field === colDef.key.replace("attr_", "");
   const sortArrow = isCurrentSorted ? currentSort.order === "asc" ? "▲" : "▼" : "⇅";
   const handleClick = () => {
     if (!colDef.sortable) return;
     if (colDef.key === "identifier") {
       const field = col.attributes.includes("name") ? "name" : col.attributes.includes("title") ? "title" : "createdAt";
       onSort(col.uid, field);
+    } else if (colDef.key === "search_attr") {
+      onSort(col.uid, searchAttribute);
     } else if (colDef.key === "target_attr") {
       onSort(col.uid, selectedAttribute);
     } else if (colDef.key.startsWith("attr_")) {
@@ -1546,7 +1558,7 @@ function formatDisplayValue(val) {
   }
   return String(val);
 }
-function renderCellContent(colDef, entry, col, selectedAttribute, isMatch, hasAttr, isSelected, onToggleSelect) {
+function renderCellContent(colDef, entry, col, selectedAttribute, searchAttribute, isMatch, hasAttr, isSelected, onToggleSelect) {
   switch (colDef.key) {
     case "select":
       return /* @__PURE__ */ jsxRuntime.jsx(
@@ -1563,6 +1575,27 @@ function renderCellContent(colDef, entry, col, selectedAttribute, isMatch, hasAt
         entry.email && /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral500", display: "block", children: entry.email })
       ] });
     }
+    case "search_attr": {
+      const val = getNestedValue(entry, searchAttribute);
+      const displayStr = formatDisplayValue(val);
+      const isUnset = displayStr === "(empty / not set)" || displayStr === "(empty / unlinked)";
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        designSystem.Typography,
+        {
+          textColor: isUnset ? "neutral500" : "primary700",
+          fontWeight: "semiBold",
+          style: {
+            fontStyle: isUnset ? "italic" : "normal",
+            display: "inline-block",
+            maxWidth: 260,
+            overflow: "hidden",
+            textOverflow: "ellipsis",
+            whiteSpace: "nowrap"
+          },
+          children: displayStr
+        }
+      );
+    }
     case "target_attr": {
       const val = getNestedValue(entry, selectedAttribute);
       const displayStr = formatDisplayValue(val);
@@ -1687,10 +1720,34 @@ const BulkUpdater = () => {
   };
   const [useRegex, setUseRegex] = React.useState(false);
   const [regexPattern, setRegexPattern] = React.useState("");
+  const DEPTH_STORAGE_KEY = "strapi_bulk_updater_component_depth";
+  const [componentDepth, setComponentDepth] = React.useState(() => {
+    try {
+      const stored = localStorage.getItem(DEPTH_STORAGE_KEY);
+      if (stored) {
+        const val = Number(stored);
+        if (val >= 1 && val <= 5) return val;
+      }
+    } catch {
+    }
+    return 3;
+  });
+  const handleComponentDepthChange = (depth) => {
+    const capped = Math.min(5, Math.max(1, depth));
+    setComponentDepth(capped);
+    try {
+      localStorage.setItem(DEPTH_STORAGE_KEY, String(capped));
+    } catch {
+    }
+  };
+  const [searchAttribute, setSearchAttribute] = React.useState("");
+  const [searchAttributeInput, setSearchAttributeInput] = React.useState("");
+  const [attributesMeta, setAttributesMeta] = React.useState({});
+  const effectiveSearchAttribute = searchAttribute || selectedAttribute;
   const [filterOperator, setFilterOperator] = React.useState("none");
   const [filterQuery, setFilterQuery] = React.useState("");
   const [entrySearch, setEntrySearch] = React.useState("");
-  const isFilterActive = filterOperator !== "none" && (["empty", "not_empty"].includes(filterOperator) || Boolean(filterQuery.trim())) || Boolean(entrySearch.trim());
+  const isFilterActive = Boolean(searchAttribute && searchAttribute !== selectedAttribute) || filterOperator !== "none" && (["empty", "not_empty"].includes(filterOperator) || Boolean(filterQuery.trim())) || Boolean(entrySearch.trim());
   const [lastResults, setLastResults] = React.useState(null);
   const [updateSummary, setUpdateSummary] = React.useState(null);
   const [collectionPages, setCollectionPages] = React.useState({});
@@ -1770,6 +1827,9 @@ const BulkUpdater = () => {
     if (data.relationsMeta) {
       setRelationsMeta(data.relationsMeta);
     }
+    if (data.attributesMeta) {
+      setAttributesMeta(data.attributesMeta);
+    }
     let storedAttr = null;
     try {
       storedAttr = localStorage.getItem(LAST_ATTR_KEY);
@@ -1817,7 +1877,7 @@ const BulkUpdater = () => {
       setLoading(false);
     }
   };
-  const loadCollectionPage = async (colUid, targetPage, customPageSize, customSortField, customSortOrder, overrideFilterOp, overrideFilterQuery, overrideEntrySearch, autoSelectReturned = true) => {
+  const loadCollectionPage = async (colUid, targetPage, customPageSize, customSortField, customSortOrder, overrideFilterOp, overrideFilterQuery, overrideEntrySearch, autoSelectReturned = true, overrideSearchAttr) => {
     const currentPageState = collectionPages[colUid];
     const size = customPageSize || currentPageState?.pageSize || defaultPageSize;
     const currentSort = collectionSorts[colUid] || { field: "createdAt", order: "desc" };
@@ -1826,6 +1886,7 @@ const BulkUpdater = () => {
     const op = overrideFilterOp !== void 0 ? overrideFilterOp : filterOperator;
     const q = overrideFilterQuery !== void 0 ? overrideFilterQuery : filterQuery;
     const s = overrideEntrySearch !== void 0 ? overrideEntrySearch : entrySearch;
+    const searchAttr = overrideSearchAttr !== void 0 ? overrideSearchAttr : searchAttribute;
     setCollectionPages((prev) => ({
       ...prev,
       [colUid]: {
@@ -1839,6 +1900,9 @@ const BulkUpdater = () => {
         pageSize: String(size)
       });
       if (selectedAttribute) params.set("attribute", selectedAttribute);
+      if (searchAttr && searchAttr !== selectedAttribute) {
+        params.set("searchAttribute", searchAttr);
+      }
       if (op && op !== "none") {
         params.set("filterOperator", op);
         if (q) params.set("filterQuery", q);
@@ -1868,7 +1932,7 @@ const BulkUpdater = () => {
             loading: false
           }
         }));
-        const isFilterActiveNow = op !== "none" && (["empty", "not_empty"].includes(op) || Boolean(q.trim())) || Boolean(s.trim());
+        const isFilterActiveNow = Boolean(searchAttr && searchAttr !== selectedAttribute) || op !== "none" && (["empty", "not_empty"].includes(op) || Boolean(q.trim())) || Boolean(s.trim());
         if (isFilterActiveNow && autoSelectReturned) {
           setSelectedEntries((prev) => {
             const next = { ...prev };
@@ -1955,13 +2019,14 @@ const BulkUpdater = () => {
     }
     const timer = setTimeout(() => {
       if (collections.length > 0) {
-        const isFilterActiveNow = filterOperator !== "none" && (["empty", "not_empty"].includes(filterOperator) || Boolean(filterQuery.trim())) || Boolean(entrySearch.trim());
+        const isFilterActiveNow = Boolean(searchAttribute && searchAttribute !== selectedAttribute) || filterOperator !== "none" && (["empty", "not_empty"].includes(filterOperator) || Boolean(filterQuery.trim())) || Boolean(entrySearch.trim());
         if (isFilterActiveNow) {
           setSelectedEntries({});
         }
+        const targetSearchAttr = searchAttribute || selectedAttribute;
         const targetCols = collections.filter((col) => {
           if (visibleTypeUids[col.uid] === false) return false;
-          if (filterOperator !== "none" && !col.attributes.includes(selectedAttribute)) return false;
+          if (filterOperator !== "none" && targetSearchAttr && !col.attributes.includes(targetSearchAttr)) return false;
           return true;
         });
         targetCols.forEach((col) => {
@@ -1974,13 +2039,14 @@ const BulkUpdater = () => {
             filterOperator,
             filterQuery,
             entrySearch,
-            true
+            true,
+            searchAttribute
           );
         });
       }
     }, 350);
     return () => clearTimeout(timer);
-  }, [filterOperator, filterQuery, entrySearch]);
+  }, [searchAttribute, filterOperator, filterQuery, entrySearch]);
   const KEY_SEP = "@@@";
   const handleAttributeChange = (newAttr) => {
     if (newAttr !== selectedAttribute) {
@@ -2049,39 +2115,119 @@ const BulkUpdater = () => {
     setVisibleTypeUids(newVis);
   };
   const [attributeSearch, setAttributeSearch] = React.useState("");
+  const [searchAttributeSearch, setSearchAttributeSearch] = React.useState("");
+  const getAttrDepth = (attr) => attributesMeta[attr]?.depth ?? (attr.includes(".") ? attr.split(".").length - 1 : 0);
+  const depthFilteredAttributes = React.useMemo(() => {
+    return attributes.filter((attr) => getAttrDepth(attr) <= componentDepth);
+  }, [attributes, componentDepth, attributesMeta]);
   const filteredAttributes = React.useMemo(() => {
     if (!attributeSearch.trim()) {
-      return attributes;
+      return depthFilteredAttributes;
     }
     const q = attributeSearch.toLowerCase().trim();
     const cleanQ = q.replace(/[^a-z0-9]/g, "");
-    return attributes.filter((attr) => {
+    return depthFilteredAttributes.filter((attr) => {
       const lower = attr.toLowerCase();
       const cleanLower = lower.replace(/[^a-z0-9]/g, "");
       const rel = relationsMeta[attr];
       const relTarget = (rel?.targetDisplayName || "").toLowerCase();
       return lower.includes(q) || cleanLower.includes(cleanQ) || relTarget.includes(q);
     });
-  }, [attributes, attributeSearch, relationsMeta]);
+  }, [depthFilteredAttributes, attributeSearch, relationsMeta]);
+  const filteredSearchAttributes = React.useMemo(() => {
+    if (!searchAttributeSearch.trim()) {
+      return depthFilteredAttributes;
+    }
+    const q = searchAttributeSearch.toLowerCase().trim();
+    const cleanQ = q.replace(/[^a-z0-9]/g, "");
+    return depthFilteredAttributes.filter((attr) => {
+      const lower = attr.toLowerCase();
+      const cleanLower = lower.replace(/[^a-z0-9]/g, "");
+      const rel = relationsMeta[attr];
+      const relTarget = (rel?.targetDisplayName || "").toLowerCase();
+      return lower.includes(q) || cleanLower.includes(cleanQ) || relTarget.includes(q);
+    });
+  }, [depthFilteredAttributes, searchAttributeSearch, relationsMeta]);
   const memoizedComboboxOptions = React.useMemo(() => {
     if (filteredAttributes.length === 0) {
       return /* @__PURE__ */ jsxRuntime.jsx(designSystem.ComboboxOption, { value: "__none__", disabled: true, textValue: "No matching attributes found", children: /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: [
         'No matching attributes found for "',
         attributeSearch,
-        '"'
+        '" (Depth L',
+        componentDepth,
+        ")"
       ] }) });
     }
     return filteredAttributes.map((attr) => {
       const rel = relationsMeta[attr];
+      const depth = getAttrDepth(attr);
       return /* @__PURE__ */ jsxRuntime.jsx(designSystem.ComboboxOption, { value: attr, textValue: attr, children: /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { justifyContent: "space-between", alignItems: "center", width: "100%", gap: 2, children: [
         /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "omega", fontWeight: attr === selectedAttribute ? "bold" : "regular", children: attr }),
         rel ? /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Badge, { backgroundColor: "secondary100", textColor: "secondary700", size: "S", children: [
           "relation ➔ ",
           rel.targetDisplayName
-        ] }) : attr.includes(".") ? /* @__PURE__ */ jsxRuntime.jsx(designSystem.Badge, { backgroundColor: "neutral150", textColor: "neutral700", size: "S", children: "component" }) : null
+        ] }) : depth > 0 ? /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Badge, { backgroundColor: depth === 1 ? "neutral150" : depth === 2 ? "primary100" : "secondary100", textColor: depth === 1 ? "neutral700" : depth === 2 ? "primary700" : "secondary700", size: "S", children: [
+          "L",
+          depth,
+          " component"
+        ] }) : null
       ] }) }, attr);
     });
-  }, [filteredAttributes, relationsMeta, selectedAttribute, attributeSearch]);
+  }, [filteredAttributes, relationsMeta, selectedAttribute, attributeSearch, componentDepth, attributesMeta]);
+  const memoizedSearchComboboxOptions = React.useMemo(() => {
+    return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        designSystem.ComboboxOption,
+        {
+          value: "__default__",
+          textValue: `Same as Update Attribute (${selectedAttribute || "None"})`,
+          children: /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { justifyContent: "space-between", alignItems: "center", width: "100%", gap: 2, children: [
+            /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Typography, { variant: "omega", fontStyle: "italic", textColor: "neutral600", children: [
+              "-- Same as Update Attribute (",
+              selectedAttribute || "None",
+              ") --"
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsx(designSystem.Badge, { backgroundColor: "neutral150", textColor: "neutral600", size: "S", children: "Default" })
+          ] })
+        }
+      ),
+      filteredSearchAttributes.map((attr) => {
+        const rel = relationsMeta[attr];
+        const depth = getAttrDepth(attr);
+        return /* @__PURE__ */ jsxRuntime.jsx(designSystem.ComboboxOption, { value: attr, textValue: attr, children: /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { justifyContent: "space-between", alignItems: "center", width: "100%", gap: 2, children: [
+          /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "omega", fontWeight: attr === searchAttribute ? "bold" : "regular", children: attr }),
+          rel ? /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Badge, { backgroundColor: "secondary100", textColor: "secondary700", size: "S", children: [
+            "relation ➔ ",
+            rel.targetDisplayName
+          ] }) : depth > 0 ? /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Badge, { backgroundColor: depth === 1 ? "neutral150" : depth === 2 ? "primary100" : "secondary100", textColor: depth === 1 ? "neutral700" : depth === 2 ? "primary700" : "secondary700", size: "S", children: [
+            "L",
+            depth,
+            " component"
+          ] }) : null
+        ] }) }, `search_${attr}`);
+      })
+    ] });
+  }, [filteredSearchAttributes, relationsMeta, searchAttribute, selectedAttribute, componentDepth, attributesMeta]);
+  const handleSearchAttributeChange = (newAttr) => {
+    const finalAttr = newAttr === "__default__" ? "" : newAttr;
+    setSearchAttribute(finalAttr);
+    if (collections.length > 0) {
+      collections.forEach((col) => {
+        loadCollectionPage(
+          col.uid,
+          1,
+          void 0,
+          void 0,
+          void 0,
+          filterOperator,
+          filterQuery,
+          entrySearch,
+          true,
+          finalAttr
+        );
+      });
+    }
+  };
   const handleGlobalPageSizeChange = (newSize) => {
     const capped = Math.min(500, Math.max(1, newSize));
     setDefaultPageSize(capped);
@@ -2172,12 +2318,14 @@ const BulkUpdater = () => {
     setSelectedEntries(updated);
   };
   const clearFilter = () => {
+    setSearchAttribute("");
+    setSearchAttributeSearch("");
     setFilterOperator("none");
     setFilterQuery("");
     setEntrySearch("");
     setSelectedEntries({});
     collections.forEach((col) => {
-      loadCollectionPage(col.uid, 1, void 0, void 0, void 0, "none", "", "", false);
+      loadCollectionPage(col.uid, 1, void 0, void 0, void 0, "none", "", "", false, "");
     });
   };
   const isCollectionFullySelected = (col) => {
@@ -2973,7 +3121,29 @@ const BulkUpdater = () => {
               marginBottom: 6,
               style: { width: "100%", maxWidth: "100%", minWidth: 0, boxSizing: "border-box" },
               children: [
-                /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "delta", tag: "h2", marginBottom: 4, fontWeight: "semiBold", children: "1. Configure Attribute Update" }),
+                /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { justifyContent: "space-between", alignItems: "center", marginBottom: 4, wrap: "wrap", gap: 3, children: [
+                  /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Box, { children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "delta", tag: "h2", fontWeight: "semiBold", children: "1. Configure Attribute Update" }),
+                    /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: "Select the target attribute to update across collections." })
+                  ] }),
+                  /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 2, alignItems: "center", wrap: "wrap", children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral700", fontWeight: "bold", children: "Component Nesting Depth:" }),
+                    [1, 2, 3, 4, 5].map((lvl) => /* @__PURE__ */ jsxRuntime.jsxs(
+                      designSystem.Button,
+                      {
+                        variant: componentDepth === lvl ? "default" : "tertiary",
+                        size: "S",
+                        onClick: () => handleComponentDepthChange(lvl),
+                        title: `Discover nested component attributes up to Level ${lvl}`,
+                        children: [
+                          "Level ",
+                          lvl
+                        ]
+                      },
+                      `depth_cfg_${lvl}`
+                    ))
+                  ] })
+                ] }),
                 /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 4, alignItems: "flex-end", wrap: "wrap", children: [
                   /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { style: { minWidth: 280, flex: 1, maxWidth: 440 }, children: /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Field.Root, { children: [
                     /* @__PURE__ */ jsxRuntime.jsx(designSystem.Field.Label, { children: "Attribute to Update" }),
@@ -3304,26 +3474,83 @@ const BulkUpdater = () => {
                     style: { width: "100%", maxWidth: "100%", boxSizing: "border-box" },
                     children: /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { direction: "column", gap: 3, children: [
                       /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { justifyContent: "space-between", alignItems: "center", wrap: "wrap", gap: 2, children: [
-                        /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 2, alignItems: "center", children: [
+                        /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 2, alignItems: "center", wrap: "wrap", children: [
                           /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "omega", fontWeight: "bold", children: "Search & Filter Targets:" }),
                           isFilterActive && /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Badge, { backgroundColor: "primary100", textColor: "primary700", children: [
                             matchingEntriesCount,
                             " matching ",
                             matchingEntriesCount === 1 ? "entry" : "entries",
                             " found in database"
+                          ] }),
+                          searchAttribute && searchAttribute !== selectedAttribute && /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Badge, { backgroundColor: "secondary100", textColor: "secondary700", children: [
+                            "Searching by: ",
+                            searchAttribute,
+                            " → Target to update: ",
+                            selectedAttribute
                           ] })
                         ] }),
-                        isFilterActive && /* @__PURE__ */ jsxRuntime.jsx(designSystem.Button, { variant: "ghost", size: "S", onClick: clearFilter, children: "Clear Search & Filter" })
+                        /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 2, alignItems: "center", wrap: "wrap", children: [
+                          /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 1, alignItems: "center", children: [
+                            /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: "Depth:" }),
+                            [1, 2, 3, 4, 5].map((lvl) => /* @__PURE__ */ jsxRuntime.jsxs(
+                              designSystem.Button,
+                              {
+                                variant: componentDepth === lvl ? "default" : "tertiary",
+                                size: "S",
+                                onClick: () => handleComponentDepthChange(lvl),
+                                title: `Show component attributes up to Level ${lvl}`,
+                                style: { minWidth: 26, padding: "2px 6px" },
+                                children: [
+                                  "L",
+                                  lvl
+                                ]
+                              },
+                              `s2_depth_${lvl}`
+                            ))
+                          ] }),
+                          isFilterActive && /* @__PURE__ */ jsxRuntime.jsx(designSystem.Button, { variant: "ghost", size: "S", onClick: clearFilter, children: "Clear Search & Filter" })
+                        ] })
                       ] }),
                       /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 3, alignItems: "flex-end", wrap: "wrap", children: [
-                        /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { style: { width: 220, minWidth: 180 }, children: /* @__PURE__ */ jsxRuntime.jsxs(
+                        /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { style: { width: 280, minWidth: 230 }, children: /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Field.Root, { children: [
+                          /* @__PURE__ */ jsxRuntime.jsx(designSystem.Field.Label, { children: "Search Attribute" }),
+                          /* @__PURE__ */ jsxRuntime.jsx(
+                            designSystem.Combobox,
+                            {
+                              autocomplete: "none",
+                              placeholder: searchAttribute || `Same as Update (${selectedAttribute || "None"})`,
+                              value: searchAttribute || "__default__",
+                              clearLabel: "Reset search attribute",
+                              onClear: () => {
+                                handleSearchAttributeChange("");
+                                setSearchAttributeSearch("");
+                              },
+                              onInputChange: (e) => {
+                                setSearchAttributeSearch(e.target.value);
+                              },
+                              onOpenChange: (isOpen) => {
+                                if (!isOpen) {
+                                  setSearchAttributeSearch("");
+                                }
+                              },
+                              onChange: (val) => {
+                                if (val && typeof val === "string" && val !== "__none__") {
+                                  handleSearchAttributeChange(val);
+                                  setSearchAttributeSearch("");
+                                }
+                              },
+                              children: memoizedSearchComboboxOptions
+                            }
+                          )
+                        ] }) }),
+                        /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { style: { width: 200, minWidth: 170 }, children: /* @__PURE__ */ jsxRuntime.jsxs(
                           designSystem.SingleSelect,
                           {
-                            label: selectedAttribute ? `Filter condition for "${selectedAttribute}"` : "Filter condition",
+                            label: effectiveSearchAttribute ? `Condition for "${effectiveSearchAttribute}"` : "Filter condition",
                             value: filterOperator,
                             onChange: (val) => setFilterOperator(String(val)),
                             children: [
-                              /* @__PURE__ */ jsxRuntime.jsx(designSystem.SingleSelectOption, { value: "none", children: "Show All (No Attribute Filter)" }),
+                              /* @__PURE__ */ jsxRuntime.jsx(designSystem.SingleSelectOption, { value: "none", children: "Show All (No Value Filter)" }),
                               /* @__PURE__ */ jsxRuntime.jsx(designSystem.SingleSelectOption, { value: "empty", children: "Is Empty or Null" }),
                               /* @__PURE__ */ jsxRuntime.jsx(designSystem.SingleSelectOption, { value: "not_empty", children: "Is Not Empty" }),
                               /* @__PURE__ */ jsxRuntime.jsx(designSystem.SingleSelectOption, { value: "equals", children: "Equals Exact Text" }),
@@ -3332,16 +3559,16 @@ const BulkUpdater = () => {
                             ]
                           }
                         ) }),
-                        (filterOperator === "equals" || filterOperator === "contains" || filterOperator === "starts_with") && /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { style: { flex: 1, minWidth: 200 }, children: /* @__PURE__ */ jsxRuntime.jsx(
+                        (filterOperator === "equals" || filterOperator === "contains" || filterOperator === "starts_with") && /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { style: { flex: 1, minWidth: 180 }, children: /* @__PURE__ */ jsxRuntime.jsx(
                           designSystem.TextInput,
                           {
-                            label: selectedAttribute ? `Value for "${selectedAttribute}"` : "Value to match",
+                            label: effectiveSearchAttribute ? `Value for "${effectiveSearchAttribute}"` : "Value to match",
                             placeholder: "Type value to match...",
                             value: filterQuery,
                             onChange: (e) => setFilterQuery(e.target.value)
                           }
                         ) }),
-                        /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { style: { flex: 1, minWidth: 200 }, children: /* @__PURE__ */ jsxRuntime.jsx(
+                        /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { style: { flex: 1, minWidth: 180 }, children: /* @__PURE__ */ jsxRuntime.jsx(
                           designSystem.TextInput,
                           {
                             label: "Full-text Entry Search",
@@ -3539,11 +3766,11 @@ const BulkUpdater = () => {
                   const pageSize = pageState ? pageState.pageSize : defaultPageSize;
                   const hasAttr = selectedAttribute ? col.attributes.includes(selectedAttribute) : false;
                   const visibleEntries = getVisibleEntries(col);
-                  selectedAttribute ? entries.filter((e) => entryMatchesFilter(e, selectedAttribute)).length : 0;
+                  selectedAttribute ? entries.filter((e) => entryMatchesFilter(e, effectiveSearchAttribute)).length : 0;
                   const isFullySelected = isCollectionFullySelected(col);
                   const isPartiallySelected = isCollectionPartiallySelected(col);
                   const currentSort = collectionSorts[col.uid] || { field: "createdAt", order: "desc" };
-                  const availableColumns = getAvailableColumnsForCollection(col, selectedAttribute);
+                  const availableColumns = getAvailableColumnsForCollection(col, selectedAttribute, searchAttribute);
                   const savedColKeys = collectionColumnVisibility[col.uid];
                   const activeColumns = savedColKeys ? availableColumns.filter((c) => c.isPermanent || savedColKeys.includes(c.key)) : availableColumns.filter((c) => c.defaultVisible);
                   return /* @__PURE__ */ jsxRuntime.jsxs(
@@ -3753,7 +3980,7 @@ const BulkUpdater = () => {
                         ),
                         /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { className: "bulk-updater-table-container", style: { width: "100%", maxWidth: "100%", minWidth: 0, overflowX: "auto" }, children: /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Table, { colCount: activeColumns.length, rowCount: visibleEntries.length + 1, style: { width: "100%" }, children: [
                           /* @__PURE__ */ jsxRuntime.jsx(designSystem.Thead, { children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Tr, { children: activeColumns.map(
-                            (colDef) => renderHeaderCell(colDef, col, currentSort, selectedAttribute, handleHeaderSortClick)
+                            (colDef) => renderHeaderCell(colDef, col, currentSort, selectedAttribute, searchAttribute, handleHeaderSortClick)
                           ) }) }),
                           /* @__PURE__ */ jsxRuntime.jsx(designSystem.Tbody, { children: visibleEntries.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx(designSystem.Tr, { children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Td, { colSpan: activeColumns.length, children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { padding: 4, style: { textAlign: "center" }, children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral500", children: "No entries in this content type match the active filter criteria." }) }) }) }) : visibleEntries.map((entry) => {
                             const key = `${col.uid}${KEY_SEP}${entry.documentId}`;
@@ -3771,6 +3998,7 @@ const BulkUpdater = () => {
                                   entry,
                                   col,
                                   selectedAttribute,
+                                  searchAttribute,
                                   isMatch,
                                   hasAttr,
                                   isSelected,
@@ -4744,4 +4972,4 @@ exports.default = BulkUpdater;
 exports.formatDisplayValue = formatDisplayValue;
 exports.getAvailableColumnsForCollection = getAvailableColumnsForCollection;
 exports.getNestedValue = getNestedValue;
-//# sourceMappingURL=BulkUpdater-CWJYmuGU.js.map
+//# sourceMappingURL=BulkUpdater-CRvwX326.js.map