@rezi-ui/core 0.1.0-alpha.24 → 0.1.0-alpha.26

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/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.map

@@ -1 +1 @@
-{"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;AAgIlG,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"}
+{"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"}

package/dist/app/createApp.js

@@ -122,6 +122,13 @@ function readBackendDrawlistVersionMarker(backend) {
     }
     return value;
 }
+function monotonicNowMs() {
+    const perf = globalThis.performance;
+    const perfNow = perf?.now;
+    if (typeof perfNow === "function")
+        return perfNow.call(perf);
+    return Date.now();
+}
 async function loadTerminalProfile(backend) {
     try {
         if (typeof backend.getTerminalProfile === "function") {
@@ -1109,6 +1116,7 @@ export function createApp(opts) {
         // First-frame/bootstrap safety is handled inside submitFrame(): it falls back
         // to full pipeline when committedRoot or layoutTree is null.
         const pendingDirtyFlags = dirtyFlags;
+        const frameNowMs = monotonicNowMs();
         const plan = {
             commit: (pendingDirtyFlags & DIRTY_VIEW) !== 0,
             layout: (pendingDirtyFlags & DIRTY_LAYOUT) !== 0,
@@ -1116,6 +1124,7 @@ export function createApp(opts) {
             // already explicitly dirty; otherwise interactive state updates can render a
             // newly-committed tree against stale layout nodes until the next resize.
             checkLayoutStability: (pendingDirtyFlags & DIRTY_LAYOUT) === 0 && (pendingDirtyFlags & DIRTY_VIEW) !== 0,
+            nowMs: frameNowMs,
         };
         const resilientView = (state) => {
             if (topLevelViewError !== null) {
@@ -1286,6 +1295,39 @@ export function createApp(opts) {
             mode = "widget";
             viewFn = fn;
         },
+        replaceView(fn) {
+            assertOperational("replaceView");
+            assertNotReentrant("replaceView");
+            if (routes !== undefined) {
+                throwCode("ZRUI_MODE_CONFLICT", "replaceView: routes are configured in createApp(); screen rendering is managed by router");
+            }
+            if (mode === "raw") {
+                throwCode("ZRUI_MODE_CONFLICT", "replaceView: draw mode already selected");
+            }
+            if (mode === null)
+                mode = "widget";
+            viewFn = fn;
+            topLevelViewError = null;
+            if (sm.state === "Running") {
+                markDirty(DIRTY_VIEW);
+            }
+        },
+        replaceRoutes(nextRoutes) {
+            assertOperational("replaceRoutes");
+            assertNotReentrant("replaceRoutes");
+            if (!routerIntegration || routes === undefined) {
+                throwCode("ZRUI_MODE_CONFLICT", "replaceRoutes: app was created without routes; use replaceView for view-mode apps");
+            }
+            if (mode === "raw") {
+                throwCode("ZRUI_MODE_CONFLICT", "replaceRoutes: draw mode already selected");
+            }
+            const nextRouteKeybindings = routerIntegration.replaceRoutes(nextRoutes);
+            app.keys(nextRouteKeybindings);
+            topLevelViewError = null;
+            if (sm.state === "Running") {
+                markDirty(DIRTY_VIEW);
+            }
+        },
         draw(fn) {
             assertOperational("draw");
             sm.assertOneOf(["Created", "Stopped"], "draw: must be Created or Stopped");