@nimbus-sh/core 0.6.0 → 0.7.0

package/dist/runtime/javascript-ast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"javascript-ast.d.ts","sourceRoot":"","sources":["../../src/runtime/javascript-ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAa/D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAI9D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAIpF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAItE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEhF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAElF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}
+{"version":3,"file":"javascript-ast.d.ts","sourceRoot":"","sources":["../../src/runtime/javascript-ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,OAAO,EAAkB,MAAM,OAAO,CAAC;AAEjF,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CA4C/D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAI9D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAIpF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAItE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEhF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAElF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}

package/dist/runtime/javascript-ast.js

@@ -1,4 +1,4 @@
-import { parse } from 'acorn';
+import { parse, tokenizer, tokTypes } from 'acorn';
 export function parseJavaScriptModule(source) {
     return parse(source, {
         ecmaVersion: 'latest',
@@ -7,17 +7,55 @@ export function parseJavaScriptModule(source) {
     });
 }
 export function hasTopLevelModuleSyntax(source) {
-    let ast;
     try {
-        ast = parseJavaScriptModule(source);
+        const tokens = tokenizer(source, {
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+            allowHashBang: true,
+        });
+        let braceDepth = 0;
+        let parenDepth = 0;
+        let bracketDepth = 0;
+        let previous;
+        const updateDepth = (type) => {
+            if (type === tokTypes.braceL || type === tokTypes.dollarBraceL)
+                braceDepth++;
+            else if (type === tokTypes.braceR)
+                braceDepth = Math.max(0, braceDepth - 1);
+            else if (type === tokTypes.parenL)
+                parenDepth++;
+            else if (type === tokTypes.parenR)
+                parenDepth = Math.max(0, parenDepth - 1);
+            else if (type === tokTypes.bracketL)
+                bracketDepth++;
+            else if (type === tokTypes.bracketR)
+                bracketDepth = Math.max(0, bracketDepth - 1);
+        };
+        while (true) {
+            const token = tokens.getToken();
+            const type = token.type;
+            if (type === tokTypes.eof)
+                return false;
+            const topLevel = braceDepth === 0 && parenDepth === 0 && bracketDepth === 0;
+            if (topLevel && previous !== tokTypes.dot) {
+                if (type === tokTypes._export)
+                    return true;
+                if (type === tokTypes._import) {
+                    const next = tokens.getToken();
+                    if (next.type !== tokTypes.parenL && next.type !== tokTypes.dot)
+                        return true;
+                    updateDepth(next.type);
+                    previous = next.type;
+                    continue;
+                }
+            }
+            updateDepth(type);
+            previous = type;
+        }
     }
     catch {
         return false;
     }
-    return nodeList(ast, 'body').some((node) => node.type === 'ImportDeclaration' ||
-        node.type === 'ExportNamedDeclaration' ||
-        node.type === 'ExportDefaultDeclaration' ||
-        node.type === 'ExportAllDeclaration');
 }
 export function nodeList(node, key) {
     const value = node[key];

package/dist/runtime/opentui-wasm-backend.d.ts.map

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

package/dist/runtime/opentui-wasm-backend.js

@@ -78,13 +78,12 @@ export class OpenTUIWasmBackend {
      * semantics), so each `dlopen`'d symbol call frees what was allocated before
      * it. Without this a per-frame `rgbaPtr(color)` would leak linear memory.
      *
-     * `view` is the source ArrayBufferView when the caller passed a writable one:
-     * native FFI `ptr(view)` yields a live pointer into the view's storage, so
-     * after the symbol call the view must reflect anything Zig wrote into it. Many
-     * FFIRenderLib wrappers materialize OUT-buffers this way — `getCursorState`,
-     * `getTerminalCapabilities`, `getRenderStats`, the span-feed's
-     * `streamDrainSpans(ptr(outBuffer))`, every `editBufferGet*`/`editorViewGet*` —
-     * so the claimed-scratch release copies these back before freeing.
+     * `view` is a writable byte view over the caller's original storage.
+     * Native `ptr(value)` exposes live memory for both ArrayBuffer and typed-array
+     * inputs, so every transient allocation copies back after the symbol call.
+     * OpenTUI's struct getters use bare ArrayBuffers (`LogicalCursorStruct`,
+     * `VisualCursorStruct`, stats, terminal capabilities), while span-feed drains
+     * use typed arrays. Both forms must observe Zig's writes.
      */
     #pendingPtrScratch = [];
     /**
@@ -176,12 +175,10 @@ export class OpenTUIWasmBackend {
     // allocation as transient scratch that the next symbol call frees (see
     // `#bindSymbol`). This keeps a per-frame `rgbaPtr(color)` loop leak-free.
     //
-    // A writable ArrayBufferView is also an OUT-buffer here: native `ptr(view)` is
-    // a live pointer into the view's storage, so after the call the view must
-    // reflect Zig's writes. We record the source view so the claimed-scratch
-    // release copies it back (the span-feed `streamDrainSpans(ptr(drainBuffer))`
-    // and every FFIRenderLib `ptr(outBuffer)`/`ptr(cursorBuffer)`/`ptr(statsBuffer)`
-    // getter depend on this). Read-only ArrayBuffers carry a null view (copy-in only).
+    // Every ArrayBuffer and ArrayBufferView is potentially an OUT-buffer:
+    // native `ptr(value)` is a live pointer into the same storage. Copy the
+    // arena bytes back after the call so bare struct buffers and typed-array
+    // windows have identical semantics.
     ptr(value) {
         const { bytes, byteOffset, byteLength } = viewBytes(value);
         const size = byteLength === 0 ? ARENA_ALIGN : byteLength;
@@ -192,7 +189,7 @@ export class OpenTUIWasmBackend {
         this.#pendingPtrScratch.push({
             offset,
             size,
-            view: ArrayBuffer.isView(value) ? value : null,
+            view: ArrayBuffer.isView(value) ? value : new Uint8Array(value),
         });
         return offset;
     }
@@ -336,8 +333,13 @@ export class OpenTUIWasmBackend {
                     scratchBytes += s.size;
                 diag.rec(name, this.#exports.memory.buffer.byteLength - memBefore, marshaled, scratchBytes);
             }
-            if (returns === 'u64' || returns === 'i64') {
-                return typeof result === 'bigint' ? result : BigInt(result);
+            if (returns === 'u64') {
+                const value = typeof result === 'bigint' ? result : BigInt(result);
+                return BigInt.asUintN(64, value);
+            }
+            if (returns === 'i64') {
+                const value = typeof result === 'bigint' ? result : BigInt(result);
+                return BigInt.asIntN(64, value);
             }
             return result;
         };

package/dist/runtime/port-registry.d.ts

@@ -23,8 +23,9 @@
  *   `request.method` and application headers mirror the outer request,
  *   Nimbus credentials/internal headers are removed, and
  *   `request.body` is a ReadableStream (or null for GET/HEAD) that
- *   the facet can consume once. The returned Response is returned
- *   to the outer fetch as-is; its body is streamed directly.
+ *   the facet can consume once. The returned Response is streamed
+ *   straight back, with one normalization: the hop speaks identity,
+ *   so a compressed body is decoded here. See `decodeContentCoding`.
  */
 import type { RouteableFacetTarget } from './os-contracts.js';
 export interface PortEntry {
@@ -44,6 +45,7 @@ export interface PortEntry {
      */
     capability: string;
 }
+export declare function createPortCapability(): string;
 export declare class PortRegistry {
     private ports;
     private facetStubsByPid;

package/dist/runtime/port-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"port-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/port-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,gBAAgB,CAAsC;IAE9D,uEAAuE;IACvE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAQpD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAYzC,yBAAyB;IACzB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,oDAAoD;IACpD,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAYpC,4BAA4B;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC,8EAA8E;IAC9E,OAAO,CAAC,oBAAoB;IAW5B,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAMvC,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOnF,qCAAqC;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,gCAAgC;IAChC,MAAM,IAAI,SAAS,EAAE;IAIrB,6EAA6E;IAC7E,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxD;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAO5D;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAI9F;;;;;;;;;;OAUG;IACG,sBAAsB,CAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;YAKb,oBAAoB;IAsHlC,IAAI,KAAK;;;;;;MAKR;IAED,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,iBAAiB;CAM1B"}
+{"version":3,"file":"port-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/port-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAuDD,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,gBAAgB,CAAsC;IAE9D,uEAAuE;IACvE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAQpD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAYzC,yBAAyB;IACzB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,oDAAoD;IACpD,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAYpC,4BAA4B;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC,8EAA8E;IAC9E,OAAO,CAAC,oBAAoB;IAW5B,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAMvC,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOnF,qCAAqC;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,gCAAgC;IAChC,MAAM,IAAI,SAAS,EAAE;IAIrB,6EAA6E;IAC7E,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxD;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAO5D;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAI9F;;;;;;;;;;OAUG;IACG,sBAAsB,CAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;YAKb,oBAAoB;IA0HlC,IAAI,KAAK;;;;;;MAKR;IAED,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/runtime/port-registry.js

@@ -23,11 +23,59 @@
  *   `request.method` and application headers mirror the outer request,
  *   Nimbus credentials/internal headers are removed, and
  *   `request.body` is a ReadableStream (or null for GET/HEAD) that
- *   the facet can consume once. The returned Response is returned
- *   to the outer fetch as-is; its body is streamed directly.
+ *   the facet can consume once. The returned Response is streamed
+ *   straight back, with one normalization: the hop speaks identity,
+ *   so a compressed body is decoded here. See `decodeContentCoding`.
  */
 import { sanitizeUntrustedHeaders } from '../_shared/untrusted-request.js';
-function createPortCapability() {
+/**
+ * Content codings this hop can undo. `DecompressionStream` decodes exactly
+ * these; brotli and zstd have no decoder in the runtime, so a body in one of
+ * those cannot be repaired here.
+ */
+const DECODABLE_CONTENT_CODINGS = new Map([
+    ['gzip', 'gzip'],
+    ['x-gzip', 'gzip'],
+    ['deflate', 'deflate'],
+]);
+/**
+ * Hand back a port target's response with its bytes and its headers in
+ * agreement.
+ *
+ * A `Response` a facet builds always holds an identity body. The runtime
+ * treats the bytes a `Response` is constructed from as unencoded and runs its
+ * own content negotiation on the way out: it drops a `Content-Encoding` the
+ * client did not ask for, and compresses again when the client did. Either
+ * way a guest server's `Content-Encoding` is a label with nothing behind it,
+ * and the browser renders compressed bytes as text.
+ *
+ * The forwarded request asks the target for `identity`, so this decode covers
+ * the server that compresses whatever the client said. A coding with no
+ * decoder answers 502: an honest failure beats a page of mojibake.
+ */
+function decodeContentCoding(response, port) {
+    const coding = response.headers.get('Content-Encoding')?.trim().toLowerCase();
+    if (!coding || coding === 'identity' || response.body === null)
+        return response;
+    const format = DECODABLE_CONTENT_CODINGS.get(coding);
+    if (!format) {
+        void response.body.cancel().catch(() => { });
+        return new Response(JSON.stringify({
+            error: `port proxy: target answered Content-Encoding "${coding}", which this hop cannot decode`,
+            port,
+        }), { status: 502, headers: { 'Content-Type': 'application/json' } });
+    }
+    const headers = new Headers(response.headers);
+    headers.delete('Content-Encoding');
+    // The decoded body has a different length; the Response re-derives it.
+    headers.delete('Content-Length');
+    return new Response(response.body.pipeThrough(new DecompressionStream(format)), {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+export function createPortCapability() {
     const bytes = crypto.getRandomValues(new Uint8Array(12));
     return Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
 }
@@ -217,6 +265,10 @@ export class PortRegistry {
             if (authorization)
                 headers.set('authorization', authorization);
             headers.set('X-Nimbus-Port', String(port));
+            // A Response cannot carry an encoded body across this hop, so the
+            // target is asked for the one coding that survives it. See
+            // `decodeContentCoding` for the server that compresses anyway.
+            headers.set('Accept-Encoding', 'identity');
             // `duplex: 'half'` is required by workerd when body is a
             // ReadableStream — otherwise `new Request(…)` throws. It's not
             // part of the published @cloudflare/workers-types RequestInit,
@@ -255,12 +307,12 @@ export class PortRegistry {
                     headers: { 'Content-Type': 'application/json' },
                 });
             }
-            // Return the facet's Response as-is. Body is streamed; headers,
-            // status, and status-text pass through unchanged. We do NOT
-            // inject Access-Control-Allow-Origin — a port proxy forwards
-            // whatever CORS policy the user's HTTP server chose (audit C3
+            // Stream the facet's Response back. Status, status-text, and every
+            // header pass through; only a content coding the hop cannot carry is
+            // undone. We do NOT inject Access-Control-Allow-Origin — a port proxy
+            // forwards whatever CORS policy the user's HTTP server chose (audit C3
             // discourages gratuitous wildcards on non-static routes).
-            return response;
+            return decodeContentCoding(response, port);
         }
         catch (error) {
             // Server-side triage — users see only the 502 body, operators

package/dist/shell/stdin-adapter.d.ts

@@ -0,0 +1,11 @@
+import type { CommandInputStream } from '../substrate/lifo/commands/types.js';
+/**
+ * One consuming source behind the full reader contract, byte-accurate:
+ * the text is encoded once and every offset is a byte offset, so
+ * readBytes(1) over `é` yields exactly one UTF-8 byte per call and mixed
+ * text/byte consumption never diverges. Worker pure-builtin adapters hold
+ * stdin as a plain string; without this they can only offer readAll, and
+ * streaming commands see an empty pipe.
+ */
+export declare function staticStdinReader(text: string): CommandInputStream;
+//# sourceMappingURL=stdin-adapter.d.ts.map

package/dist/shell/stdin-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin-adapter.d.ts","sourceRoot":"","sources":["../../src/shell/stdin-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA+ClE"}

package/dist/shell/stdin-adapter.js

@@ -0,0 +1,59 @@
+/**
+ * One consuming source behind the full reader contract, byte-accurate:
+ * the text is encoded once and every offset is a byte offset, so
+ * readBytes(1) over `é` yields exactly one UTF-8 byte per call and mixed
+ * text/byte consumption never diverges. Worker pure-builtin adapters hold
+ * stdin as a plain string; without this they can only offer readAll, and
+ * streaming commands see an empty pipe.
+ */
+export function staticStdinReader(text) {
+    const bytes = new TextEncoder().encode(text);
+    const decoder = new TextDecoder('utf-8');
+    let offset = 0;
+    const pull = (max) => {
+        if (offset >= bytes.length)
+            return null;
+        const end = Math.min(offset + max, bytes.length);
+        const chunk = bytes.subarray(offset, end);
+        offset = end;
+        return chunk;
+    };
+    return {
+        readBytes: async (maxLength) => {
+            if (maxLength <= 0)
+                return new Uint8Array(0);
+            return pull(maxLength);
+        },
+        read: async () => {
+            while (offset < bytes.length) {
+                const end = Math.min(offset + 65536, bytes.length);
+                const text2 = decoder.decode(bytes.subarray(offset, end), { stream: true });
+                offset = end;
+                if (text2.length > 0)
+                    return text2;
+            }
+            const tail = decoder.decode();
+            return tail.length > 0 ? tail : null;
+        },
+        readAll: async () => {
+            if (offset >= bytes.length)
+                return '';
+            const out = decoder.decode(bytes.subarray(offset));
+            offset = bytes.length;
+            return out;
+        },
+        readLine: async () => {
+            if (offset >= bytes.length)
+                return null;
+            const newline = bytes.indexOf(0x0a, offset);
+            if (newline === -1) {
+                const line = decoder.decode(bytes.subarray(offset));
+                offset = bytes.length;
+                return line;
+            }
+            const line = decoder.decode(bytes.subarray(offset, newline));
+            offset = newline + 1;
+            return line;
+        },
+    };
+}

package/dist/shell/unix-commands.d.ts

@@ -8,7 +8,8 @@
  * uptime, tree, find, grep -r, head, tail, wc, diff, sort, uniq,
  * sed (s///), awk (field extract), xargs, tee, chown, ln -s,
  * du, man/help, basename, dirname, printf, true, false, seq, sleep,
- * touch, stat, file, xxd, base64, sha256sum, id, hostname, realpath
+ * touch, stat, file, xxd, od, hexdump, base64, sha256sum, id, hostname,
+ * realpath
  */
 import type { SqliteVFS } from '../vfs/sqlite-vfs.js';
 import type { Command } from '../substrate/lifo/commands/types.js';

package/dist/shell/unix-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unix-commands.d.ts","sourceRoot":"","sources":["../../src/shell/unix-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAavE,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,qCAAqC,CAAC;AAoFvF;;;;;;GAMG;AACH,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC,CAAC;AAgmIF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,SAAS,GACnB,IAAI,CAoKN"}
+{"version":3,"file":"unix-commands.d.ts","sourceRoot":"","sources":["../../src/shell/unix-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAavE,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,qCAAqC,CAAC;AAoFvF;;;;;;GAMG;AACH,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC,CAAC;AAskKF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,SAAS,GACnB,IAAI,CAyKN"}