react-email-studio 3.1.1 → 3.2.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.1.1] - 2026-04-30
+
+### Added
+
+- **Loading state for `loadJson`**: `ReactEmailEditor` shows a full-workspace overlay (spinner + localized “Loading design…”) while a design JSON is applied, including invalid-parse early exit.
+- **Lossless studio JSON**: document `settings._reactEmailStudio.editorSettings` stores a snapshot of editor settings; each row may include `_reactEmailStudio.row` (row fields without `cells`) for presets, ratios, `columnStyles`, etc.
+- **i18n**: `loadingDesign` string in `en`, `fr`, `de`, `es`.
+
+### Fixed
+
+- **Settings round-trip**: exported document `rtl` / `responsive` now follow `pageRtl` / `pageResponsive` so normalization no longer overwrites them from stale canonical defaults.
+- **Social blocks**: canonical `content.networks` includes URLs from `socialUrls` even when not listed in `networks`; import supports `networks` as an array plus `content.socialUrls`; `styles.padding` is exported/imported; legacy flat-merge skips `socialUrls` where appropriate.
+- **Nested layout `columnStyles`**: importing a layout whose `props.cells` is hydrated no longer drops `columnStyles` that exist only on `content` (merge after hydrate).
+- **Nested layout inspector**: `LayoutRowEditor` background-step UI (row + per-column) re-syncs when `bgColor` / `bgImage` / `bgGradient` / `columnStyles` change, not only when `row.id` changes.
+- **Block palette (click)**: new blocks go to the focused column, a focused nested column, column 0 of a row selected in the rails, or **first row / first column** by default (instead of always column 0 of the last row).
+
+### Notes for integrators
+
+- Prefer **`loadJson` / `exportJson`** (or `designToEmailDocument` + `normalizeEmailDesignInput`) for full fidelity; blocks may include a `props` object alongside `content` / `styles` for editor-only fields.
+- **`jsonToHtml`** nested layouts already receive `columnStyles` when present on hydrated blocks.

package/README.md

@@ -5,6 +5,10 @@
 [![npm](https://img.shields.io/npm/v/react-email-studio.svg)](https://www.npmjs.com/package/react-email-studio)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
+## Release notes
+
+Version history and migration hints: **[CHANGELOG.md](./CHANGELOG.md)** (also included in the published npm tarball under `node_modules/react-email-studio/CHANGELOG.md`).
+
 ---
 
 ## Features
@@ -13,7 +17,7 @@
 - **Page & content** backgrounds (solid, gradient, image), responsive preview
 - **Undo / redo**, zoom, device preview modal
 - **Internationalized** UI strings (`en`, `fr`, `de`, `es`)
-- **Merge tags** support for templates
+- **Template placeholders** (e.g. `{{first_name}}`) can be typed directly in HTML / text blocks
 - Tree-shakeable ESM + CJS, TypeScript types
 
 ---

package/TUTORIAL.md

@@ -134,7 +134,7 @@ Adjust the import path to match your structure.
 | Prop | Type | Description |
 |------|------|-------------|
 | `ref` | `ReactEmailEditorRef` | Imperative API: `loadJson`, `exportJson` (see below). |
-| `options` | `ReactEmailEditorOptions` | Editor chrome, locale, merge tags, feature flags, etc. (see §6). |
+| `options` | `ReactEmailEditorOptions` | Editor chrome, locale, feature flags, etc. (see §6). |
 | `onUpload` | `(file: File) => Promise<string>` | Required for good image/video UX; return public URL string. |
 | `onLoad` / `onReady` | `(api: ReactEmailEditorRef) => void` | Fired once with the same API object; use to call `loadJson` with server data. |
 | `hideTemplates` | `boolean` | Hide built-in templates UI; use when you only load via `loadJson`. |
@@ -163,7 +163,6 @@ Adjust the import path to match your structure.
 | **`customCSS`** | Extra `<style>` content for generated HTML (preview / export parity). |
 | **`appearance`** | `theme`, `colors`, `customThemes` — chrome theming. |
 | **`locale`** | `"en"` \| `"fr"` \| `"de"` \| `"es"` for UI strings. |
-| **`mergeTags`** | `{ name: string; value: string }[]` for rich-text insertion. |
 | **`features.autoSave`** | `{ enabled?: boolean; interval?: number }` — UI autosave hint. |
 | **`tools`** | `{ [blockType: string]: { enabled?: boolean } }` — toggle blocks. |
 | **`blockLibrary`** | `groupHeadings`, `paletteGroupLabels` — library copy overrides. |

package/dist/index.cjs

@@ -152,7 +152,6 @@ var I18N = {
     delete: "Delete",
     moveUp: "Move Up",
     moveDown: "Move Down",
-    mergeTags: "Merge Tags",
     autoSaved: "Auto-saved",
     search: "Search blocks\u2026",
     zoomIn: "Zoom In",
@@ -211,7 +210,6 @@ var I18N = {
     delete: "Supprimer",
     moveUp: "Monter",
     moveDown: "Descendre",
-    mergeTags: "Balises fusion",
     autoSaved: "Auto-sauvegard\xE9",
     search: "Rechercher\u2026",
     colorScheme: "Sch\xE9ma de couleurs",
@@ -271,7 +269,6 @@ var I18N = {
     delete: "L\xF6schen",
     moveUp: "Nach oben",
     moveDown: "Nach unten",
-    mergeTags: "Merge-Tags",
     autoSaved: "Auto-gespeichert",
     search: "Bl\xF6cke suchen\u2026",
     colorScheme: "Farbschema",
@@ -329,7 +326,6 @@ var I18N = {
     delete: "Eliminar",
     moveUp: "Subir",
     moveDown: "Bajar",
-    mergeTags: "Etiquetas de fusi\xF3n",
     autoSaved: "Auto-guardado",
     search: "Buscar bloques\u2026",
     zoomIn: "Zoom +",
@@ -2238,9 +2234,8 @@ function useLiveCountdown(endDate) {
   const s = Math.floor(diff % 6e4 / 1e3);
   return [d, h, m, s];
 }
-function editChromeBorder(C, preview) {
-  if (preview) return {};
-  return { border: `1px dotted ${C.border}`, boxSizing: "border-box" };
+function editChromeBorder(_C, _preview) {
+  return {};
 }
 function blockLinkCaptureHandler(preview, e) {
   if (preview) return;
@@ -2542,6 +2537,8 @@ function NestedRowBlock({
   rowId,
   cellIdx,
   parentBlockIdx,
+  /** When this layout sits inside another layout column, meta uses `contentIdx` + `inner` like other nested blocks. */
+  selectionInner,
   editorId,
   selectedKey,
   selContentMeta,
@@ -2553,7 +2550,7 @@ function NestedRowBlock({
   C
 }) {
   const p = block.props;
-  const rowSelected = !preview && selContentMeta && selContentMeta.rowId === rowId && selContentMeta.cellIdx === cellIdx && selContentMeta.contentIdx === parentBlockIdx && !selContentMeta.inner && selectedKey === block.id;
+  const rowSelected = !preview && selContentMeta && selContentMeta.rowId === rowId && selContentMeta.cellIdx === cellIdx && selectedKey === block.id && (selectionInner == null ? selContentMeta.contentIdx === parentBlockIdx && !selContentMeta.inner : selContentMeta.contentIdx === parentBlockIdx && selContentMeta.inner && selContentMeta.inner.cellIdx === selectionInner.cellIdx && selContentMeta.inner.contentIdx === selectionInner.contentIdx);
   const rowStyle = {
     padding: p.padding ?? 8,
     position: "relative",
@@ -2577,7 +2574,13 @@ function NestedRowBlock({
       style: rowStyle,
       onClick: preview ? void 0 : (e) => {
         e.stopPropagation();
-        onSelectContent(block.id, rowId, cellIdx, parentBlockIdx, null);
+        onSelectContent(
+          block.id,
+          rowId,
+          cellIdx,
+          parentBlockIdx,
+          selectionInner ?? null
+        );
       },
       children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { style: { display: "flex", gap: p.gap ?? 12 }, children: (p.cells || []).map((innerBlocks, ici) => {
         const cS = p.columnStyles && p.columnStyles[ici] || {};
@@ -2643,7 +2646,13 @@ function BlockItem({
     if (!onSelectContent) return;
     e.stopPropagation();
     if (isSplitLayoutBlock(cb)) {
-      onSelectContent(cb.id, rowId, cellIdx, nest ? nest.parentBlockIdx : ci, null);
+      onSelectContent(
+        cb.id,
+        rowId,
+        cellIdx,
+        nest ? nest.parentBlockIdx : ci,
+        nest ? { cellIdx: innerCellIdx, contentIdx: ci } : null
+      );
     } else {
       onSelectContent(
         cb.id,
@@ -2714,6 +2723,7 @@ function BlockItem({
                 rowId,
                 cellIdx,
                 parentBlockIdx: nest ? nest.parentBlockIdx : ci,
+                selectionInner: nest ? { cellIdx: innerCellIdx, contentIdx: ci } : null,
                 editorId,
                 selectedKey,
                 selContentMeta,
@@ -3301,11 +3311,8 @@ function ToolbarTypographyControls({ editor, C }) {
 }
 function FormattingToolbar({
   editor,
-  C,
-  mergeTags,
-  onMergeTagInsert
+  C
 }) {
-  const [mergeSel, setMergeSel] = (0, import_react2.useState)("");
   const [linkPanelOpen, setLinkPanelOpen] = (0, import_react2.useState)(false);
   const [linkUrlValue, setLinkUrlValue] = (0, import_react2.useState)("");
   const ibtn = (active) => toolbarIconBtn(C, active);
@@ -3625,8 +3632,6 @@ function TextRichEditor({
   value,
   onChange,
   typography,
-  mergeTags,
-  onMergeTagInsert,
   placeholder = "Write your message\u2026",
   headerTitle = "Rich editor",
   C
@@ -3770,15 +3775,7 @@ function TextRichEditor({
             ]
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-          FormattingToolbar,
-          {
-            editor,
-            C,
-            mergeTags,
-            onMergeTagInsert
-          }
-        ),
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(FormattingToolbar, { editor, C }),
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("style", { children: proseStyle }),
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
           "div",
@@ -3829,15 +3826,7 @@ function TextRichEditor({
         background: C.inputBg
       },
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-          FormattingToolbar,
-          {
-            editor,
-            C,
-            mergeTags,
-            onMergeTagInsert
-          }
-        ),
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(FormattingToolbar, { editor, C }),
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("style", { children: proseStyle }),
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
           "div",
@@ -4837,7 +4826,7 @@ function BlockSurfaceBgInspector({
     ] }) : null
   ] });
 }
-function ContentBlockEditor({ block, onChange, mergeTags, onClose, onUpload, C }) {
+function ContentBlockEditor({ block, onChange, onClose, onUpload, C }) {
   const { IS, CI } = useIS(C);
   const imageFileRef = (0, import_react4.useRef)(null);
   const p = block.props;
@@ -4856,7 +4845,6 @@ function ContentBlockEditor({ block, onChange, mergeTags, onClose, onUpload, C }
     /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("input", { type: "checkbox", checked: !!p[k], onChange: (e) => set(k, e.target.checked), style: { width: 15, height: 15, accentColor: C.accent } }),
     /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { style: { color: C.muted, fontSize: 12 }, children: p[k] ? "On" : "Off" })
   ] }) });
-  const TagPicker = (_field) => null;
   const FONTS2 = ["Georgia,serif", "Arial,sans-serif", "Verdana,sans-serif", "'Courier New',monospace", "Trebuchet MS,sans-serif", "Impact,sans-serif"];
   const ImgUpload = (key) => {
     if (!onUpload) return null;
@@ -4910,7 +4898,7 @@ function ContentBlockEditor({ block, onChange, mergeTags, onClose, onUpload, C }
       ] });
     case "text":
       return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(import_jsx_runtime6.Fragment, { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PR, { label: "Content (HTML)", C, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PR, { label: "Content", C, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
           "textarea",
           {
             style: { ...IS, minHeight: 200, resize: "vertical", fontFamily: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace", fontSize: 12, lineHeight: 1.45 },
@@ -4921,24 +4909,6 @@ function ContentBlockEditor({ block, onChange, mergeTags, onClose, onUpload, C }
           },
           block.id
         ) }),
-        mergeTags && mergeTags.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PR, { label: "Insert merge tag", C, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
-          "select",
-          {
-            style: IS,
-            defaultValue: "",
-            onChange: (e) => {
-              const v = e.target.value;
-              if (v) {
-                set("content", normalizeRichHtmlForStorage((p.content || "") + " " + v));
-                e.target.value = "";
-              }
-            },
-            children: [
-              /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("option", { value: "", children: "Choose\u2026" }),
-              mergeTags.map((t) => /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("option", { value: t.value, children: t.name }, t.name))
-            ]
-          }
-        ) }) : null,
         /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(NumRangePx, { label: "Font size", value: p.fontSize ?? 15, onChange: (n) => set("fontSize", n), min: 8, max: 96, step: 1, C }),
         Col("color", "Color"),
         /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(AlignButtons, { value: p.align, onChange: (v) => set("align", v), options: ["left", "center", "right", "justify"], C }),
@@ -4968,8 +4938,6 @@ function ContentBlockEditor({ block, onChange, mergeTags, onClose, onUpload, C }
               letterSpacing: p.letterSpacing,
               padding: p.padding
             },
-            mergeTags,
-            onMergeTagInsert: (tag) => set("content", (p.content || "") + " " + tag),
             placeholder: "Write your rich content\u2026",
             headerTitle: "Rich editor",
             C
@@ -5376,6 +5344,19 @@ function ContentBlockEditor({ block, onChange, mergeTags, onClose, onUpload, C }
       return null;
   }
 }
+function inferLayoutRowBgStep(r) {
+  if (r.bgGradient) return "gradient";
+  if (String(r.bgImage || "").trim()) return "image";
+  if (String(r.bgColor || "").trim()) return "solid";
+  return null;
+}
+function inferColumnBgStep(columnStyles, selCol) {
+  const cs = (columnStyles || {})[selCol] || {};
+  if (cs.bgGradient) return "gradient";
+  if (String(cs.bgImage || "").trim()) return "image";
+  if (String(cs.bgColor || "").trim()) return "solid";
+  return null;
+}
 function LayoutRowEditor({
   row,
   onChange,
@@ -5387,49 +5368,37 @@ function LayoutRowEditor({
   customizationHint
 }) {
   const { IS, CI } = useIS(C);
-  const [selCol, setSelCol] = (0, import_react4.useState)(initialCol);
-  const [rowBgUiStep, setRowBgUiStep] = (0, import_react4.useState)(null);
-  const [colBgUiStep, setColBgUiStep] = (0, import_react4.useState)(null);
+  const colCount = Math.max(1, row.ratios?.length || row.cells?.length || 1);
+  const ratioList = row.ratios?.length ? row.ratios : [1];
+  const [selCol, setSelCol] = (0, import_react4.useState)(0);
+  const [rowBgPickerMode, setRowBgPickerMode] = (0, import_react4.useState)(null);
+  const [colBgPickerMode, setColBgPickerMode] = (0, import_react4.useState)(null);
+  const inferredRowBg = (0, import_react4.useMemo)(() => inferLayoutRowBgStep(row), [row.bgGradient, row.bgImage, row.bgColor]);
+  const inferredColBg = (0, import_react4.useMemo)(
+    () => inferColumnBgStep(row.columnStyles, selCol),
+    [row.columnStyles, selCol]
+  );
+  const rowBgUiStep = inferredRowBg ?? rowBgPickerMode;
+  const colBgUiStep = inferredColBg ?? colBgPickerMode;
   (0, import_react4.useEffect)(() => {
-    if (initialCol !== null && initialCol !== void 0) {
-      setSelCol(initialCol);
+    if (initialCol !== null && initialCol !== void 0 && initialCol >= 0) {
+      setSelCol(Math.min(initialCol, colCount - 1));
+    } else {
+      setSelCol((c) => Math.min(Math.max(0, c), colCount - 1));
     }
-  }, [initialCol]);
+  }, [initialCol, row.id, colCount]);
   (0, import_react4.useEffect)(() => {
-    if (row.bgGradient) {
-      setRowBgUiStep("gradient");
-      return;
-    }
-    if (String(row.bgImage || "").trim()) {
-      setRowBgUiStep("image");
-      return;
-    }
-    if (String(row.bgColor || "").trim()) {
-      setRowBgUiStep("solid");
-      return;
-    }
-    setRowBgUiStep(null);
+    setRowBgPickerMode(null);
   }, [row.id]);
   (0, import_react4.useEffect)(() => {
-    if (selCol === null) {
-      setColBgUiStep(null);
-      return;
-    }
-    const cs = (row.columnStyles || {})[selCol] || {};
-    if (cs.bgGradient) {
-      setColBgUiStep("gradient");
-      return;
-    }
-    if (String(cs.bgImage || "").trim()) {
-      setColBgUiStep("image");
-      return;
-    }
-    if (String(cs.bgColor || "").trim()) {
-      setColBgUiStep("solid");
-      return;
-    }
-    setColBgUiStep(null);
+    setColBgPickerMode(null);
   }, [selCol, row.id]);
+  (0, import_react4.useEffect)(() => {
+    if (inferredRowBg) setRowBgPickerMode(null);
+  }, [inferredRowBg]);
+  (0, import_react4.useEffect)(() => {
+    if (inferredColBg) setColBgPickerMode(null);
+  }, [inferredColBg]);
   const set = (k, v) => onChange({ ...row, [k]: v });
   const applyColumnCount = (n) => {
     const prevCells = [...row.cells || []];
@@ -5445,16 +5414,13 @@ function LayoutRowEditor({
     }
     onChange({ ...row, cols: n, preset: "custom", cells, ratios });
   };
-  const colCount = Math.max(1, row.ratios?.length || row.cells?.length || 1);
-  const ratioList = row.ratios?.length ? row.ratios : [1];
   const updCol = (i, upd) => {
     const styles = { ...row.columnStyles || {} };
     styles[i] = { ...styles[i] || {}, ...upd };
     set("columnStyles", styles);
   };
   const setColBgMode = (mode) => {
-    if (selCol === null) return;
-    setColBgUiStep(mode);
+    setColBgPickerMode(mode);
     const cs = (row.columnStyles || {})[selCol] || {};
     if (mode === "solid") {
       updCol(selCol, { bgGradient: null, bgImage: "" });
@@ -5472,7 +5438,7 @@ function LayoutRowEditor({
   const total = ratioList.reduce((a, b) => a + b, 0) || 1;
   const POS_OPTS = ["center", "top", "bottom", "left", "right", "top left", "top right", "bottom left", "bottom right"];
   const setRowBgMode = (mode) => {
-    setRowBgUiStep(mode);
+    setRowBgPickerMode(mode);
     if (mode === "solid") {
       set("bgGradient", null);
       set("bgImage", "");
@@ -5630,7 +5596,7 @@ function LayoutRowEditor({
         },
         i
       )) }),
-      selCol !== null && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: { background: C.surface, padding: 10, borderRadius: 8, border: `1px solid ${C.border}` }, children: [
+      colCount > 0 && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: { background: C.surface, padding: 10, borderRadius: 8, border: `1px solid ${C.border}` }, children: [
         /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(BgModeButtons, { value: colBgUiStep, onChange: setColBgMode, C }),
         colBgUiStep === null ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { style: { fontSize: 11, color: C.muted, marginBottom: 10, lineHeight: 1.45 }, children: "Choose Color, Gradient, or Image \u2014 then edit column background details." }) : null,
         colBgUiStep === "solid" ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PR, { label: `col ${selCol + 1} bg`, C, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: { display: "flex", gap: 8, alignItems: "center" }, children: [
@@ -6521,7 +6487,6 @@ var ReactEmailEditor = (0, import_react8.forwardRef)(
     const [locale, setLocale] = (0, import_react8.useState)(
       typeof opt.locale === "string" ? opt.locale : "en"
     );
-    const [mergeTags, setMergeTagsState] = (0, import_react8.useState)(() => opt.mergeTags ?? []);
     const [zoom, setZoom] = (0, import_react8.useState)(100);
     const [rightRailWidth, setRightRailWidth] = (0, import_react8.useState)(RIGHT_RAIL_DEFAULT_W);
     const [ctxMenu, setCtxMenu] = (0, import_react8.useState)(null);
@@ -6916,7 +6881,7 @@ var ReactEmailEditor = (0, import_react8.forwardRef)(
         }));
         return;
       }
-      const loc = { type: "nested", rowId, outerCellIdx: cellIdx, blockIdx: inner.parentBlockIdx, innerCellIdx: inner.cellIdx };
+      const loc = { type: "nested", rowId, outerCellIdx: cellIdx, blockIdx: ci, innerCellIdx: inner.cellIdx };
       mutate((prev) => updateColumnAt(prev, loc, (c) => c.map((b, j) => j === inner.contentIdx ? upd : b)));
     };
     const selectContent = (contentId, rowId, cellIdx, parentBlockIdx, inner = null) => {
@@ -7647,7 +7612,6 @@ var ReactEmailEditor = (0, import_react8.forwardRef)(
                             setSelMeta(null);
                             setSelectedRowId(null);
                           },
-                          mergeTags,
                           onUpload,
                           C
                         }
@@ -7716,11 +7680,43 @@ var ReactEmailEditor = (0, import_react8.forwardRef)(
                                   e.dataTransfer.setData("application/json", JSON.stringify({ contentType: bt.type }));
                                 },
                                 onClick: () => {
-                                  const targetRow = selectedRowId ? rows.find((r) => r.id === selectedRowId) : rows[rows.length - 1];
-                                  if (!targetRow) return;
-                                  dropContent(targetRow.id, 0, { kind: "new", contentType: bt.type, insertAt: null });
+                                  if (!rows.length) return;
+                                  if (selContentMeta?.inner) {
+                                    const { rowId, cellIdx, contentIdx, inner } = selContentMeta;
+                                    dropContent(rowId, cellIdx, {
+                                      kind: "new",
+                                      contentType: bt.type,
+                                      insertAt: null,
+                                      nested: { parentBlockIdx: contentIdx, innerCellIdx: inner.cellIdx }
+                                    });
+                                    return;
+                                  }
+                                  if (selContentMeta?.rowId && typeof selContentMeta.cellIdx === "number" && selContentMeta.cellIdx >= 0) {
+                                    const r = rows.find((x) => x.id === selContentMeta.rowId);
+                                    if (r && selContentMeta.cellIdx < r.cells.length) {
+                                      dropContent(selContentMeta.rowId, selContentMeta.cellIdx, {
+                                        kind: "new",
+                                        contentType: bt.type,
+                                        insertAt: null
+                                      });
+                                      return;
+                                    }
+                                  }
+                                  if (selectedRowId) {
+                                    const targetRow = rows.find((r) => r.id === selectedRowId);
+                                    if (targetRow) {
+                                      dropContent(targetRow.id, 0, {
+                                        kind: "new",
+                                        contentType: bt.type,
+                                        insertAt: null
+                                      });
+                                      return;
+                                    }
+                                  }
+                                  const main = rows[0];
+                                  dropContent(main.id, 0, { kind: "new", contentType: bt.type, insertAt: null });
                                 },
-                                title: `Drag into a cell or click to add to ${selectedRowId ? "selected row" : "last row"}`,
+                                title: selContentMeta?.inner ? "Click to add inside the selected nested column" : selContentMeta?.rowId ? "Click to add in the selected column" : selectedRowId ? "Click to add to column 1 of the selected row" : "Click to add to the first row, first column",
                                 style: {
                                   display: "flex",
                                   flexDirection: "row",