@rezi-ui/node 0.1.0-alpha.1

package/README.md

@@ -0,0 +1,17 @@
+# @rezi-ui/node
+
+Node.js backend for Rezi. This package owns:
+
+- worker-thread engine ownership (native engine is never called on the main thread)
+- frame scheduling and buffer pooling
+- transfer of drawlists/events between core and the native addon
+
+Typical usage:
+
+```ts
+import { createApp, ui } from "@rezi-ui/core";
+import { createNodeBackend } from "@rezi-ui/node";
+```
+
+Docs: `https://rtlzeromemory.github.io/Rezi/`
+

package/dist/__e2e__/fixtures/terminal-app.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-app.d.ts.map

package/dist/__e2e__/fixtures/terminal-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-app.d.ts","sourceRoot":"","sources":["../../../src/__e2e__/fixtures/terminal-app.ts"],"names":[],"mappings":""}

package/dist/__e2e__/fixtures/terminal-app.js

@@ -0,0 +1,42 @@
+import { createApp, ui } from "@rezi-ui/core";
+import { createNodeBackend } from "@rezi-ui/node";
+const app = createApp({
+    backend: createNodeBackend({ executionMode: "inline", fpsCap: 30 }),
+    initialState: { step: 0 },
+});
+app.view((state) => ui.column({ p: 1, gap: 1 }, [
+    ui.text("E2E Terminal Render"),
+    ui.text(`Step: ${state.step}`),
+    ui.text("Rezi UI"),
+]));
+const shutdown = async (code) => {
+    try {
+        await app.stop();
+    }
+    catch {
+        // ignore shutdown errors to avoid hanging the runner
+    }
+    try {
+        app.dispose();
+    }
+    catch {
+        // ignore
+    }
+    process.exit(code);
+};
+process.on("uncaughtException", (err) => {
+    console.error(err);
+    void shutdown(1);
+});
+process.on("unhandledRejection", (err) => {
+    console.error(err);
+    void shutdown(1);
+});
+await app.start();
+setTimeout(() => {
+    app.update((s) => ({ step: s.step + 1 }));
+}, 50);
+setTimeout(() => {
+    void shutdown(0);
+}, 200);
+//# sourceMappingURL=terminal-app.js.map

package/dist/__e2e__/fixtures/terminal-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-app.js","sourceRoot":"","sources":["../../../src/__e2e__/fixtures/terminal-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIlD,MAAM,GAAG,GAAG,SAAS,CAAQ;IAC3B,OAAO,EAAE,iBAAiB,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACnE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;CAC1B,CAAC,CAAC;AAEH,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACjB,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;IAC1B,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC;IAC9B,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9B,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;CACnB,CAAC,CACH,CAAC;AAEF,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IACD,IAAI,CAAC;QACH,GAAG,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;IACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE;IACvC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,CAAC,CAAC;AAEH,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;AAElB,UAAU,CAAC,GAAG,EAAE;IACd,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC,EAAE,EAAE,CAAC,CAAC;AAEP,UAAU,CAAC,GAAG,EAAE;IACd,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,EAAE,GAAG,CAAC,CAAC"}

package/dist/__e2e__/terminal-render.e2e.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-render.e2e.test.d.ts.map

package/dist/__e2e__/terminal-render.e2e.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-render.e2e.test.d.ts","sourceRoot":"","sources":["../../src/__e2e__/terminal-render.e2e.test.ts"],"names":[],"mappings":""}

package/dist/__e2e__/terminal-render.e2e.test.js

@@ -0,0 +1,125 @@
+import { spawn, spawnSync } from "node:child_process";
+import { setTimeout as delay } from "node:timers/promises";
+import { fileURLToPath } from "node:url";
+import { assert, test } from "@rezi-ui/testkit";
+const COLS = 60;
+const ROWS = 16;
+const TIMEOUT_MS = 5000;
+const isLinux = process.platform === "linux";
+const hasPythonPty = (() => {
+    if (!isLinux)
+        return false;
+    const probe = spawnSync("python3", ["-c", "import pty,sys"], { stdio: "ignore" });
+    return !probe.error && probe.status === 0;
+})();
+async function loadTerminalCtor() {
+    const mod = await import("@xterm/headless");
+    const candidate = mod;
+    const Terminal = candidate.Terminal ?? candidate.default?.Terminal;
+    if (!Terminal) {
+        throw new Error("terminal e2e could not resolve @xterm/headless Terminal export");
+    }
+    return Terminal;
+}
+function snapshotScreen(term, rows) {
+    const buffer = term.buffer.active;
+    const out = [];
+    for (let i = 0; i < rows; i++) {
+        const line = buffer.getLine(i);
+        out.push(line ? line.translateToString(true) : "");
+    }
+    return out;
+}
+test("terminal e2e renders real output", { skip: isLinux ? (hasPythonPty ? false : "python3 required for pty") : "linux-only" }, async () => {
+    const Terminal = await loadTerminalCtor();
+    const term = new Terminal({ cols: COLS, rows: ROWS, allowProposedApi: true });
+    const appPath = fileURLToPath(new URL("./fixtures/terminal-app.js", import.meta.url));
+    const root = fileURLToPath(new URL("../../../../", import.meta.url));
+    const pythonScript = `
+import os, pty, sys, fcntl, termios, struct
+
+cols = int(os.environ.get("REZI_E2E_COLS", "60"))
+rows = int(os.environ.get("REZI_E2E_ROWS", "16"))
+node = os.environ["REZI_E2E_NODE"]
+app = os.environ["REZI_E2E_APP"]
+
+pid, fd = pty.fork()
+if pid == 0:
+    os.execv(node, [node, app])
+else:
+    fcntl.ioctl(fd, termios.TIOCSWINSZ, struct.pack("HHHH", rows, cols, 0, 0))
+    while True:
+        try:
+            data = os.read(fd, 1024)
+        except OSError:
+            break
+        if not data:
+            break
+        os.write(sys.stdout.fileno(), data)
+    _, status = os.waitpid(pid, 0)
+    if os.WIFEXITED(status):
+        sys.exit(os.WEXITSTATUS(status))
+    if os.WIFSIGNALED(status):
+        sys.exit(128 + os.WTERMSIG(status))
+    sys.exit(1)
+`;
+    const child = spawn("python3", ["-c", pythonScript], {
+        cwd: root,
+        env: {
+            ...process.env,
+            TERM: "xterm-256color",
+            REZI_E2E_NODE: process.execPath,
+            REZI_E2E_APP: appPath,
+            REZI_E2E_COLS: String(COLS),
+            REZI_E2E_ROWS: String(ROWS),
+        },
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    assert.ok(child.stdout, "expected python pty stdout pipe");
+    let stderr = "";
+    child.stderr?.on("data", (chunk) => {
+        stderr += chunk.toString("utf8");
+    });
+    let sawTitle = false;
+    let sawStep = false;
+    let sawFooter = false;
+    let lastScreen = "";
+    const updateScreen = () => {
+        lastScreen = snapshotScreen(term, ROWS).join("\n");
+        if (!sawTitle && lastScreen.includes("E2E Terminal Render"))
+            sawTitle = true;
+        if (!sawStep && lastScreen.includes("Step: 1"))
+            sawStep = true;
+        if (!sawFooter && lastScreen.includes("Rezi UI"))
+            sawFooter = true;
+    };
+    let pending = Promise.resolve();
+    child.stdout.on("data", (chunk) => {
+        const data = chunk.toString("utf8");
+        pending = pending
+            .then(() => new Promise((resolve) => term.write(data, resolve)))
+            .then(() => {
+            if (!sawTitle || !sawStep || !sawFooter) {
+                updateScreen();
+            }
+        });
+    });
+    const exit = new Promise((resolve, reject) => {
+        child.on("error", reject);
+        child.on("exit", (code, signal) => resolve({ code, signal }));
+    });
+    const timeout = delay(TIMEOUT_MS).then(() => {
+        child.kill("SIGKILL");
+        throw new Error("terminal e2e timed out");
+    });
+    const { code, signal } = await Promise.race([exit, timeout]);
+    await pending;
+    updateScreen();
+    if (code !== 0) {
+        throw new Error(`terminal app exited with code=${String(code)} signal=${String(signal)}\n${stderr}`);
+    }
+    assert.ok(sawTitle, `missing title in screen:\n${lastScreen}`);
+    assert.ok(sawStep, `missing updated state in screen:\n${lastScreen}`);
+    assert.ok(sawFooter, `missing footer in screen:\n${lastScreen}`);
+});
+//# sourceMappingURL=terminal-render.e2e.test.js.map

package/dist/__e2e__/terminal-render.e2e.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-render.e2e.test.js","sourceRoot":"","sources":["../../src/__e2e__/terminal-render.e2e.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/worker_integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker_integration.test.d.ts.map

package/dist/__tests__/worker_integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker_integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/worker_integration.test.ts"],"names":[],"mappings":""}