@slowclap/rezi-core 0.1.0-fork.1

package/dist/app/createApp/eventLoop.js

@@ -0,0 +1,357 @@
+import { describeThrown } from "../../debug/describeThrown.js";
+import { resetChordState, routeKeyEvent } from "../../keybindings/index.js";
+import { ZR_MOD_CTRL, ZR_MOD_SHIFT } from "../../keybindings/keyCodes.js";
+import { perfMarkEnd, perfMarkStart, perfNow } from "../../perf/perf.js";
+import { parseEventBatchV1 } from "../../protocol/zrev_v1.js";
+import { DIRTY_LAYOUT, DIRTY_RENDER, DIRTY_VIEW } from "./dirtyPlan.js";
+import { codepointToCtrlKeyCode, codepointToKeyCode, } from "./keybindings.js";
+import { isTopLevelQuitEvent, isTopLevelRetryEvent, isUnhandledCtrlCKeyEvent, isUnmodifiedTextQuitEvent, } from "./topLevelViewError.js";
+export function createEventLoop(options) {
+    function commitUpdates() {
+        const drained = options.updates.drain();
+        if (drained.length === 0)
+            return;
+        const commitToken = perfMarkStart("commit");
+        options.setInCommit(true);
+        try {
+            let next = options.getCommittedState();
+            for (const update of drained) {
+                if (typeof update === "function") {
+                    next = update(next);
+                }
+                else {
+                    next = update;
+                }
+            }
+            if (next !== options.getCommittedState()) {
+                options.setCommittedState(next);
+                options.markDirty(DIRTY_VIEW, false);
+            }
+        }
+        catch (error) {
+            options.fatalNowOrEnqueue("ZRUI_USER_CODE_THROW", `state updater threw: ${describeThrown(error)}`);
+        }
+        finally {
+            options.setInCommit(false);
+            perfMarkEnd("commit", commitToken);
+        }
+    }
+    function releaseOnce(batch, releasedBatches) {
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            releasedBatches.add(batch);
+            try {
+                batch.release();
+            }
+            catch {
+                // ignore
+            }
+        };
+    }
+    function processEventBatch(batch, releasedBatches) {
+        const release = releaseOnce(batch, releasedBatches);
+        const parseToken = perfMarkStart("event_parse");
+        const parsed = parseEventBatchV1(batch.bytes, {
+            maxTotalSize: options.config.maxEventBytes,
+            timeUnwrap: options.timeUnwrap,
+        });
+        perfMarkEnd("event_parse", parseToken);
+        if (!parsed.ok) {
+            release();
+            options.fatalNowOrEnqueue("ZRUI_PROTOCOL_ERROR", `${parsed.error.code}: ${parsed.error.detail}`);
+            return;
+        }
+        const engineTruncated = (parsed.value.flags & 1) !== 0;
+        const droppedBatches = batch.droppedBatches;
+        try {
+            if (engineTruncated || droppedBatches > 0) {
+                if (!options.emit({ kind: "overrun", engineTruncated, droppedBatches }))
+                    return;
+                if (options.getRuntimeState() !== "Running")
+                    return;
+            }
+            for (const ev of parsed.value.events) {
+                if (ev.kind === "key" || ev.kind === "text" || ev.kind === "paste" || ev.kind === "mouse") {
+                    options.setInteractiveBudget(2);
+                }
+                options.noteBreadcrumbEvent(ev.kind);
+                if (!options.emit({ kind: "engine", event: ev }))
+                    return;
+                if (options.getRuntimeState() !== "Running")
+                    return;
+                if (ev.kind === "resize") {
+                    const prev = options.getViewport();
+                    if (prev === null || prev.cols !== ev.cols || prev.rows !== ev.rows) {
+                        options.setViewport(Object.freeze({ cols: ev.cols, rows: ev.rows }));
+                        if (options.widgetRenderer.hasViewportAwareComposites()) {
+                            options.widgetRenderer.invalidateCompositeWidgets();
+                            options.markDirty(DIRTY_LAYOUT | DIRTY_VIEW);
+                        }
+                        else {
+                            options.markDirty(DIRTY_LAYOUT);
+                        }
+                    }
+                }
+                if (ev.kind === "tick" && options.getMode() === "widget") {
+                    if (options.widgetRenderer.hasAnimatedWidgets()) {
+                        const tickMs = ev.timeMs;
+                        const perfMs = perfNow();
+                        const eventClockAdvances = tickMs > options.getLastObservedSpinnerTickEventMs();
+                        if (eventClockAdvances) {
+                            options.setLastObservedSpinnerTickEventMs(tickMs);
+                        }
+                        const elapsedMs = eventClockAdvances
+                            ? tickMs - options.getLastSpinnerRenderTickMs()
+                            : perfMs - options.getLastSpinnerRenderPerfMs();
+                        if (elapsedMs >= options.spinnerTickMinIntervalMs) {
+                            options.setLastSpinnerRenderTickMs(tickMs);
+                            options.setLastSpinnerRenderPerfMs(perfMs);
+                            options.markDirty(DIRTY_RENDER);
+                        }
+                    }
+                }
+                if (options.getMode() === "widget" && options.getTopLevelViewError() !== null) {
+                    if (isTopLevelRetryEvent(ev)) {
+                        options.noteBreadcrumbConsumptionPath("widgetRouting");
+                        options.retryTopLevelViewError();
+                        continue;
+                    }
+                    if (isTopLevelQuitEvent(ev)) {
+                        options.noteBreadcrumbConsumptionPath("widgetRouting");
+                        options.quitFromTopLevelViewError();
+                        continue;
+                    }
+                    if (ev.kind === "key" ||
+                        ev.kind === "text" ||
+                        ev.kind === "paste" ||
+                        ev.kind === "mouse") {
+                        options.noteBreadcrumbConsumptionPath("widgetRouting");
+                        continue;
+                    }
+                }
+                const isWidgetRoutableEvent = ev.kind === "key" || ev.kind === "text" || ev.kind === "paste" || ev.kind === "mouse";
+                if (options.getMode() === "widget" && isWidgetRoutableEvent) {
+                    if (options.getKeybindingsEnabled()) {
+                        if (ev.kind === "mouse" &&
+                            ev.mouseKind === 3 &&
+                            options.getKeybindingState().chordState.pendingKeys.length > 0) {
+                            options.setKeybindingState(Object.freeze({
+                                ...options.getKeybindingState(),
+                                chordState: resetChordState(),
+                            }));
+                        }
+                        if (ev.kind === "key") {
+                            const bypass = options.widgetRenderer.shouldBypassKeybindings(ev);
+                            if (!bypass) {
+                                const keyCtx = Object.freeze({
+                                    state: options.getCommittedState(),
+                                    update: options.getAppUpdate(),
+                                    focusedId: options.widgetRenderer.getFocusedId(),
+                                });
+                                const routeInputState = options.getKeybindingState();
+                                const keyResult = routeKeyEvent(routeInputState, ev, keyCtx);
+                                options.keybindingHelpers.applyRoutedKeybindingState(routeInputState, keyResult.nextState);
+                                if (keyResult.handlerError !== undefined) {
+                                    options.fatalNowOrEnqueue("ZRUI_USER_CODE_THROW", `keybinding handler threw: ${describeThrown(keyResult.handlerError)}`);
+                                    return;
+                                }
+                                if (keyResult.consumed) {
+                                    options.noteBreadcrumbConsumptionPath("keybindings");
+                                    continue;
+                                }
+                            }
+                        }
+                        if (ev.kind === "text") {
+                            const ctrlKeyCode = codepointToCtrlKeyCode(ev.codepoint);
+                            const shouldRouteCtrlText = ctrlKeyCode !== null;
+                            const shouldRoutePrintableText = !shouldRouteCtrlText && !options.widgetRenderer.hasActiveOverlay();
+                            if (shouldRouteCtrlText || shouldRoutePrintableText) {
+                                const keyCode = shouldRouteCtrlText
+                                    ? ctrlKeyCode
+                                    : codepointToKeyCode(ev.codepoint);
+                                const isUpperLetter = ev.codepoint >= 65 && ev.codepoint <= 90;
+                                const mods = (shouldRouteCtrlText ? ZR_MOD_CTRL : 0) | (isUpperLetter ? ZR_MOD_SHIFT : 0);
+                                if (keyCode !== null) {
+                                    const syntheticKeyEvent = {
+                                        kind: "key",
+                                        action: "down",
+                                        key: keyCode,
+                                        mods,
+                                        timeMs: ev.timeMs,
+                                    };
+                                    const keyCtx = Object.freeze({
+                                        state: options.getCommittedState(),
+                                        update: options.getAppUpdate(),
+                                        focusedId: options.widgetRenderer.getFocusedId(),
+                                    });
+                                    const routeInputState = options.getKeybindingState();
+                                    const keyResult = routeKeyEvent(routeInputState, syntheticKeyEvent, keyCtx);
+                                    options.keybindingHelpers.applyRoutedKeybindingState(routeInputState, keyResult.nextState);
+                                    if (keyResult.handlerError !== undefined) {
+                                        options.fatalNowOrEnqueue("ZRUI_USER_CODE_THROW", `keybinding handler threw: ${describeThrown(keyResult.handlerError)}`);
+                                        return;
+                                    }
+                                    if (keyResult.consumed) {
+                                        options.noteBreadcrumbConsumptionPath("keybindings");
+                                        continue;
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    let routed;
+                    try {
+                        options.noteBreadcrumbConsumptionPath("widgetRouting");
+                        routed = options.widgetRenderer.routeEngineEvent(ev);
+                    }
+                    catch (error) {
+                        options.fatalNowOrEnqueue("ZRUI_USER_CODE_THROW", `widget routing threw: ${describeThrown(error)}`);
+                        return;
+                    }
+                    if (options.getRuntimeState() !== "Running")
+                        return;
+                    if (!options.emitFocusChangeIfNeeded())
+                        return;
+                    if (routed.needsRender)
+                        options.markDirty(DIRTY_RENDER);
+                    if (routed.action) {
+                        options.noteBreadcrumbAction(routed.action);
+                        if (!options.emit({ kind: "action", ...routed.action }))
+                            return;
+                        if (options.getRuntimeState() !== "Running")
+                            return;
+                    }
+                    if (routed.action === undefined &&
+                        !routed.needsRender &&
+                        routed.consumed !== true &&
+                        (isUnmodifiedTextQuitEvent(ev) || isUnhandledCtrlCKeyEvent(ev))) {
+                        options.noteBreadcrumbConsumptionPath("widgetRouting");
+                        options.stopFromUnhandledQuitEvent();
+                    }
+                }
+            }
+        }
+        finally {
+            release();
+        }
+    }
+    function drainIgnored(items, releasedBatches) {
+        for (const item of items) {
+            if (item.kind === "eventBatch" && !releasedBatches.has(item.batch)) {
+                releasedBatches.add(item.batch);
+                try {
+                    item.batch.release();
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+    }
+    function processTurn(items) {
+        options.setRenderRequestQueuedForCurrentTurn(false);
+        const releasedBatches = new Set();
+        const runtimeState = options.getRuntimeState();
+        if (runtimeState === "Disposed" || runtimeState === "Faulted") {
+            drainIgnored(items, releasedBatches);
+            return;
+        }
+        let sawKick = false;
+        for (const item of items) {
+            if (options.getRuntimeState() === "Faulted" || options.getRuntimeState() === "Disposed") {
+                drainIgnored(items, releasedBatches);
+                return;
+            }
+            switch (item.kind) {
+                case "fatal": {
+                    options.doFatal(item.code, item.detail);
+                    drainIgnored(items, releasedBatches);
+                    return;
+                }
+                case "eventBatch": {
+                    if (options.getRuntimeState() !== "Running") {
+                        releasedBatches.add(item.batch);
+                        try {
+                            item.batch.release();
+                        }
+                        catch {
+                            // ignore
+                        }
+                        break;
+                    }
+                    processEventBatch(item.batch, releasedBatches);
+                    if (options.getRuntimeState() !== "Running") {
+                        drainIgnored(items, releasedBatches);
+                        return;
+                    }
+                    commitUpdates();
+                    break;
+                }
+                case "userCommit": {
+                    options.setUserCommitScheduled(false);
+                    if (options.getRuntimeState() === "Running")
+                        commitUpdates();
+                    break;
+                }
+                case "kick": {
+                    sawKick = true;
+                    break;
+                }
+                case "renderRequest": {
+                    break;
+                }
+                case "frameDone": {
+                    options.setFramesInFlight(Math.max(0, options.getFramesInFlight() - 1));
+                    break;
+                }
+                case "frameError": {
+                    options.setFramesInFlight(Math.max(0, options.getFramesInFlight() - 1));
+                    if (options.getLifecycleBusy() === "stop")
+                        break;
+                    options.doFatal("ZRUI_BACKEND_ERROR", `requestFrame rejected: ${describeThrown(item.error)}`);
+                    break;
+                }
+            }
+        }
+        if (options.getRuntimeState() !== "Running")
+            return;
+        if (sawKick)
+            commitUpdates();
+        options.tryRenderOnce();
+    }
+    async function pollLoop(token) {
+        while (options.getRuntimeState() === "Running" && token === options.getPollToken()) {
+            let batch;
+            try {
+                batch = await options.backend.pollEvents();
+            }
+            catch (error) {
+                if (options.getRuntimeState() === "Running" && token === options.getPollToken()) {
+                    options.fatalNowOrEnqueue("ZRUI_BACKEND_ERROR", `pollEvents rejected: ${describeThrown(error)}`);
+                }
+                return;
+            }
+            if (token !== options.getPollToken() || options.getRuntimeState() !== "Running") {
+                try {
+                    batch.release();
+                }
+                catch {
+                    // ignore
+                }
+                return;
+            }
+            options.enqueueWorkItem({ kind: "eventBatch", batch });
+        }
+    }
+    return {
+        commitUpdates,
+        drainIgnored,
+        pollLoop,
+        processEventBatch,
+        processTurn,
+    };
+}
+//# sourceMappingURL=eventLoop.js.map

package/dist/app/createApp/eventLoop.js.map

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

package/dist/app/createApp/focusDispatcher.d.ts

@@ -0,0 +1,14 @@
+export type FocusDispatcher<T> = Readonly<{
+    emitIfChanged: () => boolean;
+    getLastEmittedId: () => string | null;
+    register: (handler: (info: T) => void) => () => void;
+}>;
+type CreateFocusDispatcherOptions<T> = Readonly<{
+    getFocusedId: () => string | null;
+    getFocusInfo: () => T;
+    initialFocusedId: string | null;
+    onHandlerError: (error: unknown) => void;
+}>;
+export declare function createFocusDispatcher<T>(options: CreateFocusDispatcherOptions<T>): FocusDispatcher<T>;
+export {};
+//# sourceMappingURL=focusDispatcher.d.ts.map

package/dist/app/createApp/focusDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusDispatcher.d.ts","sourceRoot":"","sources":["../../../src/app/createApp/focusDispatcher.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,QAAQ,CAAC;IACxC,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,gBAAgB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACtD,CAAC,CAAC;AAIH,KAAK,4BAA4B,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC9C,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C,CAAC,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACvC,eAAe,CAAC,CAAC,CAAC,CAuCpB"}

package/dist/app/createApp/focusDispatcher.js

@@ -0,0 +1,39 @@
+export function createFocusDispatcher(options) {
+    const handlers = [];
+    let lastEmittedId = options.initialFocusedId;
+    return {
+        emitIfChanged() {
+            const focusedId = options.getFocusedId();
+            if (focusedId === lastEmittedId)
+                return true;
+            lastEmittedId = focusedId;
+            const info = options.getFocusInfo();
+            const snapshot = [];
+            for (const slot of handlers) {
+                if (slot.active.value)
+                    snapshot.push(slot.fn);
+            }
+            for (const fn of snapshot) {
+                try {
+                    fn(info);
+                }
+                catch (error) {
+                    options.onHandlerError(error);
+                    return false;
+                }
+            }
+            return true;
+        },
+        getLastEmittedId() {
+            return lastEmittedId;
+        },
+        register(handler) {
+            const active = { value: true };
+            handlers.push({ fn: handler, active });
+            return () => {
+                active.value = false;
+            };
+        },
+    };
+}
+//# sourceMappingURL=focusDispatcher.js.map

package/dist/app/createApp/focusDispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusDispatcher.js","sourceRoot":"","sources":["../../../src/app/createApp/focusDispatcher.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,qBAAqB,CACnC,OAAwC;IAExC,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,IAAI,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAE7C,OAAO;QACL,aAAa;YACX,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YACzC,IAAI,SAAS,KAAK,aAAa;gBAAE,OAAO,IAAI,CAAC;YAC7C,aAAa,GAAG,SAAS,CAAC;YAE1B,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YACpC,MAAM,QAAQ,GAA6B,EAAE,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK;oBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChD,CAAC;YAED,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,EAAE,CAAC,IAAI,CAAC,CAAC;gBACX,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;oBAC9B,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,gBAAgB;YACd,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,QAAQ,CAAC,OAA0B;YACjC,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YACvC,OAAO,GAAG,EAAE;gBACV,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;YACvB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/app/createApp/guards.d.ts

@@ -0,0 +1,21 @@
+import { type ZrUiErrorCode } from "../../abi.js";
+import type { AppRuntimeState } from "../stateMachine.js";
+type CreateAppGuardsOptions = Readonly<{
+    getEventHandlerDepth: () => number;
+    getLifecycleBusy: () => "start" | "stop" | null;
+    getRuntimeState: () => AppRuntimeState;
+    isInCommit: () => boolean;
+    isInRender: () => boolean;
+}>;
+export type AppGuards = Readonly<{
+    assertKeybindingMutationAllowed: (method: string) => void;
+    assertLifecycleIdle: (method: string) => void;
+    assertNotReentrant: (method: string) => void;
+    assertOperational: (method: string) => void;
+    assertRouterMutationAllowed: (method: string) => void;
+    throwCode: (code: ZrUiErrorCode, detail: string) => never;
+    updateDuringRenderDetail: (method: string) => string;
+}>;
+export declare function createAppGuards(options: CreateAppGuardsOptions): AppGuards;
+export {};
+//# sourceMappingURL=guards.d.ts.map

package/dist/app/createApp/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../src/app/createApp/guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,KAAK,sBAAsB,GAAG,QAAQ,CAAC;IACrC,oBAAoB,EAAE,MAAM,MAAM,CAAC;IACnC,gBAAgB,EAAE,MAAM,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IAChD,eAAe,EAAE,MAAM,eAAe,CAAC;IACvC,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,OAAO,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,+BAA+B,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,2BAA2B,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,SAAS,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC;IAC1D,wBAAwB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACtD,CAAC,CAAC;AAEH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CAwD1E"}

package/dist/app/createApp/guards.js

@@ -0,0 +1,54 @@
+import { ZrUiError } from "../../abi.js";
+export function createAppGuards(options) {
+    function throwCode(code, detail) {
+        throw new ZrUiError(code, detail);
+    }
+    function assertOperational(method) {
+        const st = options.getRuntimeState();
+        if (st === "Disposed" || st === "Faulted") {
+            throwCode("ZRUI_INVALID_STATE", `${method}: app is ${st}`);
+        }
+        if (options.getLifecycleBusy() !== null) {
+            throwCode("ZRUI_INVALID_STATE", `${method}: lifecycle operation already in flight`);
+        }
+    }
+    function assertLifecycleIdle(method) {
+        if (options.getLifecycleBusy() !== null) {
+            throwCode("ZRUI_INVALID_STATE", `${method}: lifecycle operation already in flight`);
+        }
+    }
+    function assertNotReentrant(method) {
+        if (options.isInCommit() || options.isInRender() || options.getEventHandlerDepth() > 0) {
+            throwCode("ZRUI_REENTRANT_CALL", `${method}: re-entrant call`);
+        }
+    }
+    function updateDuringRenderDetail(method) {
+        return `${method}: called during render. Hint: This usually means an onPress/onChange callback calls app.update() synchronously during the render phase. Move state updates to event handlers or useEffect.`;
+    }
+    function assertRouterMutationAllowed(method) {
+        assertOperational(method);
+        if (options.isInCommit())
+            throwCode("ZRUI_REENTRANT_CALL", `${method}: called during commit`);
+        if (options.isInRender()) {
+            throwCode("ZRUI_UPDATE_DURING_RENDER", updateDuringRenderDetail(method));
+        }
+    }
+    function assertKeybindingMutationAllowed(method) {
+        assertOperational(method);
+        if (options.isInCommit())
+            throwCode("ZRUI_REENTRANT_CALL", `${method}: called during commit`);
+        if (options.isInRender()) {
+            throwCode("ZRUI_UPDATE_DURING_RENDER", updateDuringRenderDetail(method));
+        }
+    }
+    return {
+        assertKeybindingMutationAllowed,
+        assertLifecycleIdle,
+        assertNotReentrant,
+        assertOperational,
+        assertRouterMutationAllowed,
+        throwCode,
+        updateDuringRenderDetail,
+    };
+}
+//# sourceMappingURL=guards.js.map

package/dist/app/createApp/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../src/app/createApp/guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,cAAc,CAAC;AAqB7D,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,SAAS,SAAS,CAAC,IAAmB,EAAE,MAAc;QACpD,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,SAAS,iBAAiB,CAAC,MAAc;QACvC,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QACrC,IAAI,EAAE,KAAK,UAAU,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YAC1C,SAAS,CAAC,oBAAoB,EAAE,GAAG,MAAM,YAAY,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,OAAO,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC;YACxC,SAAS,CAAC,oBAAoB,EAAE,GAAG,MAAM,yCAAyC,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,SAAS,mBAAmB,CAAC,MAAc;QACzC,IAAI,OAAO,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC;YACxC,SAAS,CAAC,oBAAoB,EAAE,GAAG,MAAM,yCAAyC,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,SAAS,kBAAkB,CAAC,MAAc;QACxC,IAAI,OAAO,CAAC,UAAU,EAAE,IAAI,OAAO,CAAC,UAAU,EAAE,IAAI,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC,EAAE,CAAC;YACvF,SAAS,CAAC,qBAAqB,EAAE,GAAG,MAAM,mBAAmB,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,SAAS,wBAAwB,CAAC,MAAc;QAC9C,OAAO,GAAG,MAAM,4LAA4L,CAAC;IAC/M,CAAC;IAED,SAAS,2BAA2B,CAAC,MAAc;QACjD,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,OAAO,CAAC,UAAU,EAAE;YAAE,SAAS,CAAC,qBAAqB,EAAE,GAAG,MAAM,wBAAwB,CAAC,CAAC;QAC9F,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACzB,SAAS,CAAC,2BAA2B,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,SAAS,+BAA+B,CAAC,MAAc;QACrD,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,OAAO,CAAC,UAAU,EAAE;YAAE,SAAS,CAAC,qBAAqB,EAAE,GAAG,MAAM,wBAAwB,CAAC,CAAC;QAC9F,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACzB,SAAS,CAAC,2BAA2B,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO;QACL,+BAA+B;QAC/B,mBAAmB;QACnB,kBAAkB;QAClB,iBAAiB;QACjB,2BAA2B;QAC3B,SAAS;QACT,wBAAwB;KACzB,CAAC;AACJ,CAAC"}

package/dist/app/createApp/keybindings.d.ts

@@ -0,0 +1,27 @@
+import type { ZrUiErrorCode } from "../../abi.js";
+import type { BindingMap, KeyContext, KeybindingManagerState, ModeBindingMap } from "../../keybindings/index.js";
+type CreateAppKeybindingHelpersOptions<S> = Readonly<{
+    getState: () => KeybindingManagerState<KeyContext<S>>;
+    markDirty: (flags: number) => void;
+    setState: (nextState: KeybindingManagerState<KeyContext<S>>) => void;
+    throwCode: (code: ZrUiErrorCode, detail: string) => never;
+}>;
+export type AppKeybindingHelpers<S> = Readonly<{
+    applyRoutedKeybindingState: (routeInputState: KeybindingManagerState<KeyContext<S>>, routeNextState: KeybindingManagerState<KeyContext<S>>) => void;
+    registerAppBindings: (bindings: BindingMap<KeyContext<S>>, options?: Readonly<{
+        sourceTag?: string;
+        method?: string;
+    }>) => void;
+    registerAppModes: (modes: ModeBindingMap<KeyContext<S>>) => void;
+    replaceRouteBindings: (bindings: BindingMap<KeyContext<S>>) => void;
+}>;
+export declare function codepointToKeyCode(codepoint: number): number | null;
+export declare function codepointToCtrlKeyCode(codepoint: number): number | null;
+export declare function computeKeybindingsEnabled<S>(state: KeybindingManagerState<KeyContext<S>>): boolean;
+export declare function formatInvalidKeybindingDetail(invalidKeys: readonly Readonly<{
+    key: string;
+    detail: string;
+}>[]): string;
+export declare function createAppKeybindingHelpers<S>(options: CreateAppKeybindingHelpersOptions<S>): AppKeybindingHelpers<S>;
+export {};
+//# sourceMappingURL=keybindings.d.ts.map

package/dist/app/createApp/keybindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybindings.d.ts","sourceRoot":"","sources":["../../../src/app/createApp/keybindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,sBAAsB,EACtB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAUpC,KAAK,iCAAiC,CAAC,CAAC,IAAI,QAAQ,CAAC;IACnD,QAAQ,EAAE,MAAM,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,EAAE,CAAC,SAAS,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACrE,SAAS,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC;CAC3D,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC7C,0BAA0B,EAAE,CAC1B,eAAe,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACtD,cAAc,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAClD,IAAI,CAAC;IACV,mBAAmB,EAAE,CACnB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACnC,OAAO,CAAC,EAAE,QAAQ,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,KACxD,IAAI,CAAC;IACV,gBAAgB,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACjE,oBAAoB,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACrE,CAAC,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWnE;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvE;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,KAAK,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC3C,OAAO,CAKT;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,SAAS,QAAQ,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,GAChE,MAAM,CAER;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,OAAO,EAAE,iCAAiC,CAAC,CAAC,CAAC,GAC5C,oBAAoB,CAAC,CAAC,CAAC,CA2FzB"}