@glissade/core 0.39.0 → 0.40.0-pre.0

package/dist/timeline.js

@@ -1,4 +1,4 @@
-import { B as emitDevWarning, H as spring, h as validateTrack } from "./targetRef.js";
+import { L as emitDevWarning, f as validateTrack, z as spring } from "./track.js";
 //#region src/timeline.ts
 /**
 * The Timeline document (DESIGN.md §2.3) — the serializable animation source

package/dist/track.d.ts

@@ -329,6 +329,14 @@ interface Track<T = unknown> {
   type: ValueTypeId;
   /** Sorted by t; enforced by validateTrack(). */
   keys: Key<T>[];
+  /**
+   * Expr (0.40): a serializable math-formula of the playhead `t`
+   * (e.g. `'100 + 50*sin(t*2)'`). When set, the track is sampled by evaluating the
+   * formula at `t` instead of interpolating `keys` (which may be empty). `type`
+   * must be 'number'. Compiled once + cached; a pure function of `t` (+ seeded
+   * `rand`), so the SAME time channel + determinism as keyframes.
+   */
+  expr?: string;
   /** Studio may own this track's keys via sidecar (§6.2). */
   editable?: boolean;
   /** Reserved (§2.2/§B.6): v2 additive blending. v1 accepts but ignores it (coalesce stays last-wins). */
@@ -389,6 +397,13 @@ declare function retime<T>(tracks: readonly Track<T>[], spec: RetimeSpec): Track
 declare function track<T>(target: string, type: ValueTypeId, keys: Key<T>[], opts?: {
   editable?: boolean;
 }): Track<T>;
+/**
+ * Expr (0.40): build a raw formula-driven numeric track — `{ target, type:
+ * 'number', keys: [], expr }`. The public `exprTrack()` (on `@glissade/core/expr`,
+ * which also registers the evaluator) wraps this + validates. Kept here (base) so
+ * `tl.expr` can emit a track without dragging the evaluator onto the embed.
+ */
+
 declare function resolveEase(spec: EaseSpec | undefined): EasingFn;
 /**
  * Analytic d(u) for an ease spec (§B.6). Custom-registered eases without a