bitwrench 2.0.24 → 2.0.25

package/dist/bitwrench-lean.esm.js

@@ -1,18 +1,18 @@
-/*! bitwrench-lean v2.0.24 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bitwrench-lean v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 /**
  * Auto-generated version file from package.json
  * DO NOT EDIT DIRECTLY - Use npm run generate-version
  */
 
 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'
 };
 
 /**
@@ -702,7 +702,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;
@@ -882,7 +882,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')] = {
@@ -963,7 +963,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
   };
@@ -989,7 +989,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,
@@ -1086,11 +1086,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')] = {
@@ -1325,11 +1325,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;
 }
 
@@ -1591,14 +1591,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;
 }
@@ -6249,7 +6249,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
@@ -6267,9 +6268,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.