bitwrench 2.0.32 → 2.1.1

package/src/bitwrench-util-color.js

@@ -0,0 +1,240 @@
+/**
+ * bitwrench-util-color.js - Legacy color parsing and conversion utilities
+ *
+ * Self-contained module providing CSS color parsing, RGB/HSL conversion,
+ * and multi-stop color interpolation. Extracted from bitwrench core in v2.1.
+ *
+ * Can be loaded standalone (browser script tag after bitwrench.umd.js),
+ * or imported as an ES module / CJS module.
+ *
+ * @module bitwrench-util-color
+ * @license BSD-2-Clause
+ * @author M A Chatterjee <deftio [at] deftio [dot] com>
+ */
+
+function _clip(val, min, max) {
+  return Math.max(min, Math.min(max, val));
+}
+
+function _mapScale(x, in0, in1, out0, out1, options) {
+  if (!options) options = {};
+  var doClip = options.clip || false;
+  var expScale = options.expScale || 1;
+  var normalized = (x - in0) / (in1 - in0);
+  if (expScale !== 1) normalized = Math.pow(normalized, expScale);
+  var result = normalized * (out1 - out0) + out0;
+  if (doClip) {
+    var mn = Math.min(out0, out1);
+    var mx = Math.max(out0, out1);
+    result = Math.max(mn, Math.min(mx, result));
+  }
+  return result;
+}
+
+/**
+ * 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"];
+}
+
+/**
+ * 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"];
+}
+
+/**
+ * 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"]
+ */
+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];
+    }
+    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);
+      }
+    } 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);
+      }
+    }
+  } 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[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 r;
+}
+
+/**
+ * Interpolate between N colors based on a mapped position.
+ * @param {number} x - Input value
+ * @param {number} in0 - Input range start
+ * @param {number} in1 - Input range end
+ * @param {Array} colors - Array of color strings
+ * @param {number} [stretch] - Exponential scaling factor
+ * @returns {Array} [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 = _mapScale(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 _mapScale(r, 0, 1, c[i][idx], c[i + 1][idx], { clip: true }); };
+  return [interp(0), interp(1), interp(2), interp(3), "rgb"];
+}
+
+var utilColor = {
+  colorParse: colorParse,
+  colorRgbToHsl: colorRgbToHsl,
+  colorHslToRgb: colorHslToRgb,
+  colorInterp: colorInterp
+};
+
+/**
+ * Install color utilities onto a bitwrench instance.
+ * @param {Object} bw - The bitwrench object to extend
+ */
+export function install(bw) {
+  if (!bw) return;
+  bw.colorParse = colorParse;
+  bw.colorRgbToHsl = colorRgbToHsl;
+  bw.colorHslToRgb = colorHslToRgb;
+  bw.colorInterp = colorInterp;
+}
+
+if (typeof window !== 'undefined' && window.bw) {
+  install(window.bw);
+}
+
+export { utilColor };
+export default utilColor;

package/src/bitwrench-util-css.js

@@ -220,6 +220,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 */
 if (typeof window !== 'undefined' && window.bw) {
   install(window.bw);
 }

package/src/bitwrench-utils.js

@@ -267,6 +267,7 @@ export function loremIpsum(numChars, startSpot, startWithCapitalLetter = true) {
     startSpot = (startSpot + 1) % lorem.length;
     skippedChars++;
     // Prevent infinite loop in case entire lorem is spaces/punctuation
+    /* c8 ignore next -- lorem text always contains letters; this is a defensive guard */
     if (skippedChars >= lorem.length) {
       startSpot = 0;
       skippedChars = 0;
@@ -297,6 +298,7 @@ export function loremIpsum(numChars, startSpot, startWithCapitalLetter = true) {
   // Ensure capital letter at start if requested
   if (startWithCapitalLetter) {
     let c = result[0].toUpperCase();
+    /* c8 ignore next -- while loop at L266 skips past non-letters, so first char is always a letter */
     c = /[A-Z]/.test(c) ? c : "L";  // Use "L" as default if first char isn't a letter
     result = c + result.substring(1);
   }
@@ -363,7 +365,9 @@ export function naturalCompare(as, bs) {
   }
 
   // Split into chunks of digits/non-digits
+  /* c8 ignore next -- match always succeeds for strings that pass the digit check above */
   const aParts = a.match(/(\d+|\D+)/g) || [];
+  /* c8 ignore next -- match always succeeds for strings that pass the digit check above */
   const bParts = b.match(/(\d+|\D+)/g) || [];
 
   const len = Math.min(aParts.length, bParts.length);

package/src/bitwrench.d.ts

@@ -64,16 +64,20 @@ export interface TacoOptions {
   state?: Record<string, any>;
   /** Called after element created and in DOM */
   mounted?: (el: HTMLElement, state?: Record<string, any>) => void;
-  /** Called on bw.cleanup() */
+  /** Called on bw.unmount() */
   unmount?: (el: HTMLElement, state?: Record<string, any>) => void;
-  /** Called by bw.update(); stored on el._bw_render */
+  /** Called by bw.refresh(); stored on el._bw_render */
   render?: (el: HTMLElement, state?: Record<string, any>) => void;
-  /** Methods attached to el.bw namespace */
+  /** Methods attached to el.bw namespace (e.g. handle.update dispatched by bw.update()) */
   handle?: Record<string, (el: HTMLElement, ...args: any[]) => any>;
   /** Slot selectors: auto-generates el.bw.setName()/getName() */
   slots?: Record<string, string>;
   /** Component type identifier (used internally by BCCL) */
   type?: string;
+  /** User tag for bw.message() addressing */
+  userTag?: string;
+  /** Declarative event handlers for bw.actions */
+  events?: Record<string, (data: any, el: HTMLElement) => void>;
 }
 
 /**
@@ -316,27 +320,51 @@ export interface Bitwrench {
   /** Generate complete HTML page string */
   htmlPage(opts: { title?: string; css?: string; content?: TacoContent; favicon?: string; [key: string]: any }): string;
   /** Create DOM element from TACO (browser only). SVG TACOs ({t:'svg',...}) use createElementNS. */
-  createDOM(taco: Taco | TacoContent, options?: Record<string, any>): HTMLElement | SVGElement | DocumentFragment;
-  /** Mount TACO into target, replacing contents */
-  DOM(target: string | HTMLElement, taco: Taco | TacoContent, options?: Record<string, any>): void;
-  /** Mount TACO and return root element (for el.bw access) */
-  mount(target: string | HTMLElement, taco: Taco | TacoContent, options?: Record<string, any>): HTMLElement;
+  create(taco: Taco | TacoContent, options?: Record<string, any>): HTMLElement | SVGElement | DocumentFragment;
+  /** Mount TACO into target, replacing contents. Alias for bw.mount(). Returns the first created element. */
+  DOM(target: string | HTMLElement, taco: Taco | TacoContent, options?: Record<string, any>): HTMLElement | null;
+  /** Mount TACO into target, replacing contents. Returns the first created element. */
+  mount(target: string | HTMLElement, taco: Taco | TacoContent, options?: Record<string, any>): HTMLElement | null;
   /** Mark string as pre-escaped HTML */
   raw(str: string): BwRaw;
   /** Escape HTML special characters */
   escapeHTML(str: string): string;
 
   // -- Lifecycle & State ----------------------------------------------------
-  /** Call el._bw_render to re-render element */
-  update(target: string | HTMLElement): void;
+  /** Dispatch data to el.bw.update(data) if defined */
+  update(ref: string | HTMLElement, data?: any): void;
+  /** Re-render element by calling el._bw_render */
+  refresh(ref: string | HTMLElement): void;
+  /** Set a named slot value via el.bw.setName(value) */
+  updateSlot(ref: string | HTMLElement, name: string, value: any): boolean;
+  /** Unmount element: fire unmount hooks, clean subscriptions, remove from cache */
+  unmount(element: HTMLElement): void;
+  /** Fire mounted() hooks on an element subtree */
+  mountTree(element: HTMLElement): void;
+  /** Unmount all lifecycle-managed children of element */
+  unmountChildren(element: HTMLElement): void;
+  /** Wire TACO options onto an existing DOM element (for post-creation hydration) */
+  hydrate(element: HTMLElement, taco: Taco): void;
+  /** Mark element as detach-exempt (survives parent unmount) */
+  detach(element: HTMLElement): void;
+  /** Append TACO as child of target */
+  append(target: string | HTMLElement, content: Taco | TacoContent): HTMLElement;
+  /** Replace target's content with new TACO */
+  replace(target: string | HTMLElement, content: Taco | TacoContent): HTMLElement;
+  /** Remove element from DOM with unmount */
+  remove(target: string | HTMLElement): void;
   /** Quick-patch element content or attribute */
   patch(id: string | HTMLElement, content?: TacoContent, attr?: string): HTMLElement | null;
   /** RFC 6902 JSON Patch on plain objects. Mutates and returns obj. @see bw.patch */
   jsonPatch(obj: object, ops: Array<{ op: string; path: string; value?: any; from?: string }>): object;
   /** Batch patch multiple elements */
   patchAll(patches: Record<string, TacoContent> | Array<{ id: string; content?: TacoContent; attr?: string }>): Record<string, HTMLElement>;
-  /** Clean up lifecycle hooks, subscriptions, cache */
-  cleanup(element: HTMLElement): void;
+  /** Janitor: document-level cleanup for orphaned lifecycle elements */
+  janitor(options?: { verbose?: boolean }): void;
+  /** Reconcile children of parent with new TACO list */
+  syncChildren(parent: HTMLElement, items: Taco[], options?: { key?: string }): void;
+  /** Declared dataflow: recompute fn(inputs...) on any input publish, publish result to outTopic. Returns disposer. */
+  derive(inputs: string[], fn: (...values: any[]) => any, outTopic: string, opts?: { seed?: any[]; immediate?: boolean; el?: HTMLElement }): () => void;
 
   // -- DOM Selection --------------------------------------------------------
   /** Resolve target to first matching element. Optional apply: string (textContent), function, TACO (mount), or array. @see bw.$ */
@@ -345,8 +373,8 @@ export interface Bitwrench {
   $(selector: string | HTMLElement | HTMLElement[], apply?: string | number | boolean | Function | object | any[]): HTMLElement[];
   /** Dispatch DOM event */
   emit(target: string | HTMLElement, eventName: string, detail?: any): void;
-  /** Add event listener */
-  on(target: string | HTMLElement, eventName: string, handler: (e: Event) => void): void;
+  /** Add event listener; returns unsubscribe function */
+  on(target: string | HTMLElement, eventName: string, handler: (e: Event) => void): () => void;
 
   // -- Pub/Sub --------------------------------------------------------------
   /** Publish to topic. Fires exact-match and wildcard subscribers. */
@@ -355,6 +383,8 @@ export interface Bitwrench {
   sub(topic: string, handler: (detail: any, topic?: string) => void, el?: HTMLElement): () => void;
   /** Unsubscribe handler from topic */
   unsub(topic: string, handler: Function): number;
+  /** Subscribe to topic for a single delivery; auto-unsubscribes after first fire. Returns unsub(). */
+  once(topic: string, handler: (detail: any) => void, el?: HTMLElement): () => void;
 
   // -- UUID & Identity ------------------------------------------------------
   /** Generate unique ID */
@@ -364,13 +394,27 @@ export interface Bitwrench {
   /** Read UUID from TACO or DOM element */
   getUUID(tacoOrElement: Taco | HTMLElement): string | null;
 
-  // -- Component Messages ---------------------------------------------------
+  // -- Component Messages & Wire Protocol -----------------------------------
   /** Call method on el.bw: el.bw[action](data) */
   message(target: string | HTMLElement, action: string, data?: any): any;
+  /** Extract form data from a form or container element */
+  formData(target: string | HTMLElement): Record<string, any>;
   /** Execute wire-protocol message object */
-  apply(msg: Record<string, any>): any;
+  apply(msg: Record<string, any>): boolean;
   /** Inspect DOM element and subtree, returning plain-object tree with bitwrench metadata */
   inspect(target: string | HTMLElement, depth?: number): Record<string, any> | null;
+  /** Document-level delegated action dispatcher */
+  actions: { enable(): void; disable(): void; _ensureInstalled(): void; _reset(): void };
+  /** Remote connection (set by bwclient or bw.connect) */
+  remote: { send(msg: any): void; close?(): void } | null;
+  /** Register a named remote function for bw.apply({type:'call'}) */
+  registerRemote(name: string, fn: Function): void;
+  /** Connect to a bwserve instance via SSE */
+  connect(url: string, options?: Record<string, any>): { send(msg: any): void; close(): void };
+  /** Set theme mode ('primary' or 'alternate') on matching elements */
+  setThemeMode(mode: string, scope?: string | HTMLElement): { mode: string; count: number };
+  /** Load structural CSS only (no theming) */
+  loadStructural(): void;
 
   // -- Function Registry ----------------------------------------------------
   funcRegister(fn: Function, name?: string): string;
@@ -379,16 +423,16 @@ export interface Bitwrench {
   funcUnregister(name: string): void;
   funcGetRegistry(): Record<string, Function>;
 
-  // -- Component Registry ---------------------------------------------------
-  render(element: HTMLElement, position: string, taco: Taco): string;
-  getComponent(id: string): Record<string, any> | null;
-  getAllComponents(): Map<string, any>;
+  // -- Render (convenience factory over append/replace) --------------------
+  render(target: string | HTMLElement, position: 'append' | 'prepend' | 'replace' | 'before' | 'after', taco: Taco): { el: HTMLElement | null; ok: boolean; error: string | null };
 
   // -- CSS & Styles ---------------------------------------------------------
   /** Generate CSS string from JS object */
   css(rules: Record<string, any>, options?: { scopeSelector?: string; selector?: string }): string;
   /** Inject CSS into document */
   injectCSS(css: string, options?: { id?: string; append?: boolean; scope?: string }): HTMLElement;
+  /** Merge style objects (shallow Object.assign). Use to compose inline styles. */
+  s(...objs: Record<string, string | number>[]): Record<string, string | number>;
   /** Responsive media query helper */
   responsive(selector: string, breakpoints: Record<string, Record<string, any>>): string;
   /** Generate styles from config */
@@ -401,8 +445,6 @@ export interface Bitwrench {
   loadReset(): void;
   /** Toggle between primary/alternate theme palettes on all matching elements. @see bw.applyStyles */
   toggleThemeMode(scope?: string | HTMLElement): string;
-  /** @deprecated Use bw.toggleThemeMode() instead. Alias kept for one release cycle. */
-  toggleStyles(scope?: string | HTMLElement): string;
   /** Remove injected styles */
   clearStyles(scope?: string): void;
   /** Generate type scale from base + ratio */
@@ -485,55 +527,8 @@ export interface Bitwrench {
   makeDataTable(config?: TableConfig): Taco;
   makeBarChart(config?: ComponentConfig): Taco;
 
-  // -- Corresponding create* (return DOM Element) ---------------------------
-  createCard(config?: CardConfig | string): HTMLElement;
-  createButton(config?: ButtonConfig | string): HTMLElement;
-  createContainer(config?: ComponentConfig): HTMLElement;
-  createRow(config?: ComponentConfig): HTMLElement;
-  createCol(config?: ComponentConfig): HTMLElement;
-  createStack(config?: ComponentConfig): HTMLElement;
-  createSection(config?: ComponentConfig): HTMLElement;
-  createNav(config?: NavConfig): HTMLElement;
-  createNavbar(config?: ComponentConfig): HTMLElement;
-  createBreadcrumb(config?: ComponentConfig): HTMLElement;
-  createTabs(config?: TabsConfig): HTMLElement;
-  createPagination(config?: ComponentConfig): HTMLElement;
-  createAlert(config?: AlertConfig | string): HTMLElement;
-  createBadge(config?: ComponentConfig | string): HTMLElement;
-  createProgress(config?: ComponentConfig): HTMLElement;
-  createSpinner(config?: ComponentConfig): HTMLElement;
-  createToast(config?: ComponentConfig): HTMLElement;
-  createTooltip(config?: ComponentConfig): HTMLElement;
-  createPopover(config?: ComponentConfig): HTMLElement;
-  createListGroup(config?: ComponentConfig): HTMLElement;
-  createAccordion(config?: AccordionConfig): HTMLElement;
-  createCarousel(config?: CarouselConfig): HTMLElement;
-  createTimeline(config?: ComponentConfig): HTMLElement;
-  createStepper(config?: ComponentConfig): HTMLElement;
-  createChipInput(config?: ComponentConfig): HTMLElement;
-  createModal(config?: ModalConfig): HTMLElement;
-  createDropdown(config?: ComponentConfig): HTMLElement;
-  createForm(config?: ComponentConfig): HTMLElement;
-  createFormGroup(config?: ComponentConfig): HTMLElement;
-  createInput(config?: InputConfig): HTMLElement;
-  createTextarea(config?: ComponentConfig): HTMLElement;
-  createSelect(config?: ComponentConfig): HTMLElement;
-  createCheckbox(config?: ComponentConfig): HTMLElement;
-  createRadio(config?: ComponentConfig): HTMLElement;
-  createSwitch(config?: ComponentConfig): HTMLElement;
-  createRange(config?: ComponentConfig): HTMLElement;
-  createFileUpload(config?: ComponentConfig): HTMLElement;
-  createSearchInput(config?: ComponentConfig): HTMLElement;
-  createButtonGroup(config?: ComponentConfig): HTMLElement;
-  createHero(config?: ComponentConfig): HTMLElement;
-  createFeatureGrid(config?: ComponentConfig): HTMLElement;
-  createCTA(config?: ComponentConfig): HTMLElement;
-  createCodeDemo(config?: ComponentConfig): HTMLElement;
-  createSkeleton(config?: ComponentConfig): HTMLElement;
-  createAvatar(config?: ComponentConfig): HTMLElement;
-  createStatCard(config?: ComponentConfig): HTMLElement;
-  createMediaObject(config?: ComponentConfig): HTMLElement;
-  createTable(config?: TableConfig): HTMLElement;
+  /** List available BCCL component types, or get factory for a type */
+  catalog(type?: string): Record<string, any>;
 
   // -- Array Utilities ------------------------------------------------------
   arrayUniq(arr: any[]): any[];
@@ -599,9 +594,11 @@ export interface Bitwrench {
   _unmountCallbacks: Map<string, Function>;
   _topics: Record<string, any[]>;
   _fnRegistry: Record<string, Function>;
-  _componentRegistry: Map<string, any>;
   _clientFunctions: Record<string, Function>;
-  _allowExec: boolean;
+  _clientRemotes: Record<string, Function>;
+  _wireListeners: Record<string, () => void>;
+  _mounted: Record<string, boolean>;
+  _detached: Record<string, boolean>;
 }
 
 /** The bw namespace (default export) */

package/src/bitwrench.h

@@ -0,0 +1,5 @@
+/*
+ * Shim header for the Arduino library layout ("recursive" layout adds only
+ * src/ to the include path). The real header lives in embedded_c/bitwrench.h.
+ */
+#include "../embedded_c/bitwrench.h"