{"id":25091,"library":"codeshape","title":"codeshape","description":"Code postprocessing utility that abstracts over evolving toolsets: typecheck via @typescript/native-preview tsgo, lint/format via @biomejs/biome, compile via tsdown, emit type declarations. v3.1.5 is current stable. Active development. Key differentiator: single npx command replacing separate tsc, biome, and bundler steps, with zero config defaults but customizable via flags and config files.","status":"active","version":"3.1.5","language":"javascript","source_language":"en","source_url":"https://github.com/axtk/codeshape","tags":["javascript","code style","lint","format code","bundle","d.ts","type declarations"],"install":[{"cmd":"npm install codeshape","lang":"bash","label":"npm"},{"cmd":"yarn add codeshape","lang":"bash","label":"yarn"},{"cmd":"pnpm add codeshape","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"TypeScript native runtime for typechecking","package":"@typescript/native-preview","optional":false},{"reason":"Linting and formatting engine","package":"@biomejs/biome","optional":false},{"reason":"Compilation and bundling","package":"tsdown","optional":false}],"imports":[{"note":"codeshape is a CLI tool, not a library. Use npx or global install.","wrong":"require('codeshape')","symbol":"codeshape","correct":"npx codeshape [...tasks] [--flags]"},{"note":"Tasks are positional arguments, not flags. Use 'check' as shorthand.","wrong":"npx codeshape --typecheck","symbol":"tasks","correct":"npx codeshape typecheck"},{"note":"Separate tasks with spaces, not commas.","wrong":"npx codeshape --tasks lint,format","symbol":"typecheck","correct":"npx codeshape lint format"}],"quickstart":{"code":"npx codeshape typecheck lint format compile --no-commit --esm-only --minify --compile-input ./src/index.ts --compile-output ./build","lang":"javascript","description":"Runs typechecking, linting, formatting (without committing), then compiles ESM-only minified output from src/index.ts to build/."},"warnings":[{"fix":"Migrate any custom formatter setup to biome configuration.","message":"codeshape 3.x removed support for custom formatters other than biome. Use biome flags or config for formatting.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Remove --use-prettier, use --no-commit if needed.","message":"The --use-prettier flag was deprecated in v2 and removed in v3. Biome is the only formatter.","severity":"deprecated","affected_versions":">=3.0.0"},{"fix":"Use explicit tasks like `npx codeshape check` to avoid unintended compilation.","message":"Running `npx codeshape` without specifying tasks defaults to all tasks: typecheck, lint, format, compile.","severity":"gotcha","affected_versions":"*"},{"fix":"Use only one of the two to avoid confusion.","message":".lintignore and .lintinclude files override each other; if both exist, .lintignore is applied after .lintinclude.","severity":"gotcha","affected_versions":"*"},{"fix":"Set --compile-platform to 'node' for Node.js projects, 'browser' for browser projects.","message":"Compilation with --compile-platform neutral may generate code incompatible with Node.js APIs.","severity":"gotcha","affected_versions":">=3.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `npx codeshape` in a directory where the package can find its dependencies, or install globally: `npm i -g codeshape`.","cause":"Missing dependency when running without automatic npx resolution.","error":"Error: Command failed: npx codeshape typecheck\nCould not find module '@typescript/native-preview'"},{"fix":"Ensure .lintignore uses the same format as .gitignore (each line a pattern).","cause":"The .lintignore file uses a custom format not compatible with gitignore.","error":"Error: Failed to parse .lintignore: Unknown rule"},{"fix":"Use `--compile-input <path>` instead of `--compile`.","cause":"The flag name is `--compile-input` not `--compile`.","error":"error: No such flag: --compile"},{"fix":"Change to a valid directory before running codeshape.","cause":"Running in a deleted or inaccessible directory.","error":"Error: Cannot determine current working directory"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}