declarative-forms 2.0.0 → 2.0.1

package/CHANGELOG.md

@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+The next release is a **major** one: the stylesheet you get by default changes.
+
+### Changed
+
+- **Breaking: `declarative-forms/styles.css` is now the modern theme.** It was
+  the v1 look; the modern light/dark redesign that 2.0 shipped as an opt-in
+  `theme.css` is what a plain `styles.css` import renders from now on. A first
+  install should look current without having to find a second import.
+- **The v1 look moved to `declarative-forms/classic.css`.** It is byte-for-byte
+  the same stylesheet, still tokenised, still shipped. Installations whose
+  overrides were written against it need a one-word import change.
+- `declarative-forms/assets/default.css` — the v1 export path — now maps to
+  `classic.css`, which is the file it always rendered. A migration that kept
+  that path sees no change at all.
+- `declarative-forms/theme.css` still resolves, now to the same file as
+  `styles.css`, so a 2.0 opt-in import keeps working. Prefer `styles.css`.
+- Consequently, **checkboxes are keyboard-reachable by default**: the input is
+  styled with `appearance: none` rather than hidden behind a pseudo-element.
+  `classic.css` keeps the old, unreachable markup.
+
+### Migration
+
+- Want the new look: change nothing.
+- Want the old look: `import 'declarative-forms/classic.css'` instead of
+  `styles.css`.
+- Overrides that assumed the classic geometry (400px fields, 416px dialogs) or
+  painted the checkbox pseudo-element need either `classic.css` or the
+  `--dl-field-width` / `--dl-modal-width` tokens. See
+  [Themes](https://wolfoo2931.github.io/declarative-forms/guide/theme).
+
+## [2.0.0] — 2026-08-16
+
 ### Added
 
 - A second stylesheet, `declarative-forms/theme.css`: a modern redesign with
@@ -111,5 +143,6 @@ keep working. See the [migration guide](https://wolfoo2931.github.io/declarative
 - Buttons flashed disabled on every keystroke, and a well-timed click could be
   dropped.
 
-[Unreleased]: https://github.com/wolfoo2931/declarative-forms/compare/v2.0.0-alpha.0...HEAD
+[Unreleased]: https://github.com/wolfoo2931/declarative-forms/compare/v2.0.0...HEAD
+[2.0.0]: https://github.com/wolfoo2931/declarative-forms/compare/v2.0.0-alpha.0...v2.0.0
 [2.0.0-alpha.0]: https://github.com/wolfoo2931/declarative-forms/releases/tag/v2.0.0-alpha.0

package/README.md

@@ -104,12 +104,17 @@ This is why the project feels more like a small “form engine” than a typical
 npm install declarative-forms
 ```
 
-And include the default CSS:
+And include the stylesheet:
 
 ```ts
 import 'declarative-forms/styles.css';
 ```
 
+That is the default look — a modern theme that follows the operating system's
+light/dark setting. The v1 look is still shipped as
+`declarative-forms/classic.css` for installations with overrides written
+against it.
+
 ## Example: modal form
 
 ```ts
@@ -186,7 +191,7 @@ Full documentation is at **[wolfoo2931.github.io/declarative-forms](https://wolf
 
 Worth knowing before you adopt it:
 
-- **Accessibility is a work in progress.** Labels, ids and focusable buttons are correct; dialog semantics, combobox ARIA and keyboard-reachable checkboxes are not there yet. The [accessibility page](https://wolfoo2931.github.io/declarative-forms/accessibility) lists every known gap.
+- **Accessibility is a work in progress.** Labels, ids, focusable buttons and — under the default stylesheet — keyboard-reachable checkboxes are correct; dialog semantics and combobox ARIA are not there yet. The [accessibility page](https://wolfoo2931.github.io/declarative-forms/accessibility) lists every known gap.
 - **There is no validation framework.** `isActive` handles conditional fields and button predicates gate submission, but there is no rule engine or error-message system.
 - **The rendered DOM is a frozen contract.** Class names, ids and structure are stable across the v1 → v2 rewrite, so existing stylesheets keep working. See the [DOM contract](https://wolfoo2931.github.io/declarative-forms/dom-contract).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "declarative-forms",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Declarative, data-driven form dialogs for the web. Zero dependencies, framework agnostic, with async options, cross-field reactivity, tabs and modal stacking.",
   "type": "module",
   "sideEffects": [
@@ -17,8 +17,9 @@
       "require": "./dist/index.cjs"
     },
     "./styles.css": "./styles/declarative-forms.css",
-    "./theme.css": "./styles/theme.css",
-    "./assets/default.css": "./styles/declarative-forms.css",
+    "./theme.css": "./styles/declarative-forms.css",
+    "./classic.css": "./styles/classic.css",
+    "./assets/default.css": "./styles/classic.css",
     "./package.json": "./package.json"
   },
   "files": [