.github/workflows/README.md

@@ -39,6 +39,11 @@ This workflow is responsible for building Stencil and validating the resultant a
 This workflow is responsible for validating that the code adheres to the Stencil team's formatting configuration before
 a pull request is merged.
 
+### Dev Release (`release-dev.yml`)
+
+This workflow initiates a developer build of Stencil from the `main` branch.
+It is intended to be manually invoked by a member of the Stencil team.
+
 ### Test Analysis (`test-analysis.yml`)
 
 This workflow is responsible for running the Stencil analysis testing suite.

.github/workflows/actions/publish-npm/action.yml

@@ -0,0 +1,38 @@
+name: 'Release'
+description: 'Releases Stencil Core'
+inputs:
+  version:
+    description: 'The type of version to release.'
+  tag:
+    description: 'The tag to publish to on NPM.'
+  token:
+    description: 'The NPM authentication token required to publish.'
+runs:
+  using: 'composite'
+  steps:
+    - name: Checkout Code
+      uses: actions/checkout@ac593985615ec2ede58e132d2e21d2b1cbd6127c # v3.3.0
+
+    - name: Get Core Dependencies
+      uses: ./.github/workflows/actions/get-core-dependencies
+
+    - name: Download Build Archive
+      uses: ./.github/workflows/actions/download-archive
+      with:
+        name: stencil-core
+        path: .
+        filename: stencil-core-build.zip
+
+    - name: Set Version
+      run: npm version --no-git-tag-version ${{ inputs.version }}
+      shell: bash
+
+    - name: Prepare NPM Token
+      run: echo //registry.npmjs.org/:_authToken=${NPM_TOKEN} > .npmrc
+      shell: bash
+      env:
+        NPM_TOKEN: ${{ inputs.token }}
+
+    - name: Publish to NPM
+      run: npm publish --tag ${{ inputs.tag }}
+      shell: bash

.github/workflows/release-dev.yml

@@ -0,0 +1,61 @@
+name: 'Stencil Dev Release'
+
+on:
+  workflow_dispatch:
+    # Make this a reusable workflow, no value needed
+    # https://docs.github.com/en/actions/using-workflows/reusing-workflows
+
+jobs:
+  build_core:
+    name: Build
+    uses: ./.github/workflows/build.yml
+
+  get-dev-version:
+    name: Get Dev Build Version
+    needs: [build_core]
+    runs-on: ubuntu-20.04
+    outputs:
+      dev-version: ${{ steps.get-dev-version.outputs.DEV_VERSION }}
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@ac593985615ec2ede58e132d2e21d2b1cbd6127c # v3.3.0
+
+      - name: Get Core Dependencies
+        uses: ./.github/workflows/actions/get-core-dependencies
+
+      - name: Download Build Archive
+        uses: ./.github/workflows/actions/download-archive
+        with:
+          name: stencil-core
+          path: .
+          filename: stencil-core-build.zip
+
+      - name: Get Version
+        id: get-dev-version
+        run: |
+          # A unique string to publish Stencil under
+          # e.g. "3.0.1-dev.1677185104.7c87e34"
+          #
+          # Pull this value from the compiled artifacts
+          DEV_VERSION=$(./bin/stencil version)
+
+          echo "Using version $DEV_VERSION"
+
+          # store a key/value pair in GITHUB_OUTPUT
+          # e.g. "DEV_VERSION=3.0.1-dev.1677185104.7c87e34"
+          echo "DEV_VERSION=$DEV_VERSION" >> $GITHUB_OUTPUT
+
+        shell: bash
+
+  release-stencil-dev-build:
+    name: Publish Dev Build
+    needs: [get-dev-version, build_core]
+    runs-on: ubuntu-20.04
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@ac593985615ec2ede58e132d2e21d2b1cbd6127c # v3.3.0
+      - uses: ./.github/workflows/actions/publish-npm
+        with:
+          tag: dev
+          version: ${{ needs.get-dev-version.outputs.dev-version }}
+          token: ${{ secrets.NPM_TOKEN }}

.github/workflows/test-browserstack.yml

@@ -5,10 +5,12 @@ on:
     branches:
       - 'main'
       - 'v3.0.0-dev'
+      - 'v2-maintenance'
   push:
     branches:
       - 'main'
       - 'v3.0.0-dev'
+      - 'v2-maintenance'
 
 env:
   BROWSERSTACK_ACCESS_KEY: ${{ secrets.BROWSER_STACK_ACCESS_KEY }}

CHANGELOG.md

@@ -1,3 +1,12 @@
+## 🎆 [2.22.3](https://github.com/ionic-team/stencil/compare/v2.22.2...v2.22.3) (2023-03-14)
+
+
+### Bug Fixes
+
+* **compiler:** use file system polling events in watch mode ([#4147](https://github.com/ionic-team/stencil/issues/4147)) ([7f3d514](https://github.com/ionic-team/stencil/commit/7f3d514c5a12e6563e315a834329da40026dd538)), fixes [#3952](https://github.com/ionic-team/stencil/issues/3952), [#4011](https://github.com/ionic-team/stencil/issues/4011), [#4044](https://github.com/ionic-team/stencil/issues/4044)
+
+
+
 ## 🎈 [2.22.2](https://github.com/ionic-team/stencil/compare/v2.22.1...v2.22.2) (2023-01-23)
 
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core",
-  "version": "2.22.2",
+  "version": "2.22.3",
   "license": "MIT",
   "main": "./internal/stencil-core/index.cjs",
   "module": "./internal/stencil-core/index.js",

scripts/utils/options.ts

@@ -1,3 +1,4 @@
+import { execSync } from 'child_process';
 import { readFileSync } from 'fs-extra';
 import { join } from 'path';
 
@@ -71,7 +72,7 @@ export function getOptions(rootDir: string, inputOpts: BuildOptions = {}): Build
   }
 
   if (!opts.version) {
-    opts.version = '0.0.0-dev.' + opts.buildId;
+    opts.version = getDevVersionId({ buildId: opts.buildId, semverVersion: opts.packageJson?.version });
   }
 
   if (opts.isPublishRelease) {
@@ -195,20 +196,59 @@ export interface BuildOptions {
   otp?: '';
 }
 
-export interface CmdLineArgs {
-  'config-version'?: string;
-  'config-build-id'?: string;
-  'config-prod'?: string;
+/**
+ * Generate a build identifier, which is the Epoch Time in seconds
+ * @returns the generated build ID
+ */
+function getBuildId(): string {
+  return Date.now().toString(10).slice(0, -3);
+}
+
+/**
+ * Describes the contents of a version string for Stencil used in 'non-production' builds (e.g. a one-off dev build)
+ */
+interface DevVersionContents {
+  /**
+   * The build identifier string, used to uniquely identify when the build was generated
+   */
+  buildId: string;
+  /**
+   * A semver-compliant string to add to the one-off build version sting, used to identify a base version of Stencil
+   * that was used in the build.
+   */
+  semverVersion: string | undefined;
 }
 
-function getBuildId() {
-  const d = new Date();
-  return [
-    d.getUTCFullYear() + '',
-    ('0' + (d.getUTCMonth() + 1)).slice(-2),
-    ('0' + d.getUTCDate()).slice(-2),
-    ('0' + d.getUTCHours()).slice(-2),
-    ('0' + d.getUTCMinutes()).slice(-2),
-    ('0' + d.getUTCSeconds()).slice(-2),
-  ].join('');
+/**
+ * Helper function to return the first seven characters of a git SHA
+ *
+ * We use the first seven characters for two reasons:
+ * 1. Seven characters _should_ be enough to uniquely ID a commit in Stencil
+ * 2. It matches the number of characters used in our CHANGELOG.md
+ *
+ * @returns the seven character SHA
+ */
+function getSevenCharGitSha(): string {
+  return execSync('git rev-parse HEAD').toString().trim().slice(0, 7);
+}
+
+/**
+ * Helper function to generate a dev build version string of the format:
+ *
+ * [BASE_VERSION]-dev.[BUILD_IDENTIFIER].[GIT_SHA]
+ *
+ * where:
+ * - BASE_VERSION is the version of Stencil currently assigned in `package.json`
+ * - BUILD_IDENTIFIER is a unique identifier for this particular build
+ * - GIT_SHA is the SHA of the HEAD of the branch this build was created from
+ *
+ * @param devVersionContents an object containing the necessary arguments to build a dev-version identifier
+ * @returns the generated version string
+ */
+function getDevVersionId(devVersionContents: DevVersionContents): string {
+  const { buildId, semverVersion } = devVersionContents;
+  // if `package.json#package` is empty, default to a value that doesn't imply any particular version of Stencil
+  const version = semverVersion ?? '0.0.0';
+  // '-' and '-dev.' are a magic substrings that may get checked on startup of a Stencil process.
+  return version + '-dev.' + buildId + '.' + getSevenCharGitSha();
 }