@xnoxs/flux-lang 3.2.2 → 3.3.0

package/dist/flux-cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /*!
- * flux-lang v3.2.2
+ * flux-lang v3.3.0
  * Flux — A modern language that transpiles to JavaScript. Python-clean syntax, TypeScript-level safety, Rust-inspired pattern matching.
  * (c) 2026 Flux Lang Contributors
  * Released under the MIT License
@@ -15,6 +15,63 @@ var __commonJS = (cb, mod) => function __require() {
   }
 };
 
+// src/config.js
+var require_config = __commonJS({
+  "src/config.js"(exports2, module2) {
+    "use strict";
+    var fs2 = require("fs");
+    var path2 = require("path");
+    var CONFIG_NAMES = [
+      "flux.config.js",
+      "flux.config.cjs",
+      ".fluxrc.js"
+    ];
+    function loadConfig2(cwd) {
+      const dir = cwd || process.cwd();
+      for (const name of CONFIG_NAMES) {
+        const configPath = path2.join(dir, name);
+        if (!fs2.existsSync(configPath)) continue;
+        delete require.cache[require.resolve(configPath)];
+        try {
+          const raw = require(configPath);
+          const cfg = raw && raw.default ? raw.default : raw;
+          if (typeof cfg !== "object" || cfg === null) {
+            process.stderr.write(
+              `[flux] warning: ${name} must export a plain object \u2014 ignoring
+`
+            );
+            return {};
+          }
+          return cfg;
+        } catch (e) {
+          process.stderr.write(
+            `[flux] error loading ${name}: ${e.message}
+`
+          );
+          return {};
+        }
+      }
+      return {};
+    }
+    function mergeConfig2(fileConfig, cliOpts) {
+      const cfg = fileConfig || {};
+      const cli = cliOpts || {};
+      return {
+        jsxTarget: cli.jsxTarget !== void 0 ? cli.jsxTarget : cfg.jsxTarget || "browser",
+        outDir: cli.outDir !== void 0 ? cli.outDir : cfg.outDir || null,
+        sourcemap: cli.sourcemap !== void 0 ? cli.sourcemap : cfg.sourcemap || false,
+        mangle: cli.mangle !== void 0 ? cli.mangle : cfg.mangle !== void 0 ? cfg.mangle : true,
+        ignore: cli.ignore !== void 0 ? cli.ignore : cfg.ignore || [],
+        entry: cli.entry !== void 0 ? cli.entry : cfg.entry || null
+      };
+    }
+    function defineConfig(config) {
+      return config;
+    }
+    module2.exports = { loadConfig: loadConfig2, mergeConfig: mergeConfig2, defineConfig };
+  }
+});
+
 // src/lexer.js
 var require_lexer = __commonJS({
   "src/lexer.js"(exports2, module2) {
@@ -7106,7 +7163,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@xnoxs/flux-lang",
-      version: "3.2.2",
+      version: "3.3.0",
       description: "Flux \u2014 A modern language that transpiles to JavaScript. Python-clean syntax, TypeScript-level safety, Rust-inspired pattern matching.",
       main: "dist/flux.cjs.js",
       module: "dist/flux.esm.js",
@@ -7131,6 +7188,7 @@ var require_package = __commonJS({
           require: "./dist/flux.cjs.js",
           default: "./dist/flux.cjs.js"
         },
+        "./config": "./src/config.js",
         "./dist/cjs": "./dist/flux.cjs.js",
         "./dist/esm": "./dist/flux.esm.js",
         "./dist/min": "./dist/flux.min.js",
@@ -7142,6 +7200,7 @@ var require_package = __commonJS({
         "dist/",
         "src/stdlib.js",
         "src/formatter.js",
+        "src/config.js",
         "src/self/",
         "scripts/build.js",
         "index.js",
@@ -8117,6 +8176,9 @@ var require_test_runner = __commonJS({
     var fs2 = require("fs");
     var path2 = require("path");
     var os = require("os");
+    var CONFIG_PATH = JSON.stringify(path2.join(__dirname, "config.js"));
+    var TRANSPILER_PATH = JSON.stringify(path2.join(__dirname, "transpiler.js"));
+    var TEST_RUNNER_PATH = JSON.stringify(__filename);
     var C2 = {
       reset: "\x1B[0m",
       bold: "\x1B[1m",
@@ -8228,8 +8290,19 @@ function __runAll(mod) {
       while ((match = fnRe.exec(result.output)) !== null) {
         fnNames.push(match[1]);
       }
+      const shimPreamble = [
+        `// \u2500\u2500 shim globals for flux.config.js tests \u2500\u2500`,
+        `const __configMod    = require(${CONFIG_PATH});`,
+        `const __transpilerMod= require(${TRANSPILER_PATH});`,
+        `const __runnerMod    = require(${TEST_RUNNER_PATH});`,
+        `const mergeConfigShim  = __configMod.mergeConfig;`,
+        `const defineConfigShim = __configMod.defineConfig;`,
+        `const transpileShim    = __transpilerMod.transpile;`,
+        `const matchIgnoreShim  = __runnerMod.matchIgnore;`
+      ].join("\n");
       const runner = [
         TEST_HELPERS,
+        shimPreamble,
         result.output,
         "",
         "// \u2500\u2500 auto-generated test runner \u2500\u2500",
@@ -8261,7 +8334,21 @@ function __runAll(mod) {
         }
       }
     }
-    function runTests(target, transpile2) {
+    function matchIgnore(filePath, patterns) {
+      if (!patterns || patterns.length === 0) return false;
+      const normalize = (p) => p.replace(/\\/g, "/");
+      const fp = normalize(filePath);
+      for (const pattern of patterns) {
+        let re = normalize(pattern).replace(/\*\*/g, "\0DSTAR\0");
+        re = re.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+        re = re.replace(/\*/g, "[^/]*");
+        re = re.replace(/\x00DSTAR\x00\//g, "(.+/)?").replace(/\x00DSTAR\x00/g, ".*");
+        if (new RegExp(`(^|/)${re}$`).test(fp)) return true;
+      }
+      return false;
+    }
+    function runTests(target, transpile2, opts) {
+      const ignorePatterns = opts && opts.ignore || [];
       let files;
       try {
         files = discoverTestFiles(target);
@@ -8269,6 +8356,13 @@ function __runAll(mod) {
         console.error(clr2(C2.red, `\u2717 ${e.message}`));
         process.exit(1);
       }
+      if (ignorePatterns.length > 0) {
+        const before = files.length;
+        files = files.filter((f) => !matchIgnore(f, ignorePatterns));
+        const skipped = before - files.length;
+        if (skipped > 0)
+          console.log(clr2(C2.gray, `  (skipped ${skipped} file${skipped === 1 ? "" : "s"} via ignore patterns)`));
+      }
       if (files.length === 0) {
         console.log(clr2(C2.yellow, `No *.test.flux files found in: ${target}`));
         return;
@@ -8315,13 +8409,14 @@ function __runAll(mod) {
       console.log();
       if (totalFail > 0) process.exitCode = 1;
     }
-    module2.exports = { runTests, runTestFile, discoverTestFiles };
+    module2.exports = { runTests, runTestFile, discoverTestFiles, matchIgnore };
   }
 });
 
 // src/cli.js
 var fs = require("fs");
 var path = require("path");
+var { loadConfig, mergeConfig } = require_config();
 var USE_SELF_HOSTED = process.argv.includes("--self-hosted") || process.env.FLUX_SELF_HOSTED === "1";
 process.argv = process.argv.filter((a) => a !== "--self-hosted");
 function loadTranspiler() {
@@ -8583,6 +8678,18 @@ function cmdInit(name) {
     dependencies: {},
     devDependencies: { "flux-lang": `^${VERSION}` }
   }, null, 2), "utf8");
+  fs.writeFileSync(path.join(dir, "flux.config.js"), [
+    "// Flux Lang project configuration",
+    "// All options are optional \u2014 CLI flags always override these values.",
+    "module.exports = {",
+    "  // jsxTarget : 'browser',   // 'browser' | 'server' | 'react'",
+    "  // outDir    : './dist',     // output directory for compiled files",
+    "  // sourcemap : false,        // generate .js.map files",
+    "  // mangle    : true,         // obfuscate names in output",
+    "  // ignore    : [],           // glob patterns to skip in `flux test`",
+    "  // entry     : 'src/main.flux', // default entry for `flux bundle`",
+    "};"
+  ].join("\n"), "utf8");
   fs.writeFileSync(path.join(dir, ".gitignore"), [
     "node_modules/",
     "dist/",
@@ -8616,6 +8723,7 @@ function cmdInit(name) {
   console.log();
   console.log(clr(C.gray, "  Files created:"));
   console.log("  " + clr(C.cyan, `${projectName}/src/main.flux`));
+  console.log("  " + clr(C.cyan, `${projectName}/flux.config.js`));
   console.log("  " + clr(C.cyan, `${projectName}/package.json`));
   console.log("  " + clr(C.cyan, `${projectName}/.gitignore`));
   console.log("  " + clr(C.cyan, `${projectName}/README.md`));
@@ -8628,12 +8736,22 @@ function cmdInit(name) {
 }
 function cmdCompile(filePath, opts) {
   const { source, abs } = readFluxFile(filePath);
-  const outPath = deriveOutPath(filePath, opts.out);
+  let outPath;
+  if (opts.out) {
+    outPath = path.resolve(opts.out);
+  } else if (opts.outDir) {
+    const dir = path.resolve(opts.outDir);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    outPath = path.join(dir, path.basename(filePath, ".flux") + ".js");
+  } else {
+    outPath = deriveOutPath(filePath, null);
+  }
   const mapPath = outPath + ".map";
   const t0 = Date.now();
   const result = transpile(source, {
     sourcemap: opts.sourcemap,
     mangle: opts.mangle,
+    jsxTarget: opts.jsxTarget,
     sourceFile: path.relative(path.dirname(outPath), abs),
     outputFile: path.basename(outPath)
   });
@@ -8685,9 +8803,12 @@ function cmdBundle(entryPath, opts) {
     clr(C.green, `\u2713 Bundle done`) + clr(C.gray, ` (${elapsed}ms)`) + ` ${path.basename(abs)} + ${result.modules - 1} module(s) \u2192 ` + clr(C.cyan, path.relative(process.cwd(), outFile)) + clr(C.gray, ` [${kb} KB]`)
   );
 }
-function cmdRun(filePath) {
+function cmdRun(filePath, opts) {
   const { source, abs } = readFluxFile(filePath);
-  const result = transpile(source);
+  const result = transpile(source, {
+    jsxTarget: opts && opts.jsxTarget,
+    mangle: opts && opts.mangle
+  });
   if (!result.success) {
     console.error(clr(C.red, `
 \u2717 Compile error`));
@@ -8885,10 +9006,10 @@ function cmdFmt(filePath, opts) {
   const diff = Math.abs(output.split("\n").length - source.split("\n").length);
   console.log(clr(C.green, `\u2713 ${path.basename(abs)} \u2014 formatted`) + (diff > 0 ? clr(C.gray, `  (${diff} line${diff === 1 ? "" : "s"} changed)`) : ""));
 }
-function cmdTest(dirOrFile) {
+function cmdTest(dirOrFile, opts) {
   const { runTests } = require_test_runner();
   const target = dirOrFile || "tests";
-  runTests(target, transpile);
+  runTests(target, transpile, { ignore: opts && opts.ignore || [] });
 }
 function cmdTokens(filePath) {
   const { source } = readFluxFile(filePath);
@@ -8925,13 +9046,26 @@ function cmdWatch(filePath, opts) {
   function doCompile() {
     try {
       const source = fs.readFileSync(abs, "utf8");
-      const result = transpile(source);
+      const result = transpile(source, {
+        jsxTarget: opts.jsxTarget,
+        sourcemap: opts.sourcemap,
+        mangle: opts.mangle
+      });
       const ts = (/* @__PURE__ */ new Date()).toLocaleTimeString();
       if (!result.success) {
         console.error(clr(C.red, `[${ts}] \u2717 Error`));
         printErrors(result.errors, source, abs);
       } else {
-        const outPath = deriveOutPath(filePath, opts.out);
+        let outPath;
+        if (opts.out) {
+          outPath = path.resolve(opts.out);
+        } else if (opts.outDir) {
+          const dir = path.resolve(opts.outDir);
+          if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+          outPath = path.join(dir, path.basename(filePath, ".flux") + ".js");
+        } else {
+          outPath = deriveOutPath(filePath, null);
+        }
         fs.writeFileSync(outPath, result.output, "utf8");
         console.log(clr(C.gray, `[${ts}]`) + clr(C.green, ` \u2713 Compiled \u2192 ${path.relative(process.cwd(), outPath)}`));
       }
@@ -9422,7 +9556,7 @@ function parseArgs(argv) {
   const args = argv.slice(2);
   const cmd = args[0];
   const file = args[1] && !args[1].startsWith("-") ? args[1] : null;
-  const opts = { stdout: false, out: null, sourcemap: false, mangle: true };
+  const opts = { stdout: false, out: null, sourcemap: void 0, mangle: void 0, jsxTarget: void 0 };
   const publishOpts = {
     bump: "patch",
     ver: null,
@@ -9439,6 +9573,8 @@ function parseArgs(argv) {
     if (args[i] === "--no-mangle" || args[i] === "-nm") opts.mangle = false;
     if ((args[i] === "-o" || args[i] === "--out") && args[i + 1]) opts.out = args[++i];
     if (args[i] === "--no-color") process.env.NO_COLOR = "1";
+    if ((args[i] === "--jsx-target" || args[i] === "--jsxTarget") && args[i + 1])
+      opts.jsxTarget = args[++i];
     if (args[i] === "--patch") publishOpts.bump = "patch";
     if (args[i] === "--minor") publishOpts.bump = "minor";
     if (args[i] === "--major") publishOpts.bump = "major";
@@ -9454,6 +9590,9 @@ function parseArgs(argv) {
 }
 function main() {
   const { cmd, file, opts, publishOpts } = parseArgs(process.argv);
+  const fileConfig = loadConfig();
+  const merged = mergeConfig(fileConfig, opts);
+  const finalOpts = { stdout: opts.stdout, out: opts.out, ...merged };
   switch (cmd) {
     case "init": {
       const name = process.argv[3] && !process.argv[3].startsWith("-") ? process.argv[3] : null;
@@ -9465,15 +9604,16 @@ function main() {
         console.error(clr(C.red, "Specify a file: flux compile <file.flux>"));
         process.exit(1);
       }
-      cmdCompile(file, opts);
+      cmdCompile(file, finalOpts);
       break;
     }
     case "bundle": {
-      if (!file) {
+      const entryFile = file || finalOpts.entry;
+      if (!entryFile) {
         console.error(clr(C.red, "Specify a file: flux bundle <entry.flux>"));
         process.exit(1);
       }
-      cmdBundle(file, opts);
+      cmdBundle(entryFile, finalOpts);
       break;
     }
     case "run": {
@@ -9481,7 +9621,7 @@ function main() {
         console.error(clr(C.red, "Specify a file: flux run <file.flux>"));
         process.exit(1);
       }
-      cmdRun(file);
+      cmdRun(file, finalOpts);
       break;
     }
     case "check": {
@@ -9521,7 +9661,7 @@ function main() {
         console.error(clr(C.red, "Specify a file: flux watch <file.flux>"));
         process.exit(1);
       }
-      cmdWatch(file, opts);
+      cmdWatch(file, finalOpts);
       break;
     }
     case "fmt": {
@@ -9533,7 +9673,7 @@ function main() {
       break;
     }
     case "test": {
-      cmdTest(file || process.argv[3]);
+      cmdTest(file || process.argv[3], finalOpts);
       break;
     }
     case "publish": {

package/dist/flux.cjs.js

@@ -1,5 +1,5 @@
 /*!
- * flux-lang v3.2.2
+ * flux-lang v3.3.0
  * Flux — A modern language that transpiles to JavaScript. Python-clean syntax, TypeScript-level safety, Rust-inspired pattern matching.
  * (c) 2026 Flux Lang Contributors
  * Released under the MIT License
@@ -7192,6 +7192,63 @@ var require_bundler = __commonJS({
   }
 });
 
+// src/config.js
+var require_config = __commonJS({
+  "src/config.js"(exports2, module2) {
+    "use strict";
+    var fs = require("fs");
+    var path = require("path");
+    var CONFIG_NAMES = [
+      "flux.config.js",
+      "flux.config.cjs",
+      ".fluxrc.js"
+    ];
+    function loadConfig2(cwd) {
+      const dir = cwd || process.cwd();
+      for (const name of CONFIG_NAMES) {
+        const configPath = path.join(dir, name);
+        if (!fs.existsSync(configPath)) continue;
+        delete require.cache[require.resolve(configPath)];
+        try {
+          const raw = require(configPath);
+          const cfg = raw && raw.default ? raw.default : raw;
+          if (typeof cfg !== "object" || cfg === null) {
+            process.stderr.write(
+              `[flux] warning: ${name} must export a plain object \u2014 ignoring
+`
+            );
+            return {};
+          }
+          return cfg;
+        } catch (e) {
+          process.stderr.write(
+            `[flux] error loading ${name}: ${e.message}
+`
+          );
+          return {};
+        }
+      }
+      return {};
+    }
+    function mergeConfig2(fileConfig, cliOpts) {
+      const cfg = fileConfig || {};
+      const cli = cliOpts || {};
+      return {
+        jsxTarget: cli.jsxTarget !== void 0 ? cli.jsxTarget : cfg.jsxTarget || "browser",
+        outDir: cli.outDir !== void 0 ? cli.outDir : cfg.outDir || null,
+        sourcemap: cli.sourcemap !== void 0 ? cli.sourcemap : cfg.sourcemap || false,
+        mangle: cli.mangle !== void 0 ? cli.mangle : cfg.mangle !== void 0 ? cfg.mangle : true,
+        ignore: cli.ignore !== void 0 ? cli.ignore : cfg.ignore || [],
+        entry: cli.entry !== void 0 ? cli.entry : cfg.entry || null
+      };
+    }
+    function defineConfig2(config) {
+      return config;
+    }
+    module2.exports = { loadConfig: loadConfig2, mergeConfig: mergeConfig2, defineConfig: defineConfig2 };
+  }
+});
+
 // index.js
 var { transpile } = require_transpiler();
 var { format } = require_formatter();
@@ -7199,6 +7256,7 @@ var { buildStdlib, detectUsedSymbols, STDLIB_SYMBOLS } = require_stdlib();
 var { Lexer } = require_lexer();
 var { Parser } = require_parser();
 var { bundle } = require_bundler();
+var { loadConfig, mergeConfig, defineConfig } = require_config();
 module.exports = {
   transpile,
   format,
@@ -7207,5 +7265,8 @@ module.exports = {
   STDLIB_SYMBOLS,
   Lexer,
   Parser,
-  bundle
+  bundle,
+  loadConfig,
+  mergeConfig,
+  defineConfig
 };

package/dist/flux.esm.js

@@ -1,5 +1,5 @@
 /*!
- * flux-lang v3.2.2
+ * flux-lang v3.3.0
  * Flux — A modern language that transpiles to JavaScript. Python-clean syntax, TypeScript-level safety, Rust-inspired pattern matching.
  * (c) 2026 Flux Lang Contributors
  * Released under the MIT License
@@ -7197,6 +7197,63 @@ var require_bundler = __commonJS({
   }
 });
 
+// src/config.js
+var require_config = __commonJS({
+  "src/config.js"(exports, module) {
+    "use strict";
+    var fs = __require("fs");
+    var path = __require("path");
+    var CONFIG_NAMES = [
+      "flux.config.js",
+      "flux.config.cjs",
+      ".fluxrc.js"
+    ];
+    function loadConfig(cwd) {
+      const dir = cwd || process.cwd();
+      for (const name of CONFIG_NAMES) {
+        const configPath = path.join(dir, name);
+        if (!fs.existsSync(configPath)) continue;
+        delete __require.cache[__require.resolve(configPath)];
+        try {
+          const raw = __require(configPath);
+          const cfg = raw && raw.default ? raw.default : raw;
+          if (typeof cfg !== "object" || cfg === null) {
+            process.stderr.write(
+              `[flux] warning: ${name} must export a plain object \u2014 ignoring
+`
+            );
+            return {};
+          }
+          return cfg;
+        } catch (e) {
+          process.stderr.write(
+            `[flux] error loading ${name}: ${e.message}
+`
+          );
+          return {};
+        }
+      }
+      return {};
+    }
+    function mergeConfig(fileConfig, cliOpts) {
+      const cfg = fileConfig || {};
+      const cli = cliOpts || {};
+      return {
+        jsxTarget: cli.jsxTarget !== void 0 ? cli.jsxTarget : cfg.jsxTarget || "browser",
+        outDir: cli.outDir !== void 0 ? cli.outDir : cfg.outDir || null,
+        sourcemap: cli.sourcemap !== void 0 ? cli.sourcemap : cfg.sourcemap || false,
+        mangle: cli.mangle !== void 0 ? cli.mangle : cfg.mangle !== void 0 ? cfg.mangle : true,
+        ignore: cli.ignore !== void 0 ? cli.ignore : cfg.ignore || [],
+        entry: cli.entry !== void 0 ? cli.entry : cfg.entry || null
+      };
+    }
+    function defineConfig(config) {
+      return config;
+    }
+    module.exports = { loadConfig, mergeConfig, defineConfig };
+  }
+});
+
 // index.js
 var require_index = __commonJS({
   "index.js"(exports, module) {
@@ -7206,6 +7263,7 @@ var require_index = __commonJS({
     var { Lexer } = require_lexer();
     var { Parser } = require_parser();
     var { bundle } = require_bundler();
+    var { loadConfig, mergeConfig, defineConfig } = require_config();
     module.exports = {
       transpile,
       format,
@@ -7214,7 +7272,10 @@ var require_index = __commonJS({
       STDLIB_SYMBOLS,
       Lexer,
       Parser,
-      bundle
+      bundle,
+      loadConfig,
+      mergeConfig,
+      defineConfig
     };
   }
 });