@rezi-ui/node 0.1.0-alpha.6 → 0.1.0-alpha.60

package/README.md

@@ -1,17 +1,37 @@
 # @rezi-ui/node
 
-Node.js backend for Rezi. This package owns:
+Node.js/Bun backend for Rezi. This package owns:
 
-- worker-thread engine ownership (native engine is never called on the main thread)
+- configurable native engine execution mode (`auto` | `worker` | `inline`)
 - frame scheduling and buffer pooling
 - transfer of drawlists/events between core and the native addon
 
-Typical usage:
+Recommended usage:
 
 ```ts
-import { createApp, ui } from "@rezi-ui/core";
-import { createNodeBackend } from "@rezi-ui/node";
+import { createNodeApp } from "@rezi-ui/node";
 ```
 
-Docs: `https://rtlzeromemory.github.io/Rezi/`
+Use `createNodeApp({ initialState, config })` as the default path. It wires
+`@rezi-ui/core` and `@rezi-ui/node` with matched cursor protocol, event caps,
+and fps settings. `executionMode` defaults to `auto` (`fpsCap <= 30` -> inline,
+otherwise worker); set `executionMode: "worker"` or `"inline"` to force a mode.
 
+For development-time hot swapping, pass `hotReload` to `createNodeApp(...)`:
+- `viewModule` for widget-view apps
+- `routesModule` for route-managed apps
+
+`app.hotReload` exposes the controller for optional manual `reloadNow()` calls.
+
+`createNodeBackend()` is available when you need direct access to a backend
+instance (benchmarks/custom runners). Most apps should use `createNodeApp()`.
+
+Install:
+
+```bash
+npm i @rezi-ui/node
+# or
+bun add @rezi-ui/node
+```
+
+Docs: `https://rezitui.dev/docs`

package/dist/backend/backendSharedConfig.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_FPS_CAP: 60;
+export declare const MAX_SAFE_FPS_CAP: 1000;
+export declare const DEFAULT_MAX_EVENT_BYTES: number;
+export declare const MAX_SAFE_EVENT_BYTES: number;
+export declare function mergeNativeLimits(nativeConfig: Readonly<Record<string, unknown>>): Readonly<Record<string, unknown>>;
+export declare function normalizeBackendNativeConfig(nativeConfig: unknown): Readonly<Record<string, unknown>>;
+export declare function parsePositiveIntOr(n: unknown, fallback: number): number;
+export declare function parsePositiveInt(n: unknown): number | null;
+export declare function parseBoundedPositiveIntOrThrow(name: string, value: unknown, fallback: number, max: number): number;
+export declare function resolveTargetFps(fpsCap: number, nativeConfig: Readonly<Record<string, unknown>>): number;
+//# sourceMappingURL=backendSharedConfig.d.ts.map

package/dist/backend/backendSharedConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendSharedConfig.d.ts","sourceRoot":"","sources":["../../src/backend/backendSharedConfig.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,EAAG,EAAW,CAAC;AAC3C,eAAO,MAAM,gBAAgB,EAAG,IAAa,CAAC;AAC9C,eAAO,MAAM,uBAAuB,QAAU,CAAC;AAC/C,eAAO,MAAM,oBAAoB,QAAU,CAAC;AAsB5C,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC9C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBnC;AAED,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,OAAO,GACpB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAInC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAM1D;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,MAAM,CAUR;AAYD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC9C,MAAM,CAgBR"}

package/dist/backend/backendSharedConfig.js

@@ -0,0 +1,99 @@
+import { ZrUiError } from "@rezi-ui/core";
+export const DEFAULT_FPS_CAP = 60;
+export const MAX_SAFE_FPS_CAP = 1000;
+export const DEFAULT_MAX_EVENT_BYTES = 1 << 20;
+export const MAX_SAFE_EVENT_BYTES = 4 << 20;
+const EMPTY_NATIVE_CONFIG = Object.freeze({});
+const DEFAULT_NATIVE_LIMITS = Object.freeze({
+    // Align native validation caps with JS drawlist builder defaults.
+    //
+    // Native defaults are intentionally conservative; however, @rezi-ui/core's
+    // drawlist builders default to 2 MiB max drawlist bytes and large command
+    // budgets. Without overriding, moderately large frames (e.g. images/canvas)
+    // can fail with ZR_ERR_LIMIT (-3) at submit time.
+    outMaxBytesPerFrame: 2 * 1024 * 1024,
+    dlMaxTotalBytes: 2 * 1024 * 1024,
+    dlMaxCmds: 100_000,
+    dlMaxStrings: 10_000,
+    dlMaxBlobs: 10_000,
+});
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+export function mergeNativeLimits(nativeConfig) {
+    // biome-ignore lint/complexity/useLiteralKeys: bracket access is required by noPropertyAccessFromIndexSignature.
+    const limitsValue = nativeConfig["limits"];
+    const existingLimits = isPlainObject(limitsValue)
+        ? limitsValue
+        : null;
+    const limits = { ...(existingLimits ?? {}) };
+    const has = (camel) => {
+        const snake = camel.replace(/[A-Z]/g, (m) => `_${m.toLowerCase()}`);
+        return (Object.prototype.hasOwnProperty.call(limits, camel) ||
+            Object.prototype.hasOwnProperty.call(limits, snake));
+    };
+    for (const [camel, value] of Object.entries(DEFAULT_NATIVE_LIMITS)) {
+        if (has(camel))
+            continue;
+        limits[camel] = value;
+    }
+    return Object.freeze({ ...nativeConfig, limits: Object.freeze(limits) });
+}
+export function normalizeBackendNativeConfig(nativeConfig) {
+    return isPlainObject(nativeConfig)
+        ? mergeNativeLimits(nativeConfig)
+        : mergeNativeLimits(EMPTY_NATIVE_CONFIG);
+}
+export function parsePositiveIntOr(n, fallback) {
+    if (typeof n !== "number")
+        return fallback;
+    if (!Number.isFinite(n))
+        return fallback;
+    if (!Number.isInteger(n))
+        return fallback;
+    if (n <= 0)
+        return fallback;
+    return n;
+}
+export function parsePositiveInt(n) {
+    if (typeof n !== "number")
+        return null;
+    if (!Number.isFinite(n))
+        return null;
+    if (!Number.isInteger(n))
+        return null;
+    if (n <= 0)
+        return null;
+    return n;
+}
+export function parseBoundedPositiveIntOrThrow(name, value, fallback, max) {
+    if (value === undefined)
+        return fallback;
+    const parsed = parsePositiveInt(value);
+    if (parsed === null) {
+        throw new ZrUiError("ZRUI_INVALID_PROPS", `${name} must be a positive integer`);
+    }
+    if (parsed > max) {
+        throw new ZrUiError("ZRUI_INVALID_PROPS", `${name} must be <= ${String(max)}`);
+    }
+    return parsed;
+}
+function readNativeTargetFpsValues(cfg) {
+    const targetFpsCfg = cfg;
+    return {
+        camel: parsePositiveInt(targetFpsCfg.targetFps),
+        snake: parsePositiveInt(targetFpsCfg.target_fps),
+    };
+}
+export function resolveTargetFps(fpsCap, nativeConfig) {
+    const values = readNativeTargetFpsValues(nativeConfig);
+    if (values.camel !== null && values.snake !== null && values.camel !== values.snake) {
+        throw new ZrUiError("ZRUI_INVALID_PROPS", `createNodeBackend config mismatch: nativeConfig.targetFps=${String(values.camel)} must match nativeConfig.target_fps=${String(values.snake)}.`);
+    }
+    const nativeTargetFps = values.camel ?? values.snake;
+    if (nativeTargetFps !== null && nativeTargetFps !== fpsCap) {
+        throw new ZrUiError("ZRUI_INVALID_PROPS", `createNodeBackend config mismatch: fpsCap=${String(fpsCap)} must match nativeConfig.targetFps/target_fps=${String(nativeTargetFps)}. Fix: set nativeConfig.targetFps (or target_fps) to ${String(fpsCap)}, or remove the override and use fpsCap only.`);
+    }
+    return fpsCap;
+}
+//# sourceMappingURL=backendSharedConfig.js.map

package/dist/backend/backendSharedConfig.js.map

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

package/dist/backend/backendSharedDebug.d.ts

@@ -0,0 +1,4 @@
+export declare const DEBUG_QUERY_DEFAULT_RECORDS: 4096;
+export declare const DEBUG_QUERY_MAX_RECORDS: 16384;
+export declare function readDebugBytesWithRetry<TEmpty>(read: (out: Uint8Array) => number, initialCapacity: number, emptyValue: TEmpty, operation: string): Uint8Array | TEmpty;
+//# sourceMappingURL=backendSharedDebug.d.ts.map

package/dist/backend/backendSharedDebug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendSharedDebug.d.ts","sourceRoot":"","sources":["../../src/backend/backendSharedDebug.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,2BAA2B,EAAG,IAAa,CAAC;AACzD,eAAO,MAAM,uBAAuB,EAAG,KAAc,CAAC;AAItD,wBAAgB,uBAAuB,CAAC,MAAM,EAC5C,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,EACjC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,MAAM,CA4BrB"}

package/dist/backend/backendSharedDebug.js

@@ -0,0 +1,29 @@
+import { ZrUiError } from "@rezi-ui/core";
+export const DEBUG_QUERY_DEFAULT_RECORDS = 4096;
+export const DEBUG_QUERY_MAX_RECORDS = 16384;
+const MAX_DEBUG_BYTES_RETRY_CAP = 64 << 20;
+export function readDebugBytesWithRetry(read, initialCapacity, emptyValue, operation) {
+    const baseCapacity = Number.isFinite(initialCapacity) ? Math.floor(initialCapacity) : 1;
+    let capacity = Math.min(MAX_DEBUG_BYTES_RETRY_CAP, Math.max(1, baseCapacity));
+    while (true) {
+        const out = new Uint8Array(capacity);
+        const written = read(out);
+        if (!Number.isInteger(written) || written > out.byteLength) {
+            throw new ZrUiError("ZRUI_BACKEND_ERROR", `${operation} returned invalid byte count: written=${String(written)} capacity=${String(out.byteLength)}`);
+        }
+        if (written <= 0) {
+            return emptyValue;
+        }
+        if (written < out.byteLength) {
+            return out.slice(0, written);
+        }
+        if (capacity >= MAX_DEBUG_BYTES_RETRY_CAP) {
+            // Native debug APIs return written byte count but not total required size.
+            // If the output exactly fills our max-cap buffer, it's likely truncated.
+            process.emitWarning(`[rezi][debug] ${operation} filled ${String(capacity)} bytes at max cap; payload may be truncated.`);
+            return out.slice(0, written);
+        }
+        capacity = Math.min(MAX_DEBUG_BYTES_RETRY_CAP, capacity * 2);
+    }
+}
+//# sourceMappingURL=backendSharedDebug.js.map

package/dist/backend/backendSharedDebug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendSharedDebug.js","sourceRoot":"","sources":["../../src/backend/backendSharedDebug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAa,CAAC;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAc,CAAC;AAEtD,MAAM,yBAAyB,GAAG,EAAE,IAAI,EAAE,CAAC;AAE3C,MAAM,UAAU,uBAAuB,CACrC,IAAiC,EACjC,eAAuB,EACvB,UAAkB,EAClB,SAAiB;IAEjB,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAC9E,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;YAC3D,MAAM,IAAI,SAAS,CACjB,oBAAoB,EACpB,GAAG,SAAS,yCAAyC,MAAM,CAAC,OAAO,CAAC,aAAa,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAC1G,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;YAC7B,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,QAAQ,IAAI,yBAAyB,EAAE,CAAC;YAC1C,2EAA2E;YAC3E,yEAAyE;YACzE,OAAO,CAAC,WAAW,CACjB,iBAAiB,SAAS,WAAW,MAAM,CAAC,QAAQ,CAAC,8CAA8C,CACpG,CAAC;YACF,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,yBAAyB,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/backend/backendSharedMarkers.d.ts

@@ -0,0 +1,10 @@
+import type { BackendBeginFrame } from "@rezi-ui/core/backend";
+type BackendMarkerOptions = Readonly<{
+    requestedDrawlistVersion: number;
+    maxEventBytes: number;
+    fpsCap: number;
+    beginFrame?: BackendBeginFrame | null;
+}>;
+export declare function attachBackendMarkers<TBackend extends object>(backend: TBackend, options: BackendMarkerOptions): TBackend;
+export {};
+//# sourceMappingURL=backendSharedMarkers.d.ts.map

package/dist/backend/backendSharedMarkers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendSharedMarkers.d.ts","sourceRoot":"","sources":["../../src/backend/backendSharedMarkers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,KAAK,oBAAoB,GAAG,QAAQ,CAAC;IACnC,wBAAwB,EAAE,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACvC,CAAC,CAAC;AAWH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAS,MAAM,EAC1D,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,QAAQ,CAuCV"}

package/dist/backend/backendSharedMarkers.js

@@ -0,0 +1,50 @@
+import { BACKEND_BEGIN_FRAME_MARKER, BACKEND_DRAWLIST_VERSION_MARKER, BACKEND_FPS_CAP_MARKER, BACKEND_MAX_EVENT_BYTES_MARKER, BACKEND_RAW_WRITE_MARKER, } from "@rezi-ui/core";
+const backendRawWrite = ((text) => {
+    if (typeof text !== "string" || text.length === 0)
+        return;
+    try {
+        process.stdout.write(text);
+    }
+    catch {
+        // Preserve backend determinism: clipboard write failures are non-fatal.
+    }
+});
+export function attachBackendMarkers(backend, options) {
+    const descriptors = {
+        [BACKEND_DRAWLIST_VERSION_MARKER]: {
+            value: options.requestedDrawlistVersion,
+            writable: false,
+            enumerable: false,
+            configurable: false,
+        },
+        [BACKEND_MAX_EVENT_BYTES_MARKER]: {
+            value: options.maxEventBytes,
+            writable: false,
+            enumerable: false,
+            configurable: false,
+        },
+        [BACKEND_FPS_CAP_MARKER]: {
+            value: options.fpsCap,
+            writable: false,
+            enumerable: false,
+            configurable: false,
+        },
+        [BACKEND_RAW_WRITE_MARKER]: {
+            value: backendRawWrite,
+            writable: false,
+            enumerable: false,
+            configurable: false,
+        },
+    };
+    if (options.beginFrame !== null && options.beginFrame !== undefined) {
+        descriptors[BACKEND_BEGIN_FRAME_MARKER] = {
+            value: options.beginFrame,
+            writable: false,
+            enumerable: false,
+            configurable: false,
+        };
+    }
+    Object.defineProperties(backend, descriptors);
+    return backend;
+}
+//# sourceMappingURL=backendSharedMarkers.js.map

package/dist/backend/backendSharedMarkers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendSharedMarkers.js","sourceRoot":"","sources":["../../src/backend/backendSharedMarkers.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,sBAAsB,EACtB,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAUvB,MAAM,eAAe,GAAG,CAAC,CAAC,IAAY,EAAQ,EAAE;IAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC1D,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;IAC1E,CAAC;AACH,CAAC,CAA2B,CAAC;AAE7B,MAAM,UAAU,oBAAoB,CAClC,OAAiB,EACjB,OAA6B;IAE7B,MAAM,WAAW,GAA0B;QACzC,CAAC,+BAA+B,CAAC,EAAE;YACjC,KAAK,EAAE,OAAO,CAAC,wBAAwB;YACvC,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,KAAK;SACpB;QACD,CAAC,8BAA8B,CAAC,EAAE;YAChC,KAAK,EAAE,OAAO,CAAC,aAAa;YAC5B,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,KAAK;SACpB;QACD,CAAC,sBAAsB,CAAC,EAAE;YACxB,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,KAAK;SACpB;QACD,CAAC,wBAAwB,CAAC,EAAE;YAC1B,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,KAAK;SACpB;KACF,CAAC;IAEF,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpE,WAAW,CAAC,0BAA0B,CAAC,GAAG;YACxC,KAAK,EAAE,OAAO,CAAC,UAAU;YACzB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/backend/emojiWidthPolicy.d.ts

@@ -0,0 +1,15 @@
+export type BackendEmojiWidthPolicy = "auto" | "wide" | "narrow";
+export type ResolvedEmojiWidthPolicy = "wide" | "narrow";
+/**
+ * Resolve backend emoji width policy and align core/native width models.
+ *
+ * Resolution order:
+ * 1) explicit `requested` ("wide"/"narrow")
+ * 2) explicit native override (`nativeConfig.widthPolicy|width_policy`)
+ * 3) env override (`ZRUI_EMOJI_WIDTH_POLICY`)
+ * 4) optional probe (CPR-based) when `ZRUI_EMOJI_WIDTH_PROBE=1`
+ * 5) deterministic default ("wide")
+ */
+export declare function resolveBackendEmojiWidthPolicy(requested: BackendEmojiWidthPolicy | undefined, nativeConfig: Readonly<Record<string, unknown>>): Promise<ResolvedEmojiWidthPolicy>;
+export declare function applyEmojiWidthPolicy(policy: ResolvedEmojiWidthPolicy): 0 | 1;
+//# sourceMappingURL=emojiWidthPolicy.d.ts.map

package/dist/backend/emojiWidthPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emojiWidthPolicy.d.ts","sourceRoot":"","sources":["../../src/backend/emojiWidthPolicy.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AACjE,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAoMzD;;;;;;;;;GASG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,uBAAuB,GAAG,SAAS,EAC9C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC9C,OAAO,CAAC,wBAAwB,CAAC,CA8BnC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,CAAC,GAAG,CAAC,CAG7E"}

package/dist/backend/emojiWidthPolicy.js

@@ -0,0 +1,229 @@
+import { ZrUiError, setTextMeasureEmojiPolicy } from "@rezi-ui/core";
+const NATIVE_WIDTH_POLICY_NARROW = 0;
+const NATIVE_WIDTH_POLICY_WIDE = 1;
+const PROBE_TIMEOUT_MS_DEFAULT = 80;
+const PROBE_GLYPHS = Object.freeze(["😀", "🚀", "🧪"]);
+const ENV_EMOJI_WIDTH_POLICY = "ZRUI_EMOJI_WIDTH_POLICY";
+const ENV_EMOJI_WIDTH_PROBE = "ZRUI_EMOJI_WIDTH_PROBE";
+let cachedProbePolicy = null;
+let cachedProbePromise = null;
+function normalizePolicy(raw) {
+    if (typeof raw !== "string")
+        return null;
+    const value = raw.trim().toLowerCase();
+    if (value === "auto")
+        return "auto";
+    if (value === "wide")
+        return "wide";
+    if (value === "narrow")
+        return "narrow";
+    return null;
+}
+function nativeWidthPolicyToResolved(value) {
+    return value === NATIVE_WIDTH_POLICY_NARROW ? "narrow" : "wide";
+}
+function resolvedToNativeWidthPolicy(value) {
+    return value === "narrow" ? NATIVE_WIDTH_POLICY_NARROW : NATIVE_WIDTH_POLICY_WIDE;
+}
+function readNativeWidthPolicyValues(cfg) {
+    const parse = (value, key) => {
+        if (value === undefined)
+            return null;
+        if (typeof value !== "number" || !Number.isInteger(value) || (value !== 0 && value !== 1)) {
+            throw new ZrUiError("ZRUI_INVALID_PROPS", `createNodeBackend config mismatch: nativeConfig.${key} must be 0 (narrow) or 1 (wide).`);
+        }
+        return value;
+    };
+    const record = cfg;
+    return {
+        camel: parse(record.widthPolicy, "widthPolicy"),
+        snake: parse(record.width_policy, "width_policy"),
+    };
+}
+function readNativeWidthPolicyOverride(cfg) {
+    const values = readNativeWidthPolicyValues(cfg);
+    if (values.camel !== null && values.snake !== null && values.camel !== values.snake) {
+        throw new ZrUiError("ZRUI_INVALID_PROPS", `createNodeBackend config mismatch: nativeConfig.widthPolicy=${String(values.camel)} must match nativeConfig.width_policy=${String(values.snake)}.`);
+    }
+    const nativeValue = values.camel ?? values.snake;
+    if (nativeValue === null)
+        return null;
+    return nativeWidthPolicyToResolved(nativeValue);
+}
+function pushParsedCpr(buffer, out) {
+    let pending = buffer;
+    while (pending.length > 0) {
+        const esc = pending.indexOf("\x1b[");
+        if (esc < 0) {
+            if (pending.length > 128)
+                pending = pending.slice(-128);
+            break;
+        }
+        if (esc > 0) {
+            pending = pending.slice(esc);
+        }
+        const end = pending.indexOf("R", 2);
+        if (end < 0)
+            break;
+        const seq = pending.slice(0, end + 1);
+        pending = pending.slice(end + 1);
+        const body = seq.slice(2, seq.length - 1);
+        const sep = body.indexOf(";");
+        if (sep <= 0 || sep >= body.length - 1)
+            continue;
+        const rowText = body.slice(0, sep);
+        const colText = body.slice(sep + 1);
+        if (!/^\d+$/.test(rowText) || !/^\d+$/.test(colText))
+            continue;
+        const row = Number.parseInt(rowText, 10);
+        const col = Number.parseInt(colText, 10);
+        if (Number.isFinite(row) && Number.isFinite(col)) {
+            out.push({ row, col });
+        }
+    }
+    return pending;
+}
+async function probeGlyphWidthViaCpr(glyph, timeoutMs) {
+    const stdin = process.stdin;
+    const stdout = process.stdout;
+    if (!stdin.isTTY || !stdout.isTTY)
+        return null;
+    if (typeof stdin.setRawMode !== "function")
+        return null;
+    const wasRaw = stdin.isRaw === true;
+    let pending = "";
+    const cprs = [];
+    const onData = (chunk) => {
+        const text = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+        pending = pushParsedCpr(pending + text, cprs);
+    };
+    let timeout = null;
+    try {
+        stdin.on("data", onData);
+        stdin.resume();
+        if (!wasRaw)
+            stdin.setRawMode(true);
+        // Save cursor, move to a stable column, query CPR, print glyph, query CPR again, restore cursor.
+        await new Promise((resolve, reject) => {
+            stdout.write(`\x1b[s\x1b[999;1H\x1b[6n${glyph}\x1b[6n\x1b[u`, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+        await new Promise((resolve) => {
+            const done = () => {
+                if (timeout)
+                    clearTimeout(timeout);
+                timeout = null;
+                resolve();
+            };
+            timeout = setTimeout(done, timeoutMs);
+            const poll = () => {
+                if (cprs.length >= 2) {
+                    done();
+                    return;
+                }
+                setTimeout(poll, 2);
+            };
+            poll();
+        });
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+        stdin.off("data", onData);
+        if (!wasRaw) {
+            try {
+                stdin.setRawMode(false);
+            }
+            catch {
+                // no-op
+            }
+        }
+    }
+    const a = cprs[0];
+    const b = cprs[1];
+    if (!a || !b)
+        return null;
+    if (b.row !== a.row)
+        return null;
+    const delta = b.col - a.col;
+    if (delta === 1 || delta === 2)
+        return delta;
+    return null;
+}
+async function probeTerminalEmojiWidthPolicy(timeoutMs) {
+    const widths = [];
+    for (const glyph of PROBE_GLYPHS) {
+        const width = await probeGlyphWidthViaCpr(glyph, timeoutMs);
+        if (width !== null)
+            widths.push(width);
+    }
+    if (widths.length === 0)
+        return null;
+    if (widths.includes(1))
+        return "narrow";
+    return "wide";
+}
+async function probeTerminalEmojiWidthPolicyCached(timeoutMs) {
+    if (cachedProbePolicy !== null)
+        return cachedProbePolicy;
+    if (cachedProbePromise)
+        return cachedProbePromise;
+    cachedProbePromise = probeTerminalEmojiWidthPolicy(timeoutMs)
+        .then((probed) => {
+        if (probed !== null)
+            cachedProbePolicy = probed;
+        return probed;
+    })
+        .finally(() => {
+        cachedProbePromise = null;
+    });
+    return cachedProbePromise;
+}
+/**
+ * Resolve backend emoji width policy and align core/native width models.
+ *
+ * Resolution order:
+ * 1) explicit `requested` ("wide"/"narrow")
+ * 2) explicit native override (`nativeConfig.widthPolicy|width_policy`)
+ * 3) env override (`ZRUI_EMOJI_WIDTH_POLICY`)
+ * 4) optional probe (CPR-based) when `ZRUI_EMOJI_WIDTH_PROBE=1`
+ * 5) deterministic default ("wide")
+ */
+export async function resolveBackendEmojiWidthPolicy(requested, nativeConfig) {
+    const requestedPolicy = requested ?? "auto";
+    const nativeOverride = readNativeWidthPolicyOverride(nativeConfig);
+    if (requestedPolicy === "narrow" || requestedPolicy === "wide") {
+        if (nativeOverride !== null && nativeOverride !== requestedPolicy) {
+            throw new ZrUiError("ZRUI_INVALID_PROPS", `createNodeBackend config mismatch: emojiWidthPolicy=${requestedPolicy} must match nativeConfig.widthPolicy/width_policy=${nativeOverride === "narrow" ? 0 : 1}.`);
+        }
+        return requestedPolicy;
+    }
+    if (nativeOverride !== null)
+        return nativeOverride;
+    const envOverride = normalizePolicy(process.env[ENV_EMOJI_WIDTH_POLICY]);
+    if (envOverride === "wide" || envOverride === "narrow")
+        return envOverride;
+    /*
+      CPR probing is opt-in because it temporarily consumes stdin bytes while
+      collecting CPR responses, which can race startup-time key streams.
+    */
+    const probeEnabled = process.env[ENV_EMOJI_WIDTH_PROBE] === "1";
+    if (probeEnabled) {
+        const probed = await probeTerminalEmojiWidthPolicyCached(PROBE_TIMEOUT_MS_DEFAULT);
+        if (probed !== null)
+            return probed;
+    }
+    return "wide";
+}
+export function applyEmojiWidthPolicy(policy) {
+    setTextMeasureEmojiPolicy(policy);
+    return resolvedToNativeWidthPolicy(policy);
+}
+//# sourceMappingURL=emojiWidthPolicy.js.map

package/dist/backend/emojiWidthPolicy.js.map

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

package/dist/backend/nodeBackend.d.ts

@@ -15,10 +15,16 @@ export type NodeBackendConfig = Readonly<{
      * - "inline": single-thread inline backend (no worker-hop transport)
      */
     executionMode?: "auto" | "worker" | "inline";
+    /**
+     * @deprecated Prefer createNodeApp({ config: { fpsCap } }) so app/core and backend
+     * remain aligned by construction.
+     */
     fpsCap?: number;
+    /**
+     * @deprecated Prefer createNodeApp({ config: { maxEventBytes } }) so app/core and backend
+     * remain aligned by construction.
+     */
     maxEventBytes?: number;
-    /** Request drawlist v2 for native cursor support (default: false for compatibility) */
-    useDrawlistV2?: boolean;
     /**
      * Frame transport mode:
      * - "auto": prefer SAB mailbox transport when available, fallback to transfer.
@@ -35,6 +41,16 @@ export type NodeBackendConfig = Readonly<{
      * Keys are forwarded as-is (camelCase or snake_case accepted by the native parser).
      */
     nativeConfig?: Readonly<Record<string, unknown>>;
+    /**
+     * Emoji width policy used to keep core layout measurement and native rendering aligned.
+     * - "auto": use native/env overrides; optional probe when `ZRUI_EMOJI_WIDTH_PROBE=1`
+     *   then fallback to deterministic "wide"
+     * - "wide": emoji clusters consume 2 cells
+     * - "narrow": emoji clusters consume 1 cell
+     *
+     * This sets core text measurement policy and native `widthPolicy` together.
+     */
+    emojiWidthPolicy?: "auto" | "wide" | "narrow";
 }>;
 export type NodeBackendInternalOpts = Readonly<{
     config?: NodeBackendConfig;
@@ -58,5 +74,17 @@ export type NodeBackend = RuntimeBackend & Readonly<{
     debug: DebugBackend;
     perf: NodeBackendPerf;
 }>;
+export type NodeBackendExecutionModeSelectionInput = Readonly<{
+    requestedExecutionMode: "auto" | "worker" | "inline";
+    fpsCap: number;
+    nativeShimModule?: string;
+    hasAnyTty: boolean;
+}>;
+export type NodeBackendExecutionModeSelection = Readonly<{
+    resolvedExecutionMode: "worker" | "inline";
+    selectedExecutionMode: "worker" | "inline";
+    fallbackReason: string | null;
+}>;
+export declare function selectNodeBackendExecutionMode(input: NodeBackendExecutionModeSelectionInput): NodeBackendExecutionModeSelection;
 export declare function createNodeBackendInternal(opts?: NodeBackendInternalOpts): NodeBackend;
 //# sourceMappingURL=nodeBackend.d.ts.map

package/dist/backend/nodeBackend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodeBackend.d.ts","sourceRoot":"","sources":["../../src/backend/nodeBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAEV,YAAY,EAKZ,cAAc,EAEf,MAAM,eAAe,CAAC;AAkCvB,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;IAC7C,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,MAAM,EAAE,QAAQ,CACd,MAAM,CACJ,MAAM,EACN;QACE,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;KAC5B,CACF,CACF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,YAAY,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACtD,CAAC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,CAAC;AAwKpG,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,uBAA4B,GAAG,WAAW,CAq3BzF"}
+{"version":3,"file":"nodeBackend.d.ts","sourceRoot":"","sources":["../../src/backend/nodeBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAEV,YAAY,EAKZ,cAAc,EAGf,MAAM,eAAe,CAAC;AAuDvB,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;IAC7C,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC/C,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,MAAM,EAAE,QAAQ,CACd,MAAM,CACJ,MAAM,EACN;QACE,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;KAC5B,CACF,CACF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,YAAY,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACtD,CAAC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,CAAC;AAEpG,MAAM,MAAM,sCAAsC,GAAG,QAAQ,CAAC;IAC5D,sBAAsB,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,iCAAiC,GAAG,QAAQ,CAAC;IACvD,qBAAqB,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3C,qBAAqB,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC,CAAC;AA0FH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,sCAAsC,GAC5C,iCAAiC,CAenC;AAgLD,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,uBAA4B,GAAG,WAAW,CA6tCzF"}