@slowclap/rezi-core 0.1.0-fork.1

package/README.md

@@ -0,0 +1,13 @@
+# @rezi-ui/core
+
+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://rezitui.dev/docs`

package/dist/abi.d.ts

@@ -0,0 +1,72 @@
+/**
+ * ABI constants and error types for Rezi.
+ * @see docs/protocol/abi.md
+ * @see docs/guide/lifecycle-and-updates.md
+ */
+/**
+ * Engine ABI version numbers.
+ * 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 = 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 = 1;
+export declare const ZR_EVENT_BATCH_VERSION_V1 = 1;
+/**
+ * Cursor shape values for SET_CURSOR command (v2+).
+ * These match the engine's zr_dl_cmd_set_cursor_t.shape field.
+ */
+export declare const ZR_CURSOR_SHAPE_BLOCK = 0;
+export declare const ZR_CURSOR_SHAPE_UNDERLINE = 1;
+export declare const ZR_CURSOR_SHAPE_BAR = 2;
+export type CursorShape = 0 | 1 | 2;
+/**
+ * Pinned Unicode version for deterministic width/grapheme behavior.
+ */
+export declare const ZR_UNICODE_VERSION_MAJOR = 15;
+export declare const ZR_UNICODE_VERSION_MINOR = 1;
+export declare const ZR_UNICODE_VERSION_PATCH = 0;
+/**
+ * Magic bytes for binary formats (little-endian u32).
+ */
+export declare const ZRDL_MAGIC = 1279545946;
+export declare const ZREV_MAGIC = 1447383642;
+/**
+ * Result codes returned by engine FFI functions.
+ * All engine functions return zr_result_t (int32).
+ */
+export declare enum ZrResult {
+    /** Operation completed successfully */
+    OK = 0,
+    /** NULL pointer, invalid enum, impossible value */
+    ERR_INVALID_ARGUMENT = -1,
+    /** Allocation failed */
+    ERR_OOM = -2,
+    /** Buffer too small, cap exceeded */
+    ERR_LIMIT = -3,
+    /** Unknown version, opcode, feature */
+    ERR_UNSUPPORTED = -4,
+    /** Malformed binary data */
+    ERR_FORMAT = -5,
+    /** OS/terminal call failed */
+    ERR_PLATFORM = -6
+}
+/**
+ * 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_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.
+ */
+export declare class ZrUiError extends Error {
+    readonly name = "ZrUiError";
+    readonly code: ZrUiErrorCode;
+    constructor(code: ZrUiErrorCode, message?: string);
+}
+//# sourceMappingURL=abi.d.ts.map

package/dist/abi.d.ts.map

@@ -0,0 +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,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

@@ -0,0 +1,86 @@
+/**
+ * ABI constants and error types for Rezi.
+ * @see docs/protocol/abi.md
+ * @see docs/guide/lifecycle-and-updates.md
+ */
+// =============================================================================
+// ABI Version Pins (from docs/protocol/abi.md)
+// =============================================================================
+/**
+ * Engine ABI version numbers.
+ * These must match the C engine's zr_version.h exactly.
+ */
+export const ZR_ENGINE_ABI_MAJOR = 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 = ZR_DRAWLIST_VERSION_V1;
+export const ZR_EVENT_BATCH_VERSION_V1 = 1;
+// =============================================================================
+// Cursor Shape Constants (from zr_drawlist.h SET_CURSOR)
+// =============================================================================
+/**
+ * Cursor shape values for SET_CURSOR command (v2+).
+ * These match the engine's zr_dl_cmd_set_cursor_t.shape field.
+ */
+export const ZR_CURSOR_SHAPE_BLOCK = 0;
+export const ZR_CURSOR_SHAPE_UNDERLINE = 1;
+export const ZR_CURSOR_SHAPE_BAR = 2;
+/**
+ * Pinned Unicode version for deterministic width/grapheme behavior.
+ */
+export const ZR_UNICODE_VERSION_MAJOR = 15;
+export const ZR_UNICODE_VERSION_MINOR = 1;
+export const ZR_UNICODE_VERSION_PATCH = 0;
+/**
+ * Magic bytes for binary formats (little-endian u32).
+ */
+export const ZRDL_MAGIC = 0x4c44525a; // 'ZRDL' as little-endian u32
+export const ZREV_MAGIC = 0x5645525a; // 'ZREV' as little-endian u32
+// =============================================================================
+// ZrResult Enum (from docs/protocol/abi.md)
+// =============================================================================
+/**
+ * Result codes returned by engine FFI functions.
+ * All engine functions return zr_result_t (int32).
+ */
+export var ZrResult;
+(function (ZrResult) {
+    /** Operation completed successfully */
+    ZrResult[ZrResult["OK"] = 0] = "OK";
+    /** NULL pointer, invalid enum, impossible value */
+    ZrResult[ZrResult["ERR_INVALID_ARGUMENT"] = -1] = "ERR_INVALID_ARGUMENT";
+    /** Allocation failed */
+    ZrResult[ZrResult["ERR_OOM"] = -2] = "ERR_OOM";
+    /** Buffer too small, cap exceeded */
+    ZrResult[ZrResult["ERR_LIMIT"] = -3] = "ERR_LIMIT";
+    /** Unknown version, opcode, feature */
+    ZrResult[ZrResult["ERR_UNSUPPORTED"] = -4] = "ERR_UNSUPPORTED";
+    /** Malformed binary data */
+    ZrResult[ZrResult["ERR_FORMAT"] = -5] = "ERR_FORMAT";
+    /** OS/terminal call failed */
+    ZrResult[ZrResult["ERR_PLATFORM"] = -6] = "ERR_PLATFORM";
+})(ZrResult || (ZrResult = {}));
+// =============================================================================
+// ZrUiError Class (from docs/guide/lifecycle-and-updates.md)
+// =============================================================================
+/**
+ * Error class for all deterministic runtime violations.
+ * The `code` property identifies the specific violation.
+ */
+export class ZrUiError extends Error {
+    name = "ZrUiError";
+    code;
+    constructor(code, message) {
+        super(message ?? code);
+        this.code = code;
+        // Maintain proper stack trace in V8 environments
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ZrUiError);
+        }
+    }
+}
+//# sourceMappingURL=abi.js.map

package/dist/abi.js.map

@@ -0,0 +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,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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"}