actual-css 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -4,7 +4,59 @@ All notable changes will be documented here.
 
 This project follows Keep a Changelog and uses semver, including during 0.x.
 
-## [0.1.0] - Unreleased
+## [0.2.0] - 2026-07-28
+
+### Added
+- Enhancement contract: `class` = presentation, `data-enhance` = behaviour,
+  ARIA/HTML = semantics, `data-*` = configuration.
+- `enhancementSelector()`, `hasEnhancement()`, `registerEnhancement()` in
+  `actual-css/js/enhance`.
+- Primitive subpath exports: `events`, `focus`, `keys`, `menu`, `surface`.
+- `.alert.callout` — neutral surface with inset intent accent band.
+- `.alert.admonition` + `.alert-title` / `.alert-body` — structured anatomy.
+- `.scroller.stable-gutter` — opt-in `scrollbar-gutter: stable`.
+- `--shadow-xs` and two-layer `--shadow` token.
+- `data-scrollspy-offset` attribute with deterministic geometry-based
+  activation (pixels or percentage, replaces IntersectionObserver).
+- Widget primitives catalogue (`docs/design-notes/widget-primitives.md`).
+- `.range` — fully custom-styled range slider (`appearance: none`) with
+  intent-tinted thumb, focus ring on the thumb surface, and disabled state.
+- `check:enhance` guardrail script.
+
+### Changed
+- Behaviour discovery moved from presentation classes to `data-enhance` tokens
+  (`tabs`, `flyout`, `scrollspy`, `validation`). The old classes remain valid
+  for presentation-only or CSS-only modes.
+- `status.js` now resolves its target via `[data-status][role="status"]` instead
+  of `.status-bar[data-status]`.
+- `.badge` is soft by default; use `.solid` for counters. `:empty` dots
+  unchanged.
+- `.btn` gap tightened to `0.375em` and weight to `--font-weight-medium`.
+- `.spinner` default size is `1em` (was `1.5rem`), `.sm` = `0.75em`,
+  `.lg` = `2rem`.
+- `--shadow` is a two-layer shadow (was single-layer), `--shadow-popout`
+  unchanged.
+- Focus ring is now neutral (`--neutral:focus`), with a single consistent recipe
+  across all interactive controls. `forced-colors` fallback is centralised, and
+  theme-specific exceptions (Edge) removed.
+- `selectors.js` holds written-state vocabulary only (discovery entries removed).
+- `surface.js` owns its own teardown via `data-actual-surface` marker and
+  per-document binding.
+
+### Fixed
+- Menu-item detection no longer matches items of a neighbouring surface (D11).
+- Keyboard navigation and click-autoclose work on surfaces with custom CSS.
+- Orphaned mounted surfaces close when their trigger/context target is removed (D9).
+- `surface.js` teardown and outside-click listener bind per owning document (D22).
+
+### Removed
+- `FormValidator.init()` default selector changed from `.needs-validation` to
+  the `data-enhance="validation"` token. The live opt-out (removing the class
+  from a connected form) is gone — the marker is read once at connect.
+- Five runtime `.needs-validation` re-checks removed — `init(customSelector)`
+  now actually works.
+
+## [0.1.0] - 2025-04
 
 - Initial pre-1.0 package surface.
 - Public class grammar, theme contract, runtime DOM tests, and build guardrails.

package/README.md

@@ -109,6 +109,8 @@ Browse [`src/css/optional/`](src/css/optional/) for available modules such as cu
 
 Some components can be enhanced with JavaScript: dialog/drawer, flyout, tooltip, tabs, scrollspy, context menu, floating UI, opt-in `data-filter` input filtering, and input masks.
 
+In 0.2, presentation (`class`) and behaviour (`data-enhance`) are separate layers — import any primitive independently to build custom widgets. See [enhancement contract](docs/design-notes/enhancement-contract.md) and [widget primitives](docs/design-notes/widget-primitives.md).
+
 Use the full module:
 
 ```html