chore: import upstream snapshot with attribution

2026-07-13 12:25:07 +08:00
commit a26e856398
1681 changed files with 296950 additions and 0 deletions
@@ -0,0 +1,164 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+import { test, expect } from "@perspective-dev/test";
+import {
+    compareLightDOMContents,
+    compareShadowDOMContents,
+} from "@perspective-dev/test";
+
+test.beforeEach(async ({ page }) => {
+    await page.goto("/tools/test/src/html/workspace-test.html");
+    await page.evaluate(async () => {
+        while (!window["__TEST_PERSPECTIVE_READY__"]) {
+            await new Promise((x) => setTimeout(x, 10));
+        }
+    });
+});
+
+function tests(context, compare) {
+    // TODO: 3.x `Client` has no exact `replaceTable`
+    test.skip("replaceTable() frees the `Table` before resolution", async ({
+        page,
+    }) => {
+        const config = {
+            viewers: {
+                One: { table: "superstore", name: "One" },
+            },
+            detail: {
+                main: {
+                    currentIndex: 0,
+                    type: "tab-area",
+                    widgets: ["One"],
+                },
+            },
+        };
+
+        await page.evaluate(async (config) => {
+            const workspace = document.getElementById("workspace");
+            await workspace.restore(config);
+            await workspace.replaceTable(
+                "superstore",
+                window.__WORKER__.table("x\n1"),
+            );
+            await window.__TABLE__.delete();
+        }, config);
+
+        await page.evaluate(async () => {
+            await workspace.flush();
+        });
+
+        return compare(page, `${context}-replace-table-frees-table.txt`);
+    });
+
+    test.skip("replaceTable() works when previous table errored", async ({
+        page,
+    }) => {
+        const config = {
+            viewers: {
+                One: { table: "errored", name: "One" },
+            },
+            detail: {
+                main: {
+                    currentIndex: 0,
+                    type: "tab-area",
+                    widgets: ["One"],
+                },
+            },
+        };
+
+        const result = await page.evaluate(async (config) => {
+            const workspace = document.getElementById("workspace");
+            await workspace.addTable(
+                "errored",
+                new Promise((_, reject) => setTimeout(reject, 50)),
+            );
+
+            try {
+                await workspace.restore(config);
+            } catch (e) {
+                console.error(e);
+                return e.toString();
+            }
+        }, config);
+
+        // NOTE This is the error message we expect when `restore()` is called
+        // without a `Table`, subject to change.
+        expect(result).toEqual(
+            "Error: Failed to construct table from JsValue(undefined)",
+        );
+        await page.evaluate(async () => {
+            await workspace.replaceTable(
+                "errored",
+                window.__WORKER__.table("x\n1"),
+            );
+        });
+
+        await page.evaluate(async () => {
+            await workspace.flush();
+        });
+
+        return compare(
+            page,
+            `${context}-replace-table-works-with-errored-table.txt`,
+        );
+    });
+
+    test("removeTable() smoke test", async ({ page }) => {
+        await page.evaluate(async () => {
+            await window.__WORKER__.table("x\n1\n", { name: "temptable" });
+            const workspace = document.getElementById("workspace");
+            await workspace.load(window.__WORKER__);
+            await workspace.restore({
+                viewers: {
+                    One: { table: "temptable", name: "One" },
+                },
+                detail: {
+                    main: {
+                        currentIndex: 0,
+                        type: "tab-area",
+                        widgets: ["One"],
+                    },
+                },
+            });
+
+            await workspace.flush();
+        });
+
+        await page.evaluate(async () => {
+            await workspace.restore({
+                viewers: {},
+                detail: {
+                    main: {
+                        currentIndex: 0,
+                        type: "tab-area",
+                        widgets: [],
+                    },
+                },
+            });
+
+            await workspace.flush();
+        });
+
+        return compare(page, `${context}-table-delete-works.txt`);
+    });
+}
+
+test.describe("Workspace table functions", () => {
+    test.describe("Light DOM", () => {
+        tests("light-dom", compareLightDOMContents);
+    });
+
+    test.describe("Shadow DOM", () => {
+        tests("shadow-dom", compareShadowDOMContents);
+    });
+});