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

package/dist/index.d.ts

@@ -281,6 +281,24 @@ interface TimelineBuilder {
     mode?: 'add' | 'sync';
     timeScale?: number;
   }): TimelineBuilder;
+  /**
+   * Build-time sugar: chain N 0-relative sub-timelines end-to-end. Each sub is
+   * `add()`ed at the running chain end (`prevEnd`); a scalar `gap` inserts slack
+   * between consecutive subs. Because `add()` advances the cursor by each sub's
+   * compiled duration, changing one sub's internal duration auto-shifts the
+   * rest. Emits ordinary ChildEntry rows — byte-identical to a hand-written
+   * `add(a); add(b, '+=gap'); add(c, '+=gap')` chain. (Negative `gap` overlaps
+   * arithmetically; it does NOT synthesize crossfades.)
+   */
+  sequence(subs: Timeline[], opts?: {
+    gap?: number;
+  }): TimelineBuilder;
+  /**
+   * Build-time sugar: place a 0-relative sub-timeline at an absolute parent time
+   * — `at(time, sub)` is exactly `add(sub, time)` (a numeric Position resolves to
+   * itself). The `at` here is a builder method, distinct from `TweenOpts.at`.
+   */
+  at(time: number, sub: Timeline): TimelineBuilder;
   /** Compiles to a marker; the callback is Player-registered, never serialized (§4.2). */
   call(fn: () => void, at?: Position): TimelineBuilder;
   /**

package/dist/index.js

@@ -705,11 +705,21 @@ function buildTimeline(build, init = {}) {
 			};
 			if (opts.timeScale !== void 0) entry.timeScale = opts.timeScale;
 			children.push(entry);
+			for (const [name, fn] of getTimelineCallbacks(child)) if (!callbacks.has(name)) callbacks.set(name, fn);
 			const scale = mode === "sync" ? opts.timeScale ?? 1 : 1;
 			prevStart = start;
 			prevEnd = start + compileTimeline(child).duration / scale;
 			return builder;
 		},
+		sequence(subs, opts = {}) {
+			const gap = opts.gap ?? 0;
+			const rel = gap < 0 ? `-=${-gap}` : `+=${gap}`;
+			for (let i = 0; i < subs.length; i++) builder.add(subs[i], i === 0 ? void 0 : rel);
+			return builder;
+		},
+		at(time, sub) {
+			return builder.add(sub, time);
+		},
 		call(fn, at) {
 			const t = at === void 0 ? prevEnd : resolvePosition(at);
 			const name = `call:${callCount++}`;

package/package.json

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