Skip to content

Explain DOMStack build and watch architecture in a blog post - #338

Draft
bcomnes wants to merge 4 commits into
masterfrom
docs/build-watch-architecture
Draft

bcomnes wants to merge 4 commits into
masterfrom
docs/build-watch-architecture

Conversation

@bcomnes

@bcomnes bcomnes commented Sep 19, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a draft blog post explaining how DOMStack organizes page building, global data, and watch mode around clear responsibilities and lifetimes. Four Mermaid diagrams illustrate component ownership, the page pipeline, global-data boundaries, and watch recovery.

The post remains unpublished pending review. Its diagrams have a wider layout and scale to fit smaller screens while prose stays narrow. A page-scoped client bundle shares the existing Mermaid configuration and theme-aware styles with the implementation docs; no new dependency is needed.

Adds visible Draft badges to blog post headers, the index, and yearly archives. Published posts remain unbadged, and badges work without JavaScript.

Validation

  • Six blog unit tests passed, including draft-only badges in index and archive output.
  • Browser checks passed for diagrams, light/dark themes, responsive sizing, the no-JavaScript fallback, draft badges, and draft exclusion from production output and feeds. Existing documentation diagrams were also checked after sharing their assets.
  • TypeScript and diff checks passed. Full ESLint passed for the original changes; targeted ESLint passed for the follow-up changes.
  • Editor diagnostics reported two existing errors in unchanged tools/blog/shared.ts; those are outside this change.

@coveralls

coveralls commented Sep 19, 2026

Copy link
Copy Markdown

Coverage Report for CI Build 35462223094

Warning

No base build found for commit e0364f6 on master.
Coverage changes can't be calculated without a base build.
If a base build is processing, this comment will update automatically when it completes.

Coverage: 96.752%

Details

  • Patch coverage: 1 of 1 lines across 1 file are fully covered (100%).

Uncovered Changes

No uncovered changes found.

Coverage Regressions

Requires a base build to compare against. How to fix this →


Coverage Stats

Coverage Status
Relevant Lines: 12061
Covered Lines: 11810
Line Coverage: 97.92%
Relevant Branches: 4105
Covered Branches: 3831
Branch Coverage: 93.33%
Branches in Coverage %: Yes
Coverage Strength: 892.33 hits per line

💛 - Coveralls

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