@veryfront/ext-parser-babel 0.1.1185 → 0.1.1189

package/README.md

@@ -25,6 +25,15 @@ export default defineConfig({
 
 Core's `src/transforms/plugins/babel-node-positions.ts` is a thin shim that resolves this contract at call time. When the extension is not installed and the shim is invoked, Veryfront throws an install-suggestion error directing the user to add `@veryfront/ext-parser-babel`.
 
+## Parser-only entry
+
+Permission-constrained workers that only need AST parsing can import
+`BabelParseOnlyParser` from `@veryfront/ext-parser-babel/parser-only`. This
+entry preserves the full parser's language and file-extension behavior without
+loading Babel traversal, code generation, JSX transformation, extension
+lifecycle, or debug dependencies. It does not read environment variables or
+request filesystem/network permissions.
+
 ## Configuration
 
-No factory options. The extension reads no environment variables and takes no config.
+No factory options. The extension takes no config.

package/esm/index.d.ts

@@ -14,9 +14,9 @@
  * @module extensions/ext-parser-babel
  */
 import type { ExtensionFactory } from "veryfront/extensions";
-import type { ASTNode, CodeParser, FunctionDirectiveOptions, GenerateOptions, GenerateResult, InjectJsxNodePositionsOptions, ParseOptions, TraverseVisitor } from "veryfront/extensions/parser";
-declare class BabelCodeParser implements CodeParser {
-    parse(options: ParseOptions): Promise<ASTNode>;
+import type { ASTNode, CodeParser, FunctionDirectiveOptions, GenerateOptions, GenerateResult, InjectJsxNodePositionsOptions, TraverseVisitor } from "veryfront/extensions/parser";
+import { BabelParseOnlyParser } from "./parser-only.js";
+declare class BabelCodeParser extends BabelParseOnlyParser implements CodeParser {
     traverse(ast: ASTNode, visitor: TraverseVisitor): void;
     generate(ast: ASTNode, options?: GenerateOptions): Promise<GenerateResult>;
     hasFunctionDirective(options: FunctionDirectiveOptions): Promise<boolean>;

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,6BAA6B,EAC7B,YAAY,EACZ,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAsErC,cAAM,eAAgB,YAAW,UAAU;IACzC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAS9C,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAItD,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAWpE,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC;IAY/E,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,6BAA6B,GAAG,MAAM;CAGvF;AAED,QAAA,MAAM,QAAQ,EAAE,gBAiBf,CAAC;AAEF,eAAe,QAAQ,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,6BAA6B,EAC7B,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAwDxD,cAAM,eAAgB,SAAQ,oBAAqB,YAAW,UAAU;IACtE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAItD,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAWpE,oBAAoB,CACxB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC;IAcnB,sBAAsB,CACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,6BAA6B,GACrC,MAAM;CAGV;AAED,QAAA,MAAM,QAAQ,EAAE,gBAiBf,CAAC;AAEF,eAAe,QAAQ,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/esm/index.js

@@ -13,10 +13,10 @@
  *
  * @module extensions/ext-parser-babel
  */
-import * as parser from "@babel/parser";
 import * as traverseModule from "@babel/traverse";
 import * as generateModule from "@babel/generator";
 import { injectNodePositions } from "./inject-node-positions.js";
+import { BabelParseOnlyParser } from "./parser-only.js";
 function resolveDefaultExport(mod) {
     const m = mod;
     if (typeof m.default === "function")
@@ -41,41 +41,13 @@ function isRecord(value) {
 }
 function functionHasDirective(node, directive) {
     const body = node.body;
-    if (!isRecord(body) || body.type !== "BlockStatement" || !Array.isArray(body.directives)) {
+    if (!isRecord(body) || body.type !== "BlockStatement" ||
+        !Array.isArray(body.directives)) {
         return false;
     }
     return body.directives.some((entry) => isRecord(entry) && isRecord(entry.value) && entry.value.value === directive);
 }
-function pickPlugins(filePath) {
-    const normalizedPath = filePath?.toLowerCase() ?? "";
-    const isTypeScript = /\.(?:tsx?|[cm]ts)$/.test(normalizedPath);
-    const supportsJsx = !filePath || /\.(?:tsx|jsx|js|mjs|cjs)$/.test(normalizedPath);
-    const plugins = [
-        "classProperties",
-        "classPrivateProperties",
-        "classPrivateMethods",
-        "decorators-legacy",
-        "decoratorAutoAccessors",
-        "deprecatedImportAssert",
-        "dynamicImport",
-        "importAttributes",
-        "topLevelAwait",
-    ];
-    if (isTypeScript || !filePath)
-        plugins.push("typescript");
-    if (supportsJsx)
-        plugins.push("jsx");
-    return plugins;
-}
-class BabelCodeParser {
-    parse(options) {
-        const ast = parser.parse(options.code, {
-            sourceType: "unambiguous",
-            allowReturnOutsideFunction: options.filePath?.toLowerCase().endsWith(".cjs") === true,
-            plugins: pickPlugins(options.filePath),
-        });
-        return Promise.resolve(ast);
-    }
+class BabelCodeParser extends BabelParseOnlyParser {
     traverse(ast, visitor) {
         traverse(ast, visitor);
     }
@@ -93,8 +65,9 @@ class BabelCodeParser {
         const ast = await this.parse(options);
         let found = false;
         const visit = (path) => {
-            if (!found && functionHasDirective(path.node, options.directive))
+            if (!found && functionHasDirective(path.node, options.directive)) {
                 found = true;
+            }
         };
         const visitor = {};
         for (const nodeType of FUNCTION_NODE_TYPES)

package/esm/parser-only.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Parser-only Babel entry for permission-constrained workers.
+ *
+ * This module deliberately imports only `@babel/parser`. In particular, it
+ * must remain independent of the full extension entry's traversal, generation,
+ * JSX transformation, extension lifecycle, and environment-sensitive debug
+ * dependency graphs.
+ *
+ * @module extensions/ext-parser-babel/parser-only
+ */
+import type { ASTNode, ParseOptions } from "veryfront/extensions/parser";
+/** The parse-only subset shared with the full `CodeParser` contract. */
+export interface BabelParseOnlyParserContract {
+    /** Parse source code into a Babel-compatible abstract syntax tree. */
+    parse(options: ParseOptions): Promise<ASTNode>;
+}
+/**
+ * Babel-backed parser with the same parse behavior as {@link BabelCodeParser},
+ * without loading traversal, generation, or extension runtime dependencies.
+ */
+export declare class BabelParseOnlyParser implements BabelParseOnlyParserContract {
+    parse(options: ParseOptions): Promise<ASTNode>;
+}
+//# sourceMappingURL=parser-only.d.ts.map

package/esm/parser-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-only.d.ts","sourceRoot":"","sources":["../src/parser-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEzE,wEAAwE;AACxE,MAAM,WAAW,4BAA4B;IAC3C,sEAAsE;IACtE,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAuBD;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,4BAA4B;IACvE,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ/C"}

package/esm/parser-only.js

@@ -0,0 +1,47 @@
+/**
+ * Parser-only Babel entry for permission-constrained workers.
+ *
+ * This module deliberately imports only `@babel/parser`. In particular, it
+ * must remain independent of the full extension entry's traversal, generation,
+ * JSX transformation, extension lifecycle, and environment-sensitive debug
+ * dependency graphs.
+ *
+ * @module extensions/ext-parser-babel/parser-only
+ */
+import * as parser from "@babel/parser";
+function pickPlugins(filePath) {
+    const normalizedPath = filePath?.toLowerCase() ?? "";
+    const isTypeScript = /\.(?:tsx?|[cm]ts)$/.test(normalizedPath);
+    const supportsJsx = !filePath ||
+        /\.(?:tsx|jsx|js|mjs|cjs)$/.test(normalizedPath);
+    const plugins = [
+        "classProperties",
+        "classPrivateProperties",
+        "classPrivateMethods",
+        "decorators-legacy",
+        "decoratorAutoAccessors",
+        "deprecatedImportAssert",
+        "dynamicImport",
+        "importAttributes",
+        "topLevelAwait",
+    ];
+    if (isTypeScript || !filePath)
+        plugins.push("typescript");
+    if (supportsJsx)
+        plugins.push("jsx");
+    return plugins;
+}
+/**
+ * Babel-backed parser with the same parse behavior as {@link BabelCodeParser},
+ * without loading traversal, generation, or extension runtime dependencies.
+ */
+export class BabelParseOnlyParser {
+    parse(options) {
+        const ast = parser.parse(options.code, {
+            sourceType: "unambiguous",
+            allowReturnOutsideFunction: options.filePath?.toLowerCase().endsWith(".cjs") === true,
+            plugins: pickPlugins(options.filePath),
+        });
+        return Promise.resolve(ast);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veryfront/ext-parser-babel",
-  "version": "0.1.1185",
+  "version": "0.1.1189",
   "description": "Veryfront first-party extension package for ext-parser-babel",
   "keywords": [
     "veryfront",
@@ -23,11 +23,15 @@
     ".": {
       "import": "./esm/index.js",
       "types": "./esm/index.d.ts"
+    },
+    "./parser-only": {
+      "import": "./esm/parser-only.js",
+      "types": "./esm/parser-only.d.ts"
     }
   },
   "scripts": {},
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.3.0"
   },
   "publishConfig": {
     "access": "public"
@@ -48,7 +52,7 @@
     "@babel/types": "7.29.0"
   },
   "peerDependencies": {
-    "veryfront": "^0.1.1185"
+    "veryfront": "^0.1.1189"
   },
   "type": "module",
   "types": "./esm/index.d.ts",