yuku-codegen 0.5.11 → 0.5.14

package/README.md

@@ -42,7 +42,7 @@ interface CodegenResult {
 }
 ```
 
-`errors` is empty on a clean run. `map` is non-null only when `sourceMaps` is set.
+`errors` is empty on a clean run. `map` is non-null only when `sourceMaps` is enabled.
 
 ## Options
 
@@ -52,7 +52,7 @@ const result = print(ast, {
   indent: 2,
   quotes: "double",
   comments: "some",
-  sourceMaps: { sourceFileName: "in.js" },
+  sourceMaps: true,
 });
 ```
 
@@ -62,11 +62,21 @@ const result = print(ast, {
 | `indent`     | `number`                                 | `2`        | Spaces per indentation level. Applies in pretty mode only.                   |
 | `quotes`     | `"double" \| "single"`                   | `"double"` | Quote style for emitted string literals.                                     |
 | `comments`   | `boolean \| "some" \| "line" \| "block"` | `"some"`   | Comment passthrough filter. See [Comments](#comments).                       |
-| `sourceMaps` | `SourceMapOptions`                       | _disabled_ | Pass an object to emit a Source Map V3 alongside the code. Omit to skip.     |
+| `sourceMaps` | `boolean \| SourceMapOptions`            | `false`    | `true` emits a Source Map V3 with default metadata; pass an object for fine-grained control. See [Source maps](#source-maps). |
 
 ## Source maps
 
-Pass `sourceMaps` to emit a Source Map V3 alongside the generated code.
+Set `sourceMaps: true` for a Source Map V3 with default metadata, or pass a `SourceMapOptions` object to fill in `file`, `sources`, `sourcesContent`, and `sourceRoot`. `false` (or omitting the field) disables map output.
+
+```js
+import { parse } from "yuku-parser";
+import { print } from "yuku-codegen";
+
+const ast = parse(`const x = 1;`);
+const { map } = print(ast, { sourceMaps: true });
+```
+
+For a map with embedded source information:
 
 ```js
 import { parse } from "yuku-parser";

package/encode.js

@@ -12,13 +12,11 @@ const NODE_SPAN_START_U32 = 10;
 const NODE_SPAN_END_U32 = 11;
 const COMMENT_SIZE = 20;
 const COMMENT_TYPE_OFFSET = 0;
-const COMMENT_KIND_OFFSET = 1;
-const COMMENT_FLAGS_OFFSET = 2;
+const COMMENT_FLAGS_OFFSET = 1;
 const COMMENT_START_OFFSET = 4;
 const COMMENT_END_OFFSET = 8;
 const COMMENT_VALUE_START_OFFSET = 12;
 const COMMENT_VALUE_END_OFFSET = 16;
-const COMMENT_KINDS_INV = {"normal": 0, "legal": 1, "jsdoc": 2, "annotation": 3, "pure": 4, "no_side_effects": 5};
 const BINARY_OPS_INV = {"==": 0, "!=": 1, "===": 2, "!==": 3, "<": 4, "<=": 5, ">": 6, ">=": 7, "+": 8, "-": 9, "*": 10, "/": 11, "%": 12, "**": 13, "|": 14, "^": 15, "&": 16, "<<": 17, ">>": 18, ">>>": 19, "in": 20, "instanceof": 21};
 const LOGICAL_OPS_INV = {"&&": 0, "||": 1, "??": 2};
 const UNARY_OPS_INV = {"-": 0, "+": 1, "!": 2, "~": 3, "typeof": 4, "void": 5, "delete": 6};
@@ -2065,13 +2063,11 @@ function encode(estree, comments, lineStarts) {
     for (let i = 0; i < commentCount; i++) {
       const c = comments[i];
       const v = encStr(typeof c.value === "string" ? c.value : "");
-      const kind = typeof c.kind === "string" ? (COMMENT_KINDS_INV[c.kind] ?? 0) : 0;
       let flags = 0;
       if (c.precededByNewline) flags |= 1;
       if (c.followedByNewline) flags |= 2;
       const o = i * COMMENT_SIZE;
       cU8[o + COMMENT_TYPE_OFFSET] = c.type === "Block" ? 1 : 0;
-      cU8[o + COMMENT_KIND_OFFSET] = kind;
       cU8[o + COMMENT_FLAGS_OFFSET] = flags;
       cDV.setUint32(o + COMMENT_START_OFFSET, (c.start >>> 0), true);
       cDV.setUint32(o + COMMENT_END_OFFSET, (c.end >>> 0), true);

package/index.js

@@ -3,10 +3,14 @@ import { encode } from "./encode.js";
 
 function normalizeOptions(options) {
   if (options == null) return {};
-  const c = options.comments;
-  if (c === true) return { ...options, comments: "all" };
-  if (c === false) return { ...options, comments: "none" };
-  return options;
+  const next = { ...options };
+  const c = next.comments;
+  if (c === true) next.comments = "all";
+  else if (c === false) next.comments = "none";
+  const s = next.sourceMaps;
+  if (s === true) next.sourceMaps = {};
+  else if (s === false) next.sourceMaps = undefined;
+  return next;
 }
 
 function encodeAst(ast) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuku-codegen",
-  "version": "0.5.11",
+  "version": "0.5.14",
   "description": "High-performance JavaScript/TypeScript code generator written in Zig",
   "license": "MIT",
   "repository": {
@@ -17,17 +17,17 @@
     "encode.js"
   ],
   "optionalDependencies": {
-    "@yuku-codegen/binding-linux-x64-gnu": "0.5.11",
-    "@yuku-codegen/binding-linux-arm64-gnu": "0.5.11",
-    "@yuku-codegen/binding-linux-arm-gnu": "0.5.11",
-    "@yuku-codegen/binding-linux-x64-musl": "0.5.11",
-    "@yuku-codegen/binding-linux-arm64-musl": "0.5.11",
-    "@yuku-codegen/binding-linux-arm-musl": "0.5.11",
-    "@yuku-codegen/binding-darwin-x64": "0.5.11",
-    "@yuku-codegen/binding-darwin-arm64": "0.5.11",
-    "@yuku-codegen/binding-win32-x64": "0.5.11",
-    "@yuku-codegen/binding-win32-arm64": "0.5.11",
-    "@yuku-codegen/binding-freebsd-x64": "0.5.11"
+    "@yuku-codegen/binding-linux-x64-gnu": "0.5.14",
+    "@yuku-codegen/binding-linux-arm64-gnu": "0.5.14",
+    "@yuku-codegen/binding-linux-arm-gnu": "0.5.14",
+    "@yuku-codegen/binding-linux-x64-musl": "0.5.14",
+    "@yuku-codegen/binding-linux-arm64-musl": "0.5.14",
+    "@yuku-codegen/binding-linux-arm-musl": "0.5.14",
+    "@yuku-codegen/binding-darwin-x64": "0.5.14",
+    "@yuku-codegen/binding-darwin-arm64": "0.5.14",
+    "@yuku-codegen/binding-win32-x64": "0.5.14",
+    "@yuku-codegen/binding-win32-arm64": "0.5.14",
+    "@yuku-codegen/binding-freebsd-x64": "0.5.14"
   },
   "keywords": [
     "ast",