@wpmoo/ui 0.8.1 → 0.9.0

package/README.md

@@ -140,13 +140,14 @@ recipes, load order, and troubleshooting.
 | `@wpmoo/ui/context-menu.js` | Optional Context Menu ESM lifecycle |
 | `@wpmoo/ui/datatable.js` | Optional DataTable ESM lifecycle |
 | `@wpmoo/ui/sidebar.js` | Optional Sidebar ESM lifecycle |
+| `@wpmoo/ui/scss/facade-settings` | Public Sass variable allow-list (LibSass `@import`) |
 | `@wpmoo/ui/certification.json` | Versioned support/evidence manifest |
 | `@wpmoo/ui/package.json` | Package metadata |
 
 The tarball also contains `README.md`, `LICENSE`, and `ASSET_LICENSE.md`. It
-does not publish catalog templates, preview artwork, catalog JavaScript, SCSS
-source, or a Sass facade. Internal Sass partials and
-Jinja macros are repository build tools, not npm APIs.
+does not publish catalog templates, preview artwork, catalog JavaScript, or
+internal SCSS partials beyond the facade's required settings import. Internal
+Sass partials and Jinja macros are repository build tools, not npm APIs.
 
 ## Why Bootstrap Teams Try It
 
@@ -174,7 +175,7 @@ are not part of the npm package.
 
 ## Status And Support
 
-Moo UI is in the `0.x` series. Current package: `@wpmoo/ui@0.8.1`. The
+Moo UI is in the `0.x` series. Current package: `@wpmoo/ui@0.9.0`. The
 package's certification manifest currently has `preview` status; catalog
 availability is WPMoo-maintained preview evidence, not independent or
 accredited certification. Read [Support & Evidence](https://ui.wpmoo.org/support/)

package/certification.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "0.1",
   "status": "preview",
-  "coreVersion": "0.8.1",
+  "coreVersion": "0.9.0",
   "bootstrap": {
     "canonicalVersion": "5.3.3",
     "targetRange": ">=5.3.0 <5.4",
@@ -26,7 +26,7 @@
       "./context-menu.js",
       "./datatable.js"
     ],
-    "sass": []
+    "sass": ["./scss/facade-settings"]
   },
   "supportPolicy": "https://github.com/wpmoo-org/ui/blob/main/SUPPORT.md"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wpmoo/ui",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Bootstrap markup. shadcn feel. A frontend-framework-free component system for server-rendered apps.",
   "license": "MIT",
   "author": "WPMoo (https://wpmoo.org)",
@@ -31,6 +31,7 @@
     "./sidebar.js": "./dist/js/sidebar.js",
     "./context-menu.js": "./dist/js/context-menu.js",
     "./datatable.js": "./dist/js/datatable.js",
+    "./scss/facade-settings": "./scss/_facade-settings.scss",
     "./certification.json": "./certification.json",
     "./package.json": "./package.json"
   },
@@ -43,6 +44,8 @@
     "dist/js/sidebar.js",
     "dist/js/context-menu.js",
     "dist/js/datatable.js",
+    "scss/_facade-settings.scss",
+    "scss/settings/_facade_public.scss",
     "certification.json",
     "README.md",
     "LICENSE",

package/scss/_facade-settings.scss

@@ -0,0 +1,51 @@
+// Moo UI — Public Sass Facade: Settings
+//
+// This is the consumer-facing subset of Moo UI's Sass variables.
+// Import this file BEFORE Bootstrap's _variables.scss so your overrides
+// take precedence over Bootstrap's own !default values.
+//
+// Usage (relative-path, Bootstrap Option B pattern):
+//   @import "../node_modules/bootstrap/scss/functions";
+//   @import "../node_modules/@wpmoo/ui/scss/facade-settings";
+//   $primary: #your-brand-color;
+//   @import "../node_modules/bootstrap/scss/variables";
+//   ...
+//
+// Usage (include_paths-based, bundler-configured):
+//   @import "bootstrap/scss/functions";
+//   @import "@wpmoo/ui/scss/facade-settings";
+//   $primary: #your-brand-color;
+//   @import "bootstrap/scss/variables";
+//   ...
+//
+// Public variable allow-list (0.9.0):
+//
+//   Brand colors — any valid Sass color value:
+//     $primary        Default: #171717
+//     $secondary      Default: #f4f4f5
+//     $success        Default: #16803c
+//     $info           Default: #0f6e8c
+//     $warning        Default: #a15c00
+//     $danger         Default: #dc2626
+//     $light          Default: #fafafa
+//     $dark           Default: #18181b
+//
+//   Body — any valid Sass color value:
+//     $body-color     Default: #18181b
+//     $body-bg        Default: #fff
+//
+//   Borders — any valid Sass color (border-color) or CSS <length> (radius):
+//     $border-color   Default: #e4e4e7
+//     $border-radius  Default: 0.5rem
+//     $border-radius-sm  Default: 0.375rem
+//     $border-radius-lg  Default: 0.625rem
+//
+//   Typography — rem/em/unitless ratio (same constraint as Bootstrap's
+//   $font-size-base; see vendor/bootstrap/scss/_variables.scss):
+//     $font-size-base Default: 0.875rem
+//
+// Derived tokens ($moo-*) are computed from the above and are not part of
+// the public facade. Component-level knobs ($moo-*-dark, $moo-sidebar,
+// etc.) are internal and may change without notice.
+
+@import "settings/facade_public";

package/scss/settings/_facade_public.scss

@@ -0,0 +1,23 @@
+// Public Sass facade allow-list — the only variables a facade consumer can
+// override. This file is the source of truth for the public Sass surface.
+// _palette.scss imports this first, then declares its own internal additions.
+// Do NOT add variables here without updating the freeze document
+// (src/certification/api-freeze-0.9.0.json) and getting explicit approval.
+
+$primary: #171717 !default;
+$secondary: #f4f4f5 !default;
+$success: #16803c !default;
+$info: #0f6e8c !default;
+$warning: #a15c00 !default;
+$danger: #dc2626 !default;
+$light: #fafafa !default;
+$dark: #18181b !default;
+
+$body-color: #18181b !default;
+$body-bg: #fff !default;
+$font-size-base: 0.875rem !default;
+
+$border-color: #e4e4e7 !default;
+$border-radius: 0.5rem !default;
+$border-radius-sm: 0.375rem !default;
+$border-radius-lg: 0.625rem !default;