[labs/ssr] Allow template cache to be configured #5119

jimsimon · 2025-10-10T19:15:22Z

This is a simple PR that allows the user to provide an alternative cache implementation for SSR's cache. We plan to use this at Reddit to implement a cache that records hits, misses, and evictions that we can then forward to our metrics collection system.

changeset-bot · 2025-10-10T19:15:26Z

🦋 Changeset detected

Latest commit: ac4636b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@lit-labs/ssr	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2025-10-10T19:15:33Z

📊 Tachometer Benchmark Results

Summary

nop-update

this-change, tip-of-tree, previous-release: unsure 🔍 -2% - +13% (-0.19ms - +1.51ms)
^{this-change vs tip-of-tree}

render

this-change: 44.86ms - 58.88ms
this-change, tip-of-tree, previous-release: unsure 🔍 -2% - +8% (-0.28ms - +1.53ms)
^{this-change vs tip-of-tree}
this-change, tip-of-tree, previous-release: unsure 🔍 -1% - +2% (-0.49ms - +0.71ms)
^{this-change vs tip-of-tree}
this-change, tip-of-tree, previous-release: unsure 🔍 -29% - +18% (-16.62ms - +10.44ms)
^{this-change vs tip-of-tree}

update

this-change: 451.33ms - 458.09ms
this-change, tip-of-tree, previous-release: unsure 🔍 -5% - +5% (-1.77ms - +1.79ms)
^{this-change vs tip-of-tree}
this-change, tip-of-tree, previous-release: unsure 🔍 -1% - +3% (-0.35ms - +1.91ms)
^{this-change vs tip-of-tree}
this-change, tip-of-tree, previous-release: unsure 🔍 -1% - +2% (-3.10ms - +7.78ms)
^{this-change vs tip-of-tree}

update-reflect

this-change: 437.04ms - 441.11ms
this-change, tip-of-tree, previous-release: unsure 🔍 -1% - +0% (-6.14ms - +0.82ms)
^{this-change vs tip-of-tree}

Results

this-change

Browser: chrome-headless 140.0.0.0
Sample size: 50
Built by: Benchmarks #7003
Commit: ac4636b

render

Version	Avg time	vs
	44.86ms - 58.88ms	-

update

Version	Avg time	vs
	451.33ms - 458.09ms	-

update-reflect

Version	Avg time	vs
	437.04ms - 441.11ms	-

this-change, tip-of-tree, previous-release

Browser: chrome-headless 140.0.0.0
Sample size: 30
Built by: Benchmarks #7003
Commit: ac4636b

render

Version	Avg time	vs this-change	vs tip-of-tree tip-of-tree	vs previous-release previous-release
this-change	19.02ms - 20.28ms	-	unsure 🔍 -2% - +8% -0.28ms - +1.53ms	slower ❌ 3% - 12% 0.50ms - 2.14ms
tip-of-tree tip-of-tree	18.37ms - 19.67ms	unsure 🔍 -8% - +1% -1.53ms - +0.28ms	-	unsure 🔍 -1% - +8% -0.14ms - +1.53ms
previous-release previous-release	17.81ms - 18.85ms	faster ✔ 3% - 11% 0.50ms - 2.14ms	unsure 🔍 -8% - +1% -1.53ms - +0.14ms	-

update

Version	Avg time	vs this-change	vs tip-of-tree tip-of-tree	vs previous-release previous-release
this-change	33.93ms - 36.57ms	-	unsure 🔍 -5% - +5% -1.77ms - +1.79ms	unsure 🔍 -3% - +9% -0.93ms - +2.99ms
tip-of-tree tip-of-tree	34.05ms - 36.43ms	unsure 🔍 -5% - +5% -1.79ms - +1.77ms	-	unsure 🔍 -3% - +9% -0.86ms - +2.89ms
previous-release previous-release	32.78ms - 35.68ms	unsure 🔍 -8% - +3% -2.99ms - +0.93ms	unsure 🔍 -8% - +2% -2.89ms - +0.86ms	-

nop-update

Version	Avg time	vs this-change	vs tip-of-tree tip-of-tree	vs previous-release previous-release
this-change	12.33ms - 13.52ms	-	unsure 🔍 -2% - +13% -0.19ms - +1.51ms	slower ❌ 2% - 15% 0.24ms - 1.74ms
tip-of-tree tip-of-tree	11.66ms - 12.87ms	unsure 🔍 -12% - +1% -1.51ms - +0.19ms	-	unsure 🔍 -4% - +9% -0.44ms - +1.10ms
previous-release previous-release	11.47ms - 12.40ms	faster ✔ 2% - 13% 0.24ms - 1.74ms	unsure 🔍 -9% - +3% -1.10ms - +0.44ms	-

this-change, tip-of-tree, previous-release

Browser: chrome-headless 140.0.0.0
Sample size: 50
Built by: Benchmarks #7003
Commit: ac4636b

render

Version	Avg time	vs this-change	vs tip-of-tree tip-of-tree	vs previous-release previous-release
this-change	34.20ms - 35.05ms	-	unsure 🔍 -1% - +2% -0.49ms - +0.71ms	unsure 🔍 -1% - +2% -0.47ms - +0.80ms
tip-of-tree tip-of-tree	34.09ms - 34.94ms	unsure 🔍 -2% - +1% -0.71ms - +0.49ms	-	unsure 🔍 -2% - +2% -0.58ms - +0.69ms
previous-release previous-release	33.99ms - 34.93ms	unsure 🔍 -2% - +1% -0.80ms - +0.47ms	unsure 🔍 -2% - +2% -0.69ms - +0.58ms	-

update

Version	Avg time	vs this-change	vs tip-of-tree tip-of-tree	vs previous-release previous-release
this-change	68.22ms - 69.89ms	-	unsure 🔍 -1% - +3% -0.35ms - +1.91ms	unsure 🔍 -1% - +3% -0.43ms - +1.71ms
tip-of-tree tip-of-tree	67.52ms - 69.04ms	unsure 🔍 -3% - +0% -1.91ms - +0.35ms	-	unsure 🔍 -2% - +1% -1.15ms - +0.88ms
previous-release previous-release	67.75ms - 69.08ms	unsure 🔍 -2% - +1% -1.71ms - +0.43ms	unsure 🔍 -1% - +2% -0.88ms - +1.15ms	-

this-change, tip-of-tree, previous-release

Browser: chrome-headless 140.0.0.0
Sample size: 50
Built by: Benchmarks #7003
Commit: ac4636b

render

Version	Avg time	vs this-change	vs tip-of-tree tip-of-tree	vs previous-release previous-release
this-change	44.32ms - 63.19ms	-	unsure 🔍 -29% - +18% -16.62ms - +10.44ms	unsure 🔍 -30% - +16% -17.64ms - +9.55ms
tip-of-tree tip-of-tree	47.15ms - 66.54ms	unsure 🔍 -20% - +32% -10.44ms - +16.62ms	-	unsure 🔍 -25% - +22% -14.73ms - +12.82ms
previous-release previous-release	48.01ms - 67.59ms	unsure 🔍 -19% - +34% -9.55ms - +17.64ms	unsure 🔍 -23% - +26% -12.82ms - +14.73ms	-

update

Version	Avg time	vs this-change	vs tip-of-tree tip-of-tree	vs previous-release previous-release
this-change	447.92ms - 455.40ms	-	unsure 🔍 -1% - +2% -3.10ms - +7.78ms	unsure 🔍 -1% - +1% -4.47ms - +5.99ms
tip-of-tree tip-of-tree	445.38ms - 453.27ms	unsure 🔍 -2% - +1% -7.78ms - +3.10ms	-	unsure 🔍 -2% - +1% -6.96ms - +3.80ms
previous-release previous-release	447.25ms - 454.56ms	unsure 🔍 -1% - +1% -5.99ms - +4.47ms	unsure 🔍 -1% - +2% -3.80ms - +6.96ms	-

update-reflect

Version	Avg time	vs this-change	vs tip-of-tree tip-of-tree	vs previous-release previous-release
this-change	449.28ms - 453.16ms	-	unsure 🔍 -1% - +0% -6.14ms - +0.82ms	faster ✔ 0% - 2% 0.71ms - 7.88ms
tip-of-tree tip-of-tree	450.99ms - 456.77ms	unsure 🔍 -0% - +1% -0.82ms - +6.14ms	-	unsure 🔍 -1% - +1% -5.81ms - +2.53ms
previous-release previous-release	452.50ms - 458.53ms	slower ❌ 0% - 2% 0.71ms - 7.88ms	unsure 🔍 -1% - +1% -2.53ms - +5.81ms	-

_{tachometer-reporter-action v2 for Benchmarks}

github-actions · 2025-10-10T19:17:03Z

The size of lit-html.js and lit-core.min.js are as expected.

[labs/ssr] Allow template cache to be configured

88870b3

jimsimon requested a review from justinfagnani October 10, 2025 19:15

jimsimon marked this pull request as ready for review October 10, 2025 19:16

jimsimon requested a review from kevinpschaaf as a code owner October 10, 2025 19:16

jimsimon added 3 commits October 10, 2025 15:18

Add changeset

8f065b1

Fix typings on RenderInfo

db95ab5

Fix typings for ssr-react

ac4636b

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[labs/ssr] Allow template cache to be configured #5119

[labs/ssr] Allow template cache to be configured #5119

Uh oh!

Uh oh!

📊 Tachometer Benchmark Results

Summary

nop-update

render

update

update-reflect

Results

render

update

update-reflect

render

update

nop-update

render

update

render

update

update-reflect

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

[labs/ssr] Allow template cache to be configured #5119

Are you sure you want to change the base?

[labs/ssr] Allow template cache to be configured #5119

Conversation

Uh oh!

Uh oh!

Uh oh!

🦋 Changeset detected

Uh oh!

Uh oh!

📊 Tachometer Benchmark Results

Summary

nop-update

render

update

update-reflect

Results

render

update

update-reflect

render

update

nop-update

render

update

render

update

update-reflect

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant