[WIP] Server Components by schultek · Pull Request #776 · schultek/jaspr

schultek · 2026-03-16T13:29:24Z

Description

Add support for Server Components to Jaspr.

Type of Change

❌ Breaking change
✨ New feature or improvement

# Conflicts: # packages/jaspr/lib/src/browser/browser_binding.dart # packages/jaspr/lib/src/browser/clients.dart # packages/jaspr/lib/src/browser/js_data.dart # packages/jaspr/lib/src/foundation/sync.dart # packages/jaspr/lib/src/framework/render_element.dart # packages/jaspr/lib/src/server/document/document.dart # packages/jaspr/lib/src/server/document/document_base.dart # packages/jaspr/lib/src/server/document/document_binding.dart # packages/jaspr/lib/src/server/document/document_file.dart # packages/jaspr/lib/src/server/markup_renderer.dart # packages/jaspr_builder/lib/src/client/client_part_builder.dart

# Conflicts: # packages/jaspr/lib/src/browser/clients.dart # packages/jaspr_builder/lib/src/client/client_module_builder.dart

# Conflicts: # packages/jaspr/lib/browser.dart # packages/jaspr/lib/src/browser/clients.dart # packages/jaspr/lib/src/components/raw_text/raw_text_web.dart # packages/jaspr/lib/src/foundation/options.dart # packages/jaspr/lib/src/server/adapters/client_component_adapter.dart # packages/jaspr/lib/src/server/adapters/client_script_adapter.dart # packages/jaspr/lib/src/server/adapters/sync_script_adapter.dart # packages/jaspr/lib/src/server/server_binding.dart # packages/jaspr_builder/lib/src/client/client_module_builder.dart # packages/jaspr_builder/lib/src/client/client_registry_builder.dart

# Conflicts: # packages/jaspr/lib/src/browser/clients.dart # packages/jaspr/lib/src/components/raw_text/raw_text_web.dart # packages/jaspr/lib/src/foundation/marker_utils.dart # packages/jaspr/lib/src/foundation/options.dart # packages/jaspr/lib/src/server/adapters/client_component_adapter.dart # packages/jaspr/lib/src/server/adapters/client_script_adapter.dart # packages/jaspr/lib/src/server/server_binding.dart # packages/jaspr/test/browser/hydration/hydration_browser_test.dart # packages/jaspr_builder/lib/src/client/client_module_builder.dart # packages/jaspr_builder/lib/src/codec/codecs.dart

# Conflicts: # packages/jaspr/lib/src/browser/clients.dart # packages/jaspr/lib/src/client/custom_node_component.dart # packages/jaspr/lib/src/dom/raw_text/raw_text_web.dart # packages/jaspr/lib/src/foundation/options.dart # packages/jaspr/lib/src/server/adapters/client_component_adapter.dart # packages/jaspr/lib/src/server/adapters/client_script_adapter.dart # packages/jaspr/lib/src/server/server_binding.dart # packages/jaspr/test/client/hydration/hydration_browser_test.dart # packages/jaspr_builder/lib/src/client/client_module_builder.dart # packages/jaspr_builder/lib/src/codec/codec_module_builder.dart # packages/jaspr_builder/test/client/sources/client_basic.dart # packages/jaspr_builder/test/client/sources/client_model_class.dart # packages/jaspr_builder/test/client/sources/client_model_extension.dart # packages/jaspr_builder/test/sync/sources/sync_model_class.dart # packages/jaspr_builder/test/sync/sources/sync_model_extension.dart

# Conflicts: # packages/jaspr/lib/src/client/component_anchors.dart # packages/jaspr/lib/src/server/adapters/client_component_adapter.dart # packages/jaspr/lib/src/server/server_binding.dart # packages/jaspr_builder/lib/src/client/client_module_builder.dart # packages/jaspr_builder/lib/src/codec/codecs.dart # packages/jaspr_builder/lib/src/sync/sync_mixins_builder.dart # packages/jaspr_builder/test/client/sources/bundle.dart # packages/jaspr_builder/test/client/sources/client_basic.dart # packages/jaspr_builder/test/client/sources/client_model_class.dart # packages/jaspr_builder/test/client/sources/client_model_extension.dart # packages/jaspr_builder/test/codec/sources/bundle.dart # packages/jaspr_builder/test/codec/sources/model_class.dart # packages/jaspr_builder/test/codec/sources/model_extension.dart # packages/jaspr_builder/test/sync/sources/sync_basic.dart # packages/jaspr_builder/test/sync/sources/sync_multi.dart

docs-page · 2026-03-16T13:29:29Z

To view this pull requests documentation preview, visit the following URL:

docs.page/schultek/jaspr~776

Documentation is deployed and generated using docs.page.

github-actions · 2026-03-16T13:31:31Z

Package Version Report

The following packages have been updated:
jaspr_test : 0.22.3 -> 0.23.0
jaspr : 0.22.3 -> 0.23.0
jaspr_builder : 0.22.3 -> 0.23.0
jaspr_cli : 0.22.3 -> 0.23.0
jaspr_content : 0.5.0 -> 0.5.1
jaspr_lints : 0.6.0 -> 0.6.1
jaspr_router : 0.8.1 -> 0.8.2
jaspr_flutter_embed : 0.4.10 -> 0.4.11
jaspr_riverpod : 0.4.4 -> 0.4.5
jaspr_serverpod : 0.6.0 -> 0.6.1

codecov · 2026-03-16T13:40:12Z

Codecov Report

❌ Patch coverage is 51.73410% with 167 lines in your changes missing coverage. Please review.
✅ Project coverage is 60.25%. Comparing base (ea3a532) to head (2034181).
⚠️ Report is 13 commits behind head on main.

Files with missing lines	Patch %	Lines
...ckages/jaspr/lib/src/client/component_anchors.dart	55.38%	29 Missing ⚠️
packages/jaspr/lib/src/client/client_binding.dart	35.29%	22 Missing ⚠️
packages/jaspr/lib/src/framework/build_owner.dart	0.00%	21 Missing ⚠️
.../src/server/adapters/client_component_adapter.dart	41.93%	18 Missing ⚠️
packages/jaspr/lib/src/server/server_handler.dart	19.04%	17 Missing ⚠️
packages/jaspr/lib/src/framework/framework.dart	22.22%	7 Missing ⚠️
packages/jaspr/lib/src/client/client_app.dart	50.00%	6 Missing ⚠️
...es/jaspr/lib/src/framework/stateful_component.dart	0.00%	6 Missing ⚠️
.../src/server/adapters/server_component_adapter.dart	0.00%	6 Missing ⚠️
...ackages/jaspr/lib/src/framework/render_object.dart	44.44%	5 Missing ⚠️
... and 12 more

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #776      +/-   ##
==========================================
- Coverage   60.82%   60.25%   -0.57%     
==========================================
  Files         196      198       +2     
  Lines       11188    11429     +241     
==========================================
+ Hits         6805     6887      +82     
- Misses       4383     4542     +159

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

parlough

Exciting!! I haven't tried it out yet, but some small questions and a few minor suggestions to consider:

schultek · 2026-03-18T13:26:45Z

Sign in to view

+    for (var i = 0; i < _adapters.length; i++) {
+      final r = _adapters[i].prepare();


Can't use foreach because new adapters can be added during .prepare(). I will add a comment.

parlough · 2026-03-18T12:39:39Z

+    rootRenderObject.node = newNode;
+    rootRenderObject.toHydrate = [...newNode.childNodes.toIterable()];


Maybe encapsulate this logic in a new method on RootDomRenderObject, so node doesn't need to have a public setter.

Done. Also I noticed I could remove some dead code in RootDomRenderObject.

parlough · 2026-03-18T12:45:00Z

+
+  /// Reloads the current page.
+  void reload([String? path]) {
+    throw UnimplementedError('Should be overridden on client and server.');


It seems the client's AppContext extension doesn't have this method. Is that intended?

Ah no, that is leftover from I feature I was experimenting with but decided against for the initial version of server components. Will remove.

parlough · 2026-03-18T12:54:17Z

+    } else if (allowComponent &&
+        type.element.name == 'Component' &&
+        type.element.library.identifier == 'package:jaspr/src/framework/framework.dart') {
+      return (decoder: 'p.mount($argument)', cast: 'String');


What if the component parameter is nullable? Should this consider the nullability suffix like the above handling?

Kilian Schulte and others added 21 commits June 14, 2024 16:39

add server components setup

2b9bbfd

finish server components

497460f

update server_components experiment

9ad1735

Merge branch 'main' into feat/server-components

842b897

# Conflicts: # packages/jaspr/lib/src/browser/clients.dart # packages/jaspr_builder/lib/src/client/client_module_builder.dart

fix merge issues

35ce3d8

fixes

0f2d046

fix server comp experiment

a732436

fix nested client components

bb2e0d2

extend server component handling

4230c82

add stateful reload feature

6e499de

Merge branch 'main' into feat/server-components

0c0cbe2

add reload event handling

c08515a

add onReload feature

f0073ce

update experiment

7bb7ed6

Merge branch 'main' into feat/server-components

7053147

make reload private

2034181

parlough reviewed Mar 18, 2026

View reviewed changes

apply review

e46ec38

schultek force-pushed the feat/server-components branch from 38c987f to e46ec38 Compare March 18, 2026 14:11

		for (var i = 0; i < _adapters.length; i++) {
		final r = _adapters[i].prepare();

		rootRenderObject.node = newNode;
		rootRenderObject.toHydrate = [...newNode.childNodes.toIterable()];

Uh oh!

Conversation

schultek commented Mar 16, 2026

Description

Type of Change

Uh oh!

docs-page bot commented Mar 16, 2026

Uh oh!

github-actions bot commented Mar 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Package Version Report

Uh oh!

codecov bot commented Mar 16, 2026

Codecov Report

Uh oh!

parlough left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

schultek Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

parlough Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

schultek Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

parlough Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

schultek Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

parlough Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

schultek Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions bot commented Mar 16, 2026 •

edited

Loading

parlough Mar 18, 2026 •

edited

Loading