rbxts-transform-boost 0.1.0 → 1.1.0

package/dist/passes/annotate.js

@@ -36,7 +36,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.annotatePass = annotatePass;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-// Luau type names for TypeScript type strings rotor knows about
 const LUAU_TYPE = {
     number: "number",
     string: "string",
@@ -58,7 +57,6 @@ const LUAU_TYPE = {
     Region3: "Region3",
     Ray: "Ray",
     buffer: "buffer",
-    // Roblox service types
     Instance: "Instance",
     BasePart: "BasePart",
     Part: "Part",
@@ -68,21 +66,9 @@ const LUAU_TYPE = {
     Workspace: "Workspace",
     RunService: "RunService",
     Players: "Players",
-    // Luau numeric arrays — kept as {number} in Luau
 };
-// Global sidecar: outLuauPath → list of function annotations for that file
 const sidecar = new Map();
 let hooked = false;
-function luauTypeForTsType(ts, checker, node) {
-    if (node.type) {
-        const mapped = mapTypeNode(ts, node.type);
-        if (mapped)
-            return mapped;
-    }
-    const type = checker.getTypeAtLocation(node);
-    const name = checker.typeToString(type);
-    return LUAU_TYPE[name] ?? null;
-}
 function mapTypeNode(ts, typeNode) {
     if (ts.isTypeReferenceNode(typeNode)) {
         const name = ts.isIdentifier(typeNode.typeName) ? typeNode.typeName.text : null;
@@ -90,7 +76,6 @@ function mapTypeNode(ts, typeNode) {
             return null;
         if (LUAU_TYPE[name])
             return LUAU_TYPE[name];
-        // Array<T> → {T}
         if ((name === "Array" || name === "ReadonlyArray") && typeNode.typeArguments?.length === 1) {
             const inner = mapTypeNode(ts, typeNode.typeArguments[0]);
             return inner ? `{${inner}}` : "{any}";
@@ -110,22 +95,40 @@ function mapTypeNode(ts, typeNode) {
         return kw[typeNode.kind];
     return null;
 }
+function luauTypeForParam(ts, checker, node) {
+    if (node.type) {
+        const mapped = mapTypeNode(ts, node.type);
+        if (mapped)
+            return mapped;
+    }
+    const name = checker.typeToString(checker.getTypeAtLocation(node));
+    return LUAU_TYPE[name] ?? null;
+}
+function luauTypeForReturn(ts, checker, node) {
+    if (node.type) {
+        const mapped = mapTypeNode(ts, node.type);
+        if (mapped)
+            return mapped;
+    }
+    const sig = checker.getSignatureFromDeclaration(node);
+    if (!sig)
+        return null;
+    const ret = checker.getReturnTypeOfSignature(sig);
+    const name = checker.typeToString(ret);
+    return LUAU_TYPE[name] ?? null;
+}
 function outPathForSource(sourceFile, program) {
     const options = program.getCompilerOptions();
     const outDir = options.outDir;
     if (!outDir)
         return null;
-    // Compute rootDir: explicit option or the common root of all source files
-    const rootDir = options.rootDir
-        ?? commonRoot(program.getRootFileNames());
+    const rootDir = options.rootDir ?? commonRoot(program.getRootFileNames());
     if (!rootDir)
         return null;
     const rel = path.relative(rootDir, sourceFile.fileName);
     if (rel.startsWith(".."))
         return null;
-    // Change .ts / .tsx extension to .luau
-    const luauRel = rel.replace(/\.tsx?$/, ".luau");
-    return path.join(outDir, luauRel);
+    return path.join(outDir, rel.replace(/\.tsx?$/, ".luau"));
 }
 function commonRoot(files) {
     if (files.length === 0)
@@ -142,45 +145,239 @@ function commonRoot(files) {
     return root.join(path.sep) || undefined;
 }
 function collectAnnotations(ts, checker, sourceFile, outPath) {
-    const fileMap = sidecar.get(outPath) ?? new Map();
-    sidecar.set(outPath, fileMap);
+    const entry = sidecar.get(outPath) ?? { fns: new Map(), consts: new Set() };
+    sidecar.set(outPath, entry);
     function visit(node) {
         if (ts.isFunctionDeclaration(node) && node.name) {
-            const fnName = node.name.text;
-            const params = node.parameters.map(p => luauTypeForTsType(ts, checker, p));
-            if (params.some(p => p !== null)) {
-                fileMap.set(fnName, { params });
+            const params = node.parameters.map(p => luauTypeForParam(ts, checker, p));
+            const ret = luauTypeForReturn(ts, checker, node);
+            if (params.some(p => p !== null) || ret !== null) {
+                entry.fns.set(node.name.text, { params, ret });
+            }
+        }
+        if (ts.isVariableStatement(node)) {
+            const isConst = (node.declarationList.flags & ts.NodeFlags.Const) !== 0;
+            if (isConst) {
+                for (const decl of node.declarationList.declarations) {
+                    if (ts.isIdentifier(decl.name)) {
+                        entry.consts.add(decl.name.text);
+                    }
+                }
             }
         }
         ts.forEachChild(node, visit);
     }
     visit(sourceFile);
 }
-function injectAnnotations(luauPath, fileMap) {
+function byLengthDesc(a, b) {
+    return b.length - a.length;
+}
+function organizePreamble(src) {
+    const lines = src.split("\n");
+    let i = 0;
+    // Collect --! directives separately from other leading comments
+    const shebang = [];
+    const header = [];
+    while (i < lines.length && lines[i].startsWith("--")) {
+        if (lines[i].startsWith("--!")) {
+            shebang.push(lines[i++]);
+        }
+        else {
+            header.push(lines[i++]);
+        }
+    }
+    shebang.sort(byLengthDesc);
+    const services = [];
+    const runtime = [];
+    const importGroups = [];
+    const bindings = [];
+    let pendingLabel = null;
+    let currentImports = [];
+    function flushImports() {
+        if (currentImports.length > 0) {
+            importGroups.push({ label: pendingLabel ?? "-- Imports", lines: [...currentImports] });
+            currentImports = [];
+        }
+        pendingLabel = null;
+    }
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line.trim() === "") {
+            // Blank line = end of current import group
+            flushImports();
+            i++;
+            continue;
+        }
+        if (/^--!/.test(line)) {
+            // Rotor can emit --!native after preamble locals — hoist it up
+            shebang.push(line);
+            shebang.sort(byLengthDesc);
+            i++;
+        }
+        else if (/^--/.test(line)) {
+            // User comment becomes the label for the next import group
+            flushImports();
+            pendingLabel = line;
+            i++;
+        }
+        else if (/^local \w+ = game:GetService\(/.test(line)) {
+            flushImports();
+            services.push(line);
+            i++;
+        }
+        else if (/^local \w+ = require\(/.test(line)) {
+            flushImports();
+            runtime.push(line);
+            i++;
+        }
+        else if (/^local \w+ = TS\.import\(/.test(line)) {
+            currentImports.push(line);
+            i++;
+        }
+        else if (/^local \w+ = \w+[\.\[]/.test(line) && !/^local function/.test(line)) {
+            flushImports();
+            bindings.push(line);
+            i++;
+        }
+        else {
+            break;
+        }
+    }
+    flushImports();
+    services.sort(byLengthDesc);
+    bindings.sort(byLengthDesc);
+    const out = [...shebang];
+    if (header.length > 0)
+        out.push("", ...header);
+    if (services.length > 0)
+        out.push("", "-- Services", ...services);
+    if (runtime.length > 0)
+        out.push("", "-- Runtime", ...runtime);
+    for (const group of importGroups) {
+        group.lines.sort(byLengthDesc);
+        out.push("", group.label, ...group.lines);
+    }
+    if (bindings.length > 0)
+        out.push("", "-- Bindings", ...bindings);
+    if (i < lines.length)
+        out.push("", ...lines.slice(i));
+    return out.join("\n");
+}
+function hoistGetService(src) {
+    // Count occurrences of each game:GetService("X") call
+    const re = /game:GetService\("([^"]+)"\)/g;
+    const counts = new Map();
+    for (const m of src.matchAll(re)) {
+        counts.set(m[1], (counts.get(m[1]) ?? 0) + 1);
+    }
+    const toHoist = [...counts.entries()].filter(([, n]) => n >= 2).map(([svc]) => svc);
+    if (toHoist.length === 0)
+        return src;
+    // Build locals and replace
+    const decls = toHoist
+        .map(svc => `local _${svc} = game:GetService("${svc}")`)
+        .join("\n");
+    for (const svc of toHoist) {
+        src = src.split(`game:GetService("${svc}")`).join(`_${svc}`);
+    }
+    // Insert after any leading --! directives and the rotor header comment
+    const insertAt = src.search(/^(?!--[!\s]|--\s*Compiled)/m);
+    if (insertAt === -1)
+        return decls + "\n" + src;
+    return src.slice(0, insertAt) + decls + "\n" + src.slice(insertAt);
+}
+function addSpacing(src) {
+    const lines = src.split("\n");
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        const prevOut = out.length > 0 ? out[out.length - 1] : "";
+        const prevTrimmed = prevOut.trim();
+        const alreadyBlank = prevTrimmed === "";
+        if (!alreadyBlank) {
+            // Blank before top-level local function
+            if (/^local function /.test(trimmed)) {
+                out.push("");
+            }
+            // Blank before return when it's not the first statement in its block
+            else if (/^return\b/.test(trimmed) &&
+                !/\b(then|do|repeat)$/.test(prevTrimmed) &&
+                !/function\s*\([^)]*\)$/.test(prevTrimmed) &&
+                !/^local function /.test(prevTrimmed)) {
+                out.push("");
+            }
+            // Blank before a block starter (do/while/for/if/repeat) when prev is local/const
+            else if (/^(do\b|while |for |if |repeat\b)/.test(trimmed) && /^(local |const )/.test(prevTrimmed)) {
+                out.push("");
+            }
+            // Blank on const → local transition
+            else if (/^local /.test(trimmed) && /^const /.test(prevTrimmed)) {
+                out.push("");
+            }
+        }
+        out.push(line);
+        // Blank after `end` when next non-blank line is not end/else/elseif/until
+        if (trimmed === "end") {
+            const next = lines[i + 1]?.trim() ?? "";
+            if (next !== "" && !/^(end\b|else\b|elseif\b|until\b)/.test(next)) {
+                out.push("");
+            }
+        }
+    }
+    return out.join("\n");
+}
+function injectAnnotations(luauPath, entry) {
     if (!fs.existsSync(luauPath))
         return;
     let src = fs.readFileSync(luauPath, "utf8");
     let changed = false;
-    for (const [fnName, ann] of fileMap) {
-        if (ann.params.every(p => p === null))
+    // Inject param + return type annotations
+    for (const [fnName, ann] of entry.fns) {
+        if (ann.params.every(p => p === null) && ann.ret === null)
             continue;
-        // Match: local function fnName(a, b, c)
-        // Captures the param list so we can replace individual names
-        const re = new RegExp(`(local function ${escapeRegex(fnName)}\\()([^)]*)(\\.\\.\\.\\))?\\)`);
-        src = src.replace(re, (_match, open, rawParams, vararg) => {
+        const re = new RegExp(`(local function ${escapeRegex(fnName)}\\()([^)]*)(\\.\\.\\.)?(\\))`);
+        src = src.replace(re, (_m, open, rawParams, vararg, close) => {
             const names = rawParams.split(",").map((s) => s.trim()).filter(Boolean);
             const annotated = names.map((name, i) => {
-                // strip any existing annotation
                 const bare = name.split(":")[0].trim();
                 const typ = ann.params[i];
                 return typ ? `${bare}: ${typ}` : bare;
             });
             if (vararg)
                 annotated.push("...");
+            const retSuffix = ann.ret ? `: ${ann.ret}` : "";
             changed = true;
-            return `${open}${annotated.join(", ")})`;
+            return `${open}${annotated.join(", ")}${close}${retSuffix}`;
         });
     }
+    // Replace local → const for TypeScript const declarations
+    for (const name of entry.consts) {
+        const re = new RegExp(`^(\\t*)local (${escapeRegex(name)}) =`, "m");
+        const next = src.replace(re, `$1const $2 =`);
+        if (next !== src) {
+            src = next;
+            changed = true;
+        }
+    }
+    // Hoist any repeated game:GetService() calls injected by the compiler
+    const hoisted = hoistGetService(src);
+    if (hoisted !== src) {
+        src = hoisted;
+        changed = true;
+    }
+    // Organize preamble into labeled sections
+    const organized = organizePreamble(src);
+    if (organized !== src) {
+        src = organized;
+        changed = true;
+    }
+    // Add blank lines between top-level blocks for readability
+    const spaced = addSpacing(src);
+    if (spaced !== src) {
+        src = spaced;
+        changed = true;
+    }
     if (changed)
         fs.writeFileSync(luauPath, src, "utf8");
 }
@@ -198,16 +395,14 @@ function installWatcher(outDir) {
         const full = path.join(outDir, filename);
         if (seen.has(full))
             return;
-        const fileMap = sidecar.get(full);
-        if (!fileMap)
+        const entry = sidecar.get(full);
+        if (!entry)
             return;
         seen.add(full);
-        if (fileMap.size > 0) {
-            try {
-                injectAnnotations(full, fileMap);
-            }
-            catch { /* ignore */ }
+        try {
+            injectAnnotations(full, entry);
         }
+        catch { /* ignore */ }
     });
     watcher.unref();
 }
@@ -215,8 +410,6 @@ function annotatePass(ts, program, sourceFile) {
     const outPath = outPathForSource(sourceFile, program);
     if (!outPath)
         return;
-    const checker = program.getTypeChecker();
-    collectAnnotations(ts, checker, sourceFile, outPath);
-    const outDir = program.getCompilerOptions().outDir;
-    installWatcher(outDir);
+    collectAnnotations(ts, program.getTypeChecker(), sourceFile, outPath);
+    installWatcher(program.getCompilerOptions().outDir);
 }

package/dist/passes/native.d.ts

@@ -1,2 +1,2 @@
 import type ts from "typescript";
-export declare function nativePass(ts: typeof import("typescript"), ctx: ts.TransformationContext, sourceFile: ts.SourceFile): ts.SourceFile;
+export declare function nativePass(ts: typeof import("typescript"), ctx: ts.TransformationContext, sourceFile: ts.SourceFile, optimize: boolean, strict: boolean): ts.SourceFile;

package/dist/passes/native.js

@@ -2,10 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.nativePass = nativePass;
 const util_1 = require("../util");
-function nativePass(ts, ctx, sourceFile) {
-    if ((0, util_1.hasOptimizeDirective)(sourceFile))
-        return sourceFile;
+function nativePass(ts, ctx, sourceFile, optimize, strict) {
     const factory = ctx.factory;
-    const optimize = ts.addSyntheticLeadingComment(factory.createNotEmittedStatement(sourceFile), ts.SyntaxKind.SingleLineCommentTrivia, "!optimize 2", true);
-    return factory.updateSourceFile(sourceFile, [optimize, ...Array.from(sourceFile.statements)]);
+    const prepend = [];
+    if (strict && !(0, util_1.hasStrictDirective)(sourceFile)) {
+        prepend.push(ts.addSyntheticLeadingComment(factory.createNotEmittedStatement(sourceFile), ts.SyntaxKind.SingleLineCommentTrivia, "!strict", true));
+    }
+    if (optimize && !(0, util_1.hasOptimizeDirective)(sourceFile)) {
+        prepend.push(ts.addSyntheticLeadingComment(factory.createNotEmittedStatement(sourceFile), ts.SyntaxKind.SingleLineCommentTrivia, "!optimize 2", true));
+    }
+    if (prepend.length === 0)
+        return sourceFile;
+    return factory.updateSourceFile(sourceFile, [...prepend, ...Array.from(sourceFile.statements)]);
 }

package/dist/util.d.ts

@@ -1,5 +1,6 @@
 import type ts from "typescript";
 export declare function hasOptimizeDirective(sourceFile: ts.SourceFile): boolean;
+export declare function hasStrictDirective(sourceFile: ts.SourceFile): boolean;
 export declare function chainKey(ts: typeof import("typescript"), node: ts.Expression): string | undefined;
 export declare function walk(ts: typeof import("typescript"), node: ts.Node, visitor: (n: ts.Node) => void): void;
 export declare function isAssignmentTarget(ts: typeof import("typescript"), node: ts.Node): boolean;

package/dist/util.js

@@ -1,12 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasOptimizeDirective = hasOptimizeDirective;
+exports.hasStrictDirective = hasStrictDirective;
 exports.chainKey = chainKey;
 exports.walk = walk;
 exports.isAssignmentTarget = isAssignmentTarget;
 function hasOptimizeDirective(sourceFile) {
     return /^--!optimize\b/m.test(sourceFile.text) || /^\/\/!optimize\b/m.test(sourceFile.text);
 }
+function hasStrictDirective(sourceFile) {
+    return /^--!strict\b/m.test(sourceFile.text) || /^\/\/!strict\b/m.test(sourceFile.text);
+}
 function chainKey(ts, node) {
     if (ts.isIdentifier(node))
         return node.text;

package/package.json

@@ -1,16 +1,18 @@
 {
     "name": "rbxts-transform-boost",
-    "version": "0.1.0",
+    "version": "1.1.0",
     "description": "roblox-ts transformer: automatic --!native, GetService hoisting, property chain caching, loop bounds hoisting, and Luau type annotation injection",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
+    "files": [
+        "dist",
+        "README.md"
+    ],
     "scripts": {
         "build": "tsc",
-        "dev": "tsc --watch",
         "bench:build": "npm run build && cd bench && ~/.rokit/bin/rotor build",
         "bench:build:baseline": "cd bench && ~/.rokit/bin/rotor build -p tsconfig.notransform.json -i out/include",
-        "bench:dev": "cd bench && ~/.rokit/bin/rotor dev",
-        "bench:rbxlx": "npm run bench:build && npm run bench:build:baseline && cd bench && ~/.rokit/bin/rojo build benchmark.project.json -o benchmark.rbxlx"
+        "bench:rbxlx": "npm run bench:build && npm run bench:build:baseline && cd bench && ~/.rokit/bin/rojo build default.project.json -o benchmark.rbxlx"
     },
     "keywords": [
         "roblox-ts",
@@ -24,6 +26,7 @@
         "typescript": ">=5.0.0"
     },
     "devDependencies": {
-        "@types/node": "^26.0.0"
+        "@types/node": "^26.0.0",
+        "typescript": "^5.9.3"
     }
 }

package/.github/workflows/publish.yml

@@ -1,26 +0,0 @@
-name: Publish to npm
-
-on:
-  push:
-    tags:
-      - "v*"
-  workflow_dispatch:
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          registry-url: https://registry.npmjs.org
-
-      - run: npm ci
-
-      - run: npm run build
-
-      - run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/bench/benchmark.project.json

@@ -1,20 +0,0 @@
-{
-    "name": "perf-benchmark",
-    "emitLegacyScripts": false,
-    "tree": {
-        "$className": "DataModel",
-        "ServerScriptService": {
-            "$className": "ServerScriptService",
-            "$path": "out/src/server"
-        },
-        "ReplicatedStorage": {
-            "$className": "ReplicatedStorage",
-            "shared": {
-                "$path": "out/src/shared"
-            },
-            "include": {
-                "$path": "out/include"
-            }
-        }
-    }
-}

package/bench/package-lock.json

@@ -1,59 +0,0 @@
-{
-    "name": "rbxts-transform-perf-test",
-    "lockfileVersion": 3,
-    "requires": true,
-    "packages": {
-        "": {
-            "name": "rbxts-transform-perf-test",
-            "devDependencies": {
-                "@rbxts/compiler-types": "^3.0.0-types.0",
-                "@rbxts/types": "^1.0.908",
-                "rbxts-transform-boost": "file:../",
-                "typescript": "=5.5.3"
-            }
-        },
-        "..": {
-            "name": "rbxts-transform-boost",
-            "version": "0.1.0",
-            "dev": true,
-            "devDependencies": {
-                "@types/node": "^26.0.0"
-            },
-            "peerDependencies": {
-                "typescript": ">=5.0.0"
-            }
-        },
-        "node_modules/@rbxts/compiler-types": {
-            "version": "3.0.0-types.0",
-            "resolved": "https://registry.npmjs.org/@rbxts/compiler-types/-/compiler-types-3.0.0-types.0.tgz",
-            "integrity": "sha512-VGOHJPoL7+56NTatMGqQj3K7xWuzEV+aP4QD5vZiHu+bcff3kiTmtoadaF6NkJrmwfFAvbsd4Dg764ZjWNceag==",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/@rbxts/types": {
-            "version": "1.0.928",
-            "resolved": "https://registry.npmjs.org/@rbxts/types/-/types-1.0.928.tgz",
-            "integrity": "sha512-GzmzBNn8fyn0ed9kVQkXUbBXpUg9Gfyf9AZJKT51VGqyrf4w6J0X72eSSGxt6YN2BMHNbqhzHCBn/fM8bdqMTg==",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/rbxts-transform-boost": {
-            "resolved": "..",
-            "link": true
-        },
-        "node_modules/typescript": {
-            "version": "5.5.3",
-            "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.5.3.tgz",
-            "integrity": "sha512-/hreyEujaB0w76zKo6717l3L0o/qEUtRgdvUBvlkhoWeOVMjMuHNHk0BRBzikzuGDqNmPQbg5ifMEqsHLiIUcQ==",
-            "dev": true,
-            "license": "Apache-2.0",
-            "bin": {
-                "tsc": "bin/tsc",
-                "tsserver": "bin/tsserver"
-            },
-            "engines": {
-                "node": ">=14.17"
-            }
-        }
-    }
-}

package/bench/package.json

@@ -1,14 +0,0 @@
-{
-    "name": "rbxts-transform-perf-test",
-    "private": true,
-    "scripts": {
-        "compile": "lumen src -o out/src -i out/include -p default.project.json",
-        "watch": "lumen src -o out/src -i out/include -p default.project.json --watch"
-    },
-    "devDependencies": {
-        "@rbxts/compiler-types": "^3.0.0-types.0",
-        "@rbxts/types": "^1.0.908",
-        "typescript": "=5.5.3",
-        "rbxts-transform-boost": "file:../"
-    }
-}

package/bench/src/server/benchmark.server.ts

@@ -1,57 +0,0 @@
-import * as opt from "../shared/fns";
-import * as base from "../shared/fns-bare";
-
-function bench(label: string, n: number, fn: () => void): void {
-    task.wait(0.05);
-    const t0 = os.clock();
-    for (let i = 0; i < n; i++) fn();
-    const elapsed = os.clock() - t0;
-    print(`  ${label}: ${string.format("%.3f", (elapsed / n) * 1e6)} us/iter`);
-}
-
-const N   = 100000;
-const NS  = 10000;
-
-const pos  = new Vector3(1, 2, 3);
-const vel  = new Vector3(0, 1, 0);
-const acc  = new Vector3(0, -9.8, 0);
-const vecA = new Vector3(1, 0, 0);
-const vecB = new Vector3(0, 1, 0);
-const eye  = new Vector3(0, 5, 10);
-const tgt  = new Vector3(0, 0, 0);
-const cf   = CFrame.lookAt(eye, tgt);
-const buf  = buffer.create(256);
-const vals = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
-const wts  = [1, 1, 1, 1, 1, 1, 1, 1, 1, 1];
-const cam  = game.GetService("Workspace").CurrentCamera!;
-
-function runSuite(fns: typeof opt): void {
-    bench("integrate   (verlet)",        N,  () => fns.integrate(pos, vel, acc, 1 / 60));
-    bench("dot         (V3 manual)",     N,  () => fns.dot(vecA, vecB));
-    bench("cross       (V3 manual)",     N,  () => fns.cross(vecA, vecB));
-    bench("lerpVec3    (V3 manual)",     N,  () => fns.lerpVec3(pos, eye, 0.5));
-    bench("encodeFixed (buf+math)",      N,  () => fns.encodeFixed(buf, 0, 3.14, 100));
-    bench("encodePacket(3x fixed)",      N,  () => fns.encodePacket(buf, 1.1, 2.2, 3.3, 100));
-    bench("sumWeighted (loop)",          N,  () => fns.sumWeighted(vals, wts));
-    bench("dotProduct  (loop)",          N,  () => fns.dotProduct(vals, vals));
-    bench("norm        (loop+sqrt)",     N,  () => fns.norm(vals));
-    bench("mathHeavy   (trig+sqrt)",     N,  () => fns.mathHeavy(1.23, 4.56));
-    bench("fib(20)     (iter)",          N,  () => fns.fib(20));
-    bench("cfLookAt    (ctor)",          NS, () => fns.cfLookAt(eye, tgt));
-    bench("cfChain     (mul+angles)",    N,  () => fns.cfChain(cf, 0.016));
-    bench("serviceWork (GetService x2)", N,  () => fns.serviceWork());
-    bench("multiSvc    (GetService x3)", N,  () => fns.multiService());
-    bench("cameraWork  (prop chain)",    N,  () => fns.cameraWork(cam));
-    bench("formatStats (template)",      N,  () => fns.formatStats("speed", 9.81, "m/s"));
-    bench("buildKey    (template)",      N,  () => fns.buildKey("player", 42, "data"));
-}
-
-print("\n=== optimized (--!native + transformer) ===");
-runSuite(opt);
-print("===========================================\n");
-
-task.wait(1);
-
-print("\n=== baseline (plain rotor, no transformer) ===");
-runSuite(base);
-print("==============================================\n");