feat: ecosystem improvements — public API, new options, CJS, regex attrs

[pierluigilenoci]

Summary

Comprehensive feature release bringing the plugin in line with ecosystem best practices observed in popular Prettier plugins (tailwindcss, svelte, astro, organize-imports, sort-imports).

New Features

• Public Sorting API — import { createSorter } from 'prettier-plugin-bootstrap/sorter' for programmatic use in linters, codemods, and build tools
• bootstrapPreserveWhitespace — preserve original multi-space/tab separators between classes
• bootstrapPreserveDuplicates — set to false to remove duplicate class names
• Regex in bootstrapAttributes — patterns like /^data-class/ match dynamic attribute names
• File-level ignore — <!-- prettier-bootstrap-ignore --> skips sorting for an entire file
• bootstrapVersion — declared option for future version-specific sorting rules
• CJS export — dual ESM+CJS build for CommonJS consumers

Infrastructure

• Prettier version matrix in CI (3.0.0 + latest 3.x)
• Test fixtures with snapshot testing (HTML, JSX, Vue)
• FUNDING.yml for GitHub Sponsors

Documentation

• "Why?" rationale section
• Plugin Compatibility table with load order guidance
• TypeScript/JSDoc configuration example
• Regex attributes documentation
• File-level ignore documentation
• FAQ: printWidth interaction

Stats

• 121 tests, 100% coverage (statements, branches, functions, lines)
• Dual ESM+CJS output verified at runtime
• Publish dry-run passes

Test plan

• pnpm run lint — clean
• pnpm run format:check — clean
• pnpm run typecheck — clean
• pnpm run test:coverage — 121 tests, 100% coverage
• pnpm run build — produces index.mjs, index.cjs, sorter.mjs, sorter.cjs + type declarations
• node -e "import('./dist/index.mjs')" — OK
• node -e "require('./dist/index.cjs')" — OK
• node -e "import('./dist/sorter.mjs')" — OK
• pnpm publish --dry-run — valid package

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (ff2cd30) to head (b543b98).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main       #12   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            4         5    +1     
  Lines          549       635   +86     
  Branches        82       104   +22     
=========================================
+ Hits           549       635   +86     

☔ 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.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.