[WIP] Convert code base to ESM

[agibson-godaddy]

Issue: https://godaddy-corp.atlassian.net/browse/MWC-17961

Summary

This PR converts the codebase to ESM. The changes/impacts are:

Require => import

Instead of const { spawn } = require('child_process') we'd use this syntax: import { spawn } from 'node:child_process'

So moving from require to import

Exports

module.exports is no longer a thing, so all instances of that have been changed.

Task registration

Although not strictly part of the ESM migration, I also updated our deprecated usage of the gulp task() function. See https://gulpjs.com/docs/en/api/task

Previously we registered a task using task('my-task-name', functionNameHere . This is deprecated and the new way to do it is to simply export the function -- e.g. export function functionNameHere

One challenge was how to get our old task names back. Previously we could just specify the task name as a string, which allowed us to use characters like: copy:build . But we don't have that same flexibility when exporting a function directly, since a function can't contain some special characters. The way around that is to set the displayName on the thing we're exporting. Example:

const validateReadmeHeaders = (done) => {
    // do things
    done()
}

validateReadmeHeaders.displayName = 'validate:readme_headers'

export {
  validateReadmeHeaders
}

Without the change, we'd have to run sake validateReadmeHeaders, but by setting the display name, sake validate:readme_headers still works!

Task Updates

I tested each of these as I went.

• build.js
• bump.js
• bundle.js
• clean.js
• compile.js
• config.js
• copy.js
• defacceinate.js
• deploy.js
• github.js
• imagemin.js
• lint.js
• makepot.js
• prerelease.js
• prompt.js
• scripts.js
• shell.js
• styles.js
• upfw.js
• validate.js
• watch.js
• wc.js
• zip.js

QA

Build / zip

1. Run sake zip using a plugin that includes blocks (like a payment gateway)
   • Command runs successfully
2. Upload zip to a test site and activate the plugin
   • Plugin loads, no fatal errors
3. Visit checkout page using block checkout
   • The gateway's assets / block load correctly

Deployment

To be completed only once the above has been done successfully!

1. Deploy any plugin using sake deploy
   • Deployment completes successfully https://godaddy.slack.com/archives/C075WSAK34H/p1742812502309499
2. Deploy a payment gateway or blocks plugin using sake deploy
   • Deployment completes successfully
3. Deploy any plugin to WordPress dot org using sake deploy
   • Success Release: v2.11.0 woocommerce-extra-product-sorting-options#34

After merge

• Update docs https://github.com/godaddy-wordpress/sake/wiki/Adding-a-new-task

[agibson-godaddy]

Config was moved to new, separate file lib/config.js so that it can now be imported where required, instead of passing it around function parameters.

[agibson-godaddy]

Note this PR is affected by this: gulpjs/gulp-cli#269

As such, it only works on Node <= v22.11.0