@seanhogg/builderforce-webcontainers-core 2026.10.6 → 2026.10.8

package/dist/node/http/upgradeSocket.js

@@ -0,0 +1,73 @@
+/**
+ * The socket an `http.Server` hands its `upgrade` listeners: a real Duplex
+ * over the upgraded connection's byte pipe, with the slice of net.Socket that
+ * WebSocket servers touch (`ws` writes its `101` reply and frames with
+ * `write(data, cb)`, corks, pauses, reads `_readableState`, and calls
+ * `setNoDelay`/`setTimeout`). Raw bytes only — framing is the package's job.
+ */
+import { Buffer } from '../buffer.js';
+import { Duplex } from '../stream/index.js';
+export class UpgradeSocket extends Duplex {
+    channel;
+    remoteAddress = '127.0.0.1';
+    remotePort = 50000 + Math.floor(Math.random() * 10000);
+    remoteFamily = 'IPv4';
+    localAddress = '127.0.0.1';
+    localPort;
+    encrypted = false;
+    connecting = false;
+    bytesRead = 0;
+    bytesWritten = 0;
+    release;
+    /** `hold` keeps the process alive while the connection is open, as a TCP socket would. */
+    constructor(channel, port, hold) {
+        super({ allowHalfOpen: false });
+        this.channel = channel;
+        this.localPort = port;
+        this.release = hold?.();
+        channel.onData((data) => {
+            this.bytesRead += data.byteLength;
+            this.push(Buffer.from(data.buffer, data.byteOffset, data.byteLength));
+        });
+        channel.onClose(() => {
+            this.push(null);
+            this.end();
+        });
+        this.once('close', () => {
+            this.release?.();
+            this.release = undefined;
+        });
+    }
+    _read() {
+        // bytes are pushed as they arrive
+    }
+    _write(chunk, _encoding, callback) {
+        this.bytesWritten += chunk.byteLength;
+        this.channel.send(chunk);
+        callback();
+    }
+    _final(callback) {
+        this.channel.close();
+        this.push(null);
+        callback();
+    }
+    _destroy(error, callback) {
+        this.channel.close();
+        callback(error);
+    }
+    setTimeout(_ms, cb) {
+        if (cb)
+            this.once('timeout', cb);
+        return this;
+    }
+    setNoDelay() { return this; }
+    setKeepAlive() { return this; }
+    address() { return { address: this.localAddress, family: 'IPv4', port: this.localPort }; }
+    ref() { return this; }
+    unref() {
+        this.release?.();
+        this.release = undefined;
+        return this;
+    }
+}
+//# sourceMappingURL=upgradeSocket.js.map

package/dist/node/http/upgradeSocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgradeSocket.js","sourceRoot":"","sources":["../../../src/node/http/upgradeSocket.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAK5C,MAAM,OAAO,aAAc,SAAQ,MAAM;IAaV;IAZ7B,aAAa,GAAG,WAAW,CAAC;IAC5B,UAAU,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IACvD,YAAY,GAAG,MAAM,CAAC;IACtB,YAAY,GAAG,WAAW,CAAC;IAC3B,SAAS,CAAS;IAClB,SAAS,GAAG,KAAK,CAAC;IAClB,UAAU,GAAG,KAAK,CAAC;IACnB,SAAS,GAAG,CAAC,CAAC;IACd,YAAY,GAAG,CAAC,CAAC;IACT,OAAO,CAAc;IAE7B,0FAA0F;IAC1F,YAA6B,OAAoB,EAAE,IAAY,EAAE,IAAuB;QACtF,KAAK,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;QADL,YAAO,GAAP,OAAO,CAAa;QAE/C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACtB,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAqB,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;YACnB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK;QACZ,kCAAkC;IACpC,CAAC;IAED,MAAM,CAAC,KAAiB,EAAE,SAAiB,EAAE,QAAkB;QAC7D,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,MAAM,CAAC,QAAkB;QACvB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,QAAQ,EAAE,CAAC;IACb,CAAC;IAEQ,QAAQ,CAAC,KAAmB,EAAE,QAAkB;QACvD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAED,UAAU,CAAC,GAAW,EAAE,EAAe;QACrC,IAAI,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,UAAU,KAAW,OAAO,IAAI,CAAC,CAAC,CAAC;IACnC,YAAY,KAAW,OAAO,IAAI,CAAC,CAAC,CAAC;IACrC,OAAO,KAAK,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC1F,GAAG,KAAW,OAAO,IAAI,CAAC,CAAC,CAAC;IAC5B,KAAK;QACH,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/node/runtime.js

@@ -16,8 +16,8 @@ export async function startNode(options) {
     // Servers die with the process: wrap listen so exit can close what is left open.
     const processSystem = {
         ...system,
-        listen(port, handler) {
-            const registration = system.listen(port, handler);
+        listen(port, handler, upgrade) {
+            const registration = system.listen(port, handler, upgrade);
             const tracked = {
                 port: registration.port,
                 close() {

package/dist/node/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/node/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/node/runtime.ts"],"names":[],"mappings":"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"}

package/dist/previewBridge.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Scripts injected into preview pages that let them reach virtual servers the
+ * way a page reaches a real one, where a service worker cannot help:
+ *
+ *   • WebSockets. A service worker never sees a WebSocket, so the page's
+ *     `WebSocket` is replaced by one that, for URLs naming a virtual server
+ *     (`ws://localhost:3000/…`, `/__bfwc/<id>/__port/3000/…`, or a path on the
+ *     page's own host from a page that server served), opens a MessageChannel
+ *     to the runtime's host page (`parent`, else `opener`). The host connects
+ *     to the server and relays frames both ways. Every other URL gets the real
+ *     `WebSocket`, untouched.
+ *   • `document.cookie` on pages a virtual server served. The host keeps those
+ *     cookies (a service worker cannot set `Set-Cookie`); this mirrors the
+ *     non-HttpOnly ones into `document.cookie` and sends assignments back.
+ *
+ * Messages on a socket's channel — page → host: `{ kind: 'send', data }`,
+ * `{ kind: 'close', code, reason }`; host → page: `{ kind: 'open', protocol }`,
+ * `{ kind: 'message', data }` (string or ArrayBuffer), `{ kind: 'close', code, reason, wasClean }`.
+ * On the cookie channel — page → host `{ kind: 'set-cookie', value }`, host → page `{ kind: 'cookies', value }`.
+ */
+/** page → host, with a MessagePort: "connect a WebSocket to `port` at `path`". */
+export declare const SOCKET_MESSAGE_TYPE = "bfwc:socket";
+/** page → host, with a MessagePort: "keep my `document.cookie` in sync" (pages served by a virtual server). */
+export declare const COOKIE_MESSAGE_TYPE = "bfwc:cookies";
+/** How long a page waits for the host to answer a socket before failing it (code 1006). */
+export declare const SOCKET_CONNECT_TIMEOUT_MS = 15000;
+/** The `WebSocket` replacement; runs in every preview page (dev-server documents and virtual-server HTML). */
+export declare function previewSocketScript(): string;
+/**
+ * `document.cookie` for a page a virtual server served: starts from the host's
+ * jar (`initial`: the non-HttpOnly cookies for this page's path), stays in sync
+ * over a channel, and sends assignments to the host's jar.
+ */
+export declare function previewCookieScript(initial: string): string;
+/**
+ * Where to inject the bridge into a streamed document, from its first bytes:
+ * just after `<head …>`, else after `<html …>` or the doctype (never before the
+ * doctype, which would switch the page to quirks mode), else the start.
+ * Undefined while the prefix is too short to tell; pass `complete` at the end of the body.
+ */
+export declare function bridgeInsertionPoint(prefix: string, complete?: boolean): number | undefined;
+//# sourceMappingURL=previewBridge.d.ts.map

package/dist/previewBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewBridge.d.ts","sourceRoot":"","sources":["../src/previewBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,+GAA+G;AAC/G,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,2FAA2F;AAC3F,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,8GAA8G;AAC9G,wBAAgB,mBAAmB,IAAI,MAAM,CAkG5C;AAKD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkC3D;AAQD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,MAAM,GAAG,SAAS,CAQzF"}

package/dist/previewBridge.js

@@ -0,0 +1,192 @@
+/**
+ * Scripts injected into preview pages that let them reach virtual servers the
+ * way a page reaches a real one, where a service worker cannot help:
+ *
+ *   • WebSockets. A service worker never sees a WebSocket, so the page's
+ *     `WebSocket` is replaced by one that, for URLs naming a virtual server
+ *     (`ws://localhost:3000/…`, `/__bfwc/<id>/__port/3000/…`, or a path on the
+ *     page's own host from a page that server served), opens a MessageChannel
+ *     to the runtime's host page (`parent`, else `opener`). The host connects
+ *     to the server and relays frames both ways. Every other URL gets the real
+ *     `WebSocket`, untouched.
+ *   • `document.cookie` on pages a virtual server served. The host keeps those
+ *     cookies (a service worker cannot set `Set-Cookie`); this mirrors the
+ *     non-HttpOnly ones into `document.cookie` and sends assignments back.
+ *
+ * Messages on a socket's channel — page → host: `{ kind: 'send', data }`,
+ * `{ kind: 'close', code, reason }`; host → page: `{ kind: 'open', protocol }`,
+ * `{ kind: 'message', data }` (string or ArrayBuffer), `{ kind: 'close', code, reason, wasClean }`.
+ * On the cookie channel — page → host `{ kind: 'set-cookie', value }`, host → page `{ kind: 'cookies', value }`.
+ */
+/** page → host, with a MessagePort: "connect a WebSocket to `port` at `path`". */
+export const SOCKET_MESSAGE_TYPE = 'bfwc:socket';
+/** page → host, with a MessagePort: "keep my `document.cookie` in sync" (pages served by a virtual server). */
+export const COOKIE_MESSAGE_TYPE = 'bfwc:cookies';
+/** How long a page waits for the host to answer a socket before failing it (code 1006). */
+export const SOCKET_CONNECT_TIMEOUT_MS = 15_000;
+/** The `WebSocket` replacement; runs in every preview page (dev-server documents and virtual-server HTML). */
+export function previewSocketScript() {
+    return `<script>(function(){
+  var Native = window.WebSocket;
+  if (!Native || Native.__bfwc) return;
+  var runtime = window.parent !== window ? window.parent : window.opener;
+  var m = /^(.*\\/__bfwc\\/[A-Za-z0-9_-]+\\/)(?:__port\\/(\\d{1,5})(?:\\/|$))?/.exec(location.pathname);
+  if (!runtime || !m || typeof MessageChannel === 'undefined') return;
+  var base = m[1], ownPort = m[2] ? Number(m[2]) : 0;
+  var LOCAL = /^(localhost|127\\.0\\.0\\.1|0\\.0\\.0\\.0|\\[::1\\])$/i;
+  function target(url) {
+    var u;
+    try { u = new URL(String(url), location.href); } catch (_) { return null; }
+    if (!/^(wss?|https?):$/.test(u.protocol)) return null;
+    if (u.host === location.host) {
+      if (u.pathname.indexOf(base) === 0) {
+        var p = /^__port\\/(\\d{1,5})(\\/.*)?$/.exec(u.pathname.slice(base.length));
+        return p ? { port: Number(p[1]), path: (p[2] || '/') + u.search } : null;
+      }
+      return ownPort ? { port: ownPort, path: u.pathname + u.search } : null;
+    }
+    if (LOCAL.test(u.hostname)) return { port: Number(u.port || (/^(wss|https):$/.test(u.protocol) ? 443 : 80)), path: u.pathname + u.search };
+    return null;
+  }
+  var CONNECTING = 0, OPEN = 1, CLOSING = 2, CLOSED = 3;
+  class VirtualWebSocket extends EventTarget {
+    constructor(url, protocols) {
+      var t = target(url);
+      if (!t) return protocols === undefined ? new Native(url) : new Native(url, protocols);
+      super();
+      var self = this, channel = new MessageChannel();
+      this._url = new URL(String(url), location.href).href.replace(/^http/, 'ws');
+      this._state = CONNECTING;
+      this._protocol = '';
+      this._binaryType = 'blob';
+      this._queue = Promise.resolve();
+      this._port = channel.port1;
+      this._port.onmessage = function (e) { self._receive(e.data); };
+      this._timer = setTimeout(function () { self._receive({ kind: 'close', code: 1006, reason: '', wasClean: false }); }, ${SOCKET_CONNECT_TIMEOUT_MS});
+      var list = protocols === undefined ? [] : typeof protocols === 'string' ? [protocols] : Array.from(protocols, String);
+      runtime.postMessage({ type: ${JSON.stringify(SOCKET_MESSAGE_TYPE)}, href: location.href, port: t.port, path: t.path, protocols: list }, '*', [channel.port2]);
+    }
+    get url() { return this._url; }
+    get readyState() { return this._state; }
+    get protocol() { return this._protocol; }
+    get extensions() { return ''; }
+    get bufferedAmount() { return 0; }
+    get binaryType() { return this._binaryType; }
+    set binaryType(v) { if (v === 'blob' || v === 'arraybuffer') this._binaryType = v; }
+    send(data) {
+      if (this._state === CONNECTING) throw new DOMException("Failed to execute 'send' on 'WebSocket': Still in CONNECTING state.", 'InvalidStateError');
+      if (this._state !== OPEN) return;
+      var port = this._port;
+      var value = typeof data === 'string' ? data
+        : data instanceof Blob ? data.arrayBuffer()
+        : ArrayBuffer.isView(data) ? data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength)
+        : data instanceof ArrayBuffer ? data.slice(0) : String(data);
+      this._queue = this._queue.then(function () { return value; }).then(function (v) { port.postMessage({ kind: 'send', data: v }); });
+    }
+    close(code, reason) {
+      if (code !== undefined && code !== 1000 && (code < 3000 || code > 4999)) throw new DOMException("Failed to execute 'close' on 'WebSocket': The code must be either 1000, or between 3000 and 4999.", 'InvalidAccessError');
+      if (this._state === CLOSING || this._state === CLOSED) return;
+      this._state = CLOSING;
+      var port = this._port;
+      this._queue.then(function () { port.postMessage({ kind: 'close', code: code, reason: reason === undefined ? '' : String(reason) }); });
+    }
+    _receive(m) {
+      if (!m || this._state === CLOSED) return;
+      if (m.kind === 'open' && this._state === CONNECTING) {
+        clearTimeout(this._timer);
+        this._state = OPEN;
+        this._protocol = m.protocol || '';
+        this._emit(new Event('open'));
+      } else if (m.kind === 'message' && this._state !== CONNECTING) {
+        var d = m.data;
+        if (typeof d !== 'string' && this._binaryType === 'blob') d = new Blob([d]);
+        this._emit(new MessageEvent('message', { data: d, origin: new URL(this._url).origin }));
+      } else if (m.kind === 'close') {
+        clearTimeout(this._timer);
+        this._state = CLOSED;
+        this._port.close();
+        if (!m.wasClean) this._emit(new Event('error'));
+        this._emit(new CloseEvent('close', { code: m.code, reason: m.reason || '', wasClean: !!m.wasClean }));
+      }
+    }
+    _emit(event) {
+      var handler = this['on' + event.type];
+      if (typeof handler === 'function') handler.call(this, event);
+      this.dispatchEvent(event);
+    }
+  }
+  [['CONNECTING', CONNECTING], ['OPEN', OPEN], ['CLOSING', CLOSING], ['CLOSED', CLOSED]].forEach(function (c) {
+    Object.defineProperty(VirtualWebSocket, c[0], { value: c[1] });
+    Object.defineProperty(VirtualWebSocket.prototype, c[0], { value: c[1] });
+  });
+  Object.defineProperty(VirtualWebSocket, Symbol.hasInstance, { value: function (o) { return o instanceof Native || Function.prototype[Symbol.hasInstance].call(VirtualWebSocket, o); } });
+  VirtualWebSocket.__bfwc = true;
+  window.WebSocket = VirtualWebSocket;
+})();</script>`;
+}
+/** `JSON.stringify`, safe inside an inline script. */
+const scriptLiteral = (value) => JSON.stringify(value).replace(/</g, '\\u003c');
+/**
+ * `document.cookie` for a page a virtual server served: starts from the host's
+ * jar (`initial`: the non-HttpOnly cookies for this page's path), stays in sync
+ * over a channel, and sends assignments to the host's jar.
+ */
+export function previewCookieScript(initial) {
+    return `<script>(function(){
+  var runtime = window.parent !== window ? window.parent : window.opener;
+  var cookies = ${scriptLiteral(initial)};
+  var port = null;
+  if (runtime && typeof MessageChannel !== 'undefined') {
+    var channel = new MessageChannel();
+    port = channel.port1;
+    port.onmessage = function (e) { if (e.data && e.data.kind === 'cookies') cookies = String(e.data.value); };
+    runtime.postMessage({ type: ${JSON.stringify(COOKIE_MESSAGE_TYPE)}, href: location.href }, '*', [channel.port2]);
+  }
+  function apply(value) {
+    var parts = value.split(';'), pair = parts[0], eq = pair.indexOf('=');
+    if (eq < 0) return;
+    var name = pair.slice(0, eq).trim(), remove = false;
+    if (!name) return;
+    for (var i = 1; i < parts.length; i++) {
+      var a = parts[i].trim(), k = a.split('=')[0].trim().toLowerCase(), v = a.slice(a.indexOf('=') + 1).trim();
+      if (k === 'httponly') return;
+      if (k === 'max-age' && /^-?\\d+$/.test(v) && Number(v) <= 0) remove = true;
+      if (k === 'expires' && Date.parse(v) <= Date.now()) remove = true;
+    }
+    var list = cookies ? cookies.split('; ').filter(function (c) { return c.slice(0, c.indexOf('=')) !== name; }) : [];
+    if (!remove) list.push(name + '=' + pair.slice(eq + 1).trim());
+    cookies = list.join('; ');
+  }
+  try {
+    Object.defineProperty(document, 'cookie', {
+      configurable: true,
+      get: function () { return cookies; },
+      set: function (value) { value = String(value); apply(value); if (port) port.postMessage({ kind: 'set-cookie', value: value }); },
+    });
+  } catch (_) {}
+})();</script>`;
+}
+const HEAD_OPEN = /<head(?:\s[^>]*)?>/i;
+const HTML_OPEN = /<html(?:\s[^>]*)?>/i;
+const DOCTYPE = /<!doctype[^>]*>/i;
+/** Content past which `<head>` can no longer appear. */
+const BODY_STARTED = /<(?:body|script|link|meta|style|title|div|p)[\s>/]/i;
+/**
+ * Where to inject the bridge into a streamed document, from its first bytes:
+ * just after `<head …>`, else after `<html …>` or the doctype (never before the
+ * doctype, which would switch the page to quirks mode), else the start.
+ * Undefined while the prefix is too short to tell; pass `complete` at the end of the body.
+ */
+export function bridgeInsertionPoint(prefix, complete = false) {
+    const head = HEAD_OPEN.exec(prefix);
+    if (head)
+        return head.index + head[0].length;
+    if (!complete && !BODY_STARTED.test(prefix) && prefix.length < 4096)
+        return undefined;
+    const html = HTML_OPEN.exec(prefix);
+    if (html)
+        return html.index + html[0].length;
+    const doctype = DOCTYPE.exec(prefix);
+    return doctype ? doctype.index + doctype[0].length : 0;
+}
+//# sourceMappingURL=previewBridge.js.map

package/dist/previewBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewBridge.js","sourceRoot":"","sources":["../src/previewBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,+GAA+G;AAC/G,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAClD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD,8GAA8G;AAC9G,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6HAoCoH,yBAAyB;;oCAElH,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA0DxD,CAAC;AAChB,CAAC;AAED,sDAAsD;AACtD,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAEzF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO;;kBAES,aAAa,CAAC,OAAO,CAAC;;;;;;kCAMN,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;eAwBtD,CAAC;AAChB,CAAC;AAED,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC;AACnC,wDAAwD;AACxD,MAAM,YAAY,GAAG,qDAAqD,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,QAAQ,GAAG,KAAK;IACnE,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO,SAAS,CAAC;IACtF,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/shell/ast.d.ts

@@ -0,0 +1,101 @@
+/**
+ * The shell's syntax tree. Words keep their quoting as segments, because
+ * expansion (variables, `$(…)`, `~`, globs, field splitting) happens at run
+ * time and depends on it.
+ */
+export type Segment = {
+    kind: 'text';
+    value: string;
+    quoted: boolean;
+} | {
+    kind: 'var';
+    name: string;
+    quoted: boolean;
+    op?: ':-' | '-' | ':=' | ':+';
+    arg?: Word;
+} | {
+    kind: 'cmd';
+    source: string;
+    quoted: boolean;
+} | {
+    kind: 'tilde';
+};
+export type Word = Segment[];
+export type RedirectOp = '>' | '>>' | '<' | '2>' | '2>>' | '&>' | '2>&1' | '>&2' | '<<' | '<<-';
+export interface Redirect {
+    op: RedirectOp;
+    target?: Word;
+    /** A here-document's body; expanded like a double-quoted string unless the delimiter was quoted. */
+    heredoc?: {
+        body: Word;
+    };
+}
+export interface SimpleCommand {
+    type: 'simple';
+    assignments: Array<{
+        name: string;
+        value: Word;
+    }>;
+    words: Word[];
+    redirects: Redirect[];
+}
+export interface IfCommand {
+    type: 'if';
+    clauses: Array<{
+        condition: Script;
+        body: Script;
+    }>;
+    otherwise?: Script;
+    redirects: Redirect[];
+}
+export interface LoopCommand {
+    type: 'while' | 'until';
+    condition: Script;
+    body: Script;
+    redirects: Redirect[];
+}
+export interface ForCommand {
+    type: 'for';
+    name: string;
+    /** Absent: iterate the positional parameters (`for x; do …`). */
+    items?: Word[];
+    body: Script;
+    redirects: Redirect[];
+}
+export interface CaseCommand {
+    type: 'case';
+    subject: Word;
+    arms: Array<{
+        patterns: Word[];
+        body: Script;
+    }>;
+    redirects: Redirect[];
+}
+/** `{ list; }` runs in this shell; `( list )` in a copy of it. */
+export interface GroupCommand {
+    type: 'group' | 'subshell';
+    body: Script;
+    redirects: Redirect[];
+}
+export interface FunctionDefinition {
+    type: 'function';
+    name: string;
+    body: CompoundCommand;
+    redirects: Redirect[];
+}
+export type CompoundCommand = IfCommand | LoopCommand | ForCommand | CaseCommand | GroupCommand;
+export type Command = SimpleCommand | CompoundCommand | FunctionDefinition;
+export interface Pipeline {
+    negate: boolean;
+    commands: Command[];
+}
+export interface AndOrList {
+    first: Pipeline;
+    rest: Array<{
+        op: '&&' | '||';
+        pipeline: Pipeline;
+    }>;
+    background: boolean;
+}
+export type Script = AndOrList[];
+//# sourceMappingURL=ast.d.ts.map

package/dist/shell/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/shell/ast.ts"],"names":[],"mappings":"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"}

package/dist/shell/ast.js

@@ -0,0 +1,7 @@
+/**
+ * The shell's syntax tree. Words keep their quoting as segments, because
+ * expansion (variables, `$(…)`, `~`, globs, field splitting) happens at run
+ * time and depends on it.
+ */
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/shell/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/shell/ast.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/shell/builtins.d.ts

@@ -3,6 +3,12 @@
  * the command tables the executor dispatches on.
  */
 import type { CommandContext, Command } from './context.js';
+import type { Flow } from './compound.js';
+/** A command started with `&`. */
+export interface BackgroundJob {
+    id: number;
+    done: Promise<number>;
+}
 /** The slice of the shell a builtin may change. */
 export interface ShellState {
     cwd: string;
@@ -11,6 +17,14 @@ export interface ShellState {
     lastStatus: number;
     /** Set by `exit`: the shell stops after the current command. */
     exitRequested?: number;
+    /** Set by `break`, `continue` and `return`; the loop or function it targets clears it. */
+    flow?: Flow;
+    /** `$1…`, `$@`; a function call swaps them for its arguments. */
+    positional: string[];
+    readonly functions: ReadonlyMap<string, unknown>;
+    readonly jobs: ReadonlyMap<number, BackgroundJob>;
+    /** One frame per running function (for `local`). */
+    readonly localFrames: Array<Map<string, string | undefined>>;
     /** Run a script in this shell (for `source`). */
     run(source: string): Promise<number>;
 }

package/dist/shell/builtins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/shell/builtins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAK5D,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAElF,wEAAwE;AACxE,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAI7C,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,eAAe,UAA+C,CAAC;AAY5E,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CA4F5C,CAAC"}
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/shell/builtins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClD,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC7D,iDAAiD;IACjD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAElF,wEAAwE;AACxE,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAK7C,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,eAAe,UAA+D,CAAC;AAe5F,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAuJ5C,CAAC"}

package/dist/shell/builtins.js

@@ -6,21 +6,27 @@ import { findExecutable } from '../system/commands.js';
 import { resolvePath } from './context.js';
 import { cat, cp, ls, mkdir, mv, pwd, rm, touch } from './fileCommands.js';
 import { basename, clear, dirname, echo, env, falseCommand, grep, head, printf, sleep, tail, trueCommand, wc } from './textCommands.js';
+import { bracket, test } from './testCommand.js';
+import { readLine } from './lineReader.js';
 /** Coreutils: plain commands, also spawnable as standalone programs. */
 export const COREUTILS = {
-    ls, cat, mkdir, rm, cp, mv, touch, pwd, echo, printf, head, tail, grep, wc, env, clear, sleep, basename, dirname,
+    ls, cat, mkdir, rm, cp, mv, touch, pwd, echo, printf, head, tail, grep, wc, env, clear, sleep, basename, dirname, test,
+    '[': bracket,
     true: trueCommand,
     false: falseCommand,
 };
 /** Programs the runtime provides besides coreutils (reported by `which`/`type`). */
-export const SYSTEM_PROGRAMS = ['node', 'npm', 'npx', 'bfsh', 'sh', 'bash'];
+export const SYSTEM_PROGRAMS = ['node', 'npm', 'npx', 'pnpm', 'yarn', 'bfsh', 'sh', 'bash'];
 const HELP = `bfsh — BuilderForce WebContainers shell
 
-  Builtins:  cd, pwd, export, unset, exit, source, history, type, which, help
-  Files:     ls [-la], cat, mkdir [-p], rm [-rf], cp [-r], mv, touch
+  Builtins:  cd, pwd, export, unset, exit, source, history, type, which, help,
+             read, local, shift, return, break, continue, jobs, wait
+  Files:     ls [-la], cat, mkdir [-p], rm [-rf], cp [-r], mv, touch, test / [ … ]
   Text:      echo, printf, head, tail, grep, wc, env, clear, sleep, basename, dirname
-  Node:      node <file>, npm install|ci|run|start|test, npx <bin>
+  Node:      node <file>, npm install|ci|run|start|test, npx <bin>, pnpm, yarn
   Syntax:    'quotes' "\$VARS" a && b || c; a | b > out.txt >> log 2>&1 2> err; FOO=bar cmd; $(cmd); *.js
+             if …; then …; elif …; else …; fi   while|until …; do …; done   for x in …; do …; done
+             case $x in a|b) …;; *) …;; esac   name() { …; }   { …; }   ( … )   cat <<EOF … EOF
 
 `;
 export const BUILTINS = {
@@ -103,10 +109,12 @@ export const BUILTINS = {
         }
         return status;
     },
-    async type(ctx) {
+    async type(ctx, shell) {
         let status = 0;
         for (const name of ctx.args) {
-            if (name in BUILTINS)
+            if (shell.functions.has(name))
+                ctx.io.stdout(`${name} is a function\n`);
+            else if (name in BUILTINS)
                 ctx.io.stdout(`${name} is a shell builtin\n`);
             else if (name in COREUTILS || SYSTEM_PROGRAMS.includes(name))
                 ctx.io.stdout(`${name} is /usr/local/bin/${name}\n`);
@@ -125,7 +133,79 @@ export const BUILTINS = {
     async set() {
         return 0; // options (-e, -x) are accepted and ignored
     },
+    async break(ctx, shell) {
+        return loopControl(ctx, shell, 'break');
+    },
+    async continue(ctx, shell) {
+        return loopControl(ctx, shell, 'continue');
+    },
+    async return(ctx, shell) {
+        if (!shell.localFrames.length) {
+            ctx.io.stderr('return: can only `return\' from a function or sourced script\n');
+            return 1;
+        }
+        const status = ctx.args[0] === undefined ? shell.lastStatus : Number(ctx.args[0]) & 255;
+        shell.flow = { kind: 'return', status };
+        return status;
+    },
+    async local(ctx, shell) {
+        const frame = shell.localFrames[shell.localFrames.length - 1];
+        if (!frame) {
+            ctx.io.stderr('local: can only be used in a function\n');
+            return 1;
+        }
+        for (const arg of ctx.args) {
+            const eq = arg.indexOf('=');
+            const name = eq > 0 ? arg.slice(0, eq) : arg;
+            if (!frame.has(name))
+                frame.set(name, shell.env[name]);
+            shell.env[name] = eq > 0 ? arg.slice(eq + 1) : '';
+        }
+        return 0;
+    },
+    async shift(ctx, shell) {
+        const count = ctx.args[0] === undefined ? 1 : Number(ctx.args[0]);
+        if (!Number.isInteger(count) || count < 0 || count > shell.positional.length)
+            return 1;
+        shell.positional = shell.positional.slice(count);
+        return 0;
+    },
+    async read(ctx, shell) {
+        const raw = ctx.args.includes('-r');
+        const names = ctx.args.filter((a) => !a.startsWith('-'));
+        let line = await readLine(ctx.io.stdin, ctx.signal);
+        if (line === null)
+            return 1;
+        if (!raw)
+            line = line.replace(/\\(.)/g, '$1');
+        const targets = names.length ? names : ['REPLY'];
+        const fields = names.length ? line.trim().split(/\s+/) : [line];
+        targets.forEach((name, i) => {
+            shell.env[name] = i === targets.length - 1 ? fields.slice(i).join(' ') : fields[i] ?? '';
+        });
+        return 0;
+    },
+    async jobs(ctx, shell) {
+        for (const job of shell.jobs.values())
+            ctx.io.stdout(`[${job.id}]  Running\n`);
+        return 0;
+    },
+    async wait(ctx, shell) {
+        const ids = ctx.args.map((a) => Number(a.replace(/^%/, '')));
+        const jobs = ids.length ? ids.map((id) => shell.jobs.get(id)).filter((j) => !!j) : [...shell.jobs.values()];
+        const statuses = await Promise.all(jobs.map((job) => job.done));
+        return statuses.length ? statuses[statuses.length - 1] : 0;
+    },
 };
+function loopControl(ctx, shell, kind) {
+    const levels = ctx.args[0] === undefined ? 1 : Number(ctx.args[0]);
+    if (!Number.isInteger(levels) || levels < 1) {
+        ctx.io.stderr(`${kind}: ${ctx.args[0]}: loop count out of range\n`);
+        return 1;
+    }
+    shell.flow = { kind, levels };
+    return 0;
+}
 BUILTINS['.'] = BUILTINS.source;
 BUILTINS[':'] = async () => 0;
 //# sourceMappingURL=builtins.js.map