ngxsmk-datepicker 2.2.3 → 2.2.6

package/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.6
 
 ### **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.6` 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.6 or later.
 
 ---
 
@@ -590,7 +590,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.6 now features **full localization synchronization** for:
 
 - 🇺🇸 English (`en`)
 - 🇩🇪 German (`de`)
@@ -683,8 +683,11 @@ This library has been optimized for maximum performance:
 
 ## **🐛 Bug Fixes & Improvements**
 
-### **Critical Updates in v2.2.3:**
+### **Critical Updates in v2.2.6:**
 
+- ✅ **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
 - ✅ **Calendar loading state**: Visual spinner + text and screen-reader announcement while calendar opens/generates
 - ✅ **Demo theme**: Light/dark theme toggle and system preference now correctly switch the demo UI
@@ -846,16 +849,16 @@ We welcome and appreciate contributions from the community! Whether it's reporti
 
 For a full list of changes, please refer to the [CHANGELOG.md](https://github.com/NGXSMK/ngxsmk-datepicker/blob/main/CHANGELOG.md) file.
 
-### **v2.2.3** (Current Stable)
+### **v2.2.6** (Current Stable)
 
-- 🎉 **Version Update**: Updated to version 2.2.3.
+- 🎉 **Version Update**: Updated to version 2.2.6.
 - ✨ **Key Updates**: Optimized loading times, refined mobile header layout, and improved dropdown accessibility.
 - ✅ **Stable Release**: Full synchronization of header components with `ViewEncapsulation.None`.
 
 ### **v1.9.24**
 
 - 🎉 **Version Update**: Updated to version 1.9.24
-- ✅ **Stable Release**: Version 2.2.3 is the current stable version
+- ✅ **Stable Release**: Version 2.2.6 is the current stable version
 
 ### **v1.9.23**
 
@@ -1311,3 +1314,4 @@ If you find this library helpful, please consider:
 - 💡 **Suggesting** new features
 - 🤝 **Contributing** code improvements
 - 📢 **Sharing** with the community
+

package/docs/API.md

@@ -2,7 +2,7 @@
 
 This document describes the stable public API of ngxsmk-datepicker with comprehensive real-world examples. APIs marked as **stable** are guaranteed to remain backward-compatible within the same major version. APIs marked as **experimental** may change in future releases.
 
-**Version**: 2.2.3+ | **Last updated**: March 9, 2026
+**Version**: 2.2.6+ | **Last updated**: March 10, 2026
 
 ## Stable vs experimental
 
@@ -2403,3 +2403,4 @@ For questions about the API:
 - Check the [README.md](../../README.md) for usage examples
 - Review the [documentation](./) for detailed guides
 - Open an issue on GitHub for questions
+

package/docs/COMPATIBILITY.md

@@ -1,6 +1,6 @@
 # Version Compatibility Matrix
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 This document provides comprehensive compatibility information for `ngxsmk-datepicker` across different Angular versions, Zone.js configurations, and SSR/CSR setups.
 
@@ -440,3 +440,4 @@ npm list @angular/core @angular/common @angular/forms
 ### Issue: Translations not working in SSR
 **Solution**: Translations work in SSR. Ensure locale is explicitly set if auto-detection fails on server.
 
+

package/docs/INTEGRATION.md

@@ -1,6 +1,6 @@
 # Integration Guides
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 This document provides integration examples for using ngxsmk-datepicker with popular frameworks and libraries.
 
@@ -699,3 +699,4 @@ See the demo app **Integrations** page for a full "Datepicker in a modal" exampl
 - [Theme Guide](./THEME-TOKENS.md)
 - [Locale Guide](./LOCALE-GUIDE.md)
 
+

package/docs/IONIC_INTEGRATION.md

@@ -1,6 +1,6 @@
 # Ionic Framework Integration Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 This guide provides step-by-step instructions for integrating ngxsmk-datepicker with Ionic Angular applications.
 
@@ -224,3 +224,4 @@ export class DatepickerPage {
 - [Ionic Theming](https://ionicframework.com/docs/theming/basics)
 - [Capacitor Keyboard Plugin](https://capacitorjs.com/docs/apis/keyboard)
 
+

package/docs/IONIC_TESTING.md

@@ -1,6 +1,6 @@
 # Ionic Integration Testing Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 This document provides comprehensive testing instructions for verifying ngxsmk-datepicker compatibility with Ionic Framework.
 
@@ -144,3 +144,4 @@ jobs:
 3. **Test in your Ionic app** with real use cases
 4. **Report issues** with detailed information
 
+

package/docs/LOCALE-GUIDE.md

@@ -1,6 +1,6 @@
 # Locale Packs & i18n Contributor Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 Guide for adding locale support and contributing translations to ngxsmk-datepicker.
 
@@ -296,3 +296,4 @@ If you encounter issues with a specific locale or want to contribute improvement
 
 **Thank you for contributing to ngxsmk-datepicker's internationalization!**
 
+

package/docs/PLUGIN-ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Plugin Architecture
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 ngxsmk-datepicker features a powerful **plugin architecture** that allows you to extend and customize the component's behavior without modifying its core code. This architecture is built on a **hook-based system** that provides extension points throughout the component's lifecycle.
 
@@ -926,3 +926,4 @@ The plugin architecture in ngxsmk-datepicker provides:
 
 For more examples and detailed hook documentation, see [Extension Points Guide](./extension-points.md).
 
+

package/docs/SEO.md

@@ -1,6 +1,6 @@
 # SEO Optimization Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 This document outlines the SEO optimizations implemented for ngxsmk-datepicker to improve search engine visibility and discoverability.
 
@@ -210,3 +210,4 @@ ngxsmk-datepicker has been optimized for search engines with comprehensive meta
 - [Twitter Cards](https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/abouts-cards)
 - [Web.dev SEO Guide](https://web.dev/learn/seo/)
 
+

package/docs/SSR-EXAMPLE.md

@@ -1,6 +1,6 @@
 # Server-Side Rendering (SSR) Example
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 Complete example demonstrating ngxsmk-datepicker with Angular Universal (SSR).
 
@@ -423,3 +423,4 @@ test('datepicker works after SSR hydration', async ({ page }) => {
 - [SSR Best Practices](https://angular.io/guide/universal#best-practices)
 - [Platform Detection](https://angular.io/api/common/isPlatformBrowser)
 
+

package/docs/THEME-TOKENS.md

@@ -1,6 +1,6 @@
 # Theme Tokens & CSS Custom Properties
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 Complete reference for all CSS custom properties (CSS variables) available in ngxsmk-datepicker.
 
@@ -320,3 +320,4 @@ CSS custom properties are supported in all modern browsers:
 
 For older browsers, consider using a CSS custom properties polyfill or provide fallback values.
 
+

package/docs/TIMEZONE.md

@@ -1,6 +1,6 @@
 # Timezone Support
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 ## Overview
 
@@ -291,3 +291,4 @@ if (isValidTimezone('America/New_York')) {
 - For advanced operations, consider date-fns-tz or Luxon
 - Always send UTC timestamps to servers/APIs
 
+

package/docs/extension-points.md

@@ -1,6 +1,6 @@
 # Extension Points and Hooks
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 ngxsmk-datepicker provides comprehensive extension points through the `hooks` input, allowing you to customize rendering, validation, keyboard shortcuts, formatting, and event handling.
 
@@ -415,3 +415,4 @@ import {
 } from 'ngxsmk-datepicker';
 ```
 
+

package/docs/signal-forms.md

@@ -1,6 +1,6 @@
 # Signal Forms Integration
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 This guide covers using ngxsmk-datepicker with Angular 21+ Signal Forms API.
 
@@ -596,3 +596,4 @@ If `form().dirty()` returns `false` after selecting a date:
 
 4. **Check dev console warnings**: In development mode, the datepicker logs warnings if it falls back to direct signal mutation, which may not track dirty state correctly.
 
+

package/docs/signals.md

@@ -1,6 +1,6 @@
 # Signals Integration Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 ngxsmk-datepicker is fully compatible with Angular Signals, providing seamless integration with both traditional reactive forms and modern signal-based patterns.
 
@@ -262,3 +262,4 @@ dateSignal = signal<DatepickerValue>(null);
 
 The datepicker supports both patterns simultaneously, so you can migrate gradually.
 
+

package/docs/ssr.md

@@ -1,6 +1,6 @@
 # Server-Side Rendering (SSR) Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 10, 2026 · **Current stable:** v2.2.6
 
 ngxsmk-datepicker is fully compatible with Angular Universal and server-side rendering. This guide covers SSR setup, best practices, and troubleshooting.
 
@@ -301,3 +301,4 @@ export class SSRExampleComponent {
 - [Angular SSR Documentation](https://angular.dev/guide/ssr)
 - [Platform Detection](https://angular.dev/api/common/isPlatformBrowser)
 
+

package/package.json

@@ -1,86 +1,86 @@
-{
-  "name": "ngxsmk-datepicker",
-  "version": "2.2.3",
-  "author": {
-    "name": "Sachin Dilshan",
-    "url": "https://www.linkedin.com/in/sachindilshan/"
-  },
-  "peerDependencies": {
-    "@angular/common": ">=17.0.0 <24.0.0",
-    "@angular/core": ">=17.0.0 <24.0.0",
-    "@angular/forms": ">=17.0.0 <24.0.0",
-    "luxon": "^3.0.0"
-  },
-  "peerDependenciesMeta": {
-    "zone.js": {
-      "optional": true
-    },
-    "@angular/material": {
-      "optional": true
-    },
-    "@angular/cdk": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "tslib": "^2.3.0"
-  },
-  "main": "fesm2022/ngxsmk-datepicker.mjs",
-  "module": "fesm2022/ngxsmk-datepicker.mjs",
-  "es2022": "fesm2022/ngxsmk-datepicker.mjs",
-  "types": "types/ngxsmk-datepicker.d.ts",
-  "typings": "types/ngxsmk-datepicker.d.ts",
-  "homepage": "https://github.com/NGXSMK/ngxsmk-datepicker#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/NGXSMK/ngxsmk-datepicker.git"
-  },
-  "bugs": {
-    "url": "https://github.com/NGXSMK/ngxsmk-datepicker/issues"
-  },
-  "sideEffects": false,
-  "files": [
-    "fesm2022/**/*.mjs",
-    "**/*.d.ts",
-    "**/*.metadata.json",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md",
-    "MIGRATION.md",
-    "docs/*.md",
-    "!docs/**/*.png",
-    "!docs/**/*.jpg",
-    "!docs/**/*.gif",
-    "styles/**/*.css"
-  ],
-  "keywords": [
-    "angular",
-    "datepicker",
-    "date-range-picker",
-    "calendar",
-    "standalone-component",
-    "angular-17",
-    "angular-18",
-    "angular-19",
-    "angular-20",
-    "angular-21",
-    "typescript",
-    "date-selection",
-    "i18n",
-    "localization"
-  ],
-  "optimization": {
-    "treeShaking": true,
-    "sideEffects": false,
-    "usedExports": true
-  },
-  "engines": {
-    "node": ">=20.19.0 || >=22.12.0",
-    "npm": ">=10.0.0"
-  },
-  "exports": {
-    "./styles/*": {
-      "default": "./styles/*"
-    }
-  }
+{
+  "name": "ngxsmk-datepicker",
+  "version": "2.2.6",
+  "author": {
+    "name": "Sachin Dilshan",
+    "url": "https://www.linkedin.com/in/sachindilshan/"
+  },
+  "peerDependencies": {
+    "@angular/common": ">=17.0.0 <24.0.0",
+    "@angular/core": ">=17.0.0 <24.0.0",
+    "@angular/forms": ">=17.0.0 <24.0.0",
+    "luxon": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zone.js": {
+      "optional": true
+    },
+    "@angular/material": {
+      "optional": true
+    },
+    "@angular/cdk": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "main": "fesm2022/ngxsmk-datepicker.mjs",
+  "module": "fesm2022/ngxsmk-datepicker.mjs",
+  "es2022": "fesm2022/ngxsmk-datepicker.mjs",
+  "types": "types/ngxsmk-datepicker.d.ts",
+  "typings": "types/ngxsmk-datepicker.d.ts",
+  "homepage": "https://github.com/NGXSMK/ngxsmk-datepicker#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NGXSMK/ngxsmk-datepicker.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NGXSMK/ngxsmk-datepicker/issues"
+  },
+  "sideEffects": false,
+  "files": [
+    "fesm2022/**/*.mjs",
+    "**/*.d.ts",
+    "**/*.metadata.json",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "MIGRATION.md",
+    "docs/*.md",
+    "!docs/**/*.png",
+    "!docs/**/*.jpg",
+    "!docs/**/*.gif",
+    "styles/**/*.css"
+  ],
+  "keywords": [
+    "angular",
+    "datepicker",
+    "date-range-picker",
+    "calendar",
+    "standalone-component",
+    "angular-17",
+    "angular-18",
+    "angular-19",
+    "angular-20",
+    "angular-21",
+    "typescript",
+    "date-selection",
+    "i18n",
+    "localization"
+  ],
+  "optimization": {
+    "treeShaking": true,
+    "sideEffects": false,
+    "usedExports": true
+  },
+  "engines": {
+    "node": ">=20.19.0 || >=22.12.0",
+    "npm": ">=10.0.0"
+  },
+  "exports": {
+    "./styles/*": {
+      "default": "./styles/*"
+    }
+  }
 }