@ball-lang/compiler 0.1.0

package/bin/ball-ts-compile.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * ball-ts-compile — Ball (binary .ball.pb or proto3 JSON) → TypeScript.
+ *
+ * Usage:
+ *   ball-ts-compile <program.ball.json|program.ball.pb> [--out <path>] [--no-preamble]
+ *
+ * If --out is omitted, writes to stdout.
+ * If the input file doesn't match either extension, JSON is assumed.
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+import { extname } from "node:path";
+import { compile } from "../dist/index.js";
+
+function die(msg) {
+  process.stderr.write(`ball-ts-compile: ${msg}\n`);
+  process.exit(1);
+}
+
+function parseArgs(argv) {
+  const out = { input: null, output: null, includePreamble: true };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--out" && i + 1 < argv.length) { out.output = argv[++i]; }
+    else if (a === "--no-preamble") { out.includePreamble = false; }
+    else if (a === "-h" || a === "--help") {
+      process.stdout.write(
+        "Usage: ball-ts-compile <program.ball.json|program.ball.pb> [--out <path>] [--no-preamble]\n"
+      );
+      process.exit(0);
+    }
+    else if (!out.input) { out.input = a; }
+    else { die(`unexpected argument: ${a}`); }
+  }
+  if (!out.input) die("missing input file");
+  return out;
+}
+
+const args = parseArgs(process.argv.slice(2));
+const ext = extname(args.input).toLowerCase();
+
+let program;
+if (ext === ".pb") {
+  die("binary .ball.pb not yet supported in @ball-lang/compiler (use .ball.json)");
+} else {
+  const text = readFileSync(args.input, "utf8");
+  try { program = JSON.parse(text); }
+  catch (e) { die(`invalid JSON: ${e.message}`); }
+}
+
+const ts = compile(program, { includePreamble: args.includePreamble });
+if (args.output) {
+  writeFileSync(args.output, ts);
+} else {
+  process.stdout.write(ts);
+}

package/dist/compiler.d.ts

@@ -0,0 +1,70 @@
+import type { Program } from "./types.ts";
+export interface CompileOptions {
+    /** Include the runtime preamble at the top of the output. Default true. */
+    includePreamble?: boolean;
+    /** Output file path hint (affects ts-morph's internal resolution). */
+    fileName?: string;
+}
+export declare class BallCompiler {
+    private readonly program;
+    /** Buffer that _emit* functions write into. */
+    private out;
+    private depth;
+    /** Catch-bound variables currently in scope — subject to bracket access. */
+    private readonly catchVars;
+    /** Fields of the class currently being emitted (method bodies). */
+    private currentClassFields;
+    /** Parameters of the currently-emitting method (shadow fields). */
+    private currentMethodParams;
+    /** Short method names of the current class (for `this.foo()` routing). */
+    private currentClassMethodNames;
+    /** All function names in the entry module (function vs ctor routing). */
+    private allFunctionNames;
+    /** typeDefs in the entry module (typeName → definition). */
+    private typeDefByName;
+    constructor(program: Program);
+    /** Compile to TS source. */
+    compile(options?: CompileOptions): string;
+    private emitFreeFunction;
+    private emitClass;
+    private buildCtor;
+    private buildMethod;
+    private buildGetter;
+    private buildSetter;
+    private captureInto;
+    private writeln;
+    private get ind();
+    private withMethodContext;
+    private emitStatementOrExpression;
+    private emitBlock;
+    private emitStatement;
+    private isControlFlow;
+    private emitControlFlowStatement;
+    private emitIfStmt;
+    private emitForStmt;
+    private emitForInStmt;
+    private emitWhileStmt;
+    private emitDoWhileStmt;
+    private emitTryStmt;
+    private emitAssignStmt;
+    private typedCatchCondition;
+    private expr;
+    private compileLiteral;
+    private compileFieldAccess;
+    private compileMessageCreation;
+    private extractPositionalAndNamed;
+    private typeIsUserDefinedClass;
+    private compileBlockExpression;
+    private compileLambda;
+    private compileCall;
+    private compileStdCall;
+    private emitIsCheck;
+    private wrapIfNeeded;
+    private compileSwitchExpr;
+    private compileThrowValue;
+    private enclosingTypeName;
+    private dartTypeToTs;
+}
+/** Convenience: compile a Program directly. */
+export declare function compile(program: Program, options?: CompileOptions): string;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAOV,OAAO,EAIR,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAQD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC,+CAA+C;IAC/C,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,KAAK,CAAK;IAElB,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,mEAAmE;IACnE,OAAO,CAAC,kBAAkB,CAA0B;IAEpD,mEAAmE;IACnE,OAAO,CAAC,mBAAmB,CAA0B;IAErD,0EAA0E;IAC1E,OAAO,CAAC,uBAAuB,CAA0B;IAEzD,yEAAyE;IACzE,OAAO,CAAC,gBAAgB,CAA0B;IAElD,4DAA4D;IAC5D,OAAO,CAAC,aAAa,CAA0C;gBAEnD,OAAO,EAAE,OAAO;IAI5B,4BAA4B;IAC5B,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM;IAyF7C,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,SAAS;IAqJjB,OAAO,CAAC,SAAS;IAsDjB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,OAAO;IAIf,OAAO,KAAK,GAAG,GAEd;IAED,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,SAAS;IAmBjB,OAAO,CAAC,aAAa;IAmCrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,wBAAwB;IAyHhC,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,WAAW;IAmFnB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,IAAI;IA0BZ,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,sBAAsB;IAuD9B,OAAO,CAAC,yBAAyB;IAqBjC,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,WAAW;IA2CnB,OAAO,CAAC,cAAc;IAoRtB,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,iBAAiB;IA6CzB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,YAAY;CA8CrB;AAqOD,+CAA+C;AAC/C,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAE1E"}