@webority/theme 0.9.17 → 0.9.18

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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority/theme",
-  "version": "0.9.17",
+  "version": "0.9.18",
   "description": "Webority shared design system — Bootstrap 5.3 SCSS overrides, --wui-* tokens, and shared component CSS. The single source of brand chrome for React portals and Razor sites.",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
@@ -33,6 +33,6 @@
     "sass-embedded": "^1.97.0"
   },
   "scripts": {
-    "build": "sass index.scss dist/webority-theme.css --load-path=node_modules --style=compressed --no-source-map --quiet-deps && node ../../scripts/sync-rcl-assets.mjs theme"
+    "build": "sass index.scss dist/webority-theme.css --load-path=node_modules --style=compressed --no-source-map --quiet-deps --silence-deprecation=if-function && node ../../scripts/sync-rcl-assets.mjs theme"
   }
 }

package/scss/wui/_controls.scss

@@ -1,4 +1,4 @@
-// Component classes use the .wui-* prefix.
+// Prefer .wui-* for new chrome; legacy bare names here are frozen until a BREAKING rename.
 // Checkbox & radio, field/input, status badge, choice chip.
 //
 // Part of the wui-components layer — see _wui-components.scss for the whole

package/scss/wui/_data.scss

@@ -1,4 +1,4 @@
-// Component classes use the .wui-* prefix.
+// Prefer .wui-* for new chrome; legacy bare names here are frozen until a BREAKING rename.
 // Empty state, base table, ledger table + pagination.
 //
 // Part of the wui-components layer — see _wui-components.scss for the whole

package/scss/wui/_overlays.scss

@@ -1,4 +1,4 @@
-// Component classes use the .wui-* prefix.
+// Prefer .wui-* for new chrome; legacy bare names here are frozen until a BREAKING rename.
 // Modal, confirm dialog.
 //
 // Part of the wui-components layer — see _wui-components.scss for the whole

package/scss/wui/_typography.scss

@@ -1,4 +1,4 @@
-// Component classes use the .wui-* prefix.
+// Prefer .wui-* for new chrome; legacy bare names here are frozen until a BREAKING rename.
 // Text-scale utilities.
 //
 // Part of the wui-components layer — see _wui-components.scss for the whole

package/scss/wui/_utilities.scss

@@ -1,4 +1,4 @@
-// Component classes use the .wui-* prefix.
+// Prefer .wui-* for new chrome; legacy bare names here are frozen until a BREAKING rename.
 // Grid utils, info tip, page header, row actions, spinner.
 //
 // Part of the wui-components layer — see _wui-components.scss for the whole