bitwrench 2.0.24 → 2.0.25

package/dist/bitwrench-util-css.cjs.js

@@ -1,4 +1,4 @@
-/*! bitwrench-util-css v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench-util-css v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 'use strict';
 
 Object.defineProperty(exports, '__esModule', { value: true });

package/dist/bitwrench-util-css.cjs.min.js

@@ -1,4 +1,4 @@
-/*! bitwrench-util-css v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench-util-css v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 "use strict";
 /**
  * bitwrench-util-css.js - Rule-based CSS utility parser plugin

package/dist/bitwrench-util-css.es5.js

@@ -1,4 +1,4 @@
-/*! bitwrench-util-css v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench-util-css v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
   typeof define === 'function' && define.amd ? define(['exports'], factory) :

package/dist/bitwrench-util-css.es5.min.js

@@ -1,4 +1,4 @@
-/*! bitwrench-util-css v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench-util-css v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 !function(t,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((t="undefined"!=typeof globalThis?globalThis:t||self).bwUtilCSS={})}(this,function(t){"use strict";function n(t){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},n(t)}
 /**
    * bitwrench-util-css.js - Rule-based CSS utility parser plugin

package/dist/bitwrench-util-css.esm.js

@@ -1,4 +1,4 @@
-/*! bitwrench-util-css v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench-util-css v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 /**
  * bitwrench-util-css.js - Rule-based CSS utility parser plugin
  *

package/dist/bitwrench-util-css.esm.min.js

@@ -1,4 +1,4 @@
-/*! bitwrench-util-css v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench-util-css v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 /**
  * bitwrench-util-css.js - Rule-based CSS utility parser plugin
  *

package/dist/bitwrench-util-css.umd.js

@@ -1,4 +1,4 @@
-/*! bitwrench-util-css v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench-util-css v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
   typeof define === 'function' && define.amd ? define(['exports'], factory) :

package/dist/bitwrench-util-css.umd.min.js

@@ -1,4 +1,4 @@
-/*! bitwrench-util-css v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench-util-css v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 !function(t,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((t="undefined"!=typeof globalThis?globalThis:t||self).bwUtilCSS={})}(this,function(t){"use strict";
 /**
    * bitwrench-util-css.js - Rule-based CSS utility parser plugin

package/dist/bitwrench.cjs.js

@@ -1,4 +1,4 @@
-/*! bitwrench v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 'use strict';
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -8,14 +8,14 @@ var _documentCurrentScript = typeof document !== 'undefined' ? document.currentS
  */
 
 const VERSION_INFO = {
-  version: '2.0.24',
+  version: '2.0.25',
   name: 'bitwrench',
   description: 'A library for javascript UI functions.',
   license: 'BSD-2-Clause',
   homepage: 'https://deftio.github.com/bitwrench/pages',
   repository: 'git+https://github.com/deftio/bitwrench.git',
   author: 'manu a. chatterjee <deftio@deftio.com> (https://deftio.com/)',
-  buildDate: '2026-03-28T09:12:50.073Z'
+  buildDate: '2026-03-31T03:03:30.752Z'
 };
 
 /**
@@ -705,7 +705,7 @@ function generateTypographyThemed(scope, palette, layout) {
     'transition': 'color ' + mot.fast + ' ' + mot.easing
   };
   rules[_sx(scope, 'a:hover')] = {
-    'color': palette.primary.hover,
+    'color': palette.tertiary.hover,
     'text-decoration': 'underline'
   };
   return rules;
@@ -885,7 +885,7 @@ function generateNavigation(scope, palette, layout) {
     'transition': 'color ' + layout.motion.fast + ' ' + layout.motion.easing + ', background-color ' + layout.motion.fast + ' ' + layout.motion.easing
   };
   rules[_sx(scope, '.bw_navbar_nav .bw_nav_link:hover')] = {
-    'color': palette.dark.base,
+    'color': palette.tertiary.base,
     'background-color': palette.surfaceAlt
   };
   rules[_sx(scope, '.bw_navbar_nav .bw_nav_link.active')] = {
@@ -966,7 +966,7 @@ function generateTabs(scope, palette, layout) {
     'transition': 'color ' + mo.fast + ' ' + mo.easing + ', border-color ' + mo.fast + ' ' + mo.easing + ', background-color ' + mo.fast + ' ' + mo.easing
   };
   rules[_sx(scope, '.bw_nav_tabs .bw_nav_link:hover')] = {
-    'color': palette.dark.base,
+    'color': palette.tertiary.base,
     'background-color': palette.surfaceAlt,
     'border-bottom-color': palette.light.border
   };
@@ -992,7 +992,7 @@ function generateListGroups(scope, palette, layout) {
   };
   rules[_sx(scope, 'a.bw_list_group_item:hover')] = {
     'background-color': palette.surfaceAlt,
-    'color': palette.dark.hover
+    'color': palette.tertiary.base
   };
   rules[_sx(scope, '.bw_list_group_item.active')] = {
     'color': palette.primary.textOn,
@@ -1089,11 +1089,11 @@ function generateBreadcrumbThemed(scope, palette, layout) {
     'color': palette.secondary.base
   };
   rules[_sx(scope, '.bw_breadcrumb_item a')] = {
-    'color': palette.primary.base,
+    'color': palette.tertiary.base,
     'transition': 'color ' + mo.fast + ' ' + mo.easing
   };
   rules[_sx(scope, '.bw_breadcrumb_item a:hover')] = {
-    'color': palette.primary.hover,
+    'color': palette.tertiary.hover,
     'text-decoration': 'underline'
   };
   rules[_sx(scope, '.bw_breadcrumb_item.active')] = {
@@ -1328,11 +1328,11 @@ function generateStepperThemed(scope, palette) {
     'font-weight': '600'
   };
   rules[_sx(scope, '.bw_step_completed .bw_step_indicator')] = {
-    'background-color': palette.primary.base,
-    'color': palette.primary.textOn
+    'background-color': palette.tertiary.base,
+    'color': palette.tertiary.textOn
   };
-  rules[_sx(scope, '.bw_step_completed .bw_step_label')] = { 'color': palette.primary.base };
-  rules[_sx(scope, '.bw_step_completed + .bw_step::before')] = { 'background-color': palette.primary.base };
+  rules[_sx(scope, '.bw_step_completed .bw_step_label')] = { 'color': palette.tertiary.base };
+  rules[_sx(scope, '.bw_step_completed + .bw_step::before')] = { 'background-color': palette.tertiary.base };
   return rules;
 }
 
@@ -1594,14 +1594,14 @@ function generatePaletteClasses(scope, palette) {
     };
   });
 
-  // Text muted — always a neutral gray, never a brand color
-  rules[_sx(scope, '.bw_text_muted')] = { 'color': '#6c757d' };
+  // Text muted — uses palette secondary for theme-aware muted text
+  rules[_sx(scope, '.bw_text_muted')] = { 'color': palette.secondary.base };
 
-  // Common bg/text utilities that aren't per-variant
-  rules[_sx(scope, '.bw_bg_dark')] = { 'background-color': '#212529', 'color': '#f8f9fa' };
-  rules[_sx(scope, '.bw_bg_light')] = { 'background-color': '#f8f9fa', 'color': '#212529' };
-  rules[_sx(scope, '.bw_text_light')] = { 'color': '#f8f9fa' };
-  rules[_sx(scope, '.bw_text_dark')] = { 'color': '#212529' };
+  // Common bg/text utilities — derive from palette for theme awareness
+  rules[_sx(scope, '.bw_bg_dark')] = { 'background-color': palette.dark.base, 'color': palette.dark.textOn };
+  rules[_sx(scope, '.bw_bg_light')] = { 'background-color': palette.light.base, 'color': palette.light.textOn };
+  rules[_sx(scope, '.bw_text_light')] = { 'color': palette.light.base };
+  rules[_sx(scope, '.bw_text_dark')] = { 'color': palette.dark.base };
 
   return rules;
 }
@@ -10082,7 +10082,8 @@ bw.applyStyles = function(styles, scope) {
  *
  * @param {Object} [config] - Style configuration (same as `makeStyles`)
  * @param {string} [scope] - Scope selector (same as `applyStyles`)
- * @returns {Element|null} The `<style>` element, or null in Node.js
+ * @returns {Object} The styles object (same as `makeStyles` return value:
+ *   `{css, alternateCss, palette, alternatePalette, rules, alternateRules, isLightPrimary}`)
  * @category CSS & Styling
  * @see bw.makeStyles
  * @see bw.applyStyles
@@ -10100,9 +10101,27 @@ bw.loadStyles = function(config, scope) {
       bw.injectCSS(structuralCSS, { id: 'bw_structural', append: false });
     }
   }
-  return bw.applyStyles(bw.makeStyles(config), scope);
+  var styles = bw.makeStyles(config);
+  bw.applyStyles(styles, scope);
+  return styles;
 };
 
+/**
+ * Prefix every selector in a rules object with a scope selector.
+ * Useful for wrapping site-level CSS under `.bw_theme_alt` for dark mode.
+ *
+ * @param {Object} rules - CSS rules object (selector -> declarations)
+ * @param {string} prefix - Scope prefix (e.g. '.bw_theme_alt')
+ * @returns {Object} New rules object with scoped selectors
+ * @category CSS & Styling
+ * @see bw.applyStyles
+ * @see bw.css
+ * @example
+ * var altRules = bw.scopeRulesUnder(myRules, '.bw_theme_alt');
+ * bw.injectCSS(bw.css(altRules));
+ */
+bw.scopeRulesUnder = scopeRulesUnder;
+
 /**
  * Inject the CSS reset (box-sizing, html/body font, reduced-motion).
  * Idempotent — if already injected, returns the existing `<style>` element.