@sproutboat/toolchain 0.4.12 → 0.4.13

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @sproutboat/toolchain
 
+## 0.4.13
+
+### Patch Changes
+
+- bb1b6a2: Parse ISO date timezone offsets correctly in native Porffor builds, including zero fields and fractional seconds.
+
 ## 0.4.12
 
 ### Patch Changes

package/PORFFOR_SCORECARD.md

@@ -0,0 +1,35 @@
+# Porffor pin scorecard
+
+Pin: alpha-9 (de4eb588264885b3a1596f75010e371a2052033f). Compatibility report: 2026-09-26T00:32:42.739Z.
+
+| Measure | Result |
+| --- | ---: |
+| Fixtures compiled | 32/32 |
+| Behavior matches | 30/32 |
+| Median / p95 compile, ms | 3139 / 3472 |
+| Median / p95 binary, bytes | 983392 / 1016464 |
+| Patch markers | 27 |
+| Upstream files written | 6 |
+| Fresh patch application | pass |
+
+This is the first recorded pin. Compare the next pin against this snapshot.
+
+## Patch inventory
+
+- `compiler/render.js`: PORT_MARKER, CONSOLE_MARKER, BYTESTRING_MARKER, READ_RAW_MARKER
+- `compiler/index.js`: LINK_MARKER, CFLAGS_MARKER
+- `compiler/builtins/typedarray.js`: TYPED_ARRAY_FROM_MARKER
+- `compiler/builtins/date.ts`: DATE_PARSER_MARKER
+- `compiler/uwebsockets.js`: BODY_MARKER, STATUS_SIG_MARKER, STATUS_303_MARKER, STATUS_DEFAULT_MARKER, HDR_SIG_MARKER, HDR_CALL_MARKER, HDR_CAP_MARKER, HDR_SKIP_MARKER, HDR_APPEND_MARKER, READ_RAW_DECL_MARKER, FORBIDDEN_HDR_MARKER, WRITE_RESPONSE_MARKER, R2_TRANSFER_MARKER, R2_TRANSFER_CALL_MARKER, R2_DOWNLOAD_CACHE_MARKER, R2_RANGE_CACHE_MARKER, R2_CONDITIONAL_CACHE_MARKER, R2_STREAMING_CACHE_MARKER, R2_RANGE_HEADER_CACHE_MARKER
+- `compiler/builtins_precompiled.js`: regenerated builtin table
+
+Patch source SHA-256: `69cf5d0bcf3f4d4c05b81df0ff04b83479af622539fa19566155531bf3ee469c`.
+
+## Known behavior gaps
+
+- 15-date-iso.js: request 3 mismatch: expected {"status":200,"body":"2008-03-04T23:00:00.000Z","content-type":null}, got {"status":200,"body":"0003-05-08T00:00:00.000Z","content-type":null}
+- 16-date-parts.js: request 3 mismatch: expected {"status":200,"body":"{\"year\":2008,\"month\":3,\"day\":4}","content-type":"application/json;charset=utf-8"}, got {"status":200,"body":"{\"year\":3,\"month\":5,\"day\":8}","content-type":"application/json;charset=utf-8"}
+
+## Review
+
+Use this scorecard with the full compatibility report and issue #35's build telemetry. If behavior regresses or patch work grows, review the individual patches and measure an alternate backend with the same fixtures.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sproutboat/toolchain",
-  "version": "0.4.12",
+  "version": "0.4.13",
   "license": "MIT",
   "type": "module",
   "repository": {

package/scorecards/alpha-9-de4eb58.json

@@ -0,0 +1,58 @@
+{
+  "pin": "alpha-9 (de4eb588264885b3a1596f75010e371a2052033f)",
+  "reportGeneratedAt": "2026-09-26T00:32:42.739Z",
+  "fixtures": 32,
+  "compiled": 32,
+  "matched": 30,
+  "medianCompileMs": 3139,
+  "p95CompileMs": 3472,
+  "medianBinaryBytes": 983392,
+  "p95BinaryBytes": 1016464,
+  "patchSourceSha256": "69cf5d0bcf3f4d4c05b81df0ff04b83479af622539fa19566155531bf3ee469c",
+  "patchMarkerCount": 27,
+  "patchTargets": {
+    "compiler/render.js": [
+      "PORT_MARKER",
+      "CONSOLE_MARKER",
+      "BYTESTRING_MARKER",
+      "READ_RAW_MARKER"
+    ],
+    "compiler/index.js": [
+      "LINK_MARKER",
+      "CFLAGS_MARKER"
+    ],
+    "compiler/builtins/typedarray.js": [
+      "TYPED_ARRAY_FROM_MARKER"
+    ],
+    "compiler/builtins/date.ts": [
+      "DATE_PARSER_MARKER"
+    ],
+    "compiler/uwebsockets.js": [
+      "BODY_MARKER",
+      "STATUS_SIG_MARKER",
+      "STATUS_303_MARKER",
+      "STATUS_DEFAULT_MARKER",
+      "HDR_SIG_MARKER",
+      "HDR_CALL_MARKER",
+      "HDR_CAP_MARKER",
+      "HDR_SKIP_MARKER",
+      "HDR_APPEND_MARKER",
+      "READ_RAW_DECL_MARKER",
+      "FORBIDDEN_HDR_MARKER",
+      "WRITE_RESPONSE_MARKER",
+      "R2_TRANSFER_MARKER",
+      "R2_TRANSFER_CALL_MARKER",
+      "R2_DOWNLOAD_CACHE_MARKER",
+      "R2_RANGE_CACHE_MARKER",
+      "R2_CONDITIONAL_CACHE_MARKER",
+      "R2_STREAMING_CACHE_MARKER",
+      "R2_RANGE_HEADER_CACHE_MARKER"
+    ],
+    "compiler/builtins_precompiled.js": []
+  },
+  "patchApplication": "pass",
+  "mismatches": [
+    "15-date-iso.js: request 3 mismatch: expected {\"status\":200,\"body\":\"2008-03-04T23:00:00.000Z\",\"content-type\":null}, got {\"status\":200,\"body\":\"0003-05-08T00:00:00.000Z\",\"content-type\":null}",
+    "16-date-parts.js: request 3 mismatch: expected {\"status\":200,\"body\":\"{\\\"year\\\":2008,\\\"month\\\":3,\\\"day\\\":4}\",\"content-type\":\"application/json;charset=utf-8\"}, got {\"status\":200,\"body\":\"{\\\"year\\\":3,\\\"month\\\":5,\\\"day\\\":8}\",\"content-type\":\"application/json;charset=utf-8\"}"
+  ]
+}

package/src/acquire.test.ts

@@ -34,6 +34,7 @@ async function fixture(): Promise<{ archive: string; sha256: string }> {
       "const path = require('node:path');\n" +
       "fs.writeFileSync(path.join(__dirname, 'builtins_precompiled.js'), fs.readFileSync(path.join(__dirname, 'builtins/typedarray.js')));\n",
     "compiler/builtins_precompiled.js": "fixture:precompiled\n",
+    "compiler/builtins/date.ts": "export const __ecma262_ParseDTSF = (string: string) => {\n  let n: number = 0;\n  let nInd: number = 0;\n\n  const len: i32 = string.length;\n  const endPtr: i32 = Porffor.IR.ptr(string) + len;\n  let ptr: i32 = Porffor.IR.ptr(string);\n\n  while (ptr <= endPtr) { // <= to include extra null byte to set last n\n    const chr: i32 = Porffor.IR.loadU8(ptr++, 4);\n    if (Porffor.fastAnd(chr >= 48, chr <= 57)) { // 0-9\n      n *= 10;\n      n += chr - 48;\n      continue;\n    }\n\n    if (chr == 45) { // -\n      if (Porffor.fastOr(ptr == Porffor.IR.ptr(string), nInd == 7)) n = -n;\n    }\n\n    if (n > 0) {\n      if (nInd == 0) y = n;\n        else if (nInd == 1) m = n - 1;\n        else if (nInd == 2) dt = n;\n        else if (nInd == 3) h = n;\n        else if (nInd == 4) min = n;\n        else if (nInd == 5) s = n;\n        else if (nInd == 6) milli = n;\n        else if (nInd == 7) tzHour = n;\n        else if (nInd == 8) tzMin = n;\n\n      n = 0;\n      nInd++;\n    }\n  }\n\n  h += tzHour;\n  min += tzMin;\n};\n// RFC 7231 or Date.prototype.toString() parser\n",
     "compiler/builtins/typedarray.js":
       "export const __${name}_from = (arg: any, mapFn: any): ${name} => {\n" +
       "  const arr: any[] = Porffor.array.new(4);\n" +

package/src/acquire.ts

@@ -38,6 +38,7 @@ const required = [
   "compiler/index.js",
   "compiler/uwebsockets.js",
   "compiler/precompile.js",
+  "compiler/builtins/date.ts",
   "compiler/builtins/typedarray.js",
   "compiler/builtins_precompiled.js",
 ];

package/src/date-native.test.ts

@@ -0,0 +1,37 @@
+import { expect, test } from "bun:test";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { resolve } from "node:path";
+import { ensurePorffor } from "./acquire";
+
+test("native ISO dates honor signed offsets, zero fields, and fractional seconds", async () => {
+  const root = await mkdtemp(resolve(tmpdir(), "sb-date-native-"));
+  const samples = [
+    "2024-01-02T03:04:05Z",
+    "2024-01-02T03:04:05+02:00",
+    "2024-01-02T03:04:05-05:00",
+    "2024-01-02T03:04:05.250+01:00",
+    "2024-01-02T00:00:00Z",
+    "2024-01-02T03:04:05.2+02:30",
+    "2024-01-02T03:04:05.25-00:30",
+  ];
+  try {
+    const porffor = await ensurePorffor({ cacheRoot: resolve(root, "cache") });
+    const source = resolve(root, "date.js");
+    const binary = resolve(root, "date-native");
+    await writeFile(source, `for (const value of ${JSON.stringify(samples)}) console.log(new Date(value).toISOString());\n`);
+    const compile = Bun.spawnSync(["bun", resolve(porffor, "runtime/index.js"), "native", source, "-o", binary, "-s"], {
+      cwd: root,
+      stdout: "pipe",
+      stderr: "pipe",
+    });
+    expect(compile.exitCode, Buffer.from(compile.stderr).toString()).toBe(0);
+    const run = Bun.spawnSync([binary], { stdout: "pipe", stderr: "pipe" });
+    expect(run.exitCode, Buffer.from(run.stderr).toString()).toBe(0);
+    expect(Buffer.from(run.stdout).toString().trim().split("\n")).toEqual(
+      samples.map((value) => new Date(value).toISOString()),
+    );
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+}, 30_000);

package/src/patch.ts

@@ -1,7 +1,7 @@
 /**
  * Idempotent, marker-guarded in-place edits to Porffor's generated C
  * (`compiler/render.js`, `compiler/index.js`, `compiler/uwebsockets.js`,
- * `compiler/builtins/typedarray.js`). Run
+ * `compiler/builtins/typedarray.js`, `compiler/builtins/date.ts`). Run
  * from the build path, not a `postinstall` hook: package managers block
  * dependency lifecycle scripts by default, so a published `postinstall` would
  * silently not run.
@@ -193,6 +193,93 @@ const TYPED_ARRAY_FROM_INJECT =
   "  }\n\n  arr.length = len;\n\n  return new ${name}(arr);\n};";
 const TYPED_ARRAY_FROM_MARKER = "sproutboat: TypedArray.from accepts array-like objects";
 
+// Porffor alpha 9 treats +02:00 as two milliseconds and adds offset hours
+// instead of subtracting them. Count fields even when they contain zero, and
+// apply the signed offset after parsing the local wall-clock fields.
+const DATE_PARSER_MARKER = "sproutboat: ISO timezone offset";
+const DATE_PARSER_ANCHOR = `  let n: number = 0;
+  let nInd: number = 0;
+
+  const len: i32 = string.length;
+  const endPtr: i32 = Porffor.IR.ptr(string) + len;
+  let ptr: i32 = Porffor.IR.ptr(string);
+
+  while (ptr <= endPtr) { // <= to include extra null byte to set last n
+    const chr: i32 = Porffor.IR.loadU8(ptr++, 4);
+    if (Porffor.fastAnd(chr >= 48, chr <= 57)) { // 0-9
+      n *= 10;
+      n += chr - 48;
+      continue;
+    }
+
+    if (chr == 45) { // -
+      if (Porffor.fastOr(ptr == Porffor.IR.ptr(string), nInd == 7)) n = -n;
+    }
+
+    if (n > 0) {
+      if (nInd == 0) y = n;
+        else if (nInd == 1) m = n - 1;
+        else if (nInd == 2) dt = n;
+        else if (nInd == 3) h = n;
+        else if (nInd == 4) min = n;
+        else if (nInd == 5) s = n;
+        else if (nInd == 6) milli = n;
+        else if (nInd == 7) tzHour = n;
+        else if (nInd == 8) tzMin = n;
+
+      n = 0;
+      nInd++;
+    }
+  }
+
+  h += tzHour;
+  min += tzMin;`;
+const DATE_PARSER_INJECT = `  // sproutboat: ISO timezone offset
+  let n: number = 0;
+  let nInd: number = 0;
+  let digits: i32 = 0;
+  let offsetSign: i32 = 0;
+
+  const len: i32 = string.length;
+  const endPtr: i32 = Porffor.IR.ptr(string) + len;
+  let ptr: i32 = Porffor.IR.ptr(string);
+
+  while (ptr <= endPtr) {
+    const chr: i32 = Porffor.IR.loadU8(ptr++, 4);
+    if (Porffor.fastAnd(chr >= 48, chr <= 57)) {
+      n = n * 10 + chr - 48;
+      digits++;
+      continue;
+    }
+
+    if (digits > 0) {
+      if (nInd == 0) y = n;
+        else if (nInd == 1) m = n - 1;
+        else if (nInd == 2) dt = n;
+        else if (nInd == 3) h = n;
+        else if (nInd == 4) min = n;
+        else if (nInd == 5) s = n;
+        else if (nInd == 6) {
+          while (digits < 3) { n *= 10; digits++; }
+          while (digits > 3) { n = Math.trunc(n / 10); digits--; }
+          milli = n;
+        }
+        else if (nInd == 7) tzHour = n;
+        else if (nInd == 8) tzMin = n;
+      n = 0;
+      nInd++;
+      digits = 0;
+    }
+
+    if (Porffor.fastOr(chr == 43, chr == 45) && nInd >= 6) {
+      offsetSign = chr == 43 ? 1 : -1;
+      nInd = 7;
+    }
+  }
+
+  h -= offsetSign * tzHour;
+  min -= offsetSign * tzMin;`;
+
 /**
  * #56 — make the inbound request-body limit configurable.
  *
@@ -856,6 +943,19 @@ async function patchCompilerArgs(root: string): Promise<void> {
   if (changed) await writeFile(file, src);
 }
 
+export async function patchDateParser(root: string): Promise<void> {
+  const file = resolve(root, "compiler/builtins/date.ts");
+  const src = await readFile(file, "utf8");
+  if (src.includes(DATE_PARSER_MARKER)) return;
+  const start = src.indexOf("export const __ecma262_ParseDTSF");
+  const end = src.indexOf("// RFC 7231 or Date.prototype.toString() parser", start);
+  if (start < 0 || end < 0) throw new Error(`could not find Porffor's ISO date parser in ${file}`);
+  const parser = src.slice(start, end);
+  if (!parser.includes(DATE_PARSER_ANCHOR))
+    throw new Error(`could not patch Porffor's ISO date parser: anchor not found in ${file}`);
+  await writeFile(file, src.slice(0, start) + parser.replace(DATE_PARSER_ANCHOR, DATE_PARSER_INJECT) + src.slice(end));
+}
+
 export async function patchTypedArrayFrom(root: string): Promise<void> {
   const file = resolve(root, "compiler/builtins/typedarray.js");
   const src = await readFile(file, "utf8");
@@ -930,6 +1030,7 @@ export async function ensurePorfforPatched(root: string): Promise<void> {
   await patchCompilerArgs(root);
   await patchUwebsockets(root);
   await patchRenderJs(root);
+  await patchDateParser(root);
   await patchTypedArrayFrom(root);
   done.add(root);
 }