.github/ISSUE_TEMPLATE/1-bug-report.md

@@ -0,0 +1,42 @@
+---
+name: "\U0001F41B Bug report"
+about: Report a bug with the specification.
+
+---
+
+<!--
+Thank you for reporting a possible bug in ECMA-262.
+
+If this is a bug with a specific implementation of ECMA-262, such as
+a JavaScript engine or a browser, please report it on their bug tracker
+instead.
+
+eshost is a tool to run the same code on many JS engines
+to compare the output.
+
+To set up eshost:
+
+1. $ npm i -g eshost-cli jsvu
+2. $ jsvu
+3. $ eshost --configure-jsvu
+
+Running eshost:
+
+Use `-x` to evaluate multiple statements:
+$ eshost -s -x "const a = 1 + 1; print(a);"
+
+Or `-e` to evaluate a single expression:
+$ eshost -s -e "1 + 1"
+
+Paste the output of eshost into the box below.
+-->
+
+**Description:** Adding 1 and 1 is two, but it should be...
+
+**eshost Output:**
+
+```
+$ eshost -s -e "1 + 1"
+#### Chakra, JavaScriptCore, SpiderMonkey, V8, XS
+2
+```

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+--- 
+blank_issues_enabled: true
+contact_links: 
+  - 
+    about: "Feature requests for future versions of ECMAScript should not be made in this repository. See CONTRIBUTING.md for more details."
+    name: "\U0001F680 Feature request"
+    url: "https://github.com/tc39/ecma262/blob/HEAD/CONTRIBUTING.md#new-feature-proposals"
+  - 
+    about: "You can also ask questions and suggest ideas on the TC39 Discourse."
+    name: "\U0001F4AC Discourse"
+    url: "https://es.discourse.group/"

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,9 @@
+<!--
+If you are changing the signature or behavior of an existing construct, please check if this affects downstream dependencies (searching for the construct's name is sufficient) and if needed file an issue:
+
+* [Web IDL](https://webidl.spec.whatwg.org/) — [file an issue](https://github.com/whatwg/webidl/issues/new)
+* [HTML Standard](https://html.spec.whatwg.org/) — [file an issue](https://github.com/whatwg/html/issues/new)
+* [ECMAScript Intl API](https://tc39.es/ecma402/) - [file an issue](https://github.com/tc39/ecma402/issues/new)
+
+Note: please ensure that the "Allow edits and access to secrets by maintainers" checkbox remains checked.
+-->

.github/workflows/build.yml

@@ -0,0 +1,19 @@
+name: 'ecma-262'
+
+on: [pull_request, push]
+
+jobs:
+  build:
+    name: 'build & lint ecmarkup'
+    runs-on: ubuntu-22.04
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ljharb/actions/node/install@dfd9796898850cf07630d1bd4053a7c9a379e90f
+        name: 'nvm install lts/* && npm ci --no-audit'
+        env:
+          NPM_CONFIG_AUDIT: false
+        with:
+          node-version: lts/*
+          use-npm-ci: true
+      - run: npm run build-head

.github/workflows/deploy.yml

@@ -0,0 +1,26 @@
+name: 'ecma-262 deploy'
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: 'deploy github pages'
+    runs-on: ubuntu-22.04
+    if: ${{ github.repository == 'tc39/ecma262' }}
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ljharb/actions/node/install@dfd9796898850cf07630d1bd4053a7c9a379e90f
+        name: 'nvm install lts/* && npm ci --no-audit'
+        env:
+          NPM_CONFIG_AUDIT: false
+        with:
+          node-version: lts/*
+          use-npm-ci: true
+      - run: npm run build-only
+      - run: ./scripts/auto-deploy.sh
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/enforce-format.yml

@@ -0,0 +1,19 @@
+name: 'enforce format'
+
+on: [pull_request]
+
+jobs:
+  build:
+    name: 'enforce format'
+    runs-on: ubuntu-22.04
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ljharb/actions/node/install@dfd9796898850cf07630d1bd4053a7c9a379e90f
+        name: 'nvm install lts/* && npm ci --no-audit'
+        env:
+          NPM_CONFIG_AUDIT: false
+        with:
+          node-version: lts/*
+          use-npm-ci: true
+      - run: 'if ! npx emu-format --check spec.html; then echo "You need to run \`npm run format\`"; exit 1; fi'

.github/workflows/esmeta-typecheck.yml

@@ -0,0 +1,41 @@
+name: 'esmeta typecheck'
+
+on: [pull_request]
+
+jobs:
+  esmeta-typecheck:
+    name: 'esmeta typecheck'
+    runs-on: ubuntu-22.04
+
+    env:
+      ESMETA_HOME: vendor/esmeta
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup JDK
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 17
+      - name: Setup SBT
+        uses: sbt/setup-sbt@v1
+      - name: download esmeta
+        run: |
+          mkdir -p "${ESMETA_HOME}"
+          cd "${ESMETA_HOME}"
+          git init
+          git remote add origin https://github.com/es-meta/esmeta.git
+          git fetch --depth 1 origin 4bc6a2ffd015a150596fde1c9dcbcb3614e7cbbb ;# v0.5.1
+          git checkout FETCH_HEAD
+      - name: build esmeta
+        run: |
+          cd "${ESMETA_HOME}"
+          sbt assembly
+      - name: link
+        run: |
+          rmdir "${ESMETA_HOME}"/ecma262 \
+            && ln -s "$(pwd)" "${ESMETA_HOME}"/ecma262
+      - name: typecheck
+        run: '"${ESMETA_HOME}"/bin/esmeta tycheck -status -tycheck:log -tycheck:ignore=esmeta-ignore.json'
+

.github/workflows/ipr.yml

@@ -0,0 +1,28 @@
+name: 'ecma-262'
+
+on:
+  pull_request_target:
+    branches:
+       - '*'
+  push:
+    branches:
+       - main
+
+jobs:
+  build:
+    name: 'check IPR form'
+    runs-on: ubuntu-22.04
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ljharb/actions/node/install@dfd9796898850cf07630d1bd4053a7c9a379e90f
+        name: 'nvm install lts/* && npm ci --no-audit'
+        env:
+          NPM_CONFIG_AUDIT: false
+        with:
+          node-version: lts/*
+          use-npm-ci: true
+      - run: npm run ipr-check ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || 'HEAD' }}
+        env:
+          GH_TOKEN: ${{ secrets.GH_IPR_TOKEN }}
+          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}

.github/workflows/preview-build.yml

@@ -0,0 +1,25 @@
+name: Build Preview
+
+on: [pull_request]
+
+jobs:
+  build:
+    name: 'build PR preview'
+    runs-on: ubuntu-22.04
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ljharb/actions/node/install@dfd9796898850cf07630d1bd4053a7c9a379e90f
+        name: 'nvm install lts/* && npm ci --no-audit'
+        env:
+          NPM_CONFIG_AUDIT: false
+        with:
+          node-version: lts/*
+          use-npm-ci: true
+      - run: npm run build-only
+      - run: node scripts/insert_snapshot_warning
+      - run: echo ${{ github.event.number }} > out/pr.txt
+      - uses: actions/upload-artifact@v4
+        with:
+          name: out
+          path: out/

.github/workflows/preview.yml

@@ -0,0 +1,61 @@
+name: Upload Preview
+
+on:
+  workflow_run:
+    workflows: ["Build Preview"]
+    types:
+      - completed
+
+jobs:
+  upload:
+    name: 'upload PR preview'
+    runs-on: ubuntu-22.04
+    if: >
+      ${{
+        github.event.workflow_run.event == 'pull_request' &&
+        github.event.workflow_run.conclusion == 'success' &&
+        github.repository == 'tc39/ecma262'
+      }}
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ljharb/actions/node/install@dfd9796898850cf07630d1bd4053a7c9a379e90f
+        name: 'nvm install lts/* && npm ci --no-audit'
+        env:
+          NPM_CONFIG_AUDIT: false
+        with:
+          node-version: lts/*
+          use-npm-ci: true
+      - name: 'Download artifact'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { owner, repo } = context.repo;
+            const artifacts = await github.rest.listWorkflowRunArtifacts({
+               owner,
+               repo,
+               run_id: ${{ github.event.workflow_run.id }},
+            });
+            const { id: artifact_id } = artifacts.data.artifacts.find((artifact) => artifact.name == 'out');
+            const download = await github.rest.downloadArtifact({
+               owner,
+               repo,
+               artifact_id,
+               archive_format: 'zip',
+            });
+            const fs = require('fs');
+            fs.writeFileSync('${{ github.workspace }}/out.zip', Buffer.from(download.data));
+      - run: unzip -o out.zip -d out
+      - name: 'debug info'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            console.log(${{ toJson(github.event) }});
+      - run: head -n1 out/pr.txt | grep -e '^[1-9][0-9]*$'
+        name: 'validate PR number from archive'
+      - run: echo "PULL_REQUEST=$(head -n1 out/pr.txt)" >> $GITHUB_ENV
+      - run: rm out/pr.txt && echo $PULL_REQUEST
+      - run: node scripts/publish-preview
+        env:
+          CI_PREVIEW_TOKEN: ${{ secrets.CI_PREVIEW_TOKEN }}
+          GITHUB_HEAD_SHA: ${{ github.event.workflow_run.head_commit.id }}

.github/workflows/publish-biblio.yml

@@ -0,0 +1,32 @@
+name: 'ecma-262-biblio'
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    name: 'publish ecma262-biblio'
+    runs-on: ubuntu-22.04
+    if: ${{ github.repository == 'tc39/ecma262' }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 'lts/*'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci --no-audit
+
+      - name: Publish biblio
+        run: scripts/publish-biblio.sh
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN_FOR_TC39_USER }}

.github/workflows/require-allow-edits.yml

@@ -0,0 +1,12 @@
+name: Require “Allow Edits”
+
+on: [pull_request]
+
+jobs:
+  _:
+    name: "Require “Allow Edits”"
+
+    runs-on: ubuntu-22.04
+
+    steps:
+    - uses: ljharb/require-allow-edits@main

.github/workflows/spellcheck.yml

@@ -0,0 +1,24 @@
+name: 'ecma-262'
+
+on: [pull_request]
+
+jobs:
+  spellcheck:
+    name: 'check for newly-introduced spelling errors'
+    runs-on: ubuntu-22.04
+
+    steps:
+      - run: sudo apt-get install aspell
+      - uses: actions/checkout@v4
+        with:
+          # Number of commits to fetch. 0 indicates all history for all branches and tags.
+          # Default: 1
+          fetch-depth: 0
+      - uses: ljharb/actions/node/install@dfd9796898850cf07630d1bd4053a7c9a379e90f
+        name: 'nvm install lts/* && npm ci --no-audit'
+        env:
+          NPM_CONFIG_AUDIT: false
+        with:
+          node-version: lts/*
+          use-npm-ci: true
+      - run: node scripts/spellcheck.mjs origin/"${GITHUB_BASE_REF}"

.gitignore

@@ -1,8 +1,9 @@
 node_modules/
 out/
+vendor/esmeta
 test*.js
+aspell.txt
 
-# Only apps should have lockfiles
+# lockfiles we don't use are ignored
 npm-shrinkwrap.json
-package-lock.json
 yarn.lock

CODE_OF_CONDUCT.md

@@ -1,3 +1,3 @@
-This repository is a TC39 project and subscribes to its [code of conduct](https://tc39.github.io/code-of-conduct/). It is available at [https://tc39.github.io/code-of-conduct/](https://tc39.github.io/code-of-conduct/). 
+This repository is a TC39 project and subscribes to its [code of conduct](https://tc39.es/code-of-conduct/). It is available at [https://tc39.es/code-of-conduct/](https://tc39.es/code-of-conduct/).
 
 To ask a question or report an issue, please email [tc39-conduct-reports@googlegroups.com](mailto:tc39-conduct-reports@googlegroups.com).