yuku-codegen 0.5.8

package/index.d.ts

@@ -0,0 +1,81 @@
+import type { Program } from "yuku-parser";
+
+/** Whitespace mode for the generated output. */
+export type Format = "pretty" | "compact";
+
+/** Quote style for emitted string literals. */
+export type Quotes = "double" | "single";
+
+/** Source-map configuration. Pass to `CodegenOptions.sourceMaps` to enable. */
+export interface SourceMapOptions {
+  /** Original source the AST was parsed from. Required. */
+  source: string;
+  /** Output filename, embedded as the map's `file`. */
+  file?: string;
+  /** Source filename, embedded as the single entry of `sources`. */
+  sourceFileName?: string;
+  /** Prefix embedded as `sourceRoot`. */
+  sourceRoot?: string;
+  /**
+   * When true, embeds `source` into `sourcesContent`.
+   * @default false
+   */
+  sourcesContent?: boolean;
+}
+
+/** Codegen options shared by `print`, `strip`, and `minify`. */
+export interface CodegenOptions {
+  /** @default "pretty" */
+  format?: Format;
+  /**
+   * Spaces per indentation level. Used only when `format = "pretty"`.
+   * @default 2
+   */
+  indent?: number;
+  /** @default "double" */
+  quotes?: Quotes;
+  /** Pass to enable source maps. Omit to disable. */
+  sourceMaps?: SourceMapOptions;
+}
+
+/** A codegen-detected problem in the input AST. */
+export interface Diagnostic {
+  message: string;
+  /** Byte offset where the problem starts. */
+  start: number;
+  /** Byte offset where the problem ends. */
+  end: number;
+}
+
+/** Source Map V3. */
+export interface SourceMap {
+  version: 3;
+  file: string | null;
+  sourceRoot: string | null;
+  sources: string[];
+  sourcesContent: (string | null)[] | null;
+  names: string[];
+  /** VLQ-encoded mappings string. */
+  mappings: string;
+}
+
+/** Result of a codegen run. */
+export interface CodegenResult {
+  code: string;
+  /** Empty when codegen succeeded cleanly. */
+  errors: Diagnostic[];
+  /** `null` unless `sourceMaps` was enabled. */
+  map: SourceMap | null;
+}
+
+/** Renders the AST verbatim, preserving TypeScript syntax. */
+export function print(estree: Program, options?: CodegenOptions): CodegenResult;
+
+/** Renders the AST as JavaScript, dropping TypeScript-specific syntax. */
+export function strip(estree: Program, options?: CodegenOptions): CodegenResult;
+
+/**
+ * Renders the AST with size-reducing rewrites. Combine with
+ * `format: "compact"` for full minification.
+ */
+export function minify(estree: Program, options?: CodegenOptions): CodegenResult;

package/index.js

@@ -0,0 +1,14 @@
+import binding from "./binding.js";
+import { encode } from "./encode.js";
+
+export function print(estree, options) {
+  return binding.print(encode(estree), options ?? {});
+}
+
+export function strip(estree, options) {
+  return binding.strip(encode(estree), options ?? {});
+}
+
+export function minify(estree, options) {
+  return binding.minify(encode(estree), options ?? {});
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "yuku-codegen",
+  "version": "0.5.8",
+  "description": "High-performance JavaScript/TypeScript code generator written in Zig",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yuku-toolchain/yuku"
+  },
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "binding.js",
+    "encode.js"
+  ],
+  "optionalDependencies": {
+    "@yuku-codegen/binding-linux-x64-gnu": "0.5.8",
+    "@yuku-codegen/binding-linux-arm64-gnu": "0.5.8",
+    "@yuku-codegen/binding-linux-arm-gnu": "0.5.8",
+    "@yuku-codegen/binding-linux-x64-musl": "0.5.8",
+    "@yuku-codegen/binding-linux-arm64-musl": "0.5.8",
+    "@yuku-codegen/binding-linux-arm-musl": "0.5.8",
+    "@yuku-codegen/binding-darwin-x64": "0.5.8",
+    "@yuku-codegen/binding-darwin-arm64": "0.5.8",
+    "@yuku-codegen/binding-win32-x64": "0.5.8",
+    "@yuku-codegen/binding-win32-arm64": "0.5.8",
+    "@yuku-codegen/binding-freebsd-x64": "0.5.8"
+  },
+  "dependencies": {
+    "yuku-parser": "workspace:*"
+  },
+  "keywords": [
+    "codegen",
+    "javascript",
+    "typescript",
+    "ast",
+    "estree",
+    "printer",
+    "minifier",
+    "napi"
+  ]
+}