Skip to content

docs: revise TypeScript migration PRD and task list for tech stack modernization#941

Open
kdaviduik wants to merge 1 commit intomainfrom
kd-update-to-typescript
Open

docs: revise TypeScript migration PRD and task list for tech stack modernization#941
kdaviduik wants to merge 1 commit intomainfrom
kd-update-to-typescript

Conversation

@kdaviduik
Copy link
Contributor

@kdaviduik kdaviduik commented Mar 9, 2026

Summary

  • Rewrites the TypeScript migration PRD and task list to expand scope from TS-only migration to full tech stack modernization
  • Adds Phase 3: Tooling Modernization (PRs 3-8) — pnpm, browser target drop, ESLint 9, Vite, Vitest, dependency cleanup — before TS file conversion begins
  • Fixes critical issues: wrong test framework types (@types/jest → Vitest), 14 missing files, dependency-tier ordering violations, npm/yarn inconsistency
  • Adds complete 49-file source inventory with tier classification and 30-file test inventory with PR assignments
  • Documents pre-existing bugs, CSS class type mismatches, and Record<string, any> debt for systematic cleanup

Key decisions

  • Major version bump 3.0.6 → 4.0.0 for IE 11 drop (breaking change for legacy browser consumers)
  • Tooling modernization BEFORE file conversion — modern tools make migration faster, safer, and better enforced
  • ~26 PRs across 3 phases: tooling (7 PRs), source conversion (13 PRs), test conversion (6 PRs)
  • Modal updater moved to PR 17 — cross-tier dependency on Product component

@kdaviduik kdaviduik marked this pull request as ready for review March 9, 2026 18:30
…dernization

Expand scope from TS-only migration to full tech stack modernization (pnpm, Vite, Vitest, ESLint 9, browser target drop to rolling modern targets).

Key changes:
- Add Phase 3: Tooling Modernization (PRs 3-8) before TS file conversion
- Fix dependency-tier ordering violations (base classes before derived)
- Add 14 missing files (templates/, styles/, template.js, defaults/components.js)
- Fix incorrect @types/jest (project uses Mocha, migrating to Vitest)
- Move modal updater to PR 17 (cross-tier dependency on Product component)
- Document CSS class type mismatch (string[] in types vs string in runtime)
- Enumerate 11 Record<string, any> + 1 Function type debt instances
- Document pre-existing bugs (destroyComponent precedence, postMessage origin)
- Add complete 49-file source inventory and 30-file test inventory
- Major version bump 3.0.6 to 4.0.0 for IE 11 drop

Reviewed and approved by Kara (product strategist), Sheldon (code guardian), and Gray (verification guardian) across 3 review rounds.
@kdaviduik kdaviduik changed the base branch from main to graphite-base/941 March 10, 2026 01:37
@kdaviduik kdaviduik force-pushed the kd-update-to-typescript branch from 222f126 to 39ab920 Compare March 10, 2026 01:37
@kdaviduik kdaviduik changed the base branch from graphite-base/941 to 03-09-chore_add_codeowners_for_developer-platforms_team March 10, 2026 01:37
Base automatically changed from 03-09-chore_add_codeowners_for_developer-platforms_team to main March 10, 2026 03:08
@kdaviduik kdaviduik requested a review from a team March 10, 2026 03:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant