esupgrade 2025.0.0

package/.editorconfig

@@ -0,0 +1,27 @@
+# http://editorconfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+insert_final_newline = true
+charset = utf-8
+end_of_line = lf
+max_line_length = 88
+
+[*.{json,yml,yaml,mjs,js,jsx,vue,toml}]
+indent_size = 2
+ij_javascript_force_semicolon_style = false
+
+[*.{html,htm,svg,xml}]
+indent_size = 2
+max_line_length = 120
+
+[LICENSE]
+insert_final_newline = false
+
+[*.{md,markdown}]
+indent_size = 2
+max_line_length = 80

package/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: "/"
+    schedule:
+      interval: daily
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: daily

package/.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+jobs:
+  node-test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: package.json
+      - run: npm ci
+      - run: node --test --experimental-test-coverage --test-reporter=spec --test-reporter=lcov --test-reporter-destination=stdout --test-reporter-destination=lcov.txt
+      - uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          flags: javascript
+          files: lcov.txt

package/.github/workflows/release.yml

@@ -0,0 +1,23 @@
+name: Release
+on:
+  release:
+    types: [published]
+permissions:
+  id-token: write
+  contents: read
+jobs:
+  npmjs:
+    name: npmjs.org
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: package.json
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm install -g npm@latest
+      - run: npm ci
+      - run: npm config set git-tag-version=false
+      - run: npm version ${{ github.event.release.tag_name }}
+      - run: npm run build --if-present
+      - run: npm publish

package/.idea/copilot.data.migration.ask2agent.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Ask2AgentMigrationStateService">
+    <option name="migrationStatus" value="COMPLETED" />
+  </component>
+</project>

package/.idea/esupgrade.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="Python 3.9" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,28 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="DjangoUnresolvedUrlInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="JsonSchemaCompliance" enabled="false" level="WARNING" enabled_by_default="false" />
+    <inspection_tool class="PyCompatibilityInspection" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="ourVersions">
+        <value>
+          <list size="2">
+            <item index="0" class="java.lang.String" itemvalue="3.13" />
+            <item index="1" class="java.lang.String" itemvalue="3.14" />
+          </list>
+        </value>
+      </option>
+    </inspection_tool>
+    <inspection_tool class="PyUnresolvedReferencesInspection" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="ignoredIdentifiers">
+        <list>
+          <option value="ssdp.lexers.content_callback" />
+        </list>
+      </option>
+    </inspection_tool>
+    <inspection_tool class="StandardJS" enabled="true" level="ERROR" enabled_by_default="true" />
+    <inspection_tool class="Stylelint" enabled="true" level="ERROR" enabled_by_default="true" />
+    <inspection_tool class="TsLint" enabled="true" level="WARNING" enabled_by_default="true" />
+  </profile>
+</component>

package/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

package/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.9" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.9" project-jdk-type="Python SDK" />
+</project>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/esupgrade.iml" filepath="$PROJECT_DIR$/.idea/esupgrade.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/vcs.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

package/.pre-commit-config.yaml

@@ -0,0 +1,53 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: check-merge-conflict
+      - id: check-json
+      - id: check-yaml
+      - id: debug-statements
+      - id: destroyed-symlinks
+      - id: check-executables-have-shebangs
+      - id: end-of-file-fixer
+      - id: no-commit-to-branch
+        args: [--branch, main]
+      - id: detect-private-key
+  - repo: https://github.com/hukkin/mdformat
+    rev: 1.0.0
+    hooks:
+      - id: mdformat
+        additional_dependencies:
+          - mdformat-footnote
+          - mdformat-gfm
+          - mdformat-gfm-alerts
+  - repo: https://github.com/google/yamlfmt
+    rev: v0.20.0
+    hooks:
+      - id: yamlfmt
+  - repo: https://github.com/btford/write-good
+    rev: v1.0.8
+    hooks:
+      - id: write-good
+        args: [--no-passive]
+  - repo: local
+    hooks:
+      - id: prettier
+        name: prettier
+        entry: prettier --check --write --ignore-unknown
+        args:
+          - --config=package.json
+        language: node
+        additional_dependencies: ["prettier"]
+        types_or: [javascript]
+#      - id: esupgrade
+#        name: esupgrade
+#        entry: npx . --check
+#        args: [--write]
+#        language: system
+#        types_or: [javascript]
+ci:
+  autoupdate_schedule: weekly
+  skip:
+    - no-commit-to-branch
+    - write-good

package/.pre-commit-hooks.yaml

@@ -0,0 +1,7 @@
+- id: esupgrade
+  name: esupgrade
+  entry: npx esupgrade --check
+  args: [--write]
+  language: system
+  types: [javascript, jsx, ts, tsx]
+  pass_filenames: true

package/LICENSE

@@ -0,0 +1,24 @@
+BSD 2-Clause License
+
+Copyright (c) 2025, Johannes Maron
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,152 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./images/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="./images/logo-light.svg">
+    <img alt="esupgrade: Auto-upgrade your JavaScript syntax" src="./images/logo-light.svg">
+  </picture>
+</p>
+
+# esupgrade
+
+Keeping your JavaScript and TypeScript code up to date with full browser compatibility.
+
+## Usage
+
+### CLI
+
+```bash
+npx esupgrade --help
+```
+
+### pre-commit
+
+```bash
+uvx pre-commit install
+```
+
+```yaml
+# .pre-commit-config.yaml
+repos:
+  - repo: https://github.com/codingjoe/esupgrade
+    rev: v0.1.0  # Use the latest version
+    hooks:
+      - id: esupgrade
+```
+
+```bash
+pre-commit run esupgrade --all-files
+```
+
+## Browser Support & Baseline
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://web-platform-dx.github.io/web-features/assets/img/baseline-widely-word-dark.svg">
+  <source media="(prefers-color-scheme: light)" srcset="https://web-platform-dx.github.io/web-features/assets/img/baseline-widely-word.svg">
+  <img alt="Baseline: widely available" src="https://web-platform-dx.github.io/web-features/assets/img/baseline-widely-word.svg" height="32" align="right">
+</picture>
+
+All transformations are based on [Web Platform Baseline](https://web.dev/baseline) features. Baseline tracks which web platform features are safe to use across browsers.
+
+By default, `esupgrade` uses **widely available** features, meaning they work in all major browsers (Chrome, Edge, Safari, Firefox) for at least 30 months. This ensures full compatibility while keeping your code modern.
+
+You can opt into **newly available** features (available in all browsers for 0-30 months) with:
+
+```bash
+npx esupgrade --baseline newly-available src/
+```
+
+For more information about Baseline browser support, visit [web.dev/baseline](https://web.dev/baseline).
+
+## Transformations
+
+All transformations are safe and behavior-preserving. Here's what `esupgrade` does:
+
+### 1. `var` → `let`/`const`
+
+```diff
+-var x = 1;
+-var y = 2;
+-y = 3;
++const x = 1;
++let y = 2;
++y = 3;
+```
+
+### 2. String concatenation → Template literals
+
+```diff
+-const greeting = 'Hello ' + name + '!';
+-const message = 'You have ' + count + ' items';
++const greeting = `Hello ${name}!`;
++const message = `You have ${count} items`;
+```
+
+### 3. `Array.from().forEach()` → `for...of` loops
+
+```diff
+-Array.from(items).forEach(item => {
+-  console.log(item);
+-});
++for (const item of items) {
++  console.log(item);
++}
+```
+
+### 4. `Object.assign({}, ...)` → Object spread
+
+```diff
+-const obj = Object.assign({}, obj1, obj2);
+-const copy = Object.assign({}, original);
++const obj = { ...obj1, ...obj2 };
++const copy = { ...original };
+```
+
+### 5. `.concat()` → Array spread
+
+```diff
+-const combined = arr1.concat(arr2, arr3);
+-const withItem = array.concat([item]);
++const combined = [...arr1, ...arr2, ...arr3];
++const withItem = [...array, item];
+```
+
+### 6. Function expressions → Arrow functions
+
+```diff
+-const fn = function(x) { return x * 2; };
+-items.map(function(item) { return item.name; });
++const fn = x => { return x * 2; };
++items.map(item => { return item.name; });
+```
+
+**Note:** Functions using `this`, `arguments`, or `super` are not converted to preserve semantics.
+
+### Complete Example
+
+```diff
+-var userName = 'John';
+-var userAge = 30;
+-var greeting = 'Hello, ' + userName + '!';
++const userName = 'John';
++const userAge = 30;
++const greeting = `Hello, ${userName}!`;
+
+-Array.from(users).forEach(function(user) {
+-  console.log('User: ' + user.name);
+-});
++for (const user of users) {
++  console.log(`User: ${user.name}`);
++}
+
+-var settings = Object.assign({}, defaultSettings, userSettings);
++const settings = { ...defaultSettings, ...userSettings };
+```
+
+## Supported File Types
+
+- `.js` - JavaScript
+- `.jsx` - React/JSX
+- `.ts` - TypeScript
+- `.tsx` - TypeScript with JSX
+- `.mjs` - ES Modules
+- `.cjs` - CommonJS

package/bin/esupgrade.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+
+import fs from "fs"
+import path from "path"
+import { Command } from "commander"
+import { transform } from "../src/index.js"
+
+/**
+ * CLI tool for esupgrade
+ */
+
+const program = new Command()
+
+program
+  .name("esupgrade")
+  .description("Auto-upgrade your JavaScript syntax")
+  .version("0.1.0")
+  .argument("[files...]", "Files or directories to process")
+  .option(
+    "--baseline <level>",
+    "Set baseline level: widely-available (default) or newly-available",
+    "widely-available",
+  )
+  .option("--check", "Report which files need upgrading and exit with code 1 if any do")
+  .option(
+    "--write",
+    "Write changes to files (default: true unless only --check is specified)",
+  )
+  .action((files, options) => {
+    if (files.length === 0) {
+      console.error("Error: No files specified")
+      program.help()
+    }
+
+    // Validate baseline option
+    if (!["widely-available", "newly-available"].includes(options.baseline)) {
+      console.error(`Error: Invalid baseline level '${options.baseline}'`)
+      console.error(`Must be 'widely-available' or 'newly-available'`)
+      process.exit(1)
+    }
+
+    // Handle check/write options - they are not mutually exclusive
+    // Default: write is true unless ONLY --check is specified (no --write)
+    const shouldWrite = options.write !== undefined ? options.write : !options.check
+    const shouldCheck = options.check || false
+
+    const processingOptions = {
+      baseline: options.baseline,
+      write: shouldWrite,
+      check: shouldCheck,
+    }
+
+    processFiles(files, processingOptions)
+  })
+
+function findFiles(patterns) {
+  const files = []
+
+  for (const pattern of patterns) {
+    try {
+      const stats = fs.statSync(pattern)
+
+      if (stats.isFile()) {
+        files.push(pattern)
+      } else if (stats.isDirectory()) {
+        // Recursively find .js, .jsx, .ts, .tsx files
+        const dirFiles = walkDirectory(pattern)
+        files.push(...dirFiles)
+      }
+    } catch (error) {
+      console.error(`Error: Cannot access '${pattern}': ${error.message}`)
+      process.exit(1)
+    }
+  }
+
+  return files
+}
+
+function walkDirectory(dir) {
+  const files = []
+  const entries = fs.readdirSync(dir, { withFileTypes: true })
+
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name)
+
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git") {
+        continue
+      }
+      files.push(...walkDirectory(fullPath))
+    } else if (entry.isFile()) {
+      const ext = path.extname(entry.name)
+      if ([".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs"].includes(ext)) {
+        files.push(fullPath)
+      }
+    }
+  }
+
+  return files
+}
+
+function processFile(filePath, options) {
+  try {
+    const code = fs.readFileSync(filePath, "utf8")
+    const result = transform(code, { baseline: options.baseline })
+
+    if (result.modified) {
+      if (options.check) {
+        console.log(`✗ ${filePath}`)
+        if (result.changes && result.changes.length > 0) {
+          // Group changes by type
+          const changesByType = {}
+
+          for (const change of result.changes) {
+            if (!changesByType[change.type]) {
+              changesByType[change.type] = []
+            }
+            changesByType[change.type].push(change.line)
+          }
+
+          for (const [type, lines] of Object.entries(changesByType)) {
+            const uniqueLines = [...new Set(lines)].sort((a, b) => a - b)
+            const displayName = type
+              .replace(/([A-Z])/g, " $1")
+              .trim()
+              .toLowerCase()
+            console.log(
+              `  - ${displayName} (line${uniqueLines.length > 1 ? "s" : ""}: ${uniqueLines.join(", ")})`,
+            )
+          }
+        }
+      }
+
+      if (options.write) {
+        fs.writeFileSync(filePath, result.code, "utf8")
+        if (!options.check) {
+          console.log(`✓ Upgraded: ${filePath}`)
+        } else {
+          console.log(`  ✓ Changes written to file`)
+        }
+      }
+
+      return true
+    } else {
+      if (!options.check) {
+        console.log(`  No changes: ${filePath}`)
+      }
+      return false
+    }
+  } catch (error) {
+    console.error(`Error processing ${filePath}: ${error.message}`)
+    return false
+  }
+}
+
+function processFiles(patterns, options) {
+  let files = []
+  try {
+    files = findFiles(patterns)
+  } catch (error) {
+    console.error(`Error finding files: ${error.message}`)
+    process.exit(1)
+  }
+
+  if (files.length === 0) {
+    console.log("No JavaScript files found")
+    process.exit(0)
+  }
+
+  console.log(`Processing ${files.length} file(s) with baseline: ${options.baseline}\n`)
+
+  let modifiedCount = 0
+  for (const file of files) {
+    if (processFile(file, options)) {
+      modifiedCount++
+    }
+  }
+
+  // Summary
+  console.log("")
+  if (modifiedCount > 0) {
+    if (options.write && options.check) {
+      console.log(`Summary: ${modifiedCount} file(s) upgraded`)
+    } else if (options.write) {
+      console.log(`Summary: ${modifiedCount} file(s) upgraded`)
+    } else {
+      console.log(`Summary: ${modifiedCount} file(s) need upgrading`)
+    }
+  } else {
+    console.log("Summary: All files are already modern")
+  }
+
+  // Exit with code 1 if --check specified and there were changes
+  if (options.check && modifiedCount > 0) {
+    process.exit(1)
+  }
+}
+
+program.parse()

package/images/logo-dark.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="640" height="320" font-family="Segoe UI, system-ui, sans-serif" viewBox="0 0 1280 640">
+  <circle cx="260" cy="320" r="200" fill="#f7df1e"/>
+  <path fill="none" stroke="#191919" stroke-width="48" d="m175 405 95-95 95 95m415 50"/>
+  <path fill="none" stroke="#191919" stroke-width="48" d="m175 315 95-95 95 95m415 50"/>
+  <text x="241" y="148" font-size="92" font-weight="bold" transform="matrix(1.6 0 0 1.6 120 120)" fill="#C9D1D9">
+    esupgrade
+  </text>
+  <text x="241" y="192" font-size="28" font-style="italic" transform="matrix(1.6 0 0 1.6 120 120)" fill="#C9D1D9">
+    Auto-upgrade your JavaScript syntax
+  </text>
+</svg>

package/images/logo-light.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="640" height="320" font-family="Segoe UI, system-ui, sans-serif" viewBox="0 0 1280 640">
+  <circle cx="260" cy="320" r="200" fill="#f7df1e"/>
+  <path fill="none" stroke="#191919" stroke-width="48" d="m175 405 95-95 95 95m415 50"/>
+  <path fill="none" stroke="#191919" stroke-width="48" d="m175 315 95-95 95 95m415 50"/>
+  <text x="241" y="148" font-size="92" font-weight="bold" transform="matrix(1.6 0 0 1.6 120 120)">
+    esupgrade
+  </text>
+  <text x="241" y="192" font-size="28" font-style="italic" transform="matrix(1.6 0 0 1.6 120 120)">
+    Auto-upgrade your JavaScript syntax
+  </text>
+</svg>

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "esupgrade",
+  "version": "2025.0.0",
+  "description": "Auto-upgrade your JavaScript syntax",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "esupgrade": "./bin/esupgrade.js"
+  },
+  "scripts": {
+    "test": "node --test --experimental-test-coverage --test-coverage-exclude=tests/* tests/*.test.js"
+  },
+  "keywords": [
+    "javascript",
+    "ecmascript",
+    "modernize",
+    "upgrade",
+    "codemod",
+    "ast",
+    "transform"
+  ],
+  "author": "Johannes Maron",
+  "license": "BSD-2-Clause",
+  "dependencies": {
+    "commander": "^14.0.2",
+    "jscodeshift": "^17.3.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "prettier": {
+    "semi": false
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codingjoe/esupgrade.git"
+  }
+}