algorithms/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

yarn test                  # run all tests (watch mode)
yarn test:report           # run tests with verbose output
yarn coverage              # run tests with coverage report
yarn dev                   # start Vite dev server for the demo UI
yarn build                 # compile TypeScript + build library to dist/
yarn add:module <name>     # scaffold a new algorithm module in lib/<name>/

To run a single test file:

npx vitest run lib/<name>/<name>.test.ts

Architecture

The repo has two independent layers:

• lib/ — algorithm implementations, built as a publishable npm library. Each algorithm lives in its own subdirectory (lib/<name>/) with an implementation file, a test file, and an index.ts re-export.
• src/ — Vite demo app (development only, not shipped in the library).

The library entry point is lib/main.ts. Build output goes to dist/ (counter.js / counter.umd.cjs).

Adding a New Algorithm

yarn add:module <algorithmName>

This creates lib/<algorithmName>/ with:

• <algorithmName>.ts — implementation stub
• <algorithmName>.test.ts — Vitest test with default array [-12, 1, 4, 6, 22]
• index.ts — re-export
• readme.md — template with complexity table and time-tracking table (in Russian)

For competitive-programming / stdin problems, use lib/__templateForSolution.ts as a base — it reads lines via readline and parses them as numbers.

Testing

Uses Vitest (not Jest). Test files live next to implementations in lib/. The vitest.config.ts enables @vitest/coverage-v8 for HTML + JSON coverage reports (output in coverage/).

Learning Structure

Progress is tracked in docs/:

• docs/progress.md — weekly skill ratings
• docs/daily-practice.md — session log
• docs/learning-plan.md / docs/weekly-schedule.md — roadmap
• docs/rules.md — learning philosophy and algorithm phase breakdown (Phase 1–4 over 16 weeks)