chore(tooling): adapt publishing workflow for new monorepo structure #5845

rubencarvalho · 2025-10-30T10:55:09Z

Description

This PR streamlines and fixes the publishing workflow for Spectrum Web Components after the monorepo restructure.

Most relevant changes

Unified publish script (`scripts/publish.js`)

Handles both 1st-gen and 2nd-gen packages in a single workflow.
Cleans and rebuilds everything from scratch to prevent stale artifact issues.
Publishes React wrappers directly via npm.
Properly handles snapshot vs regular releases.

Fixed global changelog generator

Corrected regex to detect @spectrum-web-components/core changes (previously looked for @swc/core).
Now only runs for regular releases (not snapshots).
Runs before changeset version to access changeset files before deletion.

Updated build configuration aliases

Fixed alias @swc/core → @spectrum-web-components/core in:
- 1st-gen/web-test-runner.config.js
- 1st-gen/test/visual/rollup.config.js
- 1st-gen/projects/documentation/rollup.config.js

Fixed Yarn constraints for new monorepo structure

Updated glob patterns:

- {packages,tools}/*
+ {1st-gen/{packages,tools},2nd-gen/packages}/*

Fixed folder name extraction for component name resolution.
Added generation-specific rules:
- 1st-gen: main/module → ./src/index.js
- 2nd-gen: main/module → ./dist/index.js
Ensured both generations set publishConfig.access: "public".

Cleaned up obsolete scripts from `1st-gen/package.json`

Removed:

changeset-publish
changeset-snapshot-publish
prepublishOnly, postpublish
prepublish:react, postpublish:react, publish:react
push-to-remote

Updated release documentation

Simplified workflow steps in
CONTRIBUTOR-DOCS/01_contributor-guides/06_releasing-swc.md
Documented that the script automatically handles all cleaning and building.
Added custom tag usage examples (nightly, beta, etc.).

Motivation and context

After reorganizing the repository into 1st-gen/ and 2nd-gen/ subdirectories, the publishing workflow needed to be updated.

Author's checklist

I have read the CONTRIBUTING and PULL_REQUESTS documents.
I have reviewed at the Accessibility Practices for this feature, see: Aria Practices
I have added automated tests to cover my changes.
I have included a well-written changeset if my change needs to be published.
I have included updated documentation if my change required it.

Reviewer's checklist

Includes a Github Issue with appropriate flag or Jira ticket number without a link
Includes thoughtfully written changeset if changes suggested include patch, minor, or major features
Automated tests cover all use cases and follow best practices for writing
Validated on all supported browsers
All VRTs are approved before the author can update Golden Hash

Manual review test cases

To be tested under the barebones testing and validation steps.

changeset-bot · 2025-10-30T10:55:13Z

⚠️ No Changeset found

Latest commit: 71512d4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

github-actions · 2025-10-30T10:57:25Z

📚 Branch Preview

🔍 Visual Regression Test Results

When a visual regression test fails (or has previously failed while working on this branch), its results can be found in the following URLs:

Deployed to Azure Blob Storage: pr-5845

If the changes are expected, update the current_golden_images_cache hash in the circleci config to accept the new images. Instructions are included in that file.
If the changes are unexpected, you can investigate the cause of the differences and update the code accordingly.

github-actions · 2025-10-30T11:00:58Z

Tachometer results

Currently, no packages are changed by this PR...

rubencarvalho · 2025-11-01T20:47:24Z

.nvmrc

Updated Node requirement to 20.19.0, as per the new Storybook 10 requirement.

rubencarvalho · 2025-11-01T20:47:54Z

1st-gen/package.json

        "build": "wireit",
-        "prebuild": "wireit",
-        "build:clear-cache": "rimraf packages/*/tsconfig.tsbuildinfo && rimraf tools/*/tsconfig.tsbuildinfo",
+        "build:clear-cache": "rimraf .wireit && rimraf packages/*/tsconfig.tsbuildinfo && rimraf tools/*/tsconfig.tsbuildinfo",


added rimraf .wireit, as this can also be a source of caching problems.

rubencarvalho · 2025-11-01T20:48:19Z

1st-gen/package.json

        "@changesets/cli": "2.29.7",
        "@commitlint/cli": "19.8.1",
-        "@commitlint/config-conventional": "^19.8.1",
+        "@commitlint/config-conventional": "19.8.1",


Pinned version.

rubencarvalho · 2025-11-01T20:48:25Z

1st-gen/package.json

        "latest-version": "9.0.0",
        "lightningcss": "1.30.1",
-        "lint-staged": "^16.1.2",
+        "lint-staged": "16.2.6",


Pinned version.

rubencarvalho · 2025-11-01T20:48:31Z

1st-gen/package.json

        "pretty-bytes": "7.1.0",
        "re-template-tag": "2.0.1",
-        "replace-in-file": "^8.3.0",
+        "replace-in-file": "8.3.0",


Pinned version.

rubencarvalho · 2025-11-01T20:54:20Z

1st-gen/web-test-runner.config.js

            entries: [
                {
-                    find: /^@swc\/core\/(.*)$/,
+                    find: /^@spectrum-web-components\/core\/(.*)$/,


More old references.

rubencarvalho · 2025-11-01T20:54:45Z

lint-staged.config.js

    ],
    'package.json': () => [
-        'cd 1st-gen && genversion --es6 --semi tools/base/src/version.js',
+        'genversion --source ./1st-gen/tools/base/package.json --es6 --semi --force ./2nd-gen/packages/core/shared/base/version.ts',


There's a new path for puting the version file.

rubencarvalho · 2025-11-01T20:55:14Z

package.json

Cleaned up the commands to be more consistent with the use of npm-run-all.

rubencarvalho · 2025-11-01T20:55:44Z

yarn.config.cjs

Updated constraints to support new 2nd-gen packages and requirements.

rubencarvalho · 2025-11-01T20:55:59Z

scripts/publish.js

This is the meat of this PR, hopefully it's self documenting! :)

rubencarvalho added 30 commits July 29, 2025 08:43

chore: clean up files

b781c08

chore: revert README

8ace404

chore: add lint-staged to root

9a73140

chore: run constraints fix

f301c56

chore: add commitlint to root

d4cab6a

chore: move patch package to root

5880b0e

chore: fix circleCI paths

6951f31

chore: fix circleCI commands

bb41ec1

chore: create baseline

aa6e3bd

chore: skip cache restore on circleci

94fd87f

chore: lets see circle ci vrts lets see

08c3425

chore: create review site, will it work now

d88857d

chore: add commands back in

60253f6

chore: don't update baselines

037c062

chore: update golden images cache

2a7d49d

chore: revert to base path without first-gen prefix

7bef2f9

chore: need to cd to first gen

a600d98

chore: pull main

2d1a15b

chore: update golden image cache

5e2b6a1

chore: restore all caches

9e4938b

chore: fix coveralls

349196f

chore: fix docs workflow

bc575a3

chore: fix tachometer paths

36712ed

chore: fix storybook deployment and prettier

416b5e8

chore: fix storybook deployment

4400f65

chore: add workdir to lint

464b8d9

chore: revert workdir

a4611b3

chore: fix gitignore and eslint notice path

9ba3bcc

chore: fix docs build css and ts paths

01440dd

chore: update eslintrc notice template file path

b501b4c

rubencarvalho added 16 commits October 30, 2025 12:09

chore: update required node version for storybook 10 compatibility

bf4fcd4

chore: add notice header to version.ts

403ea60

chore: bump node requirements and fix version imports

296d31f

chore: fi Theme import

3ae91e2

chore: clear build cache before rebuilding

302b24c

chore: clear publish script

198de2a

chore: fix react wrappers

77e6067

chore: streamline some stuff

3852590

chore: simplify react wrappers publishing

043d5d4

chore: fix old swc/core references

af23758

chore: update documentation

b1b54a2

chore: only create changelog for regular releases

150b5f2

chore: fix constraints for 2nd gen

c606137

chore: remove unecessary scripts

ce1a5e0

chore: use npm-run-all for consistency

78f0464

chore: use latest npmrunall2

6c55b3a

rubencarvalho changed the title ~~Ruben/streamline release~~ chore(tooling): make publishing workflow work for new monorepo structure Nov 1, 2025

rubencarvalho changed the title ~~chore(tooling): make publishing workflow work for new monorepo structure~~ chore(tooling): adapt publishing workflow for new monorepo structure Nov 1, 2025

chore: reorder some commands

71512d4

rubencarvalho commented Nov 1, 2025

View reviewed changes

rubencarvalho added Status: Ready for review PR ready for review or re-review. 2nd gen These issues or PRs map to our 2nd generation work to modernizing infrastructure. High priority PR review PR is a high priority and should be reviewed ASAP labels Nov 1, 2025

rubencarvalho marked this pull request as ready for review November 1, 2025 20:56

rubencarvalho requested a review from a team as a code owner November 1, 2025 20:56

rubencarvalho force-pushed the barebones branch from ec211ef to 22de59a Compare November 2, 2025 21:27

rubencarvalho closed this Nov 2, 2025

chore(tooling): adapt publishing workflow for new monorepo structure #5845

chore(tooling): adapt publishing workflow for new monorepo structure #5845

Uh oh!

Conversation

rubencarvalho commented Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Most relevant changes

Unified publish script (scripts/publish.js)

Fixed global changelog generator

Updated build configuration aliases

Fixed Yarn constraints for new monorepo structure

Cleaned up obsolete scripts from 1st-gen/package.json

Updated release documentation

Motivation and context

Author's checklist

Reviewer's checklist

Manual review test cases

Uh oh!

changeset-bot bot commented Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

github-actions bot commented Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📚 Branch Preview

🔍 Visual Regression Test Results

Uh oh!

github-actions bot commented Oct 30, 2025

Tachometer results

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

rubencarvalho commented Oct 30, 2025 •

edited

Loading

Unified publish script (`scripts/publish.js`)

Cleaned up obsolete scripts from `1st-gen/package.json`

changeset-bot bot commented Oct 30, 2025 •

edited

Loading

github-actions bot commented Oct 30, 2025 •

edited

Loading