TypeScript libraries and type definitions for scripting in Counter-Strike 2.
This repository is a pnpm workspace. Each package is published independently to npm under the @s2ze scope but shares a single fixed version across the workspace.
| Package | Description |
|---|---|
@s2ze/types | Valve-provided type definitions for CS2 scripting |
@s2ze/math | Math utilities (vectors, matrices, etc.) for scripts. |
@s2ze/scheduler | Scheduling helpers, setTimeout, setInterval. |
@s2ze/debug | Debugging helpers. |
@s2ze/tsconfig | Shared TypeScript configuration consumed by the other packages. |
- Node.js (LTS recommended)
- pnpm
11.2.2(the version is pinned via thepackageManagerfield — runcorepack enableto have the correct version selected automatically)
pnpm install # install all dependencies and link workspace packages
pnpm build # compile every package (runs `build` in each package)
pnpm test# run the test suitesCommon root scripts (see package.json):
| Script | What it does |
|---|---|
pnpm build | pnpm -r run build — builds every package. |
pnpm test | pnpm -r run test — tests every package. |
pnpm lint | Run ESLint across the workspace. |
pnpm format | eslint . --fix — autofix lint/formatting. |
Each package compiles its TypeScript source in src/ down to JavaScript in a build/ directory:
When one package imports another (e.g. @s2ze/debug importing @s2ze/math), pnpm symlinks the dependency into node_modules, but Node/TypeScript resolve the import through that package's main/exports fields — which point at build/, not src/, editing packages/math/src/... does not change what @s2ze/debug sees until @s2ze/math is rebuilt and its build/ output is regenerated. The consumer reads the compiled artifact, so stale build/ output means stale behavior.
After changing a library package, you need to rebuild it for the changes to be reflected with pnpm build in the root.
MIT © Source2ZE