Changeset 0.31.1 (#204)

Co-authored-by: Jeffrey Smith <jasafpro@gmail.com>
Co-committed-by: Jeffrey Smith <jasafpro@gmail.com>

CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [0.31.1] — 2026-03-18
+
+### Summary
+
+SDK Exercise Surface: fixes 4 SDK bugs (flyout unification, overflow
+clipping, menu system split, ChatPane standalone gap), then proves them
+fixed with a dashboard package exercising every `sw.*` primitive with
+zero component CSS overrides.
+
+### Fixed
+
+- **Flyout unification** — 3 competing CSS systems (layout.css,
+  user-menu.css, primitives.css) consolidated into `.sw-menu-flyout`
+  in primitives.css. UserMenu now shares the same flyout class and
+  `data-position` attribute as `sw.menu()`.
+- **Flyout positioning** — `position:fixed` escape hatch for flyouts
+  inside `overflow:hidden` extension surface containers. Shared
+  `_positionFlyout` helper wired into both `sw.menu()` and
+  `sw.userMenu()`.
+- **ChatPane standalone** — `ChatPane.mount()` with `standalone: true`
+  now provides complete chat (textarea, model selector, history,
+  streaming, channel creation). Editor package slimmed ~220 lines.
+- **Flyout text contrast** — menu items used `--text-2` (#9898a8)
+  against `--bg-elevated` (#42424e), giving ~2.8:1 contrast ratio.
+  Bumped to `--text` (#e8e8ed) for ~5.5:1 (WCAG AA compliant).
+
+### New
+
+- **Dashboard `.pkg`** — `packages/dashboard/` exercises all 14 SDK
+  primitives: userMenu, menu, toolbar, tabs, dropdown, chat, notes,
+  modal, confirm, toast, on/emit, api, user/isAdmin, theme.
+- **E2E tests** — `crud/dashboard-package.js` — install, settings,
+  export/import round-trip (7 tests).
+
 ## [0.31.0] — 2026-03-18
 
 ### Summary