@xnoxs/flux-lang 3.2.2 → 3.3.0

package/index.js

@@ -13,6 +13,7 @@ const { buildStdlib, detectUsedSymbols, STDLIB_SYMBOLS } = require('./src/stdlib
 const { Lexer }                            = require('./src/lexer');
 const { Parser }                           = require('./src/parser');
 const { bundle }                           = require('./src/bundler');
+const { loadConfig, mergeConfig, defineConfig } = require('./src/config');
 
 module.exports = {
   transpile,
@@ -23,4 +24,7 @@ module.exports = {
   Lexer,
   Parser,
   bundle,
+  loadConfig,
+  mergeConfig,
+  defineConfig,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnoxs/flux-lang",
-  "version": "3.2.2",
+  "version": "3.3.0",
   "description": "Flux — 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",
@@ -9,33 +9,35 @@
     "flux": "./bin/flux.js"
   },
   "scripts": {
-    "build":           "node scripts/build.js",
-    "prepublishOnly":  "npm test && npm run build",
-    "test":            "node src/cli.js test tests/",
-    "test:file":       "node src/cli.js test",
-    "check":           "node src/cli.js check tests/01_basics.test.flux",
-    "bench":           "node benchmarks/bench.js",
-    "start":           "node src/cli.js run app/server.flux",
-    "repl":            "node src/cli.js repl",
-    "version":         "node src/cli.js version"
+    "build": "node scripts/build.js",
+    "prepublishOnly": "npm test && npm run build",
+    "test": "node src/cli.js test tests/",
+    "test:file": "node src/cli.js test",
+    "check": "node src/cli.js check tests/01_basics.test.flux",
+    "bench": "node benchmarks/bench.js",
+    "start": "node src/cli.js run app/server.flux",
+    "repl": "node src/cli.js repl",
+    "version": "node src/cli.js version"
   },
   "exports": {
     ".": {
-      "import":  "./dist/flux.esm.js",
+      "import": "./dist/flux.esm.js",
       "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",
-    "./stdlib":   "./src/stdlib.js",
-    "./formatter":"./src/formatter.js"
+    "./stdlib": "./src/stdlib.js",
+    "./formatter": "./src/formatter.js"
   },
   "files": [
     "bin/",
     "dist/",
     "src/stdlib.js",
     "src/formatter.js",
+    "src/config.js",
     "src/self/",
     "scripts/build.js",
     "index.js",

package/src/config.js

@@ -0,0 +1,99 @@
+'use strict';
+
+/**
+ * Flux Lang — Project Config Loader
+ *
+ * Looks for flux.config.js (or .fluxrc.js) in the current working directory.
+ * Returns a plain object with config values; returns {} if no config found.
+ *
+ * Config schema:
+ *   module.exports = {
+ *     jsxTarget : 'browser' | 'server' | 'react',  // default: 'browser'
+ *     outDir    : './dist',      // output dir for compiled files
+ *     sourcemap : false,         // generate .js.map files
+ *     mangle    : true,          // obfuscate variable/function names
+ *     ignore    : [],            // glob patterns to skip in `flux test`
+ *     entry     : 'src/main.flux', // default bundle entry
+ *   }
+ *
+ * CLI flags always take precedence over config values.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const CONFIG_NAMES = [
+  'flux.config.js',
+  'flux.config.cjs',
+  '.fluxrc.js',
+];
+
+/**
+ * Load project config from CWD (or a given directory).
+ * @param {string} [cwd] - directory to search (default: process.cwd())
+ * @returns {object} raw config object (or {} if none found)
+ */
+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;
+
+    // Bust require cache so tests can reload different configs
+    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 — ignoring\n`
+        );
+        return {};
+      }
+
+      return cfg;
+    } catch (e) {
+      process.stderr.write(
+        `[flux] error loading ${name}: ${e.message}\n`
+      );
+      return {};
+    }
+  }
+
+  return {};
+}
+
+/**
+ * Merge file config with CLI opts (CLI flags win).
+ * @param {object} fileConfig  - from loadConfig()
+ * @param {object} cliOpts     - parsed CLI flags
+ * @returns {object} merged options safe to pass to transpile()
+ */
+function mergeConfig(fileConfig, cliOpts) {
+  const cfg = fileConfig || {};
+  const cli = cliOpts   || {};
+
+  return {
+    jsxTarget : cli.jsxTarget  !== undefined ? cli.jsxTarget  : (cfg.jsxTarget  || 'browser'),
+    outDir    : cli.outDir     !== undefined ? cli.outDir     : (cfg.outDir     || null),
+    sourcemap : cli.sourcemap  !== undefined ? cli.sourcemap  : (cfg.sourcemap  || false),
+    mangle    : cli.mangle     !== undefined ? cli.mangle     : (cfg.mangle     !== undefined ? cfg.mangle : true),
+    ignore    : cli.ignore     !== undefined ? cli.ignore     : (cfg.ignore     || []),
+    entry     : cli.entry      !== undefined ? cli.entry      : (cfg.entry      || null),
+  };
+}
+
+/**
+ * Identity helper for IDE type-checking / autocompletion.
+ * Usage in flux.config.js:  const { defineConfig } = require('@xnoxs/flux-lang/config');
+ * @param {object} config
+ * @returns {object}
+ */
+function defineConfig(config) {
+  return config;
+}
+
+module.exports = { loadConfig, mergeConfig, defineConfig };