@slowclap/rezi-core 0.1.0-fork.1

package/dist/animation/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * packages/core/src/animation/types.ts — Core animation API types.
+ *
+ * Why: Centralize animation configs so hooks and renderer transitions share
+ * consistent behavior and defaults.
+ */
+/** Easing function input/output in [0..1]. */
+export type EasingFunction = (t: number) => number;
+/** Built-in easing presets for declarative animation hooks. */
+export type EasingName = "linear" | "easeInQuad" | "easeOutQuad" | "easeInOutQuad" | "easeInCubic" | "easeOutCubic" | "easeInOutCubic" | "easeInExpo" | "easeOutExpo" | "easeInOutExpo" | "easeInBack" | "easeOutBack" | "easeInOutBack" | "easeOutBounce" | "easeInBounce";
+/** Easing value accepted by transition APIs. */
+export type EasingInput = EasingName | EasingFunction;
+/** Playback controls for time-based animation hooks. */
+export type PlaybackControl = Readonly<{
+    /** Freeze animation at the current sampled value. */
+    paused?: boolean;
+    /** Run animation time backwards. */
+    reversed?: boolean;
+    /** Playback rate multiplier. */
+    rate?: number;
+}>;
+/** Time-based interpolation configuration. */
+export type TransitionConfig = Readonly<{
+    /** Delay before animation starts in milliseconds. */
+    delay?: number;
+    /** Transition duration in milliseconds. */
+    duration?: number;
+    /** Easing curve name or custom easing function. */
+    easing?: EasingInput;
+    /** Optional playback controls for pause/reverse/rate. */
+    playback?: PlaybackControl;
+    /** Called when the transition reaches the target value. */
+    onComplete?: () => void;
+}>;
+/** Spring simulation configuration. */
+export type SpringConfig = Readonly<{
+    /** Delay before spring simulation starts in milliseconds. */
+    delay?: number;
+    /** Hooke spring constant. Larger values snap faster. */
+    stiffness?: number;
+    /** Velocity damping factor. Larger values reduce oscillation. */
+    damping?: number;
+    /** Mass term. Higher values move more slowly. */
+    mass?: number;
+    /** Position threshold for settling. */
+    restDelta?: number;
+    /** Velocity threshold for settling. */
+    restSpeed?: number;
+    /** Maximum integration step in milliseconds. */
+    maxDeltaMs?: number;
+    /** Called when the spring settles at rest. */
+    onComplete?: () => void;
+}>;
+/** Internal normalized spring config with defaults applied. */
+export type NormalizedSpringConfig = Readonly<{
+    stiffness: number;
+    damping: number;
+    mass: number;
+    restDelta: number;
+    restSpeed: number;
+    maxDeltaMs: number;
+}>;
+/** Sequence keyframe input for `useSequence`. */
+export type SequenceKeyframe = number | Readonly<{
+    /** Keyframe numeric value. */
+    value: number;
+    /** Segment duration (ms) to the next keyframe. */
+    duration?: number;
+    /** Easing used for the segment to the next keyframe. */
+    easing?: EasingInput;
+}>;
+/** Sequence timeline configuration. */
+export type SequenceConfig = Readonly<{
+    /** Default per-segment duration in milliseconds. */
+    duration?: number;
+    /** Default easing for segments without per-keyframe easing. */
+    easing?: EasingInput;
+    /** Optional playback controls for pause/reverse/rate. */
+    playback?: PlaybackControl;
+    /** Loop sequence timeline when it reaches the end. */
+    loop?: boolean;
+    /** Called when the sequence reaches the final keyframe (when not looping). */
+    onComplete?: () => void;
+}>;
+/** Staggered list animation configuration. */
+export type StaggerConfig = Readonly<{
+    /** Delay between each item start in milliseconds. */
+    delay?: number;
+    /** Duration for each item in milliseconds. */
+    duration?: number;
+    /** Easing curve applied to each item's local progress. */
+    easing?: EasingInput;
+    /** Called when all item progress values reach 1.0. */
+    onComplete?: () => void;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/animation/types.d.ts.map

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

package/dist/animation/types.js

@@ -0,0 +1,8 @@
+/**
+ * packages/core/src/animation/types.ts — Core animation API types.
+ *
+ * Why: Centralize animation configs so hooks and renderer transitions share
+ * consistent behavior and defaults.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/animation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/animation/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

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

@@ -0,0 +1,38 @@
+import type { RuntimeBreadcrumbAction, RuntimeBreadcrumbConsumptionPath, RuntimeBreadcrumbEventKind, RuntimeBreadcrumbSnapshot, WidgetRuntimeBreadcrumbSnapshot } from "../runtimeBreadcrumbs.js";
+import type { AppLayoutSnapshot, AppRenderMetrics } from "../types.js";
+import type { WidgetRoutingOutcome } from "../widgetRenderer.js";
+export type InternalRuntimeBreadcrumbHooks = Readonly<{
+    onRender?: ((metrics: AppRenderMetrics) => void) | undefined;
+    onLayout?: ((snapshot: AppLayoutSnapshot) => void) | undefined;
+}>;
+type CreateRuntimeBreadcrumbHelpersOptions = Readonly<{
+    getBaseInternalOnLayout: () => ((snapshot: AppLayoutSnapshot) => void) | undefined;
+    getBaseInternalOnRender: () => ((metrics: AppRenderMetrics) => void) | undefined;
+    getInspectorInternalOnLayout: () => ((snapshot: AppLayoutSnapshot) => void) | undefined;
+    getInspectorInternalOnRender: () => ((metrics: AppRenderMetrics) => void) | undefined;
+    getLastAction: () => RuntimeBreadcrumbAction | null;
+    getLastConsumptionPath: () => RuntimeBreadcrumbConsumptionPath | null;
+    getLastEventKind: () => RuntimeBreadcrumbEventKind | null;
+    getWidgetRuntimeBreadcrumbSnapshot: () => WidgetRuntimeBreadcrumbSnapshot | null;
+    isEnabled: () => boolean;
+    isEventTracked: () => boolean;
+    setEnabled: (enabled: boolean) => void;
+    setEventTracked: (tracked: boolean) => void;
+    setInspectorInternalOnLayout: (callback: ((snapshot: AppLayoutSnapshot) => void) | undefined) => void;
+    setInspectorInternalOnRender: (callback: ((metrics: AppRenderMetrics) => void) | undefined) => void;
+    setLastAction: (action: RuntimeBreadcrumbAction | null) => void;
+    setLastConsumptionPath: (path: RuntimeBreadcrumbConsumptionPath | null) => void;
+    setLastEventKind: (kind: RuntimeBreadcrumbEventKind | null) => void;
+    setWidgetRuntimeBreadcrumbCaptureEnabled: (enabled: boolean) => void;
+}>;
+export type RuntimeBreadcrumbHelpers = Readonly<{
+    buildRuntimeBreadcrumbSnapshot: (renderTimeMs: number) => RuntimeBreadcrumbSnapshot | null;
+    noteBreadcrumbAction: (action: NonNullable<WidgetRoutingOutcome["action"]>) => void;
+    noteBreadcrumbConsumptionPath: (path: RuntimeBreadcrumbConsumptionPath) => void;
+    noteBreadcrumbEvent: (kind: string) => void;
+    recomputeRuntimeBreadcrumbCollection: () => void;
+    setInspectorHooks: (hooks: InternalRuntimeBreadcrumbHooks | null | undefined) => void;
+}>;
+export declare function createRuntimeBreadcrumbHelpers(options: CreateRuntimeBreadcrumbHelpersOptions): RuntimeBreadcrumbHelpers;
+export {};
+//# sourceMappingURL=breadcrumbs.d.ts.map

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

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

package/dist/app/createApp/breadcrumbs.js

@@ -0,0 +1,65 @@
+import { isRuntimeBreadcrumbEventKind, mergeRuntimeBreadcrumbSnapshot, toRuntimeBreadcrumbAction, } from "../runtimeBreadcrumbs.js";
+export function createRuntimeBreadcrumbHelpers(options) {
+    function recomputeRuntimeBreadcrumbCollection() {
+        const next = options.getBaseInternalOnRender() !== undefined ||
+            options.getBaseInternalOnLayout() !== undefined ||
+            options.getInspectorInternalOnRender() !== undefined ||
+            options.getInspectorInternalOnLayout() !== undefined;
+        if (next === options.isEnabled())
+            return;
+        options.setEnabled(next);
+        options.setWidgetRuntimeBreadcrumbCaptureEnabled(next);
+        if (!next) {
+            options.setLastEventKind(null);
+            options.setLastConsumptionPath(null);
+            options.setLastAction(null);
+            options.setEventTracked(false);
+        }
+    }
+    function noteBreadcrumbEvent(kind) {
+        options.setEventTracked(false);
+        if (!options.isEnabled())
+            return;
+        if (!isRuntimeBreadcrumbEventKind(kind))
+            return;
+        options.setLastEventKind(kind);
+        options.setLastConsumptionPath(null);
+        options.setEventTracked(true);
+    }
+    function noteBreadcrumbConsumptionPath(path) {
+        if (!options.isEnabled())
+            return;
+        if (!options.isEventTracked())
+            return;
+        options.setLastConsumptionPath(path);
+    }
+    function noteBreadcrumbAction(action) {
+        if (!options.isEnabled())
+            return;
+        if (!options.isEventTracked())
+            return;
+        options.setLastAction(toRuntimeBreadcrumbAction(action));
+    }
+    function buildRuntimeBreadcrumbSnapshot(renderTimeMs) {
+        if (!options.isEnabled())
+            return null;
+        const widgetSnapshot = options.getWidgetRuntimeBreadcrumbSnapshot();
+        if (!widgetSnapshot)
+            return null;
+        return mergeRuntimeBreadcrumbSnapshot(widgetSnapshot, options.getLastEventKind(), options.getLastConsumptionPath(), options.getLastAction(), renderTimeMs);
+    }
+    function setInspectorHooks(hooks) {
+        options.setInspectorInternalOnRender(typeof hooks?.onRender === "function" ? hooks.onRender : undefined);
+        options.setInspectorInternalOnLayout(typeof hooks?.onLayout === "function" ? hooks.onLayout : undefined);
+        recomputeRuntimeBreadcrumbCollection();
+    }
+    return {
+        buildRuntimeBreadcrumbSnapshot,
+        noteBreadcrumbAction,
+        noteBreadcrumbConsumptionPath,
+        noteBreadcrumbEvent,
+        recomputeRuntimeBreadcrumbCollection,
+        setInspectorHooks,
+    };
+}
+//# sourceMappingURL=breadcrumbs.js.map

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

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

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

@@ -0,0 +1,25 @@
+import { type BACKEND_FPS_CAP_MARKER, type BACKEND_MAX_EVENT_BYTES_MARKER, type RuntimeBackend } from "../../backend.js";
+import { type ResponsiveBreakpointThresholds } from "../../layout/responsive.js";
+import { type TerminalProfile } from "../../terminalProfile.js";
+import type { AppConfig, AppLayoutSnapshot, AppRenderMetrics } from "../types.js";
+export type ResolvedAppConfig = Readonly<{
+    fpsCap: number;
+    maxEventBytes: number;
+    maxDrawlistBytes: number;
+    rootPadding: number;
+    breakpointThresholds: ResponsiveBreakpointThresholds;
+    drawlistValidateParams: boolean;
+    drawlistReuseOutputBuffer: boolean;
+    drawlistEncodedStringCacheCap: number;
+    maxFramesInFlight: number;
+    themeTransitionFrames: number;
+    internal_onRender?: ((metrics: AppRenderMetrics) => void) | undefined;
+    internal_onLayout?: ((snapshot: AppLayoutSnapshot) => void) | undefined;
+}>;
+export declare function requirePositiveInt(name: string, v: number): number;
+export declare function resolveAppConfig(config: AppConfig | undefined): ResolvedAppConfig;
+export declare function readBackendPositiveIntMarker(backend: RuntimeBackend, marker: typeof BACKEND_MAX_EVENT_BYTES_MARKER | typeof BACKEND_FPS_CAP_MARKER): number | null;
+export declare function readBackendDrawlistVersionMarker(backend: RuntimeBackend): 1 | null;
+export declare function monotonicNowMs(): number;
+export declare function loadTerminalProfile(backend: RuntimeBackend): Promise<TerminalProfile>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/app/createApp/config.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,8BAA8B,EACnC,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,8BAA8B,EAEpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,8BAA8B,CAAC;IACrD,sBAAsB,EAAE,OAAO,CAAC;IAChC,yBAAyB,EAAE,OAAO,CAAC;IACnC,6BAA6B,EAAE,MAAM,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACtE,iBAAiB,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACzE,CAAC,CAAC;AAwBH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlE;AAaD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,CA6DjF;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,OAAO,8BAA8B,GAAG,OAAO,sBAAsB,GAC5E,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,cAAc,GAAG,CAAC,GAAG,IAAI,CAWlF;AAED,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAe3F"}

package/dist/app/createApp/config.js

@@ -0,0 +1,130 @@
+import { ZrUiError } from "../../abi.js";
+import { BACKEND_DRAWLIST_VERSION_MARKER, } from "../../backend.js";
+import { normalizeBreakpointThresholds, } from "../../layout/responsive.js";
+import { DEFAULT_TERMINAL_PROFILE, terminalProfileFromCaps, } from "../../terminalProfile.js";
+const DEFAULT_CONFIG = Object.freeze({
+    fpsCap: 60,
+    maxEventBytes: 1 << 20 /* 1 MiB */,
+    maxDrawlistBytes: 2 << 20 /* 2 MiB */,
+    rootPadding: 0,
+    breakpointThresholds: normalizeBreakpointThresholds(undefined),
+    drawlistValidateParams: true,
+    drawlistReuseOutputBuffer: true,
+    drawlistEncodedStringCacheCap: 131072,
+    maxFramesInFlight: 1,
+    themeTransitionFrames: 0,
+    internal_onRender: undefined,
+    internal_onLayout: undefined,
+});
+const MAX_SAFE_FPS_CAP = 1000;
+const MAX_SAFE_EVENT_BYTES = 4 << 20; /* 4 MiB */
+function invalidProps(detail) {
+    throw new ZrUiError("ZRUI_INVALID_PROPS", detail);
+}
+export function requirePositiveInt(name, v) {
+    if (!Number.isInteger(v) || v <= 0)
+        invalidProps(`${name} must be a positive integer`);
+    return v;
+}
+function requirePositiveIntAtMost(name, v, max) {
+    const parsed = requirePositiveInt(name, v);
+    if (parsed > max)
+        invalidProps(`${name} must be <= ${String(max)}`);
+    return parsed;
+}
+function requireNonNegativeInt(name, v) {
+    if (!Number.isInteger(v) || v < 0)
+        invalidProps(`${name} must be a non-negative integer`);
+    return v;
+}
+export function resolveAppConfig(config) {
+    if (!config)
+        return DEFAULT_CONFIG;
+    const fpsCap = config.fpsCap === undefined
+        ? DEFAULT_CONFIG.fpsCap
+        : requirePositiveIntAtMost("fpsCap", config.fpsCap, MAX_SAFE_FPS_CAP);
+    const maxEventBytes = config.maxEventBytes === undefined
+        ? DEFAULT_CONFIG.maxEventBytes
+        : requirePositiveIntAtMost("maxEventBytes", config.maxEventBytes, MAX_SAFE_EVENT_BYTES);
+    const maxDrawlistBytes = config.maxDrawlistBytes === undefined
+        ? DEFAULT_CONFIG.maxDrawlistBytes
+        : requirePositiveInt("maxDrawlistBytes", config.maxDrawlistBytes);
+    const rootPadding = config.rootPadding === undefined
+        ? DEFAULT_CONFIG.rootPadding
+        : requireNonNegativeInt("rootPadding", config.rootPadding);
+    const breakpointThresholds = normalizeBreakpointThresholds(config.breakpoints);
+    const drawlistValidateParams = config.drawlistValidateParams === undefined
+        ? DEFAULT_CONFIG.drawlistValidateParams
+        : config.drawlistValidateParams !== false;
+    const drawlistReuseOutputBuffer = config.drawlistReuseOutputBuffer === undefined
+        ? DEFAULT_CONFIG.drawlistReuseOutputBuffer
+        : config.drawlistReuseOutputBuffer === true;
+    const drawlistEncodedStringCacheCap = config.drawlistEncodedStringCacheCap === undefined
+        ? DEFAULT_CONFIG.drawlistEncodedStringCacheCap
+        : requireNonNegativeInt("drawlistEncodedStringCacheCap", config.drawlistEncodedStringCacheCap);
+    const maxFramesInFlight = config.maxFramesInFlight === undefined
+        ? DEFAULT_CONFIG.maxFramesInFlight
+        : Math.min(4, Math.max(1, requirePositiveInt("maxFramesInFlight", config.maxFramesInFlight)));
+    const themeTransitionFrames = config.themeTransitionFrames === undefined
+        ? DEFAULT_CONFIG.themeTransitionFrames
+        : requireNonNegativeInt("themeTransitionFrames", config.themeTransitionFrames);
+    const internal_onRender = typeof config.internal_onRender === "function" ? config.internal_onRender : undefined;
+    const internal_onLayout = typeof config.internal_onLayout === "function" ? config.internal_onLayout : undefined;
+    return Object.freeze({
+        fpsCap,
+        maxEventBytes,
+        maxDrawlistBytes,
+        rootPadding,
+        breakpointThresholds,
+        drawlistValidateParams,
+        drawlistReuseOutputBuffer,
+        drawlistEncodedStringCacheCap,
+        maxFramesInFlight,
+        themeTransitionFrames,
+        internal_onRender,
+        internal_onLayout,
+    });
+}
+export function readBackendPositiveIntMarker(backend, marker) {
+    const value = backend[marker];
+    if (value === undefined)
+        return null;
+    if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
+        invalidProps(`backend marker ${marker} must be a positive integer when present`);
+    }
+    return value;
+}
+export function readBackendDrawlistVersionMarker(backend) {
+    const value = backend[BACKEND_DRAWLIST_VERSION_MARKER];
+    if (value === undefined)
+        return null;
+    if (value !== 1) {
+        invalidProps(`backend marker ${BACKEND_DRAWLIST_VERSION_MARKER} must be 1 (received ${String(value)})`);
+    }
+    return 1;
+}
+export function monotonicNowMs() {
+    const perf = globalThis.performance;
+    const perfNow = perf?.now;
+    if (typeof perfNow === "function")
+        return perfNow.call(perf);
+    return Date.now();
+}
+export async function loadTerminalProfile(backend) {
+    try {
+        if (typeof backend.getTerminalProfile === "function") {
+            return await backend.getTerminalProfile();
+        }
+    }
+    catch {
+        // fall through to caps-derived profile
+    }
+    try {
+        const caps = await backend.getCaps();
+        return terminalProfileFromCaps(caps);
+    }
+    catch {
+        return DEFAULT_TERMINAL_PROFILE;
+    }
+}
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { WidgetRenderPlan } from "../widgetRenderer.js";
+export declare const DIRTY_RENDER: number;
+export declare const DIRTY_LAYOUT: number;
+export declare const DIRTY_VIEW: number;
+export type DirtyVersionSnapshot = Readonly<{
+    render: number;
+    layout: number;
+    view: number;
+}>;
+export type DirtyTracker = Readonly<{
+    clearConsumedFlags: (consumedFlags: number, snapshot: DirtyVersionSnapshot) => void;
+    getFlags: () => number;
+    markDirty: (flags: number) => Readonly<{
+        wasDirty: boolean;
+        flags: number;
+    }>;
+    snapshotVersions: () => DirtyVersionSnapshot;
+}>;
+export declare function createDirtyTracker(): DirtyTracker;
+export declare function buildWidgetRenderPlan(dirtyFlags: number, nowMs: number): WidgetRenderPlan;
+//# sourceMappingURL=dirtyPlan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dirtyPlan.d.ts","sourceRoot":"","sources":["../../../src/app/createApp/dirtyPlan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,eAAO,MAAM,YAAY,QAAS,CAAC;AACnC,eAAO,MAAM,YAAY,QAAS,CAAC;AACnC,eAAO,MAAM,UAAU,QAAS,CAAC;AAEjC,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,kBAAkB,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACpF,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;CAC9C,CAAC,CAAC;AAEH,wBAAgB,kBAAkB,IAAI,YAAY,CA0CjD;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAOzF"}

package/dist/app/createApp/dirtyPlan.js

@@ -0,0 +1,54 @@
+export const DIRTY_RENDER = 1 << 0;
+export const DIRTY_LAYOUT = 1 << 1;
+export const DIRTY_VIEW = 1 << 2;
+export function createDirtyTracker() {
+    let dirtyFlags = 0;
+    let dirtyRenderVersion = 0;
+    let dirtyLayoutVersion = 0;
+    let dirtyViewVersion = 0;
+    return {
+        clearConsumedFlags(consumedFlags, snapshot) {
+            let clearMask = 0;
+            if ((consumedFlags & DIRTY_RENDER) !== 0 && dirtyRenderVersion === snapshot.render) {
+                clearMask |= DIRTY_RENDER;
+            }
+            if ((consumedFlags & DIRTY_LAYOUT) !== 0 && dirtyLayoutVersion === snapshot.layout) {
+                clearMask |= DIRTY_LAYOUT;
+            }
+            if ((consumedFlags & DIRTY_VIEW) !== 0 && dirtyViewVersion === snapshot.view) {
+                clearMask |= DIRTY_VIEW;
+            }
+            dirtyFlags &= ~clearMask;
+        },
+        getFlags() {
+            return dirtyFlags;
+        },
+        markDirty(flags) {
+            const wasDirty = dirtyFlags !== 0;
+            dirtyFlags |= flags;
+            if ((flags & DIRTY_RENDER) !== 0)
+                dirtyRenderVersion++;
+            if ((flags & DIRTY_LAYOUT) !== 0)
+                dirtyLayoutVersion++;
+            if ((flags & DIRTY_VIEW) !== 0)
+                dirtyViewVersion++;
+            return { wasDirty, flags: dirtyFlags };
+        },
+        snapshotVersions() {
+            return {
+                render: dirtyRenderVersion,
+                layout: dirtyLayoutVersion,
+                view: dirtyViewVersion,
+            };
+        },
+    };
+}
+export function buildWidgetRenderPlan(dirtyFlags, nowMs) {
+    return {
+        commit: (dirtyFlags & DIRTY_VIEW) !== 0,
+        layout: (dirtyFlags & DIRTY_LAYOUT) !== 0,
+        checkLayoutStability: (dirtyFlags & DIRTY_LAYOUT) === 0 && (dirtyFlags & DIRTY_VIEW) !== 0,
+        nowMs,
+    };
+}
+//# sourceMappingURL=dirtyPlan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dirtyPlan.js","sourceRoot":"","sources":["../../../src/app/createApp/dirtyPlan.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,CAAC;AAejC,MAAM,UAAU,kBAAkB;IAChC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,OAAO;QACL,kBAAkB,CAAC,aAAqB,EAAE,QAA8B;YACtE,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,kBAAkB,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACnF,SAAS,IAAI,YAAY,CAAC;YAC5B,CAAC;YACD,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,kBAAkB,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACnF,SAAS,IAAI,YAAY,CAAC;YAC5B,CAAC;YACD,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,gBAAgB,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC7E,SAAS,IAAI,UAAU,CAAC;YAC1B,CAAC;YACD,UAAU,IAAI,CAAC,SAAS,CAAC;QAC3B,CAAC;QAED,QAAQ;YACN,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,SAAS,CAAC,KAAa;YACrB,MAAM,QAAQ,GAAG,UAAU,KAAK,CAAC,CAAC;YAClC,UAAU,IAAI,KAAK,CAAC;YACpB,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;gBAAE,kBAAkB,EAAE,CAAC;YACvD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;gBAAE,kBAAkB,EAAE,CAAC;YACvD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;gBAAE,gBAAgB,EAAE,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QACzC,CAAC;QAED,gBAAgB;YACd,OAAO;gBACL,MAAM,EAAE,kBAAkB;gBAC1B,MAAM,EAAE,kBAAkB;gBAC1B,IAAI,EAAE,gBAAgB;aACvB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,KAAa;IACrE,OAAO;QACL,MAAM,EAAE,CAAC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC;QACvC,MAAM,EAAE,CAAC,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC;QACzC,oBAAoB,EAAE,CAAC,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC;QAC1F,KAAK;KACN,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,95 @@
+import type { ZrUiErrorCode } from "../../abi.js";
+import type { BackendEventBatch, RuntimeBackend } from "../../backend.js";
+import type { UiEvent } from "../../events.js";
+import type { KeyContext, KeybindingManagerState } from "../../keybindings/index.js";
+import type { EventTimeUnwrapState } from "../../protocol/types.js";
+import type { AppRuntimeState } from "../stateMachine.js";
+import type { StateUpdater, UpdateQueue } from "../updateQueue.js";
+import type { WidgetRenderer, WidgetRoutingOutcome } from "../widgetRenderer.js";
+import type { ResolvedAppConfig } from "./config.js";
+import { type AppKeybindingHelpers } from "./keybindings.js";
+import { type TopLevelViewError } from "./topLevelViewError.js";
+export type WorkItem = Readonly<{
+    kind: "eventBatch";
+    batch: BackendEventBatch;
+}> | Readonly<{
+    kind: "userCommit";
+}> | Readonly<{
+    kind: "kick";
+}> | Readonly<{
+    kind: "renderRequest";
+}> | Readonly<{
+    kind: "frameDone";
+}> | Readonly<{
+    kind: "frameError";
+    error: unknown;
+}> | Readonly<{
+    kind: "fatal";
+    code: ZrUiErrorCode;
+    detail: string;
+}>;
+type CreateEventLoopOptions<S> = Readonly<{
+    backend: RuntimeBackend;
+    config: ResolvedAppConfig;
+    doFatal: (code: ZrUiErrorCode, detail: string) => void;
+    emit: (ev: UiEvent) => boolean;
+    emitFocusChangeIfNeeded: () => boolean;
+    enqueueWorkItem: (item: WorkItem) => void;
+    fatalNowOrEnqueue: (code: ZrUiErrorCode, detail: string) => void;
+    getAppUpdate: () => (updater: StateUpdater<S>) => void;
+    getCommittedState: () => Readonly<S>;
+    getFramesInFlight: () => number;
+    getInteractiveBudget: () => number;
+    getKeybindingState: () => KeybindingManagerState<KeyContext<S>>;
+    getKeybindingsEnabled: () => boolean;
+    getLastObservedSpinnerTickEventMs: () => number;
+    getLastSpinnerRenderPerfMs: () => number;
+    getLastSpinnerRenderTickMs: () => number;
+    getLifecycleBusy: () => "start" | "stop" | null;
+    getMode: () => "raw" | "widget" | null;
+    getPollToken: () => number;
+    getRenderRequestQueuedForCurrentTurn: () => boolean;
+    getRuntimeState: () => AppRuntimeState;
+    getTopLevelViewError: () => TopLevelViewError | null;
+    getViewport: () => Readonly<{
+        cols: number;
+        rows: number;
+    }> | null;
+    keybindingHelpers: Pick<AppKeybindingHelpers<S>, "applyRoutedKeybindingState">;
+    markDirty: (flags: number, schedule?: boolean) => void;
+    noteBreadcrumbAction: (action: NonNullable<WidgetRoutingOutcome["action"]>) => void;
+    noteBreadcrumbConsumptionPath: (path: "keybindings" | "widgetRouting") => void;
+    noteBreadcrumbEvent: (kind: string) => void;
+    quitFromTopLevelViewError: () => void;
+    retryTopLevelViewError: () => void;
+    setCommittedState: (nextState: S) => void;
+    setFramesInFlight: (next: number) => void;
+    setInCommit: (next: boolean) => void;
+    setInteractiveBudget: (next: number) => void;
+    setKeybindingState: (nextState: KeybindingManagerState<KeyContext<S>>) => void;
+    setLastObservedSpinnerTickEventMs: (next: number) => void;
+    setLastSpinnerRenderPerfMs: (next: number) => void;
+    setLastSpinnerRenderTickMs: (next: number) => void;
+    setRenderRequestQueuedForCurrentTurn: (next: boolean) => void;
+    setUserCommitScheduled: (next: boolean) => void;
+    setViewport: (next: Readonly<{
+        cols: number;
+        rows: number;
+    }> | null) => void;
+    spinnerTickMinIntervalMs: number;
+    stopFromUnhandledQuitEvent: () => void;
+    timeUnwrap: EventTimeUnwrapState;
+    tryRenderOnce: () => void;
+    updates: UpdateQueue<S>;
+    widgetRenderer: WidgetRenderer<S>;
+}>;
+export type AppEventLoop = Readonly<{
+    commitUpdates: () => void;
+    drainIgnored: (items: readonly WorkItem[], releasedBatches: Set<BackendEventBatch>) => void;
+    pollLoop: (token: number) => Promise<void>;
+    processEventBatch: (batch: BackendEventBatch, releasedBatches: Set<BackendEventBatch>) => void;
+    processTurn: (items: readonly WorkItem[]) => void;
+}>;
+export declare function createEventLoop<S>(options: CreateEventLoopOptions<S>): AppEventLoop;
+export {};
+//# sourceMappingURL=eventLoop.d.ts.map

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

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