@toolbox-web/grid 1.21.1 → 1.22.0

package/lib/plugins/clipboard/index.js

@@ -1,734 +1,2 @@
-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: "▲",
-  sortDesc: "▼",
-  sortNone: "⇅",
-  submenuArrow: "▶",
-  dragHandle: "⋮⋮",
-  toolPanel: "☰",
-  filter: b,
-  filterActive: b,
-  print: "🖨️"
-};
-class v {
-  /**
-   * Plugin dependencies - declare other plugins this one requires.
-   *
-   * Dependencies are validated when the plugin is attached.
-   * Required dependencies throw an error if missing.
-   * Optional dependencies log an info message if missing.
-   *
-   * @example
-   * ```typescript
-   * static readonly dependencies: PluginDependency[] = [
-   *   { name: 'editing', required: true, reason: 'Tracks cell edits for undo/redo' },
-   *   { name: 'selection', required: false, reason: 'Enables selection-based undo' },
-   * ];
-   * ```
-   */
-  static dependencies;
-  /**
-   * Plugin manifest - declares owned properties, config rules, and hook priorities.
-   *
-   * This is read by the configuration validator to:
-   * - Validate that required plugins are loaded when their properties are used
-   * - Execute configRules to detect invalid/conflicting settings
-   * - Order hook execution based on priority
-   *
-   * @example
-   * ```typescript
-   * static override readonly manifest: PluginManifest<MyConfig> = {
-   *   ownedProperties: [
-   *     { property: 'myProp', level: 'column', description: 'the "myProp" column property' },
-   *   ],
-   *   configRules: [
-   *     { id: 'myPlugin/conflict', severity: 'warn', message: '...', check: (c) => c.a && c.b },
-   *   ],
-   * };
-   * ```
-   */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  static manifest;
-  /**
-   * 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 */
-  cellRenderers;
-  /** Custom header renderers keyed by type name */
-  headerRenderers;
-  /** Custom cell editors keyed by type name */
-  cellEditors;
-  /** The grid instance this plugin is attached to */
-  grid;
-  /** Plugin configuration - merged with defaults in attach() */
-  config;
-  /** User-provided configuration from constructor */
-  userConfig;
-  /**
-   * Plugin-level AbortController for event listener cleanup.
-   * Created fresh in attach(), aborted in detach().
-   * This ensures event listeners are properly cleaned up when plugins are re-attached.
-   */
-  #e;
-  /**
-   * Default configuration - subclasses should override this getter.
-   * Note: This must be a getter (not property initializer) for proper inheritance
-   * since property initializers run after parent constructor.
-   */
-  get defaultConfig() {
-    return {};
-  }
-  constructor(e = {}) {
-    this.userConfig = e;
-  }
-  /**
-   * Called when the plugin is attached to a grid.
-   * Override to set up event listeners, initialize state, etc.
-   *
-   * @example
-   * ```ts
-   * attach(grid: GridElement): void {
-   *   super.attach(grid);
-   *   // Set up document-level listeners with auto-cleanup
-   *   document.addEventListener('keydown', this.handleEscape, {
-   *     signal: this.disconnectSignal
-   *   });
-   * }
-   * ```
-   */
-  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.
-   * Override to clean up event listeners, timers, etc.
-   *
-   * @example
-   * ```ts
-   * detach(): void {
-   *   // Clean up any state not handled by disconnectSignal
-   *   this.selectedRows.clear();
-   *   this.cache = null;
-   * }
-   * ```
-   */
-  detach() {
-    this.#e?.abort(), this.#e = void 0;
-  }
-  /**
-   * Get another plugin instance from the same grid.
-   * Use for inter-plugin communication.
-   *
-   * @example
-   * ```ts
-   * const selection = this.getPlugin(SelectionPlugin);
-   * if (selection) {
-   *   const selectedRows = selection.getSelectedRows();
-   * }
-   * ```
-   */
-  getPlugin(e) {
-    return this.grid?.getPlugin(e);
-  }
-  /**
-   * Emit a custom event from the grid.
-   */
-  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(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
-  // =========================================================================
-  /**
-   * Subscribe to an event from another plugin.
-   * The subscription is automatically cleaned up when this plugin is detached.
-   *
-   * @category Plugin Development
-   * @param eventType - The event type to listen for (e.g., 'filter-change')
-   * @param callback - The callback to invoke when the event is emitted
-   *
-   * @example
-   * ```typescript
-   * // In attach() or other initialization
-   * this.on('filter-change', (detail) => {
-   *   console.log('Filter changed:', detail);
-   * });
-   * ```
-   */
-  on(e, t) {
-    this.grid?._pluginManager?.subscribe(this, e, t);
-  }
-  /**
-   * Unsubscribe from a plugin event.
-   *
-   * @category Plugin Development
-   * @param eventType - The event type to stop listening for
-   *
-   * @example
-   * ```typescript
-   * this.off('filter-change');
-   * ```
-   */
-  off(e) {
-    this.grid?._pluginManager?.unsubscribe(this, e);
-  }
-  /**
-   * Emit an event to other plugins via the Event Bus.
-   * This is for inter-plugin communication only; it does NOT dispatch DOM events.
-   * Use `emit()` to dispatch DOM events that external consumers can listen to.
-   *
-   * @category Plugin Development
-   * @param eventType - The event type to emit (should be declared in manifest.events)
-   * @param detail - The event payload
-   *
-   * @example
-   * ```typescript
-   * // Emit to other plugins (not DOM)
-   * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });
-   *
-   * // For DOM events that consumers can addEventListener to:
-   * this.emit('filter-change', { field: 'name', value: 'Alice' });
-   * ```
-   */
-  emitPluginEvent(e, t) {
-    this.grid?._pluginManager?.emitPluginEvent(e, t);
-  }
-  /**
-   * Request a re-render of the grid.
-   * Uses ROWS phase - does NOT trigger processColumns hooks.
-   */
-  requestRender() {
-    this.grid?.requestRender?.();
-  }
-  /**
-   * Request a columns re-render of the grid.
-   * Uses COLUMNS phase - triggers processColumns hooks.
-   * Use this when your plugin needs to reprocess column configuration.
-   */
-  requestColumnsRender() {
-    this.grid?.requestColumnsRender?.();
-  }
-  /**
-   * 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.
-   */
-  requestAfterRender() {
-    this.grid?.requestAfterRender?.();
-  }
-  /**
-   * Get the current rows from the grid.
-   */
-  get rows() {
-    return this.grid?.rows ?? [];
-  }
-  /**
-   * Get the original unfiltered/unprocessed rows from the grid.
-   * Use this when you need all source data regardless of active filters.
-   */
-  get sourceRows() {
-    return this.grid?.sourceRows ?? [];
-  }
-  /**
-   * Get the current columns from the grid.
-   */
-  get columns() {
-    return this.grid?.columns ?? [];
-  }
-  /**
-   * Get only visible columns from the grid (excludes hidden).
-   * Use this for rendering that needs to match the grid template.
-   */
-  get visibleColumns() {
-    return this.grid?._visibleColumns ?? [];
-  }
-  /**
-   * 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 disconnect signal for event listener cleanup.
-   * This signal is aborted when the grid disconnects from the DOM.
-   * Use this when adding event listeners that should be cleaned up automatically.
-   *
-   * Best for:
-   * - Document/window-level listeners added in attach()
-   * - Listeners on the grid element itself
-   * - Any listener that should persist across renders
-   *
-   * Not needed for:
-   * - Listeners on elements created in afterRender() (removed with element)
-   *
-   * @example
-   * element.addEventListener('click', handler, { signal: this.disconnectSignal });
-   * document.addEventListener('keydown', handler, { signal: this.disconnectSignal });
-   */
-  get disconnectSignal() {
-    return this.#e?.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 };
-  }
-  // #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 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.
-   * 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 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;
-  }
-  // #endregion
-  /**
-   * Resolve an icon value to string or HTMLElement.
-   * Checks plugin config first, then grid-level icons, then defaults.
-   *
-   * @param iconKey - The icon key in GridIcons (e.g., 'expand', 'collapse')
-   * @param pluginOverride - Optional plugin-level override
-   * @returns The resolved icon value
-   */
-  resolveIcon(e, t) {
-    return t !== void 0 ? t : this.gridIcons[e];
-  }
-  /**
-   * Set an icon value on an element.
-   * Handles both string (text/HTML) and HTMLElement values.
-   *
-   * @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)));
-  }
-  /**
-   * Log a warning message.
-   */
-  warn(e) {
-    console.warn(`[tbw-grid:${this.name}] ${e}`);
-  }
-  // #endregion
-}
-function w(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 x(a, e) {
-  return e?.length ? [...e].sort((t, n) => t - n).map((t) => a[t]).filter((t) => t != null) : a;
-}
-function E(a) {
-  return a == null ? "" : a instanceof Date ? a.toISOString() : typeof a == "object" ? JSON.stringify(a) : String(a);
-}
-async function I(a) {
-  try {
-    return await navigator.clipboard.writeText(a), !0;
-  } catch (e) {
-    console.warn("[copyToClipboard] Clipboard API failed:", e);
-    const t = document.createElement("textarea");
-    t.value = a, t.style.position = "fixed", t.style.opacity = "0", t.style.pointerEvents = "none", document.body.appendChild(t), t.select();
-    const n = document.execCommand("copy");
-    return document.body.removeChild(t), n;
-  }
-}
-function y(a, e) {
-  const t = e.delimiter ?? "	", n = e.newline ?? `
-`, s = a.replace(/\r\n/g, `
-`).replace(/\r/g, `
-`), 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 o.push(l), (o.length > 1 || o.some((i) => i.trim() !== "")) && r.push(o), r;
-}
-async function S() {
-  try {
-    return await navigator.clipboard.readText();
-  } catch {
-    return "";
-  }
-}
-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 = [...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 (; f >= i.length; ) {
-        const m = {};
-        l.forEach((p) => m[p] = ""), i.push(m);
-      }
-      i[f] = { ...i[f] }, u.forEach((m, p) => {
-        const h = s[p];
-        h && c.get(h) && (i[f][h] = m);
-      });
-    }
-  }), e.rows = i;
-}
-class D extends v {
-  /**
-   * Plugin dependencies - ClipboardPlugin works best with SelectionPlugin.
-   *
-   * Without SelectionPlugin: copies entire grid, pastes at row 0 col 0.
-   * With SelectionPlugin: copies/pastes based on selection.
-   */
-  /** @internal */
-  static dependencies = [
-    { name: "selection", required: !1, reason: "Enables copy/paste of selected cells instead of entire grid" }
-  ];
-  /** @internal */
-  name = "clipboard";
-  /** @internal */
-  get defaultConfig() {
-    return {
-      includeHeaders: !1,
-      delimiter: "	",
-      newline: `
-`,
-      quoteStrings: !1
-    };
-  }
-  // #region Internal State
-  /** The last copied text (for reference/debugging) */
-  lastCopied = null;
-  // #endregion
-  // #region Lifecycle
-  /** @internal */
-  attach(e) {
-    super.attach(e), e.addEventListener("paste", (n) => this.#r(n), {
-      signal: this.disconnectSignal
-    });
-  }
-  /** @internal */
-  detach() {
-    this.lastCopied = null;
-  }
-  // #endregion
-  // #region Event Handlers
-  /** @internal */
-  onKeyDown(e) {
-    return (e.ctrlKey || e.metaKey) && e.key === "c" ? (e.preventDefault(), this.#e(e.target), !0) : !1;
-  }
-  // #endregion
-  // #region Private Methods
-  /**
-   * Handle copy operation from keyboard shortcut.
-   *
-   * 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;
-    }
-    this.copy();
-  }
-  /**
-   * 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
-   */
-  #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.visibleColumns.length - 1, u = this.visibleColumns[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 C = this.visibleColumns[l + h];
-      C && f.push(C.field);
-    }
-    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.
-   *
-   * Uses the configured `pasteHandler`, or the default handler if not specified.
-   * Set `pasteHandler: null` in config to disable auto-paste.
-   */
-  #i(e) {
-    if (!this.grid) return;
-    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.
-   */
-  #t() {
-    return this.grid?.query("getSelection")?.[0];
-  }
-  /**
-   * 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(e) {
-    const t = this.#t();
-    let n;
-    if (e?.columns)
-      n = w(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 = w(this.visibleColumns.slice(o, l + 1));
-    } else
-      n = w(this.columns);
-    let s;
-    if (e?.rowIndices)
-      s = x(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) : E(g);
-      });
-      c.push(d.join(s));
-    }
-    return c.join(r);
-  }
-  /**
-   * Get focused cell coordinates from DOM.
-   * Used as fallback when SelectionPlugin has no selection.
-   */
-  #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
-  /**
-   * 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(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 I(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(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 e = await S();
-    return e ? y(e, this.config) : null;
-  }
-  /**
-   * Get the last copied text and timestamp.
-   * @returns The last copied info or null
-   */
-  getLastCopied() {
-    return this.lastCopied;
-  }
-  // #endregion
-}
-export {
-  D as ClipboardPlugin,
-  _ as defaultPasteHandler
-};
+const e='<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>',t={expand:"▶",collapse:"▼",sortAsc:"▲",sortDesc:"▼",sortNone:"⇅",submenuArrow:"▶",dragHandle:"⋮⋮",toolPanel:"☰",filter:e,filterActive:e,print:"🖨️"};class n{static dependencies;static manifest;version="undefined"!=typeof __GRID_VERSION__?__GRID_VERSION__:"dev";styles;cellRenderers;headerRenderers;cellEditors;grid;config;userConfig;#e;get defaultConfig(){return{}}constructor(e={}){this.userConfig=e}attach(e){this.#e?.abort(),this.#e=new AbortController,this.grid=e,this.config={...this.defaultConfig,...this.userConfig}}detach(){this.#e?.abort(),this.#e=void 0}getPlugin(e){return this.grid?.getPlugin(e)}emit(e,t){this.grid?.dispatchEvent?.(new CustomEvent(e,{detail:t,bubbles:!0}))}emitCancelable(e,t){const n=new CustomEvent(e,{detail:t,bubbles:!0,cancelable:!0});return this.grid?.dispatchEvent?.(n),n.defaultPrevented}on(e,t){this.grid?._pluginManager?.subscribe(this,e,t)}off(e){this.grid?._pluginManager?.unsubscribe(this,e)}emitPluginEvent(e,t){this.grid?._pluginManager?.emitPluginEvent(e,t)}requestRender(){this.grid?.requestRender?.()}requestColumnsRender(){this.grid?.requestColumnsRender?.()}requestRenderWithFocus(){this.grid?.requestRenderWithFocus?.()}requestAfterRender(){this.grid?.requestAfterRender?.()}get rows(){return this.grid?.rows??[]}get sourceRows(){return this.grid?.sourceRows??[]}get columns(){return this.grid?.columns??[]}get visibleColumns(){return this.grid?._visibleColumns??[]}get gridElement(){return this.grid}get disconnectSignal(){return this.#e?.signal??this.grid?.disconnectSignal}get gridIcons(){const e=this.grid?.gridConfig?.icons??{};return{...t,...e}}get isAnimationEnabled(){const e=this.grid?.effectiveConfig?.animation?.mode??"reduced-motion";if(!1===e||"off"===e)return!1;if(!0===e||"on"===e)return!0;const t=this.gridElement;if(t){return"0"!==getComputedStyle(t).getPropertyValue("--tbw-animation-enabled").trim()}return!0}get animationDuration(){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}resolveIcon(e,t){return void 0!==t?t:this.gridIcons[e]}setIcon(e,t){"string"==typeof t?e.innerHTML=t:t instanceof HTMLElement&&(e.innerHTML="",e.appendChild(t.cloneNode(!0)))}warn(e){console.warn(`[tbw-grid:${this.name}] ${e}`)}}function i(e,t,n=!0){let i=e;if(n&&(i=i.filter(e=>!e.hidden&&!e.field.startsWith("__")&&!0!==e.meta?.utility)),t?.length){const e=new Set(t);i=i.filter(t=>e.has(t.field))}return i}function r(e){return null==e?"":e instanceof Date?e.toISOString():"object"==typeof e?JSON.stringify(e):String(e)}function o(e,t){const n=t.delimiter??"\t",i=t.newline??"\n",r=e.replace(/\r\n/g,"\n").replace(/\r/g,"\n"),o=[];let s=[],l="",a=!1;for(let c=0;c<r.length;c++){const e=r[c];'"'!==e||a?'"'===e&&a?'"'===r[c+1]?(l+='"',c++):a=!1:e!==n||a?e!==i||a?l+=e:(s.push(l),l="",(s.length>1||s.some(e=>""!==e.trim()))&&o.push(s),s=[]):(s.push(l),l=""):a=!0}return s.push(l),(s.length>1||s.some(e=>""!==e.trim()))&&o.push(s),o}function s(e,t){const{rows:n,target:i,fields:r}=e;if(!i)return;const o=t.rows,s=t.effectiveConfig.columns??[],l=s.map(e=>e.field),a=/* @__PURE__ */new Map;s.forEach(e=>{a.set(e.field,!0===e.editable)});const c=[...o],d=i.bounds?i.bounds.endRow:1/0;n.forEach((e,t)=>{const n=i.row+t;if(!(n>d)){if(i.bounds){if(n>=c.length)return}else for(;n>=c.length;){const e={};l.forEach(t=>e[t]=""),c.push(e)}c[n]={...c[n]},e.forEach((e,t)=>{const i=r[t];i&&a.get(i)&&(c[n][i]=e)})}}),t.rows=c}class l extends n{static dependencies=[{name:"selection",required:!1,reason:"Enables copy/paste of selected cells instead of entire grid"}];name="clipboard";get defaultConfig(){return{includeHeaders:!1,delimiter:"\t",newline:"\n",quoteStrings:!1}}lastCopied=null;attach(e){super.attach(e);e.addEventListener("paste",e=>this.#t(e),{signal:this.disconnectSignal})}detach(){this.lastCopied=null}onKeyDown(e){return!(!e.ctrlKey&&!e.metaKey||"c"!==e.key)&&(e.preventDefault(),this.#n(e.target),!0)}#n(e){const t=this.#i();if(t&&0===t.ranges.length){const t=this.#r(e);if(!t)return;const n=this.columns[t.col];if(!n)return;return void this.copy({rowIndices:[t.row],columns:[n.field]})}this.copy()}#t(e){const t=e.clipboardData?.getData("text/plain");if(!t)return;e.preventDefault();const n=o(t,this.config),i=this.#i(),r=i?.ranges?.[0],s=r?.from.row??0,l=r?.from.col??0,a=r&&("range"===i?.mode||"row"===i?.mode)&&(r.from.row!==r.to.row||r.from.col!==r.to.col)?{endRow:r.to.row,endCol:r.to.col}:null,c=a?.endCol??this.visibleColumns.length-1,d=this.visibleColumns[l],u=d?{row:s,col:l,field:d.field,bounds:a}:null,h=[],g=n[0]?.length??0;for(let o=0;o<g&&l+o<=c;o++){const e=this.visibleColumns[l+o];e&&h.push(e.field)}const f={rows:n,text:t,target:u,fields:h};this.emit("paste",f),this.#o(f)}#o(e){if(!this.grid)return;const{pasteHandler:t}=this.config;if(null===t)return;(t??s)(e,this.grid)}#i(){const e=this.grid?.query("getSelection");return e?.[0]}#s(e){const t=this.#i();let n,r;if(e?.columns)n=i(this.columns,e.columns);else if(t?.ranges.length&&"row"!==t.mode){const e=t.ranges[t.ranges.length-1],r=Math.min(e.from.col,e.to.col),o=Math.max(e.from.col,e.to.col);n=i(this.visibleColumns.slice(r,o+1))}else n=i(this.columns);if(e?.rowIndices)r=function(e,t){return t?.length?[...t].sort((e,t)=>e-t).map(t=>e[t]).filter(e=>null!=e):e}(this.rows,e.rowIndices);else if(t?.ranges.length){const e=t.ranges[t.ranges.length-1],n=Math.min(e.from.row,e.to.row),i=Math.max(e.from.row,e.to.row);r=[];for(let t=n;t<=i;t++){const e=this.rows[t];e&&r.push(e)}}else r=this.rows;return{columns:n,rows:r}}#l(e,t,n){const i=n?.delimiter??this.config.delimiter??"\t",o=n?.newline??this.config.newline??"\n",s=n?.includeHeaders??this.config.includeHeaders??!1,l=n?.processCell??this.config.processCell,a=[];s&&a.push(e.map(e=>e.header||e.field).join(i));for(const c of t){const t=e.map(e=>{const t=c[e.field];return l?l(t,e.field,c):r(t)});a.push(t.join(i))}return a.join(o)}#r(e){const t=e.closest("[data-field-cache]");if(!t)return null;const n=t.dataset.fieldCache,i=t.dataset.row;if(!n||!i)return null;const r=parseInt(i,10);if(isNaN(r))return null;const o=this.columns.findIndex(e=>e.field===n);return-1===o?null:{row:r,col:o}}getSelectionAsText(e){const{columns:t,rows:n}=this.#s(e);return 0===t.length||0===n.length?"":this.#l(t,n,e)}async copy(e){const{columns:t,rows:n}=this.#s(e);if(0===t.length||0===n.length)return"";const i=this.#l(t,n,e);return await async function(e){try{return await navigator.clipboard.writeText(e),!0}catch(t){console.warn("[copyToClipboard] Clipboard API failed:",t);const n=document.createElement("textarea");n.value=e,n.style.position="fixed",n.style.opacity="0",n.style.pointerEvents="none",document.body.appendChild(n),n.select();const i=document.execCommand("copy");return document.body.removeChild(n),i}}(i),this.lastCopied={text:i,timestamp:Date.now()},this.emit("copy",{text:i,rowCount:n.length,columnCount:t.length}),i}async copyRows(e,t){return 0===e.length?"":this.copy({...t,rowIndices:e})}async paste(){const e=await async function(){try{return await navigator.clipboard.readText()}catch{return""}}();return e?o(e,this.config):null}getLastCopied(){return this.lastCopied}}export{l as ClipboardPlugin,s as defaultPasteHandler};
 //# sourceMappingURL=index.js.map