@engine262/engine262 0.0.1-07c72085c73f960bcf0aa06db807321f3b446518

package/src/static-semantics/LexicallyDeclaredNames.mts

@@ -0,0 +1,26 @@
+import type { ParseNode } from '../parser/ParseNode.mts';
+import type { JSStringValue } from '../value.mts';
+import {
+  TopLevelLexicallyDeclaredNames,
+} from './all.mts';
+
+export function LexicallyDeclaredNames(node: ParseNode): JSStringValue[] {
+  switch (node.type) {
+    case 'Script':
+      if (node.ScriptBody) {
+        return LexicallyDeclaredNames(node.ScriptBody);
+      }
+      return [];
+    case 'ScriptBody':
+      return TopLevelLexicallyDeclaredNames(node.StatementList);
+    case 'FunctionBody':
+    case 'GeneratorBody':
+    case 'AsyncBody':
+    case 'AsyncGeneratorBody':
+      return TopLevelLexicallyDeclaredNames(node.FunctionStatementList);
+    case 'ClassStaticBlockBody':
+      return TopLevelLexicallyDeclaredNames(node.ClassStaticBlockStatementList);
+    default:
+      return [];
+  }
+}

package/src/static-semantics/LexicallyScopedDeclarations.mts

@@ -0,0 +1,82 @@
+import { isArray } from '../helpers.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+import { TopLevelLexicallyScopedDeclarations, DeclarationPart } from './all.mts';
+
+export function LexicallyScopedDeclarations(node: ParseNode | readonly ParseNode[]): (ParseNode.Declaration | ParseNode.ExportDeclaration)[] {
+  if (isArray(node)) {
+    const declarations = [];
+    for (const item of node) {
+      declarations.push(...LexicallyScopedDeclarations(item));
+    }
+    return declarations;
+  }
+  switch (node.type) {
+    case 'LabelledStatement':
+      return LexicallyScopedDeclarations(node.LabelledItem);
+    case 'Script':
+      if (node.ScriptBody) {
+        return LexicallyScopedDeclarations(node.ScriptBody);
+      }
+      return [];
+    case 'ScriptBody':
+      return TopLevelLexicallyScopedDeclarations(node.StatementList);
+    case 'Module':
+      if (node.ModuleBody) {
+        return LexicallyScopedDeclarations(node.ModuleBody);
+      }
+      return [];
+    case 'ModuleBody':
+      return LexicallyScopedDeclarations(node.ModuleItemList);
+    case 'FunctionBody':
+    case 'GeneratorBody':
+    case 'AsyncBody':
+    case 'AsyncGeneratorBody':
+      return TopLevelLexicallyScopedDeclarations(node.FunctionStatementList);
+    case 'ClassStaticBlockBody':
+      return TopLevelLexicallyScopedDeclarations(node.ClassStaticBlockStatementList);
+    case 'ImportDeclaration':
+      return [];
+    case 'ClassDeclaration':
+    case 'LexicalDeclaration':
+    case 'FunctionDeclaration':
+    case 'GeneratorDeclaration':
+    case 'AsyncFunctionDeclaration':
+    case 'AsyncGeneratorDeclaration':
+      return [DeclarationPart(node)];
+    case 'CaseBlock': {
+      const names = [];
+      if (node.CaseClauses_a) {
+        names.push(...LexicallyScopedDeclarations(node.CaseClauses_a));
+      }
+      if (node.DefaultClause) {
+        names.push(...LexicallyScopedDeclarations(node.DefaultClause));
+      }
+      if (node.CaseClauses_b) {
+        names.push(...LexicallyScopedDeclarations(node.CaseClauses_b));
+      }
+      return names;
+    }
+    case 'CaseClause':
+    case 'DefaultClause':
+      if (node.StatementList) {
+        return LexicallyScopedDeclarations(node.StatementList);
+      }
+      return [];
+    case 'ExportDeclaration':
+      if (node.Declaration) {
+        return [DeclarationPart(node.Declaration)];
+      }
+      if (node.HoistableDeclaration) {
+        return [DeclarationPart(node.HoistableDeclaration)];
+      }
+      if (node.ClassDeclaration) {
+        return [node.ClassDeclaration];
+      }
+      if (node.AssignmentExpression) {
+        return [node];
+      }
+      return [];
+    default:
+      return [];
+  }
+}

package/src/static-semantics/ModuleRequests.mts

@@ -0,0 +1,34 @@
+import type { ParseNode } from '../parser/ParseNode.mts';
+import type { JSStringValue } from '../value.mts';
+import { StringValue } from './all.mts';
+
+export function ModuleRequests(node: ParseNode): JSStringValue[] {
+  switch (node.type) {
+    case 'Module':
+      if (node.ModuleBody) {
+        return ModuleRequests(node.ModuleBody);
+      }
+      return [];
+    case 'ModuleBody': {
+      const moduleNames: JSStringValue[] = [];
+      for (const item of node.ModuleItemList) {
+        moduleNames.push(...ModuleRequests(item));
+      }
+      return moduleNames;
+    }
+    case 'ImportDeclaration':
+      if (node.FromClause) {
+        return ModuleRequests(node.FromClause);
+      }
+      return [StringValue(node.ModuleSpecifier!)];
+    case 'ExportDeclaration':
+      if (node.FromClause) {
+        return ModuleRequests(node.FromClause);
+      }
+      return [];
+    case 'StringLiteral':
+      return [StringValue(node)];
+    default:
+      return [];
+  }
+}

package/src/static-semantics/NonConstructorElements.mts

@@ -0,0 +1,15 @@
+import type { ParseNode } from '../parser/ParseNode.mts';
+import { PropName } from './all.mts';
+
+/** https://tc39.es/ecma262/#sec-static-semantics-nonconstructorelements */
+// ClassElementList :
+//   ClassElement
+//   ClassElementList ClassElement
+export function NonConstructorElements(ClassElementList: ParseNode.ClassElementList) {
+  return ClassElementList.filter((ClassElement) => {
+    if (ClassElement.static === false && PropName(ClassElement) === 'constructor') {
+      return false;
+    }
+    return true;
+  });
+}

package/src/static-semantics/NumericValue.mts

@@ -0,0 +1,7 @@
+/** https://tc39.es/ecma262/#sec-numericvalue */
+import type { ParseNode } from '../parser/ParseNode.mts';
+import { Value } from '../value.mts';
+
+export function NumericValue(node: ParseNode.NumericLiteral) {
+  return Value(node.value);
+}

package/src/static-semantics/PrivateBoundIdentifiers.mts

@@ -0,0 +1,23 @@
+import { isArray } from '../helpers.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+import type { JSStringValue } from '../value.mts';
+import { StringValue } from './all.mts';
+
+/** https://tc39.es/ecma262/#sec-static-semantics-privateboundidentifiers */
+export function PrivateBoundIdentifiers(node: ParseNode | readonly ParseNode[]): JSStringValue[] {
+  if (isArray(node)) {
+    return node.flatMap((n) => PrivateBoundIdentifiers(n));
+  }
+  switch (node.type) {
+    case 'PrivateIdentifier':
+      return [StringValue(node)];
+    case 'MethodDefinition':
+    case 'GeneratorMethod':
+    case 'AsyncMethod':
+    case 'AsyncGeneratorMethod':
+    case 'FieldDefinition':
+      return PrivateBoundIdentifiers(node.ClassElementName);
+    default:
+      return [];
+  }
+}

package/src/static-semantics/PropName.mts

@@ -0,0 +1,18 @@
+import type { ParseNode } from '../parser/ParseNode.mts';
+
+export function PropName(node: ParseNode): string | undefined {
+  switch (node.type) {
+    case 'IdentifierName':
+      return node.name;
+    case 'StringLiteral':
+      return node.value;
+    case 'MethodDefinition':
+    case 'GeneratorMethod':
+    case 'AsyncGeneratorMethod':
+    case 'AsyncMethod':
+    case 'FieldDefinition':
+      return PropName(node.ClassElementName);
+    default:
+      return undefined;
+  }
+}

package/src/static-semantics/StringToCodePoints.mts

@@ -0,0 +1,23 @@
+import { X } from '../completion.mts';
+import { CodePointAt } from './all.mts';
+
+/** https://tc39.es/ecma262/#sec-stringtocodepoints */
+export function StringToCodePoints(string: string) {
+  // 1. Let codePoints be a new empty List.
+  const codePoints = [];
+  // 2. Let size be the length of string.
+  const size = string.length;
+  // 3. Let position be 0.
+  let position = 0;
+  // 4. Repeat, while position < size,
+  while (position < size) {
+    // a. Let cp be ! CodePointAt(string, position).
+    const cp = X(CodePointAt(string, position));
+    // b. Append cp.[[CodePoint]] to codePoints.
+    codePoints.push(cp.CodePoint);
+    // c. Set position to position + cp.[[CodeUnitCount]].
+    position += cp.CodeUnitCount;
+  }
+  // 5. Return codePoints.
+  return codePoints;
+}

package/src/static-semantics/StringValue.mts

@@ -0,0 +1,19 @@
+import { Value } from '../value.mts';
+import { OutOfRange } from '../helpers.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+
+export function StringValue(node: ParseNode) {
+  switch (node.type) {
+    case 'IdentifierName':
+    case 'BindingIdentifier':
+    case 'IdentifierReference':
+    case 'LabelIdentifier':
+      return Value(node.name);
+    case 'PrivateIdentifier':
+      return Value(`#${node.name}`);
+    case 'StringLiteral':
+      return Value(node.value);
+    default:
+      throw new OutOfRange('StringValue', node);
+  }
+}

package/src/static-semantics/TemplateStrings.mts

@@ -0,0 +1,108 @@
+import { Value } from '../value.mts';
+import { isHexDigit, isDecimalDigit, isLineTerminator } from '../parser/Lexer.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+
+export function TV(s: string) {
+  let buffer = '';
+  for (let i = 0; i < s.length; i += 1) {
+    if (s[i] === '\\') {
+      i += 1;
+      switch (s[i]) {
+        case '$':
+          buffer += '$';
+          break;
+        case '\\':
+          buffer += '\\';
+          break;
+        case '`':
+          buffer += '`';
+          break;
+        case '\'':
+          buffer += '\'';
+          break;
+        case '"':
+          buffer += '"';
+          break;
+        case 'b':
+          buffer += '\b';
+          break;
+        case 'f':
+          buffer += '\f';
+          break;
+        case 'n':
+          buffer += '\n';
+          break;
+        case 'r':
+          buffer += '\r';
+          break;
+        case 't':
+          buffer += '\t';
+          break;
+        case 'v':
+          buffer += '\v';
+          break;
+        case 'x':
+          i += 1;
+          if (isHexDigit(s[i]) && isHexDigit(s[i + 1])) {
+            const n = Number.parseInt(s.slice(i, i + 2), 16);
+            i += 1;
+            buffer += String.fromCharCode(n);
+          } else {
+            return undefined;
+          }
+          break;
+        case 'u':
+          i += 1;
+          if (s[i] === '{') {
+            i += 1;
+            const start = i;
+            do {
+              i += 1;
+            } while (isHexDigit(s[i]));
+            if (s[i] !== '}') {
+              return undefined;
+            }
+            const n = Number.parseInt(s.slice(start, i), 16);
+            if (n > 0x10FFFF) {
+              return undefined;
+            }
+            buffer += String.fromCodePoint(n);
+          } else if (isHexDigit(s[i]) && isHexDigit(s[i + 1])
+                     && isHexDigit(s[i + 2]) && isHexDigit(s[i + 3])) {
+            const n = Number.parseInt(s.slice(i, i + 4), 16);
+            i += 3;
+            buffer += String.fromCodePoint(n);
+          } else {
+            return undefined;
+          }
+          break;
+        case '0':
+          if (isDecimalDigit(s[i + 1])) {
+            return undefined;
+          }
+          return '\u{0000}';
+        default:
+          if (isLineTerminator(s)) {
+            return '';
+          }
+          return undefined;
+      }
+    } else {
+      buffer += s[i];
+    }
+  }
+  return buffer;
+}
+
+export function TemplateStrings(node: ParseNode.TemplateLiteral, raw: boolean) {
+  if (raw) {
+    return node.TemplateSpanList.map((s) => Value(s));
+  }
+  return node.TemplateSpanList.map((v) => {
+    const tv = TV(v);
+    if (tv === undefined) {
+      return Value.undefined;
+    }
+    return Value(tv);
+  });
+}

package/src/static-semantics/TopLevelLexicallyDeclaredNames.mts

@@ -0,0 +1,21 @@
+import { isArray } from '../helpers.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+import type { JSStringValue } from '../value.mts';
+import { BoundNames } from './all.mts';
+
+export function TopLevelLexicallyDeclaredNames(node: ParseNode | readonly ParseNode[]): JSStringValue[] {
+  if (isArray(node)) {
+    const names = [];
+    for (const StatementListItem of node) {
+      names.push(...TopLevelLexicallyDeclaredNames(StatementListItem));
+    }
+    return names;
+  }
+  switch (node.type) {
+    case 'ClassDeclaration':
+    case 'LexicalDeclaration':
+      return BoundNames(node);
+    default:
+      return [];
+  }
+}

package/src/static-semantics/TopLevelLexicallyScopedDeclarations.mts

@@ -0,0 +1,23 @@
+import { isArray } from '../helpers.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+
+export function TopLevelLexicallyScopedDeclarations(node: ParseNode | readonly ParseNode[]): LexicallyScopedDeclaration[] {
+  if (isArray(node)) {
+    const declarations = [];
+    for (const item of node) {
+      declarations.push(...TopLevelLexicallyScopedDeclarations(item));
+    }
+    return declarations;
+  }
+  switch (node.type) {
+    case 'ClassDeclaration':
+    case 'LexicalDeclaration':
+      return [node];
+    default:
+      return [];
+  }
+}
+
+export type LexicallyScopedDeclaration =
+  | ParseNode.ClassDeclaration
+  | ParseNode.LexicalDeclaration;

package/src/static-semantics/TopLevelVarDeclaredNames.mts

@@ -0,0 +1,26 @@
+import { isArray } from '../helpers.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+import type { JSStringValue } from '../value.mts';
+import { BoundNames, VarDeclaredNames } from './all.mts';
+
+export function TopLevelVarDeclaredNames(node: ParseNode | readonly ParseNode[]): JSStringValue[] {
+  if (isArray(node)) {
+    const names = [];
+    for (const item of node) {
+      names.push(...TopLevelVarDeclaredNames(item));
+    }
+    return names;
+  }
+  switch (node.type) {
+    case 'ClassDeclaration':
+    case 'LexicalDeclaration':
+      return [];
+    case 'FunctionDeclaration':
+    case 'GeneratorDeclaration':
+    case 'AsyncFunctionDeclaration':
+    case 'AsyncGeneratorDeclaration':
+      return BoundNames(node);
+    default:
+      return VarDeclaredNames(node);
+  }
+}

package/src/static-semantics/TopLevelVarScopedDeclarations.mts

@@ -0,0 +1,34 @@
+import { isArray } from '../helpers.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+import { DeclarationPart, VarScopedDeclarations } from './all.mts';
+
+export function TopLevelVarScopedDeclarations(node: ParseNode | readonly ParseNode[]): VarScopedDeclaration[] {
+  if (isArray(node)) {
+    const declarations = [];
+    for (const item of node) {
+      declarations.push(...TopLevelVarScopedDeclarations(item));
+    }
+    return declarations;
+  }
+  switch (node.type) {
+    case 'ClassDeclaration':
+    case 'LexicalDeclaration':
+      return [];
+    case 'FunctionDeclaration':
+    case 'GeneratorDeclaration':
+    case 'AsyncFunctionDeclaration':
+    case 'AsyncGeneratorDeclaration':
+      return [DeclarationPart(node)];
+    default:
+      return VarScopedDeclarations(node);
+  }
+}
+
+export type VarScopedDeclaration =
+  | ParseNode.ForBinding
+  | ParseNode.VariableDeclaration
+  | ParseNode.FunctionDeclaration
+  | ParseNode.GeneratorDeclaration
+  | ParseNode.AsyncFunctionDeclaration
+  | ParseNode.AsyncGeneratorDeclaration
+  | ParseNode.BindingIdentifier;

package/src/static-semantics/UTF16EncodeCodePoint.mts

@@ -0,0 +1,17 @@
+import { Assert } from '../abstract-ops/all.mts';
+
+/** https://tc39.es/ecma262/#sec-utf16encodecodepoint */
+export function UTF16EncodeCodePoint(cp: number) {
+  // 1. Assert: 0 ≤ cp ≤ 0x10FFFF.
+  Assert(cp >= 0 && cp <= 0x10FFFF);
+  // 2. If cp ≤ 0xFFFF, return the String value consisting of the code unit whose value is cp.
+  if (cp <= 0xFFFF) {
+    return String.fromCodePoint(cp);
+  }
+  // 3. Let cu1 be the code unit whose value is floor((cp - 0x10000) / 0x400) + 0xD800.
+  const cu1 = Math.floor((cp - 0x10000) / 0x400) + 0xD800;
+  // 4. Let cu2 be the code unit whose value is ((cp - 0x10000) modulo 0x400) + 0xDC00.
+  const cu2 = ((cp - 0x10000) % 0x400) + 0xDC00;
+  // 5. Return the string-concatenation of cu1 and cu2.
+  return String.fromCodePoint(cu1, cu2);
+}

package/src/static-semantics/UTF16SurrogatePairToCodePoint.mts

@@ -0,0 +1,12 @@
+import { Assert } from '../abstract-ops/all.mts';
+import { isLeadingSurrogate, isTrailingSurrogate } from '../parser/Lexer.mts';
+
+/** https://tc39.es/ecma262/#sec-utf16decodesurrogatepair */
+export function UTF16SurrogatePairToCodePoint(lead: number, trail: number) {
+  // 1. Assert: lead is a leading surrogate and trail is a trailing surrogate.
+  Assert(isLeadingSurrogate(lead) && isTrailingSurrogate(trail));
+  // 2. Let cp be (lead - 0xD800) × 0x400 + (trail - 0xDC00) + 0x10000.
+  const cp = (lead - 0xD800) * 0x400 + (trail - 0xDC00) + 0x10000;
+  // 3. Return the code point cp.
+  return cp;
+}

package/src/static-semantics/VarDeclaredNames.mts

@@ -0,0 +1,109 @@
+import { isArray } from '../helpers.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+import type { JSStringValue } from '../value.mts';
+import { BoundNames, TopLevelVarDeclaredNames } from './all.mts';
+
+export function VarDeclaredNames(node: ParseNode | readonly ParseNode[]): JSStringValue[] {
+  if (isArray(node)) {
+    const names = [];
+    for (const item of node) {
+      names.push(...VarDeclaredNames(item));
+    }
+    return names;
+  }
+  switch (node.type) {
+    case 'VariableStatement':
+      return BoundNames(node.VariableDeclarationList);
+    case 'VariableDeclaration':
+      return BoundNames(node);
+    case 'IfStatement': {
+      const names = VarDeclaredNames(node.Statement_a);
+      if (node.Statement_b) {
+        names.push(...VarDeclaredNames(node.Statement_b));
+      }
+      return names;
+    }
+    case 'Block':
+      return VarDeclaredNames(node.StatementList);
+    case 'WhileStatement':
+      return VarDeclaredNames(node.Statement);
+    case 'DoWhileStatement':
+      return VarDeclaredNames(node.Statement);
+    case 'ForStatement': {
+      const names = [];
+      if (node.VariableDeclarationList) {
+        names.push(...VarDeclaredNames(node.VariableDeclarationList));
+      }
+      names.push(...VarDeclaredNames(node.Statement));
+      return names;
+    }
+    case 'ForInStatement':
+    case 'ForOfStatement':
+    case 'ForAwaitStatement': {
+      const names = [];
+      if (node.ForBinding) {
+        names.push(...BoundNames(node.ForBinding));
+      }
+      names.push(...VarDeclaredNames(node.Statement));
+      return names;
+    }
+    case 'WithStatement':
+      return VarDeclaredNames(node.Statement);
+    case 'SwitchStatement':
+      return VarDeclaredNames(node.CaseBlock);
+    case 'CaseBlock': {
+      const names = [];
+      if (node.CaseClauses_a) {
+        names.push(...VarDeclaredNames(node.CaseClauses_a));
+      }
+      if (node.DefaultClause) {
+        names.push(...VarDeclaredNames(node.DefaultClause));
+      }
+      if (node.CaseClauses_b) {
+        names.push(...VarDeclaredNames(node.CaseClauses_b));
+      }
+      return names;
+    }
+    case 'CaseClause':
+    case 'DefaultClause':
+      if (node.StatementList) {
+        return VarDeclaredNames(node.StatementList);
+      }
+      return [];
+    case 'LabelledStatement':
+      return VarDeclaredNames(node.LabelledItem);
+    case 'TryStatement': {
+      const names = VarDeclaredNames(node.Block);
+      if (node.Catch) {
+        names.push(...VarDeclaredNames(node.Catch));
+      }
+      if (node.Finally) {
+        names.push(...VarDeclaredNames(node.Finally));
+      }
+      return names;
+    }
+    case 'Catch':
+      return VarDeclaredNames(node.Block);
+    case 'Script':
+      if (node.ScriptBody) {
+        return VarDeclaredNames(node.ScriptBody);
+      }
+      return [];
+    case 'ScriptBody':
+      return TopLevelVarDeclaredNames(node.StatementList);
+    case 'FunctionBody':
+    case 'GeneratorBody':
+    case 'AsyncBody':
+    case 'AsyncGeneratorBody':
+      return TopLevelVarDeclaredNames(node.FunctionStatementList);
+    case 'ClassStaticBlockBody':
+      return TopLevelVarDeclaredNames(node.ClassStaticBlockStatementList);
+    case 'ExportDeclaration':
+      if (node.VariableStatement) {
+        return BoundNames(node);
+      }
+      return [];
+    default:
+      return [];
+  }
+}