Skip to content
ContractSpec
Start here

Package manual · tools

·CLI, authoring and agent tooling

tool.typescript

Pinned TypeScript tooling and shared compiler configuration for ContractSpec packages.

toolstoolv5.0.4stableservernode
@lssm-tech/tool.typescript
bun add @lssm-tech/tool.typescript
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Website: https://contractspec.io

Shared TypeScript configuration presets (base, nextjs, react-library) extended by every package's tsconfig.json in the monorepo.

What It Provides

  • Layer: tool
  • Consumers: all monorepo packages (via "extends": "@lssm-tech/tool.typescript/...")

Installation

npm install @lssm-tech/tool.typescript

or

bun add @lssm-tech/tool.typescript

Local Commands

  • bun run build — validate every published shared config as a hashable Turbo dependency task
  • bun run typecheck — run the same deterministic config validation
  • bun run publish:pkg — bun publish --tolerate-republish --ignore-scripts --verbose
  • bun run publish:pkg:canary — bun publish:pkg --tag canary

Recent Updates

  • Replace eslint+prettier by biomejs to optimize speed
  • PublishConfig not supported by bun
  • Migrate non-app builds to shared Bun toolchain

TypeScript 7

The monorepo uses the stable TypeScript 7 compiler for apps, packages, declaration emit, and repository tooling. Run the broad non-app compiler check from the repository root:

sh
bun run typecheck:typescript:not-apps

This command scans packages/libs, packages/modules, and packages/bundles, uses each package's existing typecheck project (tsconfig.build.json when the package script selects it), and intentionally skips packages/apps. Use bun run typecheck:typescript:not-apps:sample for a fast representative smoke check.

contractspec-bun-build types emits declarations with the stable TypeScript 7 tsc binary.

TypeScript 7.0's programmatic API is explicitly unstable. Repository code that needs AST or project access must use an owned adapter boundary rather than importing the removed legacy typescript compiler API.

Notes

  • Compiler option changes propagate to every package -- verify with bun run typecheck across the repo
  • Do not weaken strict-mode settings (strict, noUncheckedIndexedAccess, etc.)
  • Adding a new preset file requires documenting which packages should use it

Relationships

THIS PACKAGEtool.typescript0 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

0 declarations

No Runtime dependencies are declared here.

Declared capabilities

This manifest does not declare a capability catalogue. Use the guide, import map and source to assess the package.

Scripts

  • buildbun scripts/validate-configs.mjs
  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • typecheckbun scripts/validate-configs.mjs