Skip to content

feat: configure streamed hydration behavior#7557

Open
janechu wants to merge 2 commits into
releases/fast-element-v3from
users/janechu/do-not-noop-hydration-logic-add-config
Open

feat: configure streamed hydration behavior#7557
janechu wants to merge 2 commits into
releases/fast-element-v3from
users/janechu/do-not-noop-hydration-logic-add-config

Conversation

@janechu
Copy link
Copy Markdown
Collaborator

@janechu janechu commented Jun 2, 2026

Pull Request

📖 Description

Adds hydration configuration for streamed Declarative Shadow DOM:

  • Adds noopAfterHydrationComplete to enableHydration() so streaming apps can keep hydration active after the initial batch.
  • Preserves the default behavior of no-oping for later prerendered batches after hydrationComplete.
  • Adds tests and an ecosystem fixture for late-appended hydratable DSD with reactive binding updates.
  • Updates README, design/API docs, website docs, export sizes, and Beachball change file.

👩‍💻 Reviewer Notes

Please review the default no-op behavior versus noopAfterHydrationComplete: false for streamed DSD scenarios.

📑 Test Plan

  • npm run build
  • npm run biome:check
  • npm run checkchange
  • npx playwright test src/components/hydration.pw.spec.ts from packages/fast-element
  • npx playwright test --config=playwright.declarative.config.ts test/declarative/fixtures/ecosystem/hydration-config/hydration-config.spec.ts from packages/fast-element
  • npm run test ❌ failed in @microsoft/fast-test-harness Firefox tests with 5s navigation/setup timeouts unrelated to the hydration changes.

✅ Checklist

General

  • I have included a change request file using $ npm run change
  • I have added tests for my changes.
  • I have tested my changes.
  • I have updated the project documentation to reflect my changes.
  • I have read the CONTRIBUTING documentation and followed the standards for this project.

janechu and others added 2 commits June 1, 2026 20:52
Add a hydration configuration option that keeps the hydration hook active for streamed Declarative Shadow DOM after the initial hydration batch.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@janechu janechu marked this pull request as ready for review June 2, 2026 20:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant