bitwrench 2.0.25 → 2.0.31

package/dist/bwserve.cjs.js

@@ -1,4 +1,4 @@
-/*! bwserve v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bwserve v2.0.31 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 'use strict';
 
 Object.defineProperty(exports, '__esModule', { value: true });
@@ -14,7 +14,7 @@ var _documentCurrentScript = typeof document !== 'undefined' ? document.currentS
  * DO NOT EDIT DIRECTLY - Use npm run generate-version
  */
 
-const VERSION = '2.0.25';
+const VERSION = '2.0.31';
 
 /**
  * BwServeClient — per-client connection for bwserve.
@@ -280,6 +280,32 @@ class BwServeClient {
         return pend.promise;
     }
 
+    // ── Inspect ──
+
+    /**
+     * Inspect the DOM tree of the connected client.
+     *
+     * Calls the `_bw_tree` builtin on the client which delegates to
+     * `bw.inspect()` when available, returning a plain-object tree with
+     * bitwrench metadata (tag, uuid, type, handles, state, children).
+     *
+     * @param {string} [selector='body'] - CSS selector of root element
+     * @param {Object} [options]
+     * @param {number} [options.depth=3] - Max recursion depth
+     * @param {number} [options.timeout=10000] - Timeout in ms
+     * @returns {Promise<Object|null>} Tree object, or null if element not found
+     */
+    inspect(selector, options) {
+        var opts = options || {};
+        var pend = this._pend(opts.timeout || 10000);
+        this.call('_bw_tree', {
+            selector: selector || 'body',
+            depth: opts.depth || 3,
+            requestId: pend.requestId
+        });
+        return pend.promise;
+    }
+
     // ── Screenshot ──
 
     /**
@@ -435,8 +461,8 @@ var BWCLIENT_SOURCE = '(function(bw) {\n'
   + '  // ── Register built-in functions ──\n'
   + '  _client._registerBuiltins = function() {\n'
   + '    var builtins = {\n'
-  + '      scrollTo: "function(sel){var el=bw._el(sel);if(el)el.scrollTop=el.scrollHeight;}",\n'
-  + '      focus: "function(sel){var el=bw._el(sel);if(el&&typeof el.focus===\\"function\\")el.focus();}",\n'
+  + '      scrollTo: "function(sel){var el=bw.el(sel);if(el)el.scrollTop=el.scrollHeight;}",\n'
+  + '      focus: "function(sel){var el=bw.el(sel);if(el&&typeof el.focus===\\"function\\")el.focus();}",\n'
   + '      download: "function(fn,c,m){if(typeof document===\\"undefined\\")return;var b=new Blob([c],{type:m||\\"text/plain\\"});var a=document.createElement(\\"a\\");a.href=URL.createObjectURL(b);a.download=fn;a.click();URL.revokeObjectURL(a.href);}",\n'
   + '      clipboard: "function(t){if(typeof navigator!==\\"undefined\\"&&navigator.clipboard)navigator.clipboard.writeText(t);}",\n'
   + '      redirect: "function(u){if(typeof window!==\\"undefined\\")window.location.href=u;}",\n'
@@ -444,7 +470,7 @@ var BWCLIENT_SOURCE = '(function(bw) {\n'
   + '      _bw_query: "function(opts){if(!bw._bwClient)return;try{var r=new Function(opts.code)();if(r&&typeof r.then===\\"function\\"){r.then(function(v){bw._bwClient.respond(\\"query\\",opts.requestId,v);}).catch(function(e){bw._bwClient.respond(\\"query\\",opts.requestId,null,e.message);});}else{bw._bwClient.respond(\\"query\\",opts.requestId,r);}}catch(e){bw._bwClient.respond(\\"query\\",opts.requestId,null,e.message);}}",\n'
   + '      _bw_mount: "function(opts){if(!bw._bwClient)return;try{var taco;var f=opts.factory;var n=f.replace(/-([a-z])/g,function(_,c){return c.toUpperCase();});if(bw.BCCL&&bw.BCCL[n]){taco=bw.make(n,opts.props||{});}else if(bw._allowExec){taco=new Function(\\"props\\",f)(opts.props||{});}else{throw new Error(\\"Unknown component and allowExec disabled\\");}bw.DOM(opts.target,taco);bw._bwClient.respond(\\"mount\\",opts.requestId,{mounted:true});}catch(e){bw._bwClient.respond(\\"mount\\",opts.requestId,null,e.message);}}",\n'
   + '      _bw_screenshot: "function(opts){if(!bw._bwClient)return;var sel=opts.selector||\\"body\\";var el=document.querySelector(sel);if(!el){bw._bwClient.respond(\\"screenshot\\",opts.requestId,null,\\"Element not found: \\"+sel);return;}function _ls(url){return new Promise(function(res,rej){var s=document.createElement(\\"script\\");s.src=url;s.onload=function(){res(window.html2canvas);};s.onerror=function(){rej(new Error(\\"Failed to load html2canvas\\"));};document.head.appendChild(s);});}var p=window.html2canvas?Promise.resolve(window.html2canvas):_ls(opts.captureUrl||\\"/bw/lib/vendor/html2canvas.min.js\\");p.then(function(h2c){return h2c(el,{scale:opts.scale||1,useCORS:true});}).then(function(canvas){var out=canvas;var mw=opts.maxWidth;var mh=opts.maxHeight;if((mw&&canvas.width>mw)||(mh&&canvas.height>mh)){var sw=mw?mw/canvas.width:1;var sh=mh?mh/canvas.height:1;var sc=Math.min(sw,sh);out=document.createElement(\\"canvas\\");out.width=Math.round(canvas.width*sc);out.height=Math.round(canvas.height*sc);out.getContext(\\"2d\\").drawImage(canvas,0,0,out.width,out.height);}var fmt=opts.format===\\"jpeg\\"?\\"image/jpeg\\":\\"image/png\\";var q=opts.format===\\"jpeg\\"?(opts.quality||0.85):undefined;var dataUrl=out.toDataURL(fmt,q);bw._bwClient.respond(\\"screenshot\\",opts.requestId,{data:dataUrl,width:out.width,height:out.height,format:opts.format||\\"png\\"});}).catch(function(err){bw._bwClient.respond(\\"screenshot\\",opts.requestId,null,err.message||String(err));});}",\n'
-  + '      _bw_tree: "function(opts){if(!bw._bwClient)return;var sel=opts.selector||\\"body\\";var depth=opts.depth||3;function walk(el,d){if(!el||d>depth)return null;var info={tag:el.tagName?el.tagName.toLowerCase():\\"#text\\"};if(el.id)info.id=el.id;if(el.className&&typeof el.className===\\"string\\")info.cls=el.className.split(\\" \\").slice(0,5).join(\\" \\");if(el.children&&el.children.length>0&&d<depth){info.children=[];for(var i=0;i<Math.min(el.children.length,20);i++){var c=walk(el.children[i],d+1);if(c)info.children.push(c);}}return info;}var root=document.querySelector(sel);bw._bwClient.respond(\\"query\\",opts.requestId,walk(root,0));}",\n'
+  + '      _bw_tree: "function(opts){if(!bw._bwClient)return;var sel=opts.selector||\\"body\\";var depth=opts.depth||3;var root=document.querySelector(sel);if(typeof bw.inspect===\\"function\\"&&bw.inspect.length===2){bw._bwClient.respond(\\"query\\",opts.requestId,bw.inspect(root,depth));return;}function walk(el,d){if(!el||d>depth)return null;var info={tag:el.tagName?el.tagName.toLowerCase():\\"#text\\"};if(el.id)info.id=el.id;if(el.className&&typeof el.className===\\"string\\")info.cls=el.className.split(\\" \\").slice(0,5).join(\\" \\");if(el.children&&el.children.length>0&&d<depth){info.children=[];for(var i=0;i<Math.min(el.children.length,20);i++){var c=walk(el.children[i],d+1);if(c)info.children.push(c);}}return info;}bw._bwClient.respond(\\"query\\",opts.requestId,walk(root,0));}",\n'
   + '      _bw_listen: "function(opts){if(!bw._bwClient)return;if(!bw._bwClient._listeners)bw._bwClient._listeners={};var key=opts.selector+\\":::\\"+opts.event;if(bw._bwClient._listeners[key])return;var fn=function(e){var el=e.target.closest?e.target.closest(opts.selector):null;if(!el)return;bw._bwClient.respond(\\"event\\",null,{event:opts.event,selector:opts.selector,tagName:el.tagName,id:el.id||null,text:(el.textContent||\\"\\").slice(0,100)});};document.addEventListener(opts.event,fn,true);bw._bwClient._listeners[key]={fn:fn,event:opts.event};}",\n'
   + '      _bw_unlisten: "function(opts){if(!bw._bwClient||!bw._bwClient._listeners)return;var key=opts.selector+\\":::\\"+opts.event;var entry=bw._bwClient._listeners[key];if(!entry)return;document.removeEventListener(entry.event,entry.fn,true);delete bw._bwClient._listeners[key];}"\n'
   + '    };\n'
@@ -692,7 +718,21 @@ var MIME_TYPES = {
   '.woff': 'font/woff',
   '.woff2': 'font/woff2',
   '.ttf':  'font/ttf',
-  '.map':  'application/json'
+  '.map':  'application/json',
+  '.txt':  'text/plain; charset=utf-8',
+  '.xml':  'application/xml; charset=utf-8',
+  '.pdf':  'application/pdf',
+  '.zip':  'application/zip',
+  '.gz':   'application/gzip',
+  '.mp3':  'audio/mpeg',
+  '.mp4':  'video/mp4',
+  '.webm': 'video/webm',
+  '.webp': 'image/webp',
+  '.avif': 'image/avif',
+  '.wasm': 'application/wasm',
+  '.csv':  'text/csv; charset=utf-8',
+  '.md':   'text/markdown; charset=utf-8',
+  '.mjs':  'application/javascript; charset=utf-8'
 };
 
 /**
@@ -705,6 +745,8 @@ var MIME_TYPES = {
  * @param {boolean} [opts.injectBitwrench=true] - Auto-inject bitwrench client JS
  * @param {string|Object} [opts.theme] - Theme preset name or config object
  * @param {boolean} [opts.allowScreenshot=false] - Enable client.screenshot() capability
+ * @param {boolean} [opts.dirList=true] - Enable directory listings when no index.html
+ * @param {string} [opts.host='0.0.0.0'] - Host/address to bind to
  * @returns {BwServeApp} Application instance
  */
 function create(opts) {
@@ -725,6 +767,8 @@ class BwServeApp {
     this.theme = opts.theme || null;
     this.allowExec = opts.allowExec || false;
     this.allowScreenshot = opts.allowScreenshot || false;
+    this.dirList = opts.dirList !== false;
+    this.host = opts.host || '0.0.0.0';
     this.keepAliveInterval = opts.keepAliveInterval || 15000;
     this._pages = new Map();
     this._clients = new Map();
@@ -758,7 +802,7 @@ class BwServeApp {
         self._handleRequest(req, rawRes);
       });
 
-      self._server.listen(self.port, function() {
+      self._server.listen(self.port, self.host, function() {
         if (callback) callback();
         res();
       });
@@ -922,6 +966,32 @@ class BwServeApp {
         res.end(content);
         return;
       }
+      // Directory index resolution: /foo/ => /foo/index.html
+      if (path$1.endsWith('/')) {
+        var indexPath = path.join(this.staticDir, path$1, 'index.html');
+        if (fs.existsSync(indexPath) && fs.statSync(indexPath).isFile()) {
+          var indexContent = fs.readFileSync(indexPath);
+          res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+          res.end(indexContent);
+          return;
+        }
+        // Directory listing when no index.html
+        var dirPath = path.join(this.staticDir, path$1);
+        if (this.dirList && fs.existsSync(dirPath) && fs.statSync(dirPath).isDirectory()) {
+          var listing = this._generateDirListing(path$1, dirPath);
+          res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+          res.end(listing);
+          return;
+        }
+      }
+      // Bare directory without trailing slash: /foo => 301 to /foo/
+      if (!path$1.endsWith('/') && fs.existsSync(filePath) && fs.statSync(filePath).isDirectory()) {
+        var qs = url.split('?')[1];
+        var location = path$1 + '/' + (qs ? '?' + qs : '');
+        res.writeHead(301, { 'Location': location });
+        res.end();
+        return;
+      }
     }
 
     // 404
@@ -1091,6 +1161,69 @@ class BwServeApp {
     });
     res.end(content);
   }
+
+  /**
+   * Generate an HTML directory listing page.
+   * @private
+   * @param {string} urlPath - URL path (with trailing slash)
+   * @param {string} dirPath - Filesystem path to the directory
+   * @returns {string} HTML page
+   */
+  _generateDirListing(urlPath, dirPath) {
+    var entries = fs.readdirSync(dirPath);
+    var dirs = [];
+    var files = [];
+
+    for (var i = 0; i < entries.length; i++) {
+      var name = entries[i];
+      var fullPath = path.join(dirPath, name);
+      try {
+        var st = fs.statSync(fullPath);
+        if (st.isDirectory()) {
+          dirs.push({ name: name + '/', size: '-' });
+        } else {
+          files.push({ name: name, size: _formatSize(st.size) });
+        }
+      } catch (e) {
+        // Skip entries we cannot stat
+      }
+    }
+
+    // Sort alphabetically
+    dirs.sort(function(a, b) { return a.name.localeCompare(b.name); });
+    files.sort(function(a, b) { return a.name.localeCompare(b.name); });
+
+    var all = dirs.concat(files);
+
+    var rows = '';
+    // Parent directory link (unless at root)
+    if (urlPath !== '/') {
+      rows += '<tr><td><a href="../">..</a></td><td>-</td></tr>\n';
+    }
+    for (var j = 0; j < all.length; j++) {
+      var entry = all[j];
+      var escaped = entry.name.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+      rows += '<tr><td><a href="' + encodeURIComponent(entry.name.replace(/\/$/, '')) + (entry.size === '-' ? '/' : '') + '">' + escaped + '</a></td><td>' + entry.size + '</td></tr>\n';
+    }
+
+    var escapedPath = urlPath.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    return '<!DOCTYPE html>\n<html><head><meta charset="utf-8"><title>Index of ' + escapedPath + '</title>' +
+      '<style>body{font-family:monospace;margin:2em}table{border-collapse:collapse}td,th{text-align:left;padding:4px 16px}a{text-decoration:none}a:hover{text-decoration:underline}</style>' +
+      '</head><body><h1>Index of ' + escapedPath + '</h1><table><tr><th>Name</th><th>Size</th></tr>\n' +
+      rows + '</table></body></html>';
+  }
+}
+
+/**
+ * Format a byte size as a human-readable string.
+ * @param {number} bytes
+ * @returns {string}
+ */
+function _formatSize(bytes) {
+  if (bytes < 1024) return bytes + ' B';
+  if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(1) + ' KB';
+  if (bytes < 1024 * 1024 * 1024) return (bytes / (1024 * 1024)).toFixed(1) + ' MB';
+  return (bytes / (1024 * 1024 * 1024)).toFixed(1) + ' GB';
 }
 
 var version = VERSION;

package/dist/bwserve.esm.js

@@ -1,15 +1,15 @@
-/*! bwserve v2.0.25 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
+/*! bwserve v2.0.31 | BSD-2-Clause | https://deftio.github.com/bitwrench/pages */
 import { fileURLToPath } from 'url';
 import { dirname, resolve, join, extname } from 'path';
 import { createServer } from 'http';
-import { existsSync, statSync, readFileSync } from 'fs';
+import { existsSync, statSync, readFileSync, readdirSync } from 'fs';
 
 /**
  * Auto-generated version file from package.json
  * DO NOT EDIT DIRECTLY - Use npm run generate-version
  */
 
-const VERSION = '2.0.25';
+const VERSION = '2.0.31';
 
 /**
  * BwServeClient — per-client connection for bwserve.
@@ -275,6 +275,32 @@ class BwServeClient {
         return pend.promise;
     }
 
+    // ── Inspect ──
+
+    /**
+     * Inspect the DOM tree of the connected client.
+     *
+     * Calls the `_bw_tree` builtin on the client which delegates to
+     * `bw.inspect()` when available, returning a plain-object tree with
+     * bitwrench metadata (tag, uuid, type, handles, state, children).
+     *
+     * @param {string} [selector='body'] - CSS selector of root element
+     * @param {Object} [options]
+     * @param {number} [options.depth=3] - Max recursion depth
+     * @param {number} [options.timeout=10000] - Timeout in ms
+     * @returns {Promise<Object|null>} Tree object, or null if element not found
+     */
+    inspect(selector, options) {
+        var opts = options || {};
+        var pend = this._pend(opts.timeout || 10000);
+        this.call('_bw_tree', {
+            selector: selector || 'body',
+            depth: opts.depth || 3,
+            requestId: pend.requestId
+        });
+        return pend.promise;
+    }
+
     // ── Screenshot ──
 
     /**
@@ -430,8 +456,8 @@ var BWCLIENT_SOURCE = '(function(bw) {\n'
   + '  // ── Register built-in functions ──\n'
   + '  _client._registerBuiltins = function() {\n'
   + '    var builtins = {\n'
-  + '      scrollTo: "function(sel){var el=bw._el(sel);if(el)el.scrollTop=el.scrollHeight;}",\n'
-  + '      focus: "function(sel){var el=bw._el(sel);if(el&&typeof el.focus===\\"function\\")el.focus();}",\n'
+  + '      scrollTo: "function(sel){var el=bw.el(sel);if(el)el.scrollTop=el.scrollHeight;}",\n'
+  + '      focus: "function(sel){var el=bw.el(sel);if(el&&typeof el.focus===\\"function\\")el.focus();}",\n'
   + '      download: "function(fn,c,m){if(typeof document===\\"undefined\\")return;var b=new Blob([c],{type:m||\\"text/plain\\"});var a=document.createElement(\\"a\\");a.href=URL.createObjectURL(b);a.download=fn;a.click();URL.revokeObjectURL(a.href);}",\n'
   + '      clipboard: "function(t){if(typeof navigator!==\\"undefined\\"&&navigator.clipboard)navigator.clipboard.writeText(t);}",\n'
   + '      redirect: "function(u){if(typeof window!==\\"undefined\\")window.location.href=u;}",\n'
@@ -439,7 +465,7 @@ var BWCLIENT_SOURCE = '(function(bw) {\n'
   + '      _bw_query: "function(opts){if(!bw._bwClient)return;try{var r=new Function(opts.code)();if(r&&typeof r.then===\\"function\\"){r.then(function(v){bw._bwClient.respond(\\"query\\",opts.requestId,v);}).catch(function(e){bw._bwClient.respond(\\"query\\",opts.requestId,null,e.message);});}else{bw._bwClient.respond(\\"query\\",opts.requestId,r);}}catch(e){bw._bwClient.respond(\\"query\\",opts.requestId,null,e.message);}}",\n'
   + '      _bw_mount: "function(opts){if(!bw._bwClient)return;try{var taco;var f=opts.factory;var n=f.replace(/-([a-z])/g,function(_,c){return c.toUpperCase();});if(bw.BCCL&&bw.BCCL[n]){taco=bw.make(n,opts.props||{});}else if(bw._allowExec){taco=new Function(\\"props\\",f)(opts.props||{});}else{throw new Error(\\"Unknown component and allowExec disabled\\");}bw.DOM(opts.target,taco);bw._bwClient.respond(\\"mount\\",opts.requestId,{mounted:true});}catch(e){bw._bwClient.respond(\\"mount\\",opts.requestId,null,e.message);}}",\n'
   + '      _bw_screenshot: "function(opts){if(!bw._bwClient)return;var sel=opts.selector||\\"body\\";var el=document.querySelector(sel);if(!el){bw._bwClient.respond(\\"screenshot\\",opts.requestId,null,\\"Element not found: \\"+sel);return;}function _ls(url){return new Promise(function(res,rej){var s=document.createElement(\\"script\\");s.src=url;s.onload=function(){res(window.html2canvas);};s.onerror=function(){rej(new Error(\\"Failed to load html2canvas\\"));};document.head.appendChild(s);});}var p=window.html2canvas?Promise.resolve(window.html2canvas):_ls(opts.captureUrl||\\"/bw/lib/vendor/html2canvas.min.js\\");p.then(function(h2c){return h2c(el,{scale:opts.scale||1,useCORS:true});}).then(function(canvas){var out=canvas;var mw=opts.maxWidth;var mh=opts.maxHeight;if((mw&&canvas.width>mw)||(mh&&canvas.height>mh)){var sw=mw?mw/canvas.width:1;var sh=mh?mh/canvas.height:1;var sc=Math.min(sw,sh);out=document.createElement(\\"canvas\\");out.width=Math.round(canvas.width*sc);out.height=Math.round(canvas.height*sc);out.getContext(\\"2d\\").drawImage(canvas,0,0,out.width,out.height);}var fmt=opts.format===\\"jpeg\\"?\\"image/jpeg\\":\\"image/png\\";var q=opts.format===\\"jpeg\\"?(opts.quality||0.85):undefined;var dataUrl=out.toDataURL(fmt,q);bw._bwClient.respond(\\"screenshot\\",opts.requestId,{data:dataUrl,width:out.width,height:out.height,format:opts.format||\\"png\\"});}).catch(function(err){bw._bwClient.respond(\\"screenshot\\",opts.requestId,null,err.message||String(err));});}",\n'
-  + '      _bw_tree: "function(opts){if(!bw._bwClient)return;var sel=opts.selector||\\"body\\";var depth=opts.depth||3;function walk(el,d){if(!el||d>depth)return null;var info={tag:el.tagName?el.tagName.toLowerCase():\\"#text\\"};if(el.id)info.id=el.id;if(el.className&&typeof el.className===\\"string\\")info.cls=el.className.split(\\" \\").slice(0,5).join(\\" \\");if(el.children&&el.children.length>0&&d<depth){info.children=[];for(var i=0;i<Math.min(el.children.length,20);i++){var c=walk(el.children[i],d+1);if(c)info.children.push(c);}}return info;}var root=document.querySelector(sel);bw._bwClient.respond(\\"query\\",opts.requestId,walk(root,0));}",\n'
+  + '      _bw_tree: "function(opts){if(!bw._bwClient)return;var sel=opts.selector||\\"body\\";var depth=opts.depth||3;var root=document.querySelector(sel);if(typeof bw.inspect===\\"function\\"&&bw.inspect.length===2){bw._bwClient.respond(\\"query\\",opts.requestId,bw.inspect(root,depth));return;}function walk(el,d){if(!el||d>depth)return null;var info={tag:el.tagName?el.tagName.toLowerCase():\\"#text\\"};if(el.id)info.id=el.id;if(el.className&&typeof el.className===\\"string\\")info.cls=el.className.split(\\" \\").slice(0,5).join(\\" \\");if(el.children&&el.children.length>0&&d<depth){info.children=[];for(var i=0;i<Math.min(el.children.length,20);i++){var c=walk(el.children[i],d+1);if(c)info.children.push(c);}}return info;}bw._bwClient.respond(\\"query\\",opts.requestId,walk(root,0));}",\n'
   + '      _bw_listen: "function(opts){if(!bw._bwClient)return;if(!bw._bwClient._listeners)bw._bwClient._listeners={};var key=opts.selector+\\":::\\"+opts.event;if(bw._bwClient._listeners[key])return;var fn=function(e){var el=e.target.closest?e.target.closest(opts.selector):null;if(!el)return;bw._bwClient.respond(\\"event\\",null,{event:opts.event,selector:opts.selector,tagName:el.tagName,id:el.id||null,text:(el.textContent||\\"\\").slice(0,100)});};document.addEventListener(opts.event,fn,true);bw._bwClient._listeners[key]={fn:fn,event:opts.event};}",\n'
   + '      _bw_unlisten: "function(opts){if(!bw._bwClient||!bw._bwClient._listeners)return;var key=opts.selector+\\":::\\"+opts.event;var entry=bw._bwClient._listeners[key];if(!entry)return;document.removeEventListener(entry.event,entry.fn,true);delete bw._bwClient._listeners[key];}"\n'
   + '    };\n'
@@ -687,7 +713,21 @@ var MIME_TYPES = {
   '.woff': 'font/woff',
   '.woff2': 'font/woff2',
   '.ttf':  'font/ttf',
-  '.map':  'application/json'
+  '.map':  'application/json',
+  '.txt':  'text/plain; charset=utf-8',
+  '.xml':  'application/xml; charset=utf-8',
+  '.pdf':  'application/pdf',
+  '.zip':  'application/zip',
+  '.gz':   'application/gzip',
+  '.mp3':  'audio/mpeg',
+  '.mp4':  'video/mp4',
+  '.webm': 'video/webm',
+  '.webp': 'image/webp',
+  '.avif': 'image/avif',
+  '.wasm': 'application/wasm',
+  '.csv':  'text/csv; charset=utf-8',
+  '.md':   'text/markdown; charset=utf-8',
+  '.mjs':  'application/javascript; charset=utf-8'
 };
 
 /**
@@ -700,6 +740,8 @@ var MIME_TYPES = {
  * @param {boolean} [opts.injectBitwrench=true] - Auto-inject bitwrench client JS
  * @param {string|Object} [opts.theme] - Theme preset name or config object
  * @param {boolean} [opts.allowScreenshot=false] - Enable client.screenshot() capability
+ * @param {boolean} [opts.dirList=true] - Enable directory listings when no index.html
+ * @param {string} [opts.host='0.0.0.0'] - Host/address to bind to
  * @returns {BwServeApp} Application instance
  */
 function create(opts) {
@@ -720,6 +762,8 @@ class BwServeApp {
     this.theme = opts.theme || null;
     this.allowExec = opts.allowExec || false;
     this.allowScreenshot = opts.allowScreenshot || false;
+    this.dirList = opts.dirList !== false;
+    this.host = opts.host || '0.0.0.0';
     this.keepAliveInterval = opts.keepAliveInterval || 15000;
     this._pages = new Map();
     this._clients = new Map();
@@ -753,7 +797,7 @@ class BwServeApp {
         self._handleRequest(req, rawRes);
       });
 
-      self._server.listen(self.port, function() {
+      self._server.listen(self.port, self.host, function() {
         if (callback) callback();
         res();
       });
@@ -917,6 +961,32 @@ class BwServeApp {
         res.end(content);
         return;
       }
+      // Directory index resolution: /foo/ => /foo/index.html
+      if (path.endsWith('/')) {
+        var indexPath = join(this.staticDir, path, 'index.html');
+        if (existsSync(indexPath) && statSync(indexPath).isFile()) {
+          var indexContent = readFileSync(indexPath);
+          res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+          res.end(indexContent);
+          return;
+        }
+        // Directory listing when no index.html
+        var dirPath = join(this.staticDir, path);
+        if (this.dirList && existsSync(dirPath) && statSync(dirPath).isDirectory()) {
+          var listing = this._generateDirListing(path, dirPath);
+          res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+          res.end(listing);
+          return;
+        }
+      }
+      // Bare directory without trailing slash: /foo => 301 to /foo/
+      if (!path.endsWith('/') && existsSync(filePath) && statSync(filePath).isDirectory()) {
+        var qs = url.split('?')[1];
+        var location = path + '/' + (qs ? '?' + qs : '');
+        res.writeHead(301, { 'Location': location });
+        res.end();
+        return;
+      }
     }
 
     // 404
@@ -1086,6 +1156,69 @@ class BwServeApp {
     });
     res.end(content);
   }
+
+  /**
+   * Generate an HTML directory listing page.
+   * @private
+   * @param {string} urlPath - URL path (with trailing slash)
+   * @param {string} dirPath - Filesystem path to the directory
+   * @returns {string} HTML page
+   */
+  _generateDirListing(urlPath, dirPath) {
+    var entries = readdirSync(dirPath);
+    var dirs = [];
+    var files = [];
+
+    for (var i = 0; i < entries.length; i++) {
+      var name = entries[i];
+      var fullPath = join(dirPath, name);
+      try {
+        var st = statSync(fullPath);
+        if (st.isDirectory()) {
+          dirs.push({ name: name + '/', size: '-' });
+        } else {
+          files.push({ name: name, size: _formatSize(st.size) });
+        }
+      } catch (e) {
+        // Skip entries we cannot stat
+      }
+    }
+
+    // Sort alphabetically
+    dirs.sort(function(a, b) { return a.name.localeCompare(b.name); });
+    files.sort(function(a, b) { return a.name.localeCompare(b.name); });
+
+    var all = dirs.concat(files);
+
+    var rows = '';
+    // Parent directory link (unless at root)
+    if (urlPath !== '/') {
+      rows += '<tr><td><a href="../">..</a></td><td>-</td></tr>\n';
+    }
+    for (var j = 0; j < all.length; j++) {
+      var entry = all[j];
+      var escaped = entry.name.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+      rows += '<tr><td><a href="' + encodeURIComponent(entry.name.replace(/\/$/, '')) + (entry.size === '-' ? '/' : '') + '">' + escaped + '</a></td><td>' + entry.size + '</td></tr>\n';
+    }
+
+    var escapedPath = urlPath.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    return '<!DOCTYPE html>\n<html><head><meta charset="utf-8"><title>Index of ' + escapedPath + '</title>' +
+      '<style>body{font-family:monospace;margin:2em}table{border-collapse:collapse}td,th{text-align:left;padding:4px 16px}a{text-decoration:none}a:hover{text-decoration:underline}</style>' +
+      '</head><body><h1>Index of ' + escapedPath + '</h1><table><tr><th>Name</th><th>Size</th></tr>\n' +
+      rows + '</table></body></html>';
+  }
+}
+
+/**
+ * Format a byte size as a human-readable string.
+ * @param {number} bytes
+ * @returns {string}
+ */
+function _formatSize(bytes) {
+  if (bytes < 1024) return bytes + ' B';
+  if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(1) + ' KB';
+  if (bytes < 1024 * 1024 * 1024) return (bytes / (1024 * 1024)).toFixed(1) + ' MB';
+  return (bytes / (1024 * 1024 * 1024)).toFixed(1) + ' GB';
 }
 
 var version = VERSION;

package/dist/sri.json

@@ -1,51 +1,51 @@
 {
-  "version": "2.0.25",
+  "version": "2.0.31",
   "algorithm": "sha384",
-  "generated": "2026-03-31",
+  "generated": "2026-04-12",
   "files": {
-    "bitwrench-bccl.cjs.js": "sha384-RA66j3cZJmQZMYv4wHTmYJFMZHnCCQw1Zn8UcAia7WI4NmGZA3RxLMCHg5IcpQSy",
-    "bitwrench-bccl.cjs.min.js": "sha384-UVKyX6Ep7ITUok4aQ5SpAo56pr/unOqNX1rg0Nqd5TdFRfS/QLsvdpB5i00k/Lp8",
-    "bitwrench-bccl.esm.js": "sha384-urwgpnwC8IpMjqShHzGgKjBVghNko0neSy1fkECY7MgFU3auHC2Bcn3MoK9E9BGU",
-    "bitwrench-bccl.esm.min.js": "sha384-oZNyOQt9pSv6MeG/1EbkcJjZimSHC+ObW3F6wbixFY2n9wgT+4kEjrBHUW7xah21",
-    "bitwrench-bccl.umd.js": "sha384-VGLCy3tnpKpvnjY/RvARW8mVoHZwycIk0fPbgbh//6xXC3rQEs/tntbqnAWw1oTa",
-    "bitwrench-bccl.umd.min.js": "sha384-o2IJV021qMlcfCCogT9BUCq7XGz5GkigYSnQfvybRx6kYNJC8txz5x/v5DjuqUUI",
-    "bitwrench-code-edit.cjs.js": "sha384-qhWEjthIXdWPGKz1CULfIbI4hv8m/n5ys7kXE0fIQYf4jsYCC1L4GukM5KRqRToS",
-    "bitwrench-code-edit.cjs.min.js": "sha384-HRxcDwX9dGKq0OghPsK8ZLiVEzzw1fiEU46qw8btM5hMqdv4x5EFnfkCWDW5LuV+",
-    "bitwrench-code-edit.es5.js": "sha384-M7p1KKOG1JGQeW0tQglvyTAUpqSLiDVMCr/CHpasi9/fWWukLBipQ/pDFUggtq86",
-    "bitwrench-code-edit.es5.min.js": "sha384-SImIBlVcBZ9Ex5jUsWpOAgtIBe+b8lnMGF1Ym8veGeD0VlY51s4i3u42eymJMjM1",
-    "bitwrench-code-edit.esm.js": "sha384-h0fE0qWyEVmYoOY/nqJX6bfWlKllg1wTyU7E3N2A8820ZICJ2KZPhDRCp7/BTz+o",
-    "bitwrench-code-edit.esm.min.js": "sha384-HtIhxNiVOUuAm33FYQkXAUJvSz33TqAKD6Uqv1iwyXlEJi1DrNd43glgL2VjNp7G",
-    "bitwrench-code-edit.umd.js": "sha384-jlE6Tns6Lr10JEWXHZUks8IyvsBYik0hWFynXOm6LXxE8jXrpPAEuTNTaa9VAOqY",
-    "bitwrench-code-edit.umd.min.js": "sha384-M6F7F7tqxV8EykfZrRv9bDOYZOwkHw9bH0znMHRnJo6MbwklnrY10rb808z4FcQF",
-    "bitwrench-debug.js": "sha384-dFXWL/RA55mOHgt9WtpcN2EUi5FP1NEdOXffQhTMg7HYQLjjDm+vfihwbHne4qpb",
-    "bitwrench-debug.min.js": "sha384-9xekM72GEadAZz/xeh3MmazFmS8lAyXOt9M5fLzjINPaIvk2Tyfr29a9e44GJGci",
-    "bitwrench-lean.cjs.js": "sha384-g/xiDIMH6SyLwVQZ4kBw7vd5mwItjwsFm7tt7lagmMPv1GLeq7TRnysAF7NYu1D/",
-    "bitwrench-lean.cjs.min.js": "sha384-NAu0XZcYl9esPSv9usftOKo0gKP3WFfITkErF4/F/nTeRss5HZEoP24OQTHJ0PIb",
-    "bitwrench-lean.es5.js": "sha384-md3746BNl73qHbL3qxHW9lJkSXxfl0iNtad8+ueyiNMMYmQtwqmgqcr5wv2Ifidh",
-    "bitwrench-lean.es5.min.js": "sha384-6eZcoh9giHgNLfx3dl8L/ZFNUyqYJRbiQtdEi1QPgD38A6Xu6oY/mNEHLgNdxAqY",
-    "bitwrench-lean.esm.js": "sha384-6mJxNfGQWSX5wZDHUfDQtoQop5J8r6mVTmpav2ro61Fc8nyPe91Mf06czeSGTzYB",
-    "bitwrench-lean.esm.min.js": "sha384-A6fDCS7onP178iZA98Ioi7WFmgANXK4gD7TGZTX4E/3FINGtgNJifn8ScEunwlKf",
-    "bitwrench-lean.umd.js": "sha384-tI59nJNwNFyhZOSX1uoGLVto0WQk0feHQx+GI71ahwyVbxhufS3mqSzXDLg6eCEY",
-    "bitwrench-lean.umd.min.js": "sha384-Lk1yDDqJbSTh3QoWl9t9WQqnOf3RqUdDswVgUPWFHbirBt77ZJF6v/MfT5cwWHFd",
-    "bitwrench-util-css.cjs.js": "sha384-eAabzZqdE8Cxj8XFWjOVQmpflXsxaPqFRMklbljSm8QgIUf03ll12xMNrnRdNQ00",
-    "bitwrench-util-css.cjs.min.js": "sha384-0eZt3OMTcA9V74g6Fo/udBm9jFTTT5/cHIa8UQ47z65hJKVpskOr95+l6La8VhxM",
-    "bitwrench-util-css.es5.js": "sha384-lF7JM6zgkGRpiPmHdBG08yUBlJjfGNEb5il9CRAkM4DfFaWcPuhG57K7JIcFsNf4",
-    "bitwrench-util-css.es5.min.js": "sha384-vPGI+zh9/gE2hyhlN2NeBxZzNpFuMB/CmQABBD8MOgbL5etd3iaq4UYGIjLBesmW",
-    "bitwrench-util-css.esm.js": "sha384-I/xcJwIp202GKLwIKIUqkiAWkoUQRFn7fNSorTv/DZe6WovBwpzWWAIr3A1o0ine",
-    "bitwrench-util-css.esm.min.js": "sha384-uY+4TDPxWPDWlpfnKP/0SYHZRx4XqxjSQPth1iKoG+uJ34UhiYmPu8Da+lDqXXd8",
-    "bitwrench-util-css.umd.js": "sha384-Dz9fjqZlIpFd68LNP1GQyTXt6VzwIsM19oxf9I8OQz/pqgO5+bvOjPleHnAd6AcG",
-    "bitwrench-util-css.umd.min.js": "sha384-RCuWraavRluQ5MEtVYWgtrEzSj8FanNT20plj0aYTP+60IHIlAeULwYYu6UkNt1i",
-    "bitwrench.cjs.js": "sha384-+6wWDHXlpihbUCMcfyuXx6JQn/xmUYFzsIykalbLVHALcWY/00J0dkE9ghNBwWsg",
-    "bitwrench.cjs.min.js": "sha384-um4doW2b9QMWnZFNeN75A12u7MgaxXqfTDD8RRY98TY9aB+Pp8wrOwVQSvYVcy8w",
-    "bitwrench.css": "sha384-y0YMF2B2xZF3TReu5KAuetdM7I/yFjJ7ATB9/pM//70PbXnn9+NBcb4fsb3cS2pe",
-    "bitwrench.es5.js": "sha384-ydqqwDi8AY8C9Ns7NughmVlzA7ZMpTIyYB+0+ZWghf1j5btx5Y0Rptx4wU7rxYGJ",
-    "bitwrench.es5.min.js": "sha384-LvrzQJLd5klWf3HVzRoDO8UNNSz3FXJ1WYhwdq4rZA70jqCSVH1kr1qOmqsc/dXB",
-    "bitwrench.esm.js": "sha384-lPKbGfBkur2VHJ2kzM11S9koP682I6roeITvEmRzm+R1A+YIqpHa3NWSj92p9w9k",
-    "bitwrench.esm.min.js": "sha384-JsRZBx7Iu4030QDS+5g9EIx3wHonD3rtvuFElKBCQVXgyKsCHsvuQIFVqnS4dcOb",
+    "bitwrench-bccl.cjs.js": "sha384-g+bREqoEZobSTDOItkmaoOIh4P9mf1GQCAKRRtI/j6SEycBq/ruD0EsxniaOPamZ",
+    "bitwrench-bccl.cjs.min.js": "sha384-3mEr1QPj1kMr6xILZRZmlLNLYpEOkiAM/NGBCoxZFUtGX6atcOxzplW+Fl2y7+0N",
+    "bitwrench-bccl.esm.js": "sha384-67aNfMHkggJSQa5N7+8cEYYihmYRmNybS+CqQVRien4+uMGPBxCHC4w76H1yjtZw",
+    "bitwrench-bccl.esm.min.js": "sha384-jmhO+xdKNGc13zmpYSu4UAiRnHbeBgEfHpgtrm376pJ+Bq4elgmAkIrqtr5nRbQp",
+    "bitwrench-bccl.umd.js": "sha384-7euK145GD8glzY1722Tc5AcMLftkUcnElt4QWxHTRynKFTmMLKVINAsCXxgMfVaQ",
+    "bitwrench-bccl.umd.min.js": "sha384-h1B+7k8xaoAWnFYfTXbSljkU9qTJb9nMYFWBhS/lXLkf90yu8ynzrC5ORoYqevi/",
+    "bitwrench-code-edit.cjs.js": "sha384-Ekls5sTQn5J+AZHydpz9L41kvojclPk2Xjgf9q3bAcu+w31sYIgUFWCRXwNjBb9r",
+    "bitwrench-code-edit.cjs.min.js": "sha384-ay5kEd9OnDQeSCeAZuDqUaZYmdI+8KXyUMWxVU1Ks3NUgCsuszk+eIt4gUgahqqb",
+    "bitwrench-code-edit.es5.js": "sha384-gzUHN64sJj9ROmEZuqsoWFp6i/V4L6gDy5TKuLLir+5scfnopxZLaSwwXzxG08CP",
+    "bitwrench-code-edit.es5.min.js": "sha384-2TIS1ABSa0cn0P7LE3vgkHM4RDMttfzOIxyqgyCWY56G6g68jd3rJJ22zgcbdojm",
+    "bitwrench-code-edit.esm.js": "sha384-Jnlrp+W1Osrtmv81vYJ/1OgvICgaekEb9DCpmmZVr1KKPzGGrzfJBocmoBvwWPyB",
+    "bitwrench-code-edit.esm.min.js": "sha384-/rGVBJaZqCOHT2BIwvW9wX2QZ6Mb+WO3Q8URi8zrkG4yoB+Sguj/5V4XAsifMmG4",
+    "bitwrench-code-edit.umd.js": "sha384-I0lPZhUKsBZZR8CzgA7bPHRVUBEG4EGAISudQv7Y17j/4dbdiNzqUeMlDDl596Lt",
+    "bitwrench-code-edit.umd.min.js": "sha384-+/fx7WThOnpKiAnGftDIKyw+jgUE0mHXOpeLOg92hXkJ9db+JX7kdYKt3+NZdgUs",
+    "bitwrench-debug.js": "sha384-Y4XKfgz6PTTaFH2Dix2s8LHrF3LYjqSxb4HL5BJbeJCsTXxUtiJtL2iXK9Q1Jjjm",
+    "bitwrench-debug.min.js": "sha384-Oq6Ifg/M2kNLPm/PU+G9lGz7k+mrfnwbb682OZo0vcwmW0mqD6kQRgZsSzvs3Zk3",
+    "bitwrench-lean.cjs.js": "sha384-tDE21mhY4wK2IKVSr8RTUXmALY1PzWkGtOaaP+j/2hyq9D5fWRqlwSeZuzchpzBE",
+    "bitwrench-lean.cjs.min.js": "sha384-HMV724gyzbWQIeZqCA7hKOldeKmeXGC0qRCjU0O+vwOE6NOYdh2QoUHfC2XrLFq0",
+    "bitwrench-lean.es5.js": "sha384-emU2M7HoqzSSZpTkIxE/WLTr+NyJJY2NWPy0yZ/m0SK0Tsi+07v+Ga48gQ0w6Zki",
+    "bitwrench-lean.es5.min.js": "sha384-azY3Ra//NFHnz9GWSFHU7+ykX0IFfuSMUcQzYGJMOxIkntluEvEStEWSC8zmMUU7",
+    "bitwrench-lean.esm.js": "sha384-4rgwMYIs+8F8YO91pUhvTdYNQQTwK9kFbLte0+IA5epp0vhypWAW91XeV4mif7Ht",
+    "bitwrench-lean.esm.min.js": "sha384-vzJjHbJjhMoNDV77pv6jUIxa54y0RcKVya/YfJjwU9P3vwbd9whO16GFcvrH2lXS",
+    "bitwrench-lean.umd.js": "sha384-HcoLWkzFGUrrXF0vb6NbpSxRT31+BZCuIWnF6PjHiGzli9m1F972Djt5bw4/U94T",
+    "bitwrench-lean.umd.min.js": "sha384-MwB/y0yT93N6uVLv6XHNPGRRkhhOJlhZuNK93dWm0Rfk+W3v/Ue1Wpyfe2SMJ6ec",
+    "bitwrench-util-css.cjs.js": "sha384-AOtO0LmNIlM0Db6JjwiXJXkqJXcYgAFOgXZRg2DsVPadOujTqSyu+0xW/hBUtX9y",
+    "bitwrench-util-css.cjs.min.js": "sha384-C/u6y4Ku3mKi/TYi8BsqXLHH+QOJGapjgfbuFnO/+6n2GRpdqLveN3kETWmRsnYr",
+    "bitwrench-util-css.es5.js": "sha384-07y+w3Vfsja7aysfVHQ70Wflwa8XjCpzkgamrkJfLhDVNwF9Hav3xWS8eNLSRjuu",
+    "bitwrench-util-css.es5.min.js": "sha384-XzcN9nNXn5ZWpVSgmg7TJZjtpp3i3e+gk8mZ7rDuDC83EgmEXoNBFhwJWbI2wsHX",
+    "bitwrench-util-css.esm.js": "sha384-mrmE9DDsN1kHxW7Dlh/1N6GlmbvDwVomn4Bjakkb0fDdTYOy/0dymp2DyxPS0HTP",
+    "bitwrench-util-css.esm.min.js": "sha384-MMn/HvHKZASAddOU2zD0MwdHH+fkcd5dx7eF2PpEhokAVo1+aY8pgZ+f+GkIiBgx",
+    "bitwrench-util-css.umd.js": "sha384-MKtAXDkkAX9gHfh9t2FikS0DQ9R4otG7JNyzInauZS2nb7tsd/ZGh//dwO+ob1ca",
+    "bitwrench-util-css.umd.min.js": "sha384-PHuLiNKRvvR0/nqHLkMZ+E3nh4VMKtOPppvjBhhjlI9baFECtT8gl0Hxgy2GkdPx",
+    "bitwrench.cjs.js": "sha384-glfbsEhz4gaiy8shr2Gu+XpByoxQ+WcO3NeBkPrTxSihsCmH053oLXlFhsC3hUPK",
+    "bitwrench.cjs.min.js": "sha384-wq9oSyr7/fdTolPFSV+EbdmgJU4djEnSAXgzJTFGrzKZJS9nDtJnY0m+uCBMtTiN",
+    "bitwrench.css": "sha384-gVfREIu0p9E0gp0cqKrIavfHDMPgay9pDctK2/BEtchIcViIJSSw7devR52ubWqr",
+    "bitwrench.es5.js": "sha384-RBjH+7YnynSh2EQ8OyhOeQv5cKZ0vwyqfCAIhn5/oOJxcP6vM/sxqUZRO751v4F/",
+    "bitwrench.es5.min.js": "sha384-vdBw8nOsqshb4g5cygdBZOQzFHsu1Z8FlBmj/RPel/sZt9CUD6/lz1XCN6VxXtVR",
+    "bitwrench.esm.js": "sha384-VJP0xOXk5d7pnhASh2XmgW8dhCe6df8b9bVVtNzp7NyPPLYaG6TwcsvSwf4AMDhR",
+    "bitwrench.esm.min.js": "sha384-WKh0HlTypEUTiv50VV5A/jvjV63zRGGg2mp2oA1tfD+t3d/Ab6EUB8AIN+Q/PVRx",
     "bitwrench.min.css": "sha384-4ymUTaU2kwrsPLCsEGReVJe2rGzsHkNG1BjrHB7EGAOqMK+SgRvaHPoYUFk7tXSE",
-    "bitwrench.umd.js": "sha384-trTM4NoRCWS6uVju/sVT/+qrQqAWc2ykIiIJ6EgdqKKWMfWLSj7A63egxbuaesZC",
-    "bitwrench.umd.min.js": "sha384-uYz9u6YCCcaYyJ5SFjvgLo3j+ThD6WgciFEFtlk6t36dgp2d9rsxvVPG5QTLC8Sy",
-    "bwserve.cjs.js": "sha384-fs6zRLlgLSMl167JZR29LNzjOcOhNjXtJpfpg8Y2xDRmGMJNKK6fBMfSXxnD58Ed",
-    "bwserve.esm.js": "sha384-ZXn4aIBNgPdwr6QaDGqV9WTCqFIAgWgndQpHs6wZbR9WrErO12kifamD3qaZONOb"
+    "bitwrench.umd.js": "sha384-LynAfOeVKIZ4kjlFhnZF62qGdv+WPAjOc397YebvINS5eOhfyW3vs+ADIIrZut3H",
+    "bitwrench.umd.min.js": "sha384-vWftG5Z0Xnd2aMbiYBtkrpswWUsrkJ6rTLohn9ZWIhssjy76iWeJaEnSifE9/V7J",
+    "bwserve.cjs.js": "sha384-Vm1L58xaNNymEJhthSNr7HbJTBa8HeA6+H5SlPD3ED0PXDXd1dTZXcH5Q+fvRo4u",
+    "bwserve.esm.js": "sha384-jrJao6NSXHoZnkV1CkAWbCs1y9dDBQWXiW5B66vN8NogNP3WOtVYFsLSd+S0nTAU"
   }
 }