yuku-ast 0.8.6 → 0.8.7

package/README.md

@@ -106,6 +106,7 @@ import {
   nameOf,          // Identifier name or string Literal value
   literalValue,    // string | number | boolean | bigint | RegExp | null
   unwrap,          // strips parens and erased TS assertion wrappers
+  isWrapper,       // true for the wrappers unwrap strips
   isCallOf,        // isCallOf(node, "require")
   bindingIdentifiers, // every binding Identifier a pattern introduces
   findAll,         // findAll(program, "CallExpression")

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _yuku_toolchain_types0 from "@yuku-toolchain/types";
-import { BigIntLiteral, BindingPattern, BooleanLiteral, CallExpression, ComputedMemberExpression, Directive, ExportAllDeclaration, ExportDefaultDeclaration, ExportNamedDeclaration, ExportSpecifier, Expression, Identifier, ImportDeclaration, ImportDeclarationSpecifier, ImportPhase, Node, NodeOfType, NodeType, NullLiteral, NumericLiteral, PrivateFieldExpression, Program, RegExpLiteral, StaticMemberExpression, StringLiteral } from "@yuku-toolchain/types";
+import { BigIntLiteral, BindingPattern, BooleanLiteral, CallExpression, ComputedMemberExpression, Directive, ExportAllDeclaration, ExportDefaultDeclaration, ExportNamedDeclaration, ExportSpecifier, Expression, Identifier, ImportDeclaration, ImportDeclarationSpecifier, ImportPhase, Node, NodeOfType, NodeType, NullLiteral, NumericLiteral, ParenthesizedExpression, PrivateFieldExpression, Program, RegExpLiteral, StaticMemberExpression, StringLiteral, TSAsExpression, TSNonNullExpression, TSSatisfiesExpression, TSTypeAssertion } from "@yuku-toolchain/types";
 
 //#region src/aliases.d.ts
 declare const ALIAS_GROUPS: {
@@ -418,6 +418,20 @@ declare function nameOf(node: MaybeNode): string | null;
  * non-literal nodes.
  */
 declare function literalValue(node: MaybeNode): string | number | boolean | bigint | RegExp | null | undefined;
+/**
+ * An expression that only wraps another one: parentheses and the
+ * TypeScript assertion forms erased on the way to JavaScript.
+ */
+type Wrapper = ParenthesizedExpression | TSAsExpression | TSSatisfiesExpression | TSNonNullExpression | TSTypeAssertion;
+/**
+ * True when `node` is a {@link Wrapper}, the expressions {@link unwrap}
+ * strips to reach the one that carries the meaning. Its `expression` is
+ * the node underneath.
+ *
+ * @example
+ * isWrapper(node) ? node.expression : node
+ */
+declare function isWrapper(node: MaybeNode): node is Wrapper;
 /**
  * The expression inside parentheses and erased TypeScript assertion
  * wrappers: `((x as any))!` unwraps to `x`. Returns the node itself
@@ -490,4 +504,4 @@ type AsyncVisitors<S = unknown> = { [K in NodeType]?: AsyncWalkHandler<NodeOfTyp
 declare function _walk(root: Node, visitors: Visitors<never> | AsyncVisitors<never>, state: unknown, ctx: WalkContext): void;
 declare function _walkAsync(root: Node, visitors: AsyncVisitors<never>, state: unknown, ctx: WalkContext): Promise<void>;
 //#endregion
-export { ALIAS_GROUPS, ALIAS_NAMES, type AliasMap, type AliasName, type AsyncVisitors, type AsyncWalkHandler, type AsyncWalkHooks, CHILD_KEYS, type CollectedExport, type CollectedImport, NODE_TYPES, type Visitors, WalkContext, type WalkHandler, type WalkHooks, _walk, _walkAsync, b, bindingIdentifiers, collectExportDeclaration, collectExports, collectImportDeclaration, collectImports, findAll, is, isCallOf, isIdentifierChar, isIdentifierName, isIdentifierStart, isKeyword, isReservedWord, isStrictBindOnlyReservedWord, isStrictBindReservedWord, isStrictReservedWord, isValidIdentifier, literalValue, nameOf, unwrap, walk, walkAsync };
+export { ALIAS_GROUPS, ALIAS_NAMES, type AliasMap, type AliasName, type AsyncVisitors, type AsyncWalkHandler, type AsyncWalkHooks, CHILD_KEYS, type CollectedExport, type CollectedImport, NODE_TYPES, type Visitors, WalkContext, type WalkHandler, type WalkHooks, type Wrapper, _walk, _walkAsync, b, bindingIdentifiers, collectExportDeclaration, collectExports, collectImportDeclaration, collectImports, findAll, is, isCallOf, isIdentifierChar, isIdentifierName, isIdentifierStart, isKeyword, isReservedWord, isStrictBindOnlyReservedWord, isStrictBindReservedWord, isStrictReservedWord, isValidIdentifier, isWrapper, literalValue, nameOf, unwrap, walk, walkAsync };

package/dist/index.js

@@ -1229,8 +1229,16 @@ const WRAPPERS = new Set([
 	"TSNonNullExpression",
 	"TSTypeAssertion"
 ]);
+/**
+* True when `node` is a {@link Wrapper}, the expressions {@link unwrap}
+* strips to reach the one that carries the meaning. Its `expression` is
+* the node underneath.
+*
+* @example
+* isWrapper(node) ? node.expression : node
+*/
 function isWrapper(node) {
-	return WRAPPERS.has(node.type);
+	return node != null && WRAPPERS.has(node.type);
 }
 /**
 * The expression inside parentheses and erased TypeScript assertion
@@ -1390,4 +1398,4 @@ function declaredNames(declaration) {
 }
 
 //#endregion
-export { ALIAS_GROUPS, ALIAS_NAMES, CHILD_KEYS, NODE_TYPES, WalkContext, _walk, _walkAsync, b, bindingIdentifiers, collectExportDeclaration, collectExports, collectImportDeclaration, collectImports, findAll, is, isCallOf, isIdentifierChar, isIdentifierName, isIdentifierStart, isKeyword, isReservedWord, isStrictBindOnlyReservedWord, isStrictBindReservedWord, isStrictReservedWord, isValidIdentifier, literalValue, nameOf, unwrap, walk, walkAsync };
+export { ALIAS_GROUPS, ALIAS_NAMES, CHILD_KEYS, NODE_TYPES, WalkContext, _walk, _walkAsync, b, bindingIdentifiers, collectExportDeclaration, collectExports, collectImportDeclaration, collectImports, findAll, is, isCallOf, isIdentifierChar, isIdentifierName, isIdentifierStart, isKeyword, isReservedWord, isStrictBindOnlyReservedWord, isStrictBindReservedWord, isStrictReservedWord, isValidIdentifier, isWrapper, literalValue, nameOf, unwrap, walk, walkAsync };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuku-ast",
-  "version": "0.8.6",
+  "version": "0.8.7",
   "description": "Typed AST toolkit for JavaScript and TypeScript ESTree trees: walker, builders, guards, and syntactic utilities",
   "license": "MIT",
   "repository": {
@@ -21,7 +21,7 @@
     "build": "tsdown"
   },
   "dependencies": {
-    "@yuku-toolchain/types": "^0.8.6"
+    "@yuku-toolchain/types": "^0.8.7"
   },
   "devDependencies": {
     "tsdown": "^0.15.6"