ngxsmk-datepicker 2.2.8 → 2.2.12

package/docs/PLUGIN-ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Plugin Architecture
 
-**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
+**Last updated:** May 2, 2026 · **Current stable:** v2.2.12
 
 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.
 

package/docs/REFACTOR_PLAN.md

@@ -0,0 +1,38 @@
+# Refactor plan: thin `NgxsmkDatepickerComponent`
+
+**Last updated:** May 2, 2026
+
+This plan operationalizes [IMPROVEMENT_REPORT.md](../../IMPROVEMENT_REPORT.md) items **1.1**–**1.6** without blocking feature work. Phases are incremental and test-backed.
+
+## Goals
+
+- Move orchestration of calendar **generation** and **month arrays** behind `CalendarGenerationService` (already exists—expand responsibilities).
+- Move **input ↔ model** normalization boundaries closer to `DatepickerParsingService` / a thin `InputFacade`.
+- Keep **public `@Input` / `@Output` API** stable unless explicitly versioned.
+
+## Phase 1 — Boundaries only (low risk)
+
+1. List public methods on `NgxsmkDatepickerComponent` that only delegate to `CalendarGenerationService`; replace with direct service calls from tests where duplicated.
+2. Ensure `generateCalendar()` becomes a thin orchestrator: **invalidate revision signals → assign `multiCalendarMonths` → CD**.
+
+## Phase 2 — Extract pure builders
+
+1. Move `buildCalendarMonths` logic that does not need component closure into `CalendarGenerationService` with explicit parameters (`firstDayOfWeek`, `syncScroll`, `count`).
+2. Unit-test service methods in isolation with Jasmine.
+
+## Phase 3 — Parsing facade
+
+1. Route typed-input updates through `DatepickerParsingService` + single `applyUserInput()` private method on the component.
+2. Reduce branching between native picker vs. text input vs. inline.
+
+## Phase 4 — Touch / positioning (optional)
+
+1. Confirm `TouchGestureHandlerService` and `PopoverPositioningService` own all DOM measurements; component emits intents only.
+
+## Verification
+
+- `npm run test` (ngxsmk-datepicker project)
+- `npm run e2e` with demo-app smoke + playground scenarios
+- Bundle size check script if touching public exports
+
+See also [FEATURE_SCOPING.md](./FEATURE_SCOPING.md) for upcoming API additions.

package/docs/SEO.md

@@ -1,6 +1,6 @@
 # SEO Optimization Guide
 
-**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
+**Last updated:** May 2, 2026 · **Current stable:** v2.2.12
 
 This document outlines the SEO optimizations implemented for ngxsmk-datepicker to improve search engine visibility and discoverability.
 

package/docs/SSR-EXAMPLE.md

@@ -1,6 +1,6 @@
 # Server-Side Rendering (SSR) Example
 
-**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
+**Last updated:** May 2, 2026 · **Current stable:** v2.2.12
 
 Complete example demonstrating ngxsmk-datepicker with Angular Universal (SSR).
 

package/docs/THEME-TOKENS.md

@@ -1,6 +1,6 @@
 # Theme Tokens & CSS Custom Properties
 
-**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
+**Last updated:** May 2, 2026 · **Current stable:** v2.2.12
 
 Complete reference for all CSS custom properties (CSS variables) available in ngxsmk-datepicker.
 

package/docs/TIMEZONE.md

@@ -1,6 +1,6 @@
 # Timezone Support
 
-**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
+**Last updated:** May 2, 2026 · **Current stable:** v2.2.12
 
 ## Overview
 

package/docs/extension-points.md

@@ -1,6 +1,6 @@
 # Extension Points and Hooks
 
-**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
+**Last updated:** May 2, 2026 · **Current stable:** v2.2.12
 
 ngxsmk-datepicker provides comprehensive extension points through the `hooks` input, allowing you to customize rendering, validation, keyboard shortcuts, formatting, and event handling.
 

package/docs/signal-forms.md

@@ -1,6 +1,6 @@
 # Signal Forms Integration
 
-**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
+**Last updated:** May 2, 2026 · **Current stable:** v2.2.12
 
 This guide covers using ngxsmk-datepicker with Angular 21+ Signal Forms API.
 

package/docs/signals.md

@@ -1,6 +1,6 @@
 # Signals Integration Guide
 
-**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
+**Last updated:** May 2, 2026 · **Current stable:** v2.2.12
 
 ngxsmk-datepicker is fully compatible with Angular Signals, providing seamless integration with both traditional reactive forms and modern signal-based patterns.
 

package/docs/ssr.md

@@ -1,6 +1,6 @@
 # Server-Side Rendering (SSR) Guide
 
-**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
+**Last updated:** May 2, 2026 · **Current stable:** v2.2.12
 
 ngxsmk-datepicker is fully compatible with Angular Universal and server-side rendering. This guide covers SSR setup, best practices, and troubleshooting.
 

package/package.json

@@ -1,94 +1,92 @@
-{
-  "name": "ngxsmk-datepicker",
-  "version": "2.2.8",
-  "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"
-  },
-  "prepublishOnly": "node ../../scripts/assert-lib-publish-artifacts.cjs",
-  "exports": {
-    "./styles/*": {
-      "default": "./styles/*"
-    },
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./types/ngxsmk-datepicker.d.ts",
-      "default": "./fesm2022/ngxsmk-datepicker.mjs"
-    }
-  }
-}
+{
+  "name": "ngxsmk-datepicker",
+  "version": "2.2.12",
+  "author": {
+    "name": "Sachin Dilshan",
+    "url": "https://www.sachindilshan.com/"
+  },
+  "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"
+  },
+  "prepublishOnly": "node ../../scripts/assert-lib-publish-artifacts.cjs",
+  "exports": {
+    ".": {
+      "types": "./types/ngxsmk-datepicker.d.ts",
+      "import": "./fesm2022/ngxsmk-datepicker.mjs",
+      "default": "./fesm2022/ngxsmk-datepicker.mjs"
+    },
+    "./styles/*": {
+      "default": "./styles/*"
+    }
+  }
+}