@yuku-codegen/wasm 0.6.12 → 0.7.0

package/README.md

@@ -8,11 +8,12 @@ returns generated source.
 
 ```js
 import { parse } from "@yuku-parser/wasm";
-import { print, strip, minify } from "@yuku-codegen/wasm";
+import { generate } from "@yuku-codegen/wasm";
 
 const { program } = parse("const x: number = 1", { lang: "ts" });
 
-print(program); // formatted source
-strip(program); // TypeScript stripped to JavaScript
-minify(program); // compact
+generate(program); // formatted source
+generate(program, { strip: true }); // TypeScript stripped to JavaScript
+generate(program, { minify: true }); // minified
+generate(program, { strip: true, minify: true }); // both
 ```

package/index.d.ts

@@ -1,6 +1,35 @@
-/** Print the AST back to formatted source. */
+/** Minification switches. */
+export interface MinifyOptions {
+  /** Emit compact whitespace. */
+  whitespace?: boolean;
+  /** Apply size-reducing syntax rewrites. */
+  syntax?: boolean;
+  /** Use shortest quotes. */
+  quotes?: boolean;
+}
+
+/** Options for `generate`. Transformations are independent flags. */
+export interface GenerateOptions {
+  /** Drop TypeScript-only syntax and emit plain JavaScript. */
+  strip?: boolean;
+  /** `true` enables every switch for maximum minification. */
+  minify?: boolean | MinifyOptions;
+  /** @default "pretty" */
+  format?: "pretty" | "compact";
+  /** Spaces per indentation level in pretty format. @default 2 */
+  indent?: number;
+  /** @default "preserve" */
+  quotes?: "preserve" | "double" | "single" | "shortest";
+  /** @default "some" */
+  comments?: boolean | "all" | "some" | "none" | "line" | "block";
+}
+
+/** Renders the AST back to source code. */
+export function generate(program: any, options?: GenerateOptions): string;
+
+/** @deprecated Use {@link generate}. */
 export function print(program: any): string;
-/** Print TypeScript to JavaScript, dropping TypeScript-only syntax. */
+/** @deprecated Use `generate(program, { strip: true })`. */
 export function strip(program: any): string;
-/** Print minified (compact, comments dropped) source. */
+/** @deprecated Use `generate(program, { minify: true })`. */
 export function minify(program: any): string;

package/index.js

@@ -18,13 +18,24 @@ async function instantiate() {
 const { memory, alloc, free, codegen } = (await instantiate()).exports;
 const decoder = new TextDecoder();
 
-function run(op, program) {
+const QUOTES = { preserve: 0, double: 1, single: 2, shortest: 3 };
+const COMMENTS = { none: 0, false: 0, all: 1, true: 1, some: 2, line: 3, block: 4 };
+
+export function generate(program, options = {}) {
+  const m = options.minify === true ? { whitespace: true, syntax: true, quotes: true } : (options.minify ?? {});
+  const flags =
+    (options.strip ? 1 : 0) |
+    (m.syntax ? 2 : 0) |
+    (m.whitespace || options.format === "compact" ? 4 : 0) |
+    ((m.quotes ? 3 : (QUOTES[options.quotes] ?? 0)) << 3) |
+    ((COMMENTS[options.comments] ?? 2) << 5) |
+    (((options.indent ?? 2) & 0xff) << 8);
   const ast = new Uint8Array(encode(program, null));
   const inPtr = alloc(ast.length || 1);
   // Growing wasm memory detaches memory.buffer, so re-view after every call.
   new Uint8Array(memory.buffer, inPtr, ast.length).set(ast);
 
-  const ptr = codegen(inPtr, ast.length, op);
+  const ptr = codegen(inPtr, ast.length, flags);
   free(inPtr, ast.length || 1);
   if (ptr === 0) throw new Error("yuku-codegen-wasm: failed to generate code");
 
@@ -34,14 +45,17 @@ function run(op, program) {
   return code;
 }
 
+/** @deprecated Use `generate(program)`. */
 export function print(program) {
-  return run(0, program);
+  return generate(program);
 }
 
+/** @deprecated Use `generate(program, { strip: true })`. */
 export function strip(program) {
-  return run(1, program);
+  return generate(program, { strip: true });
 }
 
+/** @deprecated Use `generate(program, { minify: true })`. */
 export function minify(program) {
-  return run(2, program);
+  return generate(program, { minify: true });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuku-codegen/wasm",
-  "version": "0.6.12",
+  "version": "0.7.0",
   "description": "JavaScript/TypeScript code generator as a WebAssembly module",
   "license": "MIT",
   "repository": {