[fpigeonjr]

Description

Bump the sam-design-system release train from 21.0.0 to 21.0.2 in lockstep:

• set the root package and lockfile metadata to 21.0.2;
• set @gsa-sam/components, @gsa-sam/sam-formly, and @gsa-sam/sam-material-extensions to 21.0.2;
• update internal peer ranges among those three packages to ^21.0.2;
• update the release-contract tests for the new lockstep version while retaining the existing Angular and external @gsa-sam/ngx-uswds* compatibility ranges.

This PR changes version metadata and its contract assertions only. It does not create a tag, publish packages, or change the release workflow.

Motivation and Context

PR #1727 corrected all three published libraries to use Angular partial-Ivy output. A v21.0.1 GitHub Release was subsequently created from a commit whose manifests still declared 21.0.0. The ADR-0011 publish preflight correctly rejected that mismatch before npm publication; all three public packages remain at 21.0.0.

Because the failed v21.0.1 GitHub Release and tag already exist, this version bump provides the reviewed commit from which a new v21.0.2 tag and release can later be created through the protected OIDC release workflow. The failed v21.0.1 release remains part of the audit trail; no package was published from it.

Publication remains a separate human-authorized operation requiring the protected release environment and confirmed live-publish configuration.

Program epic: IAEMOD-57412

How to Test

npm run test:scripts
npx ng build components --configuration production
npx ng build sam-formly --configuration production
npx ng build sam-material-extensions --configuration production
node scripts/validate-publish-package.mjs --tag v21.0.2
npx prettier --check \
  package.json \
  package-lock.json \
  libs/packages/components/package.json \
  libs/packages/sam-formly/package.json \
  libs/packages/sam-material-extensions/package.json \
  scripts/dependency-bands.test.mjs

Expected results:

• 108 script tests pass.
• All three production library builds pass.
• Publish validation confirms every publishable manifest and built package matches v21.0.2 and retains valid partial-Ivy output.
• Formatting passes for all changed files.

Type of Change (Select One and Apply Github Label)

• Bug fix (non-breaking change which fixes an issue) -> Apply bugfix label
• New feature (non-breaking change which adds functionality) -> Apply enhancement label
• Breaking change (fix or feature that would cause existing functionality to change) -> Apply breaking label

Screenshots (if appropriate):

N/A — version metadata and release-contract assertions only.

Which browsers have you tested?

N/A — no browser or UI behavior changed.

• Edge
• Chrome
• Firefox
• Safari

Checklist:

• I have read the CONTRIBUTING.md document.
• My code passes the automated a11y lint gate.
• This code has been reviewed by another team member and passes the reviewer checklist found in CONTRIBUTING.md.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.
• All new and existing tests pass; the coverage floor has not regressed.
• Lint baseline not raised.
• My code conforms to WCAG 2.1 AA.
• Any dependent changes have been merged and published in downstream modules.

[Copilot]

🟢 Approval recommended

The metadata and contract assertions consistently target 21.0.1, with no blocking issues identified.

No open issues 🎉

What changed in this PR

Prepares the design-system libraries for a corrected 21.0.1 release following the partial-Ivy fix in #1727. Publication remains a separate operation.

Changes:

• Updates root, lockfile, and all three library versions to 21.0.1.
• Raises internal peer ranges to ^21.0.1, preserving external compatibility ranges.
• Updates release-contract assertions to match.

File	Description
scripts/​dependency-bands.test.mjs	Updates version and internal peer assertions.
package.json	Sets root version to 21.0.1.
package-lock.json	Synchronizes root version metadata.
libs/​packages/​sam-material-extensions/​package.json	Updates version and components peer range.
libs/​packages/​sam-formly/​package.json	Updates version and internal peer ranges.
libs/​packages/​components/​package.json	Sets library version to 21.0.1.

_{Review effort: Balanced}

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-10-20 19:00 UTC