@rezi-ui/core 0.1.0-alpha.3 → 0.1.0-alpha.30

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,16 @@
  * 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_V3 = 3;
+export declare const ZR_DRAWLIST_VERSION_V4 = 4;
+export declare const ZR_DRAWLIST_VERSION_V5 = 5;
 export declare const ZR_EVENT_BATCH_VERSION_V1 = 1;
 /**
  * Cursor shape values for SET_CURSOR command (v2+).

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,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,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"}

package/dist/abi.js

@@ -11,13 +11,16 @@
  * 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_V3 = 3;
+export const ZR_DRAWLIST_VERSION_V4 = 4;
+export const ZR_DRAWLIST_VERSION_V5 = 5;
 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,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,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"}

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;AAY1E,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc,CAM5E"}

package/dist/animation/easing.js

@@ -0,0 +1,23 @@
+/**
+ * packages/core/src/animation/easing.ts — Easing curve helpers.
+ */
+import { clamp01 } from "./interpolate.js";
+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),
+});
+/** 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":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,MAAM,cAAc,GAAiD,MAAM,CAAC,MAAM,CAAC;IACjF,MAAM,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC;IACxC,WAAW,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,aAAa,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvF,WAAW,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7C,YAAY,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IACrD,cAAc,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CAC7F,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC1D,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,CAAS,EAAU,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,OAAO,cAAc,CAAC,MAAM,CAAC;IACzC,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC;AACxD,CAAC"}

package/dist/animation/interpolate.d.ts

@@ -0,0 +1,10 @@
+/**
+ * packages/core/src/animation/interpolate.ts — Primitive interpolation helpers.
+ */
+/** 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;
+//# 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,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"}

package/dist/animation/interpolate.js

@@ -0,0 +1,26 @@
+/**
+ * packages/core/src/animation/interpolate.ts — Primitive interpolation helpers.
+ */
+/** 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);
+}
+//# 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,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"}

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,CAwChB"}

package/dist/animation/timeline.js

@@ -0,0 +1,90 @@
+/**
+ * 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
+        ? ((Math.max(0, 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,71 @@
+/**
+ * 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";
+/** Easing value accepted by transition APIs. */
+export type EasingInput = EasingName | EasingFunction;
+/** Time-based interpolation configuration. */
+export type TransitionConfig = Readonly<{
+    /** Transition duration in milliseconds. */
+    duration?: number;
+    /** Easing curve name or custom easing function. */
+    easing?: EasingInput;
+}>;
+/** Spring simulation configuration. */
+export type SpringConfig = Readonly<{
+    /** 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;
+}>;
+/** 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;
+    /** Loop sequence timeline when it reaches the end. */
+    loop?: boolean;
+}>;
+/** 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;
+}>;
+//# 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":"AAAA;;;;;GAKG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnD,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,YAAY,GACZ,aAAa,GACb,eAAe,GACf,aAAa,GACb,cAAc,GACd,gBAAgB,CAAC;AAErB,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;AAEtD,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC,CAAC;AAEH,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,QAAQ,CAAC;IACP,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC,CAAC;AAEP,uCAAuC;AACvC,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AAEH,8CAA8C;AAC9C,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC,CAAC"}

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.d.ts

@@ -23,6 +23,8 @@
  */
 import { type RuntimeBackend } from "../backend.js";
 import type { App, AppConfig, AppLayoutSnapshot, AppRenderMetrics } from "../index.js";
+import { type ResponsiveBreakpointThresholds } from "../layout/responsive.js";
+import type { RouteDefinition } from "../router/types.js";
 import type { Theme } from "../theme/theme.js";
 import type { ThemeDefinition } from "../theme/tokens.js";
 /** Resolved configuration with defaults applied. */
@@ -30,6 +32,8 @@ type ResolvedAppConfig = Readonly<{
     fpsCap: number;
     maxEventBytes: number;
     maxDrawlistBytes: number;
+    rootPadding: number;
+    breakpointThresholds: ResponsiveBreakpointThresholds;
     useV2Cursor: boolean;
     drawlistValidateParams: boolean;
     drawlistReuseOutputBuffer: boolean;
@@ -38,8 +42,27 @@ type ResolvedAppConfig = Readonly<{
     internal_onRender?: ((metrics: AppRenderMetrics) => void) | undefined;
     internal_onLayout?: ((snapshot: AppLayoutSnapshot) => void) | undefined;
 }>;
+export declare const APP_INTERNAL_REQUEST_VIEW_LAYOUT_MARKER = "__reziRequestViewLayout";
+export declare const APP_INTERNAL_SET_RUNTIME_BREADCRUMB_HOOKS_MARKER = "__reziSetRuntimeBreadcrumbHooks";
 /** Apply defaults to user-provided config, validating all values. */
 export declare function resolveAppConfig(config: AppConfig | undefined): ResolvedAppConfig;
+type CreateAppBaseOptions = Readonly<{
+    backend: RuntimeBackend;
+    config?: AppConfig;
+    theme?: 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;
+}>;
 /**
  * Create a Rezi application instance.
  *
@@ -60,11 +83,7 @@ export declare function resolveAppConfig(config: AppConfig | undefined): Resolve
  * await app.start();
  * ```
  */
-export declare function createApp<S>(opts: Readonly<{
-    backend: RuntimeBackend;
-    initialState: S;
-    config?: AppConfig;
-    theme?: Theme | ThemeDefinition;
-}>): App<S>;
+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

@@ -1 +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;AAEvB,OAAO,KAAK,EACV,GAAG,EACH,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAIjB,MAAM,aAAa,CAAC;AAoBrB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAW1D,oDAAoD;AACpD,KAAK,iBAAiB,GAAG,QAAQ,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,sBAAsB,EAAE,OAAO,CAAC;IAChC,yBAAyB,EAAE,OAAO,CAAC;IACnC,6BAA6B,EAAE,MAAM,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,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;AAqDH,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,CAmDjF;AAoDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,IAAI,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,CAAC,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,GAAG,eAAe,CAAC;CACjC,CAAC,GACD,GAAG,CAAC,CAAC,CAAC,CAyzBR"}
+{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../../src/app/createApp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EACV,GAAG,EACH,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAKjB,MAAM,aAAa,CAAC;AAmBrB,OAAO,EACL,KAAK,8BAA8B,EAEpC,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQ1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAsB1D,oDAAoD;AACpD,KAAK,iBAAiB,GAAG,QAAQ,CAAC;IAChC,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,WAAW,EAAE,OAAO,CAAC;IACrB,sBAAsB,EAAE,OAAO,CAAC;IAChC,yBAAyB,EAAE,OAAO,CAAC;IACnC,6BAA6B,EAAE,MAAM,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,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;AA0BH,eAAO,MAAM,uCAAuC,4BAA4B,CAAC;AACjF,eAAO,MAAM,gDAAgD,oCAAoC,CAAC;AAuIlG,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,CA0DjF;AAuKD,KAAK,oBAAoB,GAAG,QAAQ,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,GAAG,eAAe,CAAC;CACjC,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;AAEL;;;;;;;;;;;;;;;;;;;GAmBG;AACH,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"}