Breaking: Convert coverage-dir from flag to positional argument

[bartveneman]

Summary

Refactored the CLI argument parsing to accept <coverage-dir> as a positional argument instead of a named flag (--coverage-dir), improving the command-line interface usability, because many CLI's accept auto-complete for positionals, not for named arguments.

Key Changes

• Argument parsing: Modified parse_arguments() to accept coverage-dir as the first positional argument instead of a named option

  • Enabled allowPositionals: true in parseArgs() configuration
  • Removed 'coverage-dir' from the options object
  • Changed to read from positionals[0] instead of values['coverage-dir']

• CLI interface: Updated the command signature from --coverage-dir=<dir> to <coverage-dir>

  • New usage: css-coverage <coverage-dir> --min-coverage=<number> [options]
  • Added "ARGUMENTS" section to help text to document the positional argument
  • Moved --coverage-dir description from OPTIONS to ARGUMENTS section

• Tests: Updated all test cases to reflect the new positional argument syntax

  • Changed test descriptions to reference <coverage-dir> instead of --coverage-dir
  • Updated test invocations to pass coverage directory as first positional argument
  • Removed test for empty --coverage-dir flag (no longer applicable)

• Documentation: Updated all CLI examples in help text to use the new positional argument syntax

Implementation Details

The change maintains backward compatibility in the returned CliArguments object structure while improving the command-line UX by using a more conventional positional argument pattern for the primary required input.

Closes #74

[codecov-commenter]

Bundle Report

Changes will decrease total bundle size by 24 bytes (-0.09%) ⬇️. This is within the configured threshold ✅

Detailed changes

Bundle name	Size	Change
cli.js-esm	13.77kB	-24 bytes (-0.17%) ⬇️

Affected Assets, Files, and Routes:

view changes for bundle: cli.js-esm

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
cli.mjs	-24 bytes	13.77kB	-0.17%

Files in cli.mjs:

• ./src/cli/help.ts → Total Size: 1.38kB

• ./src/cli/arguments.ts → Total Size: 1.79kB

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.71%. Comparing base (dfc5876) to head (ddf03cb).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #100   +/-   ##
=======================================
  Coverage   96.71%   96.71%           
=======================================
  Files          14       14           
  Lines        1064     1064           
  Branches      142      142           
=======================================
  Hits         1029     1029           
  Misses         34       34           
  Partials        1        1           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.