chore: prepare release v2.2.4 and refactor ngOnChanges

- Bump version to 2.2.4 in package.json (root and library) and package-lock.json
- Update all documentation (README, CHANGELOG, MIGRATION, ROADMAP, SECURITY, PUBLISHING) to reflect v2.2.4
- Refactor ngOnChanges in ngxsmk-datepicker.ts to reduce cognitive complexity from 17 to under 15
- Extract focused private methods (handleChangesTimeAndMode, handleChangesDisabledStates, etc.) for better maintainability
- Update demo app versioning and translations across all supported languages
- Update docs/INSTALLATION.md with new version-specific CDN and download links

Author: toozuuu

CHANGELOG.md

@@ -2,11 +2,18 @@
 
 All notable changes to this project will be documented in this file.
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.4
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.4] - 2026-03-10
+
+### Fixed
+- **Timezone Support**: Added full support for IANA timezones in "Today" calculation. The component now correctly identifies "Today" based on the configured `timezone` input.
+- **Date Validation**: Fixed an issue where "Today" was incorrectly considered invalid if `minDate` was set to the current time. Validation now normalizes to the start of the day.
+- **Keyboard Shortcuts**: Updated "Today" selection shortcut to be timezone-aware.
+
 ## [2.2.3] - 2026-03-09
 
 ### Fixed

CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 Thank you for your interest in contributing to ngxsmk-datepicker! This document provides guidelines and instructions for contributing.
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.4
 
 ## Code of Conduct
 

DEPLOYMENT.md

@@ -2,7 +2,7 @@
 
 This document explains how the ngxsmk-datepicker demo app is deployed to GitHub Pages.
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.4
 
 ## Automatic Deployment
 

MIGRATION.md

@@ -2,10 +2,11 @@
 
 This document provides migration instructions for upgrading between major versions of ngxsmk-datepicker.
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.4
 
 ## Table of Contents
 
+- [v2.2.3 → v2.2.4](#v223---v224)
 - [v2.2.0 → v2.2.3](#v220---v223)
 - [v2.1.8 → v2.2.0](#v218---v219)
 - [v2.1.7 → v2.1.8](#v217---v218)
@@ -53,9 +54,24 @@ This document provides migration instructions for upgrading between major versio
 - [v1.9.1 → v1.9.2](#v191---v192)
 - [v1.9.0 → v1.9.1](#v190---v191)
 - [v1.8.0 → v1.9.0](#v180---v190)
-- [v1.9.0 → v2.0.0](#v190---v200) (Future)
 - [v1.7.0 → v1.8.0](#v170---v180)
 
+## v2.2.3 → v2.2.4
+
+### Changes
+
+- **Timezone Support**: Added full support for IANA timezones in "Today" calculation. The component now correctly identifies "Today" based on the configured `timezone` input rather than just browser local time.
+- **Date Validation**: Fixed an issue where "Today" could become unselectable if `minDate` was set to the current time later in the day. `minDate` validation now correctly normalizes to the start of the day.
+- **Keyboard Shortcuts**: Updated `selectToday` shortcut to use the timezone-aware `today` value.
+
+### Migration Steps
+
+No migration steps required.
+
+```bash
+npm install ngxsmk-datepicker@2.2.4
+```
+
 ## v2.2.0 → v2.2.3
 
 ### Changes
@@ -266,7 +282,7 @@ npm install ngxsmk-datepicker@2.0.8
 ### Changes
 
 - **Version Update**: Updated to version 2.0.7
-- **Stable Release**: Version 2.2.3 is the current stable version
+- **Stable Release**: Version 2.2.4 is the current stable version
 - No breaking changes.
 
 ### Migration Steps

PUBLISHING.md

@@ -2,7 +2,7 @@
 
 This document outlines the process for publishing new versions of `ngxsmk-datepicker` to npm.
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.4
 
 ## Prerequisites
 
@@ -104,8 +104,8 @@ npm run publish:beta
 ### 2. Publish production (after beta is validated)
 
 ```bash
-# Set the stable version (must match the release, e.g. 2.2.3 from 2.2.3-beta.0)
-npm run version:stable -- 2.2.3
+# Set the stable version (must match the release, e.g. 2.2.4 from 2.2.4-beta.0)
+npm run version:stable -- 2.2.4
 
 # Update CHANGELOG.md: rename [X.Y.Z-beta.N] to [X.Y.Z] or add a [X.Y.Z] section, then commit
 
@@ -118,8 +118,8 @@ npm run publish:patch
 
 ### Manual version (optional)
 
-- Set a specific beta: `node scripts/set-beta-version.js 2.2.3-beta.0`
-- Set stable: `node scripts/set-stable-version.js 2.2.3`
+- Set a specific beta: `node scripts/set-beta-version.js 2.2.4-beta.0`
+- Set stable: `node scripts/set-stable-version.js 2.2.4`
 
 ## Pre-Release Checklist
 

README.md

@@ -24,15 +24,15 @@
 
 ---
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.4
 
 ### **Overview**
 
 **ngxsmk-datepicker** is a high-performance, enterprise-ready date and range picker engineered for the modern Angular ecosystem (v17+). Built from the ground up with **Angular Signals**, it delivers a seamless, zoneless-ready experience for both desktop and mobile (Ionic) applications.
 
-> **Stable Release**: `v2.2.3` is live! This release brings a **TypeScript Strictness Overhaul** (eliminating `any` types), **Cognitive Complexity & Linting Fixes** for Material integration, and improved **Test Coverage (~68.2%)**. It also fixes **appendToBody** popover positioning, datepicker-in-modal behavior, and touch interaction regressions. No breaking changes.
+> **Stable Release**: `v2.2.4` is live! This release adds full **IANA Timezone Support** for "Today" calculation, resolves a critical bug where "Today" could become unselectable after late-day `minDate` initializations, and ensures high-performance date validation across all configurations.
 >
-> ⚠️ **Important**: Versions 2.0.10 and 2.0.11 are broken and have been unpublished. Please use v2.2.3 or later.
+> ⚠️ **Important**: Versions 2.0.10 and 2.0.11 are broken and have been unpublished. Please use v2.2.4 or later.
 
 ---
 
@@ -139,7 +139,7 @@ For details, see [CONTRIBUTING.md](https://github.com/NGXSMK/ngxsmk-datepicker/b
 ## **📦 Installation**
 
 ```bash
-npm install ngxsmk-datepicker@2.2.3
+npm install ngxsmk-datepicker@2.2.4
 ```
 
 ### Alternative installation
@@ -148,12 +148,12 @@ You can install without npm using any of these methods (peer dependencies must s
 
 | Method | Command |
 |--------|--------|
-| **Yarn** | `yarn add ngxsmk-datepicker@2.2.3` |
-| **pnpm** | `pnpm add ngxsmk-datepicker@2.2.3` |
-| **Bun** | `bun add ngxsmk-datepicker@2.2.3` |
-| **From Git** | `npm install github:NGXSMK/ngxsmk-datepicker#v2.2.3` (requires the repo to have built output or you build from source) |
+| **Yarn** | `yarn add ngxsmk-datepicker@2.2.4` |
+| **pnpm** | `pnpm add ngxsmk-datepicker@2.2.4` |
+| **Bun** | `bun add ngxsmk-datepicker@2.2.4` |
+| **From Git** | `npm install github:NGXSMK/ngxsmk-datepicker#v2.2.4` (requires the repo to have built output or you build from source) |
 | **Local path** | Build the library in the repo (`npx ng build ngxsmk-datepicker`), then `npm install /path/to/ngxsmk-datepicker/dist/ngxsmk-datepicker` |
-| **CDN (ESM)** | Use [unpkg](https://unpkg.com/ngxsmk-datepicker@2.2.3/) or [jsDelivr](https://cdn.jsdelivr.net/npm/ngxsmk-datepicker@2.2.3/) in your bundler or import map; peer dependencies (Angular, etc.) must be installed in your app. |
+| **CDN (ESM)** | Use [unpkg](https://unpkg.com/ngxsmk-datepicker@2.2.4/) or [jsDelivr](https://cdn.jsdelivr.net/npm/ngxsmk-datepicker@2.2.4/) in your bundler or import map; peer dependencies (Angular, etc.) must be installed in your app. |
 
 For all options and caveats, see [docs/INSTALLATION.md](docs/INSTALLATION.md).
 
@@ -604,7 +604,7 @@ The `locale` input controls all internationalization. It automatically formats m
 
 ### **Global Language Support**
 
-ngxsmk-datepicker v2.2.3 now features **full localization synchronization** for:
+ngxsmk-datepicker v2.2.4 now features **full localization synchronization** for:
 
 - �� English (`en`)
 - �� German (`de`)
@@ -697,8 +697,12 @@ This library has been optimized for maximum performance:
 
 ## **🐛 Bug Fixes & Improvements**
 
-### **Critical Bug Fixes in v1.4.15:**
+### **Critical Updates in v2.2.4:**
 
+- ✅ **Timezone Support**: Added full support for IANA timezones in "Today" calculation.
+- ✅ **Date Validation**: Fixed "Today" unselectable bug by normalizing `minDate` boundary checks.
+- ✅ **Keyboard Shortcuts**: Updated "Today" selection shortcut to use timezone-aware calculation.
+- ✅ **Validation messages**: User-facing i18n strings for invalid date, min/max; `validationError` output and on-screen error display
 - ✅ **Change Detection**: Fixed OnPush change detection issues with proper `markForCheck()` triggers
 - ✅ **Date Comparison**: Fixed null safety issues in date range comparisons
 - ✅ **Memory Leaks**: Added cache size limits to prevent memory leaks
@@ -860,7 +864,7 @@ We welcome and appreciate contributions from the community! Whether it's reporti
 
 ## **📄 Changelog**
 
-**Recent:** v2.2.3 — TypeScript strictness overhaul, appendToBody/popover fixes, loading and CSS cleanup. Versions 2.0.10 and 2.0.11 are unpublished; use v2.2.3 or later.
+**Recent:** v2.2.4 — TypeScript strictness overhaul, appendToBody/popover fixes, loading and CSS cleanup. Versions 2.0.10 and 2.0.11 are unpublished; use v2.2.4 or later.
 
 For the full list of changes, see [CHANGELOG.md](https://github.com/NGXSMK/ngxsmk-datepicker/blob/main/CHANGELOG.md).
 

ROADMAP.md

@@ -2,7 +2,7 @@
 
 This roadmap outlines the planned features, improvements, and enhancements for ngxsmk-datepicker. We welcome community input and contributions!
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.4
 
 ## 🎯 Current Focus (Q1 2026 - Q2 2026)
 

SECURITY.md

@@ -1,6 +1,6 @@
 # Security Policy
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.4
 
 ## Supported Versions
 

docs/ACCESSIBILITY_TESTING.md

@@ -1,6 +1,6 @@
 # Accessibility Testing
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.4
 
 This document outlines the accessibility testing infrastructure integrated into the ngxsmk-datepicker library.
 

docs/API_REFERENCE.md

@@ -2,8 +2,8 @@
 
 Complete API reference for ngxsmk-datepicker with JSDoc examples for improved IDE IntelliSense.
 
-**Version**: 2.2.3+  
-**Last Updated**: March 9, 2026
+**Version**: 2.2.4+  
+**Last Updated**: March 10, 2026
 
 ---