diff --git a/.changeset/presentation-subscriber-reentry.md b/.changeset/presentation-subscriber-reentry.md new file mode 100644 index 00000000..39cdc140 --- /dev/null +++ b/.changeset/presentation-subscriber-reentry.md @@ -0,0 +1,5 @@ +--- +'@tanstack/charts': patch +--- + +Keep presentation subscribers and animation completion on the newest scene when a subscriber renders another scene. diff --git a/benchmarks/comparison/bundle-baseline.json b/benchmarks/comparison/bundle-baseline.json index 1129d730..38798945 100644 --- a/benchmarks/comparison/bundle-baseline.json +++ b/benchmarks/comparison/bundle-baseline.json @@ -11,8 +11,8 @@ "sources": { "tanstack": { "kind": "workspace", - "revision": "af1fbe696130b86804194b49159d7adca8f4c97e", - "inputDigest": "sha256:d69c77dee8bd32caa953245d7153983aa3fa8520d407c8410b7a19a93287b33a" + "revision": "828b520d7a9c1488a4ab66259162dfe048084acd", + "inputDigest": "sha256:09545bea7164c4cea02bc5e30e48076ba227c1d33643f73ea75de5120c50bdf2" }, "chartjs": { "kind": "package", diff --git a/benchmarks/conformance/previews/manifest.json b/benchmarks/conformance/previews/manifest.json index a69af0b2..506767e9 100644 --- a/benchmarks/conformance/previews/manifest.json +++ b/benchmarks/conformance/previews/manifest.json @@ -2,7 +2,7 @@ "schemaVersion": 1, "width": 288, "height": 192, - "sourceHash": "b3278434002dbce5d618fa0ef27b126696ab8a3406f37899d6e4492e7c6ab66c", + "sourceHash": "9e3bf0e06796e3f7a4f41dcada68f334a5e38160608e2964900dbb74e3b65970", "assets": [ { "id": "01-line-gaps", diff --git a/docs/comparison.md b/docs/comparison.md index 1ae6e917..c94a28ed 100644 --- a/docs/comparison.md +++ b/docs/comparison.md @@ -12,14 +12,14 @@ turning untested behavior into a checkmark. | Library | Package | Measured source | | -------------------------------------------------------------------------------------- | -------------------- | ------------------- | -| [TanStack Charts](./overview.md) | `@tanstack/charts` | workspace `af1fbe6` | +| [TanStack Charts](./overview.md) | `@tanstack/charts` | workspace `828b520` | | [Chart.js](https://www.chartjs.org/docs/latest/) | `chart.js` | npm `4.5.1` | | [Apache ECharts](https://echarts.apache.org/handbook/en/best-practices/canvas-vs-svg/) | `echarts` | npm `6.1.0` | | [Recharts](https://recharts.github.io/en-US/) | `recharts` | npm `3.10.1` | | [Observable Plot](https://observablehq.com/plot/features/plots) | `@observablehq/plot` | npm `0.6.17` | The competitor versions are exact package pins, not latest versions inferred -at page render time. The measured TanStack workspace revision is `af1fbe6`. +at page render time. The measured TanStack workspace revision is `828b520`. ## Capability matrix diff --git a/docs/installation.md b/docs/installation.md index d735384f..307c8ad4 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -96,7 +96,7 @@ D3 dependency. | `@tanstack/charts/react-native` | React `^19.2.3`, React Native `^0.86.0` or `^0.88.0`, and `react-native-svg` `>=15.15.4 <16` | | `@tanstack/charts/preact` | Preact `>=10` | | `@tanstack/charts/vue` | Vue `>=3.5` | -| `@tanstack/charts/solid` | Solid `>=1.8` | +| `@tanstack/charts/solid` | Solid `^1.8` | | `@tanstack/charts/svelte` | Svelte `^5.20.0` | | `@tanstack/charts/angular` | Angular core and platform browser `>=19` | | `@tanstack/charts/lit` | Lit `>=3.1.3` | diff --git a/packages/charts-core/docs/comparison.md b/packages/charts-core/docs/comparison.md index 1ae6e917..c94a28ed 100644 --- a/packages/charts-core/docs/comparison.md +++ b/packages/charts-core/docs/comparison.md @@ -12,14 +12,14 @@ turning untested behavior into a checkmark. | Library | Package | Measured source | | -------------------------------------------------------------------------------------- | -------------------- | ------------------- | -| [TanStack Charts](./overview.md) | `@tanstack/charts` | workspace `af1fbe6` | +| [TanStack Charts](./overview.md) | `@tanstack/charts` | workspace `828b520` | | [Chart.js](https://www.chartjs.org/docs/latest/) | `chart.js` | npm `4.5.1` | | [Apache ECharts](https://echarts.apache.org/handbook/en/best-practices/canvas-vs-svg/) | `echarts` | npm `6.1.0` | | [Recharts](https://recharts.github.io/en-US/) | `recharts` | npm `3.10.1` | | [Observable Plot](https://observablehq.com/plot/features/plots) | `@observablehq/plot` | npm `0.6.17` | The competitor versions are exact package pins, not latest versions inferred -at page render time. The measured TanStack workspace revision is `af1fbe6`. +at page render time. The measured TanStack workspace revision is `828b520`. ## Capability matrix diff --git a/packages/charts-core/docs/installation.md b/packages/charts-core/docs/installation.md index d735384f..307c8ad4 100644 --- a/packages/charts-core/docs/installation.md +++ b/packages/charts-core/docs/installation.md @@ -96,7 +96,7 @@ D3 dependency. | `@tanstack/charts/react-native` | React `^19.2.3`, React Native `^0.86.0` or `^0.88.0`, and `react-native-svg` `>=15.15.4 <16` | | `@tanstack/charts/preact` | Preact `>=10` | | `@tanstack/charts/vue` | Vue `>=3.5` | -| `@tanstack/charts/solid` | Solid `>=1.8` | +| `@tanstack/charts/solid` | Solid `^1.8` | | `@tanstack/charts/svelte` | Svelte `^5.20.0` | | `@tanstack/charts/angular` | Angular core and platform browser `>=19` | | `@tanstack/charts/lit` | Lit `>=3.1.3` | diff --git a/packages/charts-core/src/motion.test.ts b/packages/charts-core/src/motion.test.ts index ef4049b0..a31806ed 100644 --- a/packages/charts-core/src/motion.test.ts +++ b/packages/charts-core/src/motion.test.ts @@ -31,6 +31,140 @@ const rows = [ { id: 'b', category: 'B', value: 80 }, ] +describe('presentation subscriber re-entry', () => { + it('defers notifications while a motion callback nests a render', () => { + const frames = installManagedFrames() + const container = document.createElement('div') + const surface = motion<{ x: number; y: number }>({ initial: false }).mount( + container, + () => {}, + ) + let armed = false + let insideCallback = false + const observedInside: boolean[] = [] + const makeScene = (value: number) => + createChartScene( + defineChart({ + marks: [ + dot([{ x: 1, y: value }], { + x: 'x', + y: 'y', + motion: () => { + if (armed) { + armed = false + insideCallback = true + surface.render(makeScene(3), { ariaLabel: 'three' }) + insideCallback = false + } + return { transition: { type: 'tween', duration: 100 } } + }, + }), + ], + scales: { + x: { scale: scaleLinear().domain([0, 2]) }, + y: { scale: scaleLinear().domain([0, 4]) }, + }, + guides: false, + }), + { width: 400, height: 200 }, + ) + try { + surface.render(makeScene(1), { ariaLabel: 'one' }) + surface.subscribePresentationPoints?.(() => + observedInside.push(insideCallback), + ) + armed = true + surface.render(makeScene(2), { ariaLabel: 'two' }) + expect(observedInside).not.toContain(true) + frames.run(0) + frames.run(100) + expect(container.querySelector('svg')?.getAttribute('aria-label')).toBe( + 'three', + ) + expect( + Number(container.querySelector('circle')?.getAttribute('cy')), + ).toBeCloseTo(makeScene(3).points[0]!.y) + } finally { + surface.destroy() + frames.restore() + } + }) + it.each(['snap', 'initial', 'mid', 'finish', 'cancel'])( + 'keeps the newest render after %s notification re-entry', + (phase) => { + const frames = installManagedFrames() + const makeScene = (revision: number) => + createChartScene( + defineChart({ + marks: [dot([{ x: 1, y: revision, revision }], { x: 'x', y: 'y' })], + scales: { + x: { scale: scaleLinear().domain([0, 2]) }, + y: { scale: scaleLinear().domain([0, 4]) }, + }, + guides: false, + }), + { width: 400, height: 200 }, + ) + const container = document.createElement('div') + const surface = motion<{ x: number; y: number; revision: number }>({ + initial: false, + transition: { + type: 'tween', + duration: phase === 'snap' ? 0 : 100, + easing: 'linear', + }, + }).mount(container, () => {}) + const third = makeScene(3) + let armed = phase === 'snap' || phase === 'initial' + let reentered = false + const observations: number[] = [] + try { + surface.render(makeScene(1), { ariaLabel: 'one' }) + surface.subscribePresentationPoints?.((points) => { + if (armed && !reentered && points[0]?.datum.revision === 2) { + reentered = true + surface.render(third, { ariaLabel: 'three' }) + } + }) + surface.subscribePresentationPoints?.((points) => { + observations.push(points[0]!.datum.revision) + }) + surface.render(makeScene(2), { ariaLabel: 'two' }) + if (phase === 'cancel') { + armed = true + surface.render(makeScene(4), { ariaLabel: 'four' }) + } + if (phase !== 'snap') { + frames.run(0) + if (phase === 'mid') armed = true + frames.run(50) + armed = true + frames.run(100) + if (frames.pending()) frames.run(200) + if (frames.pending()) frames.run(400) + } + const expected = phase === 'cancel' ? 4 : 3 + expect(reentered).toBe(phase !== 'cancel') + expect(observations).toContain(expected) + expect( + observations.slice(observations.indexOf(expected)), + ).not.toContain(2) + expect(container.querySelector('svg')?.getAttribute('aria-label')).toBe( + phase === 'cancel' ? 'four' : 'three', + ) + expect(surface.getPresentationPoints?.()).toBeUndefined() + expect( + Number(container.querySelector('circle')?.getAttribute('cy')), + ).toBeCloseTo(makeScene(expected).points[0]!.y) + } finally { + surface.destroy() + expect(frames.pending()).toBe(0) + frames.restore() + } + }, + ) +}) + describe('motion resize policy', () => { it.each([false, true])( 'handles a resize during entrance with resize: %s', diff --git a/packages/charts-core/src/motion.ts b/packages/charts-core/src/motion.ts index a0656cb3..6131c008 100644 --- a/packages/charts-core/src/motion.ts +++ b/packages/charts-core/src/motion.ts @@ -828,6 +828,7 @@ function createMotionSvgChartRenderer< let stateTransitions: Readonly> | undefined let stateScene: ChartScene | undefined + let rendering = 0 let dataMotionRevision = 0 let dataMotionActive = false let stateFlushQueued = false @@ -861,7 +862,12 @@ function createMotionSvgChartRenderer< points: readonly ChartPoint[], ) => { presentationPoints = points - for (const listener of presentationListeners) listener(points) + if (rendering) return + const revision = dataMotionRevision + for (const listener of presentationListeners) { + if (revision !== dataMotionRevision) break + listener(points) + } } const queuePendingStateFocus = () => { if (stateFlushQueued || !pendingStateFocus) return @@ -953,105 +959,120 @@ function createMotionSvgChartRenderer< }) return presented.scene } + function renderScene( + nextScene: ChartScene, + options: ChartSurfaceRenderOptions, + ) { + const previousScene = scene + const initial = previousScene === undefined + const resized = Boolean( + previousScene && + (previousScene.width !== nextScene.width || + previousScene.height !== nextScene.height), + ) + const reduced = + motion.respectReducedMotion && + (container.ownerDocument.defaultView?.matchMedia?.( + '(prefers-reduced-motion: reduce)', + ).matches ?? + false) + const animate = + !reduced && + (initial + ? motion.initial && (!adoptedRoot || motion.initial === 'always') + : motion.resize || !resized) + const viewportMoved = Boolean( + previousScene && viewportTranslationChanged(previousScene, nextScene), + ) + const markup = renderSvg(nextScene, options) + cancelAnimation() + const previousPresentation = + presentationPoints ?? previousScene?.points ?? [] + cancelFocusAnimation() + cancelFocusAnimation = () => {} + const retainsFocusGuideLayers = Boolean( + previousScene?.focusGuides?.length, + ) + const focusGuideLayers = retainsFocusGuideLayers + ? detachSvgFocusGuideLayers(svgElement()) + : {} + for (const placement of visibleFocusGuides) { + if ( + !nextScene.focusGuides?.some( + (guide) => guide.placement === placement, + ) + ) { + visibleFocusGuides.delete(placement) + } + } + const revision = ++dataMotionRevision + stateScene = undefined + stateTransition = undefined + scene = nextScene + renderOptions = options + dataMotionActive = animate && !viewportMoved + pendingStateFocus = dataMotionActive ? desiredStateFocus : undefined + if (animate && !viewportMoved) { + if (initial) reconcileChartSvg(container, markup) + const cancel = motion.animateSvg({ + container, + scene: nextScene as ChartScene, + previousScene: previousScene as ChartScene | undefined, + presentationPoints: + previousPresentation as readonly ChartPoint[], + markup, + phase: initial ? 'initial' : 'update', + setPresentationPoints(points) { + if (revision !== dataMotionRevision) return + publishPresentationPoints( + points as readonly ChartPoint[], + ) + if ( + points === nextScene.points && + revision === dataMotionRevision + ) { + dataMotionActive = false + queuePendingStateFocus() + } + }, + }) + if (revision === dataMotionRevision) cancelAnimation = cancel + else cancel() + } else { + reconcileChartSvg(container, markup) + publishPresentationPoints(nextScene.points) + dataMotionActive = false + } + if (retainsFocusGuideLayers) { + restoreSvgFocusGuideLayers( + svgElement(), + focusGuideLayers, + (placement) => + scene?.focusGuides?.some( + (guide) => guide.placement === placement, + ) === true, + ) + } + if (revision !== dataMotionRevision) return + scene = nextScene + stateScene = undefined + renderOptions = options + stateTransition = undefined + stateTransitions = undefined + } const surface: ChartSurface = { renderer: ownerRenderer ?? renderer, get element() { return svgElement() }, render(nextScene, options) { - const previousScene = scene - const initial = previousScene === undefined - const resized = Boolean( - previousScene && - (previousScene.width !== nextScene.width || - previousScene.height !== nextScene.height), - ) - const reduced = - motion.respectReducedMotion && - (container.ownerDocument.defaultView?.matchMedia?.( - '(prefers-reduced-motion: reduce)', - ).matches ?? - false) - const animate = - !reduced && - (initial - ? motion.initial && (!adoptedRoot || motion.initial === 'always') - : motion.resize || !resized) - const viewportMoved = Boolean( - previousScene && - viewportTranslationChanged(previousScene, nextScene), - ) - const markup = renderSvg(nextScene, options) - cancelAnimation() - const previousPresentation = - presentationPoints ?? previousScene?.points ?? [] - cancelFocusAnimation() - cancelFocusAnimation = () => {} - const retainsFocusGuideLayers = Boolean( - previousScene?.focusGuides?.length, - ) - const focusGuideLayers = retainsFocusGuideLayers - ? detachSvgFocusGuideLayers(svgElement()) - : {} - for (const placement of visibleFocusGuides) { - if ( - !nextScene.focusGuides?.some( - (guide) => guide.placement === placement, - ) - ) { - visibleFocusGuides.delete(placement) - } - } - const revision = ++dataMotionRevision - stateScene = undefined - stateTransition = undefined - scene = nextScene - renderOptions = options - dataMotionActive = animate && !viewportMoved - pendingStateFocus = dataMotionActive ? desiredStateFocus : undefined - if (animate && !viewportMoved) { - if (initial) reconcileChartSvg(container, markup) - cancelAnimation = motion.animateSvg({ - container, - scene: nextScene as ChartScene, - previousScene: previousScene as ChartScene | undefined, - presentationPoints: - previousPresentation as readonly ChartPoint[], - markup, - phase: initial ? 'initial' : 'update', - setPresentationPoints(points) { - publishPresentationPoints( - points as readonly ChartPoint[], - ) - if ( - revision === dataMotionRevision && - points === nextScene.points - ) { - dataMotionActive = false - queuePendingStateFocus() - } - }, - }) - } else { - reconcileChartSvg(container, markup) - publishPresentationPoints(nextScene.points) - dataMotionActive = false - } - if (retainsFocusGuideLayers) { - restoreSvgFocusGuideLayers( - svgElement(), - focusGuideLayers, - (placement) => - nextScene.focusGuides?.some( - (guide) => guide.placement === placement, - ) === true, - ) + rendering += 1 + try { + renderScene(nextScene, options) + } finally { + rendering -= 1 } - scene = nextScene - stateScene = undefined - renderOptions = options - stateTransition = undefined - stateTransitions = undefined + if (presentationPoints) publishPresentationPoints(presentationPoints) }, clientToScene(currentScene, clientX, clientY) { return svgClientToScene(svgElement(), currentScene, clientX, clientY) @@ -3994,6 +4015,7 @@ function runTracks( } } lifecycle.publish?.() + if (cancelled) return root.dataset.tsMotionProgress = String(finished.size / activeTracks.length) if (finished.size < activeTracks.length && elapsed < safetyLimit) { frame = view.requestAnimationFrame(tick) @@ -4003,6 +4025,7 @@ function runTracks( if (!finished.has(track)) completeMotionTrack(track) } lifecycle.finish?.() + if (cancelled) return root.dataset.tsMotionState = 'finished' root.dataset.tsMotionProgress = '1' } diff --git a/scripts/measure-bundles.mjs b/scripts/measure-bundles.mjs index f02c1f63..567f8fa7 100644 --- a/scripts/measure-bundles.mjs +++ b/scripts/measure-bundles.mjs @@ -1789,7 +1789,7 @@ const entries = [ budgeted( 'Motion SVG renderer', 'benchmarks/entries/charts-motion-svg-renderer.ts', - 23_240 / 1024, + 23_301 / 1024, { rendererBoundary: 'svg', inputBoundary: {