humanspeak / svelte-markdown

94%

main: 81%

push

github

refactor(docs): adopt docs-kit V2 shells + shared brutalist palette (#295)

* refactor(docs): adopt docs-kit V2 shells + shared brutalist palette

Migrates `/docs`, `/compare`, and `/examples` layouts to the new
DocsLayoutV2 + CompareLayoutV2 + HeaderV2/FooterV2 primitives in
@humanspeak/docs-kit@2026.5.17. The hand-rolled chrome on each
layout collapses to ~15-50 lines of configuration; the boilerplate
(breadcrumbs, TechArticle + FAQPage JSON-LD, headings extraction
with afterNavigate refresh, the full sidebar/article/TOC shell)
now lives in docs-kit and benefits every Humanspeak docs site.

Changes:

- `docs/src/routes/docs/+layout.svelte` — DocsLayoutV2 with FAQ
  Q&A passed through as a prop (four canonical disambiguation Qs
  per .notes/SEO.md P2), sitemap manifest for `dateModified`, and
  the existing `buildBreadcrumbs` resolver.
- `docs/src/routes/compare/+layout.svelte` — CompareLayoutV2 with
  the compare-specific breadcrumb resolver.
- `docs/src/routes/examples/+layout.svelte` — HeaderV2 / FooterV2.
- `docs/src/app.css` — imports `docs-kit/styles/brutalist.css` and
  `prose-v2.css`. The inline `.brut` token block in
  `/+page.svelte` is gone; the homepage now picks them up from the
  shared stylesheet.
- `docs/package.json` — `@humanspeak/docs-kit` bumped to
  `#2026.5.17` (adds DocsLayoutV2/CompareLayoutV2, the brutalist
  palette, prose-v2, svelte-motion animations on code-block copy
  buttons, and several effect cycle fixes in TableOfContentsV2 +
  DocsLayoutV2 that surfaced during this migration).

Verified: `/`, `/docs/getting-started`, `/compare/vs-mdsvex`, and
`/examples` all render 200 with zero console errors. Copy-button
spring lift + tap-down + success-bounce ride through to every doc
page via the action.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(mprocs): wipe vite + svelte-kit caches before dev start

Mirrors the pattern in svelte-motion's mprocs.yaml: prepend
`rm -rf .svelte-kit node_modules... (continued)

573 of 653 branches covered (87.75%)

Branch coverage included in aggregate %.

1059 of 1089 relevant lines covered (97.25%)

5273.44 hits per line