ngxsmk-datepicker 2.2.13 → 2.3.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (21) hide show
  1. package/CHANGELOG.md +1240 -1218
  2. package/MIGRATION.md +1775 -1775
  3. package/README.md +939 -923
  4. package/docs/API.md +1 -1
  5. package/docs/COMPATIBILITY.md +14 -1
  6. package/docs/INTEGRATION.md +1 -1
  7. package/docs/IONIC_INTEGRATION.md +1 -1
  8. package/docs/IONIC_TESTING.md +1 -1
  9. package/docs/LOCALE-GUIDE.md +1 -1
  10. package/docs/PLUGIN-ARCHITECTURE.md +1 -1
  11. package/docs/SEO.md +1 -1
  12. package/docs/SSR-EXAMPLE.md +1 -1
  13. package/docs/THEME-TOKENS.md +1 -1
  14. package/docs/TIMEZONE.md +1 -1
  15. package/docs/extension-points.md +1 -1
  16. package/docs/signal-forms.md +1 -1
  17. package/docs/signals.md +1 -1
  18. package/docs/ssr.md +1 -1
  19. package/fesm2022/ngxsmk-datepicker.mjs +635 -135
  20. package/package.json +12 -2
  21. package/types/ngxsmk-datepicker.d.ts +62 -6
package/docs/API.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  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.
4
4
 
5
- **Version**: 2.2.13+ | **Last updated**: March 21, 2026
5
+ **Version**: 2.2.15+ | **Last updated**: March 21, 2026
6
6
 
7
7
  ## Stable vs experimental
8
8
 
package/docs/COMPATIBILITY.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Version Compatibility Matrix
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  This document provides comprehensive compatibility information for `ngxsmk-datepicker` across different Angular versions, Zone.js configurations, and SSR/CSR setups.
6
6
 
@@ -250,6 +250,18 @@ export class MyComponent {
250
250
  }
251
251
  ```
252
252
 
253
+ ## 🧩 Shadow DOM & Web Components Compatibility
254
+
255
+ `ngxsmk-datepicker` is fully compatible with **Shadow DOM encapsulation** (`ViewEncapsulation.ShadowDom`) and deployment as an **Angular Element (Custom Web Component)** inside other frameworks (React, Vue, etc.).
256
+
257
+ ### Composed Path Event Retargeting
258
+ When components are loaded inside a Shadow root, the browser retargets event targets when they bubble outside of the Shadow boundary. Standard `.contains()` checks on the host node will fail when checking external interaction listeners (e.g. document close listeners).
259
+
260
+ `ngxsmk-datepicker` natively handles this by tracking event composed paths:
261
+ * Inspects `event.composedPath()` when available to accurately check event origins inside Shadow DOM trees.
262
+ * Falls back to standard light DOM `.contains(target)` when composed paths are not supported by the environment.
263
+ * Supported across both the primary Datepicker component and Custom Select dropdown components.
264
+
253
265
  ## 🔧 Feature Compatibility Matrix
254
266
 
255
267
  ### By Angular Version
@@ -258,6 +270,7 @@ export class MyComponent {
258
270
  |---------|------------|-----------|------------|------------|-------------|
259
271
  | **Standalone Component** | ✅ | ✅ | ✅ | ✅ | ✅ |
260
272
  | **Signals** | ✅ | ✅ | ✅ | ✅ | ✅ |
273
+ | **Shadow DOM Support** | ✅ | ✅ | ✅ | ✅ | ✅ |
261
274
  | **Computed Signals** | ✅ | ✅ | ✅ | ✅ | ✅ |
262
275
  | **Effects** | ⚠️ Limited | ✅ | ✅ | ✅ | ✅ |
263
276
  | **Signal Forms** | ❌ | ❌ | ❌ | ❌ | ✅ |
package/docs/INTEGRATION.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Integration Guides
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  This document provides integration examples for using ngxsmk-datepicker with popular frameworks and libraries.
6
6
 
package/docs/IONIC_INTEGRATION.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Ionic Framework Integration Guide
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  This guide provides step-by-step instructions for integrating ngxsmk-datepicker with Ionic Angular applications.
6
6
 
package/docs/IONIC_TESTING.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Ionic Integration Testing Guide
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  This document provides comprehensive testing instructions for verifying ngxsmk-datepicker compatibility with Ionic Framework.
6
6
 
package/docs/LOCALE-GUIDE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Locale Packs & i18n Contributor Guide
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  Guide for adding locale support and contributing translations to ngxsmk-datepicker.
6
6
 
package/docs/PLUGIN-ARCHITECTURE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Plugin Architecture
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  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.
6
6
 
package/docs/SEO.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # SEO Optimization Guide
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  This document outlines the SEO optimizations implemented for ngxsmk-datepicker to improve search engine visibility and discoverability.
6
6
 
package/docs/SSR-EXAMPLE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Server-Side Rendering (SSR) Example
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  Complete example demonstrating ngxsmk-datepicker with Angular Universal (SSR).
6
6
 
package/docs/THEME-TOKENS.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Theme Tokens & CSS Custom Properties
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  Complete reference for all CSS custom properties (CSS variables) available in ngxsmk-datepicker.
6
6
 
package/docs/TIMEZONE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Timezone Support
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  ## Overview
6
6
 
package/docs/extension-points.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Extension Points and Hooks
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  ngxsmk-datepicker provides comprehensive extension points through the `hooks` input, allowing you to customize rendering, validation, keyboard shortcuts, formatting, and event handling.
6
6
 
package/docs/signal-forms.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Signal Forms Integration
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  This guide covers using ngxsmk-datepicker with Angular 21+ Signal Forms API.
6
6
 
package/docs/signals.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Signals Integration Guide
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  ngxsmk-datepicker is fully compatible with Angular Signals, providing seamless integration with both traditional reactive forms and modern signal-based patterns.
6
6
 
package/docs/ssr.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Server-Side Rendering (SSR) Guide
2
2
 
3
- **Last updated:** May 6, 2026 - **Current stable:** v2.2.13
3
+ **Last updated:** May 19, 2026 - **Current stable:** v2.2.15
4
4
 
5
5
  ngxsmk-datepicker is fully compatible with Angular Universal and server-side rendering. This guide covers SSR setup, best practices, and troubleshooting.
6
6