@ball-lang/encoder

Encodes TypeScript source into a Ball Program (the reverse of @ball-lang/compiler). Built on the TypeScript Compiler API; every construct — operators, control flow, closures, try/catch, string/list ops — routes through the universal std module (there is no ts_std). The Dart encoder (dart/encoder/, built on the analyzer package) is the canonical reference implementation.

Install

npm install @ball-lang/encoder

Usage

import { encode } from '@ball-lang/encoder';

const program = encode(`
  function main(): void {
    console.log("Hello, World!");
  }
`);

// `program` is a Ball Program object (proto3-JSON-shaped) you can
// serialize, run through @ball-lang/engine, or compile back to a
// target language.
console.log(JSON.stringify(program, null, 2));

API

• encode(source: string, options?: EncodeOptions): Program — encode TypeScript source to a Ball Program. With { strict: true } it throws an EncodeError on any unhandled construct.
• encodeWithWarnings(source, options?): EncodeResult — same as encode, but returns { program, warnings } so you can inspect non-fatal warnings (e.g. unhandled statement/expression kinds).
• TsEncoder — the underlying class.
• EncodeError — thrown in strict mode; carries the accumulated warnings.

EncodeOptions:

| Option | Type | Description | |--------|------|-------------| | moduleName | string | Name of the generated module. Default "main". | | entryFunction | string | Entry function name. Default "main". | | strict | boolean | Throw EncodeError on any unhandled construct. Default false. |

License

MIT