@toolbox-web/grid 0.4.1 → 0.5.0

package/lib/plugins/clipboard/index.js

@@ -1,4 +1,4 @@
-const R = {
+const b = {
   expand: "▶",
   collapse: "▼",
   sortAsc: "▲",
@@ -8,7 +8,7 @@ const R = {
   dragHandle: "⋮⋮",
   toolPanel: "☰"
 };
-class I {
+class x {
   /**
    * Plugin dependencies - declare other plugins this one requires.
    *
@@ -25,8 +25,11 @@ class I {
    * ```
    */
   static dependencies;
-  /** Plugin version - override in subclass if needed */
-  version = "1.0.0";
+  /**
+   * Plugin version - defaults to grid version for built-in plugins.
+   * Third-party plugins can override with their own semver.
+   */
+  version = typeof __GRID_VERSION__ < "u" ? __GRID_VERSION__ : "dev";
   /** CSS styles to inject into the grid's shadow DOM */
   styles;
   /** Custom cell renderers keyed by type name */
@@ -46,7 +49,7 @@ class I {
    * Created fresh in attach(), aborted in detach().
    * This ensures event listeners are properly cleaned up when plugins are re-attached.
    */
-  #e;
+  #t;
   /**
    * Default configuration - subclasses should override this getter.
    * Note: This must be a getter (not property initializer) for proper inheritance
@@ -55,8 +58,8 @@ class I {
   get defaultConfig() {
     return {};
   }
-  constructor(e = {}) {
-    this.userConfig = e;
+  constructor(t = {}) {
+    this.userConfig = t;
   }
   /**
    * Called when the plugin is attached to a grid.
@@ -73,8 +76,8 @@ class I {
    * }
    * ```
    */
-  attach(e) {
-    this.#e?.abort(), this.#e = new AbortController(), this.grid = e, this.config = { ...this.defaultConfig, ...this.userConfig };
+  attach(t) {
+    this.#t?.abort(), this.#t = new AbortController(), this.grid = t, this.config = { ...this.defaultConfig, ...this.userConfig };
   }
   /**
    * Called when the plugin is detached from a grid.
@@ -90,7 +93,7 @@ class I {
    * ```
    */
   detach() {
-    this.#e?.abort(), this.#e = void 0;
+    this.#t?.abort(), this.#t = void 0;
   }
   /**
    * Get another plugin instance from the same grid.
@@ -104,14 +107,22 @@ class I {
    * }
    * ```
    */
-  getPlugin(e) {
-    return this.grid?.getPlugin(e);
+  getPlugin(t) {
+    return this.grid?.getPlugin(t);
   }
   /**
    * Emit a custom event from the grid.
    */
-  emit(e, t) {
-    this.grid?.dispatchEvent?.(new CustomEvent(e, { detail: t, bubbles: !0 }));
+  emit(t, e) {
+    this.grid?.dispatchEvent?.(new CustomEvent(t, { detail: e, bubbles: !0 }));
+  }
+  /**
+   * Emit a cancelable custom event from the grid.
+   * @returns `true` if the event was cancelled (preventDefault called), `false` otherwise
+   */
+  emitCancelable(t, e) {
+    const o = new CustomEvent(t, { detail: e, bubbles: !0, cancelable: !0 });
+    return this.grid?.dispatchEvent?.(o), o.defaultPrevented;
   }
   /**
    * Request a re-render of the grid.
@@ -119,6 +130,14 @@ class I {
   requestRender() {
     this.grid?.requestRender?.();
   }
+  /**
+   * Request a re-render and restore focus styling afterward.
+   * Use this when a plugin action (like expand/collapse) triggers a render
+   * but needs to maintain keyboard navigation focus.
+   */
+  requestRenderWithFocus() {
+    this.grid?.requestRenderWithFocus?.();
+  }
   /**
    * Request a lightweight style update without rebuilding DOM.
    * Use this instead of requestRender() when only CSS classes need updating.
@@ -153,10 +172,34 @@ class I {
     return this.grid?._visibleColumns ?? [];
   }
   /**
-   * Get the shadow root of the grid.
+   * Get the grid as an HTMLElement for direct DOM operations.
+   * Use sparingly - prefer the typed GridElementRef API when possible.
+   *
+   * @example
+   * ```ts
+   * const width = this.gridElement.clientWidth;
+   * this.gridElement.classList.add('my-plugin-active');
+   * ```
+   */
+  get gridElement() {
+    return this.grid;
+  }
+  /**
+   * Get the render root of the grid for DOM queries.
+   * @deprecated Use `gridElement` instead. This getter exists only for backward compatibility.
+   *
+   * With Shadow DOM removed, the grid element itself is the render root.
+   * All new code should use `this.gridElement` for DOM queries.
+   *
+   * @example
+   * // OLD (deprecated)
+   * const rows = this.shadowRoot?.querySelector('.rows');
+   *
+   * // NEW (preferred)
+   * const rows = this.gridElement.querySelector('.rows');
    */
   get shadowRoot() {
-    return this.grid?.shadowRoot ?? null;
+    return this.gridElement;
   }
   /**
    * Get the disconnect signal for event listener cleanup.
@@ -176,16 +219,61 @@ class I {
    * document.addEventListener('keydown', handler, { signal: this.disconnectSignal });
    */
   get disconnectSignal() {
-    return this.#e?.signal ?? this.grid?.disconnectSignal;
+    return this.#t?.signal ?? this.grid?.disconnectSignal;
   }
   /**
    * Get the grid-level icons configuration.
    * Returns merged icons (user config + defaults).
    */
   get gridIcons() {
-    const e = this.grid?.gridConfig?.icons ?? {};
-    return { ...R, ...e };
+    const t = this.grid?.gridConfig?.icons ?? {};
+    return { ...b, ...t };
+  }
+  // #region Animation Helpers
+  /**
+   * Check if animations are enabled at the grid level.
+   * Respects gridConfig.animation.mode and the CSS variable set by the grid.
+   *
+   * Plugins should use this to skip animations when:
+   * - Animation mode is 'off' or `false`
+   * - User prefers reduced motion and mode is 'reduced-motion' (default)
+   *
+   * @example
+   * ```ts
+   * private get animationStyle(): 'slide' | 'fade' | false {
+   *   if (!this.isAnimationEnabled) return false;
+   *   return this.config.animation ?? 'slide';
+   * }
+   * ```
+   */
+  get isAnimationEnabled() {
+    const t = this.grid?.effectiveConfig?.animation?.mode ?? "reduced-motion";
+    if (t === !1 || t === "off") return !1;
+    if (t === !0 || t === "on") return !0;
+    const e = this.gridElement;
+    return e ? getComputedStyle(e).getPropertyValue("--tbw-animation-enabled").trim() !== "0" : !0;
+  }
+  /**
+   * Get the animation duration in milliseconds from CSS variable.
+   * Falls back to 200ms if not set.
+   *
+   * Plugins can use this for their animation timing to stay consistent
+   * with the grid-level animation.duration setting.
+   *
+   * @example
+   * ```ts
+   * element.animate(keyframes, { duration: this.animationDuration });
+   * ```
+   */
+  get animationDuration() {
+    const t = this.gridElement;
+    if (t) {
+      const e = getComputedStyle(t).getPropertyValue("--tbw-animation-duration").trim(), o = parseInt(e, 10);
+      if (!isNaN(o)) return o;
+    }
+    return 200;
   }
+  // #endregion
   /**
    * Resolve an icon value to string or HTMLElement.
    * Checks plugin config first, then grid-level icons, then defaults.
@@ -194,8 +282,8 @@ class I {
    * @param pluginOverride - Optional plugin-level override
    * @returns The resolved icon value
    */
-  resolveIcon(e, t) {
-    return t !== void 0 ? t : this.gridIcons[e];
+  resolveIcon(t, e) {
+    return e !== void 0 ? e : this.gridIcons[t];
   }
   /**
    * Set an icon value on an element.
@@ -204,88 +292,81 @@ class I {
    * @param element - The element to set the icon on
    * @param icon - The icon value (string or HTMLElement)
    */
-  setIcon(e, t) {
-    typeof t == "string" ? e.innerHTML = t : t instanceof HTMLElement && (e.innerHTML = "", e.appendChild(t.cloneNode(!0)));
+  setIcon(t, e) {
+    typeof e == "string" ? t.innerHTML = e : e instanceof HTMLElement && (t.innerHTML = "", t.appendChild(e.cloneNode(!0)));
   }
   /**
    * Log a warning message.
    */
-  warn(e) {
-    console.warn(`[tbw-grid:${this.name}] ${e}`);
+  warn(t) {
+    console.warn(`[tbw-grid:${this.name}] ${t}`);
   }
   // #endregion
 }
-function P(h, e, t, n) {
-  if (n.processCell)
-    return n.processCell(h, e, t);
-  if (h == null) return "";
-  if (h instanceof Date) return h.toISOString();
-  if (typeof h == "object") return JSON.stringify(h);
-  const i = String(h), l = n.delimiter ?? "	", o = n.newline ?? `
-`;
-  return n.quoteStrings || i.includes(l) || i.includes(o) || i.includes('"') ? `"${i.replace(/"/g, '""')}"` : i;
+function v(h) {
+  return h.meta?.utility === !0;
 }
-function p(h) {
-  const { rows: e, columns: t, selectedIndices: n, config: i } = h, l = i.delimiter ?? "	", o = i.newline ?? `
-`, r = t.filter((s) => !s.hidden && !s.field.startsWith("__")), c = [];
-  if (i.includeHeaders) {
-    const s = r.map((d) => {
-      const f = d.header || d.field;
-      return f.includes(l) || f.includes(o) || f.includes('"') ? `"${f.replace(/"/g, '""')}"` : f;
-    });
-    c.push(s.join(l));
-  }
-  const u = [...n instanceof Set ? [...n] : n].sort((s, d) => s - d);
-  for (const s of u) {
-    const d = e[s];
-    if (!d) continue;
-    const f = r.map(
-      (g) => P(d[g.field], g.field, d, i)
-    );
-    c.push(f.join(l));
-  }
-  return c.join(o);
-}
-async function C(h) {
+async function R(h) {
   try {
     return await navigator.clipboard.writeText(h), !0;
   } catch {
-    const e = document.createElement("textarea");
-    e.value = h, e.style.position = "fixed", e.style.opacity = "0", e.style.pointerEvents = "none", document.body.appendChild(e), e.select();
-    const t = document.execCommand("copy");
-    return document.body.removeChild(e), t;
+    const t = document.createElement("textarea");
+    t.value = h, t.style.position = "fixed", t.style.opacity = "0", t.style.pointerEvents = "none", document.body.appendChild(t), t.select();
+    const e = document.execCommand("copy");
+    return document.body.removeChild(t), e;
   }
 }
-function y(h, e) {
-  const t = e.delimiter ?? "	", n = e.newline ?? `
-`, i = h.replace(/\r\n/g, `
+function y(h, t) {
+  const e = t.delimiter ?? "	", o = t.newline ?? `
+`, a = h.replace(/\r\n/g, `
 `).replace(/\r/g, `
-`), l = [];
-  let o = [], r = "", c = !1;
-  for (let a = 0; a < i.length; a++) {
-    const u = i[a];
-    u === '"' && !c ? c = !0 : u === '"' && c ? i[a + 1] === '"' ? (r += '"', a++) : c = !1 : u === t && !c ? (o.push(r), r = "") : u === n && !c ? (o.push(r), r = "", (o.length > 1 || o.some((s) => s.trim() !== "")) && l.push(o), o = []) : r += u;
+`), r = [];
+  let n = [], i = "", s = !1;
+  for (let c = 0; c < a.length; c++) {
+    const l = a[c];
+    l === '"' && !s ? s = !0 : l === '"' && s ? a[c + 1] === '"' ? (i += '"', c++) : s = !1 : l === e && !s ? (n.push(i), i = "") : l === o && !s ? (n.push(i), i = "", (n.length > 1 || n.some((w) => w.trim() !== "")) && r.push(n), n = []) : i += l;
   }
-  return o.push(r), (o.length > 1 || o.some((a) => a.trim() !== "")) && l.push(o), l;
+  return n.push(i), (n.length > 1 || n.some((c) => c.trim() !== "")) && r.push(n), r;
 }
-async function x() {
+async function E() {
   try {
     return await navigator.clipboard.readText();
   } catch {
     return "";
   }
 }
-class T extends I {
+function I(h, t) {
+  const { rows: e, target: o, fields: a } = h;
+  if (!o) return;
+  const r = t.rows, i = (t.effectiveConfig.columns ?? []).map((l) => l.field), s = [...r], c = o.bounds ? o.bounds.endRow : 1 / 0;
+  e.forEach((l, w) => {
+    const u = o.row + w;
+    if (!(u > c)) {
+      if (o.bounds) {
+        if (u >= s.length)
+          return;
+      } else for (; u >= s.length; ) {
+        const f = {};
+        i.forEach((d) => f[d] = ""), s.push(f);
+      }
+      s[u] = { ...s[u] }, l.forEach((f, d) => {
+        const g = a[d];
+        g && (s[u][g] = f);
+      });
+    }
+  }), t.rows = s;
+}
+class P extends x {
   /**
-   * Plugin dependencies - ClipboardPlugin requires SelectionPlugin to know what to copy.
+   * Plugin dependencies - ClipboardPlugin works best with SelectionPlugin.
    *
-   * The SelectionPlugin must be loaded BEFORE this plugin in the plugins array.
+   * Without SelectionPlugin: copies entire grid, pastes at row 0 col 0.
+   * With SelectionPlugin: copies/pastes based on selection.
    */
   static dependencies = [
-    { name: "selection", required: !0, reason: "ClipboardPlugin needs selection to determine what cells to copy" }
+    { name: "selection", required: !1, reason: "Enables copy/paste of selected cells instead of entire grid" }
   ];
   name = "clipboard";
-  version = "1.0.0";
   get defaultConfig() {
     return {
       includeHeaders: !1,
@@ -300,137 +381,153 @@ class T extends I {
   lastCopied = null;
   // #endregion
   // #region Lifecycle
+  attach(t) {
+    super.attach(t), t.addEventListener(
+      "paste",
+      (e) => this.#o(e),
+      { signal: this.disconnectSignal }
+    );
+  }
   detach() {
     this.lastCopied = null;
   }
   // #endregion
   // #region Event Handlers
-  onKeyDown(e) {
-    const t = (e.ctrlKey || e.metaKey) && e.key === "c", n = (e.ctrlKey || e.metaKey) && e.key === "v";
-    return t ? (this.#e(e.target), !0) : n ? (this.#n(), !0) : !1;
+  onKeyDown(t) {
+    return (t.ctrlKey || t.metaKey) && t.key === "c" ? (this.#t(t.target), !0) : !1;
   }
   // #endregion
   // #region Private Methods
   /**
-   * Handle copy operation
-   */
-  #e(e) {
-    const t = this.#t(), n = t?.getSelectedRows() ?? [], i = n.length > 0, l = t?.getRanges() ?? [], o = l.length > 0, r = t?.getSelectedCell() != null;
-    let c, a, u;
-    if (i && t)
-      c = p({
-        rows: this.rows,
-        columns: [...this.columns],
-        selectedIndices: n,
-        config: this.config
-      }), a = n.length, u = this.columns.filter((s) => !s.hidden && !s.field.startsWith("__")).length;
-    else if (o && t) {
-      const s = l[l.length - 1], d = this.#i({
-        startRow: s.from.row,
-        startCol: s.from.col,
-        endRow: s.to.row,
-        endCol: s.to.col
-      });
-      c = d.text, a = d.rowCount, u = d.columnCount;
-    } else if (r && t) {
-      const s = t.getSelectedCell(), d = this.#s(s.row, s.col);
-      if (!d) return;
-      c = d.text, a = 1, u = 1;
-    } else {
-      const s = this.#o(e);
+   * Handle copy operation.
+   *
+   * Everything is treated as a range:
+   * - With selection: copies the selected range
+   * - Row mode: range spanning all columns for selected rows
+   * - No selection plugin: entire grid as a range
+   * - No selection: try to get focused cell from DOM as 1x1 range
+   */
+  #t(t) {
+    const e = this.#e(), o = e?.getSelection(), a = this.columns.length - 1, r = this.rows.length - 1;
+    let n;
+    if (o && o.ranges.length > 0) {
+      const { mode: s, ranges: c } = o, l = c[c.length - 1];
+      s === "row" ? n = {
+        startRow: l.from.row,
+        startCol: 0,
+        endRow: l.to.row,
+        endCol: a
+      } : n = {
+        startRow: l.from.row,
+        startCol: l.from.col,
+        endRow: l.to.row,
+        endCol: l.to.col
+      };
+    } else if (!e)
+      n = { startRow: 0, startCol: 0, endRow: r, endCol: a };
+    else {
+      const s = this.#r(t);
       if (!s) return;
-      c = s.text, a = 1, u = 1;
+      n = { startRow: s.row, startCol: s.col, endRow: s.row, endCol: s.col };
     }
-    C(c).then(() => {
-      this.lastCopied = { text: c, timestamp: Date.now() }, this.emit("copy", { text: c, rowCount: a, columnCount: u });
+    const i = this.#n(n);
+    R(i.text).then(() => {
+      this.lastCopied = { text: i.text, timestamp: Date.now() }, this.emit("copy", {
+        text: i.text,
+        rowCount: i.rowCount,
+        columnCount: i.columnCount
+      });
     });
   }
   /**
-   * Handle paste operation
+   * Handle native paste event (preferred method - works in iframes).
+   * Uses synchronous clipboardData from the native paste event.
+   *
+   * Flow:
+   * 1. Parse clipboard text
+   * 2. Build target/fields info from selection
+   * 3. Emit 'paste' event (for listeners)
+   * 4. Call paste handler (if configured) to apply data to grid
+   *
+   * Selection behavior:
+   * - Single cell: paste starts at cell, expands freely
+   * - Range/row: paste is clipped to fit within selection bounds
+   * - No selection: paste starts at row 0, col 0
    */
-  #n() {
-    x().then((e) => {
-      if (!e) return;
-      const t = y(e, this.config);
-      this.emit("paste", { rows: t, text: e });
-    });
+  #o(t) {
+    const e = t.clipboardData?.getData("text/plain");
+    if (!e) return;
+    t.preventDefault();
+    const o = y(e, this.config), r = this.#e()?.getSelection(), n = r?.ranges?.[0], i = n?.from.row ?? 0, s = n?.from.col ?? 0, l = n && (r?.mode === "range" || r?.mode === "row") && (n.from.row !== n.to.row || n.from.col !== n.to.col) ? { endRow: n.to.row, endCol: n.to.col } : null, w = l?.endCol ?? this.columns.length - 1, u = this.columns[s], f = u ? { row: i, col: s, field: u.field, bounds: l } : null, d = [], g = o[0]?.length ?? 0;
+    for (let p = 0; p < g && s + p <= w; p++) {
+      const m = this.columns[s + p];
+      m && !m.hidden && d.push(m.field);
+    }
+    const C = { rows: o, text: e, target: f, fields: d };
+    this.emit("paste", C), this.#s(C);
+  }
+  /**
+   * Apply the paste handler to update grid data.
+   *
+   * Uses the configured `pasteHandler`, or the default handler if not specified.
+   * Set `pasteHandler: null` in config to disable auto-paste.
+   */
+  #s(t) {
+    if (!this.grid) return;
+    const { pasteHandler: e } = this.config;
+    if (e === null) return;
+    (e ?? I)(t, this.grid);
   }
   /**
    * Get the selection plugin instance if available.
    */
-  #t() {
+  #e() {
     try {
-      const e = this.grid?.getPluginByName("selection");
-      if (e)
-        return e;
+      const t = this.grid?.getPluginByName("selection");
+      if (t)
+        return t;
     } catch {
     }
   }
-  /**
-   * Build text for a single cell by row/col index.
-   */
-  #s(e, t) {
-    const n = this.rows[e];
-    if (!n) return null;
-    const i = this.columns[t];
-    if (!i) return null;
-    const l = n[i.field], o = i.header || i.field;
-    let r;
-    if (this.config.includeHeaders) {
-      const c = l == null ? "" : String(l);
-      r = `${o}: ${c}`;
-    } else
-      r = l == null ? "" : String(l);
-    return { text: r };
-  }
   /**
    * Build text for a rectangular range of cells.
+   * Utility columns (like expander columns) are automatically excluded.
    */
-  #i(e) {
-    const { startRow: t, startCol: n, endRow: i, endCol: l } = e, o = Math.min(t, i), r = Math.max(t, i), c = Math.min(n, l), a = Math.max(n, l), u = this.config.delimiter ?? "	", s = this.config.newline ?? `
-`, d = [], f = this.columns.slice(c, a + 1);
+  #n(t) {
+    const { startRow: e, startCol: o, endRow: a, endCol: r } = t, n = Math.min(e, a), i = Math.max(e, a), s = Math.min(o, r), c = Math.max(o, r), l = this.config.delimiter ?? "	", w = this.config.newline ?? `
+`, u = [], f = this.columns.slice(s, c + 1).filter((d) => !v(d));
     if (this.config.includeHeaders) {
-      const g = f.map((m) => m.header || m.field);
-      d.push(g.join(u));
+      const d = f.map((g) => g.header || g.field);
+      u.push(d.join(l));
     }
-    for (let g = o; g <= r; g++) {
-      const m = this.rows[g];
-      if (!m) continue;
-      const b = f.map((S) => {
-        const w = m[S.field];
-        return w == null ? "" : w instanceof Date ? w.toISOString() : String(w);
+    for (let d = n; d <= i; d++) {
+      const g = this.rows[d];
+      if (!g) continue;
+      const C = f.map((p) => {
+        const m = g[p.field];
+        return m == null ? "" : m instanceof Date ? m.toISOString() : String(m);
       });
-      d.push(b.join(u));
+      u.push(C.join(l));
     }
     return {
-      text: d.join(s),
-      rowCount: r - o + 1,
-      columnCount: a - c + 1
+      text: u.join(w),
+      rowCount: i - n + 1,
+      columnCount: c - s + 1
     };
   }
   /**
-   * Build text for a single focused cell from DOM.
-   * Used when selection plugin is not available or no rows are selected.
-   */
-  #o(e) {
-    const t = e.closest("[data-field-cache]");
-    if (!t) return null;
-    const n = t.dataset.fieldCache;
-    if (!n) return null;
-    const i = t.dataset.row;
-    if (!i) return null;
-    const l = parseInt(i, 10);
-    if (isNaN(l)) return null;
-    const o = this.rows[l];
-    if (!o) return null;
-    const r = o[n], a = this.columns.find((s) => s.field === n)?.header || n;
-    let u;
-    if (this.config.includeHeaders) {
-      const s = r == null ? "" : String(r);
-      u = `${a}: ${s}`;
-    } else
-      u = r == null ? "" : String(r);
-    return { text: u, field: n, value: r };
+   * Get focused cell coordinates from DOM.
+   * Used as fallback when SelectionPlugin has no selection.
+   */
+  #r(t) {
+    const e = t.closest("[data-field-cache]");
+    if (!e) return null;
+    const o = e.dataset.fieldCache, a = e.dataset.row;
+    if (!o || !a) return null;
+    const r = parseInt(a, 10);
+    if (isNaN(r)) return null;
+    const n = this.columns.findIndex((i) => i.field === o);
+    return n === -1 ? null : { row: r, col: n };
   }
   // #endregion
   // #region Public API
@@ -439,35 +536,42 @@ class T extends I {
    * @returns The copied text
    */
   async copy() {
-    const t = this.#t()?.getSelectedRows() ?? [], n = p({
-      rows: this.rows,
-      columns: [...this.columns],
-      selectedIndices: t,
-      config: this.config
-    });
-    return await C(n), this.lastCopied = { text: n, timestamp: Date.now() }, n;
+    const e = this.#e()?.getSelection(), o = this.columns.length - 1;
+    let a = { startRow: 0, startCol: 0, endRow: this.rows.length - 1, endCol: o };
+    if (e && e.ranges.length > 0) {
+      const n = e.ranges[e.ranges.length - 1];
+      e.mode === "row" ? a = { startRow: n.from.row, startCol: 0, endRow: n.to.row, endCol: o } : a = {
+        startRow: n.from.row,
+        startCol: n.from.col,
+        endRow: n.to.row,
+        endCol: n.to.col
+      };
+    }
+    const r = this.#n(a);
+    return await R(r.text), this.lastCopied = { text: r.text, timestamp: Date.now() }, r.text;
   }
   /**
    * Copy specific rows by index to clipboard.
    * @param indices - Array of row indices to copy
    * @returns The copied text
    */
-  async copyRows(e) {
-    const t = p({
-      rows: this.rows,
-      columns: [...this.columns],
-      selectedIndices: e,
-      config: this.config
-    });
-    return await C(t), this.lastCopied = { text: t, timestamp: Date.now() }, t;
+  async copyRows(t) {
+    if (t.length === 0) return "";
+    const e = [...t].sort((n, i) => n - i), o = this.columns.length - 1, a = {
+      startRow: e[0],
+      startCol: 0,
+      endRow: e[e.length - 1],
+      endCol: o
+    }, r = this.#n(a);
+    return await R(r.text), this.lastCopied = { text: r.text, timestamp: Date.now() }, r.text;
   }
   /**
    * Read and parse clipboard content.
    * @returns Parsed 2D array of cell values, or null if clipboard is empty
    */
   async paste() {
-    const e = await x();
-    return e ? y(e, this.config) : null;
+    const t = await E();
+    return t ? y(t, this.config) : null;
   }
   /**
    * Get the last copied text and timestamp.
@@ -479,6 +583,7 @@ class T extends I {
   // #endregion
 }
 export {
-  T as ClipboardPlugin
+  P as ClipboardPlugin,
+  I as defaultPasteHandler
 };
 //# sourceMappingURL=index.js.map