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

package/README.md

@@ -3,10 +3,11 @@
 Runtime-agnostic TypeScript core for Rezi:
 
 - widget constructors (`ui.*`)
+- declarative animation hooks (`useTransition`, `useSpring`, `useSequence`, `useStagger`)
+- box transition props (`transition`, `opacity`)
 - reconciliation + layout + focus + routing
 - drawlist building (ZRDL) and event batch parsing (ZREV)
 
 Most applications should use the Node backend package (`@rezi-ui/node`), which depends on this package.
 
-Docs: `https://rtlzeromemory.github.io/Rezi/`
-
+Docs: `https://rezitui.dev/docs`

package/dist/abi.d.ts

@@ -8,13 +8,13 @@
  * These must match the C engine's zr_version.h exactly.
  */
 export declare const ZR_ENGINE_ABI_MAJOR = 1;
-export declare const ZR_ENGINE_ABI_MINOR = 1;
+export declare const ZR_ENGINE_ABI_MINOR = 2;
 export declare const ZR_ENGINE_ABI_PATCH = 0;
 /**
  * Binary format version pins.
  */
 export declare const ZR_DRAWLIST_VERSION_V1 = 1;
-export declare const ZR_DRAWLIST_VERSION_V2 = 2;
+export declare const ZR_DRAWLIST_VERSION = 1;
 export declare const ZR_EVENT_BATCH_VERSION_V1 = 1;
 /**
  * Cursor shape values for SET_CURSOR command (v2+).
@@ -59,7 +59,7 @@ export declare enum ZrResult {
  * Deterministic error codes for all runtime violations.
  * These are surfaced as ZrUiError instances.
  */
-export type ZrUiErrorCode = "ZRUI_INVALID_STATE" | "ZRUI_MODE_CONFLICT" | "ZRUI_NO_RENDER_MODE" | "ZRUI_REENTRANT_CALL" | "ZRUI_UPDATE_DURING_RENDER" | "ZRUI_DUPLICATE_KEY" | "ZRUI_DUPLICATE_ID" | "ZRUI_INVALID_PROPS" | "ZRUI_PROTOCOL_ERROR" | "ZRUI_DRAWLIST_BUILD_ERROR" | "ZRUI_BACKEND_ERROR" | "ZRUI_USER_CODE_THROW";
+export type ZrUiErrorCode = "ZRUI_INVALID_STATE" | "ZRUI_MODE_CONFLICT" | "ZRUI_NO_RENDER_MODE" | "ZRUI_REENTRANT_CALL" | "ZRUI_UPDATE_DURING_RENDER" | "ZRUI_DUPLICATE_KEY" | "ZRUI_DUPLICATE_ID" | "ZRUI_INVALID_PROPS" | "ZRUI_INVALID_CONSTRAINT" | "ZRUI_CIRCULAR_CONSTRAINT" | "ZRUI_PROTOCOL_ERROR" | "ZRUI_DRAWLIST_BUILD_ERROR" | "ZRUI_BACKEND_ERROR" | "ZRUI_USER_CODE_THROW";
 /**
  * Error class for all deterministic runtime violations.
  * The `code` property identifies the specific violation.

package/dist/abi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAM3C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,UAAU,aAAa,CAAC;AACrC,eAAO,MAAM,UAAU,aAAa,CAAC;AAMrC;;;GAGG;AACH,oBAAY,QAAQ;IAClB,uCAAuC;IACvC,EAAE,IAAI;IACN,mDAAmD;IACnD,oBAAoB,KAAK;IACzB,wBAAwB;IACxB,OAAO,KAAK;IACZ,qCAAqC;IACrC,SAAS,KAAK;IACd,uCAAuC;IACvC,eAAe,KAAK;IACpB,4BAA4B;IAC5B,UAAU,KAAK;IACf,8BAA8B;IAC9B,YAAY,KAAK;CAClB;AAMD;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,2BAA2B,GAC3B,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,GACrB,2BAA2B,GAC3B,oBAAoB,GACpB,sBAAsB,CAAC;AAM3B;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAkB,IAAI,eAAe;IACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAEjB,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM;CASlD"}
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,mBAAmB,IAAyB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAM3C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,UAAU,aAAa,CAAC;AACrC,eAAO,MAAM,UAAU,aAAa,CAAC;AAMrC;;;GAGG;AACH,oBAAY,QAAQ;IAClB,uCAAuC;IACvC,EAAE,IAAI;IACN,mDAAmD;IACnD,oBAAoB,KAAK;IACzB,wBAAwB;IACxB,OAAO,KAAK;IACZ,qCAAqC;IACrC,SAAS,KAAK;IACd,uCAAuC;IACvC,eAAe,KAAK;IACpB,4BAA4B;IAC5B,UAAU,KAAK;IACf,8BAA8B;IAC9B,YAAY,KAAK;CAClB;AAMD;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,2BAA2B,GAC3B,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,yBAAyB,GACzB,0BAA0B,GAC1B,qBAAqB,GACrB,2BAA2B,GAC3B,oBAAoB,GACpB,sBAAsB,CAAC;AAM3B;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAkB,IAAI,eAAe;IACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAEjB,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM;CASlD"}

package/dist/abi.js

@@ -11,13 +11,13 @@
  * These must match the C engine's zr_version.h exactly.
  */
 export const ZR_ENGINE_ABI_MAJOR = 1;
-export const ZR_ENGINE_ABI_MINOR = 1;
+export const ZR_ENGINE_ABI_MINOR = 2;
 export const ZR_ENGINE_ABI_PATCH = 0;
 /**
  * Binary format version pins.
  */
 export const ZR_DRAWLIST_VERSION_V1 = 1;
-export const ZR_DRAWLIST_VERSION_V2 = 2;
+export const ZR_DRAWLIST_VERSION = ZR_DRAWLIST_VERSION_V1;
 export const ZR_EVENT_BATCH_VERSION_V1 = 1;
 // =============================================================================
 // Cursor Shape Constants (from zr_drawlist.h SET_CURSOR)

package/dist/abi.js.map

@@ -1 +1 @@
-{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C,gFAAgF;AAChF,yDAAyD;AACzD,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAIrC;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,8BAA8B;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,8BAA8B;AAEpE,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAN,IAAY,QAeX;AAfD,WAAY,QAAQ;IAClB,uCAAuC;IACvC,mCAAM,CAAA;IACN,mDAAmD;IACnD,wEAAyB,CAAA;IACzB,wBAAwB;IACxB,8CAAY,CAAA;IACZ,qCAAqC;IACrC,kDAAc,CAAA;IACd,uCAAuC;IACvC,8DAAoB,CAAA;IACpB,4BAA4B;IAC5B,oDAAe,CAAA;IACf,8BAA8B;IAC9B,wDAAiB,CAAA;AACnB,CAAC,EAfW,QAAQ,KAAR,QAAQ,QAenB;AAwBD,gFAAgF;AAChF,6DAA6D;AAC7D,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAChB,IAAI,GAAG,WAAW,CAAC;IAC5B,IAAI,CAAgB;IAE7B,YAAY,IAAmB,EAAE,OAAgB;QAC/C,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,iDAAiD;QACjD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAC1D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C,gFAAgF;AAChF,yDAAyD;AACzD,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAIrC;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,8BAA8B;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,8BAA8B;AAEpE,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAN,IAAY,QAeX;AAfD,WAAY,QAAQ;IAClB,uCAAuC;IACvC,mCAAM,CAAA;IACN,mDAAmD;IACnD,wEAAyB,CAAA;IACzB,wBAAwB;IACxB,8CAAY,CAAA;IACZ,qCAAqC;IACrC,kDAAc,CAAA;IACd,uCAAuC;IACvC,8DAAoB,CAAA;IACpB,4BAA4B;IAC5B,oDAAe,CAAA;IACf,8BAA8B;IAC9B,wDAAiB,CAAA;AACnB,CAAC,EAfW,QAAQ,KAAR,QAAQ,QAenB;AA0BD,gFAAgF;AAChF,6DAA6D;AAC7D,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAChB,IAAI,GAAG,WAAW,CAAC;IAC5B,IAAI,CAAgB;IAE7B,YAAY,IAAmB,EAAE,OAAgB;QAC/C,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,iDAAiD;QACjD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;CACF"}

package/dist/animation/easing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * packages/core/src/animation/easing.ts — Easing curve helpers.
+ */
+import type { EasingFunction, EasingInput } from "./types.js";
+/** Resolve user-provided easing value to a safe function. */
+export declare function resolveEasing(input: EasingInput | undefined): EasingFunction;
+//# sourceMappingURL=easing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../../src/animation/easing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAgE1E,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc,CAM5E"}

package/dist/animation/easing.js

@@ -0,0 +1,68 @@
+/**
+ * packages/core/src/animation/easing.ts — Easing curve helpers.
+ */
+import { clamp01 } from "./interpolate.js";
+const EASE_IN_BACK_OVERSHOOT = 1.70158;
+const EASE_IN_OUT_BACK_OVERSHOOT = EASE_IN_BACK_OVERSHOOT * 1.525;
+const easeOutBounce = (t) => {
+    if (t < 1 / 2.75)
+        return 7.5625 * t * t;
+    if (t < 2 / 2.75) {
+        const shifted = t - 1.5 / 2.75;
+        return 7.5625 * shifted * shifted + 0.75;
+    }
+    if (t < 2.5 / 2.75) {
+        const shifted = t - 2.25 / 2.75;
+        return 7.5625 * shifted * shifted + 0.9375;
+    }
+    const shifted = t - 2.625 / 2.75;
+    return 7.5625 * shifted * shifted + 0.984375;
+};
+const EASING_PRESETS = Object.freeze({
+    linear: (t) => t,
+    easeInQuad: (t) => t * t,
+    easeOutQuad: (t) => 1 - (1 - t) * (1 - t),
+    easeInOutQuad: (t) => (t < 0.5 ? 2 * t * t : 1 - (-2 * t + 2) ** 2 / 2),
+    easeInCubic: (t) => t * t * t,
+    easeOutCubic: (t) => 1 - (1 - t) ** 3,
+    easeInOutCubic: (t) => (t < 0.5 ? 4 * t * t * t : 1 - (-2 * t + 2) ** 3 / 2),
+    easeInExpo: (t) => (t === 0 ? 0 : 2 ** (10 * (t - 1))),
+    easeOutExpo: (t) => (t === 1 ? 1 : 1 - 2 ** (-10 * t)),
+    easeInOutExpo: (t) => {
+        if (t === 0 || t === 1)
+            return t;
+        return t < 0.5 ? 2 ** (20 * t - 10) / 2 : (2 - 2 ** (-20 * t + 10)) / 2;
+    },
+    easeInBack: (t) => t * t * ((EASE_IN_BACK_OVERSHOOT + 1) * t - EASE_IN_BACK_OVERSHOOT),
+    easeOutBack: (t) => {
+        const shifted = t - 1;
+        return (shifted * shifted * ((EASE_IN_BACK_OVERSHOOT + 1) * shifted + EASE_IN_BACK_OVERSHOOT) + 1);
+    },
+    easeInOutBack: (t) => {
+        const scaled = t * 2;
+        if (scaled < 1) {
+            return ((scaled *
+                scaled *
+                ((EASE_IN_OUT_BACK_OVERSHOOT + 1) * scaled - EASE_IN_OUT_BACK_OVERSHOOT)) /
+                2);
+        }
+        const shifted = scaled - 2;
+        return ((shifted *
+            shifted *
+            ((EASE_IN_OUT_BACK_OVERSHOOT + 1) * shifted + EASE_IN_OUT_BACK_OVERSHOOT) +
+            2) /
+            2);
+    },
+    easeOutBounce,
+    easeInBounce: (t) => 1 - easeOutBounce(1 - t),
+});
+/** Resolve user-provided easing value to a safe function. */
+export function resolveEasing(input) {
+    if (typeof input === "function") {
+        return (t) => clamp01(input(clamp01(t)));
+    }
+    if (!input)
+        return EASING_PRESETS.linear;
+    return EASING_PRESETS[input] ?? EASING_PRESETS.linear;
+}
+//# sourceMappingURL=easing.js.map

package/dist/animation/easing.js.map

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

package/dist/animation/interpolate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * packages/core/src/animation/interpolate.ts — Primitive interpolation helpers.
+ */
+import { type Rgb24 } from "../widgets/style.js";
+/** Clamp a number into [0, 1]. */
+export declare function clamp01(value: number): number;
+/** Clamp an animation duration to a safe, non-negative integer in milliseconds. */
+export declare function normalizeDurationMs(durationMs: number | undefined, fallbackMs: number): number;
+/** Linear interpolation between two numeric values. */
+export declare function interpolateNumber(from: number, to: number, t: number): number;
+/** Linear interpolation between two RGB colors. */
+export declare function interpolateRgb(from: Rgb24, to: Rgb24, t: number): Rgb24;
+/** Generate `steps` RGB samples between two colors (inclusive endpoints). */
+export declare function interpolateRgbArray(from: Rgb24, to: Rgb24, steps: number): readonly Rgb24[];
+//# sourceMappingURL=interpolate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../src/animation/interpolate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAyB,MAAM,qBAAqB,CAAC;AAExE,kCAAkC;AAClC,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAI9F;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7E;AASD,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAMvE;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,EAAE,CAS3F"}

package/dist/animation/interpolate.js

@@ -0,0 +1,53 @@
+/**
+ * packages/core/src/animation/interpolate.ts — Primitive interpolation helpers.
+ */
+import { rgb, rgbB, rgbG, rgbR } from "../widgets/style.js";
+/** Clamp a number into [0, 1]. */
+export function clamp01(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    if (value <= 0)
+        return 0;
+    if (value >= 1)
+        return 1;
+    return value;
+}
+/** Clamp an animation duration to a safe, non-negative integer in milliseconds. */
+export function normalizeDurationMs(durationMs, fallbackMs) {
+    if (durationMs === undefined)
+        return fallbackMs;
+    if (!Number.isFinite(durationMs))
+        return fallbackMs;
+    return Math.max(0, Math.trunc(durationMs));
+}
+/** Linear interpolation between two numeric values. */
+export function interpolateNumber(from, to, t) {
+    return from + (to - from) * clamp01(t);
+}
+function clampRgbChannel(channel) {
+    if (!Number.isFinite(channel))
+        return 0;
+    if (channel <= 0)
+        return 0;
+    if (channel >= 255)
+        return 255;
+    return Math.round(channel);
+}
+/** Linear interpolation between two RGB colors. */
+export function interpolateRgb(from, to, t) {
+    return rgb(clampRgbChannel(interpolateNumber(rgbR(from), rgbR(to), t)), clampRgbChannel(interpolateNumber(rgbG(from), rgbG(to), t)), clampRgbChannel(interpolateNumber(rgbB(from), rgbB(to), t)));
+}
+/** Generate `steps` RGB samples between two colors (inclusive endpoints). */
+export function interpolateRgbArray(from, to, steps) {
+    const count = Math.max(0, Math.trunc(steps));
+    if (count <= 0)
+        return Object.freeze([]);
+    if (count === 1)
+        return Object.freeze([interpolateRgb(from, to, 0)]);
+    const samples = new Array(count);
+    for (let i = 0; i < count; i++) {
+        samples[i] = interpolateRgb(from, to, i / (count - 1));
+    }
+    return Object.freeze(samples);
+}
+//# sourceMappingURL=interpolate.js.map

package/dist/animation/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../../src/animation/interpolate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAc,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAExE,kCAAkC;AAClC,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACzB,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACzB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,UAA8B,EAAE,UAAkB;IACpF,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,EAAU,EAAE,CAAS;IACnE,OAAO,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IACxC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,IAAI,OAAO,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAAC,IAAW,EAAE,EAAS,EAAE,CAAS;IAC9D,OAAO,GAAG,CACR,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAC3D,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAC3D,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB,CAAC,IAAW,EAAE,EAAS,EAAE,KAAa;IACvE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,OAAO,GAAY,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,OAAO,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/animation/spring.d.ts

@@ -0,0 +1,18 @@
+/**
+ * packages/core/src/animation/spring.ts — Spring simulation utilities.
+ */
+import type { NormalizedSpringConfig, SpringConfig } from "./types.js";
+export type { NormalizedSpringConfig };
+export type SpringState = Readonly<{
+    value: number;
+    velocity: number;
+}>;
+export type SpringStepResult = Readonly<{
+    value: number;
+    velocity: number;
+    done: boolean;
+}>;
+export declare function normalizeSpringConfig(config: SpringConfig | undefined): NormalizedSpringConfig;
+export declare function isSpringAtRest(value: number, target: number, velocity: number, config: NormalizedSpringConfig): boolean;
+export declare function stepSpring(state: SpringState, target: number, dtSeconds: number, config: NormalizedSpringConfig): SpringStepResult;
+//# sourceMappingURL=spring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../../src/animation/spring.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvE,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC,CAAC;AAWH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,sBAAsB,CAmC9F;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAET;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,sBAAsB,GAC7B,gBAAgB,CA4ClB"}

package/dist/animation/spring.js

@@ -0,0 +1,84 @@
+/**
+ * packages/core/src/animation/spring.ts — Spring simulation utilities.
+ */
+const DEFAULT_SPRING_CONFIG = Object.freeze({
+    stiffness: 170,
+    damping: 26,
+    mass: 1,
+    restDelta: 0.001,
+    restSpeed: 0.001,
+    maxDeltaMs: 32,
+});
+export function normalizeSpringConfig(config) {
+    if (!config)
+        return DEFAULT_SPRING_CONFIG;
+    const stiffness = typeof config.stiffness === "number" && Number.isFinite(config.stiffness)
+        ? Math.max(0, config.stiffness)
+        : DEFAULT_SPRING_CONFIG.stiffness;
+    const damping = typeof config.damping === "number" && Number.isFinite(config.damping)
+        ? Math.max(0, config.damping)
+        : DEFAULT_SPRING_CONFIG.damping;
+    const mass = typeof config.mass === "number" && Number.isFinite(config.mass)
+        ? Math.max(0.0001, config.mass)
+        : DEFAULT_SPRING_CONFIG.mass;
+    const restDelta = typeof config.restDelta === "number" && Number.isFinite(config.restDelta)
+        ? Math.max(0, config.restDelta)
+        : DEFAULT_SPRING_CONFIG.restDelta;
+    const restSpeed = typeof config.restSpeed === "number" && Number.isFinite(config.restSpeed)
+        ? Math.max(0, config.restSpeed)
+        : DEFAULT_SPRING_CONFIG.restSpeed;
+    const maxDeltaMs = typeof config.maxDeltaMs === "number" && Number.isFinite(config.maxDeltaMs)
+        ? Math.max(1, Math.trunc(config.maxDeltaMs))
+        : DEFAULT_SPRING_CONFIG.maxDeltaMs;
+    return Object.freeze({
+        stiffness,
+        damping,
+        mass,
+        restDelta,
+        restSpeed,
+        maxDeltaMs,
+    });
+}
+export function isSpringAtRest(value, target, velocity, config) {
+    return Math.abs(velocity) <= config.restSpeed && Math.abs(target - value) <= config.restDelta;
+}
+export function stepSpring(state, target, dtSeconds, config) {
+    if (!Number.isFinite(state.value) ||
+        !Number.isFinite(state.velocity) ||
+        !Number.isFinite(target) ||
+        !Number.isFinite(dtSeconds) ||
+        dtSeconds <= 0) {
+        return Object.freeze({
+            value: target,
+            velocity: 0,
+            done: true,
+        });
+    }
+    if (config.stiffness <= 0 || config.mass <= 0) {
+        return Object.freeze({
+            value: target,
+            velocity: 0,
+            done: true,
+        });
+    }
+    const displacement = state.value - target;
+    const springForce = -config.stiffness * displacement;
+    const dampingForce = -config.damping * state.velocity;
+    const acceleration = (springForce + dampingForce) / config.mass;
+    const nextVelocity = state.velocity + acceleration * dtSeconds;
+    const nextValue = state.value + nextVelocity * dtSeconds;
+    const done = isSpringAtRest(nextValue, target, nextVelocity, config);
+    if (done) {
+        return Object.freeze({
+            value: target,
+            velocity: 0,
+            done: true,
+        });
+    }
+    return Object.freeze({
+        value: nextValue,
+        velocity: nextVelocity,
+        done: false,
+    });
+}
+//# sourceMappingURL=spring.js.map

package/dist/animation/spring.js.map

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

package/dist/animation/timeline.d.ts

@@ -0,0 +1,27 @@
+/**
+ * packages/core/src/animation/timeline.ts — Sequence timeline helpers.
+ */
+import type { EasingFunction, EasingInput, SequenceKeyframe } from "./types.js";
+type SequenceSegment = Readonly<{
+    from: number;
+    to: number;
+    durationMs: number;
+    easing: EasingFunction;
+}>;
+export type NormalizedSequence = Readonly<{
+    initialValue: number;
+    finalValue: number;
+    segments: readonly SequenceSegment[];
+    totalDurationMs: number;
+}>;
+export type SequenceSample = Readonly<{
+    value: number;
+    done: boolean;
+}>;
+export declare function normalizeSequence(keyframes: readonly SequenceKeyframe[], defaults?: Readonly<{
+    duration?: number;
+    easing?: EasingInput;
+}>): NormalizedSequence;
+export declare function sampleSequence(sequence: NormalizedSequence, elapsedMs: number, loop: boolean): SequenceSample;
+export {};
+//# sourceMappingURL=timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/animation/timeline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhF,KAAK,eAAe,GAAG,QAAQ,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf,CAAC,CAAC;AAgBH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,QAAQ,GAAE,QAAQ,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAM,GACnE,kBAAkB,CA4CpB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,GACZ,cAAc,CAsChB"}

package/dist/animation/timeline.js

@@ -0,0 +1,88 @@
+/**
+ * packages/core/src/animation/timeline.ts — Sequence timeline helpers.
+ */
+import { resolveEasing } from "./easing.js";
+import { clamp01, interpolateNumber, normalizeDurationMs } from "./interpolate.js";
+const DEFAULT_SEQUENCE_SEGMENT_DURATION_MS = 160;
+function readKeyframeValue(frame) {
+    return typeof frame === "number" ? frame : frame.value;
+}
+function readKeyframeDuration(frame) {
+    return typeof frame === "number" ? undefined : frame.duration;
+}
+function readKeyframeEasing(frame) {
+    return typeof frame === "number" ? undefined : frame.easing;
+}
+export function normalizeSequence(keyframes, defaults = {}) {
+    if (keyframes.length === 0) {
+        return Object.freeze({
+            initialValue: 0,
+            finalValue: 0,
+            segments: Object.freeze([]),
+            totalDurationMs: 0,
+        });
+    }
+    const values = [];
+    for (const frame of keyframes) {
+        values.push(readKeyframeValue(frame));
+    }
+    const segments = [];
+    let totalDurationMs = 0;
+    const fallbackDurationMs = normalizeDurationMs(defaults.duration, DEFAULT_SEQUENCE_SEGMENT_DURATION_MS);
+    for (let i = 0; i < keyframes.length - 1; i++) {
+        const frame = keyframes[i];
+        if (frame === undefined)
+            continue;
+        const durationMs = normalizeDurationMs(readKeyframeDuration(frame), fallbackDurationMs);
+        const easingInput = readKeyframeEasing(frame) ?? defaults.easing;
+        segments.push(Object.freeze({
+            from: values[i] ?? 0,
+            to: values[i + 1] ?? 0,
+            durationMs,
+            easing: resolveEasing(easingInput),
+        }));
+        totalDurationMs += durationMs;
+    }
+    return Object.freeze({
+        initialValue: values[0] ?? 0,
+        finalValue: values[values.length - 1] ?? 0,
+        segments: Object.freeze(segments),
+        totalDurationMs,
+    });
+}
+export function sampleSequence(sequence, elapsedMs, loop) {
+    if (!Number.isFinite(elapsedMs) || sequence.segments.length === 0) {
+        return Object.freeze({
+            value: sequence.initialValue,
+            done: true,
+        });
+    }
+    const total = sequence.totalDurationMs;
+    if (total <= 0) {
+        return Object.freeze({
+            value: sequence.finalValue,
+            done: true,
+        });
+    }
+    const normalizedElapsedMs = loop ? ((elapsedMs % total) + total) % total : Math.max(0, elapsedMs);
+    let cursor = 0;
+    for (let i = 0; i < sequence.segments.length; i++) {
+        const seg = sequence.segments[i];
+        if (!seg)
+            continue;
+        const segEnd = cursor + seg.durationMs;
+        if (normalizedElapsedMs <= segEnd || i === sequence.segments.length - 1) {
+            const localT = seg.durationMs <= 0 ? 1 : clamp01((normalizedElapsedMs - cursor) / seg.durationMs);
+            return Object.freeze({
+                value: interpolateNumber(seg.from, seg.to, seg.easing(localT)),
+                done: !loop && elapsedMs >= total,
+            });
+        }
+        cursor = segEnd;
+    }
+    return Object.freeze({
+        value: sequence.finalValue,
+        done: true,
+    });
+}
+//# sourceMappingURL=timeline.js.map

package/dist/animation/timeline.js.map

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

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/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"}