@webority/theme 0.9.17 → 0.9.19

package/README.md

@@ -87,6 +87,22 @@ Token remap includes:
 Marketing sites ship light-only (the `scss/_marketing.scss` partial is opt-in on portals
 and omitted on marketing); dark mode is a **portal feature**, not a marketing requirement.
 
+## Public CSS class vocabulary
+
+Theme-owned class names follow one rule going forward. Enforced by
+`scripts/check-scss-class-prefix.mjs` (frozen legacy allowlist + fail on new bare names).
+
+| Class kind | Allowed for **new** chrome? | Notes |
+|---|---|---|
+| Bootstrap public classes (`.btn`, `.form-control`, `.card`, …) | **Yes** | Restyle Layer A only — do not fork a second kit |
+| `.wui-*` | **Yes — default** | All new library chrome |
+| `.app-*` | Legacy only | Shell / host wrappers already shipped; prefer `.wui-*` for anything new |
+| Bare generics (`.input`, `.search-select`, `.datepicker`, `.tbl-*`, …) | Legacy only | Frozen allowlist; no new top-level bare selectors |
+| Marketing bare (`.section-y`, `.btn-pill`, …) | Opt-in `_marketing.scss` only | Documented marketing vocabulary; portals omit the import |
+
+Renames of legacy bare names are **BREAKING**: remove the old class, list the new name in
+`CHANGELOG.md`, no dual-class shim. Consumers update markup on the bump.
+
 ## Library vs product ownership
 
 Three layers. Do not collapse product art direction into the shared package.