@yuneta/gobj-ui 5.8.2 → 5.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuneta/gobj-ui",
-  "version": "5.8.2",
+  "version": "5.9.0",
   "type": "module",
   "main": "dist/gobj-ui.cjs.js",
   "module": "dist/gobj-ui.es.js",

package/src/yui_clipboard.js

@@ -0,0 +1,143 @@
+/***********************************************************************
+ *          yui_clipboard.js
+ *
+ *          Put things on the clipboard, from any view.
+ *
+ *          Four views had grown their own copy code, and they had
+ *          drifted: two of them wrote unindented JSON and reported
+ *          nothing when the write failed. This is that code, once.
+ *
+ *          The Clipboard API is absent in an insecure context (plain
+ *          http, some embedded webviews) and REJECTS when the document
+ *          does not have focus — which happens whenever the click that
+ *          asked for the copy also moved focus. Neither is something
+ *          the caller can act on, so a hidden-textarea copy covers both
+ *          rather than failing.
+ *
+ *          Copyright (c) 2026, ArtGins.
+ *          All Rights Reserved.
+ ***********************************************************************/
+import {log_error} from "@yuneta/gobj-js";
+
+/***************************************************************
+ *      Last-resort copy: a hidden textarea + execCommand.
+ *      Deprecated in the spec, still the only route in an
+ *      insecure context. Returns TRUE when it worked.
+ ***************************************************************/
+function fallback_copy(text)
+{
+    let ok = false;
+    let $ta = document.createElement("textarea");
+
+    $ta.value = text;
+    $ta.style.position = "fixed";
+    $ta.style.left = "-9999px";
+    document.body.appendChild($ta);
+    $ta.select();
+    try {
+        ok = document.execCommand("copy");
+    } catch(e) {
+        log_error(`yui_clipboard: execCommand copy failed: ${e}`);
+    }
+    document.body.removeChild($ta);
+
+    if(!ok) {
+        log_error("yui_clipboard: could not reach the clipboard");
+    }
+    return ok;
+}
+
+/***************************************************************
+ *      Copy text.
+ *      Resolves TRUE when the text reached the clipboard.
+ ***************************************************************/
+function yui_copy_text(text)
+{
+    if(typeof text !== "string") {
+        log_error("yui_copy_text(): text must be a string");
+        return Promise.resolve(false);
+    }
+
+    if(navigator.clipboard && navigator.clipboard.writeText) {
+        return navigator.clipboard.writeText(text).then(
+            function() {
+                return true;
+            },
+            function() {
+                return fallback_copy(text);
+            }
+        );
+    }
+
+    return Promise.resolve(fallback_copy(text));
+}
+
+/***************************************************************
+ *      Copy a value as JSON, indented FOUR spaces — the same
+ *      width the rest of the family uses to show structure.
+ *      Resolves TRUE when it reached the clipboard.
+ ***************************************************************/
+function yui_copy_json(value)
+{
+    let text;
+
+    try {
+        text = JSON.stringify(value, null, 4);
+    } catch(e) {
+        log_error(`yui_copy_json(): value is not serializable: ${e}`);
+        return Promise.resolve(false);
+    }
+
+    if(text === undefined) {
+        log_error("yui_copy_json(): value is not serializable");
+        return Promise.resolve(false);
+    }
+
+    return yui_copy_text(text);
+}
+
+/***************************************************************
+ *      What the user is LOOKING AT, as an array of records:
+ *      the selected rows when there is a selection, otherwise
+ *      every row that passes the current filters, in the order
+ *      shown.
+ *
+ *      Deliberately not the whole dataset: the point is to hand
+ *      over what is on screen. A table with no selection and no
+ *      filter therefore copies everything, which is what the
+ *      screen shows too.
+ ***************************************************************/
+function yui_table_rows(tabulator)
+{
+    if(!tabulator) {
+        log_error("yui_table_rows(): no tabulator");
+        return [];
+    }
+
+    let selected = tabulator.getSelectedData();
+    if(selected && selected.length) {
+        return selected;
+    }
+
+    return tabulator.getData("active");
+}
+
+/***************************************************************
+ *      Copy what the table shows, as JSON.
+ *      Resolves to the NUMBER of records copied, 0 if none —
+ *      so the caller can tell the user, or stay quiet.
+ ***************************************************************/
+function yui_copy_table_json(tabulator)
+{
+    let rows = yui_table_rows(tabulator);
+
+    if(!rows.length) {
+        return Promise.resolve(0);
+    }
+
+    return yui_copy_json(rows).then(function(ok) {
+        return ok? rows.length : 0;
+    });
+}
+
+export {yui_copy_text, yui_copy_json, yui_table_rows, yui_copy_table_json};

package/src/yui_clipboard.test.js

@@ -0,0 +1,112 @@
+/***********************************************************************
+ *          yui_clipboard.test.js
+ *
+ *      Unit tests for the shared clipboard helpers.
+ *      Run with: npm test
+ ***********************************************************************/
+import { test, expect, vi, beforeEach, afterEach } from "vitest";
+import {
+    yui_copy_text,
+    yui_copy_json,
+    yui_table_rows,
+    yui_copy_table_json,
+} from "./yui_clipboard.js";
+
+let written;
+
+beforeEach(() => {
+    written = [];
+    /*  A clipboard that accepts everything.  */
+    Object.defineProperty(navigator, "clipboard", {
+        value: {
+            writeText: (text) => {
+                written.push(text);
+                return Promise.resolve();
+            }
+        },
+        configurable: true,
+        writable: true
+    });
+});
+
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+
+/*  A Tabulator stand-in: only the two methods the helper calls.  */
+function fake_table(active, selected)
+{
+    return {
+        getData: () => active,
+        getSelectedData: () => selected || []
+    };
+}
+
+/*============================================================
+ *      yui_copy_text
+ *============================================================*/
+test("copy_text: writes the text and resolves true", async () => {
+    await expect(yui_copy_text("hello")).resolves.toBe(true);
+    expect(written).toEqual(["hello"]);
+});
+
+test("copy_text: a non-string is refused, nothing is written", async () => {
+    await expect(yui_copy_text({a: 1})).resolves.toBe(false);
+    expect(written).toEqual([]);
+});
+
+/*============================================================
+ *      yui_copy_json
+ *============================================================*/
+test("copy_json: indents FOUR spaces", async () => {
+    await yui_copy_json({a: 1});
+    expect(written[0]).toBe("{\n    \"a\": 1\n}");
+});
+
+test("copy_json: a cycle is reported, not thrown", async () => {
+    let cyclic = {};
+    cyclic.self = cyclic;
+    await expect(yui_copy_json(cyclic)).resolves.toBe(false);
+    expect(written).toEqual([]);
+});
+
+test("copy_json: an undefined value is refused", async () => {
+    await expect(yui_copy_json(undefined)).resolves.toBe(false);
+});
+
+/*============================================================
+ *      yui_table_rows
+ *============================================================*/
+test("table_rows: with no selection, the filtered rows", () => {
+    let rows = [{id: 1}, {id: 2}];
+    expect(yui_table_rows(fake_table(rows))).toEqual(rows);
+});
+
+test("table_rows: a selection WINS over the filtered rows", () => {
+    let active = [{id: 1}, {id: 2}, {id: 3}];
+    let selected = [{id: 2}];
+    expect(yui_table_rows(fake_table(active, selected))).toEqual(selected);
+});
+
+test("table_rows: no table is an empty array, not a throw", () => {
+    expect(yui_table_rows(null)).toEqual([]);
+});
+
+/*============================================================
+ *      yui_copy_table_json
+ *============================================================*/
+test("copy_table_json: resolves to the number of records copied", async () => {
+    let rows = [{id: 1}, {id: 2}, {id: 3}];
+    await expect(yui_copy_table_json(fake_table(rows))).resolves.toBe(3);
+    expect(JSON.parse(written[0])).toEqual(rows);
+});
+
+test("copy_table_json: an empty table copies nothing and reports 0", async () => {
+    await expect(yui_copy_table_json(fake_table([]))).resolves.toBe(0);
+    expect(written).toEqual([]);
+});
+
+test("copy_table_json: counts the SELECTION when there is one", async () => {
+    let active = [{id: 1}, {id: 2}, {id: 3}];
+    await expect(yui_copy_table_json(fake_table(active, [{id: 2}]))).resolves.toBe(1);
+});