@engine262/engine262 0.0.1-0574c6b92a2925de851f895445b7cfd7e97cc0ba

package/src/static-semantics/PropName.mts

@@ -0,0 +1,23 @@
+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);
+    case 'PropertyDefinition':
+      if (node.PropertyName) {
+        return PropName(node.PropertyName);
+      }
+      break;
+    default:
+  }
+  return undefined;
+}

package/src/static-semantics/StringToCodePoints.mts

@@ -0,0 +1,22 @@
+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 = 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,109 @@
+import { Value } from '../value.mts';
+import { isHexDigit, isDecimalDigit, isLineTerminator } from '../parser/Lexer.mts';
+import type { ParseNode } from '../parser/ParseNode.mts';
+
+/** https://tc39.es/ecma262/#sec-static-semantics-tv */
+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,18 @@
+import { Assert } from '../abstract-ops/all.mts';
+import type { CodePoint } from '#self';
+
+/** https://tc39.es/ecma262/#sec-utf16encodecodepoint */
+export function UTF16EncodeCodePoint(cp: CodePoint) {
+  // 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, type CodePoint } from '#self';
+
+/** https://tc39.es/ecma262/#sec-utf16decodesurrogatepair */
+export function UTF16SurrogatePairToCodePoint(lead: number, trail: number): CodePoint {
+  // 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 as CodePoint;
+}

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 [];
+  }
+}

package/src/static-semantics/VarScopedDeclarations.mts

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

package/src/static-semantics/all.mts

@@ -0,0 +1,47 @@
+export * from './StringValue.mts';
+export * from './IsStatic.mts';
+export * from './NonConstructorElements.mts';
+export * from './ConstructorMethod.mts';
+export * from './PropName.mts';
+export * from './NumericValue.mts';
+export * from './IsAnonymousFunctionDefinition.mts';
+export * from './IsFunctionDefinition.mts';
+export * from './HasName.mts';
+export * from './IsIdentifierRef.mts';
+export * from './LexicallyDeclaredNames.mts';
+export * from './TopLevelLexicallyDeclaredNames.mts';
+export * from './BoundNames.mts';
+export * from './VarDeclaredNames.mts';
+export * from './TopLevelVarDeclaredNames.mts';
+export * from './VarScopedDeclarations.mts';
+export * from './TopLevelVarScopedDeclarations.mts';
+export * from './DeclarationPart.mts';
+export * from './LexicallyScopedDeclarations.mts';
+export * from './TopLevelLexicallyScopedDeclarations.mts';
+export * from './IsConstantDeclaration.mts';
+export * from './IsInTailPosition.mts';
+export * from './ExpectedArgumentCount.mts';
+export * from './HasInitializer.mts';
+export * from './IsSimpleParameterList.mts';
+export * from './ContainsExpression.mts';
+export * from './IsStrict.mts';
+export * from './BodyText.mts';
+export * from './FlagText.mts';
+export * from './ModuleRequests.mts';
+export * from './ImportEntries.mts';
+export * from './ExportEntries.mts';
+export * from './ImportedLocalNames.mts';
+export * from './IsDestructuring.mts';
+export * from './TemplateStrings.mts';
+export * from './ImportEntriesForModule.mts';
+export * from './ExportEntriesForModule.mts';
+export * from './CharacterValue.mts';
+export * from './UTF16SurrogatePairToCodePoint.mts';
+export * from './CodePointAt.mts';
+export * from './StringToCodePoints.mts';
+export * from './CodePointsToString.mts';
+export * from './IsStringWellFormedUnicode.mts';
+export * from './IsComputedPropertyKey.mts';
+export * from './PrivateBoundIdentifiers.mts';
+export * from './ContainsArguments.mts';
+export * from './UTF16EncodeCodePoint.mts';

package/src/syntax-error.d.ts

@@ -0,0 +1,5 @@
+// eslint-disable-next-line no-unused-vars
+interface SyntaxError {
+    decoration?: string
+    position?: number
+}

package/src/tsconfig.json

@@ -0,0 +1,11 @@
+{
+    "extends": "../tsconfig.base.json",
+    "compilerOptions": {
+      "composite": true,
+      "rootDir": "./",
+      "emitDeclarationOnly": true,
+      "declarationDir": "../declaration/",
+      "tsBuildInfoFile": "../declaration/.tsbuildinfo"
+    },
+    "include": ["./"]
+}