@@ -162,53 +162,61 @@ The top-level `yarn build` command handles this automatically.
162162
163163### Current version
164164
165- ** TypeScript version** : 5.9.2 (aligned across all workspaces as of November 7, 2025)
165+ ** TypeScript version** : 5.9.2 (managed at root level as of November 2025)
166166
167- All three locations use the same version :
167+ TypeScript is installed in :
168168
169- - ` 1st-gen/package.json `
170- - ` 1st-gen/projects/css-custom-vars-viewer/package.json `
171- - ` 1st-gen/projects/example-project-rollup/package.json `
169+ - Root ` package.json ` (primary dependency for all workspaces via hoisting)
170+ - ` 1st-gen/projects/css-custom-vars-viewer/package.json ` (example project)
171+ - ` 1st-gen/projects/example-project-rollup/package.json ` (example project)
172+
173+ Example projects maintain their own TypeScript dependency to simulate external consumer environments.
172174
173175### Upgrading TypeScript
174176
175- When updating TypeScript versions, follow these steps to ensure consistency :
177+ When updating TypeScript versions:
176178
177- ** 1. Update all three package.json files :**
179+ ** 1. Update the root package.json:**
178180
179181``` bash
180- # Update version in all three locations
181- # 1st-gen/package.json
182- # 1st-gen/projects/css-custom-vars-viewer/package.json
183- # 1st-gen/projects/example-project-rollup/package.json
182+ # Edit package.json at root and update typescript version
184183```
185184
186- ** 2. Install the new version:**
185+ ** 2. Update example projects (optional):**
186+
187+ Example projects can update independently, but should generally stay aligned:
188+
189+ - ` 1st-gen/projects/css-custom-vars-viewer/package.json `
190+ - ` 1st-gen/projects/example-project-rollup/package.json `
191+
192+ ** 3. Install the new version:**
187193
188194``` bash
189195yarn install
190196```
191197
192- ** 3 . Verify TypeScript version:**
198+ ** 4 . Verify TypeScript version:**
193199
194200``` bash
195- cd 1st-gen && yarn tsc --version
201+ yarn tsc --version # Check hoisted version
202+ cd 1st-gen && yarn tsc --version # Verify in 1st-gen
203+ cd 2nd-gen && yarn tsc --version # Verify in 2nd-gen
196204```
197205
198- ** 4 . Clean and rebuild:**
206+ ** 5 . Clean and rebuild:**
199207
200208``` bash
201209yarn workspace @spectrum-web-components/1st-gen build:clear-cache
202210yarn build
203211```
204212
205- ** 5 . Run the test suite:**
213+ ** 6 . Run the test suite:**
206214
207215``` bash
208216yarn test
209217```
210218
211- ** 6 . Check for breaking changes:**
219+ ** 7 . Check for breaking changes:**
212220
213221- Review the [ TypeScript release notes] ( https://www.typescriptlang.org/docs/handbook/release-notes/overview.html )
214222- Pay special attention to ` lib.d.ts ` changes (DOM types)
0 commit comments