@xnoxs/flux-lang 3.1.1

package/src/self/test-runner.js

@@ -0,0 +1,132 @@
+// ── Flux stdlib ──
+
+function map(arr, fn) { return arr.map(fn); }
+
+function filter(arr, fn) { return arr.filter(fn); }
+
+function join(arr, sep) { return arr.join(sep != null ? sep : ','); }
+
+function sort(arr, fn) { return arr.slice().sort(fn); }
+// ── end stdlib ──
+
+// Generated by Flux Transpiler v3.1.0
+"use strict";
+
+const Fs = require("fs");
+const Path = require("path");
+const Os = require("os");
+const C = { reset: "\\x1b[0m", bold: "\\x1b[1m", red: "\\x1b[31m", green: "\\x1b[32m", yellow: "\\x1b[33m", cyan: "\\x1b[36m", gray: "\\x1b[90m", dim: "\\x1b[2m" };
+function clr(c, s) {
+  return (process.env.NO_COLOR ? s : ((c + s) + C.reset));
+}
+const TEST_HELPERS = "\"use strict\";\n\nconst __results = [];\nlet   __current = null;\n\nfunction assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'Assertion failed: expected truthy');\n  }\n}\n\nfunction assertEqual(actual, expected, message) {\n  const ok = JSON.stringify(actual) === JSON.stringify(expected);\n  if (!ok) {\n    throw new Error(\n      message ||\n      'Expected ' + JSON.stringify(expected) + ' but got ' + JSON.stringify(actual)\n    );\n  }\n}\n\nfunction assertNotEqual(actual, expected, message) {\n  const ok = JSON.stringify(actual) !== JSON.stringify(expected);\n  if (!ok) {\n    throw new Error(message || 'Expected values to be different but both were ' + JSON.stringify(actual));\n  }\n}\n\nfunction assertThrows(fn, message) {\n  try { fn(); }\n  catch (_) { return; }\n  throw new Error(message || 'Expected function to throw, but it did not');\n}\n\nfunction assertClose(actual, expected, delta, message) {\n  delta = delta || 1e-9;\n  if (Math.abs(actual - expected) > delta) {\n    throw new Error(message || ('Expected ' + actual + ' to be close to ' + expected + ' (delta=' + delta + ')'));\n  }\n}\n\nfunction __runTest(name, fn) {\n  try {\n    fn();\n    __results.push({ name: name, ok: true });\n  } catch(e) {\n    __results.push({ name: name, ok: false, error: e.message });\n  }\n}";
+function discoverTestFiles(target) {
+  const abs = Path.resolve(target);
+  if (!Fs.existsSync(abs)) {
+    throw new Error(("Not found: " + abs));
+  }
+  const stat = Fs.statSync(abs);
+  if (stat.isDirectory()) {
+    return Fs.readdirSync(abs).filter((f) => f.endsWith(".test.flux")).map((f) => Path.join(abs, f)).sort();
+  }
+  if (abs.endsWith(".flux")) {
+    return [abs];
+  }
+  throw new Error(("Expected a .flux file or directory, got: " + abs));
+}
+module.exports.discoverTestFiles = discoverTestFiles;
+function runTestFile(filePath, transpile) {
+  const source = Fs.readFileSync(filePath, "utf8");
+  const result = transpile(source);
+  if (!result.success) {
+    return { file: Path.basename(filePath), errors: result.errors, tests: [], compile: false };
+  }
+  const fnNames = [];
+  const fnRe = /^function (test_[a-zA-Z0-9_]+)\s*\(/mg;
+  let m = fnRe.exec(result.output);
+  while (m) {
+    fnNames.push(m[1]);
+    m = fnRe.exec(result.output);
+  }
+  const runnerParts = [TEST_HELPERS, result.output, "", "// ── auto-generated test runner ──"];
+  for (const n of fnNames) {
+    runnerParts.push((((("__runTest(" + JSON.stringify(n.replace(/^test_/, "").replace(/_/g, " "))) + ", ") + n) + ");"));
+  }
+  runnerParts.push("module.exports = { __results };");
+  const runner = runnerParts.join("\n");
+  const tmpPath = Path.join(Os.tmpdir(), (("_flux_test_" + Date.now()) + ".js"));
+  try {
+    Fs.writeFileSync(tmpPath, runner, "utf8");
+    const mod = require(tmpPath);
+    const tests = ((mod && mod.__results) ? mod.__results : []);
+    return { file: Path.basename(filePath), tests, compile: true, errors: [] };
+  }
+  catch (e) {
+    return { file: Path.basename(filePath), tests: [], compile: false, errors: [{ message: ("Runtime error: " + e.message) }] };
+  }
+  finally {
+    try {
+      Fs.unlinkSync(tmpPath);
+    }
+    catch (ignored) {
+      null;
+    }
+  }
+}
+module.exports.runTestFile = runTestFile;
+function runTests(target, transpile) {
+  let files = [];
+  try {
+    files = discoverTestFiles(target);
+  }
+  catch (e) {
+    console.error(clr(C.red, ("✗ " + e.message)));
+    process.exit(1);
+  }
+  if ((files.length == 0)) {
+    console.log(clr(C.yellow, ("No *.test.flux files found in: " + target)));
+    return;
+  }
+  let totalPass = 0;
+  let totalFail = 0;
+  let totalFiles = 0;
+  const t0 = Date.now();
+  for (const file of files) {
+    totalFiles = (totalFiles + 1);
+    console.log(clr(C.cyan, ("\n◈ " + Path.basename(file))));
+    const result = runTestFile(file, transpile);
+    if (!result.compile) {
+      console.log(clr(C.red, "  ✗ Compile error:"));
+      for (const e of result.errors) {
+        console.log(clr(C.red, ("    " + e.message)));
+      }
+      totalFail = (totalFail + 1);
+      continue;
+    }
+    if ((result.tests.length == 0)) {
+      console.log(clr(C.yellow, "  (no test_ functions found)"));
+      continue;
+    }
+    for (const t of result.tests) {
+      if (t.ok) {
+        totalPass = (totalPass + 1);
+        console.log((clr(C.green, "  ✓") + clr(C.gray, (" " + t.name))));
+      }
+      else {
+        totalFail = (totalFail + 1);
+        console.log(clr(C.red, ("  ✗ " + t.name)));
+        console.log(clr(C.dim, ("    " + t.error)));
+      }
+    }
+  }
+  const elapsed = (Date.now() - t0);
+  const total = (totalPass + totalFail);
+  console.log();
+  console.log(clr(C.bold, "─".repeat(50)));
+  console.log(((((clr(C.bold, "Results: ") + clr(C.green, (totalPass + " passed"))) + clr(C.gray, ", ")) + ((totalFail > 0) ? clr(C.red, (totalFail + " failed")) : clr(C.gray, (totalFail + " failed")))) + clr(C.gray, ((((" (" + total) + " total) in ") + elapsed) + "ms"))));
+  console.log();
+  if ((totalFail > 0)) {
+    process.exitCode = 1;
+  }
+}
+module.exports.runTests = runTests;

package/src/self/transpiler.flux

@@ -0,0 +1,123 @@
+// ============================================================
+//  Flux Self-Hosted Transpiler — v3.0 (100% Self-Hosting)
+//  src/self/transpiler.flux — written in Flux, compiled by stage-0
+//
+//  Full pipeline:
+//    CSS-preprocess → JSX-preprocess → Lex → Parse →
+//    Immutability-check → Type-check → Codegen
+// ============================================================
+
+import { Lexer, lexerize, T }                    from './lexer'
+import { Parser, makeParser }                    from './parser'
+import { CodeGenerator, makeCodeGen }            from './codegen'
+import { transformCss }                          from './css-preprocessor'
+import { transformJsx, FLUX_H_BROWSER, FLUX_H_SERVER, FLUX_CSS_BROWSER, FLUX_CSS_SERVER } from './jsx'
+import { Checker }                               from './checker'
+import { FluxTypeChecker }                       from './type-checker'
+
+// ── Version info ─────────────────────────────────────────────
+export val FLUX_VERSION = "3.0.0"
+export val FLUX_STAGE   = "self-hosted"
+
+// ── Public API ────────────────────────────────────────────────
+export fn transpile(source, options):
+  val opts = options ?? {}
+
+  val result = {
+    success:      false,
+    output:       "",
+    ast:          null,
+    tokens:       null,
+    errors:       [],
+    typeErrors:   [],
+    typeWarnings: [],
+    stage:        "",
+  }
+
+  try:
+    var src = source
+
+    // ── Stage 0a: CSS preprocessing ────────────────────────────
+    result.stage = "css"
+    if opts.css != false:
+      src = transformCss(src)
+
+    // ── Stage 0b: JSX preprocessing ────────────────────────────
+    result.stage = "jsx"
+    if opts.jsx:
+      val jsxTarget = opts.jsxTarget ?? "browser"
+      val jsxResult = transformJsx(src, { target: jsxTarget })
+      src = jsxResult.source
+      // JSX runtime helpers will be prepended to output if JSX detected
+      if jsxResult.hasJsx:
+        opts._jsxHelpers = jsxResult.runtimeHelpers
+
+    // ── Stage 1: Lex ────────────────────────────────────────────
+    result.stage  = "lexer"
+    val lexer  = lexerize(src)
+    val tokens = lexer.tokenize()
+    result.tokens = tokens
+
+    // ── Stage 2: Parse ──────────────────────────────────────────
+    result.stage = "parser"
+    val ast  = makeParser(tokens).parse()
+    result.ast = ast
+
+    // ── Stage 3: Immutability check ─────────────────────────────
+    if opts.check != false:
+      result.stage = "checker"
+      val checker     = new Checker([], [])
+      val checkResult = checker.check(ast)
+      if checkResult.errors.length > 0:
+        result.errors = checkResult.errors
+        result.stage  = null
+        return result
+
+    // ── Stage 4: Type checking ──────────────────────────────────
+    if opts.typecheck:
+      result.stage = "type-checker"
+      val tc = new FluxTypeChecker([], [], new Map(), new Map(), new Map(), new Map())
+      val tcResult = tc.check(ast)
+      result.typeErrors   = tcResult.errors
+      result.typeWarnings = tcResult.warnings
+      // Type errors are non-fatal warnings unless strict mode
+      if opts.strict and tcResult.errors.length > 0:
+        result.errors = tcResult.errors
+        result.stage  = null
+        return result
+
+    // ── Stage 5: Code generation ────────────────────────────────
+    result.stage = "codegen"
+    val indent    = opts.mangle ? "" : "  "
+    val cg        = makeCodeGen({ indent })
+    val genResult = cg.generate(ast)
+    var code      = genResult.code
+
+    // Prepend JSX runtime helpers if needed
+    if opts._jsxHelpers:
+      code = opts._jsxHelpers + "\n" + code
+
+    result.output  = code
+    result.success = true
+    result.stage   = null
+
+  catch(e):
+    result.errors.push({
+      message: e.message,
+      name:    e.name,
+      stage:   result.stage,
+    })
+
+  return result
+
+// ── Convenience: transpile with full options ──────────────────
+export fn transpileFile(source, opts):
+  return transpile(source, {
+    check:     true,
+    typecheck: opts?.typecheck ?? false,
+    jsx:       opts?.jsx ?? false,
+    jsxTarget: opts?.jsxTarget ?? "browser",
+    mangle:    opts?.mangle ?? false,
+    strict:    opts?.strict ?? false,
+    ...(opts ?? {}),
+  })

package/src/self/transpiler.js

@@ -0,0 +1,83 @@
+// Generated by Flux Transpiler v3.1.0
+"use strict";
+
+const { Lexer, lexerize, T } = require("./lexer");
+const { Parser, makeParser } = require("./parser");
+const { CodeGenerator, makeCodeGen } = require("./codegen");
+const { transformCss } = require("./css-preprocessor");
+const { transformJsx, FLUX_H_BROWSER, FLUX_H_SERVER, FLUX_CSS_BROWSER, FLUX_CSS_SERVER } = require("./jsx");
+const { Checker } = require("./checker");
+const { FluxTypeChecker } = require("./type-checker");
+const FLUX_VERSION = "3.0.0";
+module.exports.FLUX_VERSION = FLUX_VERSION;
+const FLUX_STAGE = "self-hosted";
+module.exports.FLUX_STAGE = FLUX_STAGE;
+function transpile(source, options) {
+  const opts = (options ?? {  });
+  const result = { success: false, output: "", ast: null, tokens: null, errors: [], typeErrors: [], typeWarnings: [], stage: "" };
+  try {
+    let src = source;
+    result.stage = "css";
+    if ((opts.css != false)) {
+      src = transformCss(src);
+    }
+    result.stage = "jsx";
+    if (opts.jsx) {
+      const jsxTarget = (opts.jsxTarget ?? "browser");
+      const jsxResult = transformJsx(src, { target: jsxTarget });
+      src = jsxResult.source;
+      if (jsxResult.hasJsx) {
+        opts._jsxHelpers = jsxResult.runtimeHelpers;
+      }
+    }
+    result.stage = "lexer";
+    const lexer = lexerize(src);
+    const tokens = lexer.tokenize();
+    result.tokens = tokens;
+    result.stage = "parser";
+    const ast = makeParser(tokens).parse();
+    result.ast = ast;
+    if ((opts.check != false)) {
+      result.stage = "checker";
+      const checker = new Checker([], []);
+      const checkResult = checker.check(ast);
+      if ((checkResult.errors.length > 0)) {
+        result.errors = checkResult.errors;
+        result.stage = null;
+        return result;
+      }
+    }
+    if (opts.typecheck) {
+      result.stage = "type-checker";
+      const tc = new FluxTypeChecker([], [], new Map(), new Map(), new Map(), new Map());
+      const tcResult = tc.check(ast);
+      result.typeErrors = tcResult.errors;
+      result.typeWarnings = tcResult.warnings;
+      if ((opts.strict && (tcResult.errors.length > 0))) {
+        result.errors = tcResult.errors;
+        result.stage = null;
+        return result;
+      }
+    }
+    result.stage = "codegen";
+    const indent = (opts.mangle ? "" : "  ");
+    const cg = makeCodeGen({ indent });
+    const genResult = cg.generate(ast);
+    let code = genResult.code;
+    if (opts._jsxHelpers) {
+      code = ((opts._jsxHelpers + "\n") + code);
+    }
+    result.output = code;
+    result.success = true;
+    result.stage = null;
+  }
+  catch (e) {
+    result.errors.push({ message: e.message, name: e.name, stage: result.stage });
+  }
+  return result;
+}
+module.exports.transpile = transpile;
+function transpileFile(source, opts) {
+  return transpile(source, { check: true, typecheck: (opts?.typecheck ?? false), jsx: (opts?.jsx ?? false), jsxTarget: (opts?.jsxTarget ?? "browser"), mangle: (opts?.mangle ?? false), strict: (opts?.strict ?? false), ...(opts ?? {  }) });
+}
+module.exports.transpileFile = transpileFile;