bitwrench 2.0.14 → 2.0.16

package/dist/sri.json

@@ -1,31 +1,41 @@
 {
-  "version": "2.0.14",
+  "version": "2.0.16",
   "algorithm": "sha384",
-  "generated": "2026-03-08",
+  "generated": "2026-03-12",
   "files": {
-    "bitwrench-code-edit.cjs.js": "sha384-NuPgjnP90qmTJh2+OHjD7dEMax23EdkDFLiPZmztnK1Rgxk7DH28DlayzgEaOLDn",
-    "bitwrench-code-edit.es5.js": "sha384-5GuqE6c+ucctoppDBKLbYZe+cgPS7aURDoeetCPGNBpBBgEokHtZvfMsU73eIlyP",
-    "bitwrench-code-edit.es5.min.js": "sha384-gOfySPh/0oSN9N/rRmKqQkfFELHA+wP2h5+C4FY4T38HYPXNEr0wTtPyBO+fo6Vw",
-    "bitwrench-code-edit.esm.js": "sha384-tDVBa46hw2U2LAqzcuVL0HErYb7lm3vusm+qwXkjw2J2drstEBFFIeFjwjQn3uid",
-    "bitwrench-code-edit.esm.min.js": "sha384-x+cZlIypO7cHNO/EblwGATZK9RMLtf+gK9gTSZQLUbpqz/58Rr3KuK7RTYxbclr7",
-    "bitwrench-code-edit.umd.js": "sha384-7WECGf8Zo3f+CalzAdPUxLcnSGNZU2CLH5KF/0jlC5e59/agNKBuAq8KAj5kzTZS",
-    "bitwrench-code-edit.umd.min.js": "sha384-hIlUdnfooER9fRK3CaFv0CbofGkJhMFBwVYjha2vM8da12kxG53VJp8ntUqgH6ER",
-    "bitwrench-lean.cjs.js": "sha384-lUUI6XztA8iBXUaAwHLEZvkr2qfRdzPpR1HIKbMC02hOFA/YVP9rcJjUcUeaRh1G",
-    "bitwrench-lean.cjs.min.js": "sha384-YQwhJXo3ZXjk7ijjMJoRBc7T5hMHqUkFIjqChjhfSKdVmPkkNl1wU2sGeypoUJ0V",
-    "bitwrench-lean.es5.js": "sha384-n+e23c7CBiv5vyOeqK20iNooX+tUcmmWbs7ZzNBgeX/49iyiar1pPUKrre0uqcaH",
-    "bitwrench-lean.es5.min.js": "sha384-jQSSsfyy/DAjxaixwfQguAz43oE+Pb4EQY4vQ2QmB+AdlK6Be7EOblIbdFAwdKqh",
-    "bitwrench-lean.esm.js": "sha384-1bivNtIh/1+k3lkkyytUMbOzzzKDI/KnLu/k04KQm4HbBt/5F2y1IbPJQK6AiKua",
-    "bitwrench-lean.esm.min.js": "sha384-HbXsASM7mEDKCgAUe4+CRcDZ+AzHlIV3d4x4gqqkd7rI29Mv3XzHd6yDP5AK62yv",
-    "bitwrench-lean.umd.js": "sha384-SUiymoHivY507YLbX3XDAkSfn7feMJ0ElzCh2QNSb6s4al9G97S0ezHOVsa0mnvR",
-    "bitwrench-lean.umd.min.js": "sha384-dWq237e2APvSFVTD/I1cRabyD4blHO9q/spdZtMKk/gmbPYiOhcocyaXR+SROgM2",
-    "bitwrench.cjs.js": "sha384-ZzcJBCi9aUwYjx5Sdww/YniuPbDdRstsO7L5L6xyBhH545rD8WR6VRZinjsUHq2J",
-    "bitwrench.cjs.min.js": "sha384-oFrUX8zWzam5K5xo2wX/cfgE1YEwZ5IH+n7qiTpayqgY4d9Pxlx2PinG7K9gXVGQ",
-    "bitwrench.css": "sha384-el6NYT+JrKiC7E5kLmTkixAWwvitbQj7cbOEOMTzbTPqiFFBsSNpHXONsNokDbiA",
-    "bitwrench.es5.js": "sha384-b0vYr/9npKCZTQeEt8wAiZO6bRrr0IPN8TkwSF9JM4y7u3Yx0tBEDTJ7E2outW0s",
-    "bitwrench.es5.min.js": "sha384-Y8vAGxrgcQ4IdWDwGpjvb3kC+IsitRnA6UmPuxCLpBcdrFRi+C91ZTLMzPo70k+L",
-    "bitwrench.esm.js": "sha384-KDJY68ddKz2K+5pS9pLt5vibM1+rCIrkflhX0uHZju+4h+hH8TyyOpNtZRRKuhJD",
-    "bitwrench.esm.min.js": "sha384-oMStlYxxW/E43uP6gZhwXSoqBwcZsZz/tDXnJFanOa7NzJ4GPI7NxDeFsD2FJXeA",
-    "bitwrench.umd.js": "sha384-k3atU2eNx5HW/2BxlpYfXCC2tcMtfmendk11UcLIUq6v0F/+mWsqZXQ58O5NA/4o",
-    "bitwrench.umd.min.js": "sha384-A8UhjSRrnhtxSOMcU8veknMpxDW4JvyVpd3VB4MFeMgmBJia9MUdsnZzoekN7OUg"
+    "bitwrench-bccl.cjs.js": "sha384-GwR2880Z60SZfdNaioTeRhUBXGyYoVU3MLylTyIPeUFxvodT/3Iet6V/WxyBMD/s",
+    "bitwrench-bccl.cjs.min.js": "sha384-Qwl5UPvUPdEYdMTcGKqPBJBsp8QhidEz8fk8yKfbS/3cqtMl5NaXbMJA2BoiwfKh",
+    "bitwrench-bccl.esm.js": "sha384-kHXaRUebkB7AJJjvfRyo55LwAljwnGo9QvTxdSAqbEqOYj+3X4O6IpNdKWBJHLcF",
+    "bitwrench-bccl.esm.min.js": "sha384-hcQjn5nawieZdF4y8RPH77VCeEFlIGNP+ZU6U/fYnxWfNEyO6d5ss2MRyQ5XFKyx",
+    "bitwrench-bccl.umd.js": "sha384-ICOeQchsjmDw5JKGRiTpzOZQFTeHdws4wxVtA9DAo+UVG7OnndU2yUcA9l+FHwH6",
+    "bitwrench-bccl.umd.min.js": "sha384-+v9FNivy9NRfWFRXRtkP6ZiEO9BMhazy+wzQtiQt1t2rE5CZW1vuOMNcJvBpzJHc",
+    "bitwrench-code-edit.cjs.js": "sha384-khga6vBpxusqbLfrzDgaUuyCoXgpWq74miYSMk7qhkiQP3AfXuAEoZpQnf0DttiS",
+    "bitwrench-code-edit.cjs.min.js": "sha384-hYMmfOiiw6x31dBGA2XuVxam6Z9hJlZrp+q3iti0kfSq3/BEDchNLF0y6VR7R4kX",
+    "bitwrench-code-edit.es5.js": "sha384-Ck1ishImBFkM4fRKK7oi9zJky7DDeOmXgkK0bSbWgogCMeW7DRpkm47hQRLVVRJw",
+    "bitwrench-code-edit.es5.min.js": "sha384-u9ykQEvMQIafDdWpMU3ecIrmx56v4MUCCOMkuyrYgGqR9vwTZZ/+1e/RbsOlNRc5",
+    "bitwrench-code-edit.esm.js": "sha384-E324MY+95O5lfS9pNSJo4INbAH19cW757B9nDcWAOtuna8TKMpYGV4ISB0fwOPDe",
+    "bitwrench-code-edit.esm.min.js": "sha384-KHv/eyr8QgXCTX0aPVH8K6Yy89AJ/0Kw7furwi5GleEDRWXDIaM2TzAcvJC7BAAA",
+    "bitwrench-code-edit.umd.js": "sha384-xXdbDll04ajtBsQX0axgamUFGN6QFMaJ2mRF+NltLk8W6DswOTcuTO3+HeUVowVr",
+    "bitwrench-code-edit.umd.min.js": "sha384-rVetnnzXOSu1IUM3rQMdMUy4aPpbzDXZJ6edtYhaf14Wsc3qjsfV/oaE1D3/ic0J",
+    "bitwrench-lean.cjs.js": "sha384-6G/GY13bZxw2fJnRYFTKMe5ID44pG00mI5fscEtcGOWsyXU66Z9x96tJ9gW2YFoJ",
+    "bitwrench-lean.cjs.min.js": "sha384-jPRTwWe3KtSyw0Jeihuds2mt78akR8sJLrg6KsGpapYOQu4jBEDluhlBxeYTV924",
+    "bitwrench-lean.es5.js": "sha384-HALcGiNdWAwTXHOSWBIM5Z8HNLqEiZxKkpshXV8aQYQEmi7ExZk5wVUSFnszt4Gx",
+    "bitwrench-lean.es5.min.js": "sha384-SesnIRrNdnucw77WgRDRqGYBoUOxLNuSjAvp9PncwRNLOHvE8xqSwq8O7lUCoHB6",
+    "bitwrench-lean.esm.js": "sha384-nuPtftCDpQZkupIb1qenEZgKMZSzvvKtwRomD8zIK4hJTsGYnvxA7z/ZhcmnjvAz",
+    "bitwrench-lean.esm.min.js": "sha384-96C4eWKwPY/T4/ZsVpoIldnThALDBRiE6RZ31U/gwyVVfoH2MZNAxzhH3IMPpqbf",
+    "bitwrench-lean.umd.js": "sha384-HRRlhaZtoFpQ+OJDjgTwsSs1pOJYcounIAVWNG8JB6OigF0dd/WAYV/kYpdfz1Hj",
+    "bitwrench-lean.umd.min.js": "sha384-F7r80Hn3REIH3VWG5YUtY+KujQE0cpGeQq833CJCfcaE5/c0dWoNvsNS1OGf2XE0",
+    "bitwrench.cjs.js": "sha384-Ew7bPhGDSA1Byb6Taso9W66aZo8H+/85RjHd1aH3uVfNz09qnPclOxbLAnHBhksT",
+    "bitwrench.cjs.min.js": "sha384-BdutYGxq7G9Tn/9J06jDSSCc1iK6aKEJ1KxjRbknZk8Et1gNmF0MomzELHmZfKQC",
+    "bitwrench.css": "sha384-TLf4tWABJynZ7cb9epG9VhRM1IvuK5k4VD5wHE2esbGXcuKzG6iArqimHPzZDLD2",
+    "bitwrench.es5.js": "sha384-gVwhjeTvWn5LhP1OqLAtS8sE/L8prV0zVV9KNJf+rKX3tJYdDAVNxLq1bvuXgggd",
+    "bitwrench.es5.min.js": "sha384-T7NCr/fxfLL7stlgkfrwZGSIYVXIF21e9M8K5QcWdElNFCBIGWlT59usFIDLgyMm",
+    "bitwrench.esm.js": "sha384-9a7cFRy55OaBzng4m6ixCUiSYWb+FN+7RcG2NyboJVQF0j6SnR0WpYR3ur8Hh8PH",
+    "bitwrench.esm.min.js": "sha384-XO2NYqeiOAvrmCZnFSPuC8yctfeZ6bfcPQhWMSbiDRwMDqqBwXyOpsVhUxjpflCo",
+    "bitwrench.min.css": "sha384-Sl7+BxWfINNnNdN+ZCL1s/p4Hn+5WeJPciWS9svNuzal8h9baX19xGeOJNzradRY",
+    "bitwrench.umd.js": "sha384-SBGSd5W8l78ZzK8XUU5FeHLE2fBB+WDgHJPtt9LkKBGkvP0TPVmfTwxcsLYA4MFO",
+    "bitwrench.umd.min.js": "sha384-jW9jzpLC07lcZ0KD7uXE8hi9J75zyCaogD5Goam0Dvmm4aofdJhy6iCVXe8Aj0jY",
+    "bwserve.cjs.js": "sha384-0mM2vNKrqS6RjlakI/4hmnnNte8/tjhiCiXZ+h+6+/IbhuyEWp1+CGXXnX97ZRZO",
+    "bwserve.esm.js": "sha384-dr2iHz8bI12AK7TMIzLc48Kvb4sIQ90w34isDil4EKtcasOeYg3Y5PjTGF3SWKqe"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bitwrench",
-	"version": "2.0.14",
+	"version": "2.0.16",
 	"description": "A library for javascript UI functions.",
 	"main": "./dist/bitwrench.umd.js",
 	"repository": {
@@ -13,7 +13,7 @@
 	"author": "manu a. chatterjee <deftio@deftio.com> (https://deftio.com/)",
 	"license": "BSD-2-Clause",
 	"bin": {
-		"bitwrench": "./bin/bitwrench.js"
+		"bwcli": "./bin/bwcli.js"
 	},
 	"type": "module",
 	"module": "./dist/bitwrench.esm.js",
@@ -22,6 +22,20 @@
 			"import": "./dist/bitwrench.esm.js",
 			"require": "./dist/bitwrench.cjs.js",
 			"default": "./dist/bitwrench.umd.js"
+		},
+		"./lean": {
+			"import": "./dist/bitwrench-lean.esm.js",
+			"require": "./dist/bitwrench-lean.cjs.js",
+			"default": "./dist/bitwrench-lean.umd.js"
+		},
+		"./bccl": {
+			"import": "./dist/bitwrench-bccl.esm.js",
+			"require": "./dist/bitwrench-bccl.cjs.js",
+			"default": "./dist/bitwrench-bccl.umd.js"
+		},
+		"./bwserve": {
+			"import": "./dist/bwserve.esm.js",
+			"require": "./dist/bwserve.cjs.js"
 		}
 	},
 	"types": "./dist/bitwrench.d.ts",
@@ -72,8 +86,8 @@
 	},
 	"scripts": {
 		"generate-version": "node tools/generate-version.cjs",
-		"prebuild": "npm run generate-version",
-		"build": "rollup --config && npm run build:css",
+		"prebuild": "npm run generate-version && npm run lint",
+		"build": "rollup --config && npm run build:css && npm run build:metrics",
 		"build:css": "node src/generate-css.js",
 		"build:readme": "node tools/build-readme.js",
 		"build:watch": "rollup --config --watch",
@@ -81,7 +95,8 @@
 		"build_1_x": "./tools/update-bw-package.js package.json package.json && ./tools/export-bw-default-css.js bitwrench.css && uglifyjs bitwrench.js -o  bitwrench.min.js && uglifyjs bitwrench_ESM.js -o bitwrench_ESM.min.js && ./tools/umd2ModuleHack.js && npm pack",
 		"cleanbuild": "npm run clean && npm run build && npm run build:generated",
 		"oldtest": "./node_modules/mocha/bin/mocha test/bitwrench_test.js --reporter spec",
-		"test": "c8 --reporter=text mocha ./test/bitwrench_ci.js ./test/bitwrench_test_coverage.js ./test/bitwrench_test_pubsub.js ./test/bitwrench_test_theme.js ./test/bitwrench_test_nodemap.js ./test/bitwrench_test_components.js -r jsdom-global/register",
+		"test": "c8 --reporter=text mocha ./test/bitwrench_ci.js ./test/bitwrench_test_coverage.js ./test/bitwrench_test_pubsub.js ./test/bitwrench_test_theme.js ./test/bitwrench_test_nodemap.js ./test/bitwrench_test_components.js ./test/bitwrench_test_component_handle.js ./test/bitwrench_test_coverage_gaps.js ./test/bitwrench_test_bwserve.js -r jsdom-global/register",
+		"test:bwserve": "mocha ./test/bitwrench_test_bwserve.js -r jsdom-global/register",
 		"test:components": "mocha ./test/bitwrench_test_components.js -r jsdom-global/register",
 		"test:v1": "c8 --reporter=text mocha ./test/bitwrench_test.js -r jsdom-global/",
 		"test:pending": "mocha ./test/bitwrench_test_pending.js -r jsdom-global/",
@@ -102,8 +117,10 @@
 		"test:examples": "playwright test tests/examples.spec.js",
 		"test:coverage": "c8 --reporter=html --reporter=text mocha ./test/bitwrench_ci.js -r jsdom-global/",
 		"build:api-reference": "node tools/build-api-reference.js",
+		"build:api-md": "node tools/build-api-markdown.js",
 		"build:builds": "node tools/build-builds-manifest.js",
-		"build:generated": "npm run generate-sri && npm run build:builds && npm run build:readme && npm run build:api-reference",
+		"build:metrics": "node tools/build-metrics.cjs",
+		"build:generated": "npm run generate-sri && npm run build:builds && npm run build:readme && npm run build:api-reference && npm run build:api-md",
 		"build:release": "npm run cleanbuild && npm run test && node tools/build-release.js",
 		"release": "node tools/release.js",
 		"start-release": "node tools/start-release.js"

package/readme.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <meta name="generator" content="bitwrench v2.0.14">
+  <meta name="generator" content="bitwrench v2.0.16">
   <title>bitwrench.js - README</title>
   <link rel="icon" type="image/x-icon" href="images/favicon.ico">
   <script src="dist/bitwrench.umd.js"></script>
@@ -44,15 +44,15 @@
 }
 .readme-body img { max-width: 100%; height: auto; }
 .readme-body table { border-collapse: collapse; width: 100%; margin: 1em 0; }
-.readme-body th, .readme-body td { border: 1px solid var(--bw-card-border); padding: 0.5em 0.75em; text-align: left; }
-.readme-body th { background: var(--bw-teal-bg); font-weight: 600; }
-.readme-body h2 { border-bottom: 1px solid var(--bw-card-border); padding-bottom: 0.3em; }
-.readme-body a { color: var(--bw-teal); }
-.readme-body a:hover { color: var(--bw-teal-dark); }
-.readme-body pre { background: var(--bw-code-bg); border-radius: 6px; overflow-x: auto; border: 1px solid rgba(0,0,0,0.1); }
-.readme-body pre code { display: block; padding: 1rem; color: var(--bw-code-text); font-family: var(--bw-font-mono); font-size: 0.8125rem; line-height: 1.6; background: transparent; border: none; }
-.readme-body code:not(pre code) { background: var(--bw-teal-light); color: var(--bw-teal-dark); padding: 0.15em 0.4em; border-radius: 3px; font-size: 0.85em; font-family: var(--bw-font-mono); }
-.readme-body blockquote { border-left: 4px solid var(--bw-teal); margin-left: 0; padding-left: 1em; color: var(--bw-text-secondary); }
+.readme-body th, .readme-body td { border: 1px solid var(--bw_card_border); padding: 0.5em 0.75em; text-align: left; }
+.readme-body th { background: var(--bw_teal_bg); font-weight: 600; }
+.readme-body h2 { border-bottom: 1px solid var(--bw_card_border); padding-bottom: 0.3em; }
+.readme-body a { color: var(--bw_teal); }
+.readme-body a:hover { color: var(--bw_teal_dark); }
+.readme-body pre { background: var(--bw_code_bg); border-radius: 6px; overflow-x: auto; border: 1px solid rgba(0,0,0,0.1); }
+.readme-body pre code { display: block; padding: 1rem; color: var(--bw_code_text); font-family: var(--bw_font_mono); font-size: 0.8125rem; line-height: 1.6; background: transparent; border: none; }
+.readme-body code:not(pre code) { background: var(--bw_teal_light); color: var(--bw_teal_dark); padding: 0.15em 0.4em; border-radius: 3px; font-size: 0.85em; font-family: var(--bw_font_mono); }
+.readme-body blockquote { border-left: 4px solid var(--bw_teal); margin-left: 0; padding-left: 1em; color: var(--bw_text_secondary); }
   </style>
 </head>
 <body>
@@ -96,7 +96,8 @@ const bw = require(&#39;bitwrench&#39;);</code></pre><p>Or include directly in a
 <li class="quikdown-li"><strong class="quikdown-strong">Built-in reactivity</strong> — <code class="quikdown-code">bw.update()</code> re-renders components when state changes, <code class="quikdown-code">bw.patch()</code> updates individual elements by ID, <code class="quikdown-code">bw.pub()</code>/<code class="quikdown-code">bw.sub()</code> provides decoupled messaging between any part of the application</li>
 <li class="quikdown-li"><strong class="quikdown-strong">CSS and theme generation</strong> — <code class="quikdown-code">bw.css()</code> generates stylesheets from objects, <code class="quikdown-code">bw.generateTheme()</code> derives a complete visual theme (buttons, alerts, badges, cards, forms, tables, dark mode) from 2-3 seed colors</li>
 <li class="quikdown-li"><strong class="quikdown-strong">45+ ready-made components</strong> — cards, buttons, sortable tables, form inputs, modals, dropdowns, accordions, tooltips, popovers, toasts, timelines, steppers, file uploads, stat cards — each a single function call that returns a composable object</li>
-<li class="quikdown-li"><strong class="quikdown-strong">Static site CLI</strong> — the <code class="quikdown-code">bitwrench</code> command converts Markdown, HTML, and JSON files into styled, self-contained pages with theme support</li>
+<li class="quikdown-li"><strong class="quikdown-strong">Server-driven UI (bwserve)</strong> — push TACO rendering commands from Node.js to the browser over SSE; same protocol works from C (ESP32), Python, Rust, or any language via the <code class="quikdown-code">bwcli serve</code> pipe server</li>
+<li class="quikdown-li"><strong class="quikdown-strong">Static site CLI</strong> — the <code class="quikdown-code">bwcli</code> command converts Markdown, HTML, and JSON files into styled, self-contained pages with theme support</li>
 <li class="quikdown-li"><strong class="quikdown-strong">Utilities</strong> — color interpolation, random data generation, lorem ipsum, cookies, URL params, file I/O for both browser and Node.js</li>
 </ul><h2 class="quikdown-h2">Getting Started</h2>
 <p><pre class="quikdown-pre"><code class="language-html">&lt;!DOCTYPE html&gt;
@@ -123,23 +124,24 @@ const bw = require(&#39;bitwrench&#39;);</code></pre><p>Or include directly in a
   &lt;/script&gt;
 &lt;/body&gt;
 &lt;/html&gt;</code></pre></p><h2 class="quikdown-h2">Adding State</h2>
-<p>The <code class="quikdown-code">o</code> key adds state and a render function to any element. When state changes, call <code class="quikdown-code">bw.update()</code> to re-render:</p><pre class="quikdown-pre"><code class="language-javascript">bw.DOM(&#39;#counter&#39;, {
-  t: &#39;div&#39;,
+<p>Wrap any TACO in <code class="quikdown-code">bw.component()</code> to get a reactive component with <code class="quikdown-code">.get()</code>, <code class="quikdown-code">.set()</code>, and template bindings:</p><pre class="quikdown-pre"><code class="language-javascript">var counter = bw.component({
+  t: &#39;div&#39;, c: [
+    { t: &#39;span&#39;, c: &#39;Count: ${count}&#39; },
+    { t: &#39;button&#39;, c: &#39;+1&#39;, a: {
+      onclick: function() { counter.set(&#39;count&#39;, counter.get(&#39;count&#39;) + 1); }
+    }}
+  ],
   o: {
     state: { count: 0 },
-    render: function(el) {
-      var s = el._bw_state;
-      bw.DOM(el, {
-        t: &#39;div&#39;, c: [
-          { t: &#39;span&#39;, c: &#39;Count: &#39; + s.count },
-          { t: &#39;button&#39;, a: {
-            onclick: function() { s.count++; bw.update(el); }
-          }, c: &#39;+1&#39; }
-        ]
-      });
+    methods: {
+      reset: function(comp) { comp.set(&#39;count&#39;, 0); }
     }
   }
-});</code></pre><p>For communication between components, use pub/sub:</p><pre class="quikdown-pre"><code class="language-javascript">bw.sub(&#39;item-added&#39;, function(detail) {
+});
+
+bw.DOM(&#39;#app&#39;, counter);
+counter.set(&#39;count&#39;, 42);   // DOM updates automatically
+counter.reset();             // methods from o.methods are callable on the handle</code></pre><p>For low-level control, you can also use <code class="quikdown-code">o.render</code> + <code class="quikdown-code">bw.update()</code> directly — see the <a class="quikdown-a" href="docs/state-management.md">State Management guide</a>.</p><p>For communication between components, use pub/sub:</p><pre class="quikdown-pre"><code class="language-javascript">bw.sub(&#39;item-added&#39;, function(detail) {
   console.log(&#39;New item:&#39;, detail.name);
 });
 
@@ -167,6 +169,10 @@ bw.toggleTheme();  // switch between primary and alternate palettes</code></pre>
 <td class="quikdown-td">Mount an object to a DOM element</td>
 </tr>
 <tr class="quikdown-tr">
+<td class="quikdown-td"><code class="quikdown-code">bw.component(taco)</code></td>
+<td class="quikdown-td">Wrap a TACO in a ComponentHandle with <code class="quikdown-code">.get()/.set()</code> reactive API</td>
+</tr>
+<tr class="quikdown-tr">
 <td class="quikdown-td"><code class="quikdown-code">bw.css(rules)</code></td>
 <td class="quikdown-td">Generate CSS from a JS object</td>
 </tr>
@@ -187,6 +193,10 @@ bw.toggleTheme();  // switch between primary and alternate palettes</code></pre>
 <td class="quikdown-td">Re-render via the element&#39;s <code class="quikdown-code">o.render</code> function</td>
 </tr>
 <tr class="quikdown-tr">
+<td class="quikdown-td"><code class="quikdown-code">bw.message(target, action, data)</code></td>
+<td class="quikdown-td">Send a message to a component by tag name</td>
+</tr>
+<tr class="quikdown-tr">
 <td class="quikdown-td"><code class="quikdown-code">bw.pub(topic, detail)</code></td>
 <td class="quikdown-td">Publish a message to subscribers</td>
 </tr>
@@ -194,16 +204,34 @@ bw.toggleTheme();  // switch between primary and alternate palettes</code></pre>
 <td class="quikdown-td"><code class="quikdown-code">bw.sub(topic, handler)</code></td>
 <td class="quikdown-td">Subscribe to a topic; returns an unsub function</td>
 </tr>
+<tr class="quikdown-tr">
+<td class="quikdown-td"><code class="quikdown-code">bw.inspect(target)</code></td>
+<td class="quikdown-td">Debug a component in the browser console</td>
+</tr>
+<tr class="quikdown-tr">
+<td class="quikdown-td"><code class="quikdown-code">bw.clientConnect(url, opts)</code></td>
+<td class="quikdown-td">Connect to a bwserve SSE endpoint</td>
+</tr>
+<tr class="quikdown-tr">
+<td class="quikdown-td"><code class="quikdown-code">bw.clientApply(msg)</code></td>
+<td class="quikdown-td">Apply a bwserve protocol message to the DOM</td>
+</tr>
+<tr class="quikdown-tr">
+<td class="quikdown-td"><code class="quikdown-code">bw.clientParse(str)</code></td>
+<td class="quikdown-td">Parse strict or r-prefix relaxed JSON</td>
+</tr>
 </tbody>
 </table><p>See the full <a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/08-api-reference.html" rel="noopener noreferrer">API Reference</a> for all functions.</p><h2 class="quikdown-h2">CLI</h2>
 <p>Convert Markdown, HTML, or JSON files to styled standalone pages:</p><pre class="quikdown-pre"><code class="language-bash"># Convert Markdown to a self-contained HTML page
-bitwrench README.md -o index.html --standalone
+bwcli README.md -o index.html --standalone
 
 # Apply a theme preset
-bitwrench doc.md -o doc.html --standalone --theme ocean
+bwcli doc.md -o doc.html --standalone --theme ocean
 
 # Custom colors
-bitwrench doc.md -o doc.html --standalone --theme &quot;#336699,#cc6633&quot;</code></pre><p>Flags: <code class="quikdown-code">--output/-o</code>, <code class="quikdown-code">--standalone/-s</code>, <code class="quikdown-code">--cdn</code>, <code class="quikdown-code">--theme/-t</code>, <code class="quikdown-code">--css/-c</code>, <code class="quikdown-code">--title</code>, <code class="quikdown-code">--favicon/-f</code>, <code class="quikdown-code">--highlight</code>, <code class="quikdown-code">--verbose/-v</code></p><h2 class="quikdown-h2">Build Formats</h2>
+bwcli doc.md -o doc.html --standalone --theme &quot;#336699,#cc6633&quot;</code></pre><p>Flags: <code class="quikdown-code">--output/-o</code>, <code class="quikdown-code">--standalone/-s</code>, <code class="quikdown-code">--cdn</code>, <code class="quikdown-code">--theme/-t</code>, <code class="quikdown-code">--css/-c</code>, <code class="quikdown-code">--title</code>, <code class="quikdown-code">--favicon/-f</code>, <code class="quikdown-code">--highlight</code>, <code class="quikdown-code">--verbose/-v</code></p><h3 class="quikdown-h3">Pipe Server</h3>
+<p><code class="quikdown-code">bwcli serve</code> turns any language into a bwserve backend — send JSON protocol messages via HTTP POST or stdin, and connected browsers update in real time:</p><pre class="quikdown-pre"><code class="language-bash">bwcli serve --port 8080 --input-port 9000
+curl -X POST http://localhost:9000 -d &#39;{&quot;type&quot;:&quot;patch&quot;,&quot;target&quot;:&quot;temp&quot;,&quot;content&quot;:&quot;23.5 C&quot;}&#39;</code></pre><h2 class="quikdown-h2">Build Formats</h2>
 <table class="quikdown-table">
 <thead class="quikdown-thead">
 <tr class="quikdown-tr">
@@ -235,19 +263,30 @@ bitwrench doc.md -o doc.html --standalone --theme &quot;#336699,#cc6633&quot;</c
 </tr>
 </tbody>
 </table><p>All formats include source maps. A separate CSS file (<code class="quikdown-code">bitwrench.css</code>) is also available for use without JavaScript.</p><h2 class="quikdown-h2">Documentation</h2>
-<ul class="quikdown-ul">
-<li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/" rel="noopener noreferrer">Interactive docs and demos</a> — full tutorial site with live examples</li>
+<strong class="quikdown-strong">Guides</strong> (in <code class="quikdown-code">docs/</code>):</p><ul class="quikdown-ul">
+<li class="quikdown-li"><a class="quikdown-a" href="docs/taco-format.md">TACO Format</a> — the <code class="quikdown-code">{t, a, c, o}</code> object format</li>
+<li class="quikdown-li"><a class="quikdown-a" href="docs/state-management.md">State Management</a> — three-level component model, ComponentHandle, reactive state</li>
+<li class="quikdown-li"><a class="quikdown-a" href="docs/component-library.md">Component Library</a> — all 50+ <code class="quikdown-code">make*()</code> functions with signatures and examples</li>
+<li class="quikdown-li"><a class="quikdown-a" href="docs/theming.md">Theming</a> — palette-driven theme generation, presets, design tokens</li>
+<li class="quikdown-li"><a class="quikdown-a" href="docs/cli.md">CLI</a> — the <code class="quikdown-code">bwcli</code> command for file conversion and pipe server</li>
+<li class="quikdown-li"><a class="quikdown-a" href="docs/bwserve.md">bwserve</a> — server-driven UI protocol (SSE, actions, embedded devices)</li>
+<li class="quikdown-li"><a class="quikdown-a" href="docs/llm-bitwrench-guide.md">LLM Guide</a> — compact single-file reference for AI-assisted development</li>
+</ul><p><strong class="quikdown-strong">Tutorials:</strong></p><ul class="quikdown-ul">
+<li class="quikdown-li"><a class="quikdown-a" href="docs/tutorial-website.md">Build a Website</a> — multi-section landing page from TACO objects</li>
+<li class="quikdown-li"><a class="quikdown-a" href="docs/tutorial-bwserve.md">bwserve Dashboard</a> — Streamlit-style server-push dashboard</li>
+<li class="quikdown-li"><a class="quikdown-a" href="docs/tutorial-embedded.md">ESP32 IoT Dashboard</a> — embedded sensor dashboard with C macros</li>
+</ul><p><strong class="quikdown-strong">Interactive demos</strong> (live site):</p><ul class="quikdown-ul">
 <li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/00-quick-start.html" rel="noopener noreferrer">Quick Start</a> — first steps with <code class="quikdown-code">bw.DOM()</code></li>
 <li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/01-components.html" rel="noopener noreferrer">Components</a> — buttons, cards, alerts, badges, navbars</li>
 <li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/03-styling.html" rel="noopener noreferrer">Styling &amp; Theming</a> — CSS generation and theming strategies</li>
-<li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/05-state.html" rel="noopener noreferrer">State &amp; Interactivity</a> — <code class="quikdown-code">bw.patch()</code>, <code class="quikdown-code">bw.update()</code>, pub/sub</li>
+<li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/05-state.html" rel="noopener noreferrer">State &amp; Interactivity</a> — state patterns and ComponentHandle</li>
 <li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/06-tic-tac-toe-tutorial.html" rel="noopener noreferrer">Tic Tac Toe Tutorial</a> — step-by-step game with state management</li>
 <li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/07-framework-comparison.html" rel="noopener noreferrer">Framework Comparison</a> — bitwrench vs React, Vue, Svelte</li>
-<li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/10-themes.html" rel="noopener noreferrer">Themes</a> — interactive theme generator with presets, dark mode, and CSS export</li>
+<li class="quikdown-li"><a class="quikdown-a" href="https://deftio.github.io/bitwrench/pages/10-themes.html" rel="noopener noreferrer">Themes</a> — interactive theme generator with presets and CSS export</li>
 </ul><h2 class="quikdown-h2">Development</h2>
 <p><pre class="quikdown-pre"><code class="language-bash">npm install          # install dev dependencies
 npm run build        # build all dist formats (UMD, ESM, CJS, ES5)
-npm test             # run unit tests (558 tests)
+npm test             # run unit tests (1000+ tests)
 npm run test:cli     # run CLI tests (49 tests)
 npm run test:e2e     # run Playwright browser tests
 npm run lint         # run ESLint

package/src/bitwrench-bccl-entry.js

@@ -0,0 +1,72 @@
+/**
+ * bitwrench-bccl-entry.js — Standalone entry point for BCCL component library.
+ *
+ * Use this alongside bitwrench-lean when you want the core library and
+ * BCCL components as separate files. The UMD build auto-registers all
+ * make*() functions onto the global `bw` object if present.
+ *
+ * Usage (browser):
+ *   <script src="bitwrench-lean.umd.min.js"></script>
+ *   <script src="bitwrench-bccl.umd.min.js"></script>
+ *
+ * Usage (ESM):
+ *   import bw from 'bitwrench/lean';
+ *   import { registerBCCL } from 'bitwrench/bccl';
+ *   registerBCCL(bw);
+ *
+ * @module bitwrench-bccl
+ * @license BSD-2-Clause
+ */
+
+import * as components from './bitwrench-bccl.js';
+
+/**
+ * Register all BCCL components onto a bitwrench instance.
+ * Called automatically in UMD builds when `bw` is a global.
+ *
+ * @param {Object} bw - The bitwrench instance to register on
+ */
+export function registerBCCL(bw) {
+  if (!bw) return;
+
+  // Register all make* functions
+  Object.entries(components).forEach(function(entry) {
+    var name = entry[0], fn = entry[1];
+    if (name.indexOf('make') === 0) {
+      bw[name] = fn;
+    }
+  });
+
+  // Factory dispatch: bw.make('card', props) → bw.makeCard(props)
+  bw.make = components.make;
+
+  // Component registry
+  bw.BCCL = components.BCCL;
+
+  // Variant class helper
+  bw.variantClass = components.variantClass;
+
+  // Create functions that return handles
+  if (typeof bw.renderComponent === 'function') {
+    Object.entries(components).forEach(function(entry) {
+      var name = entry[0], fn = entry[1];
+      if (name.indexOf('make') === 0) {
+        var createName = 'create' + name.substring(4);
+        bw[createName] = function(props) {
+          var taco = fn(props);
+          return bw.renderComponent(taco);
+        };
+      }
+    });
+  }
+}
+
+// Re-export all components for direct import
+export { BCCL, make, variantClass } from './bitwrench-bccl.js';
+
+// UMD auto-registration: if `bw` exists as a global, register automatically
+if (typeof window !== 'undefined' && typeof window.bw !== 'undefined') {
+  registerBCCL(window.bw);
+} else if (typeof globalThis !== 'undefined' && typeof globalThis.bw !== 'undefined') {
+  registerBCCL(globalThis.bw);
+}