<?php
declare( strict_types = 1 );

/**
 * Copyright 2011 Paul Copperman <paul.copperman@gmail.com>
 * Copyright 2018 Timo Tijhof
 * Copyright 2021 Roan Kattouw <roan.kattouw@gmail.com>
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * @file
 * @license Apache-2.0
 * @license MIT
 * @license GPL-2.0-or-later
 * @license LGPL-2.1-or-later
 */

namespace Wikimedia\Minify;

use ReflectionClass;

/**
 * JavaScript Minifier
 *
 * This class is meant to safely minify JavaScript code, while leaving syntactically correct
 * programs intact. Other libraries, such as JSMin require a certain coding style to work
 * correctly. OTOH, libraries like jsminplus, that do parse the code correctly are rather
 * slow, because they construct a complete parse tree before outputting the code minified.
 * So this class is meant to allow arbitrary (but syntactically correct) input, while being
 * fast enough to be used for on-the-fly minifying.
 *
 * This class was written with ECMA-262 13th Edition in mind ("ECMAScript 2022"). Parsing features
 * new to later editions of ECMAScript might not be supported. It's assumed that the input is
 * syntactically correct; if it's not, this class may not detect that, and may produce incorrect
 * output.
 *
 * See also:
 * - <https://262.ecma-international.org/13.0/>
 */
class JavaScriptMinifier {

	/* Parsing states.
	 * The state machine is necessary to decide whether to parse a slash as division
	 * operator or as regexp literal, and to know where semicolon insertion is possible.
	 * States are generally named after the next expected item. We only distinguish states when the
	 * distinction is relevant for our purpose. The meaning of these states is documented
	 * in $model below.
	 *
	 * Negative numbers are used to indicate that the state is inside a generator function,
	 * which changes the behavior of 'yield'
	 */
	private const STATEMENT                     = 1;
	private const CONDITION                     = 2;
	private const FUNC                          = 3;
	private const GENFUNC                       = 4;
	private const PROPERTY_ASSIGNMENT           = 5;
	private const EXPRESSION                    = 6;
	private const EXPRESSION_NO_NL              = 7;
	private const EXPRESSION_OP                 = 8;
	private const EXPRESSION_DOT                = 9;
	private const EXPRESSION_END                = 10;
	private const EXPRESSION_ARROWFUNC          = 11;
	private const EXPRESSION_TERNARY            = 12;
	private const EXPRESSION_TERNARY_OP         = 13;
	private const EXPRESSION_TERNARY_DOT        = 14;
	private const EXPRESSION_TERNARY_ARROWFUNC  = 15;
	private const PAREN_EXPRESSION              = 16;
	private const PAREN_EXPRESSION_OP           = 17;
	private const PAREN_EXPRESSION_DOT          = 18;
	private const PAREN_EXPRESSION_ARROWFUNC    = 19;
	private const PROPERTY_EXPRESSION           = 20;
	private const PROPERTY_EXPRESSION_OP        = 21;
	private const PROPERTY_EXPRESSION_DOT       = 22;
	private const PROPERTY_EXPRESSION_ARROWFUNC = 23;
	private const CLASS_DEF                     = 24;
	private const IMPORT_EXPORT                 = 25;
	private const TEMPLATE_STRING_HEAD          = 26;
	private const TEMPLATE_STRING_TAIL          = 27;
	private const PAREN_EXPRESSION_OP_NO_NL     = 28;
	private const EXPRESSION_TERNARY_NO_NL      = 29;
	private const PAREN_EXPRESSION_NO_NL        = 30;
	private const PROPERTY_EXPRESSION_NO_NL     = 31;
	private const PROPERTY_EXPRESSION_ASYNC     = 32;

	/* Token types */

	/** @var int unary operators */
	private const TYPE_UN_OP = 101;

	/** @var int ++ and -- */
	private const TYPE_INCR_OP = 102;

	/** @var int binary operators (except .) */
	private const TYPE_BIN_OP = 103;

	/** @var int + and - which can be either unary or binary ops */
	private const TYPE_ADD_OP = 104;

	/** @var int . */
	private const TYPE_DOT = 105;

	/** @var int ? */
	private const TYPE_HOOK = 106;

	/** @var int : */
	private const TYPE_COLON = 107;

	/** @var int , */
	private const TYPE_COMMA = 108;

	/** @var int ; */
	private const TYPE_SEMICOLON = 109;

	/** @var int { */
	private const TYPE_BRACE_OPEN = 110;

	/** @var int } */
	private const TYPE_BRACE_CLOSE = 111;

	/** @var int ( and [ */
	private const TYPE_PAREN_OPEN = 112;

	/** @var int ) and ] */
	private const TYPE_PAREN_CLOSE = 113;

	/** @var int => */
	private const TYPE_ARROW = 114;

	/** @var int keywords: break, continue, return, throw (and yield, if we're in a generator) */
	private const TYPE_RETURN = 115;

	/** @var int keywords: catch, for, with, switch, while, if */
	private const TYPE_IF = 116;

	/** @var int keywords: case, finally, else, do, try */
	private const TYPE_DO = 117;

	/** @var int keywords: var, let, const */
	private const TYPE_VAR = 118;

	/** @var int keywords: yield */
	private const TYPE_YIELD = 119;

	/** @var int keywords: function */
	private const TYPE_FUNC = 120;

	/** @var int keywords: class */
	private const TYPE_CLASS = 121;

	/** @var int all literals, identifiers, unrecognised tokens, and other keywords */
	private const TYPE_LITERAL = 122;

	/** @var int For special treatment of tokens that usually mean something else */
	private const TYPE_SPECIAL = 123;

	/** @var int keywords: async */
	private const TYPE_ASYNC = 124;

	/** @var int keywords: await */
	private const TYPE_AWAIT = 125;

	/** @var int Go to another state */
	private const ACTION_GOTO = 201;

	/** @var int Push a state to the stack */
	private const ACTION_PUSH = 202;

	/** @var int Pop the state from the top of the stack, and go to that state */
	private const ACTION_POP = 203;

	/** @var int Limit to avoid excessive memory usage */
	private const STACK_LIMIT = 1000;

	/**
	 * @var int $maxLineLength
	 *
	 * Maximum line length
	 *
	 * This is not a strict maximum, but a guideline. Longer lines will be
	 * produced when literals (e.g. quoted strings) longer than this are
	 * encountered, or when required to guard against semicolon insertion.
	 *
	 * This is a private member (instead of constant) to allow tests to
	 * set it to 1, to verify ASI and line-breaking behaviour.
	 */
	private static $maxLineLength = 1000;

	private static bool $expandedStates = false;

	/**
	 * @var array $opChars
	 *
	 * Characters which can be combined without whitespace between them.
	 * Unlike the ECMAScript spec, we define these as individual symbols, not sequences.
	 */
	private static $opChars = [
		// ECMAScript 13.0 § 12.7 Punctuators
		//
		//    Punctuator
		//    DivPunctuator
		//    RightBracePunctuator
		//
		'{' => true,
		'(' => true,
		')' => true,
		'[' => true,
		']' => true,
		// Dots have a special case after $plainDigits which require whitespace
		'.' => true,
		';' => true,
		',' => true,
		'<' => true,
		'>' => true,
		'=' => true,
		'!' => true,
		'+' => true,
		'-' => true,
		'*' => true,
		'%' => true,
		'&' => true,
		'|' => true,
		'^' => true,
		'~' => true,
		'?' => true,
		':' => true,
		'/' => true,
		'}' => true,

		// ECMAScript 13.0 § 12.8.4 String Literals
		'"' => true,
		"'" => true,

		// ECMAScript 13.0 § 12.8.6 Template Literal Lexical Components
		'`' => true,
	];

	/**
	 * Table-driven lookahead map for parsing multi-character punctuation operators.
	 *
	 * This is the subset of $tokenTypes keys, made of two or more $opChars. It must be
	 * updated whenever punctuation operators are added to $tokenTypes. This is ensured
	 * by the JavaScriptMinifierTest::testOperatorLookaheadCoversAllTokens test case.
	 *
	 * The shape of this map is one character offset per array level (or "column").
	 * The total depth is based on the longest punctuation token in $tokenTypes.
	 * Currently, the longest punctuation token is `>>>=`, which is 4 characters.
	 *
	 * Example:
	 * - Token AB is stored at `['A']['B'][''][''] === 2`,
	 *   Token ABC is stored at `['A']['B']['C'][''] === 3`,
	 *   Token ABCD is stored at `['A']['B']['C']['D'] === 4`
	 * - The parser looks at `map[$ch][$next2][$next3][$next4]`.
	 * - If set, it directly moves past that number of characters to parse the current token.
	 *
	 * We have a fairly even distribution (most starting characters lead to only 1 or 2 possible
	 * tokens), so the most valuable optimization is to look at the first character and narrow
	 * our options, before performing any other potentially unnecessary assignments and lookups.
	 *
	 * The most common token length in this map is 2 (because 3 and 4 are rare, and 1-length tokens
	 * don't need lookahead) and most of those are unambigious (i.e. not the start of a longer
	 * token) which allows for a further optimization. Whenever possible, we store length 2 in
	 * a shortcut directly under `map[$ch][$next2]` instead of `map[$ch][$next2]['']['']`.
	 * This allows the parser to usually stop after 2 lookups (at the cost of an extra isset),
	 * instead of always peforming the worst case (4 lookups) for all operators.
	 */
	private const MULTICHAR_PUNCTOKENS = [
		'.' => [
			'.' => [
				'.' => [
					'' => 3,
				],
			],
		],
		'+' => [
			'+' => 2,
			'=' => 2,
		],
		'-' => [
			'-' => 2,
			'=' => 2,
		],
		'*' => [
			'*' => [
				'' => 2,
				'=' => [
					'' => 3,
				],
			],
			'=' => 2,
		],
		'<' => [
			'<' => [
				'' => 2,
				'=' => [
					'' => 3,
				],
			],
			'=' => 2,
		],
		'>' => [
			'>' => [
				'' => 2,
				'>' => [
					'' => 3,
					'=' => 4,
				],
				'=' => [
					'' => 3,
				],
				'>=' => 4,
			],
			'=' => 2,
		],
		'=' => [
			'=' => [
				'' => 2,
				'=' => [
					'' => 3,
				],
			],
			'>' => 2,
		],
		'!' => [
			'=' => [
				'' => 2,
				'=' => [
					'' => 3,
				],
			],
		],
		'&' => [
			'&' => [
				'' => 2,
				'=' => [
					'' => 3,
				],
			],
			'=' => 2,
		],
		'|' => [
			'|' => [
				'' => 2,
				'=' => [
					'' => 3,
				],
			],
			'=' => 2,
		],
		'?' => [
			'?' => [
				'' => 2,
				'=' => [
					'' => 3,
				],
			],
			'.' => 2,
		],
		'/' => [
			'=' => 2,
		],
		'%' => [
			'=' => 2,
		],
		'^' => [
			'=' => 2,
		],
	];

	/**
	 * @var array $tokenTypes
	 *
	 * Tokens and their types.
	 */
	private static $tokenTypes = [
		// Can be one of:
		//
		// - ECMAScript 13.0 § 13.2.4 Array Initializer
		//    ... AssignmentExpression
		// - ECMAScript 13.0 § 14.3.3 Destructuring Binding Patterns
		//    ... BindingIdentifier
		//    ... BindingPattern
		'...'        => self::TYPE_UN_OP,

		// ECMAScript 13.0 § 13.3 Left-Hand-Side Expressions
		//
		//    MemberExpression
		//    OptionalExpression
		//
		// A dot can also be part of a DecimalLiteral, but in that case we handle the entire
		// DecimalLiteral as one token. A separate '.' token is always part of a MemberExpression.
		'.'          => self::TYPE_DOT,
		'?.'         => self::TYPE_DOT,

		// ECMAScript 13.0 § 13.4 Update Expressions
		//
		//    LeftHandSideExpression [no LineTerminator here] ++
		//    LeftHandSideExpression [no LineTerminator here] --
		//    ++ UnaryExpression
		//    -- UnaryExpression
		//
		// This is given a separate type from TYPE_UN_OP,
		// because `++` and `--` require special handling
		// around new lines and semicolon insertion.
		//
		'++'         => self::TYPE_INCR_OP,
		'--'         => self::TYPE_INCR_OP,

		// ECMAScript 13.0 § 13.5 Unary Operators
		//
		//    UnaryExpression
		//        includes UpdateExpression
		//            includes LeftHandSideExpression
		//                includes NewExpression, which defines 'new'
		//
		'new'        => self::TYPE_UN_OP,
		'delete'     => self::TYPE_UN_OP,
		'void'       => self::TYPE_UN_OP,
		'typeof'     => self::TYPE_UN_OP,
		'~'          => self::TYPE_UN_OP,
		'!'          => self::TYPE_UN_OP,

		// These operators can be either binary or unary depending on context,
		// and thus require separate type from TYPE_UN_OP and TYPE_BIN_OP.
		//
		//     var z = +y;    // unary (convert to number)
		//     var z = x + y; // binary (add operation)
		//
		// ECMAScript 13.0 § 13.5 Unary Operators
		//
		//     + UnaryExpression
		//     - UnaryExpression
		//
		// ECMAScript 13.0 § 13.8 Additive Operators
		//
		//     AdditiveExpression + MultiplicativeExpression
		//     AdditiveExpression - MultiplicativeExpression
		//
		'+'          => self::TYPE_ADD_OP,
		'-'          => self::TYPE_ADD_OP,

		// These operators can be treated the same as binary operators. Their
		// productions all place an operator token between a left operand and a
		// right operand, and do not require special handling for preserving
		// whitespace or line breaks.
		//
		// Defined in:
		// - ECMAScript 13.0 § 13.6 Exponentiation Operator
		//   ExponentiationExpression
		// - ECMAScript 13.0 § 13.7 Multiplicative Operators
		//   MultiplicativeOperator
		// - ECMAScript 13.0 § 13.9 Bitwise Shift Operators
		//   ShiftExpression
		// - ECMAScript 13.0 § 13.10 Relational Operators
		//   RelationalExpression
		// - ECMAScript 13.0 § 13.11 Equality Operators
		//   EqualityExpression
		'**'         => self::TYPE_BIN_OP,
		'*'          => self::TYPE_BIN_OP,
		'/'          => self::TYPE_BIN_OP,
		'%'          => self::TYPE_BIN_OP,
		'<<'         => self::TYPE_BIN_OP,
		'>>'         => self::TYPE_BIN_OP,
		'>>>'        => self::TYPE_BIN_OP,
		'<'          => self::TYPE_BIN_OP,
		'>'          => self::TYPE_BIN_OP,
		'<='         => self::TYPE_BIN_OP,
		'>='         => self::TYPE_BIN_OP,
		'instanceof' => self::TYPE_BIN_OP,
		'in'         => self::TYPE_BIN_OP,
		'=='         => self::TYPE_BIN_OP,
		'!='         => self::TYPE_BIN_OP,
		'==='        => self::TYPE_BIN_OP,
		'!=='        => self::TYPE_BIN_OP,

		// ECMAScript 13.0 § 13.12 Binary Bitwise Operators
		//
		//    BitwiseANDExpression
		//    BitwiseXORExpression
		//    BitwiseORExpression
		//
		'&'          => self::TYPE_BIN_OP,
		'^'          => self::TYPE_BIN_OP,
		'|'          => self::TYPE_BIN_OP,

		// ECMAScript 13.0 § 13.13 Binary Logical Operators
		//
		//    LogicalANDExpression
		//    LogicalORExpression
		//    CoalesceExpression
		//
		//    ShortCircuitExpression
		//        includes LogicalORExpression
		//        includes CoalesceExpression
		//
		'&&'         => self::TYPE_BIN_OP,
		'||'         => self::TYPE_BIN_OP,
		'??'         => self::TYPE_BIN_OP,

		// ECMAScript 13.0 § 13.14 Conditional Operator
		//
		//    ConditionalExpression:
		//        ShortCircuitExpression ? AssignmentExpression : AssignmentExpression
		//
		// Also known as ternary.
		'?'          => self::TYPE_HOOK,
		':'          => self::TYPE_COLON,

		// ECMAScript 13.0 § 13.15 Assignment Operators
		'='          => self::TYPE_BIN_OP,
		'*='         => self::TYPE_BIN_OP,
		'/='         => self::TYPE_BIN_OP,
		'%='         => self::TYPE_BIN_OP,
		'+='         => self::TYPE_BIN_OP,
		'-='         => self::TYPE_BIN_OP,
		'<<='        => self::TYPE_BIN_OP,
		'>>='        => self::TYPE_BIN_OP,
		'>>>='       => self::TYPE_BIN_OP,
		'&='         => self::TYPE_BIN_OP,
		'^='         => self::TYPE_BIN_OP,
		'|='         => self::TYPE_BIN_OP,
		'**='        => self::TYPE_BIN_OP,
		'&&='        => self::TYPE_BIN_OP,
		'||='        => self::TYPE_BIN_OP,
		'??='        => self::TYPE_BIN_OP,

		// ECMAScript 13.0 § 13.16 Comma Operator
		','          => self::TYPE_COMMA,

		// ECMAScript 13.0 § 12.9.1 Rules of Automatic Semicolon Insertion
		//
		// These keywords disallow LineTerminator before their following operand
		// or label. They are similar enough that we can treat them all the same
		// way that we treat return, with regards to new line and semicolon insertion.
		//
		//     continue [no LineTerminator here] LabelIdentifier ;
		//     break [no LineTerminator here] LabelIdentifier ;
		//     return [no LineTerminator here] Expression ;
		//     throw [no LineTerminator here] Expression ;
		//     yield [no LineTerminator here] AssignmentExpression ;
		//     yield [no LineTerminator here] * AssignmentExpression ;
		//
		// continue, break, return, and yield also allow the operand or label
		// to be omitted.
		//
		// See also ECMAScript 13.0:
		// - § 14.8 The continue Statement
		// - § 14.9 The break Statement
		// - § 14.10 The return Statement
		// - § 14.14 The throw Statement
		// - § 15.5 Generator Function Definitions (yield)
		'continue'   => self::TYPE_RETURN,
		'break'      => self::TYPE_RETURN,
		'return'     => self::TYPE_RETURN,
		'throw'      => self::TYPE_RETURN,
		// "yield" only counts as a keyword inside generator functions,
		// otherwise it is a regular identifier.
		// This is handled with the negative states hack: if the state is negative, TYPE_YIELD
		// is treated as TYPE_RETURN, if it's positive it's treated as TYPE_LITERAL
		'yield'      => self::TYPE_YIELD,

		// These keywords start constructs whose header/body shape is close enough
		// for the minifier to treat them like "if".
		//
		// See also ECMAScript 13.0:
		// - § 14.6 The if Statement
		// - § 14.7 Iteration Statements (while, for)
		// - § 14.11 The with Statement
		// - § 14.12 The switch Statement
		// - § 14.15 The try Statement (catch)
		'if'         => self::TYPE_IF,
		'while'      => self::TYPE_IF,
		'for'        => self::TYPE_IF,
		'with'       => self::TYPE_IF,
		'switch'     => self::TYPE_IF,
		'catch'      => self::TYPE_IF,

		// ECMAScript 13.0 § 14.7.5 The for-in, for-of, and for-await-of Statements
		'of'         => self::TYPE_BIN_OP,

		// These keywords start productions whose next significant token belongs
		// to a Statement, Expression, or Block. The minifier can treat those
		// shapes alike.
		//
		// See also ECMAScript 13.0:
		// - § 14.6 The if Statement (else)
		// - § 14.7 Iteration Statements (do)
		// - § 14.12 The switch Statement (case)
		// - § 14.15 The try Statement (try, finally)
		'else'       => self::TYPE_DO,
		'do'         => self::TYPE_DO,
		'case'       => self::TYPE_DO,
		'try'        => self::TYPE_DO,
		'finally'    => self::TYPE_DO,

		// ECMAScript 13.0 § 14.3 Declarations and the Variable Statement
		//
		//    LetOrConst
		//    VariableStatement
		//
		// These keywords are followed by a variable declaration statement.
		// This needs to be treated differently from the TYPE_DO group,
		// because for TYPE_VAR, when we see an "{" open curly brace, it
		// begins object destructuring (ObjectBindingPattern), not a block.
		'var'        => self::TYPE_VAR,
		'let'        => self::TYPE_VAR,
		'const'      => self::TYPE_VAR,

		// ECMAScript 13.0 § 15.2 Function Definitions
		'function'   => self::TYPE_FUNC,

		// ECMAScript 13.0 § 15.3 Arrow Function Definitions
		'=>'         => self::TYPE_ARROW,

		// ECMAScript 13.0 § 15.7 Class Definitions
		//
		//     ClassDeclaration:
		//         class BindingIdentifier ClassTail
		//         class ClassTail
		//     ClassExpression:
		//         class BindingIdentifier? ClassTail
		//     ClassTail:
		//         ClassHeritage? { ClassBody? }
		//     ClassHeritage:
		//         extends LeftHandSideExpression
		//
		'class'      => self::TYPE_CLASS,

		// ECMAScript 13.0 § 15.8 Async Function Definitions
		//
		//     AwaitExpression:
		//         await UnaryExpression
		//
		'await'      => self::TYPE_AWAIT,

		// Can be one of:
		// - Block (ECMAScript 13.0 § 14.2 Block)
		// - ObjectLiteral (ECMAScript 13.0 § 13.2 Primary Expression)
		'{'          => self::TYPE_BRACE_OPEN,
		'}'          => self::TYPE_BRACE_CLOSE,

		// Can be one of:
		// - Parenthesized header after a TYPE_IF keyword or parameter list
		//   after a TYPE_FUNC keyword.
		// - PrimaryExpression (ECMAScript 13.0 § 13.2 Primary Expression)
		// - CallExpression (ECMAScript 13.0 § 13.3 Left-Hand-Side Expressions)
		// - Beginning of an ArrowFunction (ECMAScript 13.0 § 15.3 Arrow Function Definitions)
		'('          => self::TYPE_PAREN_OPEN,
		')'          => self::TYPE_PAREN_CLOSE,

		// Can be one of:
		// - ArrayLiteral (ECMAScript 13.0 § 13.2 Primary Expression)
		// - ComputedPropertyName (ECMAScript 13.0 § 13.2.5 Object Initializer)
		'['          => self::TYPE_PAREN_OPEN,
		']'          => self::TYPE_PAREN_CLOSE,

		// Can be one of:
		// - End of any statement
		// - EmptyStatement (ECMAScript 13.0 § 14.4 Empty Statement)
		';'          => self::TYPE_SEMICOLON,

		// ECMAScript 13.0 § 15.8 Async Function Definitions
		// AsyncFunctionDeclaration starts with:
		//     async [no LineTerminator here] function
		// AsyncMethod starts with:
		//     async [no LineTerminator here] PropertyName or ClassElementName
		'async'      => self::TYPE_ASYNC,
	];

	/**
	 * @var array $model
	 *
	 * The main table for the state machine. Defines the desired action for every state/token pair.
	 *
	 * The state pushed onto the stack by ACTION_PUSH will be returned to by ACTION_POP.
	 * A state/token pair may not specify both ACTION_POP and ACTION_GOTO. If that does happen,
	 * ACTION_POP takes precedence.
	 *
	 * This table is augmented by self::ensureExpandedStates().
	 */
	private static $model = [
		// Statement - This is the initial state.
		self::STATEMENT => [
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_BRACE_OPEN => [
				// Use of '{' in statement context, creates a Block.
				self::ACTION_PUSH => self::STATEMENT,
			],
			self::TYPE_BRACE_CLOSE => [
				// Ends a Block
				self::ACTION_POP => true,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::EXPRESSION_NO_NL,
			],
			self::TYPE_IF => [
				self::ACTION_GOTO => self::CONDITION,
			],
			self::TYPE_VAR => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::STATEMENT,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::STATEMENT,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_SPECIAL => [
				'import' => [
					self::ACTION_GOTO => self::IMPORT_EXPORT,
				],
				'export' => [
					self::ACTION_GOTO => self::IMPORT_EXPORT,
				],
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_AWAIT => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
		],
		// The state after if/catch/while/for/switch/with
		// Waits for an expression in parentheses, then goes to STATEMENT
		self::CONDITION => [
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::STATEMENT,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::STATEMENT,
				self::ACTION_GOTO => self::STATEMENT,
			]
		],
		// The state after the function keyword. Waits for {, then goes to STATEMENT.
		// The function body's closing } will pop the stack, so the state to return to
		// after the function should be pushed to the stack first
		self::FUNC => [
			// Needed to prevent * in an expression in the argument list from improperly
			// triggering GENFUNC
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::FUNC,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_SPECIAL => [
				'*' => [
					self::ACTION_GOTO => self::GENFUNC,
				],
			],
		],
		// State after `function*` to wait for `{` and go to generator function statement.
		//
		// For example: `function* myGen(a, b) { yield 1; }`
		self::GENFUNC => [
			self::TYPE_BRACE_OPEN => [
				// Note negative value: generator function states are negative
				self::ACTION_GOTO => -self::STATEMENT
			],
		],
		// State after `{` expecting property keys in an object literal declaration.
		//
		// For example: `{ key: value, key2, [computedKey3]: value3, method4() { ... } }`
		self::PROPERTY_ASSIGNMENT => [
			// Note that keywords like "if", "class", "var", "delete", "async", etc, are
			// valid key names, and should be treated as literals here. Like in EXPRESSION_DOT.
			// For this state, this requires no special handling because TYPE_LITERAL
			// has no action here, so we remain in this state.
			//
			// If this state ever gets a transition for TYPE_LITERAL, then that same transition
			// must apply to TYPE_IF, TYPE_CLASS, TYPE_VAR, TYPE_ASYNC, etc as well.
			self::TYPE_COLON => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			// For {, which begins a method
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_ASSIGNMENT,
				// This is not flipped, see "Special cases" below
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_BRACE_CLOSE => [
				self::ACTION_POP => true,
			],
			// For [, which begins a computed key
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_ASSIGNMENT,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_SPECIAL => [
				'*' => [
					self::ACTION_PUSH => self::PROPERTY_ASSIGNMENT,
					self::ACTION_GOTO => self::GENFUNC,
				],
			],
		],
		// Place in an expression where we expect an operand or a unary operator: the start
		// of an expression or after an operator. Note that unary operators (including INCR_OP
		// and ADD_OP) cause us to stay in this state, while operands take us to EXPRESSION_OP
		self::EXPRESSION => [
			self::TYPE_SEMICOLON => [
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_BRACE_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			// 'return' can't appear here, but 'yield' can
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::EXPRESSION_NO_NL,
			],
		],

		// State after `return` (or throw/break/continue/yield) where a newline is not allowed.
		//
		// This state is identical to EXPRESSION, except that semicolon insertion can happen here,
		// and we (almost) never stay here:
		// in cases where EXPRESSION would do nothing, we go back to EXPRESSION.
		//
		// We only stay here if there's a double yield, because `yield yield foo` is valid.
		self::EXPRESSION_NO_NL => [
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			// BIN_OP seems impossible at the start of an expression, but it can happen in
			// yield *foo
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_SEMICOLON => [
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_BRACE_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_AWAIT => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			// 'return' can't appear here, because 'return return' isn't allowed
			// But 'yield' can appear here, because 'yield yield' is allowed
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::EXPRESSION_NO_NL,
			],
		],

		// State after an literal or operand in an expression, such as:
		// `var x = foo`      potentially `var x = foo + 1` or `var x = foo()`
		// `var x = async`    potentially `var x = async + 1` or `var x = async function () {}`
		//
		// This is also the state we pop back to after a nested operation has
		// completed such as after:
		// `var x = (foo + 1)`
		// `var x = { foo: 1 }`
		// `var x = class Foo {}`
		// `var x = function () {}`
		//
		// We are in an expression after an operand, and expect an operator
		self::EXPRESSION_OP => [
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_DOT => [
				self::ACTION_GOTO => self::EXPRESSION_DOT,
			],
			self::TYPE_HOOK => [
				self::ACTION_PUSH => self::EXPRESSION,
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_COLON => [
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_COMMA => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_SEMICOLON => [
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_ARROW => [
				self::ACTION_GOTO => self::EXPRESSION_ARROWFUNC,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_BRACE_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
		],

		// State after a dot in EXPRESSION_OP, such as:
		// `var x = foo.`
		// `var x = (foo + 1).`
		//
		// Like EXPRESSION, except many keywords behave like literals
		// (e.g. class, if, else, var, function) because they're not valid as identifiers
		// but are valid as property names.
		self::EXPRESSION_DOT => [
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			// The following are keywords behaving as literals
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_IF => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_DO => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_VAR => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_FUNC => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_CLASS => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			// We don't expect real unary/binary operators here, but some keywords
			// (new, delete, void, typeof, instanceof, in) are classified as such, and they can be
			// used as property names
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
		],

		// State after the `}` that closes an arrow function body
		//
		// Like STATEMENT except it allows semicolon insertion, COMMA can continue the expression,
		// and after a function we go to STATEMENT instead of EXPRESSION_OP.
		self::EXPRESSION_END => [
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_COMMA => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_SEMICOLON => [
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::STATEMENT,
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_BRACE_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::EXPRESSION_NO_NL,
			],
			self::TYPE_IF => [
				self::ACTION_GOTO => self::CONDITION,
			],
			self::TYPE_VAR => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::STATEMENT,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::STATEMENT,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
		],

		// State after `=>` such as:
		// `var inc = a =>`        potentially `var inc = a => a + 1;`
		// `var sum = (a, b) =>`   potentially `var sum = (a, b) => a + b;`
		//
		// Like EXPRESSION, except that `{` begins an arrow function body
		// rather than an object literal.
		self::EXPRESSION_ARROWFUNC => [
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_END,
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_OP,
			],
		],

		// State after `?` in EXPRESSION_OP, expecting another expression, such as:
		// `var x = foo ?`
		// `foo ?`
		//
		// This differs from EXPRESSION because a `:` ends the ternary
		// rather than starting STATEMENT (outside a ternary, `:` comes after a goto label)
		// The actual rule for `:` ending the ternary is in EXPRESSION_TERNARY_OP.
		self::EXPRESSION_TERNARY => [
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			// 'return' can't appear here, but 'yield' can
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_NO_NL,
			],
		],
		// Like EXPRESSION_TERNARY, except that semicolon insertion can happen
		// See also EXPRESSION_NO_NL
		self::EXPRESSION_TERNARY_NO_NL => [
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			// 'yield' can appear here, because 'yield yield' is allowed
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_NO_NL,
			],
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			// BIN_OP seems impossible at the start of an expression, but it can happen in
			// yield *foo
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
		],

		// State after an literal or operand in a ternary expression, such as:
		// `var x = foo ? foo`       potentially `foo ? foo + 1 : 0` or `foo ? foo.bar : 0`
		//
		// This is also the state we pop back to after a nested operation has
		// completed such as after:
		// `var x = foo ? (foo + 1)`
		// `var x = foo ? { foo: 1 }`
		// `var x = foo ? function (a, b) {}`
		//
		// Like EXPRESSION_OP, but for ternaries, see EXPRESSION_TERNARY
		self::EXPRESSION_TERNARY_OP => [
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_DOT => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_DOT,
			],
			self::TYPE_HOOK => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY,
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_COMMA => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_ARROW => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_ARROWFUNC,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_COLON => [
				self::ACTION_POP => true,
			],
		],

		// State after a dot in a ternary expression, such as:
		// `var x = foo ? foo.`
		// `var x = foo ? (foo + 1).`
		//
		// Like EXPRESSION_DOT, but for ternaries, see EXPRESSION_TERNARY
		self::EXPRESSION_TERNARY_DOT => [
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			// The following are keywords behaving as literals
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			self::TYPE_IF => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			self::TYPE_DO => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			self::TYPE_VAR => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			self::TYPE_FUNC => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			self::TYPE_CLASS => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			// We don't expect real unary/binary operators here, but some keywords
			// (new, delete, void, typeof, instanceof, in) are classified as such, and they can be
			// used as property names
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
		],
		// Like EXPRESSION_ARROWFUNC, but for ternaries, see EXPRESSION_TERNARY
		self::EXPRESSION_TERNARY_ARROWFUNC => [
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::EXPRESSION_TERNARY_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::EXPRESSION_TERNARY_OP,
			],
		],
		// Expression inside parentheses. Like EXPRESSION, except that `)` ends this state
		// This differs from EXPRESSION because semicolon insertion can't happen here
		self::PAREN_EXPRESSION => [
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_PAREN_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP_NO_NL,
			],
			// 'return' can't appear here, but 'yield' can
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_NO_NL,
			],
		],
		// Like PAREN_EXPRESSION, except that semicolon insertion can happen
		// See also EXPRESSION_NO_NL
		self::PAREN_EXPRESSION_NO_NL => [
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_PAREN_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP_NO_NL,
			],
			// 'yield' can appear here, because 'yield yield' is allowed
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_NO_NL,
			],
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			// BIN_OP seems impossible at the start of an expression, but it can happen in
			// yield *foo
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_AWAIT => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
		],
		// Like EXPRESSION_OP, but in parentheses, see PAREN_EXPRESSION
		self::PAREN_EXPRESSION_OP => [
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_DOT => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_DOT,
			],
			self::TYPE_HOOK => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_COLON => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_COMMA => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_SEMICOLON => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_ARROW => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_ARROWFUNC,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_PAREN_CLOSE => [
				self::ACTION_POP => true,
			],
		],

		// State after dot in PAREN_EXPRESSION, such as
		// `var x = (foo.`
		// `if (foo.`
		//
		// Like EXPRESSION_DOT, but in parentheses, see PAREN_EXPRESSION
		self::PAREN_EXPRESSION_DOT => [
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			// The following are keywords behaving as literals
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_IF => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_DO => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_VAR => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_FUNC => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_CLASS => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			// We don't expect real unary/binary operators here, but some keywords
			// (new, delete, void, typeof, instanceof, in) are classified as such, and they can be
			// used as property names
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
		],
		// Like EXPRESSION_ARROWFUNC, but in parentheses, see PAREN_EXPRESSION
		self::PAREN_EXPRESSION_ARROWFUNC => [
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_OP,
			],
		],

		// Like PAREN_EXPRESSION_OP, for the state after "async" in a PAREN_EXPRESSION,
		// for use by the $semicolon model.
		self::PAREN_EXPRESSION_OP_NO_NL => [
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_DOT => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_DOT,
			],
			self::TYPE_HOOK => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_COLON => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_COMMA => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_SEMICOLON => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_ARROW => [
				self::ACTION_GOTO => self::PAREN_EXPRESSION_ARROWFUNC,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PAREN_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_PAREN_CLOSE => [
				self::ACTION_POP => true,
			],
		],

		// State after `{ foo:` expecting an expression as the value of a key in an object literal.
		//
		// Like EXPRESSION, except that a comma (in PROPERTY_EXPRESSION_OP) goes to PROPERTY_ASSIGNMENT instead
		self::PROPERTY_EXPRESSION => [
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_BRACE_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_ASYNC,
			],
			// 'return' can't appear here, but 'yield' can
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_NO_NL,
			],
		],
		// Like PROPERTY_EXPRESSION, except that semicolon insertion can happen
		// See also EXPRESSION_NO_NL
		self::PROPERTY_EXPRESSION_NO_NL => [
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_BRACE_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			// 'yield' can appear here, because 'yield yield' is allowed
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_NO_NL,
			],
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			// BIN_OP seems impossible at the start of an expression, but it can happen in
			// yield *foo
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
		],

		// State after `{ foo: bar`
		//
		// Like EXPRESSION_OP, but in a property expression, see PROPERTY_EXPRESSION
		self::PROPERTY_EXPRESSION_OP => [
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			self::TYPE_DOT => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_DOT,
			],
			self::TYPE_HOOK => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION,
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_COMMA => [
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_ARROW => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_ARROWFUNC,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_BRACE_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
		],

		// State after `{ foo: async`
		//
		// Like PROPERTY_EXPRESSION_OP, but with an added TYPE_FUNC handler.
		//
		// This state exists to support "{ foo: async function() {",
		// which can't re-use PROPERTY_EXPRESSION_OP, because handling TYPE_FUNC there
		// would treat invalid "{ foo: bar function () {" as valid.
		//
		// For other cases we treat "async" like a literal key or key-less value.
		//
		// ```
		// var noAsyncHere = {
		//   async,
		//   async: 1,
		//   async() { return 2; },
		//   foo: async
		//   foo: async + 2,
		//   foo: async(),
		// }
		// ```
		self::PROPERTY_EXPRESSION_ASYNC => [
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			self::TYPE_DOT => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_DOT,
			],
			self::TYPE_HOOK => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION,
				self::ACTION_GOTO => self::EXPRESSION_TERNARY,
			],
			self::TYPE_COMMA => [
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_ARROW => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_ARROWFUNC,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_BRACE_CLOSE => [
				self::ACTION_POP => true,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
		],

		// State after `{ foo: bar.`
		//
		// Like EXPRESSION_DOT, but in a property expression, see PROPERTY_EXPRESSION
		self::PROPERTY_EXPRESSION_DOT => [
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			// The following are keywords behaving as literals
			self::TYPE_ASYNC => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_RETURN => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_IF => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_DO => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_VAR => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_FUNC => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_CLASS => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			// We don't expect real unary/binary operators here, but some keywords
			// (new, delete, void, typeof, instanceof, in) are classified as such, and they can be
			// used as property names
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_BIN_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
		],
		// Like EXPRESSION_ARROWFUNC, but in a property expression, see PROPERTY_EXPRESSION
		self::PROPERTY_EXPRESSION_ARROWFUNC => [
			self::TYPE_UN_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			self::TYPE_INCR_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			self::TYPE_ADD_OP => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION,
			],
			self::TYPE_BRACE_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::PROPERTY_EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_LITERAL => [
				self::ACTION_GOTO => self::PROPERTY_EXPRESSION_OP,
			],
		],
		// Class definition (after the class keyword). Expects a BindingIdentifier
		// and/or ClassHeritage, followed by {, which starts a class body. The class
		// body's closing } will pop the stack, so the state to return to after the
		// class definition should be pushed to the stack first.
		self::CLASS_DEF => [
			self::TYPE_BRACE_OPEN => [
				self::ACTION_GOTO => self::PROPERTY_ASSIGNMENT,
			],
			self::TYPE_PAREN_OPEN => [
				self::ACTION_PUSH => self::CLASS_DEF,
				self::ACTION_GOTO => self::PAREN_EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::CLASS_DEF,
				self::ACTION_GOTO => self::FUNC,
			],
		],
		// Import or export declaration
		self::IMPORT_EXPORT => [
			self::TYPE_SEMICOLON => [
				self::ACTION_GOTO => self::STATEMENT,
			],
			self::TYPE_VAR => [
				self::ACTION_GOTO => self::EXPRESSION,
			],
			self::TYPE_FUNC => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::FUNC,
			],
			self::TYPE_CLASS => [
				self::ACTION_PUSH => self::EXPRESSION_OP,
				self::ACTION_GOTO => self::CLASS_DEF,
			],
			self::TYPE_SPECIAL => [
				'default' => [
					self::ACTION_GOTO => self::EXPRESSION,
				],
				// Stay in this state for *, as, from
				'*' => [],
				'as' => [],
				'from' => [],
			],
		],
		// Used in template string-specific code below
		self::TEMPLATE_STRING_HEAD => [
			self::TYPE_LITERAL => [
				self::ACTION_PUSH => self::TEMPLATE_STRING_TAIL,
				self::ACTION_GOTO => self::EXPRESSION,
			],
		],
	];

	/**
	 * @var array $semicolon
	 *
	 * Rules for when semicolon insertion is appropriate. Semicolon insertion happens if we are
	 * in one of these states, and encounter one of these tokens preceded by a newline.
	 *
	 * This array is augmented by ensureExpandedStates().
	 */
	private static $semicolon = [
		self::EXPRESSION_NO_NL => [
			self::TYPE_UN_OP => true,
			// BIN_OP seems impossible at the start of an expression, but it can happen in
			// yield *foo
			self::TYPE_BIN_OP => true,
			self::TYPE_INCR_OP => true,
			self::TYPE_ADD_OP => true,
			self::TYPE_BRACE_OPEN => true,
			self::TYPE_PAREN_OPEN => true,
			self::TYPE_RETURN => true,
			self::TYPE_IF => true,
			self::TYPE_DO => true,
			self::TYPE_VAR => true,
			self::TYPE_FUNC => true,
			self::TYPE_CLASS => true,
			self::TYPE_LITERAL => true,
			self::TYPE_ASYNC => true,
		],
		self::EXPRESSION_TERNARY_NO_NL => [
			self::TYPE_UN_OP => true,
			// BIN_OP seems impossible at the start of an expression, but it can happen in
			// yield *foo
			self::TYPE_BIN_OP => true,
			self::TYPE_INCR_OP => true,
			self::TYPE_ADD_OP => true,
			self::TYPE_BRACE_OPEN => true,
			self::TYPE_PAREN_OPEN => true,
			self::TYPE_RETURN => true,
			self::TYPE_IF => true,
			self::TYPE_DO => true,
			self::TYPE_VAR => true,
			self::TYPE_FUNC => true,
			self::TYPE_CLASS => true,
			self::TYPE_LITERAL => true,
			self::TYPE_ASYNC => true,
		],
		self::PAREN_EXPRESSION_NO_NL => [
			self::TYPE_UN_OP => true,
			// BIN_OP seems impossible at the start of an expression, but it can happen in
			// yield *foo
			self::TYPE_BIN_OP => true,
			self::TYPE_INCR_OP => true,
			self::TYPE_ADD_OP => true,
			self::TYPE_BRACE_OPEN => true,
			self::TYPE_PAREN_OPEN => true,
			self::TYPE_RETURN => true,
			self::TYPE_IF => true,
			self::TYPE_DO => true,
			self::TYPE_VAR => true,
			self::TYPE_FUNC => true,
			self::TYPE_CLASS => true,
			self::TYPE_LITERAL => true,
			self::TYPE_ASYNC => true,
		],
		self::PROPERTY_EXPRESSION_NO_NL => [
			self::TYPE_UN_OP => true,
			// BIN_OP seems impossible at the start of an expression, but it can happen in
			// yield *foo
			self::TYPE_BIN_OP => true,
			self::TYPE_INCR_OP => true,
			self::TYPE_ADD_OP => true,
			self::TYPE_BRACE_OPEN => true,
			self::TYPE_PAREN_OPEN => true,
			self::TYPE_RETURN => true,
			self::TYPE_IF => true,
			self::TYPE_DO => true,
			self::TYPE_VAR => true,
			self::TYPE_FUNC => true,
			self::TYPE_CLASS => true,
			self::TYPE_LITERAL => true,
			self::TYPE_ASYNC => true,
		],
		self::EXPRESSION_OP => [
			self::TYPE_UN_OP => true,
			self::TYPE_INCR_OP => true,
			self::TYPE_BRACE_OPEN => true,
			self::TYPE_RETURN => true,
			self::TYPE_IF => true,
			self::TYPE_DO => true,
			self::TYPE_VAR => true,
			self::TYPE_FUNC => true,
			self::TYPE_CLASS => true,
			self::TYPE_LITERAL => true,
			self::TYPE_ASYNC => true,
		],
		self::EXPRESSION_END => [
			self::TYPE_UN_OP => true,
			self::TYPE_INCR_OP => true,
			self::TYPE_ADD_OP => true,
			self::TYPE_BRACE_OPEN => true,
			self::TYPE_PAREN_OPEN => true,
			self::TYPE_RETURN => true,
			self::TYPE_IF => true,
			self::TYPE_DO => true,
			self::TYPE_VAR => true,
			self::TYPE_FUNC => true,
			self::TYPE_CLASS => true,
			self::TYPE_LITERAL => true,
			self::TYPE_ASYNC => true,
		],
		self::PAREN_EXPRESSION_OP_NO_NL => [
			self::TYPE_FUNC => true,
		]
	];

	/**
	 * @var array $divStates
	 *
	 * States in which a / is a division operator. In all other states, it's the start of a regex.
	 *
	 * This array is augmented by self::ensureExpandedStates().
	 */
	private static $divStates = [
		self::EXPRESSION_OP             => true,
		self::EXPRESSION_TERNARY_OP     => true,
		self::PAREN_EXPRESSION_OP       => true,
		self::PROPERTY_EXPRESSION_OP    => true,
		self::PROPERTY_EXPRESSION_ASYNC => true
	];

	/**
	 * Add copies of all states but with negative numbers to self::$model (if not already present),
	 * to represent generator function states.
	 */
	private static function ensureExpandedStates() {
		// Already done?
		if ( self::$expandedStates ) {
			return;
		}
		self::$expandedStates = true;

		// Add copies of all states (except FUNC and GENFUNC) with negative numbers.
		// These negative states represent states inside generator functions. When in these states,
		// TYPE_YIELD is treated as TYPE_RETURN, otherwise as TYPE_LITERAL
		foreach ( self::$model as $state => $transitions ) {
			if ( $state === self::FUNC || $state === self::GENFUNC ) {
				continue;
			}
			foreach ( $transitions as $tokenType => $actions ) {
				foreach ( $actions as $action => $target ) {
					if ( !is_array( $target ) ) {
						self::$model[-$state][$tokenType][$action] = (
							$target === self::FUNC ||
							$target === true ||
							$target === self::GENFUNC
						) ? $target : -$target;
						continue;
					}

					foreach ( $target as $subaction => $subtarget ) {
						self::$model[-$state][$tokenType][$action][$subaction] = (
							$subtarget === self::FUNC ||
							$subtarget === true ||
							$subtarget === self::GENFUNC
						) ? $subtarget : -$subtarget;
					}
				}
			}
		}
		// Special cases:
		// '{' in a property assignment starts a method, so it shouldn't be flipped
		self::$model[-self::PROPERTY_ASSIGNMENT][self::TYPE_BRACE_OPEN][self::ACTION_GOTO] = self::STATEMENT;

		// Also add negative versions of states to the other arrays
		foreach ( self::$semicolon as $state => $value ) {
			self::$semicolon[-$state] = $value;
		}
		foreach ( self::$divStates as $state => $value ) {
			self::$divStates[-$state] = $value;
		}
	}

	/**
	 * Returns minified JavaScript code.
	 *
	 * @see MinifierState::setErrorHandler
	 * @param string $s JavaScript code to minify
	 * @param callable|null $onError Called with a ParseError object
	 * @return string Minified code
	 */
	public static function minify( $s, $onError = null ) {
		return self::minifyInternal( $s, null, $onError );
	}

	/**
	 * Create a minifier state object without source map capabilities
	 *
	 * Example:
	 *
	 *   JavaScriptMinifier::createMinifier()
	 *     ->addSourceFile( 'file.js', $source )
	 *     ->getMinifiedOutput();
	 *
	 * @return JavaScriptMinifierState
	 */
	public static function createMinifier() {
		return new JavaScriptMinifierState;
	}

	/**
	 * Create a minifier state object with source map capabilities
	 *
	 * Example:
	 *
	 *   $mapper = JavaScriptMinifier::createSourceMapState()
	 *     ->addSourceFile( 'file1.js', $source1 )
	 *     ->addOutput( "\n\n" )
	 *     ->addSourceFile( 'file2.js', $source2 );
	 *   $out = $mapper->getMinifiedOutput();
	 *   $map = $mapper->getSourceMap()
	 *
	 * @return JavaScriptMapperState
	 */
	public static function createSourceMapState() {
		return new JavaScriptMapperState;
	}

	/**
	 * Create a MinifierState that doesn't actually minify
	 *
	 * @return IdentityMinifierState
	 */
	public static function createIdentityMinifier() {
		return new IdentityMinifierState;
	}

	private static function getNextNonWhitespaceChar( string $s, int $pos ): ?string {
		$length = strlen( $s );
		// This is an exact copy of the whitespace/comment recognition in minifyInternal().
		// Keep the scanner logic in sync with the inlined version there.
		while ( $pos < $length ) {
			$skip = strspn( $s, " \t\n\r\xb\xc", $pos );
			if ( $skip ) {
				$pos += $skip;
				continue;
			}
			if ( substr( $s, $pos, 2 ) === '/*' ) {
				$end = strpos( $s, '*/', $pos + 2 );
				if ( $end === false ) {
					return null;
				}
				$pos = $end + 2;
				continue;
			}
			if (
				substr( $s, $pos, 2 ) === '//' ||
				substr( $s, $pos, 4 ) === '<!--' ||
				substr( $s, $pos, 3 ) === '-->'
			) {
				$skip = strcspn( $s, "\r\n", $pos );
				$pos += $skip;
				continue;
			}
			return $s[$pos];
		}
		return null;
	}

	/**
	 * Minify with optional source map.
	 *
	 * @internal
	 *
	 * @param string $s
	 * @param MappingsGenerator|null $mapGenerator
	 * @param callable|null $onError
	 * @param callable|null $onDebug See augmentDebugContext() for callback parameter
	 * @return string
	 */
	public static function minifyInternal( $s, $mapGenerator = null, $onError = null, $onDebug = null ) {
		self::ensureExpandedStates();

		// Optimization: alias static properties accessed in the hot loop to local variables.
		$opChars = self::$opChars;
		$multicharPuncTokens = self::MULTICHAR_PUNCTOKENS;
		$tokenTypes = self::$tokenTypes;
		$model = self::$model;
		$semicolon = self::$semicolon;
		$divStates = self::$divStates;
		$maxLineLength = self::$maxLineLength;

		// Here's where the minifying takes place: Loop through the input, looking for tokens
		// and output them to $out, taking actions to the above defined rules when appropriate.
		$error = null;
		$out = '';
		$pos = 0;
		$length = strlen( $s );
		$lineLength = 0;
		$plainDigits = false;
		$lastPlainDigits = false;
		$newlineFound = true;
		$state = self::STATEMENT;
		$stack = [];
		// Optimization: calling end( $stack ) repeatedly is expensive
		$topOfStack = null;
		// Pretend that we have seen a semicolon yet
		$last = ';';
		while ( $pos < $length ) {
			// First, skip over any whitespace and line breaks
			//
			// ECMAScript 13.0 § 12.2 White Space
			// https://262.ecma-international.org/13.0/#sec-white-space
			//
			// - U+0009 Tab (\t)
			// - U+000B Line Tabulation (VT, \v in JavaScript, \xb binary in PHP)
			// - U+000C Form Feed (FF, \f in JavaScript, \xc binary in PHP)
			// - U+0020 Space
			// - [Not implemented] U+00A0 No Break Space (NBSP)
			// - [Not implemented] U+FEFF Zero Width No-Break Space (ZWNBSP)
			// - [Not implemented] Any other Unicode "Space_Separator (Zs)" code point
			//
			// ECMAScript 13.0 § 12.3 Line Terminators
			// - U+000A Line Feed (LF, \n)
			// - U+000D Carriage Return (CR, \r)
			// - [Not implemented] U+2028 Line Separator (LS)
			// - [Not implemented] U+2029 Paragraph Separator (PS)
			//
			// The U+2028 and U+2029 codepoints are multibyte characters that are extremely unlikely
			// to appear in source code because there is no reason for either hand-written or
			// machine-generated code to use them as line terminators. ES2019 instead allowed
			// them in string literals to make JSON text a syntactic subset of ECMAScript.
			// We don't implement them as line terminators because doing so would slow down all
			// parsing, especially for "end of inline comment" and "end of identifier or reserved
			// word". It is acceptable that we simply don't support such input. In simple cases
			// such input would actually work fine, but it may cause invalid output.
			//
			// NOTE: We do support multibyte line terminators in multi-line string literals and
			// template string literals.
			//
			// Optimization: Rearrange with Space, Tab, and Line Feed first which are most common.
			//
			// Optimization: We inline getNextNonWhitespaceChar() here because it is a hot path.
			//
			// NOTE: Keep the scanner logic in sync with getNextNonWhitespaceChar().
			$skip = strspn( $s, " \t\n\r\xb\xc", $pos );
			if ( !$skip ) {
				$ch = $s[$pos];

				// Skip multiline comment. Search for the end token or EOT.
				if ( $ch === '/' && substr( $s, $pos, 2 ) === '/*' ) {
					$end = strpos( $s, '*/', $pos + 2 );
					$skip = $end === false ? $length - $pos : $end - $pos + 2;
				}
			}

			// Record whether we skipped over a newline in whitespace or multiline comment.
			// The semicolon insertion mechanism must know whether there was a newline between tokens.
			if ( $skip ) {
				if ( !$newlineFound && strcspn( $s, "\r\n", $pos, $skip ) !== $skip ) {
					$newlineFound = true;
				}
				if ( $mapGenerator ) {
					$mapGenerator->consumeSource( $skip );
				}
				$pos += $skip;
				continue;
			}
			// Handle C++-style comments and html comments, which are treated as single line
			// comments by the browser, regardless of whether the end tag is on the same line.
			// Handle --> the same way, but only if it's at the beginning of the line
			// @phan-suppress-next-line PhanPossiblyUndeclaredVariable
			if ( ( $ch === '/' && substr( $s, $pos, 2 ) === '//' )
				|| ( $ch === '<' && substr( $s, $pos, 4 ) === '<!--' )
				|| ( $ch === '-' && $newlineFound && substr( $s, $pos, 3 ) === '-->' )
			) {
				$skip = strcspn( $s, "\r\n", $pos );
				if ( $mapGenerator ) {
					$mapGenerator->consumeSource( $skip );
				}
				$pos += $skip;
				continue;
			}

			// Find out which kind of token we're handling.
			// Note: $end must point past the end of the current token
			// so that `substr($s, $pos, $end - $pos)` would be the entire token.
			// In order words, $end will be the offset of the last relevant character
			// in the stream + 1, or simply put: The offset of the first character
			// of any next token in the stream.
			$end = $pos + 1;
			// Handle string literals
			if ( $ch === "'" || $ch === '"' ) {
				// Search to the end of the string literal, skipping over backslash escapes
				$search = $ch . '\\';
				do {
					// Speculatively add 2 to the end so that if we see a backslash,
					// the next iteration will start 2 characters further (one for the
					// backslash, one for the escaped character).
					// We'll correct this outside the loop.
					$end += strcspn( $s, $search, $end ) + 2;
					// If the last character in our search for a quote or a backlash
					// matched a backslash and we haven't reached the end, keep searching..
				} while ( $end - 2 < $length && $s[$end - 2] === '\\' );
				// Correction (1): Undo speculative add, keep only one (end of string literal)
				$end--;
				if ( $end > $length ) {
					// Correction (2): Loop wrongly assumed an end quote ended the search,
					// but search ended because we've reached the end. Correct $end.
					// TODO: This is invalid and should throw.
					$end--;
				}

			// Handle template strings, either from "`" to begin a new string,
			// or continuation after the "}" that ends a "${"-expression.
			} elseif ( $ch === '`' || ( $ch === '}' && $topOfStack === self::TEMPLATE_STRING_TAIL ) ) {
				if ( $ch === '}' ) {
					// Pop the TEMPLATE_STRING_TAIL state off the stack
					// We don't let it get popped off the stack the normal way, to avoid the newline
					// and comment stripping code above running on the continuation of the literal
					array_pop( $stack );
					// Also pop the previous state off the stack
					$state = array_pop( $stack );
					$topOfStack = end( $stack );
				}
				// Search until we reach either a closing ` or a ${, skipping over backslash escapes
				// and $ characters followed by something other than { or `
				do {
					$end += strcspn( $s, '`$\\', $end ) + 1;
					if ( $end - 1 < $length && $s[$end - 1] === '`' ) {
						// End of the string, stop
						// We don't do this in the while() condition because the $end++ in the
						// backslash escape branch makes it difficult to do so without incorrectly
						// considering an escaped backtick (\`) the end of the string
						break;
					}
					if ( $end - 1 < $length && $s[$end - 1] === '\\' ) {
						// Backslash escape. Skip the next character, and keep going
						$end++;
						continue;
					}
					if ( $end < $length && $s[$end - 1] === '$' && $s[$end] === '{' ) {
						// Beginning of an expression in ${ ... }. Skip the {, and stop
						$end++;
						// Push the current state to the stack. We'll pop this off later when hitting
						// the end of this template string
						$stack[] = $state;
						$topOfStack = $state;
						// Change the state to TEMPLATE_STRING_HEAD. The token type will be detected
						// as TYPE_LITERAL, and this will cause the state machine to expect an
						// expression, then go to the TEMPLATE_STRING_TAIL state when it hits the }
						$state = self::TEMPLATE_STRING_HEAD;
						break;
					}
				} while ( $end - 1 < $length );
				if ( $end > $length ) {
					// Loop wrongly assumed an end quote or ${ ended the search,
					// but search ended because we've reached the end. Correct $end.
					// TODO: This is invalid and should throw.
					$end--;
				}

			// We have to distinguish between regexp literals and division operators
			// A division operator is only possible in certain states
			} elseif ( $ch === '/' && !isset( $divStates[$state] ) ) {
				// Regexp literal
				for ( ; ; ) {
					// Search until we find "/" (end of regexp), "\" (backslash escapes),
					// or "[" (start of character classes).
					do {
						// Speculatively add 2 to ensure next iteration skips
						// over backslash and escaped character.
						// We'll correct this outside the loop.
						$end += strcspn( $s, '/[\\', $end ) + 2;
						// If backslash escape, keep searching...
					} while ( $end - 2 < $length && $s[$end - 2] === '\\' );
					// Correction (1): Undo speculative add, keep only one (end of regexp)
					$end--;
					if ( $end > $length ) {
						// Correction (2): Loop wrongly assumed end slash was seen
						// String ended without end of regexp. Correct $end.
						// TODO: This is invalid and should throw.
						$end--;
						break;
					}
					if ( $s[$end - 1] === '/' ) {
						break;
					}
					// (Implicit else), we must've found the start of a char class,
					// skip until we find "]" (end of char class), or "\" (backslash escape)
					do {
						// Speculatively add 2 for backslash escape.
						// We'll substract one outside the loop.
						$end += strcspn( $s, ']\\', $end ) + 2;
						// If backslash escape, keep searching...
					} while ( $end - 2 < $length && $s[$end - 2] === '\\' );
					// Correction (1): Undo speculative add, keep only one (end of regexp)
					$end--;
					if ( $end > $length ) {
						// Correction (2): Loop wrongly assumed "]" was seen
						// String ended without ending char class or regexp. Correct $end.
						// TODO: This is invalid and should throw.
						$end--;
						break;
					}
				}
				// Search past the regexp modifiers (gi)
				while ( $end < $length && ctype_alpha( $s[$end] ) ) {
					$end++;
				}

			// @phan-suppress-next-line PhanParamSuspiciousOrder
			} elseif ( $ch === '0' && $pos + 1 < $length && str_contains( 'xXbBoO', $s[$pos + 1] ) ) {
				// Non-decimal integer literal, with optional BigInt suffix.
				$end++;
				$prefix = $s[$pos + 1];
				$digits = match ( $prefix ) {
					'x', 'X' => '0123456789ABCDEFabcdef',
					'b', 'B' => '01',
					'o', 'O' => '01234567',
				};
				$len = strspn( $s, $digits . '_', $end );
				if ( !$len && !$error ) {
					$base = match ( $prefix ) {
						'x', 'X' => 'hexadecimal',
						'b', 'B' => 'binary',
						'o', 'O' => 'octal',
					};
					$error = new ParseError(
						"Expected a $base number but found " . substr( $s, $pos, 5 ),
						$pos,
					);
				}
				$end += $len;
				if ( $end < $length && $s[$end] === 'n' ) {
					$end++;
				}
			} elseif (
				// Optimisation: This check must accept only ASCII digits 0-9.
				// Avoid ctype_digit() because it is slower and also accepts locale-specific digits.
				// Using is_numeric() might seem wrong also as it accepts negative numbers, decimal
				// numbers, and exponents (e.g. strings like "+012.34e6"). But, it is fine here
				// because we know $ch is a single character, and we believe the only single
				// characters that is_numeric() accepts are ASCII digits 0-9.
				is_numeric( $ch )
				|| ( $ch === '.' && $pos + 1 < $length && is_numeric( $s[$pos + 1] ) )
			) {
				$end += strspn( $s, '0123456789_', $end );
				if ( $ch === '.' ) {
					// Valid: ".42" (number literal, fraction with implied zero)
					// Valid: ".42_000"
					$decimal = 1;
				} else {
					$decimal = strspn( $s, '.', $end );
					if ( $decimal ) {
						// Valid: "5." (number literal, optional fraction)
						// Valid: "5_0." (number literal, optional fraction)
						// Valid: "5.42" (number literal)
						// Valid: "5..toString" (number literal "5.", followed by member expression)
						// Valid: "5..a_100"    (number literal "5.", followed by member expression)
						// Valid: "5. .a_100"   (number literal "5.", followed by member expression)
						// Valid: "5_0.4_2.toString" (number "50.42", followed by member expression)
						// Invalid: "5..42"
						// Invalid: "5...42"
						// Invalid: "5...toString"
						// Invalid: "5._.toString" (numeric separator must be between digits, undetected)
						// Invalid: "5_.toString" (numeric separator not allowed at end of number, undetected)
						$fraction = strspn( $s, '0123456789_', $end + $decimal );
						if ( $decimal === 2 && !$fraction ) {
							// Rewind one character, so that the member expression dot
							// will be parsed as the next token (TYPE_DOT).
							$decimal = 1;
						}
						if ( $decimal > 1 && !$error ) {
							$error = new ParseError( 'Too many decimal points', $end );
						}
						$end += $decimal + $fraction;
					} else {
						// Valid: "42"
						// Valid: "42_000"
						// Invalid: "5_" (numeric separator not allowed at end of number, undetected)
						$plainDigits = true;
					}
				}
				$exponent = strspn( $s, 'eE', $end );
				if ( $exponent ) {
					if ( $exponent > 1 && !$error ) {
						$error = new ParseError( 'Number with several E', $end );
					}
					$end += $exponent;

					// + sign is optional; - sign is required.
					$end += strspn( $s, '-+', $end );
					$len = strspn( $s, '0123456789_', $end );
					if ( !$len && !$error ) {
						$error = new ParseError(
							'Missing decimal digits after exponent',
							$pos
						);
					}
					$end += $len;
					$plainDigits = false;
				}
				if ( !$decimal && !$exponent && $end < $length && $s[$end] === 'n' ) {
					$end++;
					$plainDigits = false;
				}
			} elseif ( isset( $multicharPuncTokens[$ch] ) ) {
				// Optimization: Parse multi-character punctuation operators with direct lookahead
				// <https://gerrit.wikimedia.org/r/c/mediawiki/libs/Minify/+/1221106>
				if (
					$pos + 1 < $length &&
					// phpcs:ignore Generic.CodeAnalysis.AssignmentInCondition.Found
					( $submap2 = $multicharPuncTokens[$ch][$s[$pos + 1]] ?? null )
				) {
					if (
						$ch === '?' &&
						$s[$pos + 1] === '.' &&
						$pos + 2 < $length &&
						is_numeric( $s[$pos + 2] )
					) {
						// ECMAScript 13.0 § 12.7 Punctuators
						// OptionalChainingPunctuator is not recognised before a decimal digit.
					} elseif ( $submap2 === 2 ) {
						// Optimization: Shortcut for the common case of an unambiguous 2-char punctuation token
						$end = $pos + 2;
					} else {
						$next3 = $pos + 2 < $length ? $s[$pos + 2] : '';
						$next4 = $pos + 3 < $length ? $s[$pos + 3] : '';
						// 4-char token,
						// or 3-char token,
						// or 2-char token that is a subset of a not-seen 3- or 4-char token
						//
						// NOTE: The `1` fallback ensures graceful handling of invalid syntax like `..*`,
						// instead of causing infinite recursion. We don't need to set `$pos + 1`, because
						// that is the default, but we assign unconditionally here because all valid syntax
						// needs an assignment. Adding checks to avoid it for invalid syntax doesn't pay off.
						$end = $pos + ( $submap2[$next3][$next4] ?? $submap2[$next3][''] ?? $submap2[''] ?? 1 );
					}
				}
				// All other opChars ({, }, (, ), [, ], :, ;, ,, ~, etc) are single-char tokens
				// so $end (which is $pos + 1) is already correct.
			} elseif ( !isset( $opChars[$ch] ) ) {
				// Identifier or reserved word. Search for the end by excluding whitespace and
				// punctuation.
				$end += strcspn( $s, " \t\n.;,=<>+-{}()[]?:*/%'\"`!&|^~\xb\xc\r", $end );
			}

			// Now get the token type from our type array
			// so $end - $pos == strlen( $token )
			$token = substr( $s, $pos, $end - $pos );
			$isImportExpression = (
				$token === 'import' &&
				abs( $state ) === self::STATEMENT &&
				in_array( self::getNextNonWhitespaceChar( $s, $end ), [ '(', '.' ], true )
			);
			$type = !$isImportExpression && isset( $model[$state][self::TYPE_SPECIAL][$token] )
				? self::TYPE_SPECIAL
				: $tokenTypes[$token] ?? self::TYPE_LITERAL;
			if ( $type === self::TYPE_YIELD ) {
				// yield is treated as TYPE_RETURN inside a generator function (negative state)
				// but as TYPE_LITERAL when not in a generator function (positive state)
				$type = $state < 0 ? self::TYPE_RETURN : self::TYPE_LITERAL;
			}

			$pad = '';

			if ( $newlineFound && isset( $semicolon[$state][$type] ) ) {
				// This token triggers the semicolon insertion mechanism of javascript. While we
				// could add the ; token here ourselves, keeping the newline has a few advantages.
				$pad = "\n";
				$state = $state < 0 ? -self::STATEMENT : self::STATEMENT;
				$lineLength = 0;
			// This check adds a new line if we have exceeded the max length and only does this if
			// a newline was found in this this position, if it wasn't, it uses the next available
			// line break
			} elseif ( $newlineFound &&
				$lineLength + $end - $pos > $maxLineLength &&
				!isset( $semicolon[$state][$type] ) &&
				$type !== self::TYPE_INCR_OP &&
				$type !== self::TYPE_ARROW
			) {
				$pad = "\n";
				$lineLength = 0;
			// Class fields can omit semicolons, so need to preserve newlines after them.
			// Preserve all line breaks before non-punctuation tokens in class bodies.
			} elseif ( $newlineFound &&
				$state === self::PROPERTY_ASSIGNMENT &&
				$topOfStack === self::STATEMENT &&
				!isset( $opChars[$ch] )
			) {
				$pad = "\n";
				$lineLength = 0;
			// Check, whether we have to separate the token from the last one with whitespace
			} elseif ( !isset( $opChars[$last] ) && !isset( $opChars[$ch] ) ) {
				$pad = ' ';
				$lineLength++;
			// Don't accidentally create ++, -- or // tokens
			} elseif ( $last === $ch && ( $ch === '+' || $ch === '-' || $ch === '/' ) ) {
				$pad = ' ';
				$lineLength++;
			// Don't create invalid dot notation after number literal (T303827).
			// Keep whitespace in "42. foo".
			// But keep minifying "foo.bar", "42..foo", and "42.0.foo" per $opChars.
			} elseif ( $lastPlainDigits && $type === self::TYPE_DOT && $token !== '?.' ) {
				$pad = ' ';
				$lineLength++;
			}

			if ( $onDebug ) {
				$onDebug( self::augmentDebugContext( [
					'stack' => $stack,
					'last' => $last,
					'state' => $state,
					'pos' => $pos,
					'ch' => $ch,
					'token' => $token,
					'type' => $type,
				] ) );
			}

			if ( $mapGenerator ) {
				$mapGenerator->outputSpace( $pad );
				$mapGenerator->outputToken( $token );
				$mapGenerator->consumeSource( $end - $pos );
			}
			$out .= $pad;
			$out .= $token;
			$lineLength += $end - $pos;
			$last = $s[$end - 1];
			$pos = $end;
			$newlineFound = false;
			$lastPlainDigits = $plainDigits;
			$plainDigits = false;

			// Now that we have output our token, transition into the new state.
			$actions = $type === self::TYPE_SPECIAL ?
				$model[$state][$type][$token] :
				$model[$state][$type] ?? [];
			if ( isset( $actions[self::ACTION_PUSH] ) &&
				count( $stack ) < self::STACK_LIMIT
			) {
				$topOfStack = $actions[self::ACTION_PUSH];
				$stack[] = $topOfStack;
			}
			if ( $stack && isset( $actions[self::ACTION_POP] ) ) {
				$state = array_pop( $stack );
				$topOfStack = end( $stack );
			} elseif ( isset( $actions[self::ACTION_GOTO] ) ) {
				$state = $actions[self::ACTION_GOTO];
			}
		}
		if ( $onError && $error ) {
			$onError( $error );
		}
		return $out;
	}

	/**
	 * Replace integer values with the corresponding class constant names
	 *
	 * @param array $context
	 * - int[] 'stack' List of states (class constants)
	 * - string 'last' Previous character from input stream
	 * - int 'state' Current state as result of previous character (class constant)
	 * - int 'pos' Offset of current character in input stream
	 * - string 'ch' Current character in input stream, first character of current token
	 * - string 'token' Current token from input stream
	 * - int 'type' Current type as interpreted from the current character
	 *
	 * @return array The $context, with any integer class constants replaced by
	 * their corresponding class constant name as a string (if found), or else
	 * their given integer value.
	 */
	private static function augmentDebugContext( array $context ) {
		$self = new ReflectionClass( self::class );
		foreach ( $self->getConstants() as $name => $value ) {
			if ( !is_int( $value ) ) {
				continue;
			}
			foreach ( $context['stack'] as $i => $state ) {
				if ( $state === $value ) {
					$context['stack'][$i] = $name;
				} elseif ( $state === -$value ) {
					$context['stack'][$i] = '-' . $name;
				}
			}
			if ( $context['state'] === $value ) {
				$context['state'] = $name;
			} elseif ( $context['state'] === -$value ) {
				$context['state'] = '-' . $name;
			}
			if ( $context['type'] === $value ) {
				$context['type'] = $name;
			}
		}

		return $context;
	}
}