\n// Error: Hardcoded color \"[#E07A5F]\". Use bg-primary-500 instead.\n\n// Input:
\n// Error: Hardcoded color \"[#3B82F6]\". Use bg-info instead.\n\n// Input:
\n// Error: Hardcoded color \"[#44403C]\". Use bg-neutral-700 instead.\n```\n\n### `akanaka/component-exists`\n\nEnsures imported components exist in the Akanaka component registry.\n\n❌ **Bad:**\n```jsx\nimport { SuperButton } from '@akanaka-design/components';\nimport { FancyCard } from '@akanaka-design/components';\n```\n\n✅ **Good:**\n```jsx\nimport { Button } from '@akanaka-design/components';\nimport { Card, CardTitle, CardContent } from '@akanaka-design/components';\n```\n\n**Error message includes available components:**\n```text\nComponent \"SuperButton\" does not exist in Akanaka.\nAvailable: Alert, Avatar, Badge, Button, Card...\n```\n\n## Available Tokens\n\n### Colors\n\n**Primary (Terracotta):**\n\n`primary-50`, `primary-100`, `primary-200`, `primary-500`, `primary-600`, `primary-700`\n\n**Neutrals (Warm Stone):**\n\n`neutral-50`, `neutral-100`, `neutral-200`, `neutral-300`, `neutral-500`, `neutral-700`, `neutral-900`\n\n**Semantic:**\n\n`success`, `warning`, `error`, `info`\n\n### Components\n\n`Alert`, `Avatar`, `Badge`, `Button`, `Card`, `CardTitle`, `CardDescription`, `CardContent`, `CardFooter`, `Checkbox`, `Input`, `Label`, `Progress`, `Select`, `StatCard`, `Table`, `Tabs`, `Toggle`\n\n## Integration with Cursor\n\nThis config works seamlessly with Cursor:\n\n1. Install the package: `pnpm add -D @akanaka-design/eslint-config`\n2. Create `.eslintrc.cjs` in your project root (see Usage above)\n3. Cursor automatically shows errors in real-time as you type\n\nTip: add `.cursorrules` to reinforce design system usage:\n\n```markdown\n# Akanaka Design System Rules\n\n- NEVER use hardcoded colors\n- ALWAYS use Tailwind classes with Akanaka tokens\n- ONLY import components from @akanaka-design/components\n```\n\n## CI/CD Integration\n\n### GitHub Actions\n\n```yaml\nname: Design System Compliance\n\non:\n pull_request:\n branches: [main]\n\njobs:\n lint:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n - uses: pnpm/action-setup@v2\n - run: pnpm install\n - run: pnpm lint\n```\n\n### Turbo (Monorepo)\n\nIf using Turborepo, add to `turbo.json`:\n\n```json\n{\n \"tasks\": {\n \"lint\": {\n \"cache\": false,\n \"outputs\": []\n }\n }\n}\n```\n\nThen run:\n\n```bash\npnpm turbo lint\n```\n\n## Development\n\n### Running Tests\n\n```bash\npnpm test # Run once (includes DZI-29 regression runners via Vitest)\npnpm test:watch # Watch mode\npnpm test:regression # Only dashboard regression runners (StatCard, Badge, tokens, Card)\n```\n\n### DZI-29 regression fixtures\n\nThese guard the dashboard rules added for DZI-29 (AKA-56, AKA-57, AKA-58). Each **invalid** fixture under `tests/fixtures/regression/` is production-shaped JSX that must keep triggering the right rule. Runners lint it with a synthetic path under `**/dashboard/**` (or `table` / `compliance`) so file-scoped rules apply—if logic drifts and violations disappear, CI fails.\n\nThere are **three fixtures per rule** for `require-statcard-for-metrics`, `require-semantic-badge-variants`, and `prefer-akanaka-tokens-over-shadcn`, plus separate coverage for `prefer-ds-components`. Shared helper: `tests/regression-lint-harness.cjs`.\n\n**Adding a new regression file:** add `tests/fixtures/regression/dzi-29-.invalid.tsx`, append an entry to the relevant `tests/*-regression.runner.cjs` fixture list (with a plausible mock `page.tsx` path), and keep `messageIncludes` aligned with the rule’s current wording.\n\n### Test Coverage\n\n- Hex color detection\n- RGB/RGBA detection\n- HSL/HSLA detection\n- Tailwind arbitrary value detection\n- No double-reporting\n- Smart token suggestions\n- Component registry validation\n- Ignores non-Akanaka imports\n- Regression fixture for dashboard tokenized card divs (must fail `prefer-ds-components`)\n- DZI-29 regression: three fixtures each for StatCard, semantic `Badge`, and Shadcn→Akanaka token rules (dashboard paths)\n\n## Publishing\n\nPublish from package directory:\n\n```bash\npnpm publish --access public\n```\n\nPre-publish checklist:\n\n- `pnpm lint` passes\n- `pnpm test` passes\n- `CHANGELOG.md` updated for the release\n- `package.json` version bumped appropriately\n- `files` includes `README.md` and `CHANGELOG.md`\n\n## License\n\nMIT\n","readmeFilename":"README.md"}