@ball-lang/encoder 0.1.0 → 1.3.5

package/README.md

@@ -0,0 +1,47 @@
+[![npm version](https://img.shields.io/npm/v/@ball-lang/encoder.svg)](https://www.npmjs.com/package/@ball-lang/encoder)
+
+# @ball-lang/encoder
+
+Encodes **TypeScript** source into a [Ball](https://github.com/ball-lang/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
+
+```bash
+npm install @ball-lang/encoder
+```
+
+## Usage
+
+```ts
+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

package/dist/encoder.d.ts

@@ -7,6 +7,7 @@ export interface EncodeOptions {
 export declare class TsEncoder {
     private stdFunctions;
     private warnings;
+    private strict;
     encode(source: string, options?: EncodeOptions): Program;
     private encodeFunction;
     private encodeBody;
@@ -14,7 +15,8 @@ export declare class TsEncoder {
     private encodeStatement;
     private encodeExpr;
     private encodeBinary;
-    private looksLikeStringConcat;
+    private isProvablyString;
+    private isStringExpr;
     private encodePrefixUnary;
     private encodePostfixUnary;
     private encodeCall;
@@ -33,10 +35,25 @@ export declare class TsEncoder {
     private encodeTypeAlias;
     private encodeEnum;
     private encodeTaggedTemplate;
+    /**
+     * Map a JS/TS method name to its Ball std function equivalent.
+     * Returns null if no mapping exists (falls through to generic method call).
+     */
+    private mapMethodToStd;
     private stdCall;
-    private buildStdModule;
+    private buildBaseModules;
+    private nullLiteral;
     private warn;
     getWarnings(): string[];
 }
+export declare class EncodeError extends Error {
+    readonly warnings: string[];
+    constructor(message: string, warnings: string[]);
+}
+export interface EncodeResult {
+    program: Program;
+    warnings: string[];
+}
 export declare function encode(source: string, options?: EncodeOptions): Program;
+export declare function encodeWithWarnings(source: string, options?: EncodeOptions): EncodeResult;
 //# sourceMappingURL=encoder.d.ts.map

package/dist/encoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../src/encoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EAGR,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA2CD,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAgB;IAEhC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO;IAyF5D,OAAO,CAAC,cAAc;IAwCtB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,eAAe;IA8GvB,OAAO,CAAC,UAAU;IAmJlB,OAAO,CAAC,YAAY;IA6CpB,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,UAAU;IA6DlB,OAAO,CAAC,YAAY;IAgDpB,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,SAAS;IA0BjB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,WAAW;IA8DnB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,IAAI;IAIZ,WAAW,IAAI,MAAM,EAAE;CAGxB;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAE3E"}
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../src/encoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EAGR,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA2CD,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAS;IAEvB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO;IA0F5D,OAAO,CAAC,cAAc;IAwCtB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,eAAe;IA8HvB,OAAO,CAAC,UAAU;IA6JlB,OAAO,CAAC,YAAY;IA2DpB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,UAAU;IA8GlB,OAAO,CAAC,YAAY;IA8CpB,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,SAAS;IAqCjB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,SAAS;IA2BjB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,WAAW;IA8DnB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,oBAAoB;IAsB5B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAmFtB,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,IAAI;IAUZ,WAAW,IAAI,MAAM,EAAE;CAGxB;AAID,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAChB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;CAKhD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAQD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAE3E;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,CAI5F"}