docs: add roadmap.

README.md

@@ -13,7 +13,7 @@
 - **Loader + CLI**: Ship CSS at runtime via `?knighted-css` loader queries or ahead of time via the `css()` API and the `knighted-css-generate-types` command.
 - **Shadow DOM + SSR ready**: Inline styles in server renders, ship them alongside web components, or keep classic DOM apps in sync—all without wiring a full bundler.
 
-See the [docs/](./docs) directory for deep dives on loaders, type generation, specificity boosts, Sass aliases, and the combined import queries.
+See the [docs/](./docs) directory for deep dives on loaders, type generation, specificity boosts, Sass aliases, the combined import queries, and the current [2026 roadmap](./docs/roadmap.md).
 
 ## Workspaces in this repo
 

docs/roadmap.md

@@ -0,0 +1,17 @@
+# 2026 Roadmap
+
+## DX-Focused Hot Module Replacement _(minor-safe)_
+
+- Detect CSS-only updates via existing `moduleInfo` default-export signals.
+- Swap the updated `knightedCss` string into live `CSSStyleSheet` instances without rerendering component trees.
+- Expose helper hooks (e.g., via `asKnightedCssCombinedModule`) so framework adapters can opt in incrementally.
+
+## Type Pipeline Cleanup
+
+- Remove the triple-slash references from `types.d.ts` for v2.0, replacing them with standard ESM import/export wiring.
+- Ensure the new pipeline preserves the current downstream behavior for 1.x users via a documented migration path.
+
+## Lightning CSS Dependency Strategy
+
+- Evaluate promoting `lightningcss` to a peer dependency so consumers can align with their own upgrade cadence.
+- Document fallbacks for specificity workflows if teams opt to satisfy the peer via compatible forks or alternative transformers.