@xnoxs/flux-lang 3.4.0 → 3.4.1

package/dist/flux-cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /*!
- * flux-lang v3.4.0
+ * flux-lang v3.4.1
  * 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
@@ -7203,7 +7203,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@xnoxs/flux-lang",
-      version: "3.4.0",
+      version: "3.4.1",
       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",
@@ -8643,136 +8643,258 @@ function cmdInit(name) {
   const projectName = name || "my-flux-app";
   const dir = path.resolve(projectName);
   if (fs.existsSync(dir)) {
-    console.error(clr(C.red, `[Error] Directory already exists: ${projectName}`));
+    console.error(clr(C.red, `\u2717 Directory already exists: ${projectName}`));
     process.exit(1);
   }
   fs.mkdirSync(dir, { recursive: true });
   fs.mkdirSync(path.join(dir, "src"), { recursive: true });
-  fs.writeFileSync(path.join(dir, "src", "main.flux"), [
-    "// Welcome to Flux Lang v2.0!",
-    "",
-    "// --- Basic ---",
-    'val greeting = "Hello, Flux!"',
-    "print(greeting)",
-    "",
-    "// --- Async / Await ---",
-    "async fn fetchData(url):",
-    "    try:",
-    "        val res  = await fetch(url)",
-    "        val data = await res.json()",
-    "        return data",
-    "    catch(e):",
-    '        print("Fetch error:", e.message)',
-    "        return null",
-    "",
-    "// --- Destructuring ---",
-    'val person = { name: "Budi", age: 25, city: "Jakarta" }',
-    "val { name, age } = person",
-    'print("Name: {name}, Age: {age}")',
-    "",
-    "// --- Optional chaining & nullish coalescing ---",
-    "val user = null",
-    'val displayName = user?.name ?? "Anonymous"',
-    'print("User:", displayName)',
-    "",
-    "// --- Spread ---",
-    "val nums = [1, 2, 3]",
-    "val more = [...nums, 4, 5, 6]",
-    'print("Numbers:", more)',
-    "",
-    "// --- Rest params ---",
-    "fn sum(...args):",
-    "    return args.reduce((acc, x) -> acc + x, 0)",
-    "",
-    'print("Sum:", sum(1, 2, 3, 4, 5))',
-    "",
-    "// --- Default params ---",
-    'fn greet(name = "World") -> "Hello, {name}!"',
-    "print(greet())",
-    'print(greet("Flux"))',
-    "",
-    "// --- Error handling ---",
-    "fn divide(a, b):",
-    "    if b == 0:",
-    '        throw new Error("Division by zero")',
-    "    return a / b",
-    "",
-    "try:",
-    "    print(divide(10, 2))",
-    "    print(divide(10, 0))",
-    "catch(e):",
-    '    print("Error:", e.message)',
-    "finally:",
-    '    print("Done.")',
-    ""
-  ].join("\n"), "utf8");
-  fs.writeFileSync(path.join(dir, "package.json"), JSON.stringify({
+  fs.mkdirSync(path.join(dir, "tests"), { recursive: true });
+  fs.writeFileSync(path.join(dir, "src", "main.flux"), `// ${projectName} \u2014 built with Flux Lang v${VERSION}
+// Run: flux run src/main.flux
+
+// \u2500\u2500 Algebraic Data Types + Pattern Matching \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+type Shape = Circle(radius) | Rect(width, height) | Triangle(base, height)
+
+fn area(shape):
+  match shape:
+    when Circle(r):      return Math.PI * r * r
+    when Rect(w, h):     return w * h
+    when Triangle(b, h): return 0.5 * b * h
+
+fn describe(shape):
+  match shape:
+    when Circle(r):      return "Circle(r={r:.2f})"
+    when Rect(w, h):     return "Rect({w:.1f}x{h:.1f})"
+    when Triangle(b, h): return "Triangle(b={b:.1f}, h={h:.1f})"
+
+// \u2500\u2500 Result type \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+type Result = Ok(value) | Err(message)
+
+fn safeDivide(a, b):
+  if b == 0: return Err("division by zero")
+  return Ok(a / b)
+
+// \u2500\u2500 Utility functions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+fn greet(name): return "Hello from Flux, {name}!"
+
+fn formatList(items):
+  if items.length == 0: return "(empty)"
+  return "[" + items.join(", ") + "]"
+
+fn clamp(value, lo, hi):
+  if value < lo: return lo
+  if value > hi: return hi
+  return value
+
+// \u2500\u2500 Pipe operator + stdlib \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+val numbers = [3, 1, 4, 1, 5, 9, 2, 6, 5, 3, 5]
+val processed = numbers
+  |> filter(n -> n > 3)
+  |> map(n -> n * n)
+  |> sort
+
+// \u2500\u2500 Main \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+print(greet("${projectName}"))
+print("Squares > 3: {formatList(processed)}")
+print("clamp(12, 0, 10) = {clamp(12, 0, 10)}")
+
+val shapes = [Circle(5.0), Rect(8.0, 3.0), Triangle(6.0, 4.0)]
+for shape in shapes:
+  val a = area(shape)
+  print("{describe(shape)}  area={a:.2f}")
+
+match safeDivide(10.0, 3.0):
+  when Ok(v):  print("10 / 3 = {v:.4f}")
+  when Err(e): print("Error: {e}")
+`, "utf8");
+  fs.writeFileSync(path.join(dir, "src", "utils.flux"), `// Utility functions for ${projectName}
+// Use with: flux bundle src/main.flux (bundles imports automatically)
+
+export fn greet(name):
+  return "\u26A1 Hello from Flux, {name}!"
+
+export fn formatList(items):
+  if items.length == 0: return "(empty)"
+  return "[" + items.join(", ") + "]"
+
+export fn clamp(value, lo, hi):
+  if value < lo: return lo
+  if value > hi: return hi
+  return value
+
+export fn sum(nums):
+  return nums.reduce((acc, x) -> acc + x, 0)
+
+export fn average(nums):
+  if nums.length == 0: return 0
+  return sum(nums) / nums.length
+`, "utf8");
+  fs.writeFileSync(path.join(dir, "tests", "main.test.flux"), `// Tests for ${projectName}
+// Run: flux test tests/
+
+// \u2500\u2500 Functions under test \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+fn add(a, b):
+    return a + b
+
+fn mul(a, b):
+    return a * b
+
+fn clamp(value, lo, hi):
+    if value < lo: return lo
+    if value > hi: return hi
+    return value
+
+fn average(nums):
+    if nums.length == 0: return 0
+    return nums.reduce((s, x) -> s + x, 0) / nums.length
+
+type Result = Ok(value) | Err(message)
+
+fn safeDivide(a, b):
+    if b == 0: return Err("div by zero")
+    return Ok(a / b)
+
+// \u2500\u2500 Test functions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+fn test_add():
+    assert(add(1, 2) == 3, "1+2=3")
+    assert(add(0, 0) == 0, "0+0=0")
+    assert(add(-1, 1) == 0, "-1+1=0")
+
+fn test_mul():
+    assert(mul(3, 4) == 12, "3*4=12")
+    assert(mul(0, 5) == 0, "0*5=0")
+
+fn test_clamp():
+    assert(clamp(5, 0, 10) == 5, "within range")
+    assert(clamp(-1, 0, 10) == 0, "below min")
+    assert(clamp(15, 0, 10) == 10, "above max")
+
+fn test_average():
+    assert(average([2, 4, 6]) == 4, "average of 2,4,6")
+    assert(average([]) == 0, "empty list")
+
+fn test_safe_divide():
+    val ok = safeDivide(10, 2)
+    match ok:
+        when Ok(v):  assert(v == 5, "10/2=5")
+        when Err(e): assert(false, "unexpected error")
+    val err = safeDivide(10, 0)
+    match err:
+        when Ok(v):  assert(false, "expected error")
+        when Err(e): assert(e == "div by zero", "error message")
+
+fn test_pipe_operator():
+    val result = [1, 2, 3, 4, 5] |> filter(n -> n > 2) |> map(n -> n * 2)
+    assert(result.length == 3, "filter length")
+    assert(result[0] == 6, "first element")
+    assert(result[2] == 10, "last element")
+`, "utf8");
+  const fluxJson = {
     name: projectName,
     version: "1.0.0",
-    description: `A Flux Lang project`,
+    description: `A Flux Lang v${VERSION} project`,
+    author: "",
+    license: "MIT",
+    entry: "src/main.flux",
+    outDir: "dist",
+    sourcemap: false,
+    typecheck: true,
     scripts: {
-      start: `flux run src/main.flux`,
-      build: `flux bundle src/main.flux -o dist/bundle.js`,
-      dev: `flux watch src/main.flux`,
-      check: `flux check src/main.flux`
+      start: "flux run src/main.flux",
+      build: "flux bundle src/main.flux -o dist/bundle.js",
+      dev: "flux watch src/main.flux",
+      check: "flux check src/main.flux",
+      test: "flux test tests/",
+      fmt: "flux fmt src/",
+      lint: "flux lint src/"
     },
     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");
+    devDependencies: { "@xnoxs/flux-lang": `^${VERSION}` }
+  };
+  fs.writeFileSync(path.join(dir, "flux.json"), JSON.stringify(fluxJson, null, 2) + "\n", "utf8");
   fs.writeFileSync(path.join(dir, ".gitignore"), [
     "node_modules/",
     "dist/",
+    "flux_modules/",
     "*.js.map",
-    ".DS_Store"
-  ].join("\n"), "utf8");
-  fs.writeFileSync(path.join(dir, "README.md"), [
-    `# ${projectName}`,
-    "",
-    "A project built with [Flux Lang](https://github.com/flux-lang/flux-lang) v2.",
-    "",
-    "## Getting Started",
-    "",
-    "```bash",
-    "npm install",
-    "flux run src/main.flux",
-    "```",
-    "",
-    "## Commands",
-    "",
-    "| Command | Description |",
-    "|---|---|",
-    "| `npm start` | Run main.flux |",
-    "| `npm run build` | Bundle to dist/ |",
-    "| `npm run dev` | Watch mode |",
-    "| `npm run check` | Check syntax |",
+    ".DS_Store",
     ""
   ].join("\n"), "utf8");
+  fs.writeFileSync(path.join(dir, "README.md"), `# ${projectName}
+
+A project built with [Flux Lang](https://flux-lang.dev) v${VERSION} \u2014 the self-hosted compiler written in Flux itself.
+
+## Quick Start
+
+\`\`\`bash
+flux run src/main.flux
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${projectName}/
+\u251C\u2500\u2500 src/
+\u2502   \u251C\u2500\u2500 main.flux        # Entry point
+\u2502   \u2514\u2500\u2500 utils.flux       # Utility functions
+\u251C\u2500\u2500 tests/
+\u2502   \u2514\u2500\u2500 main.test.flux   # Test suite
+\u251C\u2500\u2500 flux.json            # Project config
+\u2514\u2500\u2500 README.md
+\`\`\`
+
+## Commands
+
+| Command | Description |
+|---|---|
+| \`flux run src/main.flux\` | Run the project |
+| \`flux bundle src/main.flux -o dist/bundle.js\` | Bundle to single file |
+| \`flux watch src/main.flux\` | Watch mode \u2014 auto-recompile |
+| \`flux check src/main.flux\` | Type check + static analysis |
+| \`flux test tests/\` | Run all tests |
+| \`flux fmt src/\` | Format source code |
+| \`flux lint src/\` | Lint for issues |
+| \`flux add <package>\` | Add a dependency |
+
+## flux.json Reference
+
+\`\`\`json
+{
+  "entry":     "src/main.flux",   // default entry for flux bundle
+  "outDir":    "dist",            // output directory
+  "sourcemap": false,             // generate .js.map files
+  "typecheck": true,              // run type checker on compile
+  "scripts": { ... }             // runnable with: flux run <name>
+}
+\`\`\`
+
+## Learn More
+
+- [Flux Docs](https://flux-lang.dev/docs)
+- [Playground](https://flux-lang.dev/playground)
+- [Self-Hosted Compiler](https://flux-lang.dev/self-hosted)
+- [npm package](https://www.npmjs.com/package/@xnoxs/flux-lang)
+`, "utf8");
+  const files = [
+    `${projectName}/src/main.flux`,
+    `${projectName}/src/utils.flux`,
+    `${projectName}/tests/main.test.flux`,
+    `${projectName}/flux.json`,
+    `${projectName}/.gitignore`,
+    `${projectName}/README.md`
+  ];
   console.log();
-  console.log(clr(C.green, `\u2713 Project created: ${projectName}/`));
+  console.log(clr(C.green, `\u2713 Created: `) + clr(C.bold, `${projectName}/`));
   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`));
+  console.log(clr(C.gray, "  Files:"));
+  for (const f of files) console.log("  " + clr(C.cyan, f));
   console.log();
   console.log(clr(C.bold, "  Next steps:"));
   console.log(`    ${clr(C.yellow, `cd ${projectName}`)}`);
-  console.log(`    ${clr(C.yellow, "npm install")}`);
-  console.log(`    ${clr(C.yellow, "flux run src/main.flux")}`);
+  console.log(`    ${clr(C.yellow, `flux run src/main.flux`)}`);
+  console.log();
+  console.log(clr(C.gray, `  Or run the test suite:`));
+  console.log(`    ${clr(C.yellow, `flux test tests/`)}`);
   console.log();
 }
 function cmdCompile(filePath, opts) {

package/dist/flux.cjs.js

@@ -1,5 +1,5 @@
 /*!
- * flux-lang v3.4.0
+ * flux-lang v3.4.1
  * 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

package/dist/flux.esm.js

@@ -1,5 +1,5 @@
 /*!
- * flux-lang v3.4.0
+ * flux-lang v3.4.1
  * 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

package/dist/flux.min.js

@@ -1,5 +1,5 @@
 /*!
- * flux-lang v3.4.0
+ * flux-lang v3.4.1
  * 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnoxs/flux-lang",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "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",