feat!: v2 — compound components, RTL, dark mode, a11y, responsive, i18n, loading states, slot creation, and breaking refactors

.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI Pipeline
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  build_and_test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check code formatting
+        run: npm run format:check
+
+      - name: Run ESLint
+        run: npm run lint
+
+      - name: Verify build
+        run: npm run build
+
+      - name: Run tests
+        run: npm test

.gitignore

@@ -26,4 +26,7 @@ yarn-error.log*
 
 docs
 
-storybook-static
+storybook-static
+
+# Claude Code
+.claude/settings.local.json

.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit ${1}

.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

.prettierignore

@@ -0,0 +1,15 @@
+# Ignore Artifacts
+node_modules
+dist
+storybook-static
+coverage
+.cache
+
+# Misc
+.env
+.npmrc
+eslint.config.js
+package-lock.json
+
+# Ignore generated documentation
+docs/

.prettierrc

@@ -0,0 +1,12 @@
+{
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "jsxBracketSameLine": false,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

.storybook/preview.ts

@@ -1,21 +1,21 @@
-import type { Preview } from '@storybook/react-vite'
+import type { Preview } from "@storybook/react-vite";
 
 const preview: Preview = {
   parameters: {
     controls: {
       matchers: {
-       color: /(background|color)$/i,
-       date: /Date$/i,
+        color: /(background|color)$/i,
+        date: /Date$/i,
       },
     },
 
     a11y: {
       // 'todo' - show a11y violations in the test UI only
       // 'error' - fail CI on a11y violations
       // 'off' - skip a11y checks entirely
-      test: 'todo'
-    }
+      test: "todo",
+    },
   },
 };
 
-export default preview;
+export default preview;

CHANGELOG.md

@@ -1,87 +1,79 @@
 # [1.2.0](https://github.com/Jaganath-MSJ/CalendarSimple/compare/v1.1.1...v1.2.0) (2026-02-17)
 
-
 ### Bug Fixes
 
-* add explicit type annotations to map callbacks ([fea1b24](https://github.com/Jaganath-MSJ/CalendarSimple/commit/fea1b24babb9ebf8767dd34f2a4658b77d3a54c9))
-* centralize calendar constants for consistency ([a7c8e02](https://github.com/Jaganath-MSJ/CalendarSimple/commit/a7c8e02406d20c78893fcf5d5cd456e95092b530))
-* **popover:** change positioning to fixed and anchor to button ([03a8413](https://github.com/Jaganath-MSJ/CalendarSimple/commit/03a841355022cc27100971ce96c34cd45f2c5369))
-* remove maxEvents from interface and make it dynamic ([b0d5495](https://github.com/Jaganath-MSJ/CalendarSimple/commit/b0d5495096316331a5f0f376ec4759dfb70a1351))
-
+- add explicit type annotations to map callbacks ([fea1b24](https://github.com/Jaganath-MSJ/CalendarSimple/commit/fea1b24babb9ebf8767dd34f2a4658b77d3a54c9))
+- centralize calendar constants for consistency ([a7c8e02](https://github.com/Jaganath-MSJ/CalendarSimple/commit/a7c8e02406d20c78893fcf5d5cd456e95092b530))
+- **popover:** change positioning to fixed and anchor to button ([03a8413](https://github.com/Jaganath-MSJ/CalendarSimple/commit/03a841355022cc27100971ce96c34cd45f2c5369))
+- remove maxEvents from interface and make it dynamic ([b0d5495](https://github.com/Jaganath-MSJ/CalendarSimple/commit/b0d5495096316331a5f0f376ec4759dfb70a1351))
 
 ### Features
 
-* add Storybook setup for component documentation and testing ([2ab6e12](https://github.com/Jaganath-MSJ/CalendarSimple/commit/2ab6e127005371f99c80212f96ec3053a07dcc36))
-* improve popover positioning and scrolling ([61ff399](https://github.com/Jaganath-MSJ/CalendarSimple/commit/61ff399a86cd3f810e47cd10c103ca8ac8ece5cd))
+- add Storybook setup for component documentation and testing ([2ab6e12](https://github.com/Jaganath-MSJ/CalendarSimple/commit/2ab6e127005371f99c80212f96ec3053a07dcc36))
+- improve popover positioning and scrolling ([61ff399](https://github.com/Jaganath-MSJ/CalendarSimple/commit/61ff399a86cd3f810e47cd10c103ca8ac8ece5cd))
 
 ## [1.1.1](https://github.com/Jaganath-MSJ/CalendarSimple/compare/v1.1.0...v1.1.1) (2026-02-11)
 
-
 ### Bug Fixes
 
-* fix date selection logic and dependency arrays ([78aa7e7](https://github.com/Jaganath-MSJ/CalendarSimple/commit/78aa7e789d7122d628c409a640a896641411d4de))
+- fix date selection logic and dependency arrays ([78aa7e7](https://github.com/Jaganath-MSJ/CalendarSimple/commit/78aa7e789d7122d628c409a640a896641411d4de))
 
 ## [1.1.1-beta.1](https://github.com/Jaganath-MSJ/CalendarSimple/compare/v1.1.0...v1.1.1-beta.1) (2026-02-11)
 
-
 ### Bug Fixes
 
-* fix date selection logic and dependency arrays ([78aa7e7](https://github.com/Jaganath-MSJ/CalendarSimple/commit/78aa7e789d7122d628c409a640a896641411d4de))
+- fix date selection logic and dependency arrays ([78aa7e7](https://github.com/Jaganath-MSJ/CalendarSimple/commit/78aa7e789d7122d628c409a640a896641411d4de))
 
 # [1.1.0](https://github.com/Jaganath-MSJ/CalendarSimple/compare/v1.0.2...v1.1.0) (2026-02-10)
 
-
 ### Bug Fixes
 
-* **calendar:** correct event width calculation and styling for multi-day events ([e38f00a](https://github.com/Jaganath-MSJ/CalendarSimple/commit/e38f00a2700be8711e11a6e69847a0f7b76dfb7f))
-* ensure consistent date comparison by using start of day ([5bab11b](https://github.com/Jaganath-MSJ/CalendarSimple/commit/5bab11b078e25bb422f91d328a35f8bd3b1adc97))
-* extract header into separate component ([d32e99f](https://github.com/Jaganath-MSJ/CalendarSimple/commit/d32e99f6321e1da85f29b8cdae16b84609f0c281))
-* remove the registry-url in the setup node.js step ([05ecf99](https://github.com/Jaganath-MSJ/CalendarSimple/commit/05ecf99e3fd734260f26f29a40eaefd74d58cf2a))
-* update repository url for semantic-release ([bbf5d9a](https://github.com/Jaganath-MSJ/CalendarSimple/commit/bbf5d9ab50e4bff6030f185d98da1cbe938d1274))
-* updating the package-lock file ([55e0c18](https://github.com/Jaganath-MSJ/CalendarSimple/commit/55e0c18bd0acec23ca214110d843378723207d6d))
-
+- **calendar:** correct event width calculation and styling for multi-day events ([e38f00a](https://github.com/Jaganath-MSJ/CalendarSimple/commit/e38f00a2700be8711e11a6e69847a0f7b76dfb7f))
+- ensure consistent date comparison by using start of day ([5bab11b](https://github.com/Jaganath-MSJ/CalendarSimple/commit/5bab11b078e25bb422f91d328a35f8bd3b1adc97))
+- extract header into separate component ([d32e99f](https://github.com/Jaganath-MSJ/CalendarSimple/commit/d32e99f6321e1da85f29b8cdae16b84609f0c281))
+- remove the registry-url in the setup node.js step ([05ecf99](https://github.com/Jaganath-MSJ/CalendarSimple/commit/05ecf99e3fd734260f26f29a40eaefd74d58cf2a))
+- update repository url for semantic-release ([bbf5d9a](https://github.com/Jaganath-MSJ/CalendarSimple/commit/bbf5d9ab50e4bff6030f185d98da1cbe938d1274))
+- updating the package-lock file ([55e0c18](https://github.com/Jaganath-MSJ/CalendarSimple/commit/55e0c18bd0acec23ca214110d843378723207d6d))
 
 ### Features
 
-* add maxEvents prop to limit displayed events per day ([864ba96](https://github.com/Jaganath-MSJ/CalendarSimple/commit/864ba9652accc49d207b5fa6125607e6746d2dab))
-* add onEventClick and onMoreClick callbacks ([90b4d82](https://github.com/Jaganath-MSJ/CalendarSimple/commit/90b4d82fff13b7c7a0fd2e7702033e1bc041f323))
-* add optional color property to calendar events ([de976db](https://github.com/Jaganath-MSJ/CalendarSimple/commit/de976db618a75004a0cdc2747bdd31d7112ee18f))
-* add spacer handling and improve event limit logic ([9160689](https://github.com/Jaganath-MSJ/CalendarSimple/commit/9160689a6d662173e6209bb5fbd247b14c02cf9b))
-* add theme support for calendar date styling ([38a199b](https://github.com/Jaganath-MSJ/CalendarSimple/commit/38a199ba9fd2e73d670fe95819572831e77c3214))
-* calculate maxEvents dynamically based on calendar height ([ae3e7ad](https://github.com/Jaganath-MSJ/CalendarSimple/commit/ae3e7ade0a0cf6186c8299f9d98564ef7b0ad178))
-* **calendar:** implement week-based event layout with proper spacing ([550fa51](https://github.com/Jaganath-MSJ/CalendarSimple/commit/550fa51405109e6d5d9adb1dbc164833805cc488))
-* **calendar:** improve event rendering across week boundaries ([93dac33](https://github.com/Jaganath-MSJ/CalendarSimple/commit/93dac33e833c52b9fb4145452f090d82deb6f8d1))
-* **calendar:** support date range events with visual rendering ([437c197](https://github.com/Jaganath-MSJ/CalendarSimple/commit/437c197c746de5edf04836db029ee3149772e3eb))
-* enable event item click to select specific date ([cfb43cc](https://github.com/Jaganath-MSJ/CalendarSimple/commit/cfb43ccaf93276e1d28ef9c82a89e8a508b177ce))
-* **EventPopover:** add popover for hidden events ([117197f](https://github.com/Jaganath-MSJ/CalendarSimple/commit/117197faf0c599468bbc4d508aa5b1b4ef8c99bf))
-* **EventPopover:** correct popover event styling and date color logic ([6fc5662](https://github.com/Jaganath-MSJ/CalendarSimple/commit/6fc56622320af4d8ed9577d318e7f58b8e2c9efa))
-* make calendar responsive using resize observer ([a01af33](https://github.com/Jaganath-MSJ/CalendarSimple/commit/a01af33dea77261e15d452e4ec00aff6063975b9))
+- add maxEvents prop to limit displayed events per day ([864ba96](https://github.com/Jaganath-MSJ/CalendarSimple/commit/864ba9652accc49d207b5fa6125607e6746d2dab))
+- add onEventClick and onMoreClick callbacks ([90b4d82](https://github.com/Jaganath-MSJ/CalendarSimple/commit/90b4d82fff13b7c7a0fd2e7702033e1bc041f323))
+- add optional color property to calendar events ([de976db](https://github.com/Jaganath-MSJ/CalendarSimple/commit/de976db618a75004a0cdc2747bdd31d7112ee18f))
+- add spacer handling and improve event limit logic ([9160689](https://github.com/Jaganath-MSJ/CalendarSimple/commit/9160689a6d662173e6209bb5fbd247b14c02cf9b))
+- add theme support for calendar date styling ([38a199b](https://github.com/Jaganath-MSJ/CalendarSimple/commit/38a199ba9fd2e73d670fe95819572831e77c3214))
+- calculate maxEvents dynamically based on calendar height ([ae3e7ad](https://github.com/Jaganath-MSJ/CalendarSimple/commit/ae3e7ade0a0cf6186c8299f9d98564ef7b0ad178))
+- **calendar:** implement week-based event layout with proper spacing ([550fa51](https://github.com/Jaganath-MSJ/CalendarSimple/commit/550fa51405109e6d5d9adb1dbc164833805cc488))
+- **calendar:** improve event rendering across week boundaries ([93dac33](https://github.com/Jaganath-MSJ/CalendarSimple/commit/93dac33e833c52b9fb4145452f090d82deb6f8d1))
+- **calendar:** support date range events with visual rendering ([437c197](https://github.com/Jaganath-MSJ/CalendarSimple/commit/437c197c746de5edf04836db029ee3149772e3eb))
+- enable event item click to select specific date ([cfb43cc](https://github.com/Jaganath-MSJ/CalendarSimple/commit/cfb43ccaf93276e1d28ef9c82a89e8a508b177ce))
+- **EventPopover:** add popover for hidden events ([117197f](https://github.com/Jaganath-MSJ/CalendarSimple/commit/117197faf0c599468bbc4d508aa5b1b4ef8c99bf))
+- **EventPopover:** correct popover event styling and date color logic ([6fc5662](https://github.com/Jaganath-MSJ/CalendarSimple/commit/6fc56622320af4d8ed9577d318e7f58b8e2c9efa))
+- make calendar responsive using resize observer ([a01af33](https://github.com/Jaganath-MSJ/CalendarSimple/commit/a01af33dea77261e15d452e4ec00aff6063975b9))
 
 # [1.1.0-beta.1](https://github.com/Jaganath-MSJ/CalendarSimple/compare/v1.0.2...v1.1.0-beta.1) (2026-02-10)
 
-
 ### Bug Fixes
 
-* **calendar:** correct event width calculation and styling for multi-day events ([e38f00a](https://github.com/Jaganath-MSJ/CalendarSimple/commit/e38f00a2700be8711e11a6e69847a0f7b76dfb7f))
-* ensure consistent date comparison by using start of day ([5bab11b](https://github.com/Jaganath-MSJ/CalendarSimple/commit/5bab11b078e25bb422f91d328a35f8bd3b1adc97))
-* extract header into separate component ([d32e99f](https://github.com/Jaganath-MSJ/CalendarSimple/commit/d32e99f6321e1da85f29b8cdae16b84609f0c281))
-* remove the registry-url in the setup node.js step ([05ecf99](https://github.com/Jaganath-MSJ/CalendarSimple/commit/05ecf99e3fd734260f26f29a40eaefd74d58cf2a))
-* update repository url for semantic-release ([bbf5d9a](https://github.com/Jaganath-MSJ/CalendarSimple/commit/bbf5d9ab50e4bff6030f185d98da1cbe938d1274))
-* updating the package-lock file ([55e0c18](https://github.com/Jaganath-MSJ/CalendarSimple/commit/55e0c18bd0acec23ca214110d843378723207d6d))
-
+- **calendar:** correct event width calculation and styling for multi-day events ([e38f00a](https://github.com/Jaganath-MSJ/CalendarSimple/commit/e38f00a2700be8711e11a6e69847a0f7b76dfb7f))
+- ensure consistent date comparison by using start of day ([5bab11b](https://github.com/Jaganath-MSJ/CalendarSimple/commit/5bab11b078e25bb422f91d328a35f8bd3b1adc97))
+- extract header into separate component ([d32e99f](https://github.com/Jaganath-MSJ/CalendarSimple/commit/d32e99f6321e1da85f29b8cdae16b84609f0c281))
+- remove the registry-url in the setup node.js step ([05ecf99](https://github.com/Jaganath-MSJ/CalendarSimple/commit/05ecf99e3fd734260f26f29a40eaefd74d58cf2a))
+- update repository url for semantic-release ([bbf5d9a](https://github.com/Jaganath-MSJ/CalendarSimple/commit/bbf5d9ab50e4bff6030f185d98da1cbe938d1274))
+- updating the package-lock file ([55e0c18](https://github.com/Jaganath-MSJ/CalendarSimple/commit/55e0c18bd0acec23ca214110d843378723207d6d))
 
 ### Features
 
-* add maxEvents prop to limit displayed events per day ([864ba96](https://github.com/Jaganath-MSJ/CalendarSimple/commit/864ba9652accc49d207b5fa6125607e6746d2dab))
-* add onEventClick and onMoreClick callbacks ([90b4d82](https://github.com/Jaganath-MSJ/CalendarSimple/commit/90b4d82fff13b7c7a0fd2e7702033e1bc041f323))
-* add optional color property to calendar events ([de976db](https://github.com/Jaganath-MSJ/CalendarSimple/commit/de976db618a75004a0cdc2747bdd31d7112ee18f))
-* add spacer handling and improve event limit logic ([9160689](https://github.com/Jaganath-MSJ/CalendarSimple/commit/9160689a6d662173e6209bb5fbd247b14c02cf9b))
-* add theme support for calendar date styling ([38a199b](https://github.com/Jaganath-MSJ/CalendarSimple/commit/38a199ba9fd2e73d670fe95819572831e77c3214))
-* calculate maxEvents dynamically based on calendar height ([ae3e7ad](https://github.com/Jaganath-MSJ/CalendarSimple/commit/ae3e7ade0a0cf6186c8299f9d98564ef7b0ad178))
-* **calendar:** implement week-based event layout with proper spacing ([550fa51](https://github.com/Jaganath-MSJ/CalendarSimple/commit/550fa51405109e6d5d9adb1dbc164833805cc488))
-* **calendar:** improve event rendering across week boundaries ([93dac33](https://github.com/Jaganath-MSJ/CalendarSimple/commit/93dac33e833c52b9fb4145452f090d82deb6f8d1))
-* **calendar:** support date range events with visual rendering ([437c197](https://github.com/Jaganath-MSJ/CalendarSimple/commit/437c197c746de5edf04836db029ee3149772e3eb))
-* enable event item click to select specific date ([cfb43cc](https://github.com/Jaganath-MSJ/CalendarSimple/commit/cfb43ccaf93276e1d28ef9c82a89e8a508b177ce))
-* **EventPopover:** add popover for hidden events ([117197f](https://github.com/Jaganath-MSJ/CalendarSimple/commit/117197faf0c599468bbc4d508aa5b1b4ef8c99bf))
-* **EventPopover:** correct popover event styling and date color logic ([6fc5662](https://github.com/Jaganath-MSJ/CalendarSimple/commit/6fc56622320af4d8ed9577d318e7f58b8e2c9efa))
-* make calendar responsive using resize observer ([a01af33](https://github.com/Jaganath-MSJ/CalendarSimple/commit/a01af33dea77261e15d452e4ec00aff6063975b9))
+- add maxEvents prop to limit displayed events per day ([864ba96](https://github.com/Jaganath-MSJ/CalendarSimple/commit/864ba9652accc49d207b5fa6125607e6746d2dab))
+- add onEventClick and onMoreClick callbacks ([90b4d82](https://github.com/Jaganath-MSJ/CalendarSimple/commit/90b4d82fff13b7c7a0fd2e7702033e1bc041f323))
+- add optional color property to calendar events ([de976db](https://github.com/Jaganath-MSJ/CalendarSimple/commit/de976db618a75004a0cdc2747bdd31d7112ee18f))
+- add spacer handling and improve event limit logic ([9160689](https://github.com/Jaganath-MSJ/CalendarSimple/commit/9160689a6d662173e6209bb5fbd247b14c02cf9b))
+- add theme support for calendar date styling ([38a199b](https://github.com/Jaganath-MSJ/CalendarSimple/commit/38a199ba9fd2e73d670fe95819572831e77c3214))
+- calculate maxEvents dynamically based on calendar height ([ae3e7ad](https://github.com/Jaganath-MSJ/CalendarSimple/commit/ae3e7ade0a0cf6186c8299f9d98564ef7b0ad178))
+- **calendar:** implement week-based event layout with proper spacing ([550fa51](https://github.com/Jaganath-MSJ/CalendarSimple/commit/550fa51405109e6d5d9adb1dbc164833805cc488))
+- **calendar:** improve event rendering across week boundaries ([93dac33](https://github.com/Jaganath-MSJ/CalendarSimple/commit/93dac33e833c52b9fb4145452f090d82deb6f8d1))
+- **calendar:** support date range events with visual rendering ([437c197](https://github.com/Jaganath-MSJ/CalendarSimple/commit/437c197c746de5edf04836db029ee3149772e3eb))
+- enable event item click to select specific date ([cfb43cc](https://github.com/Jaganath-MSJ/CalendarSimple/commit/cfb43ccaf93276e1d28ef9c82a89e8a508b177ce))
+- **EventPopover:** add popover for hidden events ([117197f](https://github.com/Jaganath-MSJ/CalendarSimple/commit/117197faf0c599468bbc4d508aa5b1b4ef8c99bf))
+- **EventPopover:** correct popover event styling and date color logic ([6fc5662](https://github.com/Jaganath-MSJ/CalendarSimple/commit/6fc56622320af4d8ed9577d318e7f58b8e2c9efa))
+- make calendar responsive using resize observer ([a01af33](https://github.com/Jaganath-MSJ/CalendarSimple/commit/a01af33dea77261e15d452e4ec00aff6063975b9))