syncing-tsconfig-paths
从package.json导入字段同步tsconfig.json路径。确保TypeScript在开发过程中正确解析子路径导入(#imports)。
📖 中文导读:从package.json导入字段同步tsconfig.json路径。确保TypeScript在开发过程中正确解析子路径导入(#imports)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: syncing-tsconfig-paths description: Synchronizes tsconfig.json paths from package.json imports field. Ensures TypeScript resolves subpath imports (#imports) correctly during development.
Syncing TSConfig Paths
Keep tsconfig paths in sync with package.json subpath imports.
Steps
Syncing
pnpm exec tsx .claude/skills/syncing-tsconfig-paths/scripts/sync-tsconfig-paths.ts
Auditing
Run with --check flag to verify without modifying:
pnpm exec tsx .claude/skills/syncing-tsconfig-paths/scripts/sync-tsconfig-paths.ts --check
Reference
The script transforms package.json imports to tsconfig paths:
// package.json
{
"imports": {
"#pkg": "./build/_.js",
"#foo": "./build/foo.js"
}
}
Becomes:
// tsconfig.json
{
"compilerOptions": {
"paths": {
"#pkg": ["./src/_.ts"],
"#foo": ["./src/foo.ts"]
}
}
}
Key transformation: ./build/ → ./src/ (extension stays .js - TypeScript with nodenext resolves to .ts)
Notes
- Run after modifying any package's
importsfield - Conditional imports (objects with browser/default) are skipped with a warning
- This enables TypeScript to resolve
#imports during development before build