docs: prepare 22.0.0 release (#2811)

Author: mhaertwig

RELEASE.md

@@ -6,7 +6,6 @@ This document describes how to create a new release of SBB Angular.
 
 ### Major release preparation
 
-- See the TODO in file `bazel-additional-stamp.mjs`
 - Update Angular packages to align with new angular major version.
 - Update ng-update schematics.
 - Update stackblitz assets.

docs/src/app/howtoupdate/update-steps.ts

@@ -155,4 +155,19 @@ export const UPDATE_STEPS: UpdateStep[] = [
         <pre>ng update @sbb-esta/angular@21</pre>`,
     ],
   },
+  {
+    from: 2100,
+    to: 2200,
+    actions: [
+      `Update your Angular dependencies to version 22.x.x with "--force" flag (due to unmet peer dependencies).<br/>
+        See <a href='https://update.angular.io'>update.angular.io</a> for a step-by-step guide for updating Angular.<br/>
+        <pre>npx @angular/cli@22 update @angular/core@22 @angular/cli@22 --force</pre>`,
+
+      `Update Angular CDK in a separate step to avoid dependency version resolving problems.<br/>
+        <pre>npx @angular/cli@22 update @angular/cdk@22 --force</pre>`,
+
+      `Finally, update SBB Angular.
+        <pre>ng update @sbb-esta/angular@22</pre>`,
+    ],
+  },
 ];

tools/bazel-additional-stamp.mjs

@@ -16,7 +16,7 @@ export default async function (mode) {
   const scriptDir = path.dirname(url.fileURLToPath(import.meta.url));
   const projectDir = path.join(scriptDir, '../');
   const packageJsonRaw = await fs.promises.readFile(path.join(projectDir, 'package.json'));
-  const {version: versionRaw} = JSON.parse(packageJsonRaw);
+  const { version: versionRaw } = JSON.parse(packageJsonRaw);
   const version = semver.parse(versionRaw);
 
   console.info(`STABLE_FRAMEWORK_PEER_DEP_RANGE ${computeFrameworkPeerDependency(version)}`);
@@ -50,7 +50,5 @@ function computeFrameworkPeerDependency(version) {
     );
   }
 
-  // TODO(mhaertwig): undo this change when releasing `@sbb-esta/angular` 22
-  // return `^${version.major}.0.0 || ^${version.major + 1}.0.0`;
-  return `^${version.major}.1.0 || ^${version.major + 1}.0.0`;
+  return `^${version.major}.0.0 || ^${version.major + 1}.0.0`;
 }