ngxsmk-datepicker 3.0.4-beta.0 → 3.0.5-beta.0

package/CHANGELOG.md

@@ -2,12 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
-**Last updated:** August 18, 2026 - **Current stable:** v3.0.4
+**Last updated:** August 22, 2026 - **Current stable:** v3.0.5
 
 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).
 
-## [Unreleased]
+## [3.0.5] - 2026-08-22
+
+### Added
+
+- **Model Context Protocol (MCP) Server (`@ngxsmk/datepicker-mcp`)**: Standalone MCP server in `mcp-server/` with standardized date intelligence tools (`parse_date`, `calculate_date_range`, `convert_timezone`, `get_holidays`, `validate_date_selection`) and resource endpoints (`datepicker://docs/api`, `datepicker://timezones`) over standard I/O (stdio).
+- **Datepicker UI AI Assistant Widget**: Added `[enableAi]`, `[aiPlaceholder]`, and `[aiResolver]` inputs with `(aiPromptSubmitted)` output on `<ngxsmk-datepicker>` allowing natural language prompt-based date selection with custom asynchronous backend support and automatic fallback parsing.
+- **Developer Workspace Configurations**: Integrated `.vscode/mcp.json` (Cursor IDE), `.gemini/mcp_config.json` (Antigravity/Gemini CLI), and complete documentation in `docs/MCP_INTEGRATION.md`.
+
+### Fixed
+
+- **Focus Loss on Keyboard Navigation via Shortcuts (Issue #313)**: Fixed issue where keyboard shortcut navigation (`PageUp`, `PageDown`, `Shift+PageUp`, `Shift+PageDown`, `Home`, `End`, cross-month arrow navigation, and letter shortcuts) caused focus loss due to calendar grid re-rendering without restoring DOM focus. Now automatically refocuses the target date cell, updates `focusedDate` with day-clamping and validity fallback, and forwards body-appended popover keydown events seamlessly ([#313](https://github.com/NGXSMK/ngxsmk-datepicker/issues/313)).
 
 ## [3.0.4] - 2026-08-18
 

package/MIGRATION.md

@@ -2,10 +2,11 @@
 
 This document provides migration instructions for upgrading between major versions of ngxsmk-datepicker.
 
-**Last updated:** August 18, 2026 - **Current stable:** v3.0.4
+**Last updated:** August 22, 2026 - **Current stable:** v3.0.5
 
 ## Table of Contents
 
+- [v3.0.4 → v3.0.5](#v304---v305)
 - [v3.0.3 → v3.0.4](#v303---v304)
 - [v2.4.0 → v3.0.3](#v240---v303)
 - [v2.2.15 → v2.3.1](#v2215---v231)
@@ -61,6 +62,17 @@ This document provides migration instructions for upgrading between major versio
 - [v1.8.0 → v1.9.0](#v180---v190)
 - [v1.7.0 → v1.8.0](#v170---v180)
 
+## v3.0.4 → v3.0.5
+
+### Changes
+
+This release includes major AI & Model Context Protocol (MCP) integrations alongside bugfixes:
+
+- **Model Context Protocol (MCP) Server (`@ngxsmk/datepicker-mcp`)**: Standalone MCP server in `mcp-server/` with standardized date intelligence tools (`parse_date`, `calculate_date_range`, `convert_timezone`, `get_holidays`, `validate_date_selection`), prompts (`schedule_meeting`, `plan_time_off`), and resources (`datepicker://docs/api`, `datepicker://timezones`).
+- **Multi-LLM Native Adapters**: Native support for **Claude** (`--export-claude`), **Google Gemini** (`--export-gemini`), **OpenAI** (`--export-openai`), and **Cursor/Windsurf** (Stdio MCP).
+- **Datepicker UI AI Assistant Widget**: Added `[enableAi]`, `[aiPlaceholder]`, `[aiSuggestions]`, `[showAiSuggestions]`, and `[aiResolver]` (Promise/Observable) inputs with `(aiPromptSubmitted)` output, async resolving micro-spinner (`isAiResolving`), screen reader announcements, and a `/` keyboard shortcut to focus the prompt bar.
+- **Focus Retention on Keyboard Navigation (Issue #313)**: Fixed issue where keyboard shortcut navigation (`PageUp`, `PageDown`, `Shift+PageUp`, `Shift+PageDown`, `Home`, `End`, cross-month arrow navigation, and letter shortcuts) caused focus loss due to calendar grid re-rendering without restoring DOM focus. Now automatically refocuses the target date cell, updates `focusedDate` with day-clamping and validity fallback, and forwards body-appended popover keydown events.
+
 ## v3.0.3 → v3.0.4
 
 ### Changes

package/README.md

@@ -30,15 +30,15 @@
 
 ---
 
-**Last updated:** August 18, 2026 - **Current stable:** v3.0.4
+**Last updated:** August 22, 2026 - **Current stable:** v3.0.5
 
 ### **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**: `v3.0.4` is the current stable release with compiled `fesm2022` output and type declarations.
+> **Stable Release**: `v3.0.5` is the current stable release with compiled `fesm2022` output and type declarations.
 >
-> **Stable line**: v2.3.x includes side-by-side **`calendars`**, **natural language input**, searchable **timezone selection dropdown UI**, dynamic range presets, and warning range highlighting. Versions **2.0.10** and **2.0.11** were broken and have been **unpublished**; use **v2.1.1+** or current **v3.0.4** on npm.
+> **Stable line**: v2.3.x includes side-by-side **`calendars`**, **natural language input**, searchable **timezone selection dropdown UI**, dynamic range presets, and warning range highlighting. Versions **2.0.10** and **2.0.11** were broken and have been **unpublished**; use **v2.1.1+** or current **v3.0.5** on npm.
 
 ---
 
@@ -89,6 +89,7 @@
 - 🏨 **Availability Calendars**: Per-day prices, indicator dots, and classes via `[dayMetadata]`; server-driven blocked dates via `[asyncDateFilter]`.
 - 🎛️ **Custom Action Bars**: `[calendarHeaderTemplate]` / `[calendarFooterTemplate]` slots with `clear()`/`close()` actions.
 - 🛠️ **Plugin Architecture**: Extend functionality via hooks for rendering, validation, and shortcuts.
+- 🤖 **Model Context Protocol (MCP) & AI Assistant**: Standalone MCP server (`@ngxsmk/datepicker-mcp`) with date intelligence tools, plus embedded UI AI prompt bar (`[enableAi]`). See [MCP Integration Guide](docs/MCP_INTEGRATION.md).
 - 🧪 **Signal Forms Native**: Direct integration with Angular 21's new Signal Forms API.
 - 🚀 **Zoneless Ready**: Optimized for the future of Angular—works perfectly without zone.js.
 - ♿ **Full Accessibility**: WAI-ARIA compliant with extensive keyboard navigation support.
@@ -188,7 +189,7 @@ ng add ngxsmk-datepicker
 The `ng add` schematic installs the package, adds the `luxon` peer dependency if it is missing, and prints a getting-started snippet. Plain npm works too:
 
 ```bash
-npm install ngxsmk-datepicker@3.0.4
+npm install ngxsmk-datepicker@3.0.5
 ```
 
 ### Alternative installation
@@ -197,12 +198,12 @@ You can install without npm using any of these methods (peer dependencies must s
 
 | Method | Command |
 |--------|--------|
-| **Yarn** | `yarn add ngxsmk-datepicker@3.0.4` |
-| **pnpm** | `pnpm add ngxsmk-datepicker@3.0.4` |
-| **Bun** | `bun add ngxsmk-datepicker@3.0.4` |
-| **From Git** | `npm install github:NGXSMK/ngxsmk-datepicker#v3.0.4` (requires the repo to have built output or you build from source) |
+| **Yarn** | `yarn add ngxsmk-datepicker@3.0.5` |
+| **pnpm** | `pnpm add ngxsmk-datepicker@3.0.5` |
+| **Bun** | `bun add ngxsmk-datepicker@3.0.5` |
+| **From Git** | `npm install github:NGXSMK/ngxsmk-datepicker#v3.0.5` (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@3.0.4/) or [jsDelivr](https://cdn.jsdelivr.net/npm/ngxsmk-datepicker@3.0.4/) 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@3.0.5/) or [jsDelivr](https://cdn.jsdelivr.net/npm/ngxsmk-datepicker@3.0.5/) 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).
 
@@ -963,7 +964,7 @@ We welcome and appreciate contributions from the community! Whether it's reporti
 
 ## **📄 Changelog**
 
-**Recent:** Use **v3.0.4** on npm. The v2.3.x line adds side-by-side multi-calendar layouts, natural language typing, timezone selector UI dropdown, warning style selections, and strict TypeScript/AOT stability. Versions 2.0.10 and 2.0.11 are unpublished; use v2.1.1+ or **v3.0.4**.
+**Recent:** Use **v3.0.5** on npm. The v2.3.x line adds side-by-side multi-calendar layouts, natural language typing, timezone selector UI dropdown, warning style selections, and strict TypeScript/AOT stability. Versions 2.0.10 and 2.0.11 are unpublished; use v2.1.1+ or **v3.0.5**.
 
 For the full list of changes, see [CHANGELOG.md](https://github.com/NGXSMK/ngxsmk-datepicker/blob/main/CHANGELOG.md).
 

package/docs/IONIC_INTEGRATION.md

@@ -1,8 +1,8 @@
-# Ionic Framework Integration Guide
+# Ionic Framework Integration Guide
 
-**Last updated:** July 29, 2026 - **Current stable:** v3.0.3
+**Last updated:** August 22, 2026 - **Current stable:** v3.0.5
 
-This guide provides step-by-step instructions for integrating ngxsmk-datepicker with Ionic Angular applications.
+This guide provides step-by-step instructions for integrating `ngxsmk-datepicker` with modern **Ionic 7, 8, & 9+** and **Angular 17–21+** applications.
 
 ## Quick Start
 
@@ -26,55 +26,64 @@ Or import directly in your component:
 import 'ngxsmk-datepicker/styles/ionic-integration.css';
 ```
 
-### 3. Use Inline Mode (Recommended)
+### 3. Use with Modern Standalone Ionic + Angular Signals
 
 ```typescript
-import { Component } from '@angular/core';
+import { Component, signal } from '@angular/core';
 import { NgxsmkDatepickerComponent } from 'ngxsmk-datepicker';
-import { IonContent, IonItem, IonLabel } from '@ionic/angular/standalone';
+import { IonContent, IonItem, IonLabel, IonList } from '@ionic/angular/standalone';
 
 @Component({
   selector: 'app-datepicker',
   standalone: true,
-  imports: [NgxsmkDatepickerComponent, IonContent, IonItem, IonLabel],
+  imports: [NgxsmkDatepickerComponent, IonContent, IonItem, IonLabel, IonList],
   template: `
-    <ion-content>
-      <ion-item>
-        <ion-label>Select Date</ion-label>
-        <ngxsmk-datepicker
-          [inline]="true"
-          mode="single"
-          [locale]="'en-US'">
-        </ngxsmk-datepicker>
-      </ion-item>
+    <ion-content [fullscreen]="true">
+      <ion-list [inset]="true">
+        <ion-item>
+          <ion-label position="stacked">Booking Date</ion-label>
+          <ngxsmk-datepicker
+            [(ngModel)]="selectedDate"
+            [inline]="true"
+            mode="single"
+            [locale]="'en-US'"
+            [enableAi]="true"
+            [showAiSuggestions]="true"
+          >
+          </ngxsmk-datepicker>
+        </ion-item>
+      </ion-list>
     </ion-content>
   `
 })
-export class DatepickerPage {}
+export class DatepickerPage {
+  selectedDate = signal<Date | null>(new Date());
+}
 ```
 
-## Configuration Options
+## Configuration & Mobile Best Practices
 
 ### Disable Focus Trap (for Ionic Modals)
 
-When using datepicker inside `ion-modal`, disable focus trapping to avoid conflicts:
+When using datepicker inside `ion-modal`, disable focus trapping to prevent focus loops:
 
-```typescript
+```html
 <ngxsmk-datepicker
   [inline]="true"
   [disableFocusTrap]="true"
-  mode="single">
-</ngxsmk-datepicker>
+  mode="single"
+></ngxsmk-datepicker>
 ```
 
-### Ionic Theme Integration
+### Ionic 8 Dark Mode (`.ion-palette-dark`)
 
-The integration styles automatically map Ionic theme variables:
+The integration stylesheet automatically detects Ionic 8's `.ion-palette-dark` and legacy `.ion-theme-dark`:
 
 - `--ion-color-primary` → `--datepicker-primary-color`
 - `--ion-background-color` → `--datepicker-background`
 - `--ion-text-color` → `--datepicker-text-color`
 - `--ion-border-color` → `--datepicker-border-color`
+- `--ion-font-family` → `--datepicker-font-family`
 
 ## Usage Patterns