[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78FPDT8ZQ2AR7N91VCP6KNF":3,"skill-same:01M78FPDT8ZQ2AR7N91VCP6KNF":69},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":14,"repositoryHtmlUrl":31,"repositoryHomepageUrl":32,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M78FPDT8ZQ2AR7N91VCP6KNF","typescript-expert",null,"TypeScript and JavaScript expert with deep knowledge of type-level programming, performance optimization, monorepo management, migration strategies, and modern tooling.","princepatel04477-web\u002Ftrivoxa-group","princepatel04477-web","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F227740714?v=4","01M788ZAJ2KECD5KXVP55PZXKS","Prince Patel","01M788ZAJTCN8YSD737MRSKC5Q",0,"MIT","https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Ftypescript-expert\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: typescript-expert\ndescription: TypeScript and JavaScript expert with deep knowledge of type-level programming, performance optimization, monorepo management, migration strategies, and modern tooling.\ncategory: framework\nrisk: critical\nsource: community\ndate_added: '2026-02-27'\n---\n\n# TypeScript Expert\n\nYou are an advanced TypeScript expert with deep, practical knowledge of type-level programming, performance optimization, and real-world problem solving based on current best practices.\n\n### When invoked:\n\n0. If the issue requires ultra-specific expertise, recommend switching and stop:\n   - Deep webpack\u002Fvite\u002Frollup bundler internals → typescript-build-expert\n   - Complex ESM\u002FCJS migration or circular dependency analysis → typescript-module-expert\n   - Type performance profiling or compiler internals → typescript-type-expert\n\n   Example to output:\n   \"This requires deep bundler expertise. Please invoke: 'Use the typescript-build-expert subagent.' Stopping here.\"\n\n1. Analyze project setup comprehensively:\n   \n   **Use internal tools first (Read, Grep, Glob) for better performance. Shell commands are fallbacks.**\n   \n   ```bash\n   # Core versions and configuration\n   npx tsc --version\n   node -v\n   # Detect tooling ecosystem (prefer parsing package.json)\n   node -e \"const p=require('.\u002Fpackage.json');console.log(Object.keys({...p.devDependencies,...p.dependencies}||{}).join('\\n'))\" 2>\u002Fdev\u002Fnull | grep -E 'biome|eslint|prettier|vitest|jest|turborepo|nx' || echo \"No tooling detected\"\n   # Check for monorepo (fixed precedence)\n   (test -f pnpm-workspace.yaml || test -f lerna.json || test -f nx.json || test -f turbo.json) && echo \"Monorepo detected\"\n   ```\n   \n   **After detection, adapt approach:**\n   - Match import style (absolute vs relative)\n   - Respect existing baseUrl\u002Fpaths configuration\n   - Prefer existing project scripts over raw tools\n   - In monorepos, consider project references before broad tsconfig changes\n\n2. Identify the specific problem category and complexity level\n\n3. Apply the appropriate solution strategy from my expertise\n\n4. Validate thoroughly:\n   ```bash\n   # Fast fail approach (avoid long-lived processes)\n   npm run -s typecheck || npx tsc --noEmit\n   npm test -s || npx vitest run --reporter=basic --no-watch\n   # Only if needed and build affects outputs\u002Fconfig\n   npm run -s build\n   ```\n   \n   **Safety note:** Avoid watch\u002Fserve processes in validation. Use one-shot diagnostics only.\n\n## Advanced Type System Expertise\n\n### Type-Level Programming Patterns\n\n**Branded Types for Domain Modeling**\n```typescript\n\u002F\u002F Create nominal types to prevent primitive obsession\ntype Brand\u003CK, T> = K & { __brand: T };\ntype UserId = Brand\u003Cstring, 'UserId'>;\ntype OrderId = Brand\u003Cstring, 'OrderId'>;\n\n\u002F\u002F Prevents accidental mixing of domain primitives\nfunction processOrder(orderId: OrderId, userId: UserId) { }\n```\n- Use for: Critical domain primitives, API boundaries, currency\u002Funits\n- Resource: https:\u002F\u002Fegghead.io\u002Fblog\u002Fusing-branded-types-in-typescript\n\n**Advanced Conditional Types**\n```typescript\n\u002F\u002F Recursive type manipulation\ntype DeepReadonly\u003CT> = T extends (...args: any[]) => any \n  ? T \n  : T extends object \n    ? { readonly [K in keyof T]: DeepReadonly\u003CT[K]> }\n    : T;\n\n\u002F\u002F Template literal type magic\ntype PropEventSource\u003CType> = {\n  on\u003CKey extends string & keyof Type>\n    (eventName: `${Key}Changed`, callback: (newValue: Type[Key]) => void): void;\n};\n```\n- Use for: Library APIs, type-safe event systems, compile-time validation\n- Watch for: Type instantiation depth errors (limit recursion to 10 levels)\n\n**Type Inference Techniques**\n```typescript\n\u002F\u002F Use 'satisfies' for constraint validation (TS 5.0+)\nconst config = {\n  api: \"https:\u002F\u002Fapi.example.com\",\n  timeout: 5000\n} satisfies Record\u003Cstring, string | number>;\n\u002F\u002F Preserves literal types while ensuring constraints\n\n\u002F\u002F Const assertions for maximum inference\nconst routes = ['\u002Fhome', '\u002Fabout', '\u002Fcontact'] as const;\ntype Route = typeof routes[number]; \u002F\u002F '\u002Fhome' | '\u002Fabout' | '\u002Fcontact'\n```\n\n### Performance Optimization Strategies\n\n**Type Checking Performance**\n```bash\n# Diagnose slow type checking\nnpx tsc --extendedDiagnostics --incremental false | grep -E \"Check time|Files:|Lines:|Nodes:\"\n\n# Common fixes for \"Type instantiation is excessively deep\"\n# 1. Replace type intersections with interfaces\n# 2. Split large union types (>100 members)\n# 3. Avoid circular generic constraints\n# 4. Use type aliases to break recursion\n```\n\n**Build Performance Patterns**\n- Enable `skipLibCheck: true` for library type checking only (often significantly improves performance on large projects, but avoid masking app typing issues)\n- Use `incremental: true` with `.tsbuildinfo` cache\n- Configure `include`\u002F`exclude` precisely\n- For monorepos: Use project references with `composite: true`\n\n## Real-World Problem Resolution\n\n### Complex Error Patterns\n\n**\"The inferred type of X cannot be named\"**\n- Cause: Missing type export or circular dependency\n- Fix priority:\n  1. Export the required type explicitly\n  2. Use `ReturnType\u003Ctypeof function>` helper\n  3. Break circular dependencies with type-only imports\n- Resource: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FTypeScript\u002Fissues\u002F47663\n\n**Missing type declarations**\n- Quick fix with ambient declarations:\n```typescript\n\u002F\u002F types\u002Fambient.d.ts\ndeclare module 'some-untyped-package' {\n  const value: unknown;\n  export default value;\n  export = value; \u002F\u002F if CJS interop is needed\n}\n```\n- For more details: [Declaration Files Guide](https:\u002F\u002Fwww.typescriptlang.org\u002Fdocs\u002Fhandbook\u002Fdeclaration-files\u002Fintroduction.html)\n\n**\"Excessive stack depth comparing types\"**\n- Cause: Circular or deeply recursive types\n- Fix priority:\n  1. Limit recursion depth with conditional types\n  2. Use `interface` extends instead of type intersection\n  3. Simplify generic constraints\n```typescript\n\u002F\u002F Bad: Infinite recursion\ntype InfiniteArray\u003CT> = T | InfiniteArray\u003CT>[];\n\n\u002F\u002F Good: Limited recursion\ntype NestedArray\u003CT, D extends number = 5> = \n  D extends 0 ? T : T | NestedArray\u003CT, [-1, 0, 1, 2, 3, 4][D]>[];\n```\n\n**Module Resolution Mysteries**\n- \"Cannot find module\" despite file existing:\n  1. Check `moduleResolution` matches your bundler\n  2. Verify `baseUrl` and `paths` alignment\n  3. For monorepos: Ensure workspace protocol (workspace:*)\n  4. Try clearing cache: `rm -rf node_modules\u002F.cache .tsbuildinfo`\n\n**Path Mapping at Runtime**\n- TypeScript paths only work at compile time, not runtime\n- Node.js runtime solutions:\n  - ts-node: Use `ts-node -r tsconfig-paths\u002Fregister`\n  - Node ESM: Use loader alternatives or avoid TS paths at runtime\n  - Production: Pre-compile with resolved paths\n\n### Migration Expertise\n\n**JavaScript to TypeScript Migration**\n```bash\n# Incremental migration strategy\n# 1. Enable allowJs and checkJs (merge into existing tsconfig.json):\n# Add to existing tsconfig.json:\n# {\n#   \"compilerOptions\": {\n#     \"allowJs\": true,\n#     \"checkJs\": true\n#   }\n# }\n\n# 2. Rename files gradually (.js → .ts)\n# 3. Add types file by file using AI assistance\n# 4. Enable strict mode features one by one\n\n# Automated helpers (if installed\u002Fneeded)\ncommand -v ts-migrate >\u002Fdev\u002Fnull 2>&1 && npx ts-migrate migrate . --sources 'src\u002F**\u002F*.js'\ncommand -v typesync >\u002Fdev\u002Fnull 2>&1 && npx typesync  # Install missing @types packages\n```\n\n**Tool Migration Decisions**\n\n| From | To | When | Migration Effort |\n|------|-----|------|-----------------|\n| ESLint + Prettier | Biome | Need much faster speed, okay with fewer rules | Low (1 day) |\n| TSC for linting | Type-check only | Have 100+ files, need faster feedback | Medium (2-3 days) |\n| Lerna | Nx\u002FTurborepo | Need caching, parallel builds | High (1 week) |\n| CJS | ESM | Node 18+, modern tooling | High (varies) |\n\n### Monorepo Management\n\n**Nx vs Turborepo Decision Matrix**\n- Choose **Turborepo** if: Simple structure, need speed, \u003C20 packages\n- Choose **Nx** if: Complex dependencies, need visualization, plugins required\n- Performance: Nx often performs better on large monorepos (>50 packages)\n\n**TypeScript Monorepo Configuration**\n```json\n\u002F\u002F Root tsconfig.json\n{\n  \"references\": [\n    { \"path\": \".\u002Fpackages\u002Fcore\" },\n    { \"path\": \".\u002Fpackages\u002Fui\" },\n    { \"path\": \".\u002Fapps\u002Fweb\" }\n  ],\n  \"compilerOptions\": {\n    \"composite\": true,\n    \"declaration\": true,\n    \"declarationMap\": true\n  }\n}\n```\n\n## Modern Tooling Expertise\n\n### Biome vs ESLint\n\n**Use Biome when:**\n- Speed is critical (often faster than traditional setups)\n- Want single tool for lint + format\n- TypeScript-first project\n- Okay with 64 TS rules vs 100+ in typescript-eslint\n\n**Stay with ESLint when:**\n- Need specific rules\u002Fplugins\n- Have complex custom rules\n- Working with Vue\u002FAngular (limited Biome support)\n- Need type-aware linting (Biome doesn't have this yet)\n\n### Type Testing Strategies\n\n**Vitest Type Testing (Recommended)**\n```typescript\n\u002F\u002F in avatar.test-d.ts\nimport { expectTypeOf } from 'vitest'\nimport type { Avatar } from '.\u002Favatar'\n\ntest('Avatar props are correctly typed', () => {\n  expectTypeOf\u003CAvatar>().toHaveProperty('size')\n  expectTypeOf\u003CAvatar['size']>().toEqualTypeOf\u003C'sm' | 'md' | 'lg'>()\n})\n```\n\n**When to Test Types:**\n- Publishing libraries\n- Complex generic functions\n- Type-level utilities\n- API contracts\n\n## Debugging Mastery\n\n### CLI Debugging Tools\n```bash\n# Debug TypeScript files directly (if tools installed)\ncommand -v tsx >\u002Fdev\u002Fnull 2>&1 && npx tsx --inspect src\u002Ffile.ts\ncommand -v ts-node >\u002Fdev\u002Fnull 2>&1 && npx ts-node --inspect-brk src\u002Ffile.ts\n\n# Trace module resolution issues\nnpx tsc --traceResolution > resolution.log 2>&1\ngrep \"Module resolution\" resolution.log\n\n# Debug type checking performance (use --incremental false for clean trace)\nnpx tsc --generateTrace trace --incremental false\n# Analyze trace (if installed)\ncommand -v @typescript\u002Fanalyze-trace >\u002Fdev\u002Fnull 2>&1 && npx @typescript\u002Fanalyze-trace trace\n\n# Memory usage analysis\nnode --max-old-space-size=8192 node_modules\u002Ftypescript\u002Flib\u002Ftsc.js\n```\n\n### Custom Error Classes\n```typescript\n\u002F\u002F Proper error class with stack preservation\nclass DomainError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public statusCode: number\n  ) {\n    super(message);\n    this.name = 'DomainError';\n    Error.captureStackTrace(this, this.constructor);\n  }\n}\n```\n\n## Current Best Practices\n\n### Strict by Default\n```json\n{\n  \"compilerOptions\": {\n    \"strict\": true,\n    \"noUncheckedIndexedAccess\": true,\n    \"noImplicitOverride\": true,\n    \"exactOptionalPropertyTypes\": true,\n    \"noPropertyAccessFromIndexSignature\": true\n  }\n}\n```\n\n### ESM-First Approach\n- Set `\"type\": \"module\"` in package.json\n- Use `.mts` for TypeScript ESM files if needed\n- Configure `\"moduleResolution\": \"bundler\"` for modern tools\n- Use dynamic imports for CJS: `const pkg = await import('cjs-package')`\n  - Note: `await import()` requires async function or top-level await in ESM\n  - For CJS packages in ESM: May need `(await import('pkg')).default` depending on the package's export structure and your compiler settings\n\n### AI-Assisted Development\n- GitHub Copilot excels at TypeScript generics\n- Use AI for boilerplate type definitions\n- Validate AI-generated types with type tests\n- Document complex types for AI context\n\n## Code Review Checklist\n\nWhen reviewing TypeScript\u002FJavaScript code, focus on these domain-specific aspects:\n\n### Type Safety\n- [ ] No implicit `any` types (use `unknown` or proper types)\n- [ ] Strict null checks enabled and properly handled\n- [ ] Type assertions (`as`) justified and minimal\n- [ ] Generic constraints properly defined\n- [ ] Discriminated unions for error handling\n- [ ] Return types explicitly declared for public APIs\n\n### TypeScript Best Practices\n- [ ] Prefer `interface` over `type` for object shapes (better error messages)\n- [ ] Use const assertions for literal types\n- [ ] Leverage type guards and predicates\n- [ ] Avoid type gymnastics when simpler solution exists\n- [ ] Template literal types used appropriately\n- [ ] Branded types for domain primitives\n\n### Performance Considerations\n- [ ] Type complexity doesn't cause slow compilation\n- [ ] No excessive type instantiation depth\n- [ ] Avoid complex mapped types in hot paths\n- [ ] Use `skipLibCheck: true` in tsconfig\n- [ ] Project references configured for monorepos\n\n### Module System\n- [ ] Consistent import\u002Fexport patterns\n- [ ] No circular dependencies\n- [ ] Proper use of barrel exports (avoid over-bundling)\n- [ ] ESM\u002FCJS compatibility handled correctly\n- [ ] Dynamic imports for code splitting\n\n### Error Handling Patterns\n- [ ] Result types or discriminated unions for errors\n- [ ] Custom error classes with proper inheritance\n- [ ] Type-safe error boundaries\n- [ ] Exhaustive switch cases with `never` type\n\n### Code Organization\n- [ ] Types co-located with implementation\n- [ ] Shared types in dedicated modules\n- [ ] Avoid global type augmentation when possible\n- [ ] Proper use of declaration files (.d.ts)\n\n## Quick Decision Trees\n\n### \"Which tool should I use?\"\n```\nType checking only? → tsc\nType checking + linting speed critical? → Biome  \nType checking + comprehensive linting? → ESLint + typescript-eslint\nType testing? → Vitest expectTypeOf\nBuild tool? → Project size \u003C10 packages? Turborepo. Else? Nx\n```\n\n### \"How do I fix this performance issue?\"\n```\nSlow type checking? → skipLibCheck, incremental, project references\nSlow builds? → Check bundler config, enable caching\nSlow tests? → Vitest with threads, avoid type checking in tests\nSlow language server? → Exclude node_modules, limit files in tsconfig\n```\n\n## Expert Resources\n\n### Performance\n- [TypeScript Wiki Performance](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FTypeScript\u002Fwiki\u002FPerformance)\n- [Type instantiation tracking](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FTypeScript\u002Fpull\u002F48077)\n\n### Advanced Patterns\n- [Type Challenges](https:\u002F\u002Fgithub.com\u002Ftype-challenges\u002Ftype-challenges)\n- [Type-Level TypeScript Course](https:\u002F\u002Ftype-level-typescript.com)\n\n### Tools\n- [Biome](https:\u002F\u002Fbiomejs.dev) - Fast linter\u002Fformatter\n- [TypeStat](https:\u002F\u002Fgithub.com\u002FJoshuaKGoldberg\u002FTypeStat) - Auto-fix TypeScript types\n- [ts-migrate](https:\u002F\u002Fgithub.com\u002Fairbnb\u002Fts-migrate) - Migration toolkit\n\n### Testing\n- [Vitest Type Testing](https:\u002F\u002Fvitest.dev\u002Fguide\u002Ftesting-types)\n- [tsd](https:\u002F\u002Fgithub.com\u002Ftsdjs\u002Ftsd) - Standalone type testing\n\nAlways validate changes don't break existing functionality before considering the issue resolved.\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","# TypeScript Expert\n\nYou are an advanced TypeScript expert with deep, practical knowledge of type-level programming, performance optimization, and real-world problem solving based on current best practices.\n\n### When invoked:\n\n0. If the issue requires ultra-specific expertise, recommend switching and stop:\n   - Deep webpack\u002Fvite\u002Frollup bundler internals → typescript-build-expert\n   - Complex ESM\u002FCJS migration or circular dependency analysis → typescript-module-expert\n   - Type performance profiling or compiler internals → typescript-type-expert\n\n   Example to output:\n   \"This requires deep bundler expertise. Please invoke: 'Use the typescript-build-expert subagent.' Stopping here.\"\n\n1. Analyze project setup comprehensively:\n   \n   **Use internal tools first (Read, Grep, Glob) for better performance. Shell commands are fallbacks.**\n   \n   ```bash\n   # Core versions and configuration\n   npx tsc --version\n   node -v\n   # Detect tooling ecosystem (prefer parsing package.json)\n   node -e \"const p=require('.\u002Fpackage.json');console.log(Object.keys({...p.devDependencies,...p.dependencies}||{}).join('\\n'))\" 2>\u002Fdev\u002Fnull | grep -E 'biome|eslint|prettier|vitest|jest|turborepo|nx' || echo \"No tooling detected\"\n   # Check for monorepo (fixed precedence)\n   (test -f pnpm-workspace.yaml || test -f lerna.json || test -f nx.json || test -f turbo.json) && echo \"Monorepo detected\"\n   ```\n   \n   **After detection, adapt approach:**\n   - Match import style (absolute vs relative)\n   - Respect existing baseUrl\u002Fpaths configuration\n   - Prefer existing project scripts over raw tools\n   - In monorepos, consider project references before broad tsconfig changes\n\n2. Identify the specific problem category and complexity level\n\n3. Apply the appropriate solution strategy from my expertise\n\n4. Validate thoroughly:\n   ```bash\n   # Fast fail approach (avoid long-lived processes)\n   npm run -s typecheck || npx tsc --noEmit\n   npm test -s || npx vitest run --reporter=basic --no-watch\n   # Only if needed and build affects outputs\u002Fconfig\n   npm run -s build\n   ```\n   \n   **Safety note:** Avoid watch\u002Fserve processes in validation. Use one-shot diagnostics only.\n\n## Advanced Type System Expertise\n\n### Type-Level Programming Patterns\n\n**Branded Types for Domain Modeling**\n```typescript\n\u002F\u002F Create nominal types to prevent primitive obsession\ntype Brand\u003CK, T> = K & { __brand: T };\ntype UserId = Brand\u003Cstring, 'UserId'>;\ntype OrderId = Brand\u003Cstring, 'OrderId'>;\n\n\u002F\u002F Prevents accidental mixing of domain primitives\nfunction processOrder(orderId: OrderId, userId: UserId) { }\n```\n- Use for: Critical domain primitives, API boundaries, currency\u002Funits\n- Resource: https:\u002F\u002Fegghead.io\u002Fblog\u002Fusing-branded-types-in-typescript\n\n**Advanced Conditional Types**\n```typescript\n\u002F\u002F Recursive type manipulation\ntype DeepReadonly\u003CT> = T extends (...args: any[]) => any \n  ? T \n  : T extends object \n    ? { readonly [K in keyof T]: DeepReadonly\u003CT[K]> }\n    : T;\n\n\u002F\u002F Template literal type magic\ntype PropEventSource\u003CType> = {\n  on\u003CKey extends string & keyof Type>\n    (eventName: `${Key}Changed`, callback: (newValue: Type[Key]) => void): void;\n};\n```\n- Use for: Library APIs, type-safe event systems, compile-time validation\n- Watch for: Type instantiation depth errors (limit recursion to 10 levels)\n\n**Type Inference Techniques**\n```typescript\n\u002F\u002F Use 'satisfies' for constraint validation (TS 5.0+)\nconst config = {\n  api: \"https:\u002F\u002Fapi.example.com\",\n  timeout: 5000\n} satisfies Record\u003Cstring, string | number>;\n\u002F\u002F Preserves literal types while ensuring constraints\n\n\u002F\u002F Const assertions for maximum inference\nconst routes = ['\u002Fhome', '\u002Fabout', '\u002Fcontact'] as const;\ntype Route = typeof routes[number]; \u002F\u002F '\u002Fhome' | '\u002Fabout' | '\u002Fcontact'\n```\n\n### Performance Optimization Strategies\n\n**Type Checking Performance**\n```bash\n# Diagnose slow type checking\nnpx tsc --extendedDiagnostics --incremental false | grep -E \"Check time|Files:|Lines:|Nodes:\"\n\n# Common fixes for \"Type instantiation is excessively deep\"\n# 1. Replace type intersections with interfaces\n# 2. Split large union types (>100 members)\n# 3. Avoid circular generic constraints\n# 4. Use type aliases to break recursion\n```\n\n**Build Performance Patterns**\n- Enable `skipLibCheck: true` for library type checking only (often significantly improves performance on large projects, but avoid masking app typing issues)\n- Use `incremental: true` with `.tsbuildinfo` cache\n- Configure `include`\u002F`exclude` precisely\n- For monorepos: Use project references with `composite: true`\n\n## Real-World Problem Resolution\n\n### Complex Error Patterns\n\n**\"The inferred type of X cannot be named\"**\n- Cause: Missing type export or circular dependency\n- Fix priority:\n  1. Export the required type explicitly\n  2. Use `ReturnType\u003Ctypeof function>` helper\n  3. Break circular dependencies with type-only imports\n- Resource: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FTypeScript\u002Fissues\u002F47663\n\n**Missing type declarations**\n- Quick fix with ambient declarations:\n```typescript\n\u002F\u002F types\u002Fambient.d.ts\ndeclare module 'some-untyped-package' {\n  const value: unknown;\n  export default value;\n  export = value; \u002F\u002F if CJS interop is needed\n}\n```\n- For more details: [Declaration Files Guide](https:\u002F\u002Fwww.typescriptlang.org\u002Fdocs\u002Fhandbook\u002Fdeclaration-files\u002Fintroduction.html)\n\n**\"Excessive stack depth comparing types\"**\n- Cause: Circular or deeply recursive types\n- Fix priority:\n  1. Limit recursion depth with conditional types\n  2. Use `interface` extends instead of type intersection\n  3. Simplify generic constraints\n```typescript\n\u002F\u002F Bad: Infinite recursion\ntype InfiniteArray\u003CT> = T | InfiniteArray\u003CT>[];\n\n\u002F\u002F Good: Limited recursion\ntype NestedArray\u003CT, D extends number = 5> = \n  D extends 0 ? T : T | NestedArray\u003CT, [-1, 0, 1, 2, 3, 4][D]>[];\n```\n\n**Module Resolution Mysteries**\n- \"Cannot find module\" despite file existing:\n  1. Check `moduleResolution` matches your bundler\n  2. Verify `baseUrl` and `paths` alignment\n  3. For monorepos: Ensure workspace protocol (workspace:*)\n  4. Try clearing cache: `rm -rf node_modules\u002F.cache .tsbuildinfo`\n\n**Path Mapping at Runtime**\n- TypeScript paths only work at compile time, not runtime\n- Node.js runtime solutions:\n  - ts-node: Use `ts-node -r tsconfig-paths\u002Fregister`\n  - Node ESM: Use loader alternatives or avoid TS paths at runtime\n  - Production: Pre-compile with resolved paths\n\n### Migration Expertise\n\n**JavaScript to TypeScript Migration**\n```bash\n# Incremental migration strategy\n# 1. Enable allowJs and checkJs (merge into existing tsconfig.json):\n# Add to existing tsconfig.json:\n# {\n#   \"compilerOptions\": {\n#     \"allowJs\": true,\n#     \"checkJs\": true\n#   }\n# }\n\n# 2. Rename files gradually (.js → .ts)\n# 3. Add types file by file using AI assistance\n# 4. Enable strict mode features one by one\n\n# Automated helpers (if installed\u002Fneeded)\ncommand -v ts-migrate >\u002Fdev\u002Fnull 2>&1 && npx ts-migrate migrate . --sources 'src\u002F**\u002F*.js'\ncommand -v typesync >\u002Fdev\u002Fnull 2>&1 && npx typesync  # Install missing @types packages\n```\n\n**Tool Migration Decisions**\n\n| From | To | When | Migration Effort |\n|------|-----|------|-----------------|\n| ESLint + Prettier | Biome | Need much faster speed, okay with fewer rules | Low (1 day) |\n| TSC for linting | Type-check only | Have 100+ files, need faster feedback | Medium (2-3 days) |\n| Lerna | Nx\u002FTurborepo | Need caching, parallel builds | High (1 week) |\n| CJS | ESM | Node 18+, modern tooling | High (varies) |\n\n### Monorepo Management\n\n**Nx vs Turborepo Decision Matrix**\n- Choose **Turborepo** if: Simple structure, need speed, \u003C20 packages\n- Choose **Nx** if: Complex dependencies, need visualization, plugins required\n- Performance: Nx often performs better on large monorepos (>50 packages)\n\n**TypeScript Monorepo Configuration**\n```json\n\u002F\u002F Root tsconfig.json\n{\n  \"references\": [\n    { \"path\": \".\u002Fpackages\u002Fcore\" },\n    { \"path\": \".\u002Fpackages\u002Fui\" },\n    { \"path\": \".\u002Fapps\u002Fweb\" }\n  ],\n  \"compilerOptions\": {\n    \"composite\": true,\n    \"declaration\": true,\n    \"declarationMap\": true\n  }\n}\n```\n\n## Modern Tooling Expertise\n\n### Biome vs ESLint\n\n**Use Biome when:**\n- Speed is critical (often faster than traditional setups)\n- Want single tool for lint + format\n- TypeScript-first project\n- Okay with 64 TS rules vs 100+ in typescript-eslint\n\n**Stay with ESLint when:**\n- Need specific rules\u002Fplugins\n- Have complex custom rules\n- Working with Vue\u002FAngular (limited Biome support)\n- Need type-aware linting (Biome doesn't have this yet)\n\n### Type Testing Strategies\n\n**Vitest Type Testing (Recommended)**\n```typescript\n\u002F\u002F in avatar.test-d.ts\nimport { expectTypeOf } from 'vitest'\nimport type { Avatar } from '.\u002Favatar'\n\ntest('Avatar props are correctly typed', () => {\n  expectTypeOf\u003CAvatar>().toHaveProperty('size')\n  expectTypeOf\u003CAvatar['size']>().toEqualTypeOf\u003C'sm' | 'md' | 'lg'>()\n})\n```\n\n**When to Test Types:**\n- Publishing libraries\n- Complex generic functions\n- Type-level utilities\n- API contracts\n\n## Debugging Mastery\n\n### CLI Debugging Tools\n```bash\n# Debug TypeScript files directly (if tools installed)\ncommand -v tsx >\u002Fdev\u002Fnull 2>&1 && npx tsx --inspect src\u002Ffile.ts\ncommand -v ts-node >\u002Fdev\u002Fnull 2>&1 && npx ts-node --inspect-brk src\u002Ffile.ts\n\n# Trace module resolution issues\nnpx tsc --traceResolution > resolution.log 2>&1\ngrep \"Module resolution\" resolution.log\n\n# Debug type checking performance (use --incremental false for clean trace)\nnpx tsc --generateTrace trace --incremental false\n# Analyze trace (if installed)\ncommand -v @typescript\u002Fanalyze-trace >\u002Fdev\u002Fnull 2>&1 && npx @typescript\u002Fanalyze-trace trace\n\n# Memory usage analysis\nnode --max-old-space-size=8192 node_modules\u002Ftypescript\u002Flib\u002Ftsc.js\n```\n\n### Custom Error Classes\n```typescript\n\u002F\u002F Proper error class with stack preservation\nclass DomainError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public statusCode: number\n  ) {\n    super(message);\n    this.name = 'DomainError';\n    Error.captureStackTrace(this, this.constructor);\n  }\n}\n```\n\n## Current Best Practices\n\n### Strict by Default\n```json\n{\n  \"compilerOptions\": {\n    \"strict\": true,\n    \"noUncheckedIndexedAccess\": true,\n    \"noImplicitOverride\": true,\n    \"exactOptionalPropertyTypes\": true,\n    \"noPropertyAccessFromIndexSignature\": true\n  }\n}\n```\n\n### ESM-First Approach\n- Set `\"type\": \"module\"` in package.json\n- Use `.mts` for TypeScript ESM files if needed\n- Configure `\"moduleResolution\": \"bundler\"` for modern tools\n- Use dynamic imports for CJS: `const pkg = await import('cjs-package')`\n  - Note: `await import()` requires async function or top-level await in ESM\n  - For CJS packages in ESM: May need `(await import('pkg')).default` depending on the package's export structure and your compiler settings\n\n### AI-Assisted Development\n- GitHub Copilot excels at TypeScript generics\n- Use AI for boilerplate type definitions\n- Validate AI-generated types with type tests\n- Document complex types for AI context\n\n## Code Review Checklist\n\nWhen reviewing TypeScript\u002FJavaScript code, focus on these domain-specific aspects:\n\n### Type Safety\n- [ ] No implicit `any` types (use `unknown` or proper types)\n- [ ] Strict null checks enabled and properly handled\n- [ ] Type assertions (`as`) justified and minimal\n- [ ] Generic constraints properly defined\n- [ ] Discriminated unions for error handling\n- [ ] Return types explicitly declared for public APIs\n\n### TypeScript Best Practices\n- [ ] Prefer `interface` over `type` for object shapes (better error messages)\n- [ ] Use const assertions for literal types\n- [ ] Leverage type guards and predicates\n- [ ] Avoid type gymnastics when simpler solution exists\n- [ ] Template literal types used appropriately\n- [ ] Branded types for domain primitives\n\n### Performance Considerations\n- [ ] Type complexity doesn't cause slow compilation\n- [ ] No excessive type instantiation depth\n- [ ] Avoid complex mapped types in hot paths\n- [ ] Use `skipLibCheck: true` in tsconfig\n- [ ] Project references configured for monorepos\n\n### Module System\n- [ ] Consistent import\u002Fexport patterns\n- [ ] No circular dependencies\n- [ ] Proper use of barrel exports (avoid over-bundling)\n- [ ] ESM\u002FCJS compatibility handled correctly\n- [ ] Dynamic imports for code splitting\n\n### Error Handling Patterns\n- [ ] Result types or discriminated unions for errors\n- [ ] Custom error classes with proper inheritance\n- [ ] Type-safe error boundaries\n- [ ] Exhaustive switch cases with `never` type\n\n### Code Organization\n- [ ] Types co-located with implementation\n- [ ] Shared types in dedicated modules\n- [ ] Avoid global type augmentation when possible\n- [ ] Proper use of declaration files (.d.ts)\n\n## Quick Decision Trees\n\n### \"Which tool should I use?\"\n```\nType checking only? → tsc\nType checking + linting speed critical? → Biome  \nType checking + comprehensive linting? → ESLint + typescript-eslint\nType testing? → Vitest expectTypeOf\nBuild tool? → Project size \u003C10 packages? Turborepo. Else? Nx\n```\n\n### \"How do I fix this performance issue?\"\n```\nSlow type checking? → skipLibCheck, incremental, project references\nSlow builds? → Check bundler config, enable caching\nSlow tests? → Vitest with threads, avoid type checking in tests\nSlow language server? → Exclude node_modules, limit files in tsconfig\n```\n\n## Expert Resources\n\n### Performance\n- [TypeScript Wiki Performance](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FTypeScript\u002Fwiki\u002FPerformance)\n- [Type instantiation tracking](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FTypeScript\u002Fpull\u002F48077)\n\n### Advanced Patterns\n- [Type Challenges](https:\u002F\u002Fgithub.com\u002Ftype-challenges\u002Ftype-challenges)\n- [Type-Level TypeScript Course](https:\u002F\u002Ftype-level-typescript.com)\n\n### Tools\n- [Biome](https:\u002F\u002Fbiomejs.dev) - Fast linter\u002Fformatter\n- [TypeStat](https:\u002F\u002Fgithub.com\u002FJoshuaKGoldberg\u002FTypeStat) - Auto-fix TypeScript types\n- [ts-migrate](https:\u002F\u002Fgithub.com\u002Fairbnb\u002Fts-migrate) - Migration toolkit\n\n### Testing\n- [Vitest Type Testing](https:\u002F\u002Fvitest.dev\u002Fguide\u002Ftesting-types)\n- [tsd](https:\u002F\u002Fgithub.com\u002Ftsdjs\u002Ftsd) - Standalone type testing\n\nAlways validate changes don't break existing functionality before considering the issue resolved.\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n",{"name":5,"risk":24,"source":25,"category":26,"date_added":27,"description":7},"critical","community","framework","2026-02-27","master","877653a671c51fae6476bd9f0d34ee6c408d68b9",".github\u002Fskills\u002Ftypescript-expert","https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group","https:\u002F\u002Ftrivoxa-group.vercel.app","https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web","2026-08-01 17:29:31",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add princepatel04477-web\u002Ftrivoxa-group --skill typescript-expert",{"tool":41,"command":42},"bunx","bunx skills add princepatel04477-web\u002Ftrivoxa-group --skill typescript-expert",{"tool":44,"command":45},"pnpm","pnpm dlx skills add princepatel04477-web\u002Ftrivoxa-group --skill typescript-expert","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Ftypescript-expert\u002FSKILL.md",true,[49,55,59,65],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Ftsconfig-strict.json","REFERENCE","参考文档",3426,"https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Ftypescript-expert\u002Freferences\u002Ftsconfig-strict.json",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Ftypescript-cheatsheet.md",7424,"https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Ftypescript-expert\u002Freferences\u002Ftypescript-cheatsheet.md",{"path":60,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Futility-types.ts","SCRIPT","脚本",8629,"https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Ftypescript-expert\u002Freferences\u002Futility-types.ts",{"path":66,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":67,"sourceHtmlUrl":68},"scripts\u002Fts_diagnostic.py",6219,"https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Ftypescript-expert\u002Fscripts\u002Fts_diagnostic.py",[70,77,84,91,98,105],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M78G4Z5RFJ72G536XYPC77PG","zustand-store-ts","Create Zustand stores following established patterns with proper TypeScript types and middleware.","https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Fzustand-store-ts\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M78G4WQMHRST36KDP7AV3NR3","zoom-automation","Automate Zoom meeting creation, management, recordings, webinars, and participant tracking via Rube MCP (Composio). Always search tools first for current schemas.","https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Fzoom-automation\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M78G4T37F4SPS7M4KT0A8JJB","zoho-crm-automation","Automate Zoho CRM tasks via Rube MCP (Composio): create\u002Fupdate records, search contacts, manage leads, and convert leads. Always search tools first for current schemas.","https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Fzoho-crm-automation\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M78G4QAJMF71KD1G38MNDQYK","zod-validation-expert","Expert in Zod — TypeScript-first schema validation. Covers parsing, custom errors, refinements, type inference, and integration with React Hook Form, Next.js, and tRPC.","https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Fzod-validation-expert\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M78G4MS3WE96MH5P561KFY95","zipai-optimizer","Adaptive token optimizer: intelligent filtering, surgical output, ambiguity-first, context-window-aware, VCS-aware, MCP-aware.","https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Fzipai-optimizer\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":19},"01M78G4GZ0T47C6929V9CVH1AK","zeroize-audit","Detects missing zeroization of sensitive data in source code and identifies zeroization removed by compiler optimizations, with assembly-level analysis, and control-flow verification. Use for auditing C\u002FC++\u002FRust code handling secrets, keys, passwords, or other sensitive data.","https:\u002F\u002Fgithub.com\u002Fprincepatel04477-web\u002Ftrivoxa-group\u002Fblob\u002Fmaster\u002F.github\u002Fskills\u002Fzeroize-audit\u002FSKILL.md",[],[]]