humanspeak / svelte-motion

69%

main: 3%

push

github

feat(docs): migrate examples to ExampleV2 chrome (batch 1: standalones) (#357)

* feat(docs): adopt ExampleV2 + demoManifestPlugin chrome — pilot variants-while-hover

Phase 2 foundation + first migrated example. Establishes the per-page
template the remaining ~30 examples will follow.

Foundation:
- `docs/vite.config.ts` registers `demoManifestPlugin({ stripComments,
  stripWrappers })` from docs-kit `2026.5.29`. The plugin pre-renders
  every `src/lib/examples/<slug>/demos/*.svelte` with Shiki and emits
  `src/lib/demo-manifest.json` (now gitignored, regenerated on every
  build / dev start). Marker-based strip options let demo files carry
  a positioning shell + maintainer notes without leaking either into
  the published code panel.
- `docs/src/routes/examples/+layout.svelte` swaps the raw
  `HeaderV2`/`FooterV2` chrome for `ExampleLayoutV2`, which provides
  the `.brut-wrap` surface (`--brut-bg`, `--brut-rule`, etc.) that
  every `ExampleV2` sheet needs to render its hairline-bordered card.
  `enhanceCodeBlocks` decorates inline `<code>` chips in the lede /
  notes columns. Surgical `:global(.dk-ex-body) { flex: 1 1 auto }`
  override forces the body to claim remaining panel height — without
  it the footer strip floats mid-panel whenever the lede column is
  taller than an intrinsically-sized demo (TODO: upstream as a
  docs-kit fix).

Pilot — `variants-while-hover`:
- New `docs/src/lib/examples/variants-while-hover/demos/{InlineForm,
  VariantKey}.svelte` — one demo file per sheet section, each
  authoring exactly the lesson code (no docs-kit imports). Both carry
  a `.humanspeak-demo-shell` flex-centering wrapper with a
  `<!-- HUMANSPEAK: ... -->` comment explaining why; both vanish from
  the published manifest via docs-kit's `stripWrappers` +
  `stripComments` + `stripOrphanCSSRules`.
- `docs/src/routes/examples/variants-while-hover/+page.svelte`
  rewritten to the sheet-section pattern: a `sections[]` array
  driving `ExampleV2` instances ... (continued)

481 of 634 branches covered (75.87%)

Branch coverage included in aggregate %.

1812 of 2686 relevant lines covered (67.46%)

10.92 hits per line