fix: bump deps and add wireit

.eslintrc.js

@@ -5,10 +5,5 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 module.exports = {
-  extends: ['eslint-config-salesforce-typescript', 'eslint-config-salesforce-license', 'plugin:sf-plugin/migration'],
-  rules: {
-    '@typescript-eslint/no-unsafe-argument': 'off',
-    '@typescript-eslint/prefer-includes': 'off',
-    'class-methods-use-this': 'off',
-  },
+  extends: ['eslint-config-salesforce-typescript', 'eslint-config-salesforce-license', 'plugin:sf-plugin/recommended'],
 };

.github/workflows/onPushToMain.yml

@@ -1,18 +1,17 @@
-# test
 name: version, tag and github release
 
 on:
   push:
-    branches: [main]
+    branches:
+      - main
+      - prerelease/*
+    tags-ignore:
+      - "*"
 
 jobs:
   release:
+    # this job will throw if prerelease is true but it doesn't have a prerelease-looking package.json version
     uses: salesforcecli/github-workflows/.github/workflows/githubRelease.yml@main
     secrets: inherit
-
-  # most repos won't use this
-  # depends on previous job to avoid git collisions, not for any functionality reason
-  # docs:
-  #   uses: salesforcecli/github-workflows/.github/workflows/publishTypedoc.yml@main
-  #   secrets: inherit
-  #   needs: release
+    with:
+      prerelease: ${{ github.ref_name != 'main' }}

.github/workflows/onRelease.yml

@@ -11,11 +11,23 @@ on:
         type: string
         required: true
 jobs:
+  # parses the package.json version and detects prerelease tag (ex: beta from 4.4.4-beta.0)
+  getDistTag:
+    outputs:
+      tag: ${{ steps.distTag.outputs.tag }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          ref: ${{ github.event.release.tag_name || inputs.tag  }}
+      - uses: salesforcecli/github-workflows/.github/actions/getPreReleaseTag@main
+        id: distTag
   npm:
     uses: salesforcecli/github-workflows/.github/workflows/npmPublish.yml@main
+    needs: [getDistTag]
     with:
       ctc: true
       sign: true
-      tag: latest
+      tag: ${{ needs.getDistTag.outputs.tag || 'latest' }}
       githubTag: ${{ github.event.release.tag_name || inputs.tag }}
     secrets: inherit

.github/workflows/test.yml

@@ -25,8 +25,7 @@ jobs:
       matrix:
         os: [ubuntu-latest, windows-latest]
         command:
-          - 'yarn test:nuts:package'
-          - 'yarn test:nuts:package1'
+          - 'yarn test:nuts'
       fail-fast: false
     with:
       os: ${{ matrix.os }}

.gitignore

@@ -1,9 +1,50 @@
-*-debug.log
-*-error.log
-/.nyc_output
-/dist
-/lib
-/package-lock.json
-/tmp
+# -- CLEAN
+tmp/
+# use yarn by default, so ignore npm
+package-lock.json
+
+# never checkin npm config
+.npmrc
+
+# debug logs
+npm-error.log
+yarn-error.log
+
+
+# compile source
+lib
+
+# test artifacts
+*xunit.xml
+*checkstyle.xml
+*unitcoverage
+.nyc_output
+coverage
+test_session*
+
+# generated docs
+docs
+
+# ignore sfdx-trust files
+*.tgz
+*.sig
+package.json.bak.
+
+# -- CLEAN ALL
+*.tsbuildinfo
+.eslintcache
+.wireit
 node_modules
+
+# --
+# put files here you don't want cleaned with sf-clean
+
+# os specific files
+.DS_Store
+.idea
+.iml 
+
 oclif.manifest.json
+*.tsbuildinfo
+/.wireit
+/.eslintcache

messages/create.md

@@ -1,20 +1,18 @@
-# example
+# examples
 
-$ <%= config.bin %> <%= command.id %> -f force-app/main/default/lwc/myButton/myButton.js
+- Create a Lightning web component test file called myButton.test.js for the myButton component:
 
-# commandDescription
+  <%= config.bin %> <%= command.id %> --filef force-app/main/default/lwc/myButton/myButton.js
 
-creates a Lightning web component test file with boilerplate code inside a **tests** directory.
+# summary
 
-# longDescription
+Create a Lightning web component test file.
 
-Creates a **tests** directory in the specified directory. Creates a yourComponentName.test.js file with boilerplate code in the **tests** directory.
-
-# filepathFlagDescription
+# description
 
-path to Lightning web component .js file to create a test for
+Creates a **tests** directory in the specified directory. Creates a yourComponentName.test.js file with boilerplate code in the **tests** directory.
 
-# filepathFlagLongDescription
+# flags.file.summary
 
 Path to Lightning web component .js file to create a test for.
 

messages/run.md

@@ -1,38 +1,42 @@
 # examples
 
-- $ <%= config.bin %> <%= command.id %>
+- Run LWC Jest unit tests:
 
-- $ <%= config.bin %> <%= command.id %> -w
+  $ <%= config.bin %> <%= command.id %>
 
-# commandDescription
+- Run LWC Jest unit tests only when a watched file changes:
 
-invokes Lightning Web Components Jest unit tests.
+  $ <%= config.bin %> <%= command.id %> --watch
 
-# longDescription
+# summary
 
-Invokes Lightning Web Components Jest unit tests.
+Invoke Lightning Web Components Jest unit tests.
 
-# debugFlagDescription
+# flags.debug.summary
 
-run tests in debug mode
+Run tests in a Node process that an external debugger can connect to.
 
-# debugFlagLongDescription
+# flags.debug.description
 
-Runs tests in a Node process that an external debugger can connect to. The run pauses until the debugger is connected. For more information, see: https://jestjs.io/docs/en/troubleshooting
+The run pauses until the debugger is connected. For more information, see: https://jestjs.io/docs/en/troubleshooting.
 
-# watchFlagDescription
+# flags.watch.summary
 
-run tests in watch mode
+Run tests when a watched file changes.
 
-# watchFlagLongDescription
+# flags.watch.description
 
-Runs tests when a watched file changes. Watched files include the component under test and any files it references.
+Watched files include the component under test and any files it references.
 
 # errorNoExecutableFound
 
-No sfdx-lwc-jest executable found. Verify it is properly installed.
-Run "%s lightning:setup:lwc:test --help" for installation details.
+No sfdx-lwc-jest executable found. Verify it's properly installed.
+Run "%s lightning setup lwc test --help" for installation details.
 
 # logSuccess
 
-Test run complete. Exited with status code: %s
+Test run complete. Exited with status code: %s.
+
+# watchAndDebugAreMutuallyExclusive
+
+--watch=true cannot also be provided when using --debug

messages/setup.md

@@ -1,14 +1,16 @@
 # examples
 
-- $ <%= config.bin %> <%= command.id %>
+- Install Jest unit testing tools for LWC:
 
-# commandDescription
+  $ <%= config.bin %> <%= command.id %>
 
-install Jest unit testing tools for Lightning Web Components.
+# summary
 
-# longDescription
+Install Jest unit testing tools for Lightning Web Components.
 
-Installs Jest unit testing tools for Lightning Web Components. For more information, see the Lightning Web Components Dev Guide: https://developer.salesforce.com/docs/component-library/documentation/lwc/lwc.testing
+# description
+
+For more information, see the Lightning Web Components Dev Guide: https://developer.salesforce.com/docs/component-library/documentation/lwc/lwc.testing
 
 # errorNodeNotFound