@glissade/core 0.23.0-pre.4 → 0.23.0

package/dist/index.d.ts

@@ -238,6 +238,14 @@ interface TweenOpts<T = unknown> {
   at?: Position;
   /** Explicit start value — sugar for fromTo; required ergonomics for string targets. */
   from?: T;
+  /**
+   * Explicit value type — the escape hatch for when `inferValueType(value)` can't
+   * tell what a value is (a structured map like `fontAxes`'s `{ wght: 700 }`, or a
+   * `number`-under-a-custom-id). Overrides inference for this target's whole track,
+   * e.g. `to('hero/fontAxes', { wght: 900 }, { type: 'fontAxes' })`. Two different
+   * explicit types on the same target throw (one track has one type).
+   */
+  type?: ValueTypeId;
 }
 /** The shared tween shape applied to every staggered target (§2.6 stagger sugar). */
 interface StaggerSpec<T = unknown> {
@@ -309,9 +317,11 @@ interface TimelineBuilder {
   tracks(tracks: Track[] | {
     tracks: Track[];
   }): TimelineBuilder;
-  /** Hold key: the value snaps at the resolved position (§2.6). */
+  /** Hold key: the value snaps at the resolved position (§2.6). `type` is the
+   *  value-type escape hatch (see {@link TweenOpts.type}). */
   set<T>(target: TweenTarget, value: T, opts?: {
     at?: Position;
+    type?: ValueTypeId;
   }): TimelineBuilder;
   label(name: string, at?: Position): TimelineBuilder;
   add(child: Timeline, at?: Position, opts?: {

package/dist/index.js

@@ -597,9 +597,10 @@ const TO_OPTS_KEYS = [
 	"duration",
 	"ease",
 	"at",
-	"from"
+	"from",
+	"type"
 ];
-const SET_OPTS_KEYS = ["at"];
+const SET_OPTS_KEYS = ["at", "type"];
 const STAGGER_SPEC_KEYS = [
 	"to",
 	"from",
@@ -666,6 +667,7 @@ function buildTimeline(build, init = {}) {
 				start
 			};
 			if (opts.from !== void 0) ins.explicitFrom = opts.from;
+			if (opts.type !== void 0) ins.valueType = opts.type;
 			insertions.push(ins);
 			prevStart = start;
 			prevEnd = start + duration;
@@ -729,7 +731,7 @@ function buildTimeline(build, init = {}) {
 		set(target, value, opts = {}) {
 			rejectUnknownOpts("set", opts, SET_OPTS_KEYS);
 			const start = resolvePosition(opts.at);
-			insertions.push({
+			const ins = {
 				kind: "set",
 				target: resolveTweenTarget(target),
 				value,
@@ -739,7 +741,9 @@ function buildTimeline(build, init = {}) {
 				baseValue: peekBase(target),
 				editable: false,
 				start
-			});
+			};
+			if (opts.type !== void 0) ins.valueType = opts.type;
+			insertions.push(ins);
 			prevStart = start;
 			prevEnd = start;
 			return builder;
@@ -879,9 +883,11 @@ function buildTimeline(build, init = {}) {
 			if (last && last.t === k.t) deduped[deduped.length - 1] = k;
 			else deduped.push(k);
 		}
+		const explicitTypes = [...new Set(list.filter((i) => i.valueType !== void 0).map((i) => i.valueType))];
+		if (explicitTypes.length > 1) throw new TimelineValidationError(`'${target}': conflicting explicit value types [${explicitTypes.join(", ")}] on one target — a track has a single value type`);
 		const tr = {
 			target,
-			type: inferValueType(list[0].value),
+			type: explicitTypes[0] ?? inferValueType(list[0].value),
 			keys: deduped
 		};
 		if (editable) tr.editable = true;

package/package.json

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