redscript-mc 2.6.2 → 3.0.0

package/benchmarks/baseline.md

@@ -0,0 +1,13 @@
+# Compiler Performance Benchmark
+
+Generated: 2026-03-21T22:24:38.379Z
+
+Host: Apple M4 | 10 cores | 16384 MB RAM | darwin 24.6.0 (arm64)
+
+Iterations per case: 5
+
+| Target Lines | Actual Lines | Helpers | Calls | Parse (avg ms) | HIR (avg ms) | MIR (avg ms) | Emit (avg ms) | Total (avg ms) | Parse (median ms) | HIR (median ms) | MIR (median ms) | Emit (median ms) | Total (median ms) | .mcfunction Files | .mcfunction Lines |
+| ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
+| 10 | 10 | 1 | 0 | 0.495 | 0.094 | 0.730 | 0.052 | 1.388 | 0.109 | 0.022 | 0.161 | 0.015 | 0.313 | 3 | 15 |
+| 100 | 100 | 12 | 35 | 0.487 | 0.050 | 1.179 | 0.052 | 1.773 | 0.400 | 0.039 | 0.883 | 0.051 | 1.423 | 15 | 307 |
+| 500 | 500 | 62 | 185 | 1.149 | 0.069 | 4.362 | 0.123 | 5.709 | 1.091 | 0.045 | 4.171 | 0.114 | 5.619 | 65 | 1557 |

package/benchmarks/compiler-perf.report.json

@@ -0,0 +1,207 @@
+{
+  "benchmark": "compiler-perf",
+  "generatedAt": "2026-03-21T20:40:12.299Z",
+  "host": {
+    "platform": "darwin",
+    "release": "24.6.0",
+    "arch": "arm64",
+    "cpuModel": "Apple M4",
+    "cpuCount": 10,
+    "totalMemoryMb": 16384
+  },
+  "iterations": 5,
+  "scales": [
+    {
+      "targetLines": 10,
+      "actualLines": 10,
+      "helperCount": 1,
+      "callCount": 0,
+      "output": {
+        "fileCount": 5,
+        "mcfunctionFileCount": 3,
+        "instructionCount": 12,
+        "totalBytes": 866,
+        "mcfunctionBytes": 731
+      },
+      "samples": [
+        {
+          "parseMs": 1.931,
+          "hirMs": 0.388,
+          "mirMs": 2.964,
+          "emitMs": 0.2,
+          "totalMs": 5.549
+        },
+        {
+          "parseMs": 0.182,
+          "hirMs": 0.02,
+          "mirMs": 1.004,
+          "emitMs": 0.117,
+          "totalMs": 1.332
+        },
+        {
+          "parseMs": 0.121,
+          "hirMs": 0.021,
+          "mirMs": 0.258,
+          "emitMs": 0.016,
+          "totalMs": 0.421
+        },
+        {
+          "parseMs": 0.105,
+          "hirMs": 0.016,
+          "mirMs": 0.133,
+          "emitMs": 0.012,
+          "totalMs": 0.272
+        },
+        {
+          "parseMs": 0.2,
+          "hirMs": 0.022,
+          "mirMs": 0.139,
+          "emitMs": 0.012,
+          "totalMs": 0.378
+        }
+      ],
+      "averages": {
+        "parseMs": 0.508,
+        "hirMs": 0.093,
+        "mirMs": 0.9,
+        "emitMs": 0.071,
+        "totalMs": 1.591
+      },
+      "medians": {
+        "parseMs": 0.182,
+        "hirMs": 0.021,
+        "mirMs": 0.258,
+        "emitMs": 0.016,
+        "totalMs": 0.421
+      }
+    },
+    {
+      "targetLines": 100,
+      "actualLines": 100,
+      "helperCount": 12,
+      "callCount": 35,
+      "output": {
+        "fileCount": 17,
+        "mcfunctionFileCount": 15,
+        "instructionCount": 292,
+        "totalBytes": 17645,
+        "mcfunctionBytes": 17508
+      },
+      "samples": [
+        {
+          "parseMs": 2.459,
+          "hirMs": 0.212,
+          "mirMs": 1.604,
+          "emitMs": 0.075,
+          "totalMs": 4.36
+        },
+        {
+          "parseMs": 0.466,
+          "hirMs": 0.05,
+          "mirMs": 1.583,
+          "emitMs": 0.06,
+          "totalMs": 2.165
+        },
+        {
+          "parseMs": 0.429,
+          "hirMs": 0.042,
+          "mirMs": 1.715,
+          "emitMs": 0.046,
+          "totalMs": 2.237
+        },
+        {
+          "parseMs": 3.443,
+          "hirMs": 0.047,
+          "mirMs": 0.845,
+          "emitMs": 0.061,
+          "totalMs": 4.406
+        },
+        {
+          "parseMs": 0.909,
+          "hirMs": 0.042,
+          "mirMs": 0.66,
+          "emitMs": 0.041,
+          "totalMs": 1.657
+        }
+      ],
+      "averages": {
+        "parseMs": 1.541,
+        "hirMs": 0.079,
+        "mirMs": 1.282,
+        "emitMs": 0.057,
+        "totalMs": 2.965
+      },
+      "medians": {
+        "parseMs": 0.909,
+        "hirMs": 0.047,
+        "mirMs": 1.583,
+        "emitMs": 0.06,
+        "totalMs": 2.237
+      }
+    },
+    {
+      "targetLines": 1000,
+      "actualLines": 1000,
+      "helperCount": 125,
+      "callCount": 370,
+      "output": {
+        "fileCount": 130,
+        "mcfunctionFileCount": 128,
+        "instructionCount": 2984,
+        "totalBytes": 182232,
+        "mcfunctionBytes": 182093
+      },
+      "samples": [
+        {
+          "parseMs": 3.663,
+          "hirMs": 1.1,
+          "mirMs": 29.995,
+          "emitMs": 0.446,
+          "totalMs": 35.235
+        },
+        {
+          "parseMs": 2.759,
+          "hirMs": 0.087,
+          "mirMs": 16.618,
+          "emitMs": 1.73,
+          "totalMs": 21.209
+        },
+        {
+          "parseMs": 2.112,
+          "hirMs": 0.086,
+          "mirMs": 12.813,
+          "emitMs": 0.277,
+          "totalMs": 15.294
+        },
+        {
+          "parseMs": 2.153,
+          "hirMs": 0.097,
+          "mirMs": 12.941,
+          "emitMs": 0.273,
+          "totalMs": 15.471
+        },
+        {
+          "parseMs": 2.348,
+          "hirMs": 0.077,
+          "mirMs": 12.889,
+          "emitMs": 0.239,
+          "totalMs": 15.561
+        }
+      ],
+      "averages": {
+        "parseMs": 2.607,
+        "hirMs": 0.289,
+        "mirMs": 17.051,
+        "emitMs": 0.593,
+        "totalMs": 20.554
+      },
+      "medians": {
+        "parseMs": 2.348,
+        "hirMs": 0.087,
+        "mirMs": 12.941,
+        "emitMs": 0.277,
+        "totalMs": 15.561
+      }
+    }
+  ]
+}

package/benchmarks/compiler-perf.ts

@@ -0,0 +1,76 @@
+import {
+  benchmarkMeta,
+  buildSyntheticProgram,
+  mean,
+  median,
+  parseCliArgs,
+  round,
+  runPipeline,
+  summarizeFiles,
+  writeJsonReport,
+} from './_shared'
+
+interface StageSample {
+  parseMs: number
+  hirMs: number
+  mirMs: number
+  emitMs: number
+  totalMs: number
+}
+
+const SCALE_TARGETS = [10, 100, 1000] as const
+
+function main(): void {
+  const { iterations, output } = parseCliArgs(process.argv.slice(2))
+  const cases = SCALE_TARGETS.map(targetLines => {
+    const program = buildSyntheticProgram(targetLines)
+    const samples: StageSample[] = []
+    let lastSummary = summarizeFiles([])
+
+    for (let i = 0; i < iterations; i++) {
+      const result = runPipeline(program.source, {
+        namespace: `bench_${targetLines}`,
+        optimizationLevel: 1,
+      })
+      samples.push(result.timings)
+      lastSummary = summarizeFiles(result.files)
+    }
+
+    return {
+      targetLines,
+      actualLines: program.actualLines,
+      helperCount: program.helperCount,
+      callCount: program.callCount,
+      output: lastSummary,
+      samples: samples.map(sample => ({
+        parseMs: round(sample.parseMs),
+        hirMs: round(sample.hirMs),
+        mirMs: round(sample.mirMs),
+        emitMs: round(sample.emitMs),
+        totalMs: round(sample.totalMs),
+      })),
+      averages: {
+        parseMs: round(mean(samples.map(sample => sample.parseMs))),
+        hirMs: round(mean(samples.map(sample => sample.hirMs))),
+        mirMs: round(mean(samples.map(sample => sample.mirMs))),
+        emitMs: round(mean(samples.map(sample => sample.emitMs))),
+        totalMs: round(mean(samples.map(sample => sample.totalMs))),
+      },
+      medians: {
+        parseMs: round(median(samples.map(sample => sample.parseMs))),
+        hirMs: round(median(samples.map(sample => sample.hirMs))),
+        mirMs: round(median(samples.map(sample => sample.mirMs))),
+        emitMs: round(median(samples.map(sample => sample.emitMs))),
+        totalMs: round(median(samples.map(sample => sample.totalMs))),
+      },
+    }
+  })
+
+  writeJsonReport({
+    ...benchmarkMeta('compiler-perf'),
+    iterations,
+    scales: cases,
+  }, output)
+}
+
+main()

package/benchmarks/results.md

@@ -0,0 +1,13 @@
+# Compiler Performance Benchmark
+
+Generated: 2026-03-21T22:24:38.379Z
+
+Host: Apple M4 | 10 cores | 16384 MB RAM | darwin 24.6.0 (arm64)
+
+Iterations per case: 5
+
+| Target Lines | Actual Lines | Helpers | Calls | Parse (avg ms) | HIR (avg ms) | MIR (avg ms) | Emit (avg ms) | Total (avg ms) | Parse (median ms) | HIR (median ms) | MIR (median ms) | Emit (median ms) | Total (median ms) | .mcfunction Files | .mcfunction Lines |
+| ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
+| 10 | 10 | 1 | 0 | 0.495 | 0.094 | 0.730 | 0.052 | 1.388 | 0.109 | 0.022 | 0.161 | 0.015 | 0.313 | 3 | 15 |
+| 100 | 100 | 12 | 35 | 0.487 | 0.050 | 1.179 | 0.052 | 1.773 | 0.400 | 0.039 | 0.883 | 0.051 | 1.423 | 15 | 307 |
+| 500 | 500 | 62 | 185 | 1.149 | 0.069 | 4.362 | 0.123 | 5.709 | 1.091 | 0.045 | 4.171 | 0.114 | 5.619 | 65 | 1557 |