@ -1,35 +1,36 @@
/** @import * as ESTree from 'estree' */
import { regex _is _valid _identifier } from '../phases/patterns.js' ; import { regex _is _valid _identifier } from '../phases/patterns.js' ;
import { sanitize _template _string } from './sanitize_template_string.js' ; import { sanitize _template _string } from './sanitize_template_string.js' ;
/ * * / * *
* @ param { Array < import ( 'estree' ) . Expression | import ( 'estree' ) . SpreadElement | null > } elements
* @ param { Array < ESTree . Expression | ESTree . SpreadElement | null > } elements
* @ returns { import ( 'estree' ) . ArrayExpression }
* @ returns { ESTree . ArrayExpression }
* /
* /
export function array ( elements = [ ] ) { export function array ( elements = [ ] ) {
return { type : 'ArrayExpression' , elements } ;
return { type : 'ArrayExpression' , elements } ;
} }
/ * * / * *
* @ param { Array < import ( 'estree' ) . Pattern | null > } elements
* @ param { Array < ESTree . Pattern | null > } elements
* @ returns { import ( 'estree' ) . ArrayPattern }
* @ returns { ESTree . ArrayPattern }
* /
* /
export function array _pattern ( elements ) { export function array _pattern ( elements ) {
return { type : 'ArrayPattern' , elements } ;
return { type : 'ArrayPattern' , elements } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Pattern } left
* @ param { ESTree . Pattern } left
* @ param { import ( 'estree' ) . Expression } right
* @ param { ESTree . Expression } right
* @ returns { import ( 'estree' ) . AssignmentPattern }
* @ returns { ESTree . AssignmentPattern }
* /
* /
export function assignment _pattern ( left , right ) { export function assignment _pattern ( left , right ) {
return { type : 'AssignmentPattern' , left , right } ;
return { type : 'AssignmentPattern' , left , right } ;
} }
/ * * / * *
* @ param { Array < import ( 'estree' ) . Pattern > } params
* @ param { Array < ESTree . Pattern > } params
* @ param { import ( 'estree' ) . BlockStatement | import ( 'estree' ) . Expression } body
* @ param { ESTree . BlockStatement | ESTree . Expression } body
* @ returns { import ( 'estree' ) . ArrowFunctionExpression }
* @ returns { ESTree . ArrowFunctionExpression }
* /
* /
export function arrow ( params , body ) { export function arrow ( params , body ) {
return {
return {
@ -44,10 +45,10 @@ export function arrow(params, body) {
} }
/ * * / * *
* @ param { import ( 'estree' ) . AssignmentOperator } operator
* @ param { ESTree . AssignmentOperator } operator
* @ param { import ( 'estree' ) . Pattern } left
* @ param { ESTree . Pattern } left
* @ param { import ( 'estree' ) . Expression } right
* @ param { ESTree . Expression } right
* @ returns { import ( 'estree' ) . AssignmentExpression }
* @ returns { ESTree . AssignmentExpression }
* /
* /
export function assignment ( operator , left , right ) { export function assignment ( operator , left , right ) {
return { type : 'AssignmentExpression' , operator , left , right } ;
return { type : 'AssignmentExpression' , operator , left , right } ;
@ -55,34 +56,34 @@ export function assignment(operator, left, right) {
/ * * / * *
* @ template T
* @ template T
* @ param { T & import ( 'estree' ) . BaseFunction } func
* @ param { T & ESTree . BaseFunction } func
* @ returns { T & import ( 'estree' ) . BaseFunction }
* @ returns { T & ESTree . BaseFunction }
* /
* /
export function async ( func ) { export function async ( func ) {
return { ... func , async : true } ;
return { ... func , async : true } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression } argument
* @ param { ESTree . Expression } argument
* @ returns { import ( 'estree' ) . AwaitExpression }
* @ returns { ESTree . AwaitExpression }
* /
* /
function await _builder ( argument ) { function await _builder ( argument ) {
return { type : 'AwaitExpression' , argument } ;
return { type : 'AwaitExpression' , argument } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . BinaryOperator } operator
* @ param { ESTree . BinaryOperator } operator
* @ param { import ( 'estree' ) . Expression } left
* @ param { ESTree . Expression } left
* @ param { import ( 'estree' ) . Expression } right
* @ param { ESTree . Expression } right
* @ returns { import ( 'estree' ) . BinaryExpression }
* @ returns { ESTree . BinaryExpression }
* /
* /
export function binary ( operator , left , right ) { export function binary ( operator , left , right ) {
return { type : 'BinaryExpression' , operator , left , right } ;
return { type : 'BinaryExpression' , operator , left , right } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Statement [ ] } body
* @ param { ESTree . Statement [ ] } body
* @ returns { import ( 'estree' ) . BlockStatement }
* @ returns { ESTree . BlockStatement }
* /
* /
export function block ( body ) { export function block ( body ) {
return { type : 'BlockStatement' , body } ;
return { type : 'BlockStatement' , body } ;
@ -90,17 +91,17 @@ export function block(body) {
/ * * / * *
* @ param { string } name
* @ param { string } name
* @ param { import ( 'estree' ) . Statement } body
* @ param { ESTree . Statement } body
* @ returns { import ( 'estree' ) . LabeledStatement }
* @ returns { ESTree . LabeledStatement }
* /
* /
export function labeled ( name , body ) { export function labeled ( name , body ) {
return { type : 'LabeledStatement' , label : id ( name ) , body } ;
return { type : 'LabeledStatement' , label : id ( name ) , body } ;
} }
/ * * / * *
* @ param { string | import ( 'estree' ) . Expression } callee
* @ param { string | ESTree . Expression } callee
* @ param { ... ( import ( 'estree' ) . Expression | import ( 'estree' ) . SpreadElement | false | undefined ) } args
* @ param { ... ( ESTree . Expression | ESTree . SpreadElement | false | undefined ) } args
* @ returns { import ( 'estree' ) . CallExpression }
* @ returns { ESTree . CallExpression }
* /
* /
export function call ( callee , ... args ) { export function call ( callee , ... args ) {
if ( typeof callee === 'string' ) callee = id ( callee ) ;
if ( typeof callee === 'string' ) callee = id ( callee ) ;
@ -124,20 +125,18 @@ export function call(callee, ...args) {
return {
return {
type : 'CallExpression' ,
type : 'CallExpression' ,
callee ,
callee ,
arguments : /** @type {Array<import('estree').Expression | import('estree').SpreadElement>} */ (
arguments : /** @type {Array<ESTree.Expression | ESTree.SpreadElement>} */ ( args ) ,
args
) ,
optional : false
optional : false
} ;
} ;
} }
/ * * / * *
* @ param { string | import ( 'estree' ) . Expression } callee
* @ param { string | ESTree . Expression } callee
* @ param { ... import ( 'estree' ) . Expression } args
* @ param { ... ESTree . Expression } args
* @ returns { import ( 'estree' ) . ChainExpression }
* @ returns { ESTree . ChainExpression }
* /
* /
export function maybe _call ( callee , ... args ) { export function maybe _call ( callee , ... args ) {
const expression = /** @type { import('estree') .SimpleCallExpression} */ ( call ( callee , ... args ) ) ;
const expression = /** @type { ESTree .SimpleCallExpression} */ ( call ( callee , ... args ) ) ;
expression . optional = true ;
expression . optional = true ;
return {
return {
@ -147,29 +146,29 @@ export function maybe_call(callee, ...args) {
} }
/ * * / * *
* @ param { import ( 'estree' ) . UnaryOperator } operator
* @ param { ESTree . UnaryOperator } operator
* @ param { import ( 'estree' ) . Expression } argument
* @ param { ESTree . Expression } argument
* @ returns { import ( 'estree' ) . UnaryExpression }
* @ returns { ESTree . UnaryExpression }
* /
* /
export function unary ( operator , argument ) { export function unary ( operator , argument ) {
return { type : 'UnaryExpression' , argument , operator , prefix : true } ;
return { type : 'UnaryExpression' , argument , operator , prefix : true } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression } test
* @ param { ESTree . Expression } test
* @ param { import ( 'estree' ) . Expression } consequent
* @ param { ESTree . Expression } consequent
* @ param { import ( 'estree' ) . Expression } alternate
* @ param { ESTree . Expression } alternate
* @ returns { import ( 'estree' ) . ConditionalExpression }
* @ returns { ESTree . ConditionalExpression }
* /
* /
export function conditional ( test , consequent , alternate ) { export function conditional ( test , consequent , alternate ) {
return { type : 'ConditionalExpression' , test , consequent , alternate } ;
return { type : 'ConditionalExpression' , test , consequent , alternate } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . LogicalOperator } operator
* @ param { ESTree . LogicalOperator } operator
* @ param { import ( 'estree' ) . Expression } left
* @ param { ESTree . Expression } left
* @ param { import ( 'estree' ) . Expression } right
* @ param { ESTree . Expression } right
* @ returns { import ( 'estree' ) . LogicalExpression }
* @ returns { ESTree . LogicalExpression }
* /
* /
export function logical ( operator , left , right ) { export function logical ( operator , left , right ) {
return { type : 'LogicalExpression' , operator , left , right } ;
return { type : 'LogicalExpression' , operator , left , right } ;
@ -177,9 +176,9 @@ export function logical(operator, left, right) {
/ * * / * *
* @ param { 'const' | 'let' | 'var' } kind
* @ param { 'const' | 'let' | 'var' } kind
* @ param { string | import ( 'estree' ) . Pattern } pattern
* @ param { string | ESTree . Pattern } pattern
* @ param { import ( 'estree' ) . Expression } [ init ]
* @ param { ESTree . Expression } [ init ]
* @ returns { import ( 'estree' ) . VariableDeclaration }
* @ returns { ESTree . VariableDeclaration }
* /
* /
export function declaration ( kind , pattern , init ) { export function declaration ( kind , pattern , init ) {
if ( typeof pattern === 'string' ) pattern = id ( pattern ) ;
if ( typeof pattern === 'string' ) pattern = id ( pattern ) ;
@ -192,32 +191,32 @@ export function declaration(kind, pattern, init) {
} }
/ * * / * *
* @ param { import ( 'estree' ) . Pattern } id
* @ param { ESTree . Pattern } id
* @ param { import ( 'estree' ) . Expression } [ init ]
* @ param { ESTree . Expression } [ init ]
* @ returns { import ( 'estree' ) . VariableDeclarator }
* @ returns { ESTree . VariableDeclarator }
* /
* /
export function declarator ( id , init ) { export function declarator ( id , init ) {
return { type : 'VariableDeclarator' , id , init } ;
return { type : 'VariableDeclarator' , id , init } ;
} }
/** @type { import('estree') .EmptyStatement} *//** @type { ESTree .EmptyStatement} */
export const empty = { export const empty = {
type : 'EmptyStatement'
type : 'EmptyStatement'
} ; } ;
/ * * / * *
* @ param { import ( 'estree' ) . Expression | import ( 'estree' ) . MaybeNamedClassDeclaration | import ( 'estree' ) . MaybeNamedFunctionDeclaration } declaration
* @ param { ESTree . Expression | ESTree . MaybeNamedClassDeclaration | ESTree . MaybeNamedFunctionDeclaration } declaration
* @ returns { import ( 'estree' ) . ExportDefaultDeclaration }
* @ returns { ESTree . ExportDefaultDeclaration }
* /
* /
export function export _default ( declaration ) { export function export _default ( declaration ) {
return { type : 'ExportDefaultDeclaration' , declaration } ;
return { type : 'ExportDefaultDeclaration' , declaration } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Identifier } id
* @ param { ESTree . Identifier } id
* @ param { import ( 'estree' ) . Pattern [ ] } params
* @ param { ESTree . Pattern [ ] } params
* @ param { import ( 'estree' ) . BlockStatement } body
* @ param { ESTree . BlockStatement } body
* @ returns { import ( 'estree' ) . FunctionDeclaration }
* @ returns { ESTree . FunctionDeclaration }
* /
* /
export function function _declaration ( id , params , body ) { export function function _declaration ( id , params , body ) {
return {
return {
@ -233,8 +232,8 @@ export function function_declaration(id, params, body) {
/ * * / * *
* @ param { string } name
* @ param { string } name
* @ param { import ( 'estree' ) . Statement [ ] } body
* @ param { ESTree . Statement [ ] } body
* @ returns { import ( 'estree' ) . Property & { value : import ( 'estree' ) . FunctionExpression } } }
* @ returns { ESTree . Property & { value : ESTree . FunctionExpression } } }
* /
* /
export function get ( name , body ) { export function get ( name , body ) {
return prop ( 'get' , key ( name ) , function _builder ( null , [ ] , block ( body ) ) ) ;
return prop ( 'get' , key ( name ) , function _builder ( null , [ ] , block ( body ) ) ) ;
@ -242,7 +241,7 @@ export function get(name, body) {
/ * * / * *
* @ param { string } name
* @ param { string } name
* @ returns { import ( 'estree' ) . Identifier }
* @ returns { ESTree . Identifier }
* /
* /
export function id ( name ) { export function id ( name ) {
return { type : 'Identifier' , name } ;
return { type : 'Identifier' , name } ;
@ -250,7 +249,7 @@ export function id(name) {
/ * * / * *
* @ param { string } name
* @ param { string } name
* @ returns { import ( 'estree' ) . PrivateIdentifier }
* @ returns { ESTree . PrivateIdentifier }
* /
* /
export function private _id ( name ) { export function private _id ( name ) {
return { type : 'PrivateIdentifier' , name } ;
return { type : 'PrivateIdentifier' , name } ;
@ -258,7 +257,7 @@ export function private_id(name) {
/ * * / * *
* @ param { string } local
* @ param { string } local
* @ returns { import ( 'estree' ) . ImportNamespaceSpecifier }
* @ returns { ESTree . ImportNamespaceSpecifier }
* /
* /
function import _namespace ( local ) { function import _namespace ( local ) {
return {
return {
@ -269,8 +268,8 @@ function import_namespace(local) {
/ * * / * *
* @ param { string } name
* @ param { string } name
* @ param { import ( 'estree' ) . Expression } value
* @ param { ESTree . Expression } value
* @ returns { import ( 'estree' ) . Property }
* @ returns { ESTree . Property }
* /
* /
export function init ( name , value ) { export function init ( name , value ) {
return prop ( 'init' , key ( name ) , value ) ;
return prop ( 'init' , key ( name ) , value ) ;
@ -278,7 +277,7 @@ export function init(name, value) {
/ * * / * *
* @ param { string | boolean | null | number | RegExp } value
* @ param { string | boolean | null | number | RegExp } value
* @ returns { import ( 'estree' ) . Literal }
* @ returns { ESTree . Literal }
* /
* /
export function literal ( value ) { export function literal ( value ) {
// @ts-expect-error we don't want to muck around with bigint here
// @ts-expect-error we don't want to muck around with bigint here
@ -286,11 +285,11 @@ export function literal(value) {
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression | import ( 'estree' ) . Super } object
* @ param { ESTree . Expression | ESTree . Super } object
* @ param { import ( 'estree' ) . Expression | import ( 'estree' ) . PrivateIdentifier } property
* @ param { ESTree . Expression | ESTree . PrivateIdentifier } property
* @ param { boolean } computed
* @ param { boolean } computed
* @ param { boolean } optional
* @ param { boolean } optional
* @ returns { import ( 'estree' ) . MemberExpression }
* @ returns { ESTree . MemberExpression }
* /
* /
export function member ( object , property , computed = false , optional = false ) { export function member ( object , property , computed = false , optional = false ) {
return { type : 'MemberExpression' , object , property , computed , optional } ;
return { type : 'MemberExpression' , object , property , computed , optional } ;
@ -298,12 +297,12 @@ export function member(object, property, computed = false, optional = false) {
/ * * / * *
* @ param { string } path
* @ param { string } path
* @ returns { import ( 'estree' ) . Identifier | import ( 'estree' ) . MemberExpression }
* @ returns { ESTree . Identifier | ESTree . MemberExpression }
* /
* /
export function member _id ( path ) { export function member _id ( path ) {
const parts = path . split ( '.' ) ;
const parts = path . split ( '.' ) ;
/** @type { import('estree').Identifier | import('estree') .MemberExpression} */
/** @type { ESTree.Identifier | ESTree .MemberExpression} */
let expression = id ( parts [ 0 ] ) ;
let expression = id ( parts [ 0 ] ) ;
for ( let i = 1 ; i < parts . length ; i += 1 ) {
for ( let i = 1 ; i < parts . length ; i += 1 ) {
@ -313,39 +312,39 @@ export function member_id(path) {
} }
/ * * / * *
* @ param { Array < import ( 'estree' ) . Property | import ( 'estree' ) . SpreadElement > } properties
* @ param { Array < ESTree . Property | ESTree . SpreadElement > } properties
* @ returns { import ( 'estree' ) . ObjectExpression }
* @ returns { ESTree . ObjectExpression }
* /
* /
export function object ( properties ) { export function object ( properties ) {
return { type : 'ObjectExpression' , properties } ;
return { type : 'ObjectExpression' , properties } ;
} }
/ * * / * *
* @ param { Array < import ( 'estree' ) . RestElement | import ( 'estree' ) . AssignmentProperty > } properties
* @ param { Array < ESTree . RestElement | ESTree . AssignmentProperty > } properties
* @ returns { import ( 'estree' ) . ObjectPattern }
* @ returns { ESTree . ObjectPattern }
* /
* /
export function object _pattern ( properties ) { export function object _pattern ( properties ) {
return { type : 'ObjectPattern' , properties } ;
return { type : 'ObjectPattern' , properties } ;
} }
/ * * / * *
* @ template { import ( 'estree' ) . Expression } Value
* @ template { ESTree . Expression } Value
* @ param { 'init' | 'get' | 'set' } kind
* @ param { 'init' | 'get' | 'set' } kind
* @ param { import ( 'estree' ) . Expression } key
* @ param { ESTree . Expression } key
* @ param { Value } value
* @ param { Value } value
* @ param { boolean } computed
* @ param { boolean } computed
* @ returns { import ( 'estree' ) . Property & { value : Value } }
* @ returns { ESTree . Property & { value : Value } }
* /
* /
export function prop ( kind , key , value , computed = false ) { export function prop ( kind , key , value , computed = false ) {
return { type : 'Property' , kind , key , value , method : false , shorthand : false , computed } ;
return { type : 'Property' , kind , key , value , method : false , shorthand : false , computed } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression | import ( 'estree' ) . PrivateIdentifier } key
* @ param { ESTree . Expression | ESTree . PrivateIdentifier } key
* @ param { import ( 'estree' ) . Expression | null | undefined } value
* @ param { ESTree . Expression | null | undefined } value
* @ param { boolean } computed
* @ param { boolean } computed
* @ param { boolean } is _static
* @ param { boolean } is _static
* @ returns { import ( 'estree' ) . PropertyDefinition }
* @ returns { ESTree . PropertyDefinition }
* /
* /
export function prop _def ( key , value , computed = false , is _static = false ) { export function prop _def ( key , value , computed = false , is _static = false ) {
return { type : 'PropertyDefinition' , key , value , computed , static : is _static } ;
return { type : 'PropertyDefinition' , key , value , computed , static : is _static } ;
@ -354,7 +353,7 @@ export function prop_def(key, value, computed = false, is_static = false) {
/ * * / * *
* @ param { string } cooked
* @ param { string } cooked
* @ param { boolean } tail
* @ param { boolean } tail
* @ returns { import ( 'estree' ) . TemplateElement }
* @ returns { ESTree . TemplateElement }
* /
* /
export function quasi ( cooked , tail = false ) { export function quasi ( cooked , tail = false ) {
const raw = sanitize _template _string ( cooked ) ;
const raw = sanitize _template _string ( cooked ) ;
@ -362,16 +361,16 @@ export function quasi(cooked, tail = false) {
} }
/ * * / * *
* @ param { import ( 'estree' ) . Pattern } argument
* @ param { ESTree . Pattern } argument
* @ returns { import ( 'estree' ) . RestElement }
* @ returns { ESTree . RestElement }
* /
* /
export function rest ( argument ) { export function rest ( argument ) {
return { type : 'RestElement' , argument } ;
return { type : 'RestElement' , argument } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression [ ] } expressions
* @ param { ESTree . Expression [ ] } expressions
* @ returns { import ( 'estree' ) . SequenceExpression }
* @ returns { ESTree . SequenceExpression }
* /
* /
export function sequence ( expressions ) { export function sequence ( expressions ) {
return { type : 'SequenceExpression' , expressions } ;
return { type : 'SequenceExpression' , expressions } ;
@ -379,42 +378,42 @@ export function sequence(expressions) {
/ * * / * *
* @ param { string } name
* @ param { string } name
* @ param { import ( 'estree' ) . Statement [ ] } body
* @ param { ESTree . Statement [ ] } body
* @ returns { import ( 'estree' ) . Property & { value : import ( 'estree' ) . FunctionExpression } }
* @ returns { ESTree . Property & { value : ESTree . FunctionExpression } }
* /
* /
export function set ( name , body ) { export function set ( name , body ) {
return prop ( 'set' , key ( name ) , function _builder ( null , [ id ( '$$value' ) ] , block ( body ) ) ) ;
return prop ( 'set' , key ( name ) , function _builder ( null , [ id ( '$$value' ) ] , block ( body ) ) ) ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression } argument
* @ param { ESTree . Expression } argument
* @ returns { import ( 'estree' ) . SpreadElement }
* @ returns { ESTree . SpreadElement }
* /
* /
export function spread ( argument ) { export function spread ( argument ) {
return { type : 'SpreadElement' , argument } ;
return { type : 'SpreadElement' , argument } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression } expression
* @ param { ESTree . Expression } expression
* @ returns { import ( 'estree' ) . ExpressionStatement }
* @ returns { ESTree . ExpressionStatement }
* /
* /
export function stmt ( expression ) { export function stmt ( expression ) {
return { type : 'ExpressionStatement' , expression } ;
return { type : 'ExpressionStatement' , expression } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . TemplateElement [ ] } elements
* @ param { ESTree . TemplateElement [ ] } elements
* @ param { import ( 'estree' ) . Expression [ ] } expressions
* @ param { ESTree . Expression [ ] } expressions
* @ returns { import ( 'estree' ) . TemplateLiteral }
* @ returns { ESTree . TemplateLiteral }
* /
* /
export function template ( elements , expressions ) { export function template ( elements , expressions ) {
return { type : 'TemplateLiteral' , quasis : elements , expressions } ;
return { type : 'TemplateLiteral' , quasis : elements , expressions } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression | import ( 'estree' ) . BlockStatement } expression
* @ param { ESTree . Expression | ESTree . BlockStatement } expression
* @ param { boolean } [ async ]
* @ param { boolean } [ async ]
* @ returns { import ( 'estree' ) . Expression }
* @ returns { ESTree . Expression }
* /
* /
export function thunk ( expression , async = false ) { export function thunk ( expression , async = false ) {
if (
if (
@ -434,9 +433,9 @@ export function thunk(expression, async = false) {
/ * * / * *
*
*
* @ param { string | import ( 'estree' ) . Expression } expression
* @ param { string | ESTree . Expression } expression
* @ param { ... import ( 'estree' ) . Expression } args
* @ param { ... ESTree . Expression } args
* @ returns { import ( 'estree' ) . NewExpression }
* @ returns { ESTree . NewExpression }
* /
* /
function new _builder ( expression , ... args ) { function new _builder ( expression , ... args ) {
if ( typeof expression === 'string' ) expression = id ( expression ) ;
if ( typeof expression === 'string' ) expression = id ( expression ) ;
@ -449,19 +448,19 @@ function new_builder(expression, ...args) {
} }
/ * * / * *
* @ param { import ( 'estree' ) . UpdateOperator } operator
* @ param { ESTree . UpdateOperator } operator
* @ param { import ( 'estree' ) . Expression } argument
* @ param { ESTree . Expression } argument
* @ param { boolean } prefix
* @ param { boolean } prefix
* @ returns { import ( 'estree' ) . UpdateExpression }
* @ returns { ESTree . UpdateExpression }
* /
* /
export function update ( operator , argument , prefix = false ) { export function update ( operator , argument , prefix = false ) {
return { type : 'UpdateExpression' , operator , argument , prefix } ;
return { type : 'UpdateExpression' , operator , argument , prefix } ;
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression } test
* @ param { ESTree . Expression } test
* @ param { import ( 'estree' ) . Statement } body
* @ param { ESTree . Statement } body
* @ returns { import ( 'estree' ) . DoWhileStatement }
* @ returns { ESTree . DoWhileStatement }
* /
* /
export function do _while ( test , body ) { export function do _while ( test , body ) {
return { type : 'DoWhileStatement' , test , body } ;
return { type : 'DoWhileStatement' , test , body } ;
@ -471,38 +470,38 @@ const true_instance = literal(true);
const false _instance = literal ( false ) ; const false _instance = literal ( false ) ;
const null _instane = literal ( null ) ; const null _instane = literal ( null ) ;
/** @type { import('estree') .DebuggerStatement} *//** @type { ESTree .DebuggerStatement} */
const debugger _builder = { const debugger _builder = {
type : 'DebuggerStatement'
type : 'DebuggerStatement'
} ; } ;
/** @type { import('estree') .ThisExpression} *//** @type { ESTree .ThisExpression} */
const this _instance = { const this _instance = {
type : 'ThisExpression'
type : 'ThisExpression'
} ; } ;
/ * * / * *
* @ param { string | import ( 'estree' ) . Pattern } pattern
* @ param { string | ESTree . Pattern } pattern
* @ param { import ( 'estree' ) . Expression } [ init ]
* @ param { ESTree . Expression } [ init ]
* @ returns { import ( 'estree' ) . VariableDeclaration }
* @ returns { ESTree . VariableDeclaration }
* /
* /
function let _builder ( pattern , init ) { function let _builder ( pattern , init ) {
return declaration ( 'let' , pattern , init ) ;
return declaration ( 'let' , pattern , init ) ;
} }
/ * * / * *
* @ param { string | import ( 'estree' ) . Pattern } pattern
* @ param { string | ESTree . Pattern } pattern
* @ param { import ( 'estree' ) . Expression } init
* @ param { ESTree . Expression } init
* @ returns { import ( 'estree' ) . VariableDeclaration }
* @ returns { ESTree . VariableDeclaration }
* /
* /
function const _builder ( pattern , init ) { function const _builder ( pattern , init ) {
return declaration ( 'const' , pattern , init ) ;
return declaration ( 'const' , pattern , init ) ;
} }
/ * * / * *
* @ param { string | import ( 'estree' ) . Pattern } pattern
* @ param { string | ESTree . Pattern } pattern
* @ param { import ( 'estree' ) . Expression } [ init ]
* @ param { ESTree . Expression } [ init ]
* @ returns { import ( 'estree' ) . VariableDeclaration }
* @ returns { ESTree . VariableDeclaration }
* /
* /
function var _builder ( pattern , init ) { function var _builder ( pattern , init ) {
return declaration ( 'var' , pattern , init ) ;
return declaration ( 'var' , pattern , init ) ;
@ -510,11 +509,11 @@ function var_builder(pattern, init) {
/ * * / * *
*
*
* @ param { import ( 'estree' ) . VariableDeclaration | import ( 'estree' ) . Expression | null } init
* @ param { ESTree . VariableDeclaration | ESTree . Expression | null } init
* @ param { import ( 'estree' ) . Expression } test
* @ param { ESTree . Expression } test
* @ param { import ( 'estree' ) . Expression } update
* @ param { ESTree . Expression } update
* @ param { import ( 'estree' ) . Statement } body
* @ param { ESTree . Statement } body
* @ returns { import ( 'estree' ) . ForStatement }
* @ returns { ESTree . ForStatement }
* /
* /
function for _builder ( init , test , update , body ) { function for _builder ( init , test , update , body ) {
return { type : 'ForStatement' , init , test , update , body } ;
return { type : 'ForStatement' , init , test , update , body } ;
@ -523,12 +522,12 @@ function for_builder(init, test, update, body) {
/ * * / * *
*
*
* @ param { 'constructor' | 'method' | 'get' | 'set' } kind
* @ param { 'constructor' | 'method' | 'get' | 'set' } kind
* @ param { import ( 'estree' ) . Expression | import ( 'estree' ) . PrivateIdentifier } key
* @ param { ESTree . Expression | ESTree . PrivateIdentifier } key
* @ param { import ( 'estree' ) . Pattern [ ] } params
* @ param { ESTree . Pattern [ ] } params
* @ param { import ( 'estree' ) . Statement [ ] } body
* @ param { ESTree . Statement [ ] } body
* @ param { boolean } computed
* @ param { boolean } computed
* @ param { boolean } is _static
* @ param { boolean } is _static
* @ returns { import ( 'estree' ) . MethodDefinition }
* @ returns { ESTree . MethodDefinition }
* /
* /
export function method ( kind , key , params , body , computed = false , is _static = false ) { export function method ( kind , key , params , body , computed = false , is _static = false ) {
return {
return {
@ -543,10 +542,10 @@ export function method(kind, key, params, body, computed = false, is_static = fa
/ * * / * *
*
*
* @ param { import ( 'estree' ) . Identifier | null } id
* @ param { ESTree . Identifier | null } id
* @ param { import ( 'estree' ) . Pattern [ ] } params
* @ param { ESTree . Pattern [ ] } params
* @ param { import ( 'estree' ) . BlockStatement } body
* @ param { ESTree . BlockStatement } body
* @ returns { import ( 'estree' ) . FunctionExpression }
* @ returns { ESTree . FunctionExpression }
* /
* /
function function _builder ( id , params , body ) { function function _builder ( id , params , body ) {
return {
return {
@ -561,10 +560,10 @@ function function_builder(id, params, body) {
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression } test
* @ param { ESTree . Expression } test
* @ param { import ( 'estree' ) . Statement } consequent
* @ param { ESTree . Statement } consequent
* @ param { import ( 'estree' ) . Statement } [ alternate ]
* @ param { ESTree . Statement } [ alternate ]
* @ returns { import ( 'estree' ) . IfStatement }
* @ returns { ESTree . IfStatement }
* /
* /
function if _builder ( test , consequent , alternate ) { function if _builder ( test , consequent , alternate ) {
return { type : 'IfStatement' , test , consequent , alternate } ;
return { type : 'IfStatement' , test , consequent , alternate } ;
@ -573,7 +572,7 @@ function if_builder(test, consequent, alternate) {
/ * * / * *
* @ param { string } as
* @ param { string } as
* @ param { string } source
* @ param { string } source
* @ returns { import ( 'estree' ) . ImportDeclaration }
* @ returns { ESTree . ImportDeclaration }
* /
* /
export function import _all ( as , source ) { export function import _all ( as , source ) {
return {
return {
@ -586,7 +585,7 @@ export function import_all(as, source) {
/ * * / * *
* @ param { Array < [ string , string ] > } parts
* @ param { Array < [ string , string ] > } parts
* @ param { string } source
* @ param { string } source
* @ returns { import ( 'estree' ) . ImportDeclaration }
* @ returns { ESTree . ImportDeclaration }
* /
* /
export function imports ( parts , source ) { export function imports ( parts , source ) {
return {
return {
@ -601,8 +600,8 @@ export function imports(parts, source) {
} }
/ * * / * *
* @ param { import ( 'estree' ) . Expression | null } argument
* @ param { ESTree . Expression | null } argument
* @ returns { import ( 'estree' ) . ReturnStatement }
* @ returns { ESTree . ReturnStatement }
* /
* /
function return _builder ( argument = null ) { function return _builder ( argument = null ) {
return { type : 'ReturnStatement' , argument } ;
return { type : 'ReturnStatement' , argument } ;
@ -610,7 +609,7 @@ function return_builder(argument = null) {
/ * * / * *
* @ param { string } str
* @ param { string } str
* @ returns { import ( 'estree' ) . ThrowStatement }
* @ returns { ESTree . ThrowStatement }
* /
* /
export function throw _error ( str ) { export function throw _error ( str ) {
return {
return {
@ -637,7 +636,7 @@ export {
/ * * / * *
* @ param { string } name
* @ param { string } name
* @ returns { import ( 'estree' ) . Expression }
* @ returns { ESTree . Expression }
* /
* /
export function key ( name ) { export function key ( name ) {
return regex _is _valid _identifier . test ( name ) ? id ( name ) : literal ( name ) ;
return regex _is _valid _identifier . test ( name ) ? id ( name ) : literal ( name ) ;
Damian Stasik
1 year ago
committed by
GitHub