@toolbox-web/grid 1.12.1 → 1.14.0

package/lib/plugins/clipboard/index.js

@@ -1,4 +1,4 @@
-const b = '<svg viewBox="0 0 16 16" width="12" height="12"><path fill="currentColor" d="M6 10.5a.5.5 0 0 1 .5-.5h3a.5.5 0 0 1 0 1h-3a.5.5 0 0 1-.5-.5zm-2-3a.5.5 0 0 1 .5-.5h7a.5.5 0 0 1 0 1h-7a.5.5 0 0 1-.5-.5zm-2-3a.5.5 0 0 1 .5-.5h11a.5.5 0 0 1 0 1h-11a.5.5 0 0 1-.5-.5z"/></svg>', x = {
+const b = '<svg viewBox="0 0 16 16" width="12" height="12"><path fill="currentColor" d="M6 10.5a.5.5 0 0 1 .5-.5h3a.5.5 0 0 1 0 1h-3a.5.5 0 0 1-.5-.5zm-2-3a.5.5 0 0 1 .5-.5h7a.5.5 0 0 1 0 1h-7a.5.5 0 0 1-.5-.5zm-2-3a.5.5 0 0 1 .5-.5h11a.5.5 0 0 1 0 1h-11a.5.5 0 0 1-.5-.5z"/></svg>', R = {
   expand: "▶",
   collapse: "▼",
   sortAsc: "▲",
@@ -11,7 +11,7 @@ const b = '<svg viewBox="0 0 16 16" width="12" height="12"><path fill="currentCo
   filterActive: b,
   print: "🖨️"
 };
-class v {
+class x {
   /**
    * Plugin dependencies - declare other plugins this one requires.
    *
@@ -74,7 +74,7 @@ class v {
    * Created fresh in attach(), aborted in detach().
    * This ensures event listeners are properly cleaned up when plugins are re-attached.
    */
-  #t;
+  #e;
   /**
    * Default configuration - subclasses should override this getter.
    * Note: This must be a getter (not property initializer) for proper inheritance
@@ -83,8 +83,8 @@ class v {
   get defaultConfig() {
     return {};
   }
-  constructor(t = {}) {
-    this.userConfig = t;
+  constructor(e = {}) {
+    this.userConfig = e;
   }
   /**
    * Called when the plugin is attached to a grid.
@@ -101,8 +101,8 @@ class v {
    * }
    * ```
    */
-  attach(t) {
-    this.#t?.abort(), this.#t = new AbortController(), this.grid = t, this.config = { ...this.defaultConfig, ...this.userConfig };
+  attach(e) {
+    this.#e?.abort(), this.#e = new AbortController(), this.grid = e, this.config = { ...this.defaultConfig, ...this.userConfig };
   }
   /**
    * Called when the plugin is detached from a grid.
@@ -118,7 +118,7 @@ class v {
    * ```
    */
   detach() {
-    this.#t?.abort(), this.#t = void 0;
+    this.#e?.abort(), this.#e = void 0;
   }
   /**
    * Get another plugin instance from the same grid.
@@ -132,22 +132,22 @@ class v {
    * }
    * ```
    */
-  getPlugin(t) {
-    return this.grid?.getPlugin(t);
+  getPlugin(e) {
+    return this.grid?.getPlugin(e);
   }
   /**
    * Emit a custom event from the grid.
    */
-  emit(t, e) {
-    this.grid?.dispatchEvent?.(new CustomEvent(t, { detail: e, bubbles: !0 }));
+  emit(e, t) {
+    this.grid?.dispatchEvent?.(new CustomEvent(e, { detail: t, 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;
+  emitCancelable(e, t) {
+    const n = new CustomEvent(e, { detail: t, bubbles: !0, cancelable: !0 });
+    return this.grid?.dispatchEvent?.(n), n.defaultPrevented;
   }
   // =========================================================================
   // Event Bus - Plugin-to-Plugin Communication
@@ -168,8 +168,8 @@ class v {
    * });
    * ```
    */
-  on(t, e) {
-    this.grid?._pluginManager?.subscribe(this, t, e);
+  on(e, t) {
+    this.grid?._pluginManager?.subscribe(this, e, t);
   }
   /**
    * Unsubscribe from a plugin event.
@@ -182,8 +182,8 @@ class v {
    * this.off('filter-change');
    * ```
    */
-  off(t) {
-    this.grid?._pluginManager?.unsubscribe(this, t);
+  off(e) {
+    this.grid?._pluginManager?.unsubscribe(this, e);
   }
   /**
    * Emit an event to other plugins via the Event Bus.
@@ -203,8 +203,8 @@ class v {
    * this.emit('filter-change', { field: 'name', value: 'Alice' });
    * ```
    */
-  emitPluginEvent(t, e) {
-    this.grid?._pluginManager?.emitPluginEvent(t, e);
+  emitPluginEvent(e, t) {
+    this.grid?._pluginManager?.emitPluginEvent(e, t);
   }
   /**
    * Request a re-render of the grid.
@@ -293,15 +293,15 @@ class v {
    * document.addEventListener('keydown', handler, { signal: this.disconnectSignal });
    */
   get disconnectSignal() {
-    return this.#t?.signal ?? this.grid?.disconnectSignal;
+    return this.#e?.signal ?? this.grid?.disconnectSignal;
   }
   /**
    * Get the grid-level icons configuration.
    * Returns merged icons (user config + defaults).
    */
   get gridIcons() {
-    const t = this.grid?.gridConfig?.icons ?? {};
-    return { ...x, ...t };
+    const e = this.grid?.gridConfig?.icons ?? {};
+    return { ...R, ...e };
   }
   // #region Animation Helpers
   /**
@@ -321,11 +321,11 @@ class v {
    * ```
    */
   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;
+    const e = this.grid?.effectiveConfig?.animation?.mode ?? "reduced-motion";
+    if (e === !1 || e === "off") return !1;
+    if (e === !0 || e === "on") return !0;
+    const t = this.gridElement;
+    return t ? getComputedStyle(t).getPropertyValue("--tbw-animation-enabled").trim() !== "0" : !0;
   }
   /**
    * Get the animation duration in milliseconds from CSS variable.
@@ -340,10 +340,10 @@ class v {
    * ```
    */
   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;
+    const e = this.gridElement;
+    if (e) {
+      const t = getComputedStyle(e).getPropertyValue("--tbw-animation-duration").trim(), n = parseInt(t, 10);
+      if (!isNaN(n)) return n;
     }
     return 200;
   }
@@ -356,8 +356,8 @@ class v {
    * @param pluginOverride - Optional plugin-level override
    * @returns The resolved icon value
    */
-  resolveIcon(t, e) {
-    return e !== void 0 ? e : this.gridIcons[t];
+  resolveIcon(e, t) {
+    return t !== void 0 ? t : this.gridIcons[e];
   }
   /**
    * Set an icon value on an element.
@@ -366,75 +366,86 @@ class v {
    * @param element - The element to set the icon on
    * @param icon - The icon value (string or HTMLElement)
    */
-  setIcon(t, e) {
-    typeof e == "string" ? t.innerHTML = e : e instanceof HTMLElement && (t.innerHTML = "", t.appendChild(e.cloneNode(!0)));
+  setIcon(e, t) {
+    typeof t == "string" ? e.innerHTML = t : t instanceof HTMLElement && (e.innerHTML = "", e.appendChild(t.cloneNode(!0)));
   }
   /**
    * Log a warning message.
    */
-  warn(t) {
-    console.warn(`[tbw-grid:${this.name}] ${t}`);
+  warn(e) {
+    console.warn(`[tbw-grid:${this.name}] ${e}`);
   }
   // #endregion
 }
-function E(g) {
-  return g.meta?.utility === !0;
+function C(a, e, t = !0) {
+  let n = a;
+  if (t && (n = n.filter((s) => !s.hidden && !s.field.startsWith("__") && s.meta?.utility !== !0)), e?.length) {
+    const s = new Set(e);
+    n = n.filter((r) => s.has(r.field));
+  }
+  return n;
+}
+function E(a, e) {
+  return e?.length ? [...e].sort((t, n) => t - n).map((t) => a[t]).filter((t) => t != null) : a;
 }
-async function R(g) {
+function I(a) {
+  return a == null ? "" : a instanceof Date ? a.toISOString() : typeof a == "object" ? JSON.stringify(a) : String(a);
+}
+async function v(a) {
   try {
-    return await navigator.clipboard.writeText(g), !0;
+    return await navigator.clipboard.writeText(a), !0;
   } catch {
-    const t = document.createElement("textarea");
-    t.value = g, 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;
+    const e = document.createElement("textarea");
+    e.value = a, 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;
   }
 }
-function y(g, t) {
-  const e = t.delimiter ?? "	", o = t.newline ?? `
-`, l = g.replace(/\r\n/g, `
+function y(a, e) {
+  const t = e.delimiter ?? "	", n = e.newline ?? `
+`, s = a.replace(/\r\n/g, `
 `).replace(/\r/g, `
-`), n = [];
-  let s = [], r = "", a = !1;
-  for (let i = 0; i < l.length; i++) {
-    const u = l[i];
-    u === '"' && !a ? a = !0 : u === '"' && a ? l[i + 1] === '"' ? (r += '"', i++) : a = !1 : u === e && !a ? (s.push(r), r = "") : u === o && !a ? (s.push(r), r = "", (s.length > 1 || s.some((d) => d.trim() !== "")) && n.push(s), s = []) : r += u;
+`), r = [];
+  let o = [], l = "", c = !1;
+  for (let i = 0; i < s.length; i++) {
+    const d = s[i];
+    d === '"' && !c ? c = !0 : d === '"' && c ? s[i + 1] === '"' ? (l += '"', i++) : c = !1 : d === t && !c ? (o.push(l), l = "") : d === n && !c ? (o.push(l), l = "", (o.length > 1 || o.some((u) => u.trim() !== "")) && r.push(o), o = []) : l += d;
   }
-  return s.push(r), (s.length > 1 || s.some((i) => i.trim() !== "")) && n.push(s), n;
+  return o.push(l), (o.length > 1 || o.some((i) => i.trim() !== "")) && r.push(o), r;
 }
-async function I() {
+async function S() {
   try {
     return await navigator.clipboard.readText();
   } catch {
     return "";
   }
 }
-function _(g, t) {
-  const { rows: e, target: o, fields: l } = g;
-  if (!o) return;
-  const n = t.rows, s = t.effectiveConfig.columns ?? [], r = s.map((d) => d.field), a = /* @__PURE__ */ new Map();
-  s.forEach((d) => {
-    a.set(d.field, d.editable === !0);
+function _(a, e) {
+  const { rows: t, target: n, fields: s } = a;
+  if (!n) return;
+  const r = e.rows, o = e.effectiveConfig.columns ?? [], l = o.map((u) => u.field), c = /* @__PURE__ */ new Map();
+  o.forEach((u) => {
+    c.set(u.field, u.editable === !0);
   });
-  const i = [...n], u = o.bounds ? o.bounds.endRow : 1 / 0;
-  e.forEach((d, w) => {
-    const h = o.row + w;
-    if (!(h > u)) {
-      if (o.bounds) {
-        if (h >= i.length)
+  const i = [...r], d = n.bounds ? n.bounds.endRow : 1 / 0;
+  t.forEach((u, g) => {
+    const f = n.row + g;
+    if (!(f > d)) {
+      if (n.bounds) {
+        if (f >= i.length)
           return;
-      } else for (; h >= i.length; ) {
-        const c = {};
-        r.forEach((f) => c[f] = ""), i.push(c);
+      } else for (; f >= i.length; ) {
+        const m = {};
+        l.forEach((p) => m[p] = ""), i.push(m);
       }
-      i[h] = { ...i[h] }, d.forEach((c, f) => {
-        const m = l[f];
-        m && a.get(m) && (i[h][m] = c);
+      i[f] = { ...i[f] }, u.forEach((m, p) => {
+        const h = s[p];
+        h && c.get(h) && (i[f][h] = m);
       });
     }
-  }), t.rows = i;
+  }), e.rows = i;
 }
-class D extends v {
+class M extends x {
   /**
    * Plugin dependencies - ClipboardPlugin works best with SelectionPlugin.
    *
@@ -463,10 +474,10 @@ class D extends v {
   // #endregion
   // #region Lifecycle
   /** @internal */
-  attach(t) {
-    super.attach(t), t.addEventListener(
+  attach(e) {
+    super.attach(e), e.addEventListener(
       "paste",
-      (e) => this.#o(e),
+      (t) => this.#r(t),
       { signal: this.disconnectSignal }
     );
   }
@@ -477,51 +488,28 @@ class D extends v {
   // #endregion
   // #region Event Handlers
   /** @internal */
-  onKeyDown(t) {
-    return (t.ctrlKey || t.metaKey) && t.key === "c" ? (this.#t(t.target), !0) : !1;
+  onKeyDown(e) {
+    return (e.ctrlKey || e.metaKey) && e.key === "c" ? (this.#e(e.target), !0) : !1;
   }
   // #endregion
   // #region Private Methods
   /**
-   * Handle copy operation.
+   * Handle copy operation from keyboard shortcut.
    *
-   * 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 = this.columns.length - 1, l = this.rows.length - 1;
-    let n;
-    if (e && e.ranges.length > 0) {
-      const { mode: r, ranges: a } = e, i = a[a.length - 1];
-      r === "row" ? n = {
-        startRow: i.from.row,
-        startCol: 0,
-        endRow: i.to.row,
-        endCol: o
-      } : n = {
-        startRow: i.from.row,
-        startCol: i.from.col,
-        endRow: i.to.row,
-        endCol: i.to.col
-      };
-    } else if (!e)
-      n = { startRow: 0, startCol: 0, endRow: l, endCol: o };
-    else {
-      const r = this.#r(t);
-      if (!r) return;
-      n = { startRow: r.row, startCol: r.col, endRow: r.row, endCol: r.col };
+   * For keyboard-triggered copies, respects the current selection or
+   * falls back to the focused cell from the DOM.
+   */
+  #e(e) {
+    const t = this.#t();
+    if (t && t.ranges.length === 0) {
+      const n = this.#o(e);
+      if (!n) return;
+      const s = this.columns[n.col];
+      if (!s) return;
+      this.copy({ rowIndices: [n.row], columns: [s.field] });
+      return;
     }
-    const s = this.#n(n);
-    R(s.text).then(() => {
-      this.lastCopied = { text: s.text, timestamp: Date.now() }, this.emit("copy", {
-        text: s.text,
-        rowCount: s.rowCount,
-        columnCount: s.columnCount
-      });
-    });
+    this.copy();
   }
   /**
    * Handle native paste event (preferred method - works in iframes).
@@ -538,17 +526,17 @@ class D extends v {
    * - Range/row: paste is clipped to fit within selection bounds
    * - No selection: paste starts at row 0, col 0
    */
-  #o(t) {
-    const e = t.clipboardData?.getData("text/plain");
-    if (!e) return;
-    t.preventDefault();
-    const o = y(e, this.config), l = this.#e(), n = l?.ranges?.[0], s = n?.from.row ?? 0, r = n?.from.col ?? 0, i = n && (l?.mode === "range" || l?.mode === "row") && (n.from.row !== n.to.row || n.from.col !== n.to.col) ? { endRow: n.to.row, endCol: n.to.col } : null, u = i?.endCol ?? this.columns.length - 1, d = this.columns[r], w = d ? { row: s, col: r, field: d.field, bounds: i } : null, h = [], c = o[0]?.length ?? 0;
-    for (let m = 0; m < c && r + m <= u; m++) {
-      const p = this.columns[r + m];
-      p && !p.hidden && h.push(p.field);
+  #r(e) {
+    const t = e.clipboardData?.getData("text/plain");
+    if (!t) return;
+    e.preventDefault();
+    const n = y(t, this.config), s = this.#t(), r = s?.ranges?.[0], o = r?.from.row ?? 0, l = r?.from.col ?? 0, i = r && (s?.mode === "range" || s?.mode === "row") && (r.from.row !== r.to.row || r.from.col !== r.to.col) ? { endRow: r.to.row, endCol: r.to.col } : null, d = i?.endCol ?? this.columns.length - 1, u = this.columns[l], g = u ? { row: o, col: l, field: u.field, bounds: i } : null, f = [], m = n[0]?.length ?? 0;
+    for (let h = 0; h < m && l + h <= d; h++) {
+      const w = this.columns[l + h];
+      w && !w.hidden && f.push(w.field);
     }
-    const f = { rows: o, text: e, target: w, fields: h };
-    this.emit("paste", f), this.#s(f);
+    const p = { rows: n, text: t, target: g, fields: f };
+    this.emit("paste", p), this.#i(p);
   }
   /**
    * Apply the paste handler to update grid data.
@@ -556,102 +544,179 @@ class D extends v {
    * Uses the configured `pasteHandler`, or the default handler if not specified.
    * Set `pasteHandler: null` in config to disable auto-paste.
    */
-  #s(t) {
+  #i(e) {
     if (!this.grid) return;
-    const { pasteHandler: e } = this.config;
-    if (e === null) return;
-    (e ?? _)(t, this.grid);
+    const { pasteHandler: t } = this.config;
+    if (t === null) return;
+    (t ?? _)(e, this.grid);
   }
   /**
    * Get the current selection via Query System.
    * Returns undefined if no selection plugin is loaded or nothing is selected.
    */
-  #e() {
-    return this.grid?.query("getSelection", void 0)?.[0];
+  #t() {
+    return this.grid?.query("getSelection")?.[0];
   }
   /**
-   * Build text for a rectangular range of cells.
-   * Utility columns (like expander columns) are automatically excluded.
+   * Resolve columns and rows to include based on options and/or current selection.
+   *
+   * Priority for columns:
+   *   1. `options.columns` (explicit field list)
+   *   2. Selection range column bounds (range/cell mode only)
+   *   3. All visible non-utility columns
+   *
+   * Priority for rows:
+   *   1. `options.rowIndices` (explicit indices)
+   *   2. Selection range row bounds
+   *   3. All rows
    */
-  #n(t) {
-    const { startRow: e, startCol: o, endRow: l, endCol: n } = t, s = Math.min(e, l), r = Math.max(e, l), a = Math.min(o, n), i = Math.max(o, n), u = this.config.delimiter ?? "	", d = this.config.newline ?? `
-`, w = [], h = this.columns.slice(a, i + 1).filter((c) => !E(c));
-    if (this.config.includeHeaders) {
-      const c = h.map((f) => f.header || f.field);
-      w.push(c.join(u));
-    }
-    for (let c = s; c <= r; c++) {
-      const f = this.rows[c];
-      if (!f) continue;
-      const m = h.map((p) => {
-        const C = f[p.field];
-        return C == null ? "" : C instanceof Date ? C.toISOString() : String(C);
+  #n(e) {
+    const t = this.#t();
+    let n;
+    if (e?.columns)
+      n = C(this.columns, e.columns);
+    else if (t?.ranges.length && t.mode !== "row") {
+      const r = t.ranges[t.ranges.length - 1], o = Math.min(r.from.col, r.to.col), l = Math.max(r.from.col, r.to.col);
+      n = C(this.columns.slice(o, l + 1));
+    } else
+      n = C(this.columns);
+    let s;
+    if (e?.rowIndices)
+      s = E(this.rows, e.rowIndices);
+    else if (t?.ranges.length) {
+      const r = t.ranges[t.ranges.length - 1], o = Math.min(r.from.row, r.to.row), l = Math.max(r.from.row, r.to.row);
+      s = [];
+      for (let c = o; c <= l; c++) {
+        const i = this.rows[c];
+        i && s.push(i);
+      }
+    } else
+      s = this.rows;
+    return { columns: n, rows: s };
+  }
+  /**
+   * Build delimited text from resolved columns and rows.
+   */
+  #s(e, t, n) {
+    const s = n?.delimiter ?? this.config.delimiter ?? "	", r = n?.newline ?? this.config.newline ?? `
+`, o = n?.includeHeaders ?? this.config.includeHeaders ?? !1, l = n?.processCell ?? this.config.processCell, c = [];
+    o && c.push(e.map((i) => i.header || i.field).join(s));
+    for (const i of t) {
+      const d = e.map((u) => {
+        const g = i[u.field];
+        return l ? l(g, u.field, i) : I(g);
       });
-      w.push(m.join(u));
+      c.push(d.join(s));
     }
-    return {
-      text: w.join(d),
-      rowCount: r - s + 1,
-      columnCount: i - a + 1
-    };
+    return c.join(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, l = e.dataset.row;
-    if (!o || !l) return null;
-    const n = parseInt(l, 10);
-    if (isNaN(n)) return null;
-    const s = this.columns.findIndex((r) => r.field === o);
-    return s === -1 ? null : { row: n, col: s };
+  #o(e) {
+    const t = e.closest("[data-field-cache]");
+    if (!t) return null;
+    const n = t.dataset.fieldCache, s = t.dataset.row;
+    if (!n || !s) return null;
+    const r = parseInt(s, 10);
+    if (isNaN(r)) return null;
+    const o = this.columns.findIndex((l) => l.field === n);
+    return o === -1 ? null : { row: r, col: o };
   }
   // #endregion
   // #region Public API
   /**
-   * Copy currently selected rows to clipboard.
+   * Get the text representation of the current selection (or specified data)
+   * without writing to the system clipboard.
+   *
+   * Useful for previewing what would be copied, or for feeding the text into
+   * a custom UI (e.g., a "copy with column picker" dialog).
+   *
+   * @param options - Control which columns/rows to include
+   * @returns Delimited text, or empty string if nothing to copy
+   *
+   * @example Get text for specific columns
+   * ```ts
+   * const clipboard = grid.getPlugin(ClipboardPlugin);
+   * const text = clipboard.getSelectionAsText({
+   *   columns: ['name', 'email'],
+   *   includeHeaders: true,
+   * });
+   * console.log(text);
+   * // "Name\tEmail\nAlice\talice@example.com\n..."
+   * ```
+   */
+  getSelectionAsText(e) {
+    const { columns: t, rows: n } = this.#n(e);
+    return t.length === 0 || n.length === 0 ? "" : this.#s(t, n, e);
+  }
+  /**
+   * Copy data to the system clipboard.
+   *
+   * Without options, copies the current selection (or entire grid if no selection).
+   * With options, copies exactly the specified columns and/or rows — ideal for
+   * "copy with column picker" workflows where the user selects rows first,
+   * then chooses which columns to include via a dialog.
+   *
+   * @param options - Control which columns/rows to include
    * @returns The copied text
+   *
+   * @example Copy current selection (default)
+   * ```ts
+   * const clipboard = grid.getPlugin(ClipboardPlugin);
+   * await clipboard.copy();
+   * ```
+   *
+   * @example Copy specific columns from specific rows
+   * ```ts
+   * // User selected rows in the grid, then picked columns in a dialog
+   * const selectedRowIndices = [0, 3, 7];
+   * const chosenColumns = ['name', 'department', 'salary'];
+   * await clipboard.copy({
+   *   rowIndices: selectedRowIndices,
+   *   columns: chosenColumns,
+   *   includeHeaders: true,
+   * });
+   * ```
    */
-  async copy() {
-    const t = this.#e(), e = this.columns.length - 1;
-    let o = { startRow: 0, startCol: 0, endRow: this.rows.length - 1, endCol: e };
-    if (t && t.ranges.length > 0) {
-      const n = t.ranges[t.ranges.length - 1];
-      t.mode === "row" ? o = { startRow: n.from.row, startCol: 0, endRow: n.to.row, endCol: e } : o = {
-        startRow: n.from.row,
-        startCol: n.from.col,
-        endRow: n.to.row,
-        endCol: n.to.col
-      };
-    }
-    const l = this.#n(o);
-    return await R(l.text), this.lastCopied = { text: l.text, timestamp: Date.now() }, l.text;
+  async copy(e) {
+    const { columns: t, rows: n } = this.#n(e);
+    if (t.length === 0 || n.length === 0) return "";
+    const s = this.#s(t, n, e);
+    return await v(s), this.lastCopied = { text: s, timestamp: Date.now() }, this.emit("copy", {
+      text: s,
+      rowCount: n.length,
+      columnCount: t.length
+    }), s;
   }
   /**
    * Copy specific rows by index to clipboard.
+   *
+   * Convenience wrapper around {@link copy} for row-based workflows.
+   * Supports non-contiguous row indices (e.g., `[0, 3, 7]`).
+   *
    * @param indices - Array of row indices to copy
+   * @param options - Additional copy options (columns, headers, etc.)
    * @returns The copied text
+   *
+   * @example
+   * ```ts
+   * const clipboard = grid.getPlugin(ClipboardPlugin);
+   * // Copy only rows 0 and 5, including just name and email columns
+   * await clipboard.copyRows([0, 5], { columns: ['name', 'email'] });
+   * ```
    */
-  async copyRows(t) {
-    if (t.length === 0) return "";
-    const e = [...t].sort((s, r) => s - r), o = this.columns.length - 1, l = {
-      startRow: e[0],
-      startCol: 0,
-      endRow: e[e.length - 1],
-      endCol: o
-    }, n = this.#n(l);
-    return await R(n.text), this.lastCopied = { text: n.text, timestamp: Date.now() }, n.text;
+  async copyRows(e, t) {
+    return e.length === 0 ? "" : this.copy({ ...t, rowIndices: e });
   }
   /**
    * Read and parse clipboard content.
    * @returns Parsed 2D array of cell values, or null if clipboard is empty
    */
   async paste() {
-    const t = await I();
-    return t ? y(t, this.config) : null;
+    const e = await S();
+    return e ? y(e, this.config) : null;
   }
   /**
    * Get the last copied text and timestamp.
@@ -663,7 +728,7 @@ class D extends v {
   // #endregion
 }
 export {
-  D as ClipboardPlugin,
+  M as ClipboardPlugin,
   _ as defaultPasteHandler
 };
 //# sourceMappingURL=index.js.map