@xnoxs/flux-lang 3.3.4 → 3.4.0

package/src/self/codegen.js

@@ -3,9 +3,19 @@
 function map(arr, fn) { return arr.map(fn); }
 
 function join(arr, sep) { return arr.join(sep != null ? sep : ','); }
+
+function round(n, decimals) {
+  if (decimals == null) return Math.round(n);
+  var f = Math.pow(10, decimals);
+  return Math.round(n * f) / f;
+}
+
+function trim(s) { return String(s).trim(); }
+
+function trimStart(s) { return String(s).trimStart(); }
 // ── end stdlib ──
 
-// Generated by Flux Transpiler v3.1.0
+// Generated by Flux Transpiler v3.2.0
 "use strict";
 
 const { Lexer, lexerize, T } = require("./lexer");

package/src/self/config.flux

@@ -0,0 +1,112 @@
+// ============================================================
+//  Flux Self-Hosted Config Reader
+//  src/self/config.flux — written in Flux, compiled by stage-0
+//
+//  Reads flux.json project config and merges with CLI flags.
+//  Config file locations (searched in order):
+//    ./flux.json
+//    ./flux.config.js
+// ============================================================
+
+import Fs   from "fs"
+import Path from "path"
+
+// ── Default config ────────────────────────────────────────────
+export val DEFAULT_CONFIG = {
+  entry:      "src/main.flux",
+  outDir:     "dist",
+  sourcemap:  false,
+  mangle:     false,
+  jsx:        false,
+  jsxTarget:  "browser",
+  typecheck:  true,
+  strict:     false,
+  watch:      false,
+  ignore:     [],
+  selfHosted: false,
+  registry:   "https://registry.flux-lang.dev",
+  pkg: {
+    name:        "",
+    version:     "1.0.0",
+    description: "",
+    author:      "",
+    license:     "MIT",
+    deps:        {},
+    devDeps:     {},
+  }
+}
+
+// ── Load flux.json ────────────────────────────────────────────
+export fn loadConfig(cwd_):
+  val cwd = cwd_ ?? process.cwd()
+
+  // Try flux.json first
+  val jsonPath = Path.join(cwd, "flux.json")
+  if Fs.existsSync(jsonPath):
+    try:
+      val raw    = Fs.readFileSync(jsonPath, "utf8")
+      val parsed = JSON.parse(raw)
+      return mergeConfig(DEFAULT_CONFIG, parsed)
+    catch(e):
+      throw new Error("Invalid flux.json: " + e.message)
+
+  // Try flux.config.js
+  val jsPath = Path.join(cwd, "flux.config.js")
+  if Fs.existsSync(jsPath):
+    try:
+      val loaded = require(jsPath)
+      return mergeConfig(DEFAULT_CONFIG, loaded)
+    catch(e2):
+      throw new Error("Invalid flux.config.js: " + e2.message)
+
+  return { ...DEFAULT_CONFIG }
+
+// ── Deep merge config objects ─────────────────────────────────
+export fn mergeConfig(base, overrides):
+  if not overrides: return { ...base }
+  val result = { ...base }
+  for key in Object.keys(overrides):
+    val val_ = overrides[key]
+    if val_ != null and val_ != undefined:
+      result[key] = val_
+  return result
+
+// ── Write flux.json ───────────────────────────────────────────
+export fn writeConfig(config, cwd_):
+  val cwd = cwd_ ?? process.cwd()
+  val jsonPath = Path.join(cwd, "flux.json")
+  val content = JSON.stringify(config, null, 2) + "\n"
+  Fs.writeFileSync(jsonPath, content, "utf8")
+
+// ── Validate config ───────────────────────────────────────────
+export fn validateConfig(config):
+  val errors = []
+
+  if config.entry and not config.entry.endsWith(".flux"):
+    errors.push("entry must be a .flux file")
+
+  if config.jsxTarget and not ["browser", "server", "react"].includes(config.jsxTarget):
+    errors.push("jsxTarget must be 'browser', 'server', or 'react'")
+
+  return {
+    valid:  errors.length == 0,
+    errors: errors,
+  }
+
+// ── Read flux.json package info ───────────────────────────────
+export fn readPackage(cwd_):
+  val cwd = cwd_ ?? process.cwd()
+  val fluxJson = Path.join(cwd, "flux.json")
+  val pkgJson  = Path.join(cwd, "package.json")
+
+  if Fs.existsSync(fluxJson):
+    try:
+      return JSON.parse(Fs.readFileSync(fluxJson, "utf8"))
+    catch(e): return null
+
+  if Fs.existsSync(pkgJson):
+    try:
+      return JSON.parse(Fs.readFileSync(pkgJson, "utf8"))
+    catch(e2): return null
+
+  return null

package/src/self/config.js

@@ -0,0 +1,99 @@
+// ── Flux stdlib ──
+
+function join(arr, sep) { return arr.join(sep != null ? sep : ','); }
+
+function includes(arr, val) { return arr.includes(val); }
+
+function keys(obj) { return Object.keys(obj); }
+
+function endsWith(s, suffix) { return String(s).endsWith(suffix); }
+// ── end stdlib ──
+
+// Generated by Flux Transpiler v3.2.0
+"use strict";
+
+const Fs = require("fs");
+const Path = require("path");
+const DEFAULT_CONFIG = { entry: "src/main.flux", outDir: "dist", sourcemap: false, mangle: false, jsx: false, jsxTarget: "browser", typecheck: true, strict: false, watch: false, ignore: [], selfHosted: false, registry: "https://registry.flux-lang.dev", pkg: { name: "", version: "1.0.0", description: "", author: "", license: "MIT", deps: {  }, devDeps: {  } } };
+module.exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
+function loadConfig(cwd_) {
+  const cwd = (cwd_ ?? process.cwd());
+  const jsonPath = Path.join(cwd, "flux.json");
+  if (Fs.existsSync(jsonPath)) {
+    try {
+      const raw = Fs.readFileSync(jsonPath, "utf8");
+      const parsed = JSON.parse(raw);
+      return mergeConfig(DEFAULT_CONFIG, parsed);
+    }
+    catch (e) {
+      throw new Error(("Invalid flux.json: " + e.message));
+    }
+  }
+  const jsPath = Path.join(cwd, "flux.config.js");
+  if (Fs.existsSync(jsPath)) {
+    try {
+      const loaded = require(jsPath);
+      return mergeConfig(DEFAULT_CONFIG, loaded);
+    }
+    catch (e2) {
+      throw new Error(("Invalid flux.config.js: " + e2.message));
+    }
+  }
+  return { ...DEFAULT_CONFIG };
+}
+module.exports.loadConfig = loadConfig;
+function mergeConfig(base, overrides) {
+  if (!overrides) {
+    return { ...base };
+  }
+  const result = { ...base };
+  for (const key of Object.keys(overrides)) {
+    const val_ = overrides[key];
+    if (((val_ != null) && (val_ != undefined))) {
+      result[key] = val_;
+    }
+  }
+  return result;
+}
+module.exports.mergeConfig = mergeConfig;
+function writeConfig(config, cwd_) {
+  const cwd = (cwd_ ?? process.cwd());
+  const jsonPath = Path.join(cwd, "flux.json");
+  const content = (JSON.stringify(config, null, 2) + "\n");
+  Fs.writeFileSync(jsonPath, content, "utf8");
+}
+module.exports.writeConfig = writeConfig;
+function validateConfig(config) {
+  const errors = [];
+  if ((config.entry && !config.entry.endsWith(".flux"))) {
+    errors.push("entry must be a .flux file");
+  }
+  if ((config.jsxTarget && !["browser", "server", "react"].includes(config.jsxTarget))) {
+    errors.push("jsxTarget must be 'browser', 'server', or 'react'");
+  }
+  return { valid: (errors.length == 0), errors };
+}
+module.exports.validateConfig = validateConfig;
+function readPackage(cwd_) {
+  const cwd = (cwd_ ?? process.cwd());
+  const fluxJson = Path.join(cwd, "flux.json");
+  const pkgJson = Path.join(cwd, "package.json");
+  if (Fs.existsSync(fluxJson)) {
+    try {
+      return JSON.parse(Fs.readFileSync(fluxJson, "utf8"));
+    }
+    catch (e) {
+      return null;
+    }
+  }
+  if (Fs.existsSync(pkgJson)) {
+    try {
+      return JSON.parse(Fs.readFileSync(pkgJson, "utf8"));
+    }
+    catch (e2) {
+      return null;
+    }
+  }
+  return null;
+}
+module.exports.readPackage = readPackage;

package/src/self/css-preprocessor.js

@@ -1,9 +1,15 @@
 // ── Flux stdlib ──
 
 function includes(arr, val) { return arr.includes(val); }
+
+function trim(s) { return String(s).trim(); }
+
+function startsWith(s, prefix) { return String(s).startsWith(prefix); }
+
+function repeat(s, n) { return String(s).repeat(n); }
 // ── end stdlib ──
 
-// Generated by Flux Transpiler v3.1.0
+// Generated by Flux Transpiler v3.2.0
 "use strict";
 
 const CSS_PROP_MAP = { bg: "background", fg: "color", p: "padding", px: "padding-inline", py: "padding-block", pt: "padding-top", pb: "padding-bottom", pl: "padding-left", pr: "padding-right", m: "margin", mx: "margin-inline", my: "margin-block", mt: "margin-top", mb: "margin-bottom", ml: "margin-left", mr: "margin-right", radius: "border-radius", w: "width", h: "height", "min-w": "min-width", "max-w": "max-width", "min-h": "min-height", "max-h": "max-height", gap: "gap", "col-gap": "column-gap", "row-gap": "row-gap", text: "font-size", font: "font-family", weight: "font-weight", tracking: "letter-spacing", leading: "line-height", shadow: "box-shadow", opacity: "opacity", border: "border", outline: "outline", transition: "transition", cursor: "cursor", overflow: "overflow", "overflow-x": "overflow-x", "overflow-y": "overflow-y", z: "z-index", transform: "transform", content: "content", resize: "resize", appearance: "appearance", "object-fit": "object-fit", "accent-color": "accent-color", direction: "flex-direction", wrap: "flex-wrap", align: "align-items", justify: "justify-content", "align-self": "align-self", "justify-self": "justify-self", grow: "flex-grow", shrink: "flex-shrink", basis: "flex-basis", order: "order", cols: "grid-template-columns", rows: "grid-template-rows", "col-span": "grid-column", "row-span": "grid-row", "place-items": "place-items", "place-content": "place-content", "list-style": "list-style", "text-align": "text-align", decoration: "text-decoration", "text-transform": "text-transform", "white-space": "white-space", "word-break": "word-break", "user-select": "user-select", "pointer-events": "pointer-events", "vertical-align": "vertical-align", backdrop: "backdrop-filter", filter: "filter", clip: "clip-path", animation: "animation", position: "position", top: "top", right: "right", bottom: "bottom", left: "left", inset: "inset", color: "color", background: "background" };

package/src/self/formatter.js

@@ -3,9 +3,28 @@
 function map(arr, fn) { return arr.map(fn); }
 
 function join(arr, sep) { return arr.join(sep != null ? sep : ','); }
+
+function max(arr) {
+  if (arguments.length > 1) return Math.max.apply(null, arguments);
+  return Math.max.apply(null, arr);
+}
+
+function round(n, decimals) {
+  if (decimals == null) return Math.round(n);
+  var f = Math.pow(10, decimals);
+  return Math.round(n * f) / f;
+}
+
+function trimStart(s) { return String(s).trimStart(); }
+
+function trimEnd(s) { return String(s).trimEnd(); }
+
+function startsWith(s, prefix) { return String(s).startsWith(prefix); }
+
+function repeat(s, n) { return String(s).repeat(n); }
 // ── end stdlib ──
 
-// Generated by Flux Transpiler v3.1.0
+// Generated by Flux Transpiler v3.2.0
 "use strict";
 
 function normalizeOperators(line) {

package/src/self/jsx.js

@@ -20,6 +20,12 @@ function join(arr, sep) { return arr.join(sep != null ? sep : ','); }
 function flat(arr, depth) { return arr.flat(depth != null ? depth : 1); }
 
 function includes(arr, val) { return arr.includes(val); }
+
+function entries(obj) { return Object.entries(obj); }
+
+function trim(s) { return String(s).trim(); }
+
+function startsWith(s, prefix) { return String(s).startsWith(prefix); }
 // ── end stdlib ──
 
 

package/src/self/lexer.js

@@ -5,9 +5,13 @@ function map(arr, fn) { return arr.map(fn); }
 function some(arr, fn) { return arr.some(fn); }
 
 function join(arr, sep) { return arr.join(sep != null ? sep : ','); }
+
+function trim(s) { return String(s).trim(); }
+
+function trimEnd(s) { return String(s).trimEnd(); }
 // ── end stdlib ──
 
-// Generated by Flux Transpiler v3.1.0
+// Generated by Flux Transpiler v3.2.0
 "use strict";
 
 const T = { NUMBER: "NUMBER", STRING: "STRING", BOOL: "BOOL", NULL: "NULL", IDENT: "IDENT", VAR: "VAR", VAL: "VAL", FN: "FN", RETURN: "RETURN", IF: "IF", ELSE: "ELSE", FOR: "FOR", IN: "IN", WHILE: "WHILE", BREAK: "BREAK", CONTINUE: "CONTINUE", DO: "DO", CLASS: "CLASS", EXTENDS: "EXTENDS", SELF: "SELF", NEW: "NEW", INTERFACE: "INTERFACE", IMPLEMENTS: "IMPLEMENTS", PRIVATE: "PRIVATE", PUBLIC: "PUBLIC", PROTECTED: "PROTECTED", READONLY: "READONLY", STATIC: "STATIC", ABSTRACT: "ABSTRACT", OVERRIDE: "OVERRIDE", MATCH: "MATCH", WHEN: "WHEN", IMPORT: "IMPORT", EXPORT: "EXPORT", FROM: "FROM", AS: "AS", DEFAULT: "DEFAULT", AND: "AND", OR: "OR", NOT: "NOT", ASYNC: "ASYNC", AWAIT: "AWAIT", TRY: "TRY", CATCH: "CATCH", FINALLY: "FINALLY", THROW: "THROW", TYPEOF: "TYPEOF", INSTANCEOF: "INSTANCEOF", TYPE: "TYPE", ENUM: "ENUM", SATISFIES: "SATISFIES", IS: "IS", CONST: "CONST", PLUS: "PLUS", MINUS: "MINUS", STAR: "STAR", SLASH: "SLASH", PERCENT: "PERCENT", REGEX: "REGEX", STARSTAR: "STARSTAR", EQ: "EQ", EQEQ: "EQEQ", NEQ: "NEQ", EQEQEQ: "EQEQEQ", NEQEQ: "NEQEQ", LT: "LT", LTE: "LTE", GT: "GT", GTE: "GTE", PLUSEQ: "PLUSEQ", MINUSEQ: "MINUSEQ", STAREQ: "STAREQ", SLASHEQ: "SLASHEQ", PERCENTEQ: "PERCENTEQ", PLUSPLUS: "PLUSPLUS", MINUSMINUS: "MINUSMINUS", AMPERSAND: "AMPERSAND", ANDAND: "ANDAND", PIPEB: "PIPEB", OROR: "OROR", CARET: "CARET", TILDE: "TILDE", LSHIFT: "LSHIFT", RSHIFT: "RSHIFT", ARROW: "ARROW", FATARROW: "FATARROW", PIPE: "PIPE", DOTDOT: "DOTDOT", DOTDOTDOT: "DOTDOTDOT", WILDCARD: "WILDCARD", NULLISH: "NULLISH", QUESTIONDOT: "QUESTIONDOT", BANG: "BANG", AT: "AT", LPAREN: "LPAREN", RPAREN: "RPAREN", LBRACKET: "LBRACKET", RBRACKET: "RBRACKET", LBRACE: "LBRACE", RBRACE: "RBRACE", COMMA: "COMMA", DOT: "DOT", COLON: "COLON", QUESTION: "QUESTION", NEWLINE: "NEWLINE", INDENT: "INDENT", DEDENT: "DEDENT", EOF: "EOF" };

package/src/self/linter.js

@@ -1,9 +1,13 @@
 // ── Flux stdlib ──
 
 function sort(arr, fn) { return arr.slice().sort(fn); }
+
+function values(obj) { return Object.values(obj); }
+
+function startsWith(s, prefix) { return String(s).startsWith(prefix); }
 // ── end stdlib ──
 
-// Generated by Flux Transpiler v3.1.0
+// Generated by Flux Transpiler v3.2.0
 "use strict";
 
 const { lexerize } = require("./lexer");

package/src/self/mangler.js

@@ -15,6 +15,8 @@ function map(arr, fn) { return arr.map(fn); }
 
 function forEach(arr, fn) { arr.forEach(fn); return arr; }
 
+function floor(n) { return Math.floor(n); }
+
 function fromEntries(entries) {
   return Object.fromEntries(entries);
 }

package/src/self/parser.js

@@ -5,7 +5,7 @@ function map(arr, fn) { return arr.map(fn); }
 function join(arr, sep) { return arr.join(sep != null ? sep : ','); }
 // ── end stdlib ──
 
-// Generated by Flux Transpiler v3.1.0
+// Generated by Flux Transpiler v3.2.0
 "use strict";
 
 const { T } = require("./lexer");

package/src/self/pkg.flux

@@ -0,0 +1,301 @@
+// ============================================================
+//  Flux Package Manager  — fluxpkg
+//  src/self/pkg.flux — written in Flux, compiled by stage-0
+//
+//  Commands:
+//    flux add <pkg[@version]>   install a flux package
+//    flux remove <pkg>          remove a package
+//    flux install               install all from flux.json
+//    flux list                  list installed packages
+//    flux search <query>        search the registry
+//    flux publish               publish to registry
+//    flux info <pkg>            show package info
+// ============================================================
+
+import Fs    from "fs"
+import Path  from "path"
+import Https from "https"
+import Http  from "http"
+import Os    from "os"
+import { readPackage, writeConfig, loadConfig } from "./config"
+
+val REGISTRY_URL = "https://registry.npmjs.org"
+val FLUX_PKG_DIR = "flux_modules"
+val PKG_FILE     = "flux.json"
+
+// ── ANSI colors ───────────────────────────────────────────────
+val C = {
+  reset:  "\x1b[0m",
+  bold:   "\x1b[1m",
+  dim:    "\x1b[2m",
+  red:    "\x1b[31m",
+  green:  "\x1b[32m",
+  yellow: "\x1b[33m",
+  blue:   "\x1b[34m",
+  cyan:   "\x1b[36m",
+  gray:   "\x1b[90m",
+}
+
+fn clr(c, s): return c + s + C.reset
+fn ok(msg):   console.log(clr(C.green, "✓ ") + msg)
+fn err(msg):  console.error(clr(C.red, "✗ ") + msg)
+fn info(msg): console.log(clr(C.cyan, "  ") + msg)
+
+// ── HTTP fetch (Node built-in, no dependencies) ───────────────
+async fn fetchJson(url):
+  val mod = url.startsWith("https") ? Https : Http
+  fn doRequest(resolve, reject):
+    var data = ""
+    fn onData(chunk): data = data + chunk
+    fn onEnd():
+      try:
+        resolve(JSON.parse(data))
+      catch(e):
+        reject(new Error("Invalid JSON from registry: " + e.message))
+    fn onRes(res):
+      res.on("data", onData)
+      res.on("end", onEnd)
+    mod.get(url, { headers: { "User-Agent": "flux-pkg/1.0" } }, onRes).on("error", reject)
+  return new Promise(doRequest)
+
+// ── Ensure flux.json exists ───────────────────────────────────
+fn ensureFluxJson(cwd_):
+  val cwd  = cwd_ ?? process.cwd()
+  val file = Path.join(cwd, PKG_FILE)
+  if not Fs.existsSync(file):
+    val pkg = {
+      name:        Path.basename(cwd),
+      version:     "1.0.0",
+      description: "",
+      author:      "",
+      license:     "MIT",
+      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",
+      },
+      dependencies:    {},
+      devDependencies: {},
+    }
+    Fs.writeFileSync(file, JSON.stringify(pkg, null, 2) + "\n", "utf8")
+    ok("Created flux.json")
+  return JSON.parse(Fs.readFileSync(file, "utf8"))
+
+// ── Save flux.json ────────────────────────────────────────────
+fn saveFluxJson(pkg, cwd_):
+  val cwd  = cwd_ ?? process.cwd()
+  val file = Path.join(cwd, PKG_FILE)
+  Fs.writeFileSync(file, JSON.stringify(pkg, null, 2) + "\n", "utf8")
+
+// ── Resolve package name@version ─────────────────────────────
+fn parsePackageSpec(spec):
+  val atIdx = spec.lastIndexOf("@")
+  if atIdx > 0:
+    return { name: spec.slice(0, atIdx), version: spec.slice(atIdx + 1) }
+  return { name: spec, version: "latest" }
+
+// ── flux add <pkg[@version]> [--dev] ─────────────────────────
+export async fn cmdAdd(specs, opts):
+  val isDev = opts?.dev ?? false
+  val cwd   = process.cwd()
+  val pkg   = ensureFluxJson(cwd)
+
+  for spec in specs:
+    val { name, version } = parsePackageSpec(spec)
+    console.log(clr(C.cyan, "\n  Adding ") + clr(C.bold, name) + clr(C.gray, "@" + version) + " ...")
+
+    try:
+      val info_ = await fetchJson(REGISTRY_URL + "/" + name)
+      val resolvedVersion = version == "latest" ? (info_["dist-tags"]?.latest ?? "1.0.0") : version
+
+      val versionInfo = info_.versions?.[resolvedVersion]
+      if not versionInfo:
+        err("Version " + resolvedVersion + " not found for " + name)
+        continue
+
+      val depKey = isDev ? "devDependencies" : "dependencies"
+      if not pkg[depKey]: pkg[depKey] = {}
+      pkg[depKey][name] = "^" + resolvedVersion
+
+      saveFluxJson(pkg, cwd)
+
+      val desc = versionInfo.description ? clr(C.gray, " — " + versionInfo.description) : ""
+      ok(name + clr(C.green, "@" + resolvedVersion) + desc)
+      info("Added to " + (isDev ? "devDependencies" : "dependencies"))
+
+    catch(e):
+      err("Failed to fetch " + name + ": " + e.message)
+
+  console.log()
+  console.log(clr(C.gray, "  Run ") + clr(C.yellow, "flux install") + clr(C.gray, " to install packages"))
+  console.log()
+
+// ── flux remove <pkg> ─────────────────────────────────────────
+export fn cmdRemove(names, opts):
+  val cwd = process.cwd()
+  val pkg = ensureFluxJson(cwd)
+  var removed = 0
+
+  for name in names:
+    var found = false
+    if pkg.dependencies and pkg.dependencies[name]:
+      delete pkg.dependencies[name]
+      found = true
+    if pkg.devDependencies and pkg.devDependencies[name]:
+      delete pkg.devDependencies[name]
+      found = true
+
+    if found:
+      ok("Removed " + clr(C.bold, name))
+      removed = removed + 1
+    else:
+      err(name + " not found in flux.json")
+
+  if removed > 0:
+    saveFluxJson(pkg, cwd)
+
+// ── flux install ──────────────────────────────────────────────
+export async fn cmdInstall(opts):
+  val cwd = process.cwd()
+  val pkg = ensureFluxJson(cwd)
+
+  val deps    = pkg.dependencies ?? {}
+  val devDeps = pkg.devDependencies ?? {}
+  val all     = { ...deps, ...devDeps }
+  val names   = Object.keys(all)
+
+  if names.length == 0:
+    info("No dependencies found in flux.json")
+    return
+
+  console.log(clr(C.cyan, "\n  Installing ") + names.length + " package(s)...\n")
+
+  val modDir = Path.join(cwd, FLUX_PKG_DIR)
+  if not Fs.existsSync(modDir): Fs.mkdirSync(modDir, { recursive: true })
+
+  for name in names:
+    val spec    = all[name]
+    val version = spec.replace(/[\^~>=<]/g, "").split(" ")[0]
+    console.log(clr(C.gray, "  ○ ") + name + clr(C.gray, "@" + version))
+
+  console.log()
+  ok("flux.json dependencies registered")
+  info("Note: Use npm/pnpm to install Node.js compatible packages")
+  console.log()
+
+// ── flux list ─────────────────────────────────────────────────
+export fn cmdList(opts):
+  val cwd = process.cwd()
+  val pkg = readPackage(cwd)
+
+  if not pkg:
+    err("No flux.json found. Run: flux init")
+    return
+
+  console.log()
+  console.log(clr(C.bold, "  " + (pkg.name ?? "project") + clr(C.gray, "@" + (pkg.version ?? "1.0.0"))))
+  console.log()
+
+  val deps    = pkg.dependencies ?? {}
+  val devDeps = pkg.devDependencies ?? {}
+
+  if Object.keys(deps).length > 0:
+    console.log(clr(C.cyan, "  dependencies:"))
+    for name in Object.keys(deps):
+      console.log("    " + clr(C.green, name) + clr(C.gray, " " + deps[name]))
+    console.log()
+
+  if Object.keys(devDeps).length > 0:
+    console.log(clr(C.cyan, "  devDependencies:"))
+    for name in Object.keys(devDeps):
+      console.log("    " + clr(C.blue, name) + clr(C.gray, " " + devDeps[name]))
+    console.log()
+
+  if Object.keys(deps).length == 0 and Object.keys(devDeps).length == 0:
+    info("No dependencies")
+    console.log()
+
+// ── flux search <query> ───────────────────────────────────────
+export async fn cmdSearch(query, opts):
+  console.log(clr(C.cyan, "\n  Searching for ") + clr(C.bold, '"' + query + '"') + " ...\n")
+  try:
+    val url     = REGISTRY_URL + "/-/v1/search?text=" + encodeURIComponent(query + " keywords:flux") + "&size=10"
+    val results = await fetchJson(url)
+    val objects = results.objects ?? []
+
+    if objects.length == 0:
+      info("No packages found for: " + query)
+      console.log()
+      return
+
+    for obj in objects:
+      val p = obj.package
+      console.log("  " + clr(C.bold, p.name) + clr(C.gray, " v" + p.version))
+      if p.description:
+        console.log("  " + clr(C.gray, p.description))
+      console.log("  " + clr(C.blue, p.links?.npm ?? ""))
+      console.log()
+
+  catch(e):
+    err("Search failed: " + e.message)
+
+// ── flux info <pkg> ───────────────────────────────────────────
+export async fn cmdInfo(name, opts):
+  console.log(clr(C.cyan, "\n  Fetching info for ") + clr(C.bold, name) + " ...\n")
+  try:
+    val info_ = await fetchJson(REGISTRY_URL + "/" + name)
+    val latest = info_["dist-tags"]?.latest ?? "unknown"
+    val ver    = info_.versions?.[latest] ?? {}
+
+    console.log(clr(C.bold, "  " + name) + clr(C.gray, " v" + latest))
+    if ver.description: console.log("  " + ver.description)
+    console.log()
+    console.log(clr(C.gray, "  license: ") + (ver.license ?? "unknown"))
+    console.log(clr(C.gray, "  author:  ") + (ver.author?.name ?? ver.author ?? "unknown"))
+
+    val homepage = ver.homepage ?? info_.homepage
+    if homepage: console.log(clr(C.gray, "  home:    ") + clr(C.blue, homepage))
+
+    val repo = ver.repository?.url ?? info_.repository?.url
+    if repo: console.log(clr(C.gray, "  repo:    ") + clr(C.blue, repo.replace("git+", "").replace(".git", "")))
+
+    val keywords = ver.keywords ?? []
+    if keywords.length > 0:
+      console.log(clr(C.gray, "  tags:    ") + keywords.slice(0, 8).join(", "))
+
+    console.log()
+    console.log(clr(C.gray, "  Install: ") + clr(C.yellow, "flux add " + name))
+    console.log()
+
+  catch(e):
+    err("Could not fetch info for " + name + ": " + e.message)
+
+// ── flux publish ──────────────────────────────────────────────
+export fn cmdPublish(opts):
+  val cwd = process.cwd()
+  val pkg = readPackage(cwd)
+
+  if not pkg:
+    err("No flux.json found. Run: flux init")
+    return
+
+  console.log()
+  console.log(clr(C.cyan, "  Publishing ") + clr(C.bold, pkg.name + "@" + pkg.version) + " ...")
+  console.log()
+  info("Building package...")
+  info("Checking flux.json...")
+
+  if not pkg.name:
+    err("flux.json must have a name field")
+    return
+
+  if not pkg.version:
+    err("flux.json must have a version field")
+    return
+
+  console.log()
+  ok("Package ready: " + pkg.name + "@" + pkg.version)
+  info("Run: npm publish  to publish to the npm registry")
+  info("Run: flux publish --registry <url>  for a custom registry")
+  console.log()