yuku-parser 0.5.3 → 0.5.4

package/README.md

@@ -44,6 +44,19 @@ import type { Node, Statement, Expression, Identifier } from "yuku-parser";
 
 The `Node` union type covers every possible AST node. Individual types like `Statement`, `Expression`, `Declaration`, etc. are also available. See the full list in the [type definitions](https://github.com/yuku-toolchain/yuku/blob/main/npm/yuku-parser/index.d.ts).
 
+## Path helpers
+
+Two small helpers are exported for resolving the `lang` and `sourceType` options from a file path:
+
+```ts
+import { langFromPath, sourceTypeFromPath } from "yuku-parser";
+
+langFromPath("foo.tsx");        // "tsx"
+langFromPath("types.d.ts");     // "dts"
+sourceTypeFromPath("foo.cjs");  // "script"
+sourceTypeFromPath("foo.mjs");  // "module"
+```
+
 ## Walking the AST
 
 The AST is standard ESTree, so any ESTree-compatible walker works. For example, with [zimmerframe](https://github.com/sveltejs/zimmerframe):

package/decode.js

@@ -103,8 +103,8 @@ function decode(buffer, source) {
     case 1: return { type: "ParenthesizedExpression", start, end, expression: f1 !== NULL ? node(f1) : null };
     case 2: { const r = { type: "ArrowFunctionExpression", start, end, id: null, generator: false, async: !!(flags & 2), params: f1 !== NULL ? fnParams(f1) : [], body: node(f2), expression: !!(flags & 1) }; if (_isTs) { r.typeParameters = f3 !== NULL ? node(f3) : null; r.returnType = f4 !== NULL ? node(f4) : null; } return r; }
     case 3: { const ft = flags & 3; const r = { type: FUNCTION_TYPES[ft], start, end, id: f1 !== NULL ? node(f1) : null, generator: !!(flags & 4), async: !!(flags & 8), params: f2 !== NULL ? fnParams(f2) : [], body: f3 !== NULL ? node(f3) : null, expression: false }; if (_isTs) { r.typeParameters = f4 !== NULL ? node(f4) : null; r.returnType = f5 !== NULL ? node(f5) : null; r.declare = !!(flags & 16); } return r; }
-    case 4: return { type: "BlockStatement", start, end, body: nodeArr(f1, f0) };
-    case 5: return { type: "BlockStatement", start, end, body: nodeArr(f1, f0) };
+    case 4: return { type: "BlockStatement", start, end, get body() { const v = nodeArr(f1, f0); _def(this, "body", v); return v; } };
+    case 5: return { type: "BlockStatement", start, end, get body() { const v = nodeArr(f1, f0); _def(this, "body", v); return v; } };
     case 6: return { params: fnParams(i) };
     case 7: return node(f1);
     case 8: return { type: "BinaryExpression", start, end, left: f1 !== NULL ? node(f1) : null, right: f2 !== NULL ? node(f2) : null, operator: BINARY_OPS[flags & 31] };
@@ -127,10 +127,10 @@ function decode(buffer, source) {
     case 25: return { type: "MetaProperty", start, end, meta: f1 !== NULL ? node(f1) : null, property: f2 !== NULL ? node(f2) : null };
     case 26: return { type: "Decorator", start, end, expression: f1 !== NULL ? node(f1) : null };
     case 27: { const r = { type: CLASS_TYPES[flags & 1], start, end, decorators: nodeArr(f1, f0), id: f2 !== NULL ? node(f2) : null, superClass: f3 !== NULL ? node(f3) : null, body: node(f4) }; if (_isTs) { r.typeParameters = f5 !== NULL ? node(f5) : null; r.superTypeArguments = f6 !== NULL ? node(f6) : null; r.implements = nodeArr(f7, f8); r.abstract = !!(flags & 2); r.declare = !!(flags & 4); } return r; }
-    case 28: return { type: "ClassBody", start, end, body: nodeArr(f1, f0) };
+    case 28: return { type: "ClassBody", start, end, get body() { const v = nodeArr(f1, f0); _def(this, "body", v); return v; } };
     case 29: { const r = { type: "MethodDefinition", start, end, decorators: nodeArr(f1, f0), key: node(f2), value: node(f3), kind: METHOD_KINDS[flags & 3], computed: !!(flags & 4), static: !!(flags & 8) }; if (_isTs) { r.override = !!(flags & 16); r.optional = !!(flags & 32); const _abs = !!(flags & 64); r.accessibility = ACCESSIBILITY[(flags >> 7) & 3]; if (_abs) r.type = "TSAbstractMethodDefinition"; } return r; }
     case 30: { const _acc = !!(flags & 4); const r = { type: _acc ? "AccessorProperty" : "PropertyDefinition", start, end, decorators: nodeArr(f1, f0), key: node(f2), value: f3 !== NULL ? node(f3) : null, computed: !!(flags & 1), static: !!(flags & 2) }; if (_isTs) { r.typeAnnotation = f4 !== NULL ? node(f4) : null; r.declare = !!(flags & 8); r.override = !!(flags & 16); r.optional = !!(flags & 32); r.definite = !!(flags & 64); r.readonly = !!(flags & 128); const _abs = !!(flags & 256); r.accessibility = ACCESSIBILITY[(flags >> 9) & 3]; if (_abs) r.type = _acc ? "TSAbstractAccessorProperty" : "TSAbstractPropertyDefinition"; } return r; }
-    case 31: return { type: "StaticBlock", start, end, body: nodeArr(f1, f0) };
+    case 31: return { type: "StaticBlock", start, end, get body() { const v = nodeArr(f1, f0); _def(this, "body", v); return v; } };
     case 32: return { type: "Super", start, end };
     case 33: return { type: "Literal", start, end, value: str(f1, f2), raw: _src.slice(start, end) };
     case 34: { const r = _src.slice(start, end); const s = r.indexOf("_") === -1 ? r : r.replace(/_/g, ""); const v = (flags & 3) === 2 && s[1] !== "o" && s[1] !== "O" ? parseInt(s.slice(1), 8) : +s; return { type: "Literal", start, end, value: v === v && isFinite(v) ? v : null, raw: r }; }
@@ -173,7 +173,7 @@ function decode(buffer, source) {
     case 71: { const el = nodeArrHoles(f1, f0); if (f2 !== NULL) el.push(node(f2)); const r = { type: "ArrayPattern", start, end, elements: el }; if (_isTs) { r.decorators = nodeArr(f3, f4); r.optional = !!(flags & 1); r.typeAnnotation = f5 !== NULL ? node(f5) : null; } return r; }
     case 72: { const pr = nodeArr(f1, f0); if (f2 !== NULL) pr.push(node(f2)); const r = { type: "ObjectPattern", start, end, properties: pr }; if (_isTs) { r.decorators = nodeArr(f3, f4); r.optional = !!(flags & 1); r.typeAnnotation = f5 !== NULL ? node(f5) : null; } return r; }
     case 73: { const r = { type: "Property", start, end, kind: "init", key: node(f1), value: node(f2), method: false, shorthand: !!(flags & 1), computed: !!(flags & 2) }; if (_isTs) { r.optional = false; } return r; }
-    case 74: return { type: "Program", start, end, sourceType: (flags & 1) ? "module" : "script", hashbang: (flags & 2) ? { type: "Hashbang", start: _p(f2 - 2), end: _p(f3), value: str(f2, f3) } : null, body: nodeArr(f1, f0) };
+    case 74: return { type: "Program", start, end, sourceType: (flags & 1) ? "module" : "script", hashbang: (flags & 2) ? { type: "Hashbang", start: _p(f2 - 2), end: _p(f3), value: str(f2, f3) } : null, get body() { const v = nodeArr(f1, f0); _def(this, "body", v); return v; } };
     case 75: return { type: "ImportExpression", start, end, source: f1 !== NULL ? node(f1) : null, options: f2 !== NULL ? node(f2) : null, phase: (flags & 1) ? ["source", "defer"][(flags >> 1) & 1] : null };
     case 76: { const r = { type: "ImportDeclaration", start, end, specifiers: nodeArr(f1, f0), source: f2 !== NULL ? node(f2) : null, attributes: nodeArr(f3, f4), phase: (flags & 1) ? ["source", "defer"][(flags >> 1) & 1] : null }; if (_isTs) { r.importKind = IMPORT_EXPORT_KINDS[(flags >> 2) & 1]; } return r; }
     case 77: { const r = { type: "ImportSpecifier", start, end, imported: f1 !== NULL ? node(f1) : null, local: f2 !== NULL ? node(f2) : null }; if (_isTs) { r.importKind = IMPORT_EXPORT_KINDS[flags & 1]; } return r; }
@@ -235,14 +235,14 @@ function decode(buffer, source) {
     case 133: { const r = { type: "TSIndexSignature", start, end, parameters: nodeArr(f1, f0), typeAnnotation: f2 !== NULL ? node(f2) : null, readonly: !!(flags & 1) }; if (_isTs) { r.static = !!(flags & 2); r.accessibility = null; } return r; }
     case 134: return { type: "TSTypeAliasDeclaration", start, end, id: f1 !== NULL ? node(f1) : null, typeParameters: f2 !== NULL ? node(f2) : null, typeAnnotation: f3 !== NULL ? node(f3) : null, declare: !!(flags & 1) };
     case 135: return { type: "TSInterfaceDeclaration", start, end, id: f1 !== NULL ? node(f1) : null, typeParameters: f2 !== NULL ? node(f2) : null, extends: nodeArr(f3, f0), body: f4 !== NULL ? node(f4) : null, declare: !!(flags & 1) };
-    case 136: return { type: "TSInterfaceBody", start, end, body: nodeArr(f1, f0) };
+    case 136: return { type: "TSInterfaceBody", start, end, get body() { const v = nodeArr(f1, f0); _def(this, "body", v); return v; } };
     case 137: return { type: "TSInterfaceHeritage", start, end, expression: f1 !== NULL ? node(f1) : null, typeArguments: f2 !== NULL ? node(f2) : null };
     case 138: return { type: "TSClassImplements", start, end, expression: f1 !== NULL ? node(f1) : null, typeArguments: f2 !== NULL ? node(f2) : null };
     case 139: return { type: "TSEnumDeclaration", start, end, id: f1 !== NULL ? node(f1) : null, body: f2 !== NULL ? node(f2) : null, const: !!(flags & 1), declare: !!(flags & 2) };
-    case 140: return { type: "TSEnumBody", start, end, members: nodeArr(f1, f0) };
+    case 140: return { type: "TSEnumBody", start, end, get members() { const v = nodeArr(f1, f0); _def(this, "members", v); return v; } };
     case 141: return { type: "TSEnumMember", start, end, id: f1 !== NULL ? node(f1) : null, initializer: f2 !== NULL ? node(f2) : null, computed: !!(flags & 1) };
     case 142: { const r = { type: "TSModuleDeclaration", start, end, id: node(f1), kind: TS_MODULE_KINDS[(flags >> 0) & 1], declare: !!(flags & 2), global: false }; if (f2 !== NULL) r.body = node(f2); return r; }
-    case 143: return { type: "TSModuleBlock", start, end, body: nodeArr(f1, f0) };
+    case 143: return { type: "TSModuleBlock", start, end, get body() { const v = nodeArr(f1, f0); _def(this, "body", v); return v; } };
     case 144: return { type: "TSModuleDeclaration", start, end, id: node(f1), body: node(f2), kind: "global", declare: !!(flags & 1), global: true };
     case 145: { const r = { type: "TSParameterProperty", start, end, decorators: nodeArr(f1, f0), parameter: f2 !== NULL ? node(f2) : null, override: !!(flags & 1), readonly: !!(flags & 2), accessibility: ACCESSIBILITY[(flags >> 2) & 3] }; if (_isTs) { r.static = false; } return r; }
     case 146: return { type: "Identifier", start, end, decorators: [], name: "this", optional: false, typeAnnotation: f1 !== NULL ? node(f1) : null };
@@ -300,6 +300,7 @@ function decode(buffer, source) {
     }
     diagnostics[j] = { severity: sev, message: msg, start: ds, end: de, help, labels };
   }
+  function _def(o, k, v) { Object.defineProperty(o, k, { value: v, writable: true, enumerable: true, configurable: true }); }
   return { program: node(progIdx), comments, diagnostics };
 }
 export { decode };

package/index.d.ts

@@ -100,6 +100,25 @@ interface ParseResult {
  */
 export function parse(source: string, options?: ParseOptions): ParseResult;
 
+/**
+ * Resolves a {@link SourceLang} from a file path's extension.
+ *
+ * - `.d.ts`, `.d.mts`, `.d.cts` → `"dts"`
+ * - `.tsx` → `"tsx"`
+ * - `.ts`, `.mts`, `.cts` → `"ts"`
+ * - `.jsx` → `"jsx"`
+ * - everything else → `"js"`
+ */
+export function langFromPath(path: string): SourceLang;
+
+/**
+ * Resolves a {@link SourceType} from a file path's extension.
+ *
+ * - `.cjs`, `.cts` → `"script"`
+ * - everything else → `"module"`
+ */
+export function sourceTypeFromPath(path: string): SourceType;
+
 // AST node types
 
 interface BaseNode {

package/index.js

@@ -24,3 +24,16 @@ export function parse(source, options) {
     },
   };
 }
+
+export function langFromPath(path) {
+  if (path.endsWith(".d.ts") || path.endsWith(".d.mts") || path.endsWith(".d.cts")) return "dts";
+  if (path.endsWith(".tsx")) return "tsx";
+  if (path.endsWith(".ts") || path.endsWith(".mts") || path.endsWith(".cts")) return "ts";
+  if (path.endsWith(".jsx")) return "jsx";
+  return "js";
+}
+
+export function sourceTypeFromPath(path) {
+  if (path.endsWith(".cjs") || path.endsWith(".cts")) return "script";
+  return "module";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuku-parser",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "High-performance JavaScript/TypeScript parser",
   "license": "MIT",
   "type": "module",
@@ -13,17 +13,17 @@
     "decode.js"
   ],
   "optionalDependencies": {
-    "@yuku-parser/binding-linux-x64-gnu": "0.5.3",
-    "@yuku-parser/binding-linux-arm64-gnu": "0.5.3",
-    "@yuku-parser/binding-linux-arm-gnu": "0.5.3",
-    "@yuku-parser/binding-linux-x64-musl": "0.5.3",
-    "@yuku-parser/binding-linux-arm64-musl": "0.5.3",
-    "@yuku-parser/binding-linux-arm-musl": "0.5.3",
-    "@yuku-parser/binding-darwin-x64": "0.5.3",
-    "@yuku-parser/binding-darwin-arm64": "0.5.3",
-    "@yuku-parser/binding-win32-x64": "0.5.3",
-    "@yuku-parser/binding-win32-arm64": "0.5.3",
-    "@yuku-parser/binding-freebsd-x64": "0.5.3"
+    "@yuku-parser/binding-linux-x64-gnu": "0.5.4",
+    "@yuku-parser/binding-linux-arm64-gnu": "0.5.4",
+    "@yuku-parser/binding-linux-arm-gnu": "0.5.4",
+    "@yuku-parser/binding-linux-x64-musl": "0.5.4",
+    "@yuku-parser/binding-linux-arm64-musl": "0.5.4",
+    "@yuku-parser/binding-linux-arm-musl": "0.5.4",
+    "@yuku-parser/binding-darwin-x64": "0.5.4",
+    "@yuku-parser/binding-darwin-arm64": "0.5.4",
+    "@yuku-parser/binding-win32-x64": "0.5.4",
+    "@yuku-parser/binding-win32-arm64": "0.5.4",
+    "@yuku-parser/binding-freebsd-x64": "0.5.4"
   },
   "keywords": [
     "parser",