@svelterm/core 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.24.0 — 2026-07-05
+
+Motion timing completeness: transitions and keyframes behave per spec.
+
+### Added
+
+- **Per-property transitions** — `transition: color 150ms linear, width
+  400ms ease` runs each property on its own duration and timing;
+  longhand lists pair cyclically per spec. (Previously the first
+  duration and one timing function applied to everything.)
+- **Interrupted transitions continue** — a retargeted transition starts
+  from its current blended value instead of jumping back to the previous
+  target (reversals no longer flash).
+- **Per-keyframe `animation-timing-function`** — a timing function
+  declared inside a keyframe applies from that stop to the next.
+- **Keyframe `var()`/`light-dark()` re-resolution** — scheme flips and
+  custom-property changes retarget a running animation in place, without
+  restarting it.
+
 ## 0.23.0 — 2026-07-05
 
 Positioning: `relative` offsets apply, and `sticky` arrives.

package/dist/src/css/animation-runner.d.ts

@@ -1,6 +1,6 @@
 import type { KeyframeStop } from './parser.js';
 import { type ResolvedStyle } from './compute.js';
-import type { Easing } from './easing.js';
+import { type Easing } from './easing.js';
 /**
  * Runs a CSS animation by applying keyframe properties at the current
  * time. Colours interpolate in RGB space between stops; properties that

package/dist/src/css/animation-runner.js

@@ -1,5 +1,6 @@
 import { applyDeclaration } from './compute.js';
 import { resolveColor } from './color.js';
+import { parseEasing } from './easing.js';
 import { lerpColor, lerpNumber } from './interpolate.js';
 import { parseCellLength } from './values.js';
 /** Properties whose animation only needs repaint; anything else re-layouts. */
@@ -37,7 +38,11 @@ export class AnimationRunner {
         const progress = this.getProgress(elapsedMs);
         const segment = this.segmentAt(progress);
         const { from, to } = segment;
-        const localT = this.easing(segment.localT);
+        // A timing function declared inside a keyframe applies from that
+        // stop to the next, overriding the element-level easing (per CSS).
+        const override = from.declarations.find(d => d.property === 'animation-timing-function');
+        const easing = override ? (parseEasing(override.value) ?? this.easing) : this.easing;
+        const localT = easing(segment.localT);
         // Hold the earlier stop's values, then interpolate toward the next
         for (const decl of from.declarations) {
             applyAnimatedProperty(style, decl);
@@ -87,6 +92,9 @@ export class AnimationRunner {
     }
 }
 function applyAnimatedProperty(style, decl) {
+    // Keyframe-level timing functions steer the runner, not the style
+    if (decl.property === 'animation-timing-function')
+        return;
     applyDeclaration(style, decl.property, decl.value);
 }
 function applyInterpolatedProperty(style, from, to, t) {

package/dist/src/css/compute.d.ts

@@ -53,6 +53,15 @@ export interface ResolvedStyle {
     transitionProperty: string | null;
     transitionDuration: number;
     transitionTimingFunction: string;
+    /** Longhand lists, paired cyclically per spec into `transitions`. */
+    transitionDurations: number[];
+    transitionTimings: string[];
+    /** Per-property transition config, resolved after cascade. */
+    transitions: Array<{
+        property: string;
+        duration: number;
+        timing: string;
+    }>;
     borderStyle: 'none' | 'single' | 'double' | 'rounded' | 'heavy' | 'ascii' | 'eighth-cell-inner' | 'eighth-cell-outer' | 'half-cell-inner' | 'half-cell-outer' | 'full-cell';
     borderCorner: 'none' | 'h' | 'v';
     borderColor: string;
@@ -88,3 +97,12 @@ export declare function resolveStyles(root: TermNode, stylesheet: CSSStyleSheet,
 export declare function filterByMedia(stylesheet: CSSStyleSheet, context: MediaContext): CSSStyleSheet;
 export declare function resolveNode(node: TermNode, stylesheet: CSSStyleSheet, styles: Map<number, ResolvedStyle>, variables: Map<number, Map<string, string>>, scheme?: 'dark' | 'light'): void;
 export declare function applyDeclaration(style: ResolvedStyle, property: string, value: string, scheme?: 'dark' | 'light'): void;
+/**
+ * Pair the transition lists per spec: durations/timings repeat
+ * cyclically to cover every listed property.
+ */
+export declare function pairTransitions(style: ResolvedStyle): Array<{
+    property: string;
+    duration: number;
+    timing: string;
+}>;

package/dist/src/css/compute.js

@@ -56,6 +56,8 @@ export function defaultStyle(tag) {
         animationTimingFunction: 'ease',
         transitionProperty: null, transitionDuration: 0,
         transitionTimingFunction: 'ease',
+        transitionDurations: [], transitionTimings: [],
+        transitions: [],
         borderStyle: 'none', borderColor: 'default', borderCorner: 'none',
         borderTop: true, borderRight: true, borderBottom: true, borderLeft: true,
         boxSizing: 'border-box',
@@ -272,6 +274,8 @@ function computeStyle(node, stylesheet, vars, parentStyle, scheme = 'dark') {
             applyDeclaration(style, decl.property, resolveVar(decl.value, vars), scheme);
         }
     }
+    // Pair transition longhand lists now the cascade is complete
+    style.transitions = pairTransitions(style);
     return style;
 }
 function parseInlineStyle(text) {
@@ -563,10 +567,12 @@ export function applyDeclaration(style, property, value, scheme = 'dark') {
             style.transitionProperty = value === 'none' ? null : value;
             break;
         case 'transition-duration':
-            style.transitionDuration = parseDuration(value);
+            style.transitionDurations = value.split(',').map(v => parseDuration(v.trim()));
+            style.transitionDuration = style.transitionDurations[0] ?? 0;
             break;
         case 'transition-timing-function':
-            style.transitionTimingFunction = value;
+            style.transitionTimings = splitTimingList(value);
+            style.transitionTimingFunction = style.transitionTimings[0] ?? 'ease';
             break;
         case 'animation-name':
             style.animationName = value === 'none' ? null : value;
@@ -806,35 +812,85 @@ function parseAnimationShorthand(style, value) {
         }
     }
 }
-/** Parse `transition: <property> <duration> [...]`, comma-separated groups. */
+/** Split a timing-function list on commas, keeping function args intact. */
+function splitTimingList(value) {
+    const out = [];
+    let depth = 0;
+    let current = '';
+    for (const ch of value) {
+        if (ch === '(')
+            depth++;
+        if (ch === ')')
+            depth--;
+        if (ch === ',' && depth === 0) {
+            out.push(current.trim());
+            current = '';
+        }
+        else
+            current += ch;
+    }
+    if (current.trim())
+        out.push(current.trim());
+    return out;
+}
+/**
+ * Parse `transition: <property> <duration> <timing> [...]` — each
+ * comma-separated group configures one property (or `all`).
+ */
 function parseTransitionShorthand(style, value) {
     const trimmed = value.trim();
     if (trimmed === 'none') {
         style.transitionProperty = null;
         style.transitionDuration = 0;
+        style.transitionDurations = [];
+        style.transitionTimings = [];
         return;
     }
-    const { easing, rest } = extractEasingFunction(trimmed);
-    if (easing)
-        style.transitionTimingFunction = easing;
     const properties = [];
-    let duration = 0;
-    for (const group of rest.split(',')) {
-        for (const token of group.trim().split(/\s+/)) {
+    const durations = [];
+    const timings = [];
+    for (const groupRaw of splitTimingList(trimmed)) {
+        const { easing, rest } = extractEasingFunction(groupRaw);
+        let property = 'all';
+        let duration = 0;
+        let timing = easing ?? 'ease';
+        for (const token of rest.trim().split(/\s+/)) {
             if (/^\d*\.?\d+(ms|s)$/.test(token)) {
                 if (duration === 0)
                     duration = parseDuration(token);
             }
             else if (TIMING_KEYWORDS.has(token)) {
-                style.transitionTimingFunction = token;
+                timing = token;
             }
             else if (token) {
-                properties.push(token);
+                property = token;
             }
         }
+        properties.push(property);
+        durations.push(duration);
+        timings.push(timing);
     }
     style.transitionProperty = properties.length > 0 ? properties.join(',') : 'all';
-    style.transitionDuration = duration;
+    style.transitionDurations = durations;
+    style.transitionTimings = timings;
+    style.transitionDuration = durations[0] ?? 0;
+    style.transitionTimingFunction = timings[0] ?? 'ease';
+}
+/**
+ * Pair the transition lists per spec: durations/timings repeat
+ * cyclically to cover every listed property.
+ */
+export function pairTransitions(style) {
+    if (!style.transitionProperty)
+        return [];
+    const properties = style.transitionProperty.split(',').map(p => p.trim()).filter(Boolean);
+    const durations = style.transitionDurations.length > 0 ? style.transitionDurations : [style.transitionDuration];
+    const timings = style.transitionTimings.length > 0 ? style.transitionTimings : [style.transitionTimingFunction];
+    return properties.map((property, i) => ({
+        property,
+        duration: durations[i % durations.length] ?? 0,
+        timing: timings[i % timings.length] ?? 'ease',
+    }));
 }
 function parseDuration(value) {
     if (value.endsWith('ms'))

package/dist/src/render/animation-clock.d.ts

@@ -12,6 +12,7 @@ export type { KeyframeResolution } from '../css/animation.js';
  */
 export declare class AnimationClock {
     private active;
+    /** Per-property transition runners, keyed `nodeId:property`. */
     private transitions;
     /** Last-seen target values per transitioned node, as CSS property → value. */
     private transitionTargets;
@@ -51,7 +52,14 @@ export declare class AnimationClock {
     stop(): void;
     private discover;
     private discoverTransitions;
-    /** Snapshot the node's target values; start a transition on any change. */
+    /**
+     * Snapshot the node's target values; start a per-property transition
+     * runner on any change, each with its own duration and timing. An
+     * interrupted transition continues from its current blended value
+     * rather than restarting from the previous target.
+     */
     private trackTransitionTargets;
+    /** Evaluate an in-flight transition's value for one property, now. */
+    private currentValue;
     private updateTimer;
 }

package/dist/src/render/animation-clock.js

@@ -6,17 +6,6 @@ import { systemClock, clockFromNow } from './clock.js';
 function easingFor(value) {
     return parseEasing(value) ?? (t => t);
 }
-/** Parse a transition-property value into the tracked-property filter. */
-function transitionedProperties(value) {
-    const names = new Set();
-    for (const raw of value.split(',')) {
-        const name = raw.trim();
-        if (name === 'all')
-            return { all: true, names };
-        names.add(name === 'background' ? 'background-color' : name);
-    }
-    return { all: false, names };
-}
 function cellValue(value) {
     return typeof value === 'number' && value >= 0 ? `${value}cell` : null;
 }
@@ -50,6 +39,7 @@ const FRAME_INTERVAL_MS = 33;
  */
 export class AnimationClock {
     active = new Map();
+    /** Per-property transition runners, keyed `nodeId:property`. */
     transitions = new Map();
     /** Last-seen target values per transitioned node, as CSS property → value. */
     transitionTargets = new Map();
@@ -71,8 +61,13 @@ export class AnimationClock {
     }
     /** Whether this node's animation needs re-layout each frame (vs repaint only). */
     touchesLayout(node) {
-        return (this.active.get(node.id)?.runner.touchesLayout
-            || this.transitions.get(node.id)?.runner.touchesLayout) ?? false;
+        if (this.active.get(node.id)?.runner.touchesLayout)
+            return true;
+        for (const anim of this.transitions.values()) {
+            if (anim.node.id === node.id && anim.runner.touchesLayout)
+                return true;
+        }
+        return false;
     }
     /**
      * Track transitioned elements and start a one-shot transition when a
@@ -87,7 +82,10 @@ export class AnimationClock {
         for (const id of this.transitionTargets.keys()) {
             if (!seen.has(id)) {
                 this.transitionTargets.delete(id);
-                this.transitions.delete(id);
+                for (const key of this.transitions.keys()) {
+                    if (key.startsWith(`${id}:`))
+                        this.transitions.delete(key);
+                }
             }
         }
         this.updateTimer();
@@ -116,15 +114,15 @@ export class AnimationClock {
         return dirty;
     }
     applyEntries(entries, styles, dirty) {
-        for (const [id, anim] of entries) {
-            const style = styles.get(id);
+        for (const [key, anim] of entries) {
+            const style = styles.get(anim.node.id);
             if (!style)
                 continue;
             const elapsed = this.now() - anim.start;
             anim.runner.apply(style, elapsed);
             dirty.push({ node: anim.node, touchesLayout: anim.runner.touchesLayout });
             if (anim.runner.isFinished(elapsed))
-                entries.delete(id);
+                entries.delete(key);
         }
     }
     stop() {
@@ -140,18 +138,27 @@ export class AnimationClock {
             const stops = name ? keyframes.get(name) : undefined;
             if (style && name && stops && style.animationDuration > 0) {
                 const existing = this.active.get(node.id);
+                const resolved = resolution
+                    ? resolveKeyframeStops(stops, resolution, node.id)
+                    : stops;
+                const resolvedKey = JSON.stringify(resolved);
                 if (!existing || existing.name !== name || existing.duration !== style.animationDuration) {
-                    const resolved = resolution
-                        ? resolveKeyframeStops(stops, resolution, node.id)
-                        : stops;
                     this.active.set(node.id, {
                         node,
                         runner: new AnimationRunner(resolved, style.animationDuration, style.animationIterationCount, easingFor(style.animationTimingFunction)),
                         name,
                         duration: style.animationDuration,
                         start: this.now(),
+                        resolvedKey,
                     });
                 }
+                else if (existing.resolvedKey !== undefined && existing.resolvedKey !== resolvedKey) {
+                    // var()/light-dark() re-resolved to new values (scheme
+                    // flip, custom property change): retarget the runner
+                    // without restarting — the original start time holds.
+                    existing.runner = new AnimationRunner(resolved, style.animationDuration, style.animationIterationCount, easingFor(style.animationTimingFunction));
+                    existing.resolvedKey = resolvedKey;
+                }
                 seen.add(node.id);
             }
         }
@@ -162,7 +169,7 @@ export class AnimationClock {
         const subtreeResolved = parentResolved || (resolvedIds?.has(node.id) ?? false);
         if (node.nodeType === 'element') {
             const style = styles.get(node.id);
-            if (style?.transitionProperty && style.transitionDuration > 0) {
+            if (style && style.transitions.some(t => t.duration > 0)) {
                 seen.add(node.id);
                 if (subtreeResolved)
                     this.trackTransitionTargets(node, style);
@@ -172,12 +179,20 @@ export class AnimationClock {
             this.discoverTransitions(child, styles, subtreeResolved, resolvedIds, seen);
         }
     }
-    /** Snapshot the node's target values; start a transition on any change. */
+    /**
+     * Snapshot the node's target values; start a per-property transition
+     * runner on any change, each with its own duration and timing. An
+     * interrupted transition continues from its current blended value
+     * rather than restarting from the previous target.
+     */
     trackTransitionTargets(node, style) {
-        const included = transitionedProperties(style.transitionProperty);
+        const configFor = (css) => style.transitions.find(t => t.property === css
+            || (t.property === 'background' && css === 'background-color'))
+            ?? style.transitions.find(t => t.property === 'all');
         const targets = {};
         for (const prop of TRANSITIONABLE) {
-            if (!included.all && !included.names.has(prop.css))
+            const config = configFor(prop.css);
+            if (!config || config.duration <= 0)
                 continue;
             const value = prop.read(style);
             if (value !== null)
@@ -187,28 +202,38 @@ export class AnimationClock {
         this.transitionTargets.set(node.id, targets);
         if (!previous)
             return; // first sight — the initial style never transitions
-        const fromDecls = [];
-        const toDecls = [];
         for (const [property, target] of Object.entries(targets)) {
             const before = previous[property];
-            if (before !== undefined && before !== target) {
-                fromDecls.push({ property, value: before });
-                toDecls.push({ property, value: target });
+            if (before === undefined || before === target)
+                continue;
+            const config = configFor(property);
+            const key = `${node.id}:${property}`;
+            // Interrupted mid-flight? Continue from the current value.
+            let from = before;
+            const inFlight = this.transitions.get(key);
+            if (inFlight) {
+                const current = this.currentValue(inFlight, style, property);
+                if (current !== null)
+                    from = current;
             }
+            const stops = [
+                { offset: 0, declarations: [{ property, value: from }] },
+                { offset: 1, declarations: [{ property, value: target }] },
+            ];
+            this.transitions.set(key, {
+                node,
+                runner: new AnimationRunner(stops, config.duration, 1, easingFor(config.timing)),
+                name: property,
+                duration: config.duration,
+                start: this.now(),
+            });
         }
-        if (fromDecls.length === 0)
-            return;
-        const stops = [
-            { offset: 0, declarations: fromDecls },
-            { offset: 1, declarations: toDecls },
-        ];
-        this.transitions.set(node.id, {
-            node,
-            runner: new AnimationRunner(stops, style.transitionDuration, 1, easingFor(style.transitionTimingFunction)),
-            name: '',
-            duration: style.transitionDuration,
-            start: this.now(),
-        });
+    }
+    /** Evaluate an in-flight transition's value for one property, now. */
+    currentValue(anim, base, property) {
+        const scratch = { ...base };
+        anim.runner.apply(scratch, this.now() - anim.start);
+        return TRANSITIONABLE.find(p => p.css === property)?.read(scratch) ?? null;
     }
     updateTimer() {
         if (this.activeCount > 0 && this.timer === null) {

package/docs/motion.md

@@ -66,19 +66,20 @@ inline style updates, a `:checked` rule starts applying:
 `ms`/`s`. The same interpolation rules as animations apply. The initial
 style never transitions.
 
+Transitions are configured per property, per spec: comma-separated
+shorthand groups (`transition: color 150ms linear, width 400ms ease`)
+or longhand lists paired cyclically. An interrupted transition
+continues from its current blended value. A timing function declared
+*inside a keyframe* applies from that stop to the next, overriding the
+element's. Keyframe `var()`/`light-dark()` values re-resolve when the
+scheme or custom properties change mid-animation, retargeting without
+restarting.
+
 ## Deviations from browsers
 
-- One duration and one timing function apply to all listed transition
-  properties (per-property lists aren't split).
-- An interrupted transition restarts from its previous target value, not
-  the current blended value.
 - `opacity` doesn't interpolate (it applies discretely mid-animation) —
   animate colour toward the background for a smooth fade.
-- Keyframe `var()`/`light-dark()` resolution happens once when the
-  animation starts; changing a custom property doesn't retarget a
-  running animation.
-- Per-keyframe `animation-timing-function` overrides are ignored — the
-  element's timing function applies to every segment.
+- `transition-delay` / `animation-delay` are not implemented.
 
 ## Reduced motion
 

package/docs/reference.md

@@ -176,7 +176,7 @@ adaptations. Lengths are cells (`cell`/`ch`, `%`, or `calc()`).
 | [Tables](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_table) | `border-collapse`, `border-spacing`, `caption-side`, `table-layout`, `empty-cells`, `vertical-align` (`baseline` ≈ `top`) |
 | Borders | `border`/`border-style`/`border-color`/`border-corner` + per-side toggles (terminal values above) |
 | [Animation](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_animations) | `animation` shorthand, `animation-name/-duration/-iteration-count` (incl. `infinite`)/`-timing-function`, `@keyframes` (from/to/percentages, values resolve `var()`/`light-dark()`) |
-| [Transitions](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_transitions) | `transition` shorthand, `transition-property` (list or `all`), `transition-duration`, `transition-timing-function` |
+| [Transitions](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_transitions) | `transition` shorthand with per-property comma groups; `transition-property`/`-duration`/`-timing-function` longhand lists paired per spec; interruptions continue from the current value |
 | [Easing](https://developer.mozilla.org/en-US/docs/Web/CSS/easing-function) | `linear`, `ease` (default), `ease-in`, `ease-out`, `ease-in-out`, `cubic-bezier()`, `steps()`, `step-start`, `step-end` |
 
 ### Animation & transition semantics on the grid
@@ -185,12 +185,14 @@ Colours interpolate in RGB at ~30fps; single cell/ch lengths interpolate
 to whole cells (movement steps cell by cell); every other supported
 property applies discretely, switching at the segment midpoint (the CSS
 rule for non-interpolable values). Layout-affecting animations re-flow
-each frame. Easing applies per keyframe segment; non-interpolable values
-switch when eased progress crosses the midpoint. Deviations: one duration
-and one timing function for all listed transition properties, interrupted
-transitions restart from the previous target value, keyframe
-`var()`/`light-dark()` resolves once at animation start, and per-keyframe
-`animation-timing-function` overrides are ignored.
+each frame. Easing applies per keyframe segment (a timing function
+declared inside a keyframe overrides the element's for that segment);
+non-interpolable values switch when eased progress crosses the midpoint.
+Transitions run per property with their own duration/timing;
+interruptions continue from the current blended value. Keyframe
+`var()`/`light-dark()` re-resolves on scheme/custom-property changes
+without restarting the animation. Deviation: no `transition-delay` /
+`animation-delay`.
 
 ## Values, functions and at-rules
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svelterm/core",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Svelte 5 components rendered to the terminal with real CSS",
   "type": "module",
   "exports": {