feat(timers deprecation): introduce

[AugustinMauroy]

TODO

• put shared into utilities package
• add more doc

[AugustinMauroy]

I need review on test cases so I can finish/clean the implementation

[Copilot]

Pull Request Overview

This PR introduces a comprehensive codemod recipe to migrate deprecated Node.js timers APIs to modern timer functions. The codemod replaces timers.enroll(), timers.unenroll(), timers.active(), and timers._unrefActive() with standard setTimeout(), clearTimeout(), and Timer#unref() constructs, addressing Node.js deprecations DEP0095, DEP0096, DEP0126, and DEP0127.

Key changes include:

• New utility functions for GCD calculation and indent detection in the codemod-utils package
• Five transformation modules that handle different deprecated APIs
• Comprehensive test suite covering various import/require patterns
• Automated cleanup of unused imports after transformations

Reviewed Changes

Copilot reviewed 45 out of 46 changed files in this pull request and generated 107 comments.

Show a summary per file

File	Description
utils/src/math.ts	Implements GCD function to calculate indentation units
utils/src/math.test.ts	Tests for GCD function including edge cases
utils/src/ast-grep/indent.ts	Detects indentation style and retrieves line indentation
utils/src/ast-grep/indent.test.ts	Tests for indentation detection utilities
utils/src/ast-grep/general.ts	Helper functions for AST manipulation
utils/src/ast-grep/general.test.ts	Tests for AST manipulation helpers
recipes/timers-deprecations/src/*.ts	Five transformation modules for each deprecated API
recipes/timers-deprecations/tests/**	Comprehensive test cases for all transformations
recipes/timers-deprecations/workflow.yaml	Workflow configuration for codemod execution
recipes/timers-deprecations/package.json	Package configuration and test scripts
recipes/timers-deprecations/codemod.yaml	Codemod metadata and registry configuration
recipes/timers-deprecations/README.md	Documentation with examples and caveats

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.