Skip to content

fix: forward HTML component inputs during SSR - #540

Merged
Mohamed Mansour (mohamedmansour) merged 5 commits into
mainfrom
mohamedmansour-fix-ssr-attribute-propagation
Sep 17, 2026
Merged

Mohamed Mansour (mohamedmansour) merged 5 commits into
mainfrom
mohamedmansour-fix-ssr-attribute-propagation

Conversation

@mohamedmansour

@mohamedmansour Mohamed Mansour (mohamedmansour) commented Sep 17, 2026 •

Copy link
Copy Markdown
Contributor

Summary

A bare component input such as <mai-drawer open aria-label="Canvas information"> remained on the host but did not supply the flag to the component's SSR state. ARIA inputs were also excluded from component scope.

This is now an HTML parser/renderer fix:

  • Forward valueless component inputs as presence flags using existing boolean fragments.
  • Preserve empty literal attributes and forward ARIA inputs through existing name mapping.
  • Keep ?open="{{open}}" behavior unchanged for true/false state.

The final diff is five files. The earlier JavaScript/decorator analysis and projection-manifest changes are removed. There are no protobuf, browser-runtime, package, or public-doc changes.

Validation

  • Native parser, handler and expression suites pass; Node package: 72 tests passed.
  • The actual drawer renders open, visible and named with JavaScript disabled and no projection manifest.
  • Unchanged actual drawer suite: 18 journeys run twice, 36/36 passed, including literal-open/name/content and false-state paths. Only the native addon was replaced; installed compiler/runtime and component code were unchanged.
  • Qualified addon: commit 7753b35874dc1d7e93861fa5b4cab76f3d858409, SHA-256 B2B86E644C7493957C994D3ACF34B504D15AD70EC7DB4A5022067FEAF3602806.
  • cargo xtask check passed in 154.1s using process-local TEMP/TMP on the worktree drive. The pre-existing Press default-temp cross-volume PROJ-C013 docs-build failure remains separate and unmodified.

Preserve literal boolean presence, empty and aliased inputs, and exact inbound decorator metadata through native/WASM builds. Keep inherited aliases authoritative during hydration without rebuilding server-rendered nodes.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Preserve empty literals without name-based boolean coercion. Use decoded attribute text and current projection proofs consistently, leaving boolean conversion to declared metadata and explicit bindings.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Keep WebUIFragmentAttribute unchanged, remove public-doc and per-attribute metadata additions, and prepare exact component bindings at protocol load. Preserve the MAI drawer no-JS and hydration behavior using declared aliases and modes.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Remove the protobuf extension and extra client metadata logic. Lower declared attributes at build time using existing fragments and preserve the actual MAI drawer SSR and hydration behavior.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Remove the added decorator/projection analysis. Pass valueless component inputs as presence flags, forward ARIA inputs through existing scope handling, and preserve empty literals without changing conditional true/false behavior.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@mohamedmansour Mohamed Mansour (mohamedmansour) changed the title fix: preserve component attributes during SSR fix: forward HTML component inputs during SSR Sep 17, 2026
Comment thread crates/webui-parser/src/lib.rs
@mohamedmansour
Mohamed Mansour (mohamedmansour) merged commit 32a29f7 into main Sep 17, 2026
35 checks passed
@mohamedmansour
Mohamed Mansour (mohamedmansour) deleted the mohamedmansour-fix-ssr-attribute-propagation branch September 17, 2026 17:08
Mohamed Mansour (mohamedmansour) added a commit that referenced this pull request Sep 18, 2026
## Release

Bumps WebUI to `0.0.29`.

Previous release tag: `v0.0.28`

## Changes since `v0.0.28`

Features:

- Ship version-matched AI authoring guidance with `@microsoft/webui`,
using a lightweight skill that reads the installed package's reference
(feat: bundle versioned AI guidance with WebUI #522 by @mohamedmansour).
- Add plugin-aware component discovery, with filename-based HTML
components and manifest-driven FAST components (feat: add plugin-aware
component discovery #524 by @mohamedmansour).
- Add WebUI Press `--show=all|content` for shell-free documentation
views that preserve SSR, hydration, authored examples, and accessible
theme behavior (feat: add WebUI Press content mode #525 by
@mohamedmansour).
- Automatically support Trusted Types for compiled templates and
generated CSS import maps without promoting arbitrary state HTML to
trusted content (feat: use Trusted Types automatically in the framework
#536 by @mohamedmansour).
- Keep explicit streaming imports lightweight so applications can load
streaming support early and application code later (feat: keep explicit
streaming imports lightweight #539 by @mohamedmansour).
- Render tree-shaped state with file-scoped named `<for id="...">`
bodies, including forward references and recursive reuse without extra
client runtime code. Use unbraced `each="item in items"`; the legacy
`template` spelling and FAST component references produce actionable
diagnostics (feat: add file-scoped recursive for loops #547 by
@mohamedmansour).

Fixes:

- Preserve table-rooted hydration ownership and correctly compile
whitespace-bearing, nested directives, preventing duplicate controls
after reactive updates. Rebuild templates to receive the compiler fix
(fix: preserve table-rooted hydration paths #512 by @mohamedmansour;
fix: align client directive parsing with the HTML scanner #531 by
@mohamedmansour).
- Emit reachable stylesheets and templates in deterministic traversal
order. External plugin implementations must adapt the affected
`HandlerPlugin` and bootstrap component collection interfaces from hash
sets to slices (fix: render reachable-component ordering
deterministically #519 by @janechu).
- Resolve bare CEM module specifiers through their owning packages,
respecting export maps, package boundaries, and cache invalidation when
nearer dependencies appear (fix: resolve bare CEM module specifiers #528
by @janechu).
- Prevent spurious dev-server rebuilds from read-only filesystem
activity and recursive traversal of linked workspace dependencies
(Improve benchmark telemetry and dev-server watching #521 by
@mohamedmansour).
- Update rustls to address TLS 1.3 handshake encryption-level validation
advisory RUSTSEC-2026-0285 (fix: update rustls to address
RUSTSEC-2026-0285 #533 by @mohamedmansour).
- Forward bare boolean and ARIA component inputs into SSR state while
preserving empty literal attributes and existing conditional boolean
bindings (fix: forward HTML component inputs during SSR #540 by
@mohamedmansour).
- Preserve sibling route declaration order across SSR and client routing
so equally specific routes select the correct pending and error
boundaries (fix: preserve route order for pending and error boundaries
#541 by @mohamedmansour).
- Handle skipped or superseded router view transitions without unhandled
animation rejections, while preserving route-commit errors and
responsive subsequent navigation (fix: handle router view transition
rejections #543 by @mohamedmansour).
- Wait for active dev-server rebuilds and their bundler subprocesses
before graceful shutdown, preventing output writes after the server
exits (fix: wait for dev-server rebuilds during shutdown #546 by
@mohamedmansour).
- Preserve global theme defaults when custom properties are overridden
only by scoped selectors or conditional rules, so unmatched component
instances retain their intended colors (fix: preserve theme defaults
under scoped CSS overrides #548 by @mohamedmansour).

Docs:

- Add a data-driven Benchmark Explorer, centralize performance guidance,
distinguish independent SSR/browser metrics, and publish resource
telemetry with accessible methodology details (docs: centralize
performance guidance and benchmark data #486 by @mohamedmansour; Improve
benchmark telemetry and dev-server watching #521 by @mohamedmansour).
- Update AI reference installation and migration guidance while
retaining `/ai`, and clarify plugin-specific discovery and FAST
converted-template requirements (feat: bundle versioned AI guidance with
WebUI #522 by @mohamedmansour; feat: add plugin-aware component
discovery #524 by @mohamedmansour).
- Document owned Rust partial rendering, streaming state ownership, and
watcher hashing benchmarks, including measurement scope and tradeoffs
(perf: reduce partial response allocations #510 by @mohamedmansour;
perf: move streaming command processing off async workers #529 by
@mohamedmansour; perf: bound watcher hashing memory with reusable
scratch #530 by @mohamedmansour).
- Document automatic Trusted Types support, CSP enforcement, and
first-declared precedence for equally specific routes and their
pending/error boundaries (feat: use Trusted Types automatically in the
framework #536 by @mohamedmansour; fix: preserve route order for pending
and error boundaries #541 by @mohamedmansour).
- Explain named recursive loops and their compatibility limits, scoped
CSS token defaults, and router view-transition error handling (feat: add
file-scoped recursive for loops #547 by @mohamedmansour; fix: preserve
theme defaults under scoped CSS overrides #548 by @mohamedmansour; fix:
handle router view transition rejections #543 by @mohamedmansour).

Maintenance:

- Reduce partial-response and per-render allocations through owned state
projection, borrowed graph traversal, scalar formatting, and borrowed
nested route trees. Rust callers use ownership-taking
`Protocol::render_partial(Value, ...)`; JSON boundaries retain
`render_partial_json` (perf: reduce partial response allocations #510 by
@mohamedmansour; perf: cut per-render handler allocations #511 by
@mohamedmansour; perf: avoid cloning nested route trees #513 by
@mohamedmansour).
- Move streaming command deserialization, validation, and default
preparation onto the existing blocking renderer, transferring owned
records and state rather than cloning retained projections (perf: move
streaming command processing off async workers #529 by @mohamedmansour).
- Bound watcher hashing content storage to one reusable 8 KiB buffer
instead of repeated file-sized allocations while preserving invalidation
behavior (perf: bound watcher hashing memory with reusable scratch #530
by @mohamedmansour).
- Parallelize release WASM builds and artifact staging, and consolidate
dependency scanning before release jobs (chore: parallelize release
pipeline work #509 by @mohamedmansour).
- Refresh compatible Rust and JavaScript dependencies and migrate
repository tooling and CI to pnpm 12.3.4 while preserving existing audit
constraints (chore: update dependencies to latest compatible versions
#534 by @mohamedmansour).

## Validation

- `cargo xtask check`
- `pnpm --dir crates/webui-press test` (16 passed).
- `pnpm --dir packages/webui-framework exec playwright test
recursive-repeat --workers=2 --reporter=line` (6 passed).
- `pnpm --dir packages/webui-router exec playwright test --grep "view
transition rejection ownership" --workers=2 --reporter=line` (4 passed).

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
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.

2 participants