bitwrench 2.0.31 → 2.1.0

package/src/bitwrench-code-edit.js

@@ -85,7 +85,10 @@ function tokenizeJS(code) {
   var buf = '';
 
   function flush(type) {
-    if (buf.length) { tokens.push({ type: type || 'plain', text: buf }); buf = ''; }
+    if (buf.length) {
+      /* c8 ignore next -- flush() is always called with an explicit type argument */
+      tokens.push({ type: type || 'plain', text: buf }); buf = '';
+    }
   }
 
   while (i < len) {
@@ -279,7 +282,10 @@ function tokenizeCSS(code) {
   var buf = '';
 
   function flush(type) {
-    if (buf.length) { tokens.push({ type: type || 'plain', text: buf }); buf = ''; }
+    if (buf.length) {
+      /* c8 ignore next -- flush() is always called with an explicit type argument */
+      tokens.push({ type: type || 'plain', text: buf }); buf = '';
+    }
   }
 
   while (i < len) {
@@ -316,7 +322,7 @@ function tokenizeCSS(code) {
       flush('selector');
       var aBuf = '@';
       i++;
-      while (i < len && /[a-zA-Z\-]/.test(code[i])) { aBuf += code[i]; i++; }
+      while (i < len && /[a-zA-Z-]/.test(code[i])) { aBuf += code[i]; i++; }
       tokens.push({ type: 'at-rule', text: aBuf });
       continue;
     }
@@ -389,7 +395,10 @@ function tokenizeHTML(code) {
   var buf = '';
 
   function flush(type) {
-    if (buf.length) { tokens.push({ type: type || 'plain', text: buf }); buf = ''; }
+    if (buf.length) {
+      /* c8 ignore next -- flush() is always called with an explicit type argument */
+      tokens.push({ type: type || 'plain', text: buf }); buf = '';
+    }
   }
 
   while (i < len) {
@@ -413,7 +422,7 @@ function tokenizeHTML(code) {
       i++;
       if (i < len && code[i] === '/') { tBuf += '/'; i++; }
       // Tag name
-      while (i < len && /[a-zA-Z0-9\-]/.test(code[i])) { tBuf += code[i]; i++; }
+      while (i < len && /[a-zA-Z0-9-]/.test(code[i])) { tBuf += code[i]; i++; }
       tokens.push({ type: 'tag', text: tBuf });
 
       // Attributes
@@ -614,6 +623,7 @@ function codeEditor(opts) {
 
         // Scroll sync: keep gutter aligned with code
         if (gutterEl) {
+          /* c8 ignore next -- codeEditor always wraps in .bw_ce; defensive fallback */
           var scrollParent = codeEl.closest('.bw_ce') || el;
           scrollParent.addEventListener('scroll', function() {
             gutterEl.style.transform = 'translateY(' + (-scrollParent.scrollTop) + 'px)';
@@ -666,6 +676,7 @@ function install(bw) {
 }
 
 // Auto-install if bw is on window (script tag usage)
+/* c8 ignore next 3 -- module-level auto-install; only runs at import time in browser with script tags */
 if (typeof window !== 'undefined' && window.bw) {
   install(window.bw);
 }

package/src/bitwrench-color-utils.js

@@ -1,189 +1,150 @@
 /**
  * Bitwrench Color Utilities
  *
- * Standalone color math helpers used by both bitwrench.js and bitwrench-styles.js.
- * Extracted to avoid circular dependencies. bitwrench.js re-exports these as
- * bw.colorParse, bw.colorRgbToHsl, etc.
+ * Hex-only color math for the theme derivation pipeline, plus legacy
+ * tagged-array color functions (colorParse, colorRgbToHsl, colorHslToRgb,
+ * colorInterp) for the public API.
  *
  * @module bitwrench-color-utils
- * @license BSD-2-Clause 
+ * @license BSD-2-Clause
  * @copy Manu Chatterjee @deftio
  */
 
 function _xs (x) {
-  return ('0' + x.toString(16)).slice(-2)
+  return ('0' + x.toString(16)).slice(-2);
 }
-/**
- * Clamp a value between min and max.
- * @param {number} val
- * @param {number} min
- * @param {number} max
- * @returns {number}
- */
-export function clip(val, min, max) {
+
+function clip(val, min, max) {
   return Math.max(min, Math.min(max, val));
 }
 
-/**
- * Parse a CSS color string to [r, g, b, a, "rgb"].
- * Handles #hex, rgb(), rgba(), hsl(), hsla(), and bitwrench color arrays.
- * @param {string|Array} s - Color string or array
- * @param {number} [defAlpha=255] - Default alpha
- * @returns {Array} [r, g, b, a, "rgb"]
- */
+// Parse hex string to [r, g, b].
+function _ph(hex) {
+  var h = hex.charAt(0) === '#' ? hex.slice(1) : hex;
+  if (h.length === 3) h = h[0]+h[0]+h[1]+h[1]+h[2]+h[2];
+  return [parseInt(h.slice(0,2),16), parseInt(h.slice(2,4),16), parseInt(h.slice(4,6),16)];
+}
+
+// RGB [0-255] to HSL [h 0-360, s 0-100, l 0-100], float precision.
+function _r2h(r, g, b) {
+  r /= 255; g /= 255; b /= 255;
+  var mx = Math.max(r, g, b), mn = Math.min(r, g, b);
+  var h, s, l = (mx + mn) / 2;
+  if (mx === mn) {
+    h = s = 0;
+  } else {
+    var d = mx - mn;
+    s = l > 0.5 ? d / (2 - mx - mn) : d / (mx + mn);
+    switch (mx) {
+      case r: h = ((g - b) / d + (g < b ? 6 : 0)) / 6; break;
+      case g: h = ((b - r) / d + 2) / 6; break;
+      case b: h = ((r - g) / d + 4) / 6; break;
+    }
+  }
+  return [h * 360, s * 100, l * 100];
+}
+
+// HSL [h 0-360, s 0-100, l 0-100] to RGB [0-255], rounded.
+function _h2r(h, s, l) {
+  var hN = h / 360, sN = s / 100, lN = l / 100;
+  var r, g, b;
+  if (sN === 0) {
+    r = g = b = lN * 255;
+  } else {
+    var hue2rgb = function(p, q, t) {
+      if (t < 0) t += 1;
+      if (t > 1) t -= 1;
+      if (t < 1/6) return p + (q - p) * 6 * t;
+      if (t < 1/2) return q;
+      if (t < 2/3) return p + (q - p) * (2/3 - t) * 6;
+      return p;
+    };
+    var q = lN < 0.5 ? lN * (1 + sN) : lN + sN - lN * sN;
+    var p = 2 * lN - q;
+    r = hue2rgb(p, q, hN + 1/3) * 255;
+    g = hue2rgb(p, q, hN) * 255;
+    b = hue2rgb(p, q, hN - 1/3) * 255;
+  }
+  return [Math.round(r), Math.round(g), Math.round(b)];
+}
+
+// =========================================================================
+// Legacy color API — tagged 5-element arrays [r,g,b,a,"rgb"/"hsl"]
+// =========================================================================
+
+function _ms(x, i0, i1, o0, o1, opts) {
+  var n = (x - i0) / (i1 - i0);
+  if (opts && opts.expScale && opts.expScale !== 1) n = Math.pow(n, opts.expScale);
+  var r = n * (o1 - o0) + o0;
+  if (opts && opts.clip) r = clip(r, Math.min(o0, o1), Math.max(o0, o1));
+  return r;
+}
+
+export function colorHslToRgb(h, s, l, a, rnd) {
+  if (a === undefined) a = 255;
+  if (rnd === undefined) rnd = true;
+  if (Array.isArray(h)) { s = h[1]; l = h[2]; a = h[3] !== undefined ? h[3] : 255; h = h[0]; }
+  var rgb = _h2r(h, s, l);
+  if (rnd) a = Math.round(a);
+  return [rgb[0], rgb[1], rgb[2], a, "rgb"];
+}
+
+export function colorRgbToHsl(r, g, b, a, rnd) {
+  if (a === undefined) a = 255;
+  if (rnd === undefined) rnd = true;
+  if (Array.isArray(r)) { g = r[1]; b = r[2]; a = r[3] !== undefined ? r[3] : 255; r = r[0]; }
+  var hsl = _r2h(r, g, b);
+  if (rnd) { hsl[0] = Math.round(hsl[0]); hsl[1] = Math.round(hsl[1]); hsl[2] = Math.round(hsl[2]); a = Math.round(a); }
+  return [hsl[0], hsl[1], hsl[2], a, "hsl"];
+}
+
 export function colorParse(s, defAlpha) {
   if (defAlpha === undefined) defAlpha = 255;
   var r = [0, 0, 0, defAlpha, "rgb"];
-
   if (Array.isArray(s)) {
     var df = [0, 0, 0, 255, "rgb"];
-    for (var p = 0; p < s.length && p < df.length; p++) {
-      df[p] = s[p];
-    }
+    for (var p = 0; p < s.length && p < df.length; p++) df[p] = s[p];
     return df;
   }
-
   s = String(s).replace(/\s/g, "");
-
   if (s[0] === "#") {
     var hex = s.slice(1);
     if (hex.length === 3 || hex.length === 4) {
-      for (var i = 0; i < hex.length; i++) {
-        r[i] = parseInt(hex[i] + hex[i], 16);
-      }
+      for (var i = 0; i < hex.length; i++) r[i] = parseInt(hex[i] + hex[i], 16);
     } else if (hex.length === 6 || hex.length === 8) {
-      for (var j = 0; j < hex.length; j += 2) {
-        r[j / 2] = parseInt(hex.substring(j, j + 2), 16);
-      }
+      for (var j = 0; j < hex.length; j += 2) r[j / 2] = parseInt(hex.substring(j, j + 2), 16);
     }
   } else {
     var match = s.match(/^(rgb|hsl)a?\(([^)]+)\)$/i);
     if (match) {
       var type = match[1].toLowerCase();
       var values = match[2].split(",").map(function(v) { return parseFloat(v); });
-
       if (type === "rgb") {
-        r[0] = values[0] || 0;
-        r[1] = values[1] || 0;
-        r[2] = values[2] || 0;
+        r[0] = values[0] || 0; r[1] = values[1] || 0; r[2] = values[2] || 0;
         r[3] = values[3] !== undefined ? values[3] * 255 : defAlpha;
-        r[4] = "rgb";
       } else if (type === "hsl") {
-        var rgb = colorHslToRgb(values[0] || 0, values[1] || 0, values[2] || 0,
-                                values[3] !== undefined ? values[3] * 255 : defAlpha);
-        return rgb;
+        return colorHslToRgb(values[0] || 0, values[1] || 0, values[2] || 0,
+                             values[3] !== undefined ? values[3] * 255 : defAlpha);
       }
     }
   }
-
   return r;
 }
 
-/**
- * Convert RGB to HSL.
- * @param {number|Array} r - Red 0-255, or [r,g,b,a] array
- * @param {number} [g] - Green 0-255
- * @param {number} [b] - Blue 0-255
- * @param {number} [a=255] - Alpha 0-255
- * @param {boolean} [rnd=true] - Round results
- * @returns {Array} [h, s, l, a, "hsl"]
- */
-export function colorRgbToHsl(r, g, b, a, rnd) {
-  if (a === undefined) a = 255;
-  if (rnd === undefined) rnd = true;
-  if (Array.isArray(r)) {
-    g = r[1]; b = r[2]; a = r[3] !== undefined ? r[3] : 255; r = r[0];
-  }
-
-  r /= 255;
-  g /= 255;
-  b /= 255;
-
-  var max = Math.max(r, g, b);
-  var min = Math.min(r, g, b);
-  var h, s, l = (max + min) / 2;
-
-  if (max === min) {
-    h = s = 0;
-  } else {
-    var d = max - min;
-    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
-
-    switch (max) {
-      case r: h = ((g - b) / d + (g < b ? 6 : 0)) / 6; break;
-      case g: h = ((b - r) / d + 2) / 6; break;
-      case b: h = ((r - g) / d + 4) / 6; break;
-    }
-  }
-
-  h *= 360;
-  s *= 100;
-  l *= 100;
-
-  if (rnd) {
-    h = Math.round(h);
-    s = Math.round(s);
-    l = Math.round(l);
-    a = Math.round(a);
-  }
-
-  return [h, s, l, a, "hsl"];
-}
-
-/**
- * Convert HSL to RGB.
- * @param {number|Array} h - Hue 0-360, or [h,s,l,a] array
- * @param {number} [s] - Saturation 0-100
- * @param {number} [l] - Lightness 0-100
- * @param {number} [a=255] - Alpha 0-255
- * @param {boolean} [rnd=true] - Round results
- * @returns {Array} [r, g, b, a, "rgb"]
- */
-export function colorHslToRgb(h, s, l, a, rnd) {
-  if (a === undefined) a = 255;
-  if (rnd === undefined) rnd = true;
-  if (Array.isArray(h)) {
-    s = h[1]; l = h[2]; a = h[3] !== undefined ? h[3] : 255; h = h[0];
-  }
-
-  var hNorm = h / 360;
-  var sNorm = s / 100;
-  var lNorm = l / 100;
-
-  var r, g, b;
-
-  if (sNorm === 0) {
-    r = g = b = lNorm * 255;
-  } else {
-    var hue2rgb = function(p, q, t) {
-      if (t < 0) t += 1;
-      if (t > 1) t -= 1;
-      if (t < 1/6) return p + (q - p) * 6 * t;
-      if (t < 1/2) return q;
-      if (t < 2/3) return p + (q - p) * (2/3 - t) * 6;
-      return p;
-    };
-
-    var q = lNorm < 0.5 ? lNorm * (1 + sNorm) : lNorm + sNorm - lNorm * sNorm;
-    var p = 2 * lNorm - q;
-
-    r = hue2rgb(p, q, hNorm + 1/3) * 255;
-    g = hue2rgb(p, q, hNorm) * 255;
-    b = hue2rgb(p, q, hNorm - 1/3) * 255;
-  }
-
-  if (rnd) {
-    r = Math.round(r);
-    g = Math.round(g);
-    b = Math.round(b);
-    a = Math.round(a);
-  }
-
-  return [r, g, b, a, "rgb"];
+export function colorInterp(x, in0, in1, colors, stretch) {
+  var c = Array.isArray(colors) ? colors : ["#000", "#fff"];
+  c = c.length === 0 ? ["#000", "#fff"] : c;
+  if (c.length === 1) return c[0];
+  c = c.map(function(col) { return colorParse(col); });
+  var a = _ms(x, in0, in1, 0, c.length - 1, { clip: true, expScale: stretch });
+  var i = clip(Math.floor(a), 0, c.length - 2);
+  var r = a - i;
+  var interp = function(idx) { return _ms(r, 0, 1, c[i][idx], c[i + 1][idx], { clip: true }); };
+  return [interp(0), interp(1), interp(2), interp(3), "rgb"];
 }
 
 // =========================================================================
-// New theme derivation helpers
+// Public theme derivation helpers
 // =========================================================================
 
 /**
@@ -192,9 +153,8 @@ export function colorHslToRgb(h, s, l, a, rnd) {
  * @returns {Array} [h, s, l] where h=0-360, s=0-100, l=0-100
  */
 export function hexToHsl(hex) {
-  var rgb = colorParse(hex);
-  var hsl = colorRgbToHsl(rgb[0], rgb[1], rgb[2], 255, false);
-  return [hsl[0], hsl[1], hsl[2]];
+  var rgb = _ph(hex);
+  return _r2h(rgb[0], rgb[1], rgb[2]);
 }
 
 /**
@@ -203,7 +163,7 @@ export function hexToHsl(hex) {
  * @returns {string} Hex color e.g. '#006666'
  */
 export function hslToHex(hsl) {
-  var rgb = colorHslToRgb(hsl[0], hsl[1], hsl[2], 255, true);
+  var rgb = _h2r(hsl[0], hsl[1], hsl[2]);
   return '#' + _xs(rgb[0])+_xs(rgb[1])+_xs(rgb[2]);
 }
 
@@ -228,8 +188,8 @@ export function adjustLightness(hex, amount) {
  * @returns {string} Mixed hex color
  */
 export function mixColor(hex1, hex2, ratio) {
-  var c1 = colorParse(hex1);
-  var c2 = colorParse(hex2);
+  var c1 = _ph(hex1);
+  var c2 = _ph(hex2);
   var r = Math.round(c1[0] + (c2[0] - c1[0]) * ratio);
   var g = Math.round(c1[1] + (c2[1] - c1[1]) * ratio);
   var b = Math.round(c1[2] + (c2[2] - c1[2]) * ratio);
@@ -242,7 +202,7 @@ export function mixColor(hex1, hex2, ratio) {
  * @returns {number} Relative luminance 0-1
  */
 export function relativeLuminance(hex) {
-  var rgb = colorParse(hex);
+  var rgb = _ph(hex);
   var vals = [rgb[0] / 255, rgb[1] / 255, rgb[2] / 255].map(function(v) {
     return v <= 0.03928 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
   });
@@ -273,7 +233,6 @@ export function harmonize(sourceHex, targetHex, amount) {
   var srcHsl = hexToHsl(sourceHex);
   var tgtHsl = hexToHsl(targetHex);
 
-  // Shortest-arc hue interpolation
   var diff = tgtHsl[0] - srcHsl[0];
   if (diff > 180) diff -= 360;
   if (diff < -180) diff += 360;
@@ -288,9 +247,7 @@ export function harmonize(sourceHex, targetHex, amount) {
  * @returns {Object} { base, hover, active, light, darkText, border, focus, textOn }
  */
 export function deriveShades(hex) {
-  var rgb = colorParse(hex);
-  // For light input colors (L > 75), mixing toward white produces invisible borders.
-  // Darken instead so borders remain visible against light backgrounds.
+  var rgb = _ph(hex);
   var borderColor = hexToHsl(hex)[2] > 75
     ? adjustLightness(hex, -18)
     : mixColor(hex, '#ffffff', 0.60);
@@ -318,14 +275,10 @@ export function deriveAlternateSeed(hex) {
   var altL, altS;
 
   if (l > 50) {
-    // Light color → make dark. Map 50-100 → 30-10 range
     altL = clip(100 - l - 10, 8, 40);
-    // Reduce saturation slightly — vivid colors at low lightness look garish
     altS = clip(s * 0.85, 0, 100);
   } else {
-    // Dark color → make light. Map 0-50 → 65-92 range
     altL = clip(100 - l + 10, 60, 92);
-    // Slightly increase saturation for light variant
     altS = clip(s * 1.1, 0, 100);
   }
 
@@ -354,35 +307,27 @@ export function isLightPalette(config) {
  */
 export function deriveAlternateConfig(config) {
   var alt = {};
-  // Invert the user's seed colors
   alt.primary = deriveAlternateSeed(config.primary);
-  alt.secondary = deriveAlternateSeed(config.secondary);
+  alt.secondary = deriveAlternateSeed(config.secondary || config.primary);
   alt.tertiary = config.tertiary ? deriveAlternateSeed(config.tertiary) : alt.primary;
 
-  // Derive alternate surface colors from primary hue.
-  // Check actual page surface brightness (not seed color brightness) to decide
-  // whether alternate should be dark or light.  The page surface is what the
-  // user sees; seeds can be dark while the page is still light (default L=96).
   var priHsl = hexToHsl(config.primary);
   var h = priHsl[0];
   var primarySurface = config.surface || hslToHex([h, 8, 96]);
   var isLight = relativeLuminance(primarySurface) > 0.179;
 
   if (isLight) {
-    // Page surface is light → alternate needs dark surfaces
     alt.light = hslToHex([h, Math.min(priHsl[1], 15), 15]);
     alt.dark = hslToHex([h, 5, 88]);
     alt.surface = hslToHex([h, 12, 18]);
     alt.background = hslToHex([h, 10, 14]);
   } else {
-    // Page surface is dark → alternate needs light surfaces
     alt.light = hslToHex([h, Math.min(priHsl[1], 10), 96]);
     alt.dark = hslToHex([h, 10, 18]);
     alt.surface = hslToHex([h, 8, 96]);
     alt.background = hslToHex([h, 6, 98]);
   }
 
-  // Semantic colors: harmonize toward primary, then invert for alternate
   var amt = config.harmonize !== undefined ? config.harmonize : 0.20;
   var semanticDefaults = {
     success: '#198754', danger: '#dc3545',
@@ -396,7 +341,6 @@ export function deriveAlternateConfig(config) {
     alt[key] = deriveAlternateSeed(harmonized);
   }
 
-  // Semantic colors are already harmonized+inverted — don't re-harmonize in derivePalette
   alt.harmonize = 0;
 
   return alt;
@@ -404,8 +348,6 @@ export function deriveAlternateConfig(config) {
 
 /**
  * Derive complete palette from a theme config object.
- * Semantic colors are harmonized toward the primary hue (configurable).
- * Light/dark surface colors are tinted with the primary hue.
  * @param {Object} config - Theme config with primary, secondary, tertiary, etc.
  * @param {number} [config.harmonize=0.20] - Hue shift amount for semantic colors (0-1)
  * @returns {Object} Full palette with shades for all 9 semantic colors
@@ -413,37 +355,31 @@ export function deriveAlternateConfig(config) {
 export function derivePalette(config) {
   var amt = config.harmonize !== undefined ? config.harmonize : 0.20;
   var pri = config.primary;
+  var sec = config.secondary || pri;
+  var ter = config.tertiary || pri;
   var priHsl = hexToHsl(pri);
   var h = priHsl[0];
 
-  // Semantic defaults — harmonized toward primary hue
   var successBase = harmonize(config.success || '#198754', pri, amt);
   var dangerBase  = harmonize(config.danger  || '#dc3545', pri, amt);
   var warningBase = harmonize(config.warning || '#f0ad4e', pri, amt);
   var infoBase    = harmonize(config.info    || '#17a2b8', pri, amt);
 
-  // Light/dark: derive from primary hue with low saturation (if not user-supplied)
   var lightBase = config.light || hslToHex([h, 8, 97]);
   var darkBase  = config.dark  || hslToHex([h, 10, 13]);
 
-  // Background & surface tokens — tinted with primary hue for theme personality.
-  // Saturation high enough that the hue is visible (each theme feels distinct)
-  // but low enough to stay neutral and readable.
-  // User can override with config.background / config.surface.
   var bgBase = config.background || hslToHex([h, 22, 96]);
   var surfBase = config.surface || hslToHex([h, 25, 94]);
 
-  // surfaceAlt: subtle background variant for striped rows, hover states, headers.
-  // Slightly lighter than surface in dark mode, slightly darker in light mode.
   var surfHsl = hexToHsl(surfBase);
   var surfAlt = surfHsl[2] <= 50
     ? hslToHex([surfHsl[0], surfHsl[1], Math.min(surfHsl[2] + 8, 100)])
     : hslToHex([surfHsl[0], surfHsl[1], Math.max(surfHsl[2] - 3, 0)]);
 
   var palette = {
-    primary:    deriveShades(config.primary),
-    secondary:  deriveShades(config.secondary),
-    tertiary:   deriveShades(config.tertiary),
+    primary:    deriveShades(pri),
+    secondary:  deriveShades(sec),
+    tertiary:   deriveShades(ter),
     success:    deriveShades(successBase),
     danger:     deriveShades(dangerBase),
     warning:    deriveShades(warningBase),

package/src/bitwrench-file-ops.js

@@ -40,7 +40,7 @@ export function bindFileOps(bw) {
     } else {
       var blob = new Blob([data], { type: "application/octet-stream" });
       var url = window.URL.createObjectURL(blob);
-      var a = bw.createDOM({
+      var a = bw.create({
         t: 'a',
         a: {
           href: url,
@@ -144,7 +144,7 @@ export function bindFileOps(bw) {
       return;
     }
 
-    var input = bw.createDOM({
+    var input = bw.create({
       t: 'input',
       a: {
         type: 'file',

package/src/bitwrench-lean.js

@@ -7,8 +7,9 @@
  *
  * Includes: HTML/DOM generation, CSS generation, color utilities,
  *           state management, pub/sub, file I/O, random/lorem,
- *           cookies, URL params, logging, makeTable, makeDataTable.
- * Excludes: All make* component helpers from bitwrench-bccl.js
- *           (makeButton, makeCard, makeAlert, makeTabs, etc.)
+ *           cookies, URL params, logging, makeTable, makeTableFromArray,
+ *           makeDataTable, makeBarChart.
+ * Excludes: BCCL component helpers from bitwrench-bccl.js
+ *           (makeButton, makeCard, makeAlert, makeTabs, makeModal, etc.)
  */
 export { default } from './bitwrench.js';

package/src/bitwrench-router.js

@@ -130,7 +130,8 @@ export function initRouter(bw) {
       return p + s;
     }
 
-    function handleRoute(toRaw, opts) {
+    function handleRoute(toRaw, _opts) {
+      /* c8 ignore next -- all callers (navigate, onHashChange, onPopState) check destroyed first */
       if (destroyed) return;
       var fromPath = currentPath;
       var toPath = normalizePath(toRaw);
@@ -180,6 +181,7 @@ export function initRouter(bw) {
           window.location.hash = path;
         }
         // hashchange listener will fire handleRoute; but if same hash, trigger manually
+        /* c8 ignore next -- fallback for bare '#' hash; navigate always sets a path */
         var currentHash = window.location.hash.replace(/^#/, '') || '/';
         if (normalizePath(currentHash) === normalizePath(path)) {
           handleRoute(path, opts);
@@ -196,11 +198,13 @@ export function initRouter(bw) {
     }
 
     function onHashChange() {
+      /* c8 ignore next -- destroy() removes the hashchange listener; belt-and-suspenders guard */
       if (destroyed) return;
       handleRoute(getPath());
     }
 
     function onPopState() {
+      /* c8 ignore next -- destroy() removes the popstate listener; belt-and-suspenders guard */
       if (destroyed) return;
       handleRoute(getPath());
     }
@@ -259,7 +263,6 @@ export function initRouter(bw) {
     }
     if (_activeRouter) {
       // determine href based on mode -- check hash by looking at current location
-      var isHash = window.location.hash !== undefined; // always true, but we default hash
       a.href = '#' + path;
     } else {
       a.href = path;