chore: add initial cursor rules [AR-44781]

Author: mmurawski-dn

.cursor/rules/checkers.mdc

@@ -0,0 +1,66 @@
+---
+description: How to run tests, linting, and type checking during development
+alwaysApply: true
+---
+
+# Code Quality Checkers
+
+Run checkers **only on changed files/directories** to keep feedback fast. Run from **workspace root**.
+
+## File/Directory-Specific Commands
+
+### Linting (eslint)
+
+```bash
+# Single file
+pnpm eslint packages/design-system/src/components/ds-button/ds-button.tsx
+
+# Directory
+pnpm eslint packages/eslint-plugin/src/
+
+# With auto-fix
+pnpm eslint --fix packages/design-system/src/components/ds-button/
+```
+
+### Type Checking (tsc)
+
+TypeScript checks the whole project config, so scope by package:
+
+```bash
+# design-system package
+pnpm --filter @drivenets/design-system typecheck
+
+# eslint-plugin package
+pnpm --filter @drivenets/eslint-plugin-design-system typecheck
+
+# vite-plugin package
+pnpm --filter @drivenets/vite-plugin-design-system typecheck
+```
+
+### Tests (vitest)
+
+```bash
+# Single test file
+pnpm --filter @drivenets/design-system test packages/design-system/tests/exports.test.ts --run
+
+# Directory of tests
+pnpm --filter @drivenets/eslint-plugin-design-system test src/__tests__/ --run
+
+# Pattern match
+pnpm --filter @drivenets/vite-plugin-design-system test --run -t "snapshot"
+```
+
+## When to Run What
+
+| Changed                    | Run                                     |
+| -------------------------- | --------------------------------------- |
+| `*.test.ts` file           | `pnpm --filter <pkg> test <path> --run` |
+| Source file with tests     | Lint the file + run related tests       |
+| Source file, no tests      | Lint the file + typecheck the package   |
+| SCSS file in design-system | Lint the file                           |
+
+## Notes
+
+- **`--run` flag** prevents vitest watch mode
+- **design-system typecheck** auto-generates SCSS type defs
+- Prefer file-level lint, package-level typecheck, file-level test

.cursor/rules/code-review.mdc

@@ -0,0 +1,29 @@
+---
+description: Use this rule when doing code reviews
+alwaysApply: false
+---
+
+# Code Review Rules
+
+It is a local code review process done before submitting a PR.
+
+Objectives:
+
+1. Review the current PR diff and flag only clear, high-severity issues
+2. Ensure the PR is up to date with the upstream main branch
+3. Verify requirements and applicable code standards/cursor rules
+4. Add short JS comments with a structure:
+
+```typescript
+/**
+ * REVIEW-[SEVERITY]: [ISSUE DESCRIPTION]
+ */
+```
+
+- Align with the upstream main branch: ASK USER FOR PERMISSION, ALWAYS
+- Get diff: git diff upstream/main
+- Max 10 inline comments total; prioritize the most critical issues
+- One issue per comment; place on the exact changed line
+- Natural tone, specific and actionable; do not mention automated or a high-confidence
+- Use emojis: 🚨 Critical 🔒 Security ⚡ Performance ⚠️ Logic ✅ Resolved ✨ Improvement
+

.cursor/rules/design-system.mdc

@@ -0,0 +1,71 @@
+---
+description: Component scaffolding templates for creating new design system components
+globs: packages/design-system/src/components/**/*
+---
+
+# Component Scaffolding
+
+## File Structure
+
+New component at `packages/design-system/src/components/ds-{name}/`:
+
+```
+ds-{name}/
+├── index.ts              # Barrel export
+├── ds-{name}.tsx         # Implementation
+├── ds-{name}.types.ts    # Props interface
+├── ds-{name}.module.scss # Styles
+└── ds-{name}.stories.tsx # Stories
+```
+
+## Implementation Template
+
+```tsx
+import classNames from 'classnames';
+import styles from './ds-{name}.module.scss';
+import type { Ds{Name}Props } from './ds-{name}.types';
+
+/**
+ * Design system {Name} component
+ */
+const Ds{Name} = ({
+  className,
+  children,
+  ...props
+}: Ds{Name}Props) => {
+  return (
+    <div className={classNames(styles.container, className)} {...props}>
+      {children}
+    </div>
+  );
+};
+
+export default Ds{Name};
+```
+
+## Types Template
+
+```typescript
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+
+export interface Ds{Name}Props extends ComponentPropsWithoutRef<'div'> {
+  /**
+   * JSDoc description
+   */
+  label?: ReactNode;
+}
+```
+
+## Index Barrel
+
+```typescript
+export { default as Ds{Name} } from './ds-{name}';
+export type { Ds{Name}Props } from './ds-{name}.types';
+```
+
+## Primitive Libraries
+
+1. **Ark UI** (`@ark-ui/react`) - Primary choice for new components
+2. **Radix UI** (`@radix-ui/react-*`) - Deprecated, modify existing only
+3. **TanStack** - Data-heavy components (table, virtual)
+4. **Custom** - Only when no primitive exists

.cursor/rules/monorepo.mdc

@@ -0,0 +1,51 @@
+---
+description: Package boundaries and workspace structure
+globs: packages/**/*
+---
+
+# Package Boundaries
+
+## Structure
+
+```
+packages/
+├── design-system/       # @drivenets/design-system
+├── eslint-plugin/       # @drivenets/eslint-plugin-design-system
+├── vite-plugin/         # @drivenets/vite-plugin-design-system
+└── commitlint-plugin/   # @drivenets/commitlint-plugin-design-system
+```
+
+## Import Rules
+
+| Package | Can Import | Cannot Import |
+|---------|-----------|---------------|
+| design-system | React, Ark UI, Radix, TanStack, classnames | Other workspace packages |
+| eslint-plugin | ESLint APIs, TypeScript | React, design-system |
+| vite-plugin | Vite APIs | React, design-system |
+
+## Workspace Dependencies
+
+```json
+{
+  "devDependencies": {
+    "@drivenets/vite-plugin-design-system": "workspace:*"
+  }
+}
+```
+
+## Adding New Packages
+
+1. Create `packages/{name}/`
+2. `package.json` with name `@drivenets/{name}`
+3. `tsconfig.json` extends `../../tsconfig.base.json`
+4. `eslint.config.ts` imports from `../../eslint.config.base.ts`
+
+## Cross-Package Imports
+
+```typescript
+// Good - use package name
+import { util } from '@drivenets/design-system';
+
+// Bad - relative path across packages
+import { util } from '../../design-system/src/utils';
+```