The repository generates a large number of .d.ts files during local builds
(especially under services/lib/). To keep the tree clean and reviewable:
- Treat
.d.tsand.d.ts.mapfiles as build artifacts. They are ignored globally in.gitignore, with a short allowlist for hand-authored entrypoints that must stay versioned (see the exception list in.gitignore). - Do not commit newly generated declaration files. If you notice untracked
.d.tsoutput locally, run the relevant clean script (e.g.,npm run cleanin the service) or remove the files after use. - To regenerate declarations, use the service’s normal build (
npm run build) ortsc --declarationwhere applicable. This keeps TypeScript consumers whole without bloating git history. - When adding a truly hand-written declaration file that should be tracked,
explicitly add an exception to
.gitignoreand document why it is needed in the owning package’s README.
This policy reduces noise from 10k+ generated artifacts while keeping intentional API surfaces documented.