@slowclap/rezi-core 0.1.0-fork.1

package/dist/app/createApp/topLevelViewError.js

@@ -0,0 +1,87 @@
+import { describeThrown } from "../../debug/describeThrown.js";
+import { ZR_MOD_ALT, ZR_MOD_CTRL, ZR_MOD_META, ZR_MOD_SHIFT } from "../../keybindings/keyCodes.js";
+import { ui } from "../../widgets/ui.js";
+const KEY_Q = 81;
+const KEY_R = 82;
+const KEY_C = 67;
+const KEY_LOWER_Q = 113;
+const KEY_LOWER_R = 114;
+const CTRL_C_CODEPOINT = 3;
+function isUnmodifiedLetterKey(mods) {
+    return (mods & (ZR_MOD_CTRL | ZR_MOD_ALT | ZR_MOD_META)) === 0;
+}
+export function captureTopLevelViewError(value) {
+    if (value instanceof Error) {
+        return Object.freeze({
+            code: "ZRUI_USER_CODE_THROW",
+            detail: `${value.name}: ${value.message}`,
+            message: value.message,
+            ...(typeof value.stack === "string" && value.stack.length > 0 ? { stack: value.stack } : {}),
+        });
+    }
+    const detail = describeThrown(value);
+    return Object.freeze({
+        code: "ZRUI_USER_CODE_THROW",
+        detail,
+        message: detail,
+    });
+}
+export function buildTopLevelViewErrorScreen(error) {
+    const lines = [`Code: ${error.code}`, `Message: ${error.message}`];
+    if (error.stack === undefined || error.stack.length === 0) {
+        lines.push(`Detail: ${error.detail}`);
+    }
+    return ui.column({ width: "full", height: "full", justify: "center", align: "center", p: 1 }, [
+        ui.box({
+            width: "full",
+            height: "full",
+            border: "single",
+            title: "Runtime Error",
+            p: 1,
+        }, [
+            ui.errorDisplay(lines.join("\n"), {
+                title: "Top-level view() threw",
+                ...(error.stack === undefined || error.stack.length === 0
+                    ? {}
+                    : { stack: error.stack, showStack: true }),
+            }),
+            ui.callout("Press R to retry, Q to quit", { variant: "warning" }),
+        ]),
+    ]);
+}
+export function isTopLevelRetryEvent(ev) {
+    if (ev.kind === "key") {
+        return ev.action === "down" && isUnmodifiedLetterKey(ev.mods) && ev.key === KEY_R;
+    }
+    if (ev.kind === "text") {
+        return ev.codepoint === KEY_R || ev.codepoint === KEY_LOWER_R;
+    }
+    return false;
+}
+export function isTopLevelQuitEvent(ev) {
+    if (ev.kind === "key") {
+        return ev.action === "down" && isUnmodifiedLetterKey(ev.mods) && ev.key === KEY_Q;
+    }
+    if (ev.kind === "text") {
+        return ev.codepoint === KEY_Q || ev.codepoint === KEY_LOWER_Q;
+    }
+    return false;
+}
+export function isUnmodifiedTextQuitEvent(ev) {
+    if (ev.kind !== "text")
+        return false;
+    return (ev.codepoint === KEY_Q || ev.codepoint === KEY_LOWER_Q || ev.codepoint === CTRL_C_CODEPOINT);
+}
+export function isUnhandledCtrlCKeyEvent(ev) {
+    if (ev.kind !== "key")
+        return false;
+    if (ev.action !== "down")
+        return false;
+    if (ev.key !== KEY_C)
+        return false;
+    const hasCtrl = (ev.mods & ZR_MOD_CTRL) !== 0;
+    if (!hasCtrl)
+        return false;
+    return (ev.mods & (ZR_MOD_SHIFT | ZR_MOD_ALT | ZR_MOD_META)) === 0;
+}
+//# sourceMappingURL=topLevelViewError.js.map

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

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

package/dist/app/createApp.d.ts

@@ -0,0 +1,52 @@
+/**
+ * packages/core/src/app/createApp.ts — Application factory and runtime orchestration.
+ *
+ * Why: Creates and manages the Rezi application instance, orchestrating
+ * the event loop, state management, and rendering pipeline. This is the main
+ * entry point for creating terminal UI applications.
+ *
+ * Responsibilities:
+ *   - Lifecycle management (start/stop/dispose)
+ *   - Mode selection (raw draw vs widget view)
+ *   - Event polling and parsing
+ *   - State update batching and commit
+ *   - Render scheduling with frame coalescing
+ *   - Fatal error handling with graceful teardown
+ *
+ * Invariants:
+ *   - Re-entrant API calls throw ZRUI_REENTRANT_CALL
+ *   - update() during render throws ZRUI_UPDATE_DURING_RENDER
+ *   - Mode cannot be changed after first start()
+ *   - Fatal errors transition to Faulted and dispose backend
+ *
+ * @see docs/guide/lifecycle-and-updates.md
+ */
+import { type RuntimeBackend } from "../backend.js";
+import type { RouteDefinition } from "../router/types.js";
+import type { ThemeDefinition } from "../theme/tokens.js";
+import { type ResolvedAppConfig } from "./createApp/config.js";
+import type { App, AppConfig } from "./types.js";
+export declare const APP_INTERNAL_REQUEST_VIEW_LAYOUT_MARKER = "__reziRequestViewLayout";
+export declare const APP_INTERNAL_SET_RUNTIME_BREADCRUMB_HOOKS_MARKER = "__reziSetRuntimeBreadcrumbHooks";
+type CreateAppBaseOptions = Readonly<{
+    backend: RuntimeBackend;
+    config?: AppConfig;
+    theme?: ThemeDefinition;
+}>;
+type CreateAppStateOptions<S> = CreateAppBaseOptions & Readonly<{
+    initialState: S;
+    routes?: readonly RouteDefinition<S>[];
+    initialRoute?: string;
+    routeHistoryMaxDepth?: number;
+}>;
+type CreateAppRoutesOnlyOptions = CreateAppBaseOptions & Readonly<{
+    routes: readonly RouteDefinition<Record<string, never>>[];
+    initialRoute: string;
+    initialState?: Record<string, never>;
+    routeHistoryMaxDepth?: number;
+}>;
+export declare function resolveAppConfig(config: AppConfig | undefined): ResolvedAppConfig;
+export declare function createApp(opts: CreateAppRoutesOnlyOptions): App<Record<string, never>>;
+export declare function createApp<S>(opts: CreateAppStateOptions<S>): App<S>;
+export {};
+//# sourceMappingURL=createApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../../src/app/createApp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAoBvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK1D,OAAO,EACL,KAAK,iBAAiB,EAMvB,MAAM,uBAAuB,CAAC;AAsB/B,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAoD,MAAM,YAAY,CAAC;AAInG,eAAO,MAAM,uCAAuC,4BAA4B,CAAC;AACjF,eAAO,MAAM,gDAAgD,oCAAoC,CAAC;AAKlG,KAAK,oBAAoB,GAAG,QAAQ,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB,CAAC,CAAC;AAEH,KAAK,qBAAqB,CAAC,CAAC,IAAI,oBAAoB,GAClD,QAAQ,CAAC;IACP,YAAY,EAAE,CAAC,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC,CAAC;AAEL,KAAK,0BAA0B,GAAG,oBAAoB,GACpD,QAAQ,CAAC;IACP,MAAM,EAAE,SAAS,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC,CAAC;AAML,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,CAEjF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,0BAA0B,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AACxF,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC"}