@glissade/core 0.10.0 → 0.10.1-pre.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as validateTrack, A as GainEnvelope, At as pathType, B as emitDevWarning, C as resolveTweenTarget, Ct as ValueTypeInferenceError, D as ChildEntry, Dt as getValueType, E as AudioClip, Et as colorType, F as TimelineValidationError, Ft as vec2Type, G as TrackValidationError, H as Key, I as audioOffsetSamples, J as resolveEaseDerivative, K as key, L as compileTimeline, M as Marker, Mt as stringType, N as Timeline, Nt as vec2ArcType, O as CompiledTimeline, Ot as inferValueType, P as TimelineInit, Pt as vec2Equals, Q as track, R as isDurationEditable, S as isEditableNodeId, St as ValueTypeId, T as AssetRef, Tt as booleanType, U as KeyOpts, V as setDevWarning, W as Track, X as springTo, Y as sampleTrack, Z as stagger, _ as setSidecarTrack, _t as HandoffKind, a as SidecarOrphan, at as springEasing, b as TweenTarget, bt as UnknownValueTypeError, c as SidecarVersionError, ct as DEFAULT_EASE, d as emptySidecar, dt as UnknownEasingError, et as velocityAt, f as hashKeys, ft as cubicBezier, g as normalizeEditedKeys, gt as namedEasing, h as migrateSidecar, ht as easings, i as SidecarDocV1, it as spring, j as Json, jt as registerValueType, k as FontFaceRef, kt as numberType, l as assignKeyIds, lt as EaseSpec, m as mergeSidecarDetailed, mt as easingDerivatives, n as OrphanReason, nt as SpringConfig, o as SidecarTimelineEntry, ot as springEasingDerivative, p as mergeSidecar, pt as cubicBezierDerivative, q as resolveEase, r as SidecarDoc, rt as SpringEase, s as SidecarTrackEntry, st as springPresets, t as MergeResult, tt as RetargetSpring, u as deleteSidecarTrack, ut as EasingFn, v as TARGET_PATH, vt as PathContour, w as targetNodeId, wt as Vec2, x as UnresolvableTargetError, xt as ValueType, y as TargetCarrier, yt as PathValue, z as DevWarning } from "./sidecar.js";
+import { $ as validateTrack, A as GainEnvelope, At as getValueType, B as emitDevWarning, C as resolveTweenTarget, Ct as UnknownValueTypeError, D as ChildEntry, Dt as Vec2, E as AudioClip, Et as ValueTypeInferenceError, F as TimelineValidationError, Ft as registerValueType, G as TrackValidationError, H as Key, I as audioOffsetSamples, It as stringType, J as resolveEaseDerivative, K as key, L as compileTimeline, Lt as vec2ArcType, M as Marker, Mt as numberType, N as Timeline, Nt as paintType, O as CompiledTimeline, Ot as booleanType, P as TimelineInit, Pt as pathType, Q as track, R as isDurationEditable, Rt as vec2Equals, S as isEditableNodeId, St as PathValue, T as AssetRef, Tt as ValueTypeId, U as KeyOpts, V as setDevWarning, W as Track, X as springTo, Y as sampleTrack, Z as stagger, _ as setSidecarTrack, _t as ColorStop, a as SidecarOrphan, at as springEasing, b as TweenTarget, bt as Paint, c as SidecarVersionError, ct as DEFAULT_EASE, d as emptySidecar, dt as UnknownEasingError, et as velocityAt, f as hashKeys, ft as cubicBezier, g as normalizeEditedKeys, gt as namedEasing, h as migrateSidecar, ht as easings, i as SidecarDocV1, it as spring, j as Json, jt as inferValueType, k as FontFaceRef, kt as colorType, l as assignKeyIds, lt as EaseSpec, m as mergeSidecarDetailed, mt as easingDerivatives, n as OrphanReason, nt as SpringConfig, o as SidecarTimelineEntry, ot as springEasingDerivative, p as mergeSidecar, pt as cubicBezierDerivative, q as resolveEase, r as SidecarDoc, rt as SpringEase, s as SidecarTrackEntry, st as springPresets, t as MergeResult, tt as RetargetSpring, u as deleteSidecarTrack, ut as EasingFn, v as TARGET_PATH, vt as GradientInterpolation, w as targetNodeId, wt as ValueType, x as UnresolvableTargetError, xt as PathContour, y as TargetCarrier, yt as HandoffKind, z as DevWarning, zt as vec2Type } from "./sidecar.js";
 
 //#region src/signal.d.ts
 
@@ -357,4 +357,4 @@ interface CheckpointedSim {
 }
 declare function bakeCheckpointed<W, S = W>(cfg: CheckpointedBakeConfig<W, S>): CheckpointedSim;
 //#endregion
-export { type AssetRef, type AudioClip, type BakeConfig, BakeError, type BindTarget, type BindableSignal, type BoundTimeline, type CheckpointedBakeConfig, type CheckpointedSim, type ChildEntry, CircularDependencyError, ColorParseError, type CompiledTimeline, type CoverageReport, type CurveSampler, DEFAULT_EASE, type DevWarning, type EaseSpec, type EasingFn, type Equals, type FontFaceRef, type FontMode, type FontRegistry, type FontUsage, FontValidationError, type GainEnvelope, type HandoffKind, type Json, type Key, type KeyOpts, type Marker, type MergeResult, type MissingGlyphs, type OkLab, type OrphanReason, type PathContour, type PathValue, type Playhead, type Position, PositionError, type ReadonlySignal, type ResolvedFace, type RetargetSpring, type Rgba, type Rng, type Scheduler, type SidecarDoc, type SidecarDocV1, type SidecarOrphan, type SidecarTimelineEntry, type SidecarTrackEntry, SidecarVersionError, type Signal, type SignalOptions, type SpringConfig, type SpringEase, TARGET_PATH, type TargetCarrier, type Timeline, type TimelineBuilder, type TimelineInit, TimelineValidationError, type Track, TrackValidationError, type TweenOpts, type TweenTarget, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, type ValidateFontsOptions, type ValueType, type ValueTypeId, ValueTypeInferenceError, type Vec2, type Vec2Signal, WriteDuringEvaluationError, assignKeyIds, audioOffsetSamples, bake, bakeCheckpointed, batch, beginReadPhase, bindTimeline, booleanType, buildFontRegistry, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, deleteSidecarTrack, easingDerivatives, easings, emitDevWarning, emptySidecar, endReadPhase, evaluateAt, formatColor, getTimelineCallbacks, getValueType, hashKeys, inReadPhase, inferValueType, isDurationEditable, isEditableNodeId, isExemptFamily, key, lerpColor, mergeSidecar, mergeSidecarDetailed, migrateSidecar, namedEasing, normalizeEditedKeys, numberType, oklabToRgba, parseCmap, parseColor, pathType, random, registerValueType, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, setScheduler, setSidecarTrack, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, synchronousScheduler, targetNodeId, timeline, track, untracked, validateFonts, validateTrack, vec2ArcType, vec2Equals, vec2Signal, vec2Type, velocityAt };
+export { type AssetRef, type AudioClip, type BakeConfig, BakeError, type BindTarget, type BindableSignal, type BoundTimeline, type CheckpointedBakeConfig, type CheckpointedSim, type ChildEntry, CircularDependencyError, ColorParseError, type ColorStop, type CompiledTimeline, type CoverageReport, type CurveSampler, DEFAULT_EASE, type DevWarning, type EaseSpec, type EasingFn, type Equals, type FontFaceRef, type FontMode, type FontRegistry, type FontUsage, FontValidationError, type GainEnvelope, type GradientInterpolation, type HandoffKind, type Json, type Key, type KeyOpts, type Marker, type MergeResult, type MissingGlyphs, type OkLab, type OrphanReason, type Paint, type PathContour, type PathValue, type Playhead, type Position, PositionError, type ReadonlySignal, type ResolvedFace, type RetargetSpring, type Rgba, type Rng, type Scheduler, type SidecarDoc, type SidecarDocV1, type SidecarOrphan, type SidecarTimelineEntry, type SidecarTrackEntry, SidecarVersionError, type Signal, type SignalOptions, type SpringConfig, type SpringEase, TARGET_PATH, type TargetCarrier, type Timeline, type TimelineBuilder, type TimelineInit, TimelineValidationError, type Track, TrackValidationError, type TweenOpts, type TweenTarget, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, type ValidateFontsOptions, type ValueType, type ValueTypeId, ValueTypeInferenceError, type Vec2, type Vec2Signal, WriteDuringEvaluationError, assignKeyIds, audioOffsetSamples, bake, bakeCheckpointed, batch, beginReadPhase, bindTimeline, booleanType, buildFontRegistry, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, deleteSidecarTrack, easingDerivatives, easings, emitDevWarning, emptySidecar, endReadPhase, evaluateAt, formatColor, getTimelineCallbacks, getValueType, hashKeys, inReadPhase, inferValueType, isDurationEditable, isEditableNodeId, isExemptFamily, key, lerpColor, mergeSidecar, mergeSidecarDetailed, migrateSidecar, namedEasing, normalizeEditedKeys, numberType, oklabToRgba, paintType, parseCmap, parseColor, pathType, random, registerValueType, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, setScheduler, setSidecarTrack, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, synchronousScheduler, targetNodeId, timeline, track, untracked, validateFonts, validateTrack, vec2ArcType, vec2Equals, vec2Signal, vec2Type, velocityAt };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as vec2Equals, A as velocityAt, B as easings, C as resolveEase, D as stagger, E as springTo, F as DEFAULT_EASE, G as colorType, H as UnknownValueTypeError, I as UnknownEasingError, J as numberType, K as getValueType, L as cubicBezier, M as springEasing, N as springEasingDerivative, O as track, P as springPresets, Q as vec2ArcType, R as cubicBezierDerivative, S as key, T as sampleTrack, U as ValueTypeInferenceError, V as namedEasing, W as booleanType, X as registerValueType, Y as pathType, Z as stringType, _ as audioOffsetSamples, a as hashKeys, at as lerpColor, b as timeline$1, c as migrateSidecar, ct as rgbaToOklab, d as TARGET_PATH, et as vec2Type, f as UnresolvableTargetError, g as TimelineValidationError, h as targetNodeId, i as emptySidecar, it as formatColor, j as spring, k as validateTrack, l as normalizeEditedKeys, m as resolveTweenTarget, n as assignKeyIds, nt as setDevWarning, o as mergeSidecar, ot as oklabToRgba, p as isEditableNodeId, q as inferValueType, r as deleteSidecarTrack, rt as ColorParseError, s as mergeSidecarDetailed, st as parseColor, t as SidecarVersionError, tt as emitDevWarning, u as setSidecarTrack, v as compileTimeline, w as resolveEaseDerivative, x as TrackValidationError, y as isDurationEditable, z as easingDerivatives } from "./sidecar.js";
+import { $ as vec2ArcType, A as velocityAt, B as easings, C as resolveEase, D as stagger, E as springTo, F as DEFAULT_EASE, G as colorType, H as UnknownValueTypeError, I as UnknownEasingError, J as numberType, K as getValueType, L as cubicBezier, M as springEasing, N as springEasingDerivative, O as track, P as springPresets, Q as stringType, R as cubicBezierDerivative, S as key, T as sampleTrack, U as ValueTypeInferenceError, V as namedEasing, W as booleanType, X as pathType, Y as paintType, Z as registerValueType, _ as audioOffsetSamples, a as hashKeys, at as formatColor, b as timeline$1, c as migrateSidecar, ct as parseColor, d as TARGET_PATH, et as vec2Equals, f as UnresolvableTargetError, g as TimelineValidationError, h as targetNodeId, i as emptySidecar, it as ColorParseError, j as spring, k as validateTrack, l as normalizeEditedKeys, lt as rgbaToOklab, m as resolveTweenTarget, n as assignKeyIds, nt as emitDevWarning, o as mergeSidecar, ot as lerpColor, p as isEditableNodeId, q as inferValueType, r as deleteSidecarTrack, rt as setDevWarning, s as mergeSidecarDetailed, st as oklabToRgba, t as SidecarVersionError, tt as vec2Type, u as setSidecarTrack, v as compileTimeline, w as resolveEaseDerivative, x as TrackValidationError, y as isDurationEditable, z as easingDerivatives } from "./sidecar.js";
 //#region src/ticker.ts
 /** The default scheduler: flush synchronously, preserving pre-ticker timing. */
 const synchronousScheduler = (flush) => flush();
@@ -1083,4 +1083,4 @@ function bakeCheckpointed(cfg) {
 	};
 }
 //#endregion
-export { BakeError, CircularDependencyError, ColorParseError, DEFAULT_EASE, FontValidationError, PositionError, SidecarVersionError, TARGET_PATH, TimelineValidationError, TrackValidationError, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, ValueTypeInferenceError, WriteDuringEvaluationError, assignKeyIds, audioOffsetSamples, bake, bakeCheckpointed, batch, beginReadPhase, bindTimeline, booleanType, buildFontRegistry, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, deleteSidecarTrack, easingDerivatives, easings, emitDevWarning, emptySidecar, endReadPhase, evaluateAt, formatColor, getTimelineCallbacks, getValueType, hashKeys, inReadPhase, inferValueType, isDurationEditable, isEditableNodeId, isExemptFamily, key, lerpColor, mergeSidecar, mergeSidecarDetailed, migrateSidecar, namedEasing, normalizeEditedKeys, numberType, oklabToRgba, parseCmap, parseColor, pathType, random, registerValueType, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, setScheduler, setSidecarTrack, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, synchronousScheduler, targetNodeId, timeline, track, untracked, validateFonts, validateTrack, vec2ArcType, vec2Equals, vec2Signal, vec2Type, velocityAt };
+export { BakeError, CircularDependencyError, ColorParseError, DEFAULT_EASE, FontValidationError, PositionError, SidecarVersionError, TARGET_PATH, TimelineValidationError, TrackValidationError, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, ValueTypeInferenceError, WriteDuringEvaluationError, assignKeyIds, audioOffsetSamples, bake, bakeCheckpointed, batch, beginReadPhase, bindTimeline, booleanType, buildFontRegistry, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, deleteSidecarTrack, easingDerivatives, easings, emitDevWarning, emptySidecar, endReadPhase, evaluateAt, formatColor, getTimelineCallbacks, getValueType, hashKeys, inReadPhase, inferValueType, isDurationEditable, isEditableNodeId, isExemptFamily, key, lerpColor, mergeSidecar, mergeSidecarDetailed, migrateSidecar, namedEasing, normalizeEditedKeys, numberType, oklabToRgba, paintType, parseCmap, parseColor, pathType, random, registerValueType, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, setScheduler, setSidecarTrack, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, synchronousScheduler, targetNodeId, timeline, track, untracked, validateFonts, validateTrack, vec2ArcType, vec2Equals, vec2Signal, vec2Type, velocityAt };

package/dist/sidecar.d.ts

@@ -55,6 +55,49 @@ declare const booleanType: ValueType<boolean>;
  * topology, so no add/sub/scale — handoffs blend from the frozen value.
  */
 declare const pathType: ValueType<PathValue>;
+/** A gradient color stop: `offset` 0..1 along the gradient, `color` a CSS string. */
+interface ColorStop {
+  offset: number;
+  color: string;
+}
+/**
+ * How a gradient blends BETWEEN its stops: `linear` (the canvas-native ramp,
+ * the default — byte-identical to no mode), `smooth` (a smoothstep S-curve, no
+ * Mach-banding at stops), or `gaussian` (a soft gaussian shoulder — melts like
+ * a wide blur with 2-3 stops). `smooth`/`gaussian` densify + oklab-interpolate
+ * the stops at raster, so a soft-light fill reads as smooth as a blur, no filter.
+ */
+type GradientInterpolation = 'linear' | 'smooth' | 'gaussian';
+/**
+ * A fill/stroke paint (§2.2 animatable document value): a solid color, or a
+ * `linear`/`radial` gradient. Geometry (`from`/`to`, `center`/`radius`) is in
+ * the shape's LOCAL space; omit it to default to the filled path's bounds.
+ * Plain JSON — serializes with no hooks; animatable via `paintType`.
+ */
+type Paint = {
+  kind: 'color';
+  color: string;
+} | {
+  kind: 'linear';
+  stops: ColorStop[];
+  from?: [number, number];
+  to?: [number, number];
+  interpolation?: GradientInterpolation;
+} | {
+  kind: 'radial';
+  stops: ColorStop[];
+  center?: [number, number];
+  radius?: number;
+  interpolation?: GradientInterpolation;
+};
+/**
+ * Gradient paint morphing (§2.2): a solid color lifts to a uniform gradient to
+ * meet the other side, then matched-kind/matched-stop-count gradients lerp their
+ * stops (offset + oklab color) and geometry pairwise; a mismatched kind or stop
+ * count snaps (hold a, then b at t ≥ 1) with a one-time dev warning. Lerp-only —
+ * no offsets under mismatch — so handoffs blend from the frozen value.
+ */
+declare const paintType: ValueType<Paint>;
 declare class ValueTypeInferenceError extends Error {
   constructor(value: unknown);
 }
@@ -507,4 +550,4 @@ declare function mergeSidecar(code: Timeline, sidecar: SidecarDoc | SidecarDocV1
  */
 declare function normalizeEditedKeys(keys: Key[]): Key[];
 //#endregion
-export { validateTrack as $, GainEnvelope as A, pathType as At, emitDevWarning as B, resolveTweenTarget as C, ValueTypeInferenceError as Ct, ChildEntry as D, getValueType as Dt, AudioClip as E, colorType as Et, TimelineValidationError as F, vec2Type as Ft, TrackValidationError as G, Key as H, audioOffsetSamples as I, resolveEaseDerivative as J, key as K, compileTimeline as L, Marker as M, stringType as Mt, Timeline as N, vec2ArcType as Nt, CompiledTimeline as O, inferValueType as Ot, TimelineInit as P, vec2Equals as Pt, track as Q, isDurationEditable as R, isEditableNodeId as S, ValueTypeId as St, AssetRef as T, booleanType as Tt, KeyOpts as U, setDevWarning as V, Track as W, springTo as X, sampleTrack as Y, stagger as Z, setSidecarTrack as _, HandoffKind as _t, SidecarOrphan as a, springEasing as at, TweenTarget as b, UnknownValueTypeError as bt, SidecarVersionError as c, DEFAULT_EASE as ct, emptySidecar as d, UnknownEasingError as dt, velocityAt as et, hashKeys as f, cubicBezier as ft, normalizeEditedKeys as g, namedEasing as gt, migrateSidecar as h, easings as ht, SidecarDocV1 as i, spring as it, Json as j, registerValueType as jt, FontFaceRef as k, numberType as kt, assignKeyIds as l, EaseSpec as lt, mergeSidecarDetailed as m, easingDerivatives as mt, OrphanReason as n, SpringConfig as nt, SidecarTimelineEntry as o, springEasingDerivative as ot, mergeSidecar as p, cubicBezierDerivative as pt, resolveEase as q, SidecarDoc as r, SpringEase as rt, SidecarTrackEntry as s, springPresets as st, MergeResult as t, RetargetSpring as tt, deleteSidecarTrack as u, EasingFn as ut, TARGET_PATH as v, PathContour as vt, targetNodeId as w, Vec2 as wt, UnresolvableTargetError as x, ValueType as xt, TargetCarrier as y, PathValue as yt, DevWarning as z };
+export { validateTrack as $, GainEnvelope as A, getValueType as At, emitDevWarning as B, resolveTweenTarget as C, UnknownValueTypeError as Ct, ChildEntry as D, Vec2 as Dt, AudioClip as E, ValueTypeInferenceError as Et, TimelineValidationError as F, registerValueType as Ft, TrackValidationError as G, Key as H, audioOffsetSamples as I, stringType as It, resolveEaseDerivative as J, key as K, compileTimeline as L, vec2ArcType as Lt, Marker as M, numberType as Mt, Timeline as N, paintType as Nt, CompiledTimeline as O, booleanType as Ot, TimelineInit as P, pathType as Pt, track as Q, isDurationEditable as R, vec2Equals as Rt, isEditableNodeId as S, PathValue as St, AssetRef as T, ValueTypeId as Tt, KeyOpts as U, setDevWarning as V, Track as W, springTo as X, sampleTrack as Y, stagger as Z, setSidecarTrack as _, ColorStop as _t, SidecarOrphan as a, springEasing as at, TweenTarget as b, Paint as bt, SidecarVersionError as c, DEFAULT_EASE as ct, emptySidecar as d, UnknownEasingError as dt, velocityAt as et, hashKeys as f, cubicBezier as ft, normalizeEditedKeys as g, namedEasing as gt, migrateSidecar as h, easings as ht, SidecarDocV1 as i, spring as it, Json as j, inferValueType as jt, FontFaceRef as k, colorType as kt, assignKeyIds as l, EaseSpec as lt, mergeSidecarDetailed as m, easingDerivatives as mt, OrphanReason as n, SpringConfig as nt, SidecarTimelineEntry as o, springEasingDerivative as ot, mergeSidecar as p, cubicBezierDerivative as pt, resolveEase as q, SidecarDoc as r, SpringEase as rt, SidecarTrackEntry as s, springPresets as st, MergeResult as t, RetargetSpring as tt, deleteSidecarTrack as u, EasingFn as ut, TARGET_PATH as v, GradientInterpolation as vt, targetNodeId as w, ValueType as wt, UnresolvableTargetError as x, PathContour as xt, TargetCarrier as y, HandoffKind as yt, DevWarning as z, vec2Type as zt };

package/dist/sidecar.js

@@ -234,6 +234,93 @@ const pathType = {
 	},
 	defaultHandoff: "blend-from-frozen"
 };
+const lerpN = (a, b, t) => a + (b - a) * t;
+const lerpPt = (a, b, t) => [lerpN(a[0], b[0], t), lerpN(a[1], b[1], t)];
+/** Lift a solid color to a uniform gradient matching `shape` (every stop = color),
+* so a color↔gradient tween fades smoothly instead of snapping. */
+function liftColor(color, shape) {
+	const stops = shape.stops.map((s) => ({
+		offset: s.offset,
+		color
+	}));
+	const interp = shape.interpolation ? { interpolation: shape.interpolation } : {};
+	return shape.kind === "radial" ? {
+		kind: "radial",
+		stops,
+		...shape.center ? { center: shape.center } : {},
+		...shape.radius !== void 0 ? { radius: shape.radius } : {},
+		...interp
+	} : {
+		kind: "linear",
+		stops,
+		...shape.from ? { from: shape.from } : {},
+		...shape.to ? { to: shape.to } : {},
+		...interp
+	};
+}
+let warnedPaintShape = false;
+function paintSnap(t, a, b) {
+	if (!warnedPaintShape) {
+		warnedPaintShape = true;
+		emitDevWarning("paint lerp across mismatched gradient shapes (different kind or stop count): snapping instead of interpolating — match the kind + stop count on both keyframes (§2.2)");
+	}
+	return t >= 1 ? b : a;
+}
+const stopsEqual = (a, b) => a.length === b.length && a.every((s, i) => s.offset === b[i].offset && s.color === b[i].color);
+/**
+* Gradient paint morphing (§2.2): a solid color lifts to a uniform gradient to
+* meet the other side, then matched-kind/matched-stop-count gradients lerp their
+* stops (offset + oklab color) and geometry pairwise; a mismatched kind or stop
+* count snaps (hold a, then b at t ≥ 1) with a one-time dev warning. Lerp-only —
+* no offsets under mismatch — so handoffs blend from the frozen value.
+*/
+const paintType = {
+	id: "paint",
+	lerp: (a, b, t) => {
+		if (a.kind === "color" && b.kind === "color") return {
+			kind: "color",
+			color: lerpColor(a.color, b.color, t)
+		};
+		let A = a;
+		let B = b;
+		if (A.kind === "color" && B.kind !== "color") A = liftColor(A.color, B);
+		else if (B.kind === "color" && A.kind !== "color") B = liftColor(B.color, A);
+		if (A.kind === "color" || B.kind === "color" || A.kind !== B.kind || A.stops.length !== B.stops.length) return paintSnap(t, a, b);
+		const stops = A.stops.map((sa, i) => ({
+			offset: lerpN(sa.offset, B.stops[i].offset, t),
+			color: lerpColor(sa.color, B.stops[i].color, t)
+		}));
+		const interp = A.interpolation ? { interpolation: A.interpolation } : {};
+		if (A.kind === "radial" && B.kind === "radial") return {
+			kind: "radial",
+			stops,
+			...A.center && B.center ? { center: lerpPt(A.center, B.center, t) } : A.center ? { center: A.center } : {},
+			...A.radius !== void 0 && B.radius !== void 0 ? { radius: lerpN(A.radius, B.radius, t) } : A.radius !== void 0 ? { radius: A.radius } : {},
+			...interp
+		};
+		if (A.kind === "linear" && B.kind === "linear") return {
+			kind: "linear",
+			stops,
+			...A.from && B.from ? { from: lerpPt(A.from, B.from, t) } : A.from ? { from: A.from } : {},
+			...A.to && B.to ? { to: lerpPt(A.to, B.to, t) } : A.to ? { to: A.to } : {},
+			...interp
+		};
+		return paintSnap(t, a, b);
+	},
+	extrapolates: false,
+	equals: (a, b) => {
+		if (a === b) return true;
+		if (a.kind !== b.kind) return false;
+		if (a.kind === "color") return b.kind === "color" && a.color === b.color;
+		if (b.kind === "color") return false;
+		if (!stopsEqual(a.stops, b.stops)) return false;
+		if (a.interpolation !== b.interpolation) return false;
+		if (a.kind === "radial" && b.kind === "radial") return JSON.stringify(a.center) === JSON.stringify(b.center) && a.radius === b.radius;
+		if (a.kind === "linear" && b.kind === "linear") return JSON.stringify(a.from) === JSON.stringify(b.from) && JSON.stringify(a.to) === JSON.stringify(b.to);
+		return false;
+	},
+	defaultHandoff: "blend-from-frozen"
+};
 var ValueTypeInferenceError = class extends Error {
 	constructor(value) {
 		super(`cannot infer a value type for ${JSON.stringify(value)}; register a custom type`);
@@ -241,10 +328,12 @@ var ValueTypeInferenceError = class extends Error {
 	}
 };
 const isContour = (c) => typeof c === "object" && c !== null && typeof c.closed === "boolean" && Array.isArray(c.v) && Array.isArray(c.in) && Array.isArray(c.out);
+const isPaint = (v) => typeof v === "object" && v !== null && (v.kind === "color" || v.kind === "linear" || v.kind === "radial");
 /** Infer a registered type id from a sample value (builder + bake authoring surfaces). */
 function inferValueType(value) {
 	if (typeof value === "number") return "number";
 	if (typeof value === "boolean") return "boolean";
+	if (isPaint(value)) return "paint";
 	if (Array.isArray(value) && value.length === 2 && value.every((v) => typeof v === "number")) return "vec2";
 	if (Array.isArray(value) && value.length > 0 && value.every(isContour)) return "path";
 	if (typeof value === "string") try {
@@ -262,6 +351,7 @@ registerValueType(colorType);
 registerValueType(stringType);
 registerValueType(booleanType);
 registerValueType(pathType);
+registerValueType(paintType);
 //#endregion
 //#region src/easing.ts
 const c1 = 1.70158;
@@ -1266,4 +1356,4 @@ function normalizeEditedKeys(keys) {
 	return out;
 }
 //#endregion
-export { vec2Equals as $, velocityAt as A, easings as B, resolveEase as C, stagger as D, springTo as E, DEFAULT_EASE as F, colorType as G, UnknownValueTypeError as H, UnknownEasingError as I, numberType as J, getValueType as K, cubicBezier as L, springEasing as M, springEasingDerivative as N, track as O, springPresets as P, vec2ArcType as Q, cubicBezierDerivative as R, key as S, sampleTrack as T, ValueTypeInferenceError as U, namedEasing as V, booleanType as W, registerValueType as X, pathType as Y, stringType as Z, audioOffsetSamples as _, hashKeys as a, lerpColor as at, timeline as b, migrateSidecar as c, rgbaToOklab as ct, TARGET_PATH as d, vec2Type as et, UnresolvableTargetError as f, TimelineValidationError as g, targetNodeId as h, emptySidecar as i, formatColor as it, spring as j, validateTrack as k, normalizeEditedKeys as l, resolveTweenTarget as m, assignKeyIds as n, setDevWarning as nt, mergeSidecar as o, oklabToRgba as ot, isEditableNodeId as p, inferValueType as q, deleteSidecarTrack as r, ColorParseError as rt, mergeSidecarDetailed as s, parseColor as st, SidecarVersionError as t, emitDevWarning as tt, setSidecarTrack as u, compileTimeline as v, resolveEaseDerivative as w, TrackValidationError as x, isDurationEditable as y, easingDerivatives as z };
+export { vec2ArcType as $, velocityAt as A, easings as B, resolveEase as C, stagger as D, springTo as E, DEFAULT_EASE as F, colorType as G, UnknownValueTypeError as H, UnknownEasingError as I, numberType as J, getValueType as K, cubicBezier as L, springEasing as M, springEasingDerivative as N, track as O, springPresets as P, stringType as Q, cubicBezierDerivative as R, key as S, sampleTrack as T, ValueTypeInferenceError as U, namedEasing as V, booleanType as W, pathType as X, paintType as Y, registerValueType as Z, audioOffsetSamples as _, hashKeys as a, formatColor as at, timeline as b, migrateSidecar as c, parseColor as ct, TARGET_PATH as d, vec2Equals as et, UnresolvableTargetError as f, TimelineValidationError as g, targetNodeId as h, emptySidecar as i, ColorParseError as it, spring as j, validateTrack as k, normalizeEditedKeys as l, rgbaToOklab as lt, resolveTweenTarget as m, assignKeyIds as n, emitDevWarning as nt, mergeSidecar as o, lerpColor as ot, isEditableNodeId as p, inferValueType as q, deleteSidecarTrack as r, setDevWarning as rt, mergeSidecarDetailed as s, oklabToRgba as st, SidecarVersionError as t, vec2Type as tt, setSidecarTrack as u, compileTimeline as v, resolveEaseDerivative as w, TrackValidationError as x, isDurationEditable as y, easingDerivatives as z };

package/dist/studioHost.d.ts

@@ -1,4 +1,4 @@
-import { H as Key, N as Timeline, S as isEditableNodeId, St as ValueTypeId, a as SidecarOrphan, lt as EaseSpec, r as SidecarDoc, w as targetNodeId } from "./sidecar.js";
+import { H as Key, N as Timeline, S as isEditableNodeId, Tt as ValueTypeId, a as SidecarOrphan, lt as EaseSpec, r as SidecarDoc, w as targetNodeId } from "./sidecar.js";
 
 //#region src/timelinePatch.d.ts
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/core",
-  "version": "0.10.0",
+  "version": "0.10.1-pre.1",
   "description": "glissade core: signals, tracks, timeline document, evaluation, easing, springs, seeded RNG. Zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "type": "module",