ember-estree 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ember-estree",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "ESTree generator for gjs and gts file used by ember",
   "keywords": [
     "AST",

package/src/index.d.ts

@@ -93,3 +93,12 @@ export function print(node: ASTNode): string;
  * @returns A map of Glimmer node type names to arrays of child-property names.
  */
 export function buildGlimmerVisitorKeys(): Record<string, string[]>;
+
+/**
+ * Recursively remove all `parent` references from an AST.
+ * Useful when you need to serialize the tree to JSON,
+ * since parent back-references create circular structures.
+ *
+ * Mutates the tree in place and returns it.
+ */
+export function removeParentReferences(ast: ASTNode): ASTNode;

package/src/index.js

@@ -1,3 +1,4 @@
 export { toTree, parse } from "./parse.js";
 export { print } from "./print.js";
 export { buildGlimmerVisitorKeys, DocumentLines } from "./transforms.js";
+export { removeParentReferences } from "./utils.js";

package/src/transforms.js

@@ -221,10 +221,5 @@ export function processGlimmerTemplate(templateAST, { contentOffset, templateRan
     comment.type = "Block";
   }
 
-  // Clear parent references (they cause circular JSON issues)
-  for (const n of allNodes) {
-    n.parent = null;
-  }
-
   return templateAST;
 }

package/src/utils.js

@@ -0,0 +1,22 @@
+/**
+ * Optional utility functions for working with ESTree ASTs
+ * produced by ember-estree.
+ */
+
+import { walk } from "zimmerframe";
+
+/**
+ * Recursively remove all `parent` references from an AST.
+ * Useful when you need to serialize the tree to JSON (e.g. for zmod),
+ * since parent back-references create circular structures.
+ *
+ * Mutates the tree in place and returns it.
+ */
+export function removeParentReferences(ast) {
+  return walk(ast, null, {
+    _(node, { next }) {
+      delete node.parent;
+      next();
+    },
+  });
+}