@glissade/core 0.6.0-pre.0 → 0.6.0-pre.1

package/dist/index.d.ts

@@ -198,6 +198,37 @@ interface SpringFactory {
   retarget: typeof retarget;
 }
 declare const spring: SpringFactory;
+/**
+ * Named spring feels (react-spring conventions, mass 1) — a vocabulary instead
+ * of hand-tuned stiffness/damping. Use `spring(springPresets.wobbly)` or
+ * `springTo(t, a, b, springPresets.gentle)`.
+ */
+declare const springPresets: {
+  readonly default: {
+    readonly stiffness: 170;
+    readonly damping: 26;
+  };
+  readonly gentle: {
+    readonly stiffness: 120;
+    readonly damping: 14;
+  };
+  readonly wobbly: {
+    readonly stiffness: 180;
+    readonly damping: 12;
+  };
+  readonly stiff: {
+    readonly stiffness: 210;
+    readonly damping: 20;
+  };
+  readonly slow: {
+    readonly stiffness: 280;
+    readonly damping: 60;
+  };
+  readonly molasses: {
+    readonly stiffness: 280;
+    readonly damping: 120;
+  };
+};
 /**
  * The spring as a normalized easing over a segment whose length must equal
  * spring.duration(cfg) (validated at the document layer, §2.7).
@@ -273,6 +304,16 @@ declare function key<T>(t: number, value: T, easeOrOpts?: EaseSpec | KeyOpts<T>)
  *   track('x/width', 'number', [...springTo(beats.start('drop'), 0, 320, cfg)])
  */
 declare function springTo<T>(endT: number, from: T, to: T, cfg: SpringConfig): [Key<T>, Key<T>];
+/**
+ * Cascade a set of tracks by shifting each one's key times — the classic
+ * stagger for animating a list of nodes with a delay between them. `delay` is
+ * the per-index gap in seconds, or a function of the index for non-linear
+ * cascades. Pure: returns new tracks, leaving the inputs untouched.
+ *
+ *   stagger(items.map((it, i) => track(`${it.id}/opacity`, 'number',
+ *     [key(0, 0), key(0.3, 1, 'easeOutCubic')])), 0.08)
+ */
+declare function stagger<T>(tracks: readonly Track<T>[], delay: number | ((index: number) => number)): Track<T>[];
 declare function track<T>(target: string, type: ValueTypeId, keys: Key<T>[], opts?: {
   editable?: boolean;
 }): Track<T>;
@@ -554,4 +595,4 @@ declare function normalizeEditedKeys(keys: Key[]): Key[];
  */
 declare function mergeSidecar(code: Timeline, sidecar: SidecarDoc | null | undefined): Timeline;
 //#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 CurveSampler, DEFAULT_EASE, type DevWarning, type EaseSpec, type EasingFn, type Equals, type GainEnvelope, type HandoffKind, type Json, type Key, type KeyOpts, type Marker, type OkLab, type PathContour, type PathValue, type Playhead, type Position, PositionError, type ReadonlySignal, type RetargetSpring, type Rgba, type Rng, type SidecarDoc, 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 ValueType, type ValueTypeId, ValueTypeInferenceError, type Vec2, type Vec2Signal, WriteDuringEvaluationError, bake, bakeCheckpointed, beginReadPhase, bindTimeline, booleanType, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, easingDerivatives, easings, emitDevWarning, emptySidecar, endReadPhase, evaluateAt, formatColor, getTimelineCallbacks, getValueType, inReadPhase, inferValueType, key, lerpColor, mergeSidecar, namedEasing, normalizeEditedKeys, numberType, oklabToRgba, parseColor, pathType, random, registerValueType, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, signal, spring, springEasing, springEasingDerivative, springTo, stringType, timeline, track, untracked, validateTrack, 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 CompiledTimeline, type CurveSampler, DEFAULT_EASE, type DevWarning, type EaseSpec, type EasingFn, type Equals, type GainEnvelope, type HandoffKind, type Json, type Key, type KeyOpts, type Marker, type OkLab, type PathContour, type PathValue, type Playhead, type Position, PositionError, type ReadonlySignal, type RetargetSpring, type Rgba, type Rng, type SidecarDoc, 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 ValueType, type ValueTypeId, ValueTypeInferenceError, type Vec2, type Vec2Signal, WriteDuringEvaluationError, bake, bakeCheckpointed, beginReadPhase, bindTimeline, booleanType, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, easingDerivatives, easings, emitDevWarning, emptySidecar, endReadPhase, evaluateAt, formatColor, getTimelineCallbacks, getValueType, inReadPhase, inferValueType, key, lerpColor, mergeSidecar, namedEasing, normalizeEditedKeys, numberType, oklabToRgba, parseColor, pathType, random, registerValueType, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, timeline, track, untracked, validateTrack, vec2Equals, vec2Signal, vec2Type, velocityAt };

package/dist/index.js

@@ -803,6 +803,37 @@ const spring = Object.assign((cfg) => {
 	retarget
 });
 /**
+* Named spring feels (react-spring conventions, mass 1) — a vocabulary instead
+* of hand-tuned stiffness/damping. Use `spring(springPresets.wobbly)` or
+* `springTo(t, a, b, springPresets.gentle)`.
+*/
+const springPresets = {
+	default: {
+		stiffness: 170,
+		damping: 26
+	},
+	gentle: {
+		stiffness: 120,
+		damping: 14
+	},
+	wobbly: {
+		stiffness: 180,
+		damping: 12
+	},
+	stiff: {
+		stiffness: 210,
+		damping: 20
+	},
+	slow: {
+		stiffness: 280,
+		damping: 60
+	},
+	molasses: {
+		stiffness: 280,
+		damping: 120
+	}
+};
+/**
 * The spring as a normalized easing over a segment whose length must equal
 * spring.duration(cfg) (validated at the document layer, §2.7).
 */
@@ -876,6 +907,28 @@ function springTo(endT, from, to, cfg) {
 	if (endT - d < 0) throw new TrackValidationError("springTo", `this spring needs ${d.toFixed(3)}s to settle — endT must be ≥ its duration (got ${endT})`);
 	return [key(endT - d, from), key(endT, to, spring(cfg))];
 }
+/**
+* Cascade a set of tracks by shifting each one's key times — the classic
+* stagger for animating a list of nodes with a delay between them. `delay` is
+* the per-index gap in seconds, or a function of the index for non-linear
+* cascades. Pure: returns new tracks, leaving the inputs untouched.
+*
+*   stagger(items.map((it, i) => track(`${it.id}/opacity`, 'number',
+*     [key(0, 0), key(0.3, 1, 'easeOutCubic')])), 0.08)
+*/
+function stagger(tracks, delay) {
+	const at = typeof delay === "function" ? delay : (i) => i * delay;
+	return tracks.map((tr, i) => {
+		const d = at(i);
+		return {
+			...tr,
+			keys: tr.keys.map((k) => ({
+				...k,
+				t: k.t + d
+			}))
+		};
+	});
+}
 function track(target, type, keys, opts) {
 	const tr = {
 		target,
@@ -1621,4 +1674,4 @@ function mergeSidecar(code, sidecar) {
 	return merged;
 }
 //#endregion
-export { BakeError, CircularDependencyError, ColorParseError, DEFAULT_EASE, PositionError, SidecarVersionError, TARGET_PATH, TimelineValidationError, TrackValidationError, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, ValueTypeInferenceError, WriteDuringEvaluationError, bake, bakeCheckpointed, beginReadPhase, bindTimeline, booleanType, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, easingDerivatives, easings, emitDevWarning, emptySidecar, endReadPhase, evaluateAt, formatColor, getTimelineCallbacks, getValueType, inReadPhase, inferValueType, key, lerpColor, mergeSidecar, namedEasing, normalizeEditedKeys, numberType, oklabToRgba, parseColor, pathType, random, registerValueType, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, signal, spring, springEasing, springEasingDerivative, springTo, stringType, timeline, track, untracked, validateTrack, vec2Equals, vec2Signal, vec2Type, velocityAt };
+export { BakeError, CircularDependencyError, ColorParseError, DEFAULT_EASE, PositionError, SidecarVersionError, TARGET_PATH, TimelineValidationError, TrackValidationError, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, ValueTypeInferenceError, WriteDuringEvaluationError, bake, bakeCheckpointed, beginReadPhase, bindTimeline, booleanType, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, easingDerivatives, easings, emitDevWarning, emptySidecar, endReadPhase, evaluateAt, formatColor, getTimelineCallbacks, getValueType, inReadPhase, inferValueType, key, lerpColor, mergeSidecar, namedEasing, normalizeEditedKeys, numberType, oklabToRgba, parseColor, pathType, random, registerValueType, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, timeline, track, untracked, validateTrack, vec2Equals, vec2Signal, vec2Type, velocityAt };

package/package.json

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